Propriétés d'étape : élément properties

L'élément properties est un conteneur de propriétés qui sont définies avec la balise property.

Chaque étape possède un élément properties unique ; un élément properties peut contenir un nombre illimité d'éléments enfant property.

Une balise property possède un attribut name obligatoire, un attribut required facultatif, et deux éléments enfant, property-ui et value, qui sont définis dans le tableau ci-après.

Tableau 1. L'élément <property>
Eléments enfant de <property> Description
<property-ui> Définit la façon dont la propriété est présentée aux utilisateurs dans l'éditeur d'IBM® UrbanCode Deploy. Cet élément possède plusieurs attributs :
  • label

    Identifie la propriété dans la boîte de dialogue Editer les propriétés de l'éditeur.

  • description

    Texte affiché pour les utilisateurs dans la boîte d'aide déroulante associée.

  • default-value

    Valeur de la propriété qui apparaît lorsque la boîte de dialogue Editer les propriétés est affichée ; utilisée si aucune modification n'a été apportée.

  • type

    Identifie le type de widget qui s'affiche pour les utilisateurs. Les valeurs possibles sont les suivantes :
    • textBox

      Permet aux utilisateurs d'entrer une quantité de texte arbitraire, dans la limite de 4064 caractères.

    • textAreaBox

      Permet aux utilisateurs d'entrer une quantité de texte arbitraire (zone de saisie plus grande que textBox), dans la limite de 4064 caractères.

    • secureBox

      Utilisé pour les mots de passe. Similaire à textBox, mais les valeurs sont rédigées.

    • checkBox

      Affiche une case à cocher. Si la case à cocher est sélectionnée, la valeur true est utilisée ; sinon, la propriété n'est pas définie.

    • selectBox

      Requiert une liste d'une ou de plusieurs valeurs, affichées sous forme de liste. La configuration de valeur est décrit ci-après.

<value> Utilisé pour spécifier des valeurs pour un attribut selectBox. Chaque valeur possède l'attribut label obligatoire, qui est affiché aux utilisateurs, ainsi qu'une valeur qui est utilisée par la propriété lorsqu'elle est sélectionnée. Les valeurs apparaissent dans l'ordre dans lequel elles sont définies.

Voici un exemple de définition de <property> :

<property name="onerror" required="true">
  <property-ui type="selectBox"
    default-value="abort"
    description="Action to perform when statement fails: continue, stop, abort."
    label="Error Handling"/>
  <value label="Abort">abort</value>
  <value label="Continue">continue</value>
  <value label="Stop">stop</value>
</property>

Commentaires en retour