People
Use the People form control to allow form users to search for and select users. The following users can be selected:
-
Users from the Nintex Automation Cloud user directory. Navigate to the User management page in the Settings menu to view the list of users. See, User management.
-
Users from the Azure Active Directory when it's configured in User directory lookup. For details on how to connect to the user directory, see User directory lookup.
-
The People control is supported only in authenticated forms. If the control is added to an unauthenticated form, you will not be able to search for users. Configure the start event to give form access to authenticated users in the tenant. For more information, see the Configure start event section in Nintex - Form.
-
The People control is always returned as a collection variable for both single and multiple selections, and is available as a Start event form variable in your workflow. To find the People control collection in the Insert variables panel or Variables panel, click Start event > Form variables > the people control collection. To access individual responses or form control values, use the Loop for each workflow action.
-
The People control is supported in Nintex Mobile version 10 and above.
Section | Setting | Description |
---|---|---|
(unlabeled) | Title |
The field name displayed on the published form. |
Customize |
Switch toggle to Yes to enable customization of the variable Name of the form control. |
|
Name |
(This field becomes configurable only when you switch the Customize toggle to Yes.) Customizes the name of the variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in the workflow, such as an email address. for the field. If the name is not customized, the Title will be used as the variable name. |
|
Allow multiple selections |
Toggle to allow selection of multiple inputs in the form field. Multiple users can be selected when the toggle is switched to Yes. The toggle is set to No, by default, and multiple selection is not allowed. |
|
Default value |
Default value for the form field. This value automatically populates the field when the form loads. Click in this field, and then click Insert to open the Formula builder where you can insert context variables and create and insert variables with applied formulas. |
|
Required |
Options to make the field a mandatory or optional field in the form. Select from the following options:
|
|
Custom required message |
(Displays when you select Yes in Required.) The validation text which displays below the field when a value is not entered into the field and the user attempts to change page or submit the form. |
|
Visible |
Options to show or hide the field in the form.
|
|
Read-only |
Options to make the field Read-only. Yes: Displays the field on the published form but does not allow user input. No: Allows user input. |
|
Placeholder |
The default text that is displayed in the field on the published form. This default text disappears when the user types the first character in the field. |
|
Description |
A description of the field to display below the field on the published form. |
|
Tooltip | The message that appears when users hover their cursor or touch the Information icon beside the field in the form. | |
Shrink |
Reduces the width of the control when placed in a row with other form controls. |
|
Expand |
Increases the width of the control when placed in a row with other form controls. |
|
Styling | CSS class |
Add a CSS class to apply a style to this form control. You can create the CSS class in the CSS code editor in form styles. Enter one class name or multiple class names separated by a space. For more information, see Add a custom CSS to individual controls. Note: The CSS Class field is available only if the Custom CSS setting is enabled in Nintex Automation Cloud Form settings. |
Border color |
Border color to apply to the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style. |
|
Control fill |
The color to fill the inside of the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style. |
|
Control input color |
The font color of the input in the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style. |