Defining an Object Control with the PRIMO Container Editor

The PRIMO Container Editor defines application object controls that Certify Silverlight cannot recognize and test. Certify Silverlight is the only Worksoft interface the PRIMO Container Editor supports.

This tool should only define objects you cannot learn with Certify Silverlight Learn and Certify LiveTouch.

To define an object control with the PRIMO Container Editor:

Open the application in which you need to learn an object.
Open the PRIMO Container Editor for PRIMO Controls by completing one of the following tasks:

From the Tools menu, select Configure > Interfaces > PRIMO.
From the Certify Silverlight Learn menu, select Tools > PRIMO Library Manager to open the PRIMO Configuration Editor.

The PRIMO Container Editor for PRIMO Controls opens.

In the PRIMO Container Editor, verify that the Basic option is selected.
In the right Controls pane, click Button.

A button control is defined as anything that you can click on the application and acts like a button.

The Edit Control Definition for New Button dialog opens.
In the right panel of the Control tab, enter a name for the control definition in the Name text field.
Click the Image tab.

The Image tab is where you will define the image that will be used to identify this control.

The left Preview pane is initially empty but will be populated as you continue to define the control. The right pane is where you configure the Tolerance option.
If needed, adjust the Tolerance option.

The default value is 99, meaning that the template image must match the image in the application under test to be considered a match. The lower the value, the more areas on the screen it will match.
To begin your capture, click the Ellipse… icon in the right pane and select Capture.

The Edit Control Definition tool minimizes, and the application appears in a dim mode that indicates the Capture mode is activated.
Position the mouse cursor to the upper left corner of the object control, draw a red box around the item as closely as possible, and release the mouse button.

The Edit Control Definition tool reappears, and the selected object control appears in the Image tab. The defined image may appear to be cut off, but the entire image is stored with the definition.
To test that the captured image, click Highlight Matches.

The Edit Control Definition tool minimizes, and the application appears with the captured image highlighted. You can see if the right captured image is highlighted and if you need to adjust your tolerance level when you capture this image. The Edit Control Definition tool reappears after a few seconds.
Click Save to save the image to the database.
Close the PRIMO Container Editor.
Use Certify LiveTouch for Silverlight to learn this added object control.

For more information about how to use Certify LiveTouch, see Adding Steps to Processes with Certify LiveTouch.
To verify that this object was learned, go to the Steps tab of the Process Editor and find the new object control name in the Object column.