Customize

Display Dialog to Select Users from a List

Summary

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.

How to Use

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

Parameters

Set Message Text, List of Users to Select From, Selection Method, OK Button Label, Cancel Button Label, and Allow Unselected or not.

Message Text

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.

List of Users to Select From

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
    
    • The action “Get Users Belonging to a Group” or “Get Users Belonging to an Organization” returns various user attributes. However, the values selected from the “Display Dialog to Select Users from a List” do not include these attribute values.

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.

Selection Method

Select whether to choose a single user with a radio button or to allow multiple users to be selected using checkboxes.

OK Button Label

You can change the label displayed on the OK button using this parameter.

Cancel Button Label

To change the label displayed on the cancel button, use this parameter.

Allow Unselected or not

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.

Precautions

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.”

Restrictions

  • If the “Display Dialog to Select Users from a List” action is executed when another dialog is already open and the user has not yet closed that dialog, the already open dialog takes precedence, and the subsequently executed “Display Dialog to Select Users from a List” is ignored. In this case, the result of the “Display Dialog to Select Users from a List” action will be treated as canceled.