Integrating an external data source

1. In the Pega instance for the challenge, click Launch Pega Infinity™ , and then log in as an Administrator by entering the following credentials:
   1. In the User name field, enter CSSystemAdmin.
   2. In the Password field, enter password123!.
2. In the header of Dev Studio, click Launch Portal > Data Portal.
3. In Data Portal, click Create > Data and integration designer.
4. In the Create Data and integration designer dialog box, configure your entity:
   1. In the Choose an option section, select Existing entity,
   2. In the Select entity section, click Contact.
   3. In the Select an action section, select Integrate with Data sources.
   4. Click Submit.
      
5. Configure the source details:
   1. In the Select profile section, click Go, and then select the Contact Data Page.
   2. In the Profile list, select CONTACT_DETAIL, and then click Submit.
   3. In the Source details section, in the Select Source Connector section, click New.
   4. In the Source type list, select REST, and then select Replace.
   5. Click Continue.
6. Configure the connection details:
   1. In the System Name field, enter ExternalCon.
   2. In the Resource Name field, enter Con1.
   3. In the Endpoint URL field, enter http://localhost:8080/prweb/PRRestService/test/01-01-01/getContactData/ContactId
   4. In the Resource path parameters, select the ContactId parameter.
   5. In the Authentication section, click Add authentication to configure the authentication service.
   6. Select Define New.
   7. In the User name field, enter serviceuser.
   8. Click Set password, enter password123!, and then click Submit.
   9. Click Continue.
7. Configure the request response:
   1. Click Add a REST response.
   2. In the ContactId parameter, enter ContactId, and then click Run.
      Note: The dialog box displays the data for the contact named Pat Smith. This is the one contact in our external data source.
   3. Click Submit, and then click Continue.

8. In the Visual mapper, click the Request tab, and then to the right of the ContactId parameter, select Key.
9. In the Visual mapper, map the base properties.
   1. Click the Response tab, and map the Source fields to the Target fields for the following properties:

      Source	Target
      FirstName	.FirstName
      LastName	.LastName
      ContactId	.ContactId

   2. Click Continue.
   3. On the Review and save page, click Finish. The Designer displays the Configure mapping page. If you get a page error, refresh the browser page, and then click Go to display the Configure mapping page.

10. Map the Page properties for primary address.
    1. In the Configure the mapping section, click Response mapping, The Edit Data Transform page shows the three fields entered earlier: .FirstName, .LastName, .ContactID
       Note: When mapping properties on the Edit Data Transform page, if you delete an entry, click Save to save your changes. You will see an error message. Refresh the page to continue to add entries.
    2. Click Add element, then select the Action named Append and map to. In the Clipboard field, enter .AddressList; in the Relation field, select An array of objects.
    3. Add subentries for the following .AddressList properties. Click Add element to add each field.

       Clipboard	Source JSON
       .Line1	AddressLine1
       .Line2	.AddressLine2
       .City	City
       .RegionID	State
       .PostalCodeID	Zip

    4. Collapse the .AddressList entries.

11. Map the Page list property for phone number.
    1. Click Add element, then select the Action named Append and map to. In the Clipboard field, enter .PhoneList; in the Relation field, select An array of objects.
    2. Under .PhoneList, add a subentry with Clipboard value .PhoneNumber and Source JSON value MobilePhone.
    3. Collapse the .PhoneList entry.
12. Map the Page list property for email address.
    1. Click Add element, then select the Action named Append and map to. In the Clipboard field, enter .EmailList; in the Relation field, select An array of objects.
    2. Under .EmailList, add a subentry with Clipboard value .Email and Source JSON value Email.
    3. Click Save.to close the Edit Data Transform page.
    4. In the Configure the mapping section, click Submit.
13. At the top of the Case, click the Test Entity Stage.
14. In the Run entity section, in the ContactID field, enter ContactId, and then click Run Data Page.
    Note: The page displays the properties for the Pat Smith contact.

15. Click Submit. The Designer displays the Case Summary.
16. Click Resolve.
    Note: The Data Integration Designer completes integration of the data source and resolves the Case.
    

You can now view the data from the external source in your Contacts.

In the navigation pane of the Data Portal, click Contacts, and then select any contact in the list.
The contact details now show the data from the external source