Using the WinApp Helper Utility

The WinApp Helper Utility is a small stand-alone program you can use to copy text or capture images for test scripts. This utility can run on the server or a separate computer, and it shows the titles of all visible windows and all text and images (bitmap files) on the screen that the WinApp Monitor can read. 

Due to the nature of some Windows programs, it is not always possible to read all the text on screen. Citrix® host applications are an example where you can only read a Window’s title bar.

To use the Helper utility, complete the following steps:

1. From the Reveille Script Editor window, click Helper Utility. The Reveille WinApp Help Utility window appears.
2. Once a window title is selected in the list, then the x/y locations of the mouse pointer are shown relative to the window. The window stays on top of all other windows.
3. From the Reveille WinApp Help Utility window, click the selection in the WindowsTitle Bar. A capture of the selected window appears.
4. Click and drag over the image that you want to capture.
5. Hold down the left mouse button to select a clipped area.
6. Click Save Image, and save the image as a bitmap file.
7. From the Test Script Editor, select OnImage Command to browse from the appropriate Bitmap file saved using the WinApp Helper Utility.
8. Select WaitOnImage Command and assign the time (in seconds) to the Wait block to begin testing a window image. 

The WaitOn Image command works exactly like the other Wait Blocks. The image must be captured using the WinAppHelper on the client system because it creates a companion XML file describing the image details needed for comparison. The current window has focus in the one that is used for comparing to the saved image.

The following is a sample test script using the WaitOnImage command.

//Test OnImage Command

RunProgram "calc.exe"

WaitOnImage 5

   OnImage "<Reveille Installation Path>\Reveille Client\Images\calc.bmp"

            SendResponse "OK - Calc Image Found"

   EndOnImage

  OnImage "<Reveille Installation Path>\Reveille Client\Images\calckeys.bmp"

            SendResponse "OK - Calc Keys Image Found"

   EndOnImage

      OnTimeOut

            SendResponse "Fail - Image Not Found"

   EndOnTimeOut

EndWaitOnImage