Integrating an external data source

Run the REST integration wizard to connect to the external data source.

1. On the exercise system landing page, click Launch Pega Infinity™ , and then log in as an Administrator by entering the following credentials:
   1. In the User name field, enter CommonAdmin.
   2. In the Password field, enter password123!.
2. In the header of Infinity Studio, click Configure > Integration > Connectors > Create REST Integration to run the New REST Integration wizard.
3. In the System details section, enter the following connection details:
   1. In the Name field, enter ExternalCon.
   2. In the Endpoint URL field, enter: http://localhost:8080/prweb/PRRestService/test/01-01-01/getContactData/ContactId
4. In the Resource path section, select the ContactId parameter.
5. In the Authentication section, click Add authentication to configure the authentication service:
   1. Select Define New.
   2. In the User name field, enter serviceuser.
   3. Click Set password, and then enter password123!.
   4. Click Submit.
6. Click Next to configure the resource methods.
7. In the Resource Name field, enter ExternalCon, and then click Next to configure the Data Model. This is the name you use to identify the REST resource in the Contact Data Page.
8. On the Data Model page, click Add a REST response.
9. In the Add a REST response dialog box, click Run to query the service and get a JSON response, which is shown in the following figure:
   
10. Click Submit to save the Data Model.
11. Click Next to review the configuration.
12. In the Data Layer section, select Skip (I'll do it later), and then click Create to create the REST connector.
    You do not need a new data layer, as you integrate the REST Connector with an existing data layer.
13. Wait for the generation to complete, and then click Close.
    Nota: If you receive a timeout error while creating the connector, refresh your browser page.

Create a copy of the Contact Data Page in your application ruleset.

1. In the navigation pane of Infinity Studio, click App, and then in the search field, enter Common-LDM-Entity.
2. Expand Contact > Data Model > Data Page.
3. In the Data Explorer, open the D_Contact Data Page.
4. Click Save as, and then on the new page, maintain the default context settings:

   Setting	Value
   Context	GoGoRoad
   Apply to	Common-LDM-Entity-Contact
   Add to ruleset	GoGoRoad:01-01-01

5. Click Create and open, and then click Save.

Copy the response Data Transform to your application Ruleset and modify the Applies to field to reference the REST service for the external data.

1. Open the D_Contact Data Page saved to your application ruleset (the one created in the previous task).
2. Click the target icon to the right of the Response Data Transform.
3. Click Save as.
4. In the Label field, enter: ExternalCon_Lookup_Response.
5. In the Context section, in the Apply to field, enter Common-LDM-Entity-Contact.
6. Click Create and open, and then click Save.
7. In the Definition tab, in Step 1, in the Action field, select Comment.
8. In the Target field, enter: This is the extension response data transform to map the response of the contact
9. Click Save.

Create the request Data Transform in your application ruleset and set the Applies to field to reference the REST service for the external data.

1. In the header of Infinity Studio, click Create > Data Model > Data Transform.
2. In the Label field, enter: ExternalCon_LookupDetail_Request.
3. In the Context section, in the Apply to field, enter Common-Int-External-ExternalConAPI.
4. Click Create and open, and then click Save.
5. Click the Pages & Classes tab:
   1. In the Page name field, enter ConnectorPage and in the Class field, enter Common-Int-External-ExternalConAPI.
   2. Add Page name Request and Class Common-LDM-Entity-Contact.
   3. Add Page name SettingsPg and Class Common-Admin-ApplicationSetting.
6. Complete the Definition tab:
   1. In row 1, in the Action field, select Comment. In the Target field, add: Set the connectorPage with request details.
   2. In row 2, in the Action field, select Update Page. In the Target field, enter ConnectorPage.request. In the Relation field, select with values from. In the Source field, enter Request.
   3. In row 2.1, in the Action field, select Set. In the Target field, enter Profile. In the Relation field, select equal to. In the Source field, enter SettingsPg.
   4. In row 3, in the Action field, enter UpdatePage. In the Target field, enter ConnectorPage.request. In the Relation field, select with values from. In the Source field, enter Request.
   5. In row 3.1, in the Action field, enter Set. In the Target field, enter ConnectorPage.request.ContactId. (Use lowercase "d" in "Id" to map to the external data.) In the Relation field, select equal to. In the Source field, enter Request.ContactID.
   6. In row 4, in the Action field, select When. In the Target field, enter Request.ContactID=="".
   7. In row 4.1, in the Action field, select Set. In the Target field, enter ConnectorPage.request.Contact.ContactID to map the contact ID to the external source. In the Relation field, select equal to. In the Source field, enter Request.ContactID.
   8. In row 5, in the Action field, select Update Page. In the Target field, enter Primary.
   9. In row 5.1, in the Action field, select Set. In the Target field, enter: .request.ContactId.
   10. In row 5.2, in the Action field, select Set. In the Target field, enter: .request.Profile.
   11. Click Save.

Modify the D_Contact Data Page in your application ruleset to reference the external REST source.

1. In the App Explorer, open the D_Contact Data Page.
   This Data Page is the version saved to the GoGoRoad Branch Ruleset.
2. In the Data Sources section, under IsLookUp, enter the external data source information:
   1. In the Source list, select Connector.
   2. In the Type list select REST.
   3. In the Name field, select ExternalCon.
   4. In the Request Data Transform field, enter ExternalCon-LookupDetail-Request.
   5. In the Response Data Transform field, enter ExternalCon-Lookup-Response.
   6. In the Endpoint URL field, enter http://localhost:8080/prweb/PRRestService/test/01-01-01/getContactData/ContactId.
   7. In the Method list, select GET.
3. Click Save to save the D_Contact Data Page.

Update the Response Data Transform to map data from the external source to your application.

1. In the App Explorer, open the ExternalCon_Lookup_Response Data Transform.
   This Data Transform is listed under the Common-LDM-Entity-Contact entity.
2. Click the Pages & Classes tab:
   1. Add Page name DataSource and Class Common-Int-External-ExternalConAPI
   2. Add Page name ConnectorPage and Class Common-Int-External-ExternalConAPI
   3. Add Page name Response and Class Common-LDM-Entity-Contact
   4. Add Page name SettingsPg and Class Common-Admin-ApplicationSetting
3. Complete the Definition tab:
   1. Add row 2, in the Action field, select Update Page. In the Target field, enter Primary. In the Relation field, select with values from. In the Source field, enter DataSource.
   2. Add rows 2.1 through 2.8 (click Add a row) to map the Target fields to the Source fields for the following properties to map fields from the external source.

      Action	Target	Source
      Set	.ContactID	.response_GET.ContactId
      Set	.FirstName	.response_GET.FirstName
      Set	.LastName	.response_GET.LastName
      Set	.PrimaryAddress.Line1	.response_GET.AddressLine1
      Set	.PrimaryAddress.Line2	.response_GET.AddressLine2
      Set	.City	.response_Get.City
      Set	.State	.response_GET.State
      Set	.PrimaryAddress.PostalCodeID	.response_GET.Zip

      For example, the ExternalCon_Lookup_Response Definition tab should now look like the example in the following figure:

      
4. To add a page for the Phone List, click Add a row (this should be row 3) and configure the following:
   1. In the Action field, select Append and map to.
   2. In the Target field, enter .PhoneList.
   3. In the Relation field, select a new page.
   4. In the second-level row (row 3.1), in the Target field, enter .PhoneNumber. In the Relation field enter equal to . In the Source field, enter Datasource.response_GET.MobilePhone.
   5. Right-click the second level row, and then select Add sibling below.
   6. Configure a Set action where .IsPrimary is equal to "true".
5. To add a page for the Email List, click Add a row (row 4) and configure the following:
   1. In the Action field, select Append and map to.
   2. In the Target field, enter .EmailList.
   3. In the Relation field, select a new page.
   4. In the second-level row, in the Target field, enter .Email. In the Relation field enter equal to . In the Source field, enter DataSource.response_GET.Email.
   5. Right-click the second level row, and then select Add sibling below.
   6. Configure a set action where .IsPrimary is equal to "true".
6. Click Save to save your changes to the ExternalCon_Lookup_Response Data Page.