Work with Transformations

A transformation is a special type of data association between data types that don't match. For example, the service that you're calling in your process may return an employee representation that's slightly different than the one you have modeled on a data object. Using transformations you can associate and map these different data types.

Transformations are reusable; once configured, you can use them wherever applicable in your process application.

Transformations have their own icon, which slightly differs from the data association icon. As with data associations, the transformation icon Transformation icon is green when valid. When invalid, the icon is red and its error displays.

You can create and apply data transformations in the following ways:

  • Create and apply transformations while configuring data associations
  • Create individual transformations and then apply them to data associations

To create and apply transformations while configuring data associations:

  1. Select an activity in a process that needs data association and click More Options.
  2. Select Data Association and choose either Input or Output.
  3. Drag and drop the data objects into the input and output fields to configure an association. You can also begin typing and select from auto complete entries that display.
  4. Click the data association icon, and in the resulting dialog toggle the Transform button.
    The data association can be valid or invalid.
  5. The Transformations window (named based on the objects you selected) displays the list of transformations that match the source and target types.
    Click Create to create a new transformation.
  6. In the Transform dialog box, enter a name, and click Create.

    The Transform window displays. It looks and functions much like the data association editor, except that its left and right panes reflect the fields from the selected objects to transform.


    Description of data-transformation-config1.png follows
    Description of the illustration data-transformation-config1.png

    Note:

    You can also create transformations within transformations, that is, nested transformations. To create nested transformations, repeat steps 4 to 6 in the Transform window, and click Save.
  7. Click Save to save the transformation.

    Process Automation validates the new transformation, displaying a green transformation icon if valid or a red transformation icon with error if invalid. Note that you can save an invalid transformation and fix it later.


    Description of data-transformation-config2.png follows
    Description of the illustration data-transformation-config2.png

To create individual transformations and then apply them to data associations:

  1. Use the Actions button on top of the data association editor to open the All Actions window.

    The All Actions window displays all transformations that are defined for the process. Click Create, and select Transform.


    Description of data-transformation-config3.png follows
    Description of the illustration data-transformation-config3.png

    Note:

    Select Filter to create a filter. See Filter Arrays.

    Additionally, you can either edit or delete an existing transformation. To do so, click the edit or delete icon next to the transformation in the All Actions window.

  2. In the Transform dialog, enter a name for the transformation and select the source and target data objects.
  3. Click Create.

    In the Transform window, configure the transformation.

  4. Click Save.

    You've now created a transformation.

  5. In the data association editor, click the data association icon, and in the resulting dialog toggle the Transform button.
  6. The Transformations window displays the list of data transformations in the process application. Select a transformation that is applicable for the association and click OK.
  7. To apply a different transformation for an already configured transformation:
    1. In the data association editor, click the data transformation icon. The resulting dialog lists the transformations applicable for the association. Click change next to the transformation you want to update.
    2. Select another transformation from the Transformations window and click OK.