Display a dialog for selecting a user from the list of specified users.
It is possible to select users from the list displayed using radio buttons or checkboxes.
When the action is executed, a selection dialog will be displayed.
When a user selects an individual from the list in the dialog and clicks the “OK” button, the action is completed, setting the individual chosen as the result of the action.
To extract the individual chosen by the user, use an expression. The result value of the action will be a list combining the user’s Login name and Display name. Even if the selection method is a radio button, the result will be a list of one element.
For example, if the action to display the selection dialog is action number one, to set the result in the user selection field with the “Auto Input to Field” action, specify the “Value” parameter as follows.
=$1
Set Message Text, List of Users to Select From, Selection Method, OK Button Label, Cancel Button Label, and Allow Unselected or not.
Enter the text to be displayed in the message part of the dialog. This parameter is optional.
You can enter rich text in a rich editor for actions like “Display Information Dialog,” but for this action, only plain text is allowed.
Enter the users to be displayed in the list using an expression.
Entering the user’s Login name or Display name directly will result in an error at runtime. You need to specify the values of the user selection field and the result values of the action in the expression. For example, specify as follows:
User Selection Field Value
=User selection
The result of the action “Get Users Belonging to a Group” or “Get Users Belonging to an Organization” is as follows (This example is intended to demonstrate that the action number is 1.):
= $1
Besides the previous example, you can also use other actions or functions that return a list of users.
If the specified user’s list is empty, an error will occur at runtime.
Select whether to choose a single user with a radio button or to allow multiple users to be selected using checkboxes.
You can change the label displayed on the OK button using this parameter.
To change the label displayed on the cancel button, use this parameter.
Choosing “Allow Unselected” allows users to click “OK” even when no user is selected.
Choosing “Don’t Allow Unselected” will disable the “OK” button when the dialog is opened. After selecting a user, the “OK” button will be enabled. When there are no selected users, “OK” will be disabled again.
The action is completed when the user clicks “OK” or “Cancel” on the dialog and closes the dialog. The action is not completed when the dialog is displayed.
Even if a user clicks “Cancel”, the action will be completed.
When waiting for the completion of this action with the condition “When Another Action Complete”, please refer to the above note.
If you want to proceed with the action only when the “OK” button is clicked, and not when the “Cancel” button is clicked, use the condition “When OK Clicked in Confirmation/Input Dialog” instead of “When Another Action is Complete.”