Schritteigenschaften: das properties-Element

Das properties-Element ist ein Container für Eigenschaften, die mit dem Tag property definiert werden.

Jeder Schritt hat ein einzelnes properties-Element. Ein properties-Element kann jede Anzahl von untergeordneten property-Elementen enthalten.

Ein property-Tag hat ein obligatorisches name-Attribut, ein optionales required-Attribut und zwei untergeordnete Elemente, property-ui und value, die in der folgenden Tabelle definiert sind.

Tabelle 1. Das <property>-Element
Untergeordnete <property>-Elemente Beschreibung
<property-ui> Definiert, wie die Eigenschaft den Benutzern im IBM® UrbanCode Deploy-Editor präsentiert wird. Dieses Element hat mehrere Attribute:
  • label

    Identifiziert die Eigenschaft im Dialogfeld Eigenschaften bearbeiten des Editors.

  • description

    Text, der Benutzern im zugeordneten Rollover-Hilfefeld angezeigt wird.

  • default-value

    Eigenschaftswert, der angezeigt wird, wenn das Dialogfeld Eigenschaften bearbeiten eingeblendet ist; wird verwendet, wenn nicht geändert.

  • type

    Identifiziert den Typ des Widgets, das Benutzern angezeigt wird. Mögliche Werte sind:
    • textBox

      Hier können Benutzer einen beliebigen Text mit maximal 4064 Zeichen eingeben.

    • textAreaBox

      Hier können Benutzer einen beliebigen Text (mit einem größeren Eingabebereich als textBox) eingeben.

    • secureBox

      Wird für Kennwörter verwendet. Ähnlich wie textBox, nur werden die Werte bearbeitet.

    • checkBox

      Zeigt ein Kontrollkästchen an. Wenn es aktiviert ist, wird der Wert "wahr" verwendet. Wenn nicht, ist die Eigenschaft nicht eingestellt.

    • selectBox

      Erfordert eine Liste von Werten, die in einer Liste angezeigt werden. Die Konfiguration eines Werts wird nachstehend gezeigt.

<value> Wir verwendet, um Werte für ein Auswahlfeld (selectBox) anzugeben. Jeder Wert hat ein obligatorisches label-Attribut, das Benutzern angezeigt wird, und einen Wert, der bei der Auswahl von der Eigenschaft verwendet wird. Werte werden in der Reihenfolge angezeigt, in der sie definiert sind.

Nachstehend finden Sie ein Beispiel für eine <property>-Definition:

<property name="onerror" required="true">
  <property-ui type="selectBox"
    default-value="abort"
    description="Auszuführende Aktion, wenn Anweisung fehlschlägt: fortsetzen, stoppen, abbrechen."
    label="Fehlerbearbeitung"/>
  <value label="Abbrechen">abort</value>
  <value label="Fortsetzen">continue</value>
  <value label="Stoppen">stop</value>
</property>

Feedback