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 ().
   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.

      

   4. Configure the parameters on the WaitForAnyScreen method.

      Table 1. WaitForAnyScreen method parameters

      Parameter	Description	Data Port type	Data type	Default value	Mandatory?	Notes
      MatchAllChildren	If 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 In	Boolean	False	No	Warning: Setting this parameter to True may slow down the execution of the component.
      Timeout	Duration in seconds within which the WaitForAnyScreen method tries to find the screen and, optionally, its child elements.	Data In	Integer	30 seconds	Yes
      Application screen	Title 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 Out	Not applicable	Not applicable	Not applicable	If the WaitForAnyScreen method finds the first screen that is listed, the execution of the WaitForAnyScreen method completes.
      ELSE	Executes another component or method if the WaitForAnyScreen method fails to find any screen within the duration specified in the Timeout port.	Data Out	Not applicable	Not applicable	No

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