Interrogating Windows and web applications

6 Tasks

30 mins

Pega Robotic Automation 19.1 (English)

Pega Robotic Automation 19.1 (日本語) Pega Robotic Automation 19.1 (Español) Pega Robotic Automation 8.0

Visible to: All users

Beginner Pega Robotic Automation 19.1 Robotic Process Automation English

Scenario

Your solution contains both projects and associated application adapters, and the next step is interrogation. The process calls for logging in to the CRM, displaying the customer information on a user interface, and adding a menu item for a future process. For the ACME Search System, the project documentation states to log in to the application and access the Stores link to search for the nearest store based on the ZIP code of the customer. The project documentation requires that the control names start with the application acronym. The ACME Search System login must also have at least four characters for both the user name and password fields. A hidden control on the sign-in page requires interrogation.

Interrogate the login controls, toolbar buttons, customer account information, and menu items in the CRM application by using the three methods: Interrogation target, Create Control, and Add Menu Items. Rename the objects in the Properties window during the interrogation process.

In this part of the solution, complete the following tasks:

• Interrogate the Windows application and the controls required for login, menu buttons, and customer information.
• Rename the Windows application controls.
• Interrogate the web application and the controls required for login, menu links, search criteria, and search results.
• Rename the web application controls.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

• Log In

Detailed Tasks

1 Interrogate a Windows application

1. Under the CRMPrj, in the Solution Explorer, double-click the CRM.os project item to open the adapter in the Designer Window.
2. On the CRM.os tab, click Start Interrogation to launch the CRM application as specified in the Path property and open an Interrogation Form dialog box.
   
3. On the Interrogation Form, click and drag the Target icon to the Login button.
4. On the Login screen, with the Login button highlighted, release the pointer to update the Object Hierarchy with the button control.
   
5. On the Interrogation Form, click and drag the Target icon to interrogate the User Name and Password fields and update the Object Hierarchy with the new controls.
   
6. On the Interrogation Form, in the Control name field, enter CRMtxtUserName to change the value.
   
7. In the Control name list, select txttxtPassword.
   
8. In the Control name field, enter CRMtxtPassword to change the value. 
9. On the Interrogation Form, repeat steps 7-8 to replace the object names in the Control name field with the updated names. 

   Object Name	Updated (Name)
   Login	CRMfrmLogin
   btnbtnLogin	CRMbtnLogin

10. With the interrogation still running, on the CRM application, click Login button to display the CRM window.

11. On the Interrogation Form, click and drag the Target icon to interrogate the New Call, User 1, User 2, and User 3 buttons to add the new controls to the solution.
    
12. On the Interrogation Form, in the Control name field, select and replace the object names with the updated names by using the following parameters:

    Object Name	Updated (Name)
    CRM_Subtraction_OpenSpan	CRMfrmMain
    Toolbar1	CRMToolBar
    btnbntUser1	CRMbtnUser1
    btnbntUser2	CRMbtnUser2
    btnbtnNewCall	CRMbtnNewCall
    btnbtnUser3	CRMbtnUser3

13. On the CRM toolbar, click New Call to display the New Call 1 window.

    Note: Your display settings may black out the Account Number field. Change the display to Windows Classic, if desired.
14. On the Interrogation Form, click and drag the Target icon to interrogate the following targets:
    • Account Number
    • Name
    • Street Address
    • City
    • State
    • ZIP
    
15. On the Interrogation Form, in the Control name field, select and replace the object names with the updated names by using the following parameters:

    Object Name	Updated (Name)
    MdiClient	CRMMDIClient
    CRMchild	CRMChild
    pnlCustomerInfo	CRMpnlCustInfo
    lbllblAcctNum	CRMlblAcctNum
    txttxtCity	CRMtxtCity
    txttxtName	CRMtxtName
    txttxtState	CRMtxtState
    txttxtStreetAdd	CRMtxtStreetAdd
    txttxtZip	CRMtxtZip

2 Interrogate a Windows application using Add Menu Items

1. With interrogation still running, in the Control Name field, select the CRMfrmMain object.
   
2. On the Interrogation Form, click the More icon, and then select Add Menu Items to display the Add Menu Items window.
   
3. In the Add Menu Items window, select the Orders Console check box.
4. In the Add Menu Items window, click the Close icon to close the window and save your selection.
   
5. On the CRM.os tab, in the design area, click Stop Interrogation to close the CRM application and the Interrogation Form window.
6. On the menu bar, click File > Save All to save the interrogation.

3 Interrogate a web application

1. In the Solution Explorer, double-click ACMESystem.os to open the adapter in a design tab.
2. On the ACMESystem.os tab, click Start Interrogation to open the Interrogation Form and browser.
3. With the Interrogation Form dialog option set as Default and the Create Global Web Page check box selected, click and drag the Target icon to interrogate the following targets:
   •  User Name
   •  Password
   • Sign In
     
