Skip to main content

Adding and configuring adapters

2 Tasks

15 mins

Visible to: All users
Beginner Pega Robotic Automation 19.1 Robotic Process Automation English

Scenario

With the addition of the Customer Relationship Management and ACME Search System projects to the TrainingCertificationSln, the next step is to add the applications associated with each project. After reading the project documentation, the CRMPrj stores the Windows-based CRM application, and the ACMESearchPrj stores the ACME Search System web application. The ACME Search System operates within the Google Chrome browser. The project documentation also states that the ACME Search System application only starts when the location inquiry is requested. Any tabs or applications running within Chrome stay open when the ACME Search System application terminates.

The TrainingCertificationSln requires the addition and configuration of the Customer Relationship Management and ACME Search System applications.

Complete the following items:

  • Add a Windows adapter to the CRMPrj
  • Configure the Windows adapter
  • Add a universal web adapter to the ACMESearchPrj
  • Configure the universal web adapter

The following table provides the information you need to complete the exercise.

Item Name Properties
Customer Relationship Management application CRM Path = C:\Program Files (x86)\Openspan\CRM Setup\. (This is the default installation path for the CRM Setup.msi)
ACME Search System application ACMESystem

StartPage = https://training.openspan.com

StartOnProjectStart = False

BrowserType = Chrome

AcceptedDomains:

        Domain = training.openspan.com

        Mode = Contains

BrowserStopMethod = StopTrackedDocuments

Note: Prior to completing this challenge and all subsequent challenges for this Mission, you must install CRM Setup.msi, located in C:\Program Files (x86)\Pegasystems\Pega Robot Studio\Extras. For more assistance in installing the CRM application, see Completing the challenges in Pega Robot Studio.
Note: To automate a web application using Google Chrome, you must have the Pega Robotic Automation extension for Google Chrome installed and enabled. For instructions on installing the Chrome extension, see the Pega Community article How do I install the Pega Robotic Automation Google Chrome extension.

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

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

Detailed Tasks

1 Add and configure a Windows adapter

  1. In the Solution Explorer, right-click the CRMPrj to display a context menu.
  2. From the context menu, click Add Project Items to display the Add Project Items window.
    Screenshot showing the Add project items menu selection
  3. In the Add Project Items window, in the Adapters section, in the Windows Application row, click the Add icon.
    Screenshot showing the plus icon on the add project items window
  4. In the Add Windows Adapter window, in the Name field, enter CRM.os.
  5. To the right of the Path field, click Browse.
    Screenshot showing the Browse button next to the Path field on the Windows adapter window
  6. Navigate to the location of CRM.exe, and then click Open to update the Path property.
  7. In the Add Windows Adapter window, click the Add icon to complete the Windows application configuration.
  8. In the Add Project Items window, click Done to finish adding items to the CRMprj project.
  9. From the menu bar, select File > Save All to save the application to the solution.

2 Add and configure a web adapter

  1. In the Solution Explorer, right-click the ACMESearchPrj to display a context menu.
  2. On the context menu, click Add Project Items to display the Add Project Items window.
  3. In the Add Project Items window, in the Adapters section, in the Universal Web Application row, click the Add icon.
    Screenshot highlighting the Universal Web Adapter plus icon on the Add Project Items window
  4. In the Add Universal Web Adapter window, in the Name field, enter ACMESystem.os.
  5. In the Start Page field, enter https://training.openspan.com.
  6. To the right of the Accepted Domains field, click the ellipsis icon  to display the AcceptedDomain Collection Editor window.
    Screenshot highlighting the AcceptedDomains ellipsis
  7. In the AcceptedDomain Collection Editor window, click Add to add a new accepted domain.
  8. In the accepted domain properties pane, enter the following values:
    Property Value
    Domain training.openspan.com
    Mode Contains
    Screenshot showing the accepted domains configuration
  9. Click Ok to save the accepted domain properties.
  10. In the Add Universal Web Adapter window, click Add to complete the Windows application configuration.
  11. In the Add Project Items window, click Done to finish adding items to the ACMESearchPrj project.
  12. In the Object Explorer, click the ACMESystem object to display the adapter properties in the Properties window.
  13. In the Properties window for ACMESystem, update the StartOnProjectStart property to False.
    Screenshot highlighting the StartOnProjectStart property.
  14. From the menu bar, select File > Save All to save the changes.


Available in the following mission:

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