Defining a mediation contract using the Data Shaper workflow template

To properly configure Data Shaper and set transformation events, you need to define a mediation contract in Data Mover.

1. Go to Design → Contracts.

2. Click the New button.

3. In the INFO section:

   • Assign a unique Name to the contract.

   • Select MEDIATION from the Contract type drop-down list.

4. Click CONTINUE to proceed to the ACTION section.

1. In the ACTION section, choose the trigger that will initiate the workflow instance. For example, to start the action when a file is written to a specific VFS, select the New File trigger.

2. In the Workflows list, select the Data Shaper workflow to be used in the contract.

3. Click SAVE to continue.

Here, select the trigger that will initiate the workflow instance. For example, if you want the action to start when the file is written on a specific VFS, select the New File trigger.

After saving, you will be prompted to configure the actions for your contract.

The icon next to the Action Name indicates that the action variables have not yet been configured.

In the Source Virtual Path section, select the Actor, VFS, and virtual path where the source files are stored. Data Mover will retrieve the file from this path and apply the transformation defined in the workflow.

Select the Cluster.

Choose the Actor, VFS, and virtual path where the transformed file will be stored.

In the Datashaper Payload section, select the Data Shaper workflow to be used. This list displays workflows from the Asynchronous Web Service folder. For details on creating these workflows, refer to the Create a Web Service page.

In the figure below, you can see the workflows available in the Data Shaper Asynchronous Web Service folder (left) and the corresponding entries in the Datashaper Payload list of the mediation contract (right).

When the workflow is selected in the Datashaper Payload field, the associated variables will appear in the contract. Within these variables, you need to input the new value you want to assign to the variable's field. Once the contract is executed, the file will be updated with the new required values.

Read the Example Use Case below with a detailed scenario.

Once all variables are set, the icon will appear next to the Action Name, indicating that configuration is complete.

Click SAVE and your contract will now appear in the result list.

Example Use Case

Imagine a file containing a list of new hires, where:

• The field company must be updated to Primeur.

• A new field dep must be added with the value Delivery.

To achieve this:

1. In Design → Data Shaper, define a workflow that performs these operations and define the two variables (company, dep) to be modified.

2. In Design → Contracts, create a mediation contract that uses the workflow and specifies the values for the variables.

For example, given these variables in Data Shaper:

once the workflow is selected in the Datashaper Payload field, the associated variables will appear in the contract and you can assign the new values:

Tip: If the variables do not appear automatically, you can manually enter field-value pairs in the Workflow parameters edit box, separated by semicolons. Example: CA_company=Primeur;CA_dep=Delivery

Data Shaper workflows can be monitored and logs can be checked in Data Mover. For details, see the next page.