This documentation supports the 22.1 version of BMC Helix Digital Workplace Basic and BMC Helix Digital Workplace Advanced. Icons distinguish capabilities available only for the Advanced and External license levels. For more information, see License types and features.

Adding a validation process to a question

As an administrator, you need to validate user responses to notify your end users of input errors, prevent failures in processing requests, and to make sure users can successfully submit service requests. Use BMC Helix Innovation Studio processes to perform input validation and ensure that a user input satisfies specific criteria before you allow the user to move to the next step or service question.

You can add validation only to native BMC Helix Digital Workplace Catalog services and imported SRDs.  


 



Scenario: Check whether a user exists in Active Directory before accepting a request to add a user to Active Directory 

Scenario

Britney wants to add a user to Active Directory. Britney specifies the user name in the Add users in Active Directory service request. A validation process checks whether the given user account exists in Active Directory. If the account does not exist, validation is successful; Britney can submit the request to create the new user account. If the user account already exists, validation fails because the user cannot be added to Active DIrectory, and Britney receives an error message.

How validation works in the following scenarios

When External Validation is enabled with other settings, such as Regular Expression or Default Value, the processing is done as described below:  

  • Regular Expression (regex) is enabled: For a required question, if the input passes the regex validation, it is then sent to the validation process. The input is not sent for further validation if the regex validation fails. For example, to check whether an email address exists in Active Directory, you use a regular expression to check if the address is valid. After you confirm it's a valid address, you use a validation process to check whether it exists in Active Directory..
  • Actions are specified: Values are populated only if the validation is successful. To learn more about actions, see "About actions that trigger default responses' in Creating questions with default responses.
  • Default Value is configured: If external validation is enabled, the default value is validated in BMC Helix Digital Workplace Catalog. For more information, see Creating questions with default responses.

Tip

If a user input contains leading or trailing spaces or both, the spaces are ignored during validation.

Process overview

  1. Create a BMC Helix Innovation Studio process to validate a user input for your use case and ensure that the process executes as expected.
  2. Create a service and integrate the validation process with the service questionnaire:
    1. Add a Text Field or Text Area type of question to the questionnaire.
    2. Enable external validation for the question.
    3. Select the process that will validate a user's response to the question.

Before you begin

Create both of the following items:

To create a process to validate user input 

  1. Create a validation workflow in BMC Helix Digital Workplace Catalog.

    • The process must have text, integer, or both types of inputs. 
    • It must have at least one global input variable. It cannot have only local variables.
    • It cannot have more than one required process input. 
  2. Log in to BMC Helix Innovation Studio as an administrator.
  3. On the Workspace tab, click Digital Workplace Catalog.
  4. On the Processes tab, click Manage Processes.
  5. Search for and select your validation process and click Run.
    Test the process in isolation to make sure the process works as expected when it executes in a questionnaire. For more information, see  Viewing and managing process execution Open link .

Important

To learn how to create a sample process that validates a user input, see Using the External Process Validation feature Open link on BMC Community. 

To map a validation process to a service question

  1. In the Catalog console, open the service, and its questionnaire.
  2. In the Questions Designer, add a question.
  3. From the Form element type list, select Text Field or Text Area.
  4. In the Label field, enter the text of the question prompt that is displayed to the user
  5. Enable External Validation for the question.
  6. Click Map to process and select the process you want to use for the response validation.
  7. In Process input variable, select the process input for which you added the question. 
    The user's response to the question is passed as an input to the process for validation.
    Only text and integer data type process inputs appear in the Process input variable list. If the process has a required input, only that input appears in the list.
  8. In Error State, specify the error message to be displayed to the user if validation fails.

    Message typeDescription Example
    Custom messageAdministrator adds a custom message.<user name> already exists in Active DIrectory. Enter a valid user name to procees.
    Custom message+process response

    Administrator cofigured message appended by the response from the BMC Helix Innovation Studio process that validates the user input.

    Invalid input: Object already exists. 
    Process response

    Response from the BMC Helix Innovation Studio process that validates the user input.

    AD3011: Object already exists. 

    In addition, error messages may be displayed to the end user if error handlers are configured to catch errors during process execution and an error occurs. For example, authentication errors, failed HTTP requests, or timeout are some errors that might occur when a process is executed.

    Important

    Process messages are in English and are not translated.

     

    Question Designer



  9. Add other questions as needed. 
  10. Save the service configuration.

Troubleshooting

The following table describes common problems and steps to resolve them:

ScenariosSteps to resolve
The selected workflow is incompatible and cannot be mapped to the question.Make sure the process has at least one text or integer process input.
Although the process contains other types of variables, the Process Input variable list displays only text or integer process inputs. External validation is available only for text and integer process inputs. 
The validation process does not work as expected.
  1. Log in to BMC Helix Innovation Studio.
  2. Select Workspace > DWPC > Processes > Manage Processes. 
  3. Provide the same values to the process inputs as you did to check the process and compare the results.
The validation process times out.

The default validation process timeout is configured for five seconds in BMC Helix Innovation Studio. If required, you can increase it up to 30 seconds. The minimum supported value is one second.

To edit the validation process timeout, follow the steps:

  1. Log in to BMC Helix Innovation Studio and navigate to the Administration tab.
  2. Select Digital Workplace Catalog > Service Request.
  3. In Validation Process Timeout (In seconds), set the increase the number of seconds.
  4. Click Save.
Validation appears disabled after a service with process validation is imported from another environment.

Clear the browser cache and reload the page.



Was this page helpful? Yes No Submitting... Thank you

Comments