Abrufen von Eigenschaftswerten aus externen Dateien

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.

Vorgehensweise

  1. Erstellen Sie eine Eigenschaftsdefinition. Beispiel: Klicken Sie auf eine Komponente, gehen Sie zur Registerkarte Konfiguration, klicken Sie auf Umgebungseigenschaftsdefinitionen und dann auf Eigenschaft hinzufügen.
  2. Geben Sie die Felder Name, Beschreibung, Kennzeichnung, Muster und Erforderlich wie gehabt an.
  3. Wählen Sie in der Liste Typ HTTP-Auswahl für einen einzelnen Eigenschaftswert aus oder wählen Sie HTTP-Mehrfachauswahl aus, um mehrere Eigenschaftswerte zuzulassen. Es werden mehrere neue Felder angezeigt.
  4. Geben Sie die folgenden Felder an. Diese Felder sind für Parameter aus externen Dateien spezifisch.
    URL
    Geben Sie die URL der externen XML- oder JSON-Datei an.
    Benutzername
    Wenn für die URL ein Benutzername erforderlich ist, geben Sie ihn hier an.
    Kennwort
    Wenn für die URL ein Kennwort erforderlich ist, geben Sie es hier an.
    Datenformat
    Geben Sie den Dateityp an: JSON oder XML.
    Basispfad
    Geben Sie für XML-Dateien einen XPath-Ausdruck für die Daten an. Geben Sie für JSON-Dateien den Pfad über JSON-Attribute zu den Daten an, indem Sie Pfade mit Punkten (.) trennen. Siehe Beispiele zu Beginn dieser Seite.
    Wertpfad
    Geben Sie den Pfad zu den Parameterwerten an, die relativ zum Parameter Base Path sind.
    Beschriftungspfad
    Geben Sie den Pfad zu den Parameterbeschriftungen an, die relativ zum Parameter Base Path sind.
    Standardwert
    Geben Sie den Standardwert für den Parameter an.
  5. Klicken Sie auf Speichern.

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.

Feedback