Sie können angeben, dass eine Eigenschaft einen Wert aus einer XML- oder JSON-Datei über HTTP bezieht. Wenn Sie den Prozess dann ausführen, stellt Ihnen der Server eine Liste von Werten aus dieser Datei bereit.
Vorbereitende Schritte
Hosten Sie auf einem Computer, der über
IBM® UrbanCode Deploy zugänglich ist, eine XML- oder JSON-Datei, die die Werte für die Eigenschaft enthält. Sie können diese Datei auf mehrere Arten formatieren. Sie müssen auch den Pfad bestimmen, der zu den Werten mit
drei Parametern führt. Beispiele
mit diesen Pfadparametern sind in den Beispieldateien enthalten.
Am einfachsten lässt sich die Datei formatieren, indem Sie eine einfache Liste von
Werten für die Eigenschaft bereitstellen, wie in den folgenden Beispielen:
<company>
<employee>Alice</employee>
<employee>Bob</employee>
<employee>Chris</employee>
<company>
Für XML-Dateien verwenden Sie XPath, um den Pfad zu den Werten anzugeben. In der vorherigen XML-Datei ist der Parameter
Base
Path der XPath-Ausdruck
//company/employee und die Parameter
Value Path und
Label Path sind leer.
Das folgende Beispiel zeigt die äquivalente Datei in JSON:
{
company: {
employee: [
"Alice",
"Bob",
"Chris"
]
}
}
In der vorherigen JSON-Datei ist der Parameter
Base Path company.employee und die Parameter
Value Path und
Label Path sind leer.
Sie können gesonderte Bezeichnungs- und Wertinformationen in der Datei einschließen.
Beispiel:
Die folgende XML-Datei enthält Namen und ID-Nummern.
<company>
<employee>
<name>Alice</name>
<id>1</id>
</employee>
<employee>
<name>Bob</name>
<id>2</id>
</employee>
<employee>
<name>Chris</name>
<id>3</id>
</employee>
</company>
In diesem Fall ist der Parameter
Base Path der XPath-Ausdruck
//company/employee. Der
Parameter
Value Path ist ein XPath-Ausdruck, der den Pfad zum Wert zeigt, der relativ
zum Basispfad ist. In diesem Fall ist der Ausdruck
./id. Ebenso ist der Parameter
Label Path ein XPath-Ausdruck, der den
Pfad zur Bezeichnung zeigt, relativ zum Basispfad. In diesem Fall ist der Ausdruck
./name.
Die folgende JSON-Datei ist äquivalent zur vorherigen XML-Datei:
{
company: {
employees: [
{ name: "Alice", employee.id: 1 },
{ name: "Bob", employee.id: 2 },
{ name: "Chris", employee.id: 3}
]
}
}
In diesem Fall ist der Parameter
Base Path company.employees. Der Parameter
Value
Path ist
employee\.id und der Parameter
Label Path ist
name.
Anmerkung: Wenn Sie den Pfad für eine JSON-Datei angeben, verwenden Sie bei Punkten in Attributnamen einen umgekehrten Schrägstrich als Escapezeichen wie im Parameter Value Path im vorherigen Parameter.
Wenn
Sie in einer XML-Datei Attribute verwenden, verwenden Sie das Zeichen
@, um ein Attribut in XPath anzugeben. Die folgende XML-Datei hat
beispielsweise Werte in Attributen:
<company>
<employee id="1">Alice</employee>
<employee id="2">Bob</employee>
<employee id="3">Chris</employee>
<company>
In diesem Fall ist der Parameter
Base Path der XPath-Ausdruck
//company/employee. Der Parameter
Value Path ist
./@id und der Parameter
Label Path ist ein Punkt (
.).
Informationen zu diesem Vorgang
Sie können diese fernen Eigenschaftswerte in Eigenschaftsdefinitionen verwenden, z. B. Komponentenumgebungseigenschaften, aber nicht in allgemeinen
Eigenschaften wie Systemeigenschaften, Anwendungseigenschaften oder Komponenteneigenschaften.
Ergebnisse
Wenn Sie den Prozess jetzt ausführen, enthält das Fenster
Prozess ausführen einen Parameter, mit dem Werte aus der externen Datei abgerufen werden.