The fields properties determine how the selected field looks and what default values are presented to the user. And they determine what rules you want to apply to the field to ensure that the user provides a valid entry in the catalog request form in vRealize Automation.
You configure each field individually. Select the field and edit the field properties.
You use the appearance properties to determine whether the field appears on the form and what label and custom help you want to provide to your catalog users.
Some blueprints might include fields that contain a fixed value. When you add this type of fields to a custom form, only the Appearance options are available, and the field is always Read-only.
|Label and type||Provide a label and select a display type.
The available display types depend on the field. Some fields support multiple text types, some support a few types, and some only support a single type. Possible values across all types:
The multi select and dual list field types provide the same functionality, with the dual list providing a more intuitive option when the user can select more than one item in a list.
Drop-down and data grid fields include a Placeholder setting. The entered value appears as an internal label or instructions in the drop-down menu, or as a general label or instructions in the data grid.
The value picker and tree picker fields include a Reference type setting. The reference type is the vRealize Orchestrator resource type that is used to limit the value or tree picker search to the vRealize Orchestrator server inventory that supports the type. You can then further limit the search by selecting an action that supports the reference type. For more information about the two pickers, see Using the Value Picker or Tree Picker Elements in the Custom Forms Designer.
|Visibility|| Show or hide a field on the request form.
|Read-only|| Prevent users from changing the field values.
|Rows per page||For data grid elements only.
Enter the number of rows.
|Custom help|| Provide information about the field to your users. This information appears in signpost help for the field.
You can use simple text or HTML, including href links. For example,
You use the values properties to provide any default values.
|Columns||For the data grid element only.
Provide the label, ID, and value type for each column in your table.
The default value for the data grid must include the header data that matches the defined columns. For example, if you have user_name ID for one column and user_role ID for another, then the first row is user_name,user_role.
For configuration examples, see Using the Data Grid Element in the Custom Forms Designer.
|Default value|| Populates the field with a default value based on the value source.
For many of the properties, you can select from various value source options. Not all source options are available for all field types or properties. Possible value sources depend on the field.
|Value option||Populates a drop-down, multi-select, radio group, or value picker fields.
|Step||For integer or decimal fields, define the incremental or decremental values.
For example, if the default value is 1 and you set the step value to 3, then the allowed values are 4, 7, 10, and so on.
You use the constraint properties to ensure that the requesting user provides valid values in the request form.
You might also use external validation as an alternative method for ensuring valid values. See Using External Validation in the Custom Forms Designer.
|Required||The requesting user must provide a value for this field.
|Regular expression||Provide a regular expression that validates the value and a message that appears when the validation fails.
|Minimum value||Specify a minimum numeric value. For example, a password must have at least 8 characters.
Provide an error message. For example, The password must be at least 8 characters.
|Maximum value||Maximum numeric value. For example, a field is limited to 50 characters.
Provide an error message. For example, This description cannot exceed 50 characters.
|Match field|| This field value must match the selected field value.
For example, a password confirmation field must match the password field.