Recipes and samples

Scenario: Creating a process for Application Integration-based enrichment

1. 1Create process objects to define input and output formats.
2. 2Create a process.

Step 1: Create process objects for input and output fields

1In Application Integration, create a folder within your project.
2Create a process object named System with a text field named groupId.
The following image shows a process object named System with a field named groupId:

3To define a set of fields that you want to accept as input fields from MDM SaaS, create a process object named InputAddress with the following fields:

Field	Label	Type
addressline1	addressline1	Text
postalcode	postalcode	Text
sys	sys	Reference Note: Reference the System process object that you created in step 2.

Note: Even though the request to AddressMaster requires a flat structure, you need a field group in this scenario because addressline1 and postalcode are child attributes of the Address field group in the Person business entity.
The following image shows a process object named InputAddress with the fields named addressline1, postalcode, and sys:

4To define a set of fields that you want to send back to MDM SaaS, create a process object named OutputAddress with the following fields:

Field	Label	Type
addressline1	addressline1	Text
addressline2	addressline2	Text
city	city	Text
state	state	Text
postalcode	postalcode	Text
country	country	Text
sys	sys	Reference Note: Reference the System process object that you created in step 2. If you include this parameter, the original field group entry is updated. Otherwise, a new field group entry is added to the record when a user accepts a CLAIRE recommendation.

The following image shows a process object named OutputAddress with the fields named addressline1, addressline2, city, state, postalcode, country, and sys:

5To define the payload for the request from MDM SaaS, create a process object named InputPayload with the following fields:

Field	Label	Type
Addresses	Addresses	ObjectList Note: Select the InputAddress process object that you created in step 3.
sys	sys	Reference Note: Reference the System process object that you created in step 2.

The following image shows a process object named InputPayload with the fields named Addresses and sys:

6To define payload for the response to MDM SaaS, create a process object named OutputPayload with the following fields:

Field	Label	Type
Addresses	Addresses	ObjectList Note: Select the OutputAddress process object that you created in step 4.
confidenceScoreInPercent	confidenceScoreInPercent	Text

The following image shows a process object named OutputPayload with the fields named confidenceScoreInPercent and Addresses:

7To define the request structure, create a process object named InputPerRecord with the following fields:

Field	Label	Type
payload	payload	ObjectList Note: Select the InputPayload process object that you created in step 5.
docId	docId	Text Note: docId is a required parameter in the response.

The following image shows a process object named InputPerRecord with the fields named payload and docId:

8To define the response structure, create a process object named OutputPerRecord with the following fields:

Field	Label	Type
docId	docId	Text
payload	payload	ObjectList Note: Select the OutputPayload process object that you created in step 6.

The following image shows a process object named OutputPerRecord with the fields named docId and payload:

Step 2: Create a process

1In Application Integration, create a process.
2In the Start Properties panel of the process, perform the following steps:
1. aClick the Start tab, and select Allow anonymous access.
2. bClick the Input Fields tab.
3. cSelect Whole Payload, add an input field named request, and set its type to List of InputPerRecord by selecting the InputPerRecord process object.
The following image shows the input field named request and its type as List of InputPerRecord:

4. dClick the Output Fields tab.
5. eSelect Whole Payload, and add an output field named response and set its type to List of OutputPerRecord by selecting the OutputPerRecord process object.
The following image shows the output field named response and its type as List of OutputPerRecord:

3Create a temp field named temp_recordId, and set its type to Text.
4Add an assignment step to the process.
5In the Properties panel of the assignment step, click the Assignment tab, and set the temp_recordId field to the $input.request[1]/docId formula.
Note: Additionally, you can create a process object that represents the request to the data provider. You can then assign the process input fields to the AddressMaster request fields. This sample process doesn't connect to a real data provider.
The following image shows that the $input.request[1]/docId formula is assigned to the temp_recordId field:

6Add an assignment step to the process.
7In the Properties panel of the assignment step, click the Assignment tab and perform the following assignment tasks:
1. aAdd a field named response.
2. bIn the Assigned Using field, select Formula.
3. cAdd the response that you want to send to MDM SaaS, such as the following sample response:
let $items :=
<Items>
<Item>
<Id>IN|LP|A|19635268|_ENG</Id>
<Type>Address</Type>
<Line1>Prakash 1;</Line1>
<Line2>Prakash Building 1 BG Kher Road</Line2>
<City></City>
<State></State>
<Country>United Kingdon</Country>
<PostCode></PostCode>
<Highlight>8-9,27-28,29-31;</Highlight>
<Description>Mumbai 400006</Description>
</Item>
<Item>
<Id>IN|LP|A|19637698|_ENG</Id>
<Type>Address</Type>
<Line1>Building 1;</Line1>
<Line2>BG Kher Road</Line2>
<City></City>
<State></State>
<Country>United Kingdon</Country>
<PostCode></PostCode>
<Highlight>8-9,27-28,29-31;</Highlight>
<Description>Mumbai 400006</Description>
</Item>
</Items>

return (
<OutputPerRecord>
<docId> {$temp.temp_recordId }</docId>
{
for $item in $items/Item
return (
<payload>
<confidenceScoreInPercent>70</confidenceScoreInPercent>
<Addresses>
<id>{$item/Id/text() }</id>
<addressline1>{$item/Line1/text()}</addressline1>
<addressline2>{$item/Line2/text()}</addressline2>
<city>{$item/City/text()}</city>
<state>{$item/State/text()}</state>
<postalcode>{$item/PostCode/text()}</postalcode>
<country>{$item/Country/text()}</country>
<sys>
<groupId> { $input.request[1]/payload[1]/Addresses[1]/sys[1]/groupId }</groupId>
</sys>
</Addresses>
</payload>
)
}
</OutputPerRecord>
)
$items represents a sample response from AddressMaster. In the return block, you can loop through the fields in the AddressMaster response and assign the required fields to the fields in the OutputPayload process object.
The following image shows that the response variable is assigned to a formula: