UiPath Activities

The UiPath Activities Guide

Check App State

UiPath.UIAutomationNext.Activities.NCheckState

Description

Checks the state of an application or web browser by verifying if an element appears in or disappears from the user interface, and can execute one set of activities if the element is found and a different set of activities if the element is not found. This activity must be added inside a Use Application/Browser activity.

Properties

Common

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

Misc

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

Options

  • Check visibility - If selected, the activity also checks if the target element is in the visible area of the user interface.
  • Timeout (seconds) - Specify the number of seconds for which to wait for the event (element to appear or to disappear). The default value is 5 seconds.
  • Wait for - Select which event to use for determining the state of the application or browser:
    • Element to appear - Wait for the element to appear in the user interface. If you select this option:
      • Add the activities to execute if the element appears in the Target appears block.
      • Add the activities to execute if the element does not appear in the Target does not appear block.
    • Element to disappear - Wait for the element to disappear from the user interface. If you select this option:
      • Add the activities to execute if the element disappears in the Target disappears block.
      • Add the activities to execute if the element does not disappear in the Target does not disappear block.

    Click Toggle View in the body of the activity to configure the visibility of the blocks where to add activities to execute depending on the state. You can work with both blocks, or either one of the blocks. By default, both blocks are visible.

Output

  • Result - Indicates if the element exists or not. The field supports only Boolean variables.

UiPath.UIAutomationNext.Activities.NCheckState

Description

Checks the state of an application or web browser by verifying if an element appears in or disappears from the user interface, and can execute one set of activities if the element is found and a different set of activities if the element is not found. This activity must be added inside a Use Application/Browser activity.

Configuring the Activity

In the Body of the Activity

  • Click Indicate target on screen to indicate the UI element to verify.
  • Wait for - Select which event to use for determining the state of the application or browser:
    • Element to appear - Wait for the element to appear in the user interface. If you select this option:
      • Add the activities to execute if the element appears in the Target appears block.
      • Add the activities to execute if the element does not appear in the Target does not appear block.
    • Element to disappear - Wait for the element to disappear from the user interface. If you select this option:
      • Add the activities to execute if the element disappears in the Target disappears block.
      • Add the activities to execute if the element does not disappear in the Target does not disappear block.
  • Click Toggle View in the body of the activity to configure the visibility of the blocks where to add activities to execute depending on the state. You can work with both blocks, or either one of the blocks. By default, both blocks are visible.
  • Seconds - Click Plus plus button on the right side of the field, and then select Number to enter the number of seconds for which to wait for the event (element to appear or to disappear). The default value is 5 seconds. Alternatively, you can use one of the other options in the menu to enter the duration:
    • Data from the Project Notebook or a parent Excel file. For example, select an Excel file, and then select a cell that contains a number.
    • Ask when run - Prompt for a number when the project is executed.
    • Open in Advanced Editor - Enter a VB expression.
  • After you indicate the target, click Menu Options button to access the following options:
    • 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

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

Misc

  • Private - If selected, the data used by the activity is not saved to the StudioX logs when the project is executed.

Options

Output

  • Result - A Boolean value (True/False) representing the result of the check. Optionally, you can save this value for later use, or save it in a cell in a parent Excel file or the Project Notebook.

Updated 19 days ago


Check App State


Suggested Edits are limited on API Reference Pages

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