Handling Global Screens

You can set up global screen handlers while either recording or testing a task. To set up a global screen handler, you must record the screen and then define the AID key that you will use to dismiss the global screen and continue running the task.

The global screen handlers that you set up can be renamed or deleted as necessary.

To set up a global screen handler while recording a task
  1. Create a new project, connect to the host, and begin recording a task.

  2. Record the task up to the point where you want the host-initiated screen to display, then using the Task Builder auxiliary session or another alternative session, log in as a different user, bring up the host-initiated screen, and cause the intended global screen to display in the Task Builder session.

  3. When the global screen displays in the task you are recording, select  Mark Global Screens Toolbar Icon  Mark Global Screen from either the toolbar or from the Task menu.

  4. In the Mark Global Screen dialog box, name the global screen and choose OK. The newly named global screen is added to the Global Screen list.
    Note You can edit the global step properties for all global screens by selecting Global Screen Handlers from the Task list and then choosing the global screen you want to modify from the list of available global screens.

  5. Enter the AID key you want to use to dismiss the global screen and navigate away from the current, unrecognized step to the recognized destination step. This key is recorded as a transition action and can be edited in the global step properties pane.

  6. Continue recording the task. Mark the task endpoint and stop recording when the task is complete.

To set up a global screen handler while testing a task
  1. After recording your task, choose Test Task from either the Task Builder Guide or the Task menu.

  2. When the Unrecorded Screen dialog box displays, choose Continue.

  3. Select Mark Global Screen from either the toolbar or the Task menu. The unexpected screen will be marked as a global screen. After a screen has been marked as a global screen, Task Builder returns to record-mode.

  4. Enter the AID key that you want to use to dismiss the global screen and navigate away from the current, unrecognized step to the recognized destination step. This key is recorded as a transition action and can be edited in the global step properties pane.

  5. Continue recording your task. Mark the task endpoint and stop recording when the task is complete.
To rename and delete global screen handlers
  • To delete a global screen handler, select the global screen handler you want to delete from the global screen list and choose Delete from either the toolbar or the Edit menu.

  • To rename a global screen handler, from the Global Step Properties pane, edit the screen name value. The name of the screen marked as a "Global Screen" will be changed.

Customizing Global Screen Handlers

You can customize global screen handlers following the same procedure used for creating other custom steps. The global screen handler becomes the step that will be converted to a custom step. For more information, see Using Custom Steps.

Note It is important to carefully construct your recognition rules when using global screen handlers as well as when using custom steps. If a screen is not recognized by the Runtime Service, whether it has been customized or not, then the Runtime Service attempts to recognize a global screen handler, and if that is unsuccessful, the task will fail.
Related Topics
Bullet Handling Special Case Screens, Overview
Bullet Recording Tasks, Overview
Bullet Using Custom Steps
  Attachmate