Forms
You can build a form to collect information from your users.
Important
You may be restricted from collecting certain personal information and other regulated sensitive information via Forms. This may include restrictions set forth in your company’s contract(s) with SailPoint. Consult with your Legal Department before proceeding.
Your company is charged with obtaining consent from data subjects before collecting any additional personal information via Forms.
Should you have any questions, contact your Legal Department.
Forms are composed of sections and fields. Sections split the form into logical groups of fields and fields are the data collection points within the form. Configure conditions to modify elements of the form as the responder provides input. Create form inputs to pass information from a calling feature, like a workflow, to your form.
Forms can be used within workflows as an action or as a trigger. The Form Action allows you to assign a form as a step in a running workflow, suspending the workflow until the form is submitted or times out, and the workflow resumes. The Form Submitted Trigger initiates a workflow when a form is submitted. The trigger can be configured to initiate on submission of a full form, a form element with any value, or a form element with a particular value.
Building a Form
The form builder space allows you to add new sections and fields to create your form. Each form must start with a section and all form fields are nested within a section. Create a section and then add fields for your users to fill out. The field types include date, select, text, text area, and toggle fields.
To build a form:
-
Go to Admin > Global > Forms.
-
Select + New Form.
-
Enter a Name and Description for the new form.
-
Select Continue to Builder.
-
Select Add Section to begin building a form.
-
Add fields and configure them so users provide the correct information.
-
Add new sections if necessary.
-
Select Save after you have built your form.
Note
The maximum form size, including user responses, is 400 kilobytes. If it exceeds this size, the form cannot be saved or submitted.
Sections
Sections are used to split long forms into logical groups with similar fields. They can be styled with their own title and description. Any number of fields can be added to a section. A section without any elements can also be used as a title for a form.
To add a section in the form builder:
-
Select Add Section.
-
Enter a name for your section in the Section Header field.
-
Select whether to display the section header in the form using the Display toggle.
-
Choose the header style in the Section Header Text Style field.
-
(Optional) Add a short description that provides additional information about the section for the user in the Section Description field.
-
Select how you want the section header to align in the Section Header Alignment section.
-
After you have configured the section, select Apply.
-
(Optional) Select + Add to add a field to this section.
Fields
Fields are the different data collection points within a form.
Every field requires a label and a technical key. The label is the name displayed for the field element in the form. The technical key is the variable that stores the data for this element. When a form is submitted, the data for the form is sent to the workflow through this variable. The technical key is autogenerated from the element label after removing white spaces and special characters, and it is formatted in camel case.
In most cases, the technical key for a field should be unique. However, you can also use fields with the same technical key to ask different users the same question and show each user different sets of selectable answers based on their identity attributes.
For example, if you create an onboarding form asking your users to select their laptop, you might have different options for them based on their department. You can create a Select field for the options available to each department while keeping the same technical key for each laptop selection field. Then, use conditions to show your user only the field for their department.
By keeping the same technical key for all these fields, the workflow can consume the laptop selection data from a single variable instead of creating additional conditions.
Column Set
A Column Set allows you to create two columns that hold additional fields.
To add a Column Set to a section, select +Add and choose Column Set. After you have configured the columns, select Apply.
Field | Description |
---|---|
Column Set Header | Enter a name for the columns set. |
Display | Select whether to display the header above the column set. Note that if this is enabled, the columns will be displayed to the user even if there are no elements in the columns. |
Column Set Header Text Style | Choose the header style. |
Column Set Description | Add a short description that provides additional information about the column set for the responder. |
To add a field to the column set:
-
Select the add icon for the column you want to add to.
-
Choose the field type.
Date Field
A Date field allows responders to enter a date.
To add a Date field to a section, select + Add and choose Date Field. After you have configured the field, select Apply.
Field | Description |
---|---|
Label | The label that displays in the form for this field element. This has a maximum of 255 characters. |
Technical Key | The variable name to access this field in inputs, conditions, and workflows. |
Mark as required | Select whether a user is required to fill out this field. |
Help Text | This text displays under the label and offers guidance to the user. This has no character limit. The default help text is a date format based on the locale of the user's browser. Adding help text will overwrite the date format. |
Placeholder Text | Example text that displays in the field before user interaction. Note that placeholder text is only for guidance and will not be submitted by the form if the user does not enter a value for that field. |
Default Date | An actual date value that populates the field before the user has entered text. Default text overrides placeholder text. If the user does not enter a response in the field, the default value will be submitted. Enter a date or select the calendar icon to choose a date. |
Email Field
An Email field allows responders to enter an email address.
To add an Email field to a section, select + Add and choose Email Field. After you have configured the field, select Apply.
Field | Description |
---|---|
Label | The label that displays in the form for this field element. This has a maximum of 255 characters. |
Technical Key | The variable name to access this field in inputs, conditions, and workflows. |
Mark as required | Select whether a user is required to fill out this field. |
Help Text | This text displays under the label and offers guidance to the user. This has no character limit. |
Placeholder Text | Example text that displays in the field before user interaction. Note that placeholder text is only for guidance and will not be submitted by the form if the user does not enter a value for that field. |
Default Email Address | An actual email address value that populates the field before the user has entered text. Default text overrides placeholder text. If the user does not enter a response in the field, the default value will be submitted. Enter an email address. |
Phone Field
A Phone field allows responders to enter a phone number that will automatically format according to the country conventions of the entered phone number.
To add a Phone field to a section, select + Add and choose Phone Field. After you have configured the field, select Apply.
Field | Description |
---|---|
Label | The label that displays in the form for this field element. This has a maximum of 255 characters. |
Technical Key | The variable name to access this field in inputs, conditions, and workflows. |
Mark as required | Select whether a user is required to fill out this field. |
Help Text | This text displays under the label and offers guidance to the user. This has no character limit. |
Placeholder Text | Example text that displays in the field before user interaction. Note that placeholder text is only for guidance and will not be submitted by the form if the user does not enter a value for that field. |
Default Phone Number | An actual phone number value that populates the field before the user has entered text. Default text overrides placeholder text. If the user does not enter a response in the field, the default value will be submitted. Enter a phone number. |
Select Field
A Select field creates a pre-populated dropdown list for the responder to select from. Populate the dropdown by using a search query, selecting a predefined list from IdentityNow, or entering a list of static options. The user will then use the dropdown to make one or more selections in the form based on the configuration.
There are three types of Select fields that you can build: - Static - Select the Static option to manually add the options you want to display for your user in the select field. - There is no character limit for the Static Values field. - There is no limit to the number of values that can be added to this field. - The values appear in the order in which they are added. - You can allow your users to enter their own custom selection in this field.
-
Predefined
- Select the Predefined option and choose a type of object. The user will select from a list of identities, roles, access profiles, sources, or entitlements based on your selection.
- This option only allows users to make a selection. There is no option for your user to enter a custom selection.
- This dropdown list displays up to 250 results at a time and can be narrowed down by searching for a value.
-
Search
- Select the Search option to show the results of a search query you enter within the dropdown list displayed to the user.
- If the search query returns more than 10,000 items, only the first 10,000 items will be returned.
Caution
If the query you enter returns no results, and this field is marked as required, users might not be able to submit the form.
To add a Select field from the form builder, select + Add and then choose Select Field. After you have configured the field, select Apply.
Field | Description |
---|---|
Label | The label that displays in the form for this field element. This has a maximum of 255 characters. |
Technical Key | The variable name to access this field in inputs, conditions, and workflows. |
Mark as required | Select whether a user is required to fill out this field. |
Help Text | This text displays under the label and offers guidance to the user. This has no character limit. |
Placeholder Text | Example text that displays in the field before user interaction. Note that placeholder text is only for guidance and will not be submitted by the form if the user does not enter a value for that field. |
Require Selection | Enable this toggle to require users to select an option from the pre-populated list. Disable this toggle to allow users to either choose an option from the pre-populated list or to enter their own custom response. This is only available for Static and Search option types. |
Maximum Selection | Select the maximum number of options a user can select in this field. |
Option Type | Choose between static, predefined, or search. |
If you selected Static: | |
Select Values | Enter custom options to populate a dropdown field in the form. Select + Add to add additional values. |
If you selected Predefined: | |
Predefined Values | Select an object type for which all values will display. |
If you selected Search: | |
Search Query | Enter a search query |
Category | Select a category to search within to narrow the results. |
Attribute to Display | Choose which attribute to display in the dropdown list of search results. |
Text Field
A Text field allows responders to enter a custom response in a single line.
To add a Text field to a section, select + Add and choose Text Field. After you have configured the field, select Apply.
Field | Description |
---|---|
Label | The label that displays in the form for this field element. This has a maximum of 255 characters. |
Technical Key | The variable name to access this field in inputs, conditions, and workflows. |
Mark as required | Select whether a user is required to fill out this field. |
Help Text | This text displays under the label and offers guidance to the user. This has no character limit. |
Placeholder Text | Example text that displays in the field before user interaction. Note that placeholder text is only for guidance and will not be submitted by the form if the user does not enter a value for that field. |
Default Text | An actual value that populates the field before the user has entered text. Default text overrides placeholder text. If the user does not enter a response in the field, the default value will be submitted. |
Text Area Field
A Text Area field allows users to enter a custom response in a larger text box.
To add a Text Area field to a section, select + Add and choose Text Area Field. After you have configured the field, select Apply.
Field | Description |
---|---|
Label | The label that displays in the form for this field element. This has a maximum of 255 characters. |
Technical Key | The variable name to access this field in inputs, conditions, and workflows. |
Mark as required | Select whether a user is required to fill out this field. |
Help Text | This text displays under the label and offers guidance to the user. This has no character limit. |
Placeholder Text | Example text that displays in the field before user interaction. Note that placeholder text is only for guidance and will not be submitted by the form if the user does not enter a value for that field. |
Default Text | An actual value that populates the field before the user has entered text. Default text overrides placeholder text. If the user does not enter a response in the field, the default value will be submitted. |
Resize | Enable this toggle to allow the responder to resize the text area box as needed. This is only for visual purposes. There is no data limit in this field. |
Rows | Select the number of rows for the default size of the text area element. The maximum number of rows you can select is 20, but there is not a row limit to how much data can be entered. If the data exceeds the chosen number of lines, a scroll bar will appear. |
Toggle Field
A toggle field captures true or false responses in the form. The toggle itself is customizable. You can set the default state of the toggle as well as create custom labels for both the true and false states.
To add a Toggle field to a section, select + Add and choose Toggle Field. After you have configured the field, select Apply.
Field | Description |
---|---|
Label | The label that displays in the form for this field element. This has a maximum of 255 characters. |
Technical Key | The variable name to access this field in inputs, conditions, and workflows. |
Help Text | This text displays under the label and offers guidance to the user. This has no character limit. |
Default State | Choose whether the toggle displays as true or false before user interaction. |
True Label | Choose a label to display when the toggle is set to true. |
False Label | Choose a label to display when the toggle is set to false. |
Settings
On the Settings page, you can edit the form details, add inputs, and create conditions for the form. From the form builder, select the Settings icon . Form inputs and conditions work together to pass data from a workflow into a form.
Details
From the Details page, you can edit the name and description of the form.
-
Go to Settings > Details.
-
Make any changes to the name and description.
-
Select Apply to apply your changes.
-
Select the Exit icon
to exit the Settings page.
-
Select Save to save your changes.
Form Inputs
Form inputs are used when you want to send data from a workflow to a form, using the Form Action step in a workflow. These inputs use dynamic data from the workflow to pre-populate the form and determine which conditional form elements to display to the user completing the form. From the Form Inputs page, you can create variables with unique names. These inputs are used to build conditions in your form. Data is then passed from a workflow into the form using these variables and conditions.
-
Go to Settings > Form Inputs.
-
Select + New Input.
-
Enter a unique name for the variable. The name must be at least 3 characters long.
-
(Optional) Enter a description for the variable.
Repeat steps 2-4 until you have created all necessary inputs, up to a maximum of 20 inputs.
-
Select Apply.
-
Select the Exit icon
to exit the Settings page.
-
Select Save to save your changes.
You must create conditions using these inputs for the data to get passed from the workflow into the form.
Conditions
Conditions allow you to change the fields that are shown to users based on how the user answers previous questions in the form, or based on the data passed in to the form from a workflow. Conditions consist of rules and effects.
A rule uses a comparison operator to compare a selected technical key or form input to a value and evaluates it as true or false. You can create multiple rules in a condition. Rules will be applied in the order they appear. An effect is a state that a form element takes if the conditions of the rule are met. You can add multiple effects for the same condition, applying the effects to the same or multiple form elements. Effects will apply in the order they appear.
Note
If you have multiple effects set for the same form element that contradict each other, the last listed effect will remain.
To create conditions for your form:
-
Go to Settings > Conditions.
-
Select + Create New.
-
Configure the criteria that must be met for this condition. This is the rule of the condition.
-
To add additional rules to the same condition, select + Add and configure the additional fields, up to a maximum of 20 rules per condition.
-
Select Any or All on the toggle to indicate when the effects apply.
-
Configure how the form elements will be impacted when the criteria for this condition are met. This is the effect of the condition.
-
To add additional effects to the same rule, select + Add and configure the additional fields, up to a maximum of 20 effects per condition.
-
After you have configured your condition, select Apply.
-
Select the Exit icon
to exit the Settings page.
-
Select Save to save your changes.
Field | Description |
---|---|
If | Select a technical key or form input to compare with another value within the rule. |
Comparison Operator | Select a comparison operator that compares the selected technical key or form input to the string value. |
String Value | Enter a value to compare to the technical key or form input in the If field. |
Any or All | Choose whether Any or All of your rules must be met for the effects to apply. Select Any to apply the effects if one rule is met. Select All to require all rules to be met for the effects to apply. |
Action | Select an action to apply to the selected element if the rule or rules are met based on your configurations. |
Element | Select a form element for the action to apply to. |
The comparison operators compare the form element with the selected technical key or form input to the string value. The available comparison operators are:
Operator | Description |
---|---|
Equals | The form element value is equal to the entered string value. |
Does Not Equal | The form element value is not equal to the entered string value. |
Contains | The form element value contains the entered string value. |
Does Not Contain | The form element value does not contain the entered string value. |
Is Empty | The form element value is empty. If this operator is selected, the String Value field becomes disabled. |
Is Not Empty | The form element has a value. If this operator is selected, the String Value field becomes disabled. |
Ends With | The form element value ends with the entered string value. |
Does Not End With | The form element value does not end with the entered string value. |
Includes | The form element value includes the entered string value. This operator only applies to form elements with multiple selections allowed. |
Does Not Include | The form element value does not include the entered string value. This operator only applies to form elements with multiple selections allowed. |
Starts With | The form element value starts with the entered string value. |
Does Not Start With | The form element value does not start with the entered string value. |
The actions are how the selected field element will be changed when the criteria of the condition are met. The available actions for the effect are:
Action | Description |
---|---|
Hide | Hides the selected form element. |
Show | Shows the selected form element. |
Enable | Enables the selected form element to allow user input. |
Disable | Disables the selected form element. Users can see the form element but cannot interact with it. |
Set Default Value | Sets a default value for the form element from a selected form input. Use the From dropdown to select the form input you want to use for the default value. Note that users are still able to change this value. If you want to set a default value that cannot be changed, add another effect. Set the Action to Disable and select the same form element. This will set the default value and make the element read-only. |
To create conditions using defined form inputs:
-
Go to Settings > Conditions.
-
Select + Create New.
-
In the If field, select the form input you want.
-
Set the Comparison Operator to Is Not Empty.
-
Select All on the toggle to indicate when the effects apply.
-
Set the Action to Set Default Value.
-
In the From field, select the form input you want to be the default value.
-
In the Element field, select the form element to apply the default value to.
-
(Optional) To make the default value read-only:
a. Select + Add to add another effect.
b. Set the Action field to Disable.
c. In the Element field, select the same form element.
-
After you have configured the condition, select Apply.
-
Select the Exit icon
to exit the Settings page.
-
Select Save to save your changes.
Managing a Form
The Forms page is a centralized location to manage your organization’s forms. You can view details, edit, delete, and duplicate a form. You can also view the workflow or list of workflows currently using the form.
Editing a Form
To view and edit the details of a form, select the name of a form.
On the Details tab, you can view and edit the name and description. You can also view when the form was created, last modified, and who owns it. Select Save to keep any changes you make.
On the Used By tab, you can view which workflows are currently using the form. You can also select the link to go directly to Workflows list page.
Select Edit in Builder to edit the form.
Select the Delete Form icon to delete the form. Select Delete on the confirmation message to confirm that you want to permanently delete the form. You cannot delete a form that is used in a workflow.
If you did not make changes, select the Close icon to close the panel.
To edit a form, select the Edit in Builder icon .
In the form builder, you can edit, move, duplicate, or delete sections or fields.
To edit a field or section:
-
Select the Edit icon
on a field or section you want to edit.
-
Make any configuration changes and select Apply to apply your changes.
-
Select Save to save the form.
To move a field or section:
Fields and sections can be moved in the form builder by using the arrow icons or dragging and dropping them to the new location.
-
Select the Move Up icon
to move a field or section one space up in the form.
-
Select the Move Down icon
to move a field or section down one space.
The fields can be moved up or down within their current section or to other sections one space at a time using the arrows.
To drag and drop a field or section, select the entry you want to move and drag it to the new placement. Fields can be moved within a section or to a different section. Sections can be moved into a different order.
To duplicate a field or section:
-
Select the Duplicate icon
to create a copy of a field or section.
This opens the configuration panel for the new field or section.
-
Make the configurations you want.
-
Select Apply to save your changes and create the new field.
To delete a field or section:
-
Select the Delete icon
to delete a field or section.
Caution
This will immediately delete the field or section without confirming first.
Duplicating a Form
From the form manager, you can duplicate a form.
-
Select the Duplicate Form icon
.
The form is duplicated and added to the top of the form table with “Copy of” before the name of the duplicated form.
-
Select the new form name to edit the name and description of the new form.
-
Select Edit in Builder to continue editing the new form or Save to save the new details and return to the form manager.
Previewing a Form
Preview a form to ensure the form is functioning as expected. You can add values for inputs to test the form using different data sets.
Select Preview from the form builder. You can view the form as a user will receive it. Interact with any fields you would like to test.
If you want to test the form using inputs, select the Show icon to show the input fields. Enter inputs and values to test the form with different data sets. Select Test Validation to test the validations of the form.
When you are done previewing the form, select the Close icon or the Back icon
to go back to the form builder.
Completing a Form
When you assign a form to a user, they receive an email notification with a link to the form. This link is their only access to this form. When they follow the link, they are prompted to log in to IdentityNow and then brought directly to the form. Ensure the form is thoroughly defined so it tells your responder everything they need to know to fill out the form correctly. A responder cannot save and return to the form. They can leave and use the same link to get to the form again, but they will need to start over. If they have not filled out the form, a reminder email is sent to them. After the configured deadline has passed, the form is no longer available for submission.
Here is an example of what your form might look like to your users: