Step Properties: <properties> Element

The properties element is a container for properties, which are defined with the property tag. Each step has a single properties element; a properties element can contain any number of property child elements.

A property tag has a mandatory name attribute, optional required attribute, and child elements, property-ui and value, which are defined in the following table.

<property> Element table

<property> Child Elements Description
<property-ui>

Defines how the property is presented to users in the Deployment Automation Process Editor. This element has several attributes:

  • label

    Identifies the name of the property shown in the Process Editor Item Properties tab.

  • description

    Help shown for the property in the Item Properties tab.

  • default-value

    The default value of the property. This is displayed in the Item Properties tab and is used by the step if left unchanged.

  • type

    Identifies the type of widget displayed to users. Possible values are:

    • textBox

      Enables users to enter an arbitrary amount of text, limited to 4064 characters.

    • textAreaBox

      Enables users to enter an arbitrary amount of text in a multi-line text box. The length of the text is limited to 4064 characters.

    • secureBox

      Used for passwords. Similar to textBox except values are redacted.

    • checkBox

      Displays a check box. If selected, a value of true will be used; otherwise the property is not set.

    • selectBox

      Requires a list of one or more values that will be displayed in a drop-down list box. Configuring a value is described below.

<value> Used to specify values for a selectBox. Each value has a mandatory label attribute which is displayed to users, and a value used by the property when selected. Values are displayed in the order they are defined.

Here is a sample <property> definition:


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