Create a Custom Property That Validates Against a Regular Expression

<

You create custom property definition that evaluates a regular expression when you want service catalog users to provide validated data on the catalog request form.

For example, to add an alphanumeric text box where the requesting user provides an application or function name that is limited to five to ten characters with no special characters. For this scenario, you use a regular expression custom property configured to something similar to ^[a-zA-Z0-9]{5,10}$.

Prerequisites

Ensure that you have a regular expression that validates the provided values as expected.

Log in to vRealize Automation as a tenant administrator or fabric administrator.

Procedure

Select Administration > Property Dictionary > Property Definitions.

Click the New icon ().

Enter the options.

Option

Description

Name

Enter a value using a standard naming convention for the new property name such as my_grouping_prefix.my_property_name.

Label

The label is populated based on the name. You can change the label to provide a more readable name.

Visibility

The action custom properties are only available in the current tenant. To make them available in another tenant, you must configure them when you are logged in to that tenant.

Description

Describe the intent of the property definition and any other helpful information about the property.

Display order

The number that you enter controls how the property name appears on the request form. The following ordering rules apply:

The display order applies only to properties that are configured with Prompt User or Show in Request Form settings.

All properties with a display order appear before properties with no order index.

Properties with a display order are sorted from lowest to highest order index value. You can use negative numbers.

All properties are ordered alphabetically, with all display ordered properties appearing before non-display ordered properties.

If two properties have the same display order value, then they are sorted alphabetically.

Data type

Select String in the drop-down menu.

Required

Select No in the drop-down menu.

Display as

Select Textbox in the drop-down menu.

Valid user input

Enter the regular expression.

Enter a value in the testing text box to verify that the expression works.

Click OK.

Results

The custom property definition is added to the list and it is available to add to a blueprint.