Changing the data source of a data page
After running the Integration wizard, open the data page to replace the source with the connector to indicate where to source information from, and then set up your mapping transforms.
- In the navigation pane of Dev Studio, click .
- Search for and open your data page.The example used in this is particular data integration scenario uses the default D_Contact_Details data page.
- In the Data Sources section, in the
Source field, change the data source into an
aggregated data source.
Note: It is recommended to use an aggregated data source because aggregated data sources support a much larger set of use cases, for example, multiple connector calls and post-call enrichment. - In the Aggregate source name field, enter the name of your source, for example, Con, to indicate a contact.
- In the Source field, select Connector.
- In the Type field, select REST.
- In the Name field, enter or select your GetContact connector.
- In the Request Data Transform field, enter
GetContact_Down and then click
Open to create and configure the transform.Setting up the Down request data transform indicates mapping to the integration data model.
Note: Pega uses a naming convention for the request and response data transforms. It is recommended to name the request data transform: your method name_Down. For example, GetContact_Down. The same rule applies to the response data transform: your method name_Up. For example, GetContact_Up. The _Down suffix maps to your connector (your integration data model), and the _Up suffix maps from your connector (to the Pega Customer Service contact data model). It is not recommended to use the _Request and _Response naming convention because if you are calling a service it will be flipped. - In the Context section, point to your application layer.
- Click Create and open.
- In the Action field, select Set.
- In the Target field, press the Down arrow key,
and then enter .request.query_GET.ContactId,
based on the structure created by the system.
Note: Depending on your business needs and how your connector is structured, your .request.query_GET.ContactId structure will vary. The .query_GET is always a part of a GET method request, but if you passed parameters instead of a query string or added headers when running the Integration wizard, the Target field will look different. - In the Source field, enter your ContactId value, which is specified on the Parameters tab on the data page.
- Click Save.
- Under the Request Data Transform field, click
Parameters, select the Pass current
parameter page check box, and then click
Submit.When you select the Pass current parameter page check box, the system passes the current parameters from the Parameters tab of the data page.
- In the Response Data Transform field, enter
GetContact_Up and then click Open
to create and configure the transform.Setting up the _Up request data transform indicates mapping from the integration data model.
- In the Context section, point to your application layer.
- Click Create and open.When you create data transforms directly from the data page, the system prepopulates the Definition tab with useful actions, for example error handling, which you can enable by right-clicking an action and selecting Enable.
- In the 1.1 row, in the Action field, change the default value to Set.
- In the 1.1 row, in the Target field, enter .FirstName.
- In the 1.1 row, in the
Source field, press the Down arrow key, and
then enter .response_GET.Contact.FirstName.
Note: The response data transform is the same as the response XML parse Map to key , on the Methods tab of the REST connector: response_Method.Class name.Property, for example, respone_GET.Contact.LastName. An example GetContact_Up data transform setup for multiple properties - Click Save.
- Under the Response Data Transform field, click Parameters, select the Pass current parameter page check box, and then click Submit.
- If the endpoint URL is different than the endpoint URL in the connector rule,
in the Endpoint URL field, enter the correct URL.
An example connector setup on the data page screen - Click Save.
Previous topic Creating a REST integration by using the Integration wizard Next topic Editing data source rules