Service Request Form Elements
When a user requests a new service, the service request form that's displayed for the user will be comprised of two form pages:
- Service form page — These settings apply to a service as a whole. For information on how to create the service-level portion of the request form, see Create New Service Requests.
- Component form page — Settings are component-specific and may include information such as CPU, memory, network, and credentials. You configure these component-level settings on the Form tab of the service catalog blueprint. For more information, see Component blueprints.
When you design the service-level and component forms, you can add the elements listed in the table below to the form pages These form elements will determine the appearance and content that's presented to users when they make a new service request.
Tip: You can access request form values through workflow variables. See Example: Mapping Request Form Fields to Variables.
Adds heading text to the form.
Adds explanatory text to the form.
Allows the requester to enter a value, such as a note or a password.
Important: If users will enter a password on the request form, enable Hide User Input. When Hide User Input is enabled:
Allows the requester to select options from lists that are updated in real time from an external source. If the lists can depend on other form elements, the selection of one form element can dictate the available choices for another list. For more information, see Add Dynamic Lists to Forms.
The date the requester requires the service.
In the Default Lead Time (in days) field, enter a number if you want a default Required By date to be displayed on the form. Users can adjust this date.
Service / Component Properties
Allows the requester to specify a primary owner for the service, or, if you enable the Display Only option, simply displays the primary owner on the form. For more information, see Assign Service Ownership.
Allows the requester to specify a value for a custom attribute or placement attribute. Select an attribute from the list. The (Placement) suffix distinguishes placement attributes from custom attributes.
You can create relationships between custom attributes, so that the value selected for one attribute affects the selectable values for other attributes. See Create Relationships Between Attributes Used on Forms.
All custom attributes that are configured to be available for VMs and virtual services are available for services as well. Note that in general it's best not to include the same custom attribute on both the Service form and the blueprint form; if a custom attribute is included on both the Service form and the blueprint form, the Service form takes precedence.
Important: Don't include text-type custom cost attributes on the request form because they allow the requester to specify the cost of the service they are requesting. Rather, include list-type custom cost attributes, so that you can control the values that a requester can specify.
To ensure accurate cost calculations, don't include custom cost attributes on the Service form; include them only on the blueprint form. For more information, see Working with Custom Attributes.
Allows the requester to specify the expiry date for the service.
Allows a user to request multiple identical services more easily. It also allows you to limit the number of each service that can be requested.
Don't include the Quantity form element when Commander is in single-service request mode, because in this mode, Quantity simply displays "1" for a value, rather than allowing users to select a number. For more information, see Set Single-Service Mode.
Displays the estimated annual, quarterly, or monthly cost for a VM or virtual service.
If the Override Cost Period option is enabled for the Expiry Date element, the Lifespan Cost is displayed on the form instead of the Estimated Cost.
Allows the requester to select from all deployment destinations available to this user and valid for the requested service.
Service Catalog costs are updated to reflect the selected destination, so that requesters can understand the cost impact of their decision.
To control what destinations users will see, if a user belongs to multiple groups, only the most specific assignment is used, with the following order of precedence:
When a user selects Let the system decide and multiple destinations are available for the selected service, the destination with the highest rating is displayed as the expected destination. If only one destination is available, a read-only field is dislayed instead of a drop-down. When no destinations are available to the user, Let the system decide is selected.
If you don't make this element mandatory, the default selection on the form is Let the system decide.
If you make this element mandatory, you must choose from the following options:
If this element isn't mandatory and the user selects Let the system decide, Commander recalculates the target destination based on the user's storage tier and network zone selections on the component blueprint form.
If you add this element to the Service form and enable the Limit Selections option, the storage tiers and network zones configured for the selected deployment destination are shown on the form, rather than those you configured for the Storage element and the Network element. The Limit Selections option ensures that users don't select a storage tier or network zone that's unavailable on the target destination. The Storage element and the Network element appear on the blueprint form, which you configure in the Service Catalog.
Allows the requester to select multiple values for a custom attribute. Use this form element to add any list-type custom attribute that's configured to apply only to forms.
This element works only with form attributes, so the values selected on the form are not applied as metadata on deployed services. Therefore, you should use this element only when you need users to be able to multi-select values on the form, but you don't need the metadata to be applied on deployed services. Use the regular Custom/Placement Attribute form element for metadata that persists on deployed services.
To configure a new custom attribute, can click Create New Attribute. See Create custom attributes for more information.
To allow users to multi-select values, enable Select Multiple.