Skip to main content

Interrogation form in Pega Robot Studio

Interrogation form

In Pega Robot Studio, developers use the interrogation form as the standard method to interrogate Windows and web applications added to a solution. When an application project item opens in the designer window, the Interrogate button is displayed in the upper-left corner.

interrogation of targets

Clicking the button begins the interrogation process and displays the interrogation form. The interrogation form displays the Pega-defined Standard properties for the application project item. Developers edit these properties within the form during interrogation and in the Properties window both before and after interrogation.

Screenshot showing the interrogation form.

With the interrogation form open, you interrogate an application control by dragging the bullseye icon over the specific control required in an automation. For example, as part of the CRM project, you create an automation for the login process. The application login has a user name field, password field, and login button. You capture the fields and buttons to interrogate the login process. Once you identify the controls, you create an automation using these controls for the login process.

Controls sometimes do not display until other actions occur, such as hidden menu items on a web page. For example, some web controls require the pointer to hover over a menu to display the sub-menu item that you wish to interrogate. The delay option allows you to configure a time delay in seconds to perform the necessary mouse or keystroke actions before interrogating the needed control.

Screenshot showing the interrogation form delay

Previously captured controls appear both in the drop-down list in the interrogation form and the Palette in Pega Robot Studio. During the interrogation process, you switch the interrogation form’s focus between these previously interrogated controls. Switching between these controls allows you to perform the following functions:

  • Rename the control to match your naming convention
  • Set standard properties for the control
  • Test the functionality of the control to ensure that it performs as expected
  • Assess the match rule type
Note: Clicking View Match Rules allows you to view the match rules detail in the application designer.

Target Properties and Testing are not available if the control is not matched. The interrogation form allows you to save time during development by providing a mechanism that does not require you to shift your focus away from the application project item you are interrogating.

Screenshot showing dropdown menu in Robot Studio interrogation form.

The More menu to the right of the drop-down list displays an action menu for the selected control, allowing you to refresh the control properties, delete the control, highlight the control inside the interrogated project item. You also collapse or expand all sections in the interrogation form.

more icon on the interrogation form

Control properties

Interrogation creates both controls, which represent application objects, and targets that directly correspond to application objects. Within the interrogation form, the Properties and Target Properties sections allow you to modify the most important values for both controls and targets. You edit properties and design names within the interrogation form by clicking in the drop-down area and entering the desired name. Editing a target property determines if the selected control responds to needed behaviors in an automation, such as text input. The interrogation form displays different properties depending on the type of selected object.

Screenshot showing control properties in Robot Studio interrogation form

Match rules

Pega Robot Studio uses Match rules to match a target in an application to a control. When a control does not have a matching application target, automation is not possible. Controls should only match a single target unless keying is enabled. If an application or a web page updates, it is recommended to review match rules if controls are no longer matching their targets. To learn more about how match rules work, see the Match Rules module within the course.

The interrogation form displays the match rules in use for the selected control and a button to view the match rule details in Pega Robot Studio.

 
Screenshot showing match rules section in Robot Studio interrogation form.

The system displays a warning icon if a match rule is not currently matching for the selected control. Clicking the View Match rules to edit the match rule if necessary to identify discrepancies and investigate them quickly.

Control testing

You can test controls by invoking the most commonly used methods specific to that control type from within the interrogation form. Testing controls at interrogation time helps you determine what precise control this method responds to and if the automation will be successful. The Use Highlight function also allows you to determine if the correct control is interrogated.

For example, you invoke the PerformClick method on the login button to confirm it receives the method and clicks. In the image below, the available methods for the txtCredentials control are highlighted. By expanding each method, you enter method parameter values and execute the method.

interrogation form testing methods

In the Palette, you test controls by right-clicking the object and selecting Test Control Methods from the list of all available methods for that control.

test control methods

The control selected determines the methods available for testing, and check the Show Inherited checkbox to see the full list of methods. For example, a text box can have an AppendText method to test automated text input in the interrogated control.

show inherited checkbox

Check your knowledge with the following interaction.


This Topic is available in the following Module:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice