Subscribe

UiPath Activities

The UiPath Activities Guide

Select Item

UiPath.UIAutomationNext.Activities.NSelectItem

Description

Selects an item from a drop-down combo box or list box. After you indicate the element on screen, the list with all the available options is displayed in the activity. This activity must be added inside a Use Application/Browser activity.

Important:

Using this activity on a combo box or list box that has not been interacted with before you run the workflow can cause the activity to throw an error. The best practice to avoid this issue is to add a Click activity configured to click the target drop-down menu before the Select Item activity is executed.

Properties

Common

  • Continue on error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
  • Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
  • Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
  • DisplayName - The name displayed for the activity in the Designer panel. A display name is automatically generated when you indicate a target.
  • Timeout - Specify a number of seconds for which to wait for the activity to be executed before throwing an error. You can choose a predetermined value from the drop-down menu associated with this property field. The default value is 30 seconds.

Input

  • Item - Specifies the item to be selected from the combo or list box. After indicating an element on screen, the list with all the available options is displayed in the activity. You can also use wildcards (*) in this field
  • Target - Before indicating on screen the application you want to automate, this field is set to (null). Once the target is indicated, all properties regarding the element that was indicated are displayed.
    • Target.Check element visibility - If selected, checks whether the UI element is visible or not. By default, this check box is cleared.
    • Target.Click Offset - Specifies an offset for the click activity, which can be further configured.
    • Target.Click Offset.Anchoring Point - Describes the starting point of the cursor to which offsets from OffsetX and OffsetY properties are added. The following options are available: TopLeft, TopRight, BottomLeft, BottomRight, and Center. By default, Center is selected.
    • Target.Click Offset.OffsetX - Horizontal displacement of the cursor position according to the option selected in the Position field. This field supports only Int32 variables.
    • Target.Click Offset.OffsetY - VerticaldDisplacement of the cursor position according to the option selected in the Position field. This field supports only Int32 variables.
    • Target.Fuzzy selector - The parameters for the fuzzy selector.
    • Target.Native text - The text that is used to identify the target element.
    • Target.Selector - The selector that is generated for the indicated element.
    • Target.Targeting methods - The selector types that you want to use for identifying the element. This property can be set to any combination of Selector, Fuzzy selector, or Image.
    • Target.Wait for page load - Before performing the action, wait for the application to become ready to accept input. The following options are available:
      • None - Does not wait for the target to be ready.
      • Interactive - Waits until only a part of the app is loaded.
      • Complete - waits for the entire app to be loaded.
    • Target.Window selector (Application instance) - The selector that is used for the application window. Only applicable when the window attach mode is set to Application instance.

Input/Output Element

  • Input Element - The UI element on which the activity is executed, stored in an UIElement object. This field supports only UIElement objects. This object can be obtained from the Output Element property field of other UIAutomation activities.
  • Output Element - Outputs a target UI Element and stores it in a UIElement object, which can be further used to target the same element with other activities.

Misc

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Options

  • AlterIfDisabled - If selected, the Select Item action is executed even if the specified UI element is disabled.

UiPath.UIAutomationNext.Activities.NSelectItem

Description

Selects an item from a drop-down combo box or list box. After you indicate the element on screen, the list with all the available options is displayed in the activity. This activity must be added inside a Use Application/Browser activity.

Important:

Using this activity on a combo box or list box that has not been interacted with before you run the workflow can cause the activity to throw an error. The best practice to avoid this issue is to add a Click activity configured to click the target drop-down menu before the Select Item activity is executed.

Configuring the Activity

In the Body of the Activity

  • Click Indicate target on screen to indicate the list box or combo box from which to select the item.
  • After you indicate the target:
    • Click Select item menu on the lower-right side of the activity, and then select the item from the drop-down menu.
    • Click the Options Options button button and then select one of the available options to further configure your target.
      • Indicate target on screen - Indicate the target again.
      • Edit Target - Open the selection mode to configure the target.

For more information about indicating and configuring targets, see About the UIAutomationNext Activities Pack.

In the Properties Panel

Common

  • Continue on error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
  • Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
  • Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
  • DisplayName - The name displayed for the activity in the Designer panel. A display name is automatically generated when you indicate a target.
  • Timeout - Specify a number of seconds for which to wait for the activity to be executed before throwing an error. The default value is 30 seconds.

Input

  • Item - Specifies the item to be selected from the combo or list box. After indicating an element on screen, the list with all the available options is displayed in the activity. You can also use wildcards (*) in this field

Misc

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Options

  • AlterIfDisabled - If selected, the Select Item action is executed even if the specified UI element is disabled.

Updated 12 days ago


Select Item


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.