Propriedades de etapa: o elemento properties

O elemento properties é um contêiner para propriedades, que são definidas com a tag property.

Cada etapa tem um único elemento properties; um elemento properties pode conter qualquer número de elementos filhos property.

Uma tag property possui um atributo name obrigatório, um atributo required opcional e dois elementos filhos, property-ui e value, que são definidos na tabela a seguir.

Tabela 1. O elemento <property>
Elementos Filhos <property> Descrição
<property-ui> Define como a propriedade é apresentada aos usuários no editor do IBM® UrbanCode Deploy. Este elemento possui vários atributos:
  • label

    Identifica a propriedade na caixa de diálogo Editar Propriedades do editor.

  • description

    Texto que é exibido para os usuários na caixa de ajuda de rolagem associada.

  • default-value

    O valor da propriedade que é exibido quando a caixa de diálogo Editar Propriedades é exibida; usado se inalterado.

  • type

    Identifica o tipo de widget que é exibido para os usuários. Os valores possíveis são:
    • textBox

      Permite que os usuários inseram uma quantidade arbitrária de texto, limitada a 4064 caracteres.

    • textAreaBox

      Permite que os usuários insiram uma quantidade arbitrária de texto (maior área de entrada que textBox), limitada a 4064 caracteres.

    • secureBox

      Usado para senhas. Semelhante a textBox, exceto os valores são redigidos.

    • checkBox

      Exibe uma caixa de seleção. Se marcado, será usado um valor igual a verdadeiro; caso contrário, a propriedade não é configurada.

    • selectBox

      Requer uma lista de um ou mais valores, que são exibidos em uma lista. A configuração de um valor é descrita abaixo.

<value> Usado para especificar valores para uma selectBox. Cada valor possui um atributo obrigatório label, que é exibido para os usuários, e um valor que é usado pela propriedade quando selecionado. Os valores são exibidos na ordem em que são definidos.

Aqui está uma definição de amostra 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>

Feedback