Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Use the WaitForAnyScreen method for Universal App Connector

Find one or more application screens and optionally, their child elements within a time period that you specify and then perform actions that you specify.

Before you begin

Role required: None

About this task

When you use the WaitForAnyScreen method, it tries to find a screen by matching the screen match rules within a specified duration. If it fails to find the screen within that duration, you may optionally enable it to perform an action by passing the control to another component through the ELSE port. Else, the WaitForAnyScreen method completes its execution. For the WaitForAnyScreen method to find a screen, the screen must be in an opened state.

Procedure

  1. Configure the UAC.

    To learn to configure the application screens and child elements, see Use the Universal App Connector.

  2. Under Global Objects, double-click the UniversalApplication object.

    The WaitForAnyScreen method appears in the Object Explorer pane.

  3. Drag the WaitForAnyScreen method to the Design surface.

  4. Configure the WaitForAnyScreen method.

    1. Select the settings icon (
Image omitted: uac-connector-settings-icon.png
Wait For Any Screen method settings icon.\).
2.  On the CHOOSE SCREENS window, select one or more application screens.

3.  Select **OK**.

    The application screen that you selected appears in the WaitForAnyScreen method.
Image omitted: uac-connector-captured-screen.png
Captured screen on the Wait For Any Screen method.
4.  Configure the parameters on the WaitForAnyScreen method.
ParameterDescriptionData Port typeData typeDefault valueMandatory?Notes
MatchAllChildrenIf set to `True`, the method also finds the child elements of the parent screen that you had captured by matching the attributes of the child elements.Data InBooleanFalseNo

Warning:

Setting this parameter to True may slow down the execution of the component.

TimeoutDuration in seconds within which the WaitForAnyScreen method tries to find the screen and, optionally, its child elements.Data InInteger30 secondsYes 
Application screenTitle of the application screen that you’ve selected in the CHOOSE SCREENS window. The component allows multiple window entries depending on the number of screens you had selected in the CHOOSE SCREENS window.Data OutNot applicableNot applicableNot applicableIf the WaitForAnyScreen method finds the first screen that is listed, the execution of the WaitForAnyScreen method completes.
ELSEExecutes another component or method if the WaitForAnyScreen method fails to find any screen within the duration specified in the Timeout port.Data OutNot applicableNot applicableNo 
  1. Double-click the required application screen or element and the Object Explorer pane is displayed listing the related methods.

    For example, if you select a Java application screen or element, the Java connector methods are displayed in Object Explorer.

    • For more information on Java connector methods, see Java connector methods.
    • For more information on Google Chrome and Microsoft Edge connector methods, see Chromium connector methods.

    • For more information on Windows connector methods, see Windows Connector methods.

    • If you have captured a web application screen and you want to execute a custom JavaScript on it, you can use the ExecuteJavascript method.

Parent Topic:Universal app connector