Propiedades de paso: el elemento properties

El elemento properties es un contenedor de propiedades, que se definen con la etiqueta property.

Cada paso tiene un único elemento properties; un elemento properties puede incluir cualquier número de elementos hijo property.

Una etiqueta property tiene un atributo name obligatorio, un atributo required opcional y dos elementos hijo, property-ui y value, que se definen en la siguiente tabla.

Tabla 1. El elemento <property>
Elementos hijo <property> Descripción
<property-ui> Define cómo se presenta la propiedad a los usuarios en el editor IBM® UrbanCode Deploy. Este elemento tiene varios atributos:
  • label

    Identifica la propiedad en el cuadro de diálogo Editar propiedades del editor.

  • description

    Texto que se muestra a los usuarios en el cuadro de ayuda asociado.

  • default-value

    Valor de propiedad que se muestra cuando se muestra en cuadro de diálogo Editar propiedades; se utiliza si no se ha modificado.

  • type

    Identifica el tipo de widget que se muestra a los usuarios. Los valores posibles son:
    • textBox

      Permite a los usuarios especificar una cantidad arbitraria de texto, limitada a 4064 caracteres.

    • textAreaBox

      Permite a los usuarios especificar una cantidad arbitraria de texto (un área de entrada mayor que textBox), limitada a 4064 caracteres.

    • secureBox

      Se utiliza para contraseñas. Es similar a textBox excepto que los valores se redactan.

    • checkBox

      Muestra una casilla de verificación. Si se activa, se utiliza el valor verdadero; si no, no se define la propiedad.

    • selectBox

      Requiere una lista de uno o varios valores, que se muestran en forma de lista. La configuración de un valor se describe a continuación.

<value> Se utiliza para especificar valores para un selectBox. Cada valor tiene un atributo label obligatorio, que se muestra a los usuarios, y un valor que utiliza la propiedad cuando se selecciona. Los valores se muestran en el orden en el que se han definido.

Aquí se muestra una definición <property> de ejemplo:

<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>

Comentarios