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 TestAppAdmin.
   2. In the Password field, enter password123!.
2. In the navigation pane of App Studio, start the designer tool.
   1. Click Tools > Data and Integration Designer.
   2. Click Launch Designer Tool.
3. In the Choose entity section, click Reuse from an existing entity, then select Contact, and then click Next.

   The Designer displays the Extend the Model stage.

4. At the top of the page, click the Manage integration stage.
5. Configure the source details:
   1. In the Select profile section, select the Contact Data Page.
   2. In the Profile list, select CONTACT_DETAIL, and then click Next.
   3. In the Source details section, under Select Connector, click Create Connector.
   4. In the Modification type list, select Replace connector.
   5. Click Next.
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 Next.
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 Next.

10. In the Visual mapper, click the Request tab, and then to the left of the ContactId parameter, select Parameter.
11. 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 Next.
    3. On the Review and save page, click Create. The Designer asks if you want to configure an additional profile.
    4. Click No and then select Next. The Designer displays the Review configuration page.

12. Map the Page properties for primary address.
    1. In the Data Transform section, click Response Data Transform, 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.

13. 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.
14. 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 the response data transform.
    4. Click Next.
15. At the top of the Case, click the Test Entity Stage.
16. 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.

17. Click Next. The Designer displays the Case Summary.
18. Click Resolve.
    Note: The Data and 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.

1. In the header of Dev Studio, click Launch portal > Data Portal.
2. In the left navigation of the Data Portal, click Contacts.
3. Select any contact.

The contact details now show the data from the external source