To create useful forms based on input parameters, you can use vRealize Automation Service Broker to design how the information appears at request time, how the parameters values are populated, and add any specialized constraints.

Custom request form designer

You use the form designer to create your custom form.

Custom form canvas with numbered callouts.

To create a custom form:

  1. Notice that request inputs that are already on the canvas.
  2. Drag any custom elements onto the design canvas.
  3. Configure each element using the properties pane.

    For more about the fields properties, see Custom form designer field properties in vRealize Automation Service Broker.

  4. Use the Actions menu options to import or export the form, or import or export a CSS file. The following sections provide more information.
  5. Enable the form.

The custom form designer supports data validation by adding constraints to a field. For constraints options that are applied as you create a form, see Custom form designer field properties in vRealize Automation Service Broker. For a constraint example, see Customize a vRealize Automation Service Broker icon and request form.

Importing and exporting custom forms between blueprint

You might find, after you develop a custom form, that you want to use part or all of it with another blueprint. You can export a form from one blueprint and import it into another blueprint, and then continue customizing the form for the new blueprint.

To share the custom forms, you can click Actions on the custom form designer and select one of the following options.

Table 1. Action menu options for importing and exporting custom forms
Action Menu Item Description
Import form Imports a JSON or YAML file.
Export form Exports your current custom form as a JSON file.
Export form as YAML Exports your current custom form as YAML.

Export the file as YAML when you want to move a custom from one vRealize Automation Service Broker instance to another. For example, from your test environment to your production environment. If you prefer to edit the form as YAML, you can export the form, edit it, and then import it back into the blueprint.

Adding your own style sheet to a custom form

You can use a custom cascading style sheet to refine how the text appears on the screen. You must create the CSS file outside of vRealize Automation Service Broker. But you can export and import a CSS file from one blueprint to another.

Table 2. Action menu options for importing and exporting CSS files
Action Menu Item Description
Import CSS Imports a CSS file that enhances the catalog request form.

The file might be similar to the following example.

#<field_ID> {
	font-size: 20px;
	font-weight: bold;
	color: red;
	width: 600px;
}
#<field_ID> {
	font-size: 20px;
	font-weight: bold;
	font-style: italic;
	width: 600px;
}

In this example, replace <field_ID> with the actual field IDs from the custom form. You can locate the values by selecting the field in the form, and then you can see the value in the properties pane, beneath the field name. For example, Field ID: deploymentName or Field ID: textField_fe7cf66a.

Export CSS Exports your customized CSS.
Remove CSS Discards your custom CSS.

The discarded CSS is not recoverable.