Setting up User Inputs
When a Variable is defined within an OpCon Event definition, it becomes available as a User Input. User Input fields display to users when they select the Service Request button.
By default, OpCon sets a new Variable as a User Input of type Text with no validation, allowing users to type any value. That text is placed in the OpCon Event just before SAM processes it.
User Input types
The following User Input types are available when configuring a Service Request:
| Type | Description |
|---|---|
| Text | Displays a text field. Supports validation rules such as minimum/maximum characters, restricted characters, regular expressions, and output formatting. |
| Number | Displays a numeric field with optional minimum and maximum value constraints. |
| Date | Displays a date picker with optional start date, end date, and date format settings. |
| Choice | Displays a list of predefined caption-and-value pairs for the user to select from. |
| Text Collection | Displays a multi-value text field. Supports delimiter configuration and optional duplicate restriction. |
| Master Job | Displays a job selector scoped to a master schedule. |
| Master Schedule | Displays a schedule selector from the master schedule list. |
Configure a User Input
To configure an individual User Input, complete the following steps:
-
Go to the Service Request definition page and locate the User Inputs list.
-
Select the User Input you want to configure, or select the Edit button next to it.
The Configure User Input page opens.
-
Enter a value in the User Input Caption field. This caption displays to users when they run the Service Request. If left blank, the Variable name is used.
-
Toggle the Required Variable option to require users to supply a value before submitting the Service Request.
-
Select a type in the User Input Type list.
-
Configure any additional settings that appear for the selected type.
-
Select OK to save, or Cancel to discard changes and return to the Service Request definition page.
Result: The User Input is saved with the selected type and settings. The updated caption and validation rules apply the next time a user runs the Service Request.
Reorder User Inputs
The order of User Inputs in the list determines the order in which fields appear to users when they run the Service Request.
To reorder User Inputs, complete the following steps:
- Go to the Service Request definition page and locate the User Inputs list.
- Use the up and down arrows next to a User Input to move it to the desired position.
Result: The updated order takes effect the next time a user opens the Service Request.