4. On the Interrogation Form, in the Control name field, select and replace the object names with the updated names by using the following parameters:

   Object Name	Updated (Name)
   Sign_In_Pega_Training_Web_Appl	ACMEwpSignIn
   Please_enter_a_user_name_of_at_least	ACMEfrmCredentials
   Login_button	ACMEbtnSignIn
   textBox1 (user_password)	ACMEtxtPassword
   User_name	ACMEtxtUserName

5. On the Login page, in the User Name and Password fields, enter 1234 to enable the Sign In button.
6. On the Login page, click Sign In to open the Home Page of the website.
7. On the Interrogation Form, click and drag the Target icon to the Stores link to update the Object Hierarchy with the controls.
   Note: Make sure the smallest highlight box is displayed for the correct target.
   
8. On the Home page, click Stores to open the Stores search page of the website.
9. On the Interrogation Form, click and drag the Target icon to the Zip Code field and Find Store button to update the Object Hierarchy with the controls.
10. On the Interrogation Form, in the Control name field, select and replace the object names with the updated names by using the following parameters:

    Object Name	Updated (Name)
    Home_Pega_Training_Web_Applica	ACMEwpHome
    Stores	ACMElnkStores
    Stores_Pega_Studio_Training_Web_Ap	ACMEwpStores
    Search_by_ZIP_CodeSubtrationORSubt	ACMEfrmSearch
    Find_Store	ACMEbtnFindStore
    txtZip	ACMEtxtZip

11. On the Search page, in the Zip Code field, enter 30022.
12. On the Search page, click Find Store to display the Results page.

4 Interrogate using Select Element

Note: In the Select Element window, when you select an element tag, the application highlights the control to ensure that you select and create the correct control during the interrogation process.

1. On the Interrogation Form, in the Drag capture icon over controls list, select Select Element.
   
2. On the Interrogation Form, click and drag the Target icon to the store address to display the Select Element window.
   
3. In the Select Element window, select <TABLE>, and then click Create Control.
   The object collects all table rows as one unit to use for the address instead of each individual address item.
4. On the Interrogation Form, in the Control name field, select and replace the object names with the updated names by using the following parameters:

   Object Name	Updated (Name)
   Store_Locator_Pega_Studio_Training_We	ACMEwpResults
   Peachtree_City2715_Hwy_54_WPeachtr1	ACMEfrmStoreAdd
   Peactree_City2715_HWY_54_WPeachtre	ACMEtblNearestStore

5 Interrogate with Match Rules

1. On the Interrogation Form, in the Drag capture icon over controls list, select Default.
2. Click and drag the Target icon to the Home link to update the Object Hierarchy with the control.
   Note: Make sure the smallest highlight box is displayed for the correct target.
   
3. On the Interrogation Form, click View match rules to display the Match Rules tab for the control in Pega Robot Studio.
   
4. In the Match Rules tab, with the first control highlighted, select Property Match Rule from the drop-down list.
   
5. Click New to open the Match Rule Designer window.
6. In the Match Rule Designer window, select classname.
7. At the bottom of the Match Rule Designer window, click Create Match to add the HTML class a target match rule.
   Pega Robot Studio now matches only one target in the Match Rules tab.
   
8. On the Interrogation Form, click Clear Errors to clear the Match Rules error.
9. Rename the Home control to ACMEInkHome.
10. On the ACMESystem.os tab, click Stop Interrogation to close the browser window and Interrogation Form window.
11. From the menu bar, click File > Save All to save the changes. When complete, the Object Hierarchy looks like the following image:
    

6 Interrogate using Web Controls

1. On the ACMESystem.os tab, click Start Interrogation to open the Interrogation Form and browser.
2. On the ACMESystem.os tab, click the Web Controls tab.
3. On the Web Controls tab, in the Web Controls section, click List Browsers and Frames to list all open browser windows.
4. From the list, click Sign In.
5. In the Filter list, select INPUT type = 'Hidden'.
   
6. In the Web Controls section, click List Web Controls to display a text box control in the Control Type list.
7. In the Control Type list, right-click INPUT type='Hidden', and then select Create Control to display the control in the Object Hierarchy as pegasystem_version.
   
8. In the Object Hierarchy, click pegasystem_version.
9. In the Properties window, rename the design (Name) property to ACMElblVersion.
10. On the ACMESytstem.os tab, click Stop Interrogation to close the browser window and Interrogation Form window.
11. From the menu bar, click File > Save All to save your edits.

---

---

Available in the following mission:

• Robotics System Architect v2