Model data flows

Data flows define how data moves between activities and events and data elements in a process.

Data associations move the flow of data between data elements and the activities and events in a diagram.

A data association can have a data object reference, data input, data output or data store reference at one end as its source or as its target. The Data Input or Data Output of the flow element is at the other end of the Data Association.

You can model and edit a data flow using the Data flow tool or do it by manually modeling and editing it.

Data flow tool

Manually modeling data flows in complex processes can be error-prone and time-consuming. The Data Flow tool simplifies this by:

  • Guiding you through the creation process

  • Automatically validating associations

  • Highlighting errors before execution

You can model data flows starting from a single activity/event or two activities/events.

Before you begin

  • Define the data inputs and data outputs for each activity or event.

  • Ensure that data types (item definitions) match between connected elements.

From one activity or event

You can model a data flow starting with a single activity or event and associate it with multiple data inputs and/or data outputs.

The following is an example that starts with a single user task and creates a data input association and one data output association.

Data flow tool selected in the toolbar and options for creating associations.

  1. Select the user task.

  2. In the toolbar, click and select Create Data Input Associations.

  3. Select a data input association for the user task, then click Create.

    Shows input data options.

  4. Select the user task again.

  5. In the toolbar, click and select Create Data Output Associations.

    Shows the diagram after creating the output data association.

Between two activities or events

The following procedure is an example of how to model a data flow between two user tasks.

The example maps the flow of data that starts at the signing of a travel request form (‘Sign the form’) and ends with the request being approved (‘Approve travel request’). The aim is to associate the data outputs of ‘Sign the form’ with the data inputs of ‘Approve travel request’ and associate them using data elements — in this example, data object references. The data inputs and data outputs have previously been defined.

  1. Select the two User Tasks.

  2. In the toolbar, click and select the source of the data flow.

    The source, Sign the form, is the starting point for the flow of data.

    The data flow tool is disabled until you select an activity or event.

    Shows a two user tasks selected and the data flow tool selected in the toolbar.

    In the dialog box that opens, data associations are automatically created between the data outputs and data inputs of the two tasks.

    Create data flow dialog box showing data associations between the data inputs and outputs of the two tasks.

  3. Select the data inputs to be associated with the data outputs.

    When you select a data input, a data element is automatically created on the data output of the task.

    Create data flow dialog box showing how to select data inputs.

  4. Select the data element type.

    In this example, it’s a data object reference.

    Type the name of a data element in the field to find it faster.

    You can also create a data element by typing a name in the field and selecting the type of data element.

    Create data flow dialog box showing data element options.

  5. Once you’ve associated all the data inputs with data outputs, click Create.

    The data flow should look something like this:

    The complete diagram with tasks and data associations.

Manually create a data flow

To manually model a data flow you need to define the following elements in a diagram:

  • the data element
  • the activity or event
  • the data association connecting the data element to the activity or event

Before you configure a data association, you need a data element and an activity or event in the diagram that has a data association between them.

The order set out in this procedure is purely for the purpose of example. You can define the data association, data element and activity or event in the order you prefer.

For detailed information on how to define a specific element and its attributes, see the documentation for that element.

  1. Define the Data Element

    Select the data element and define its attributes.

    If you use a data object reference or a data store reference, you need to associate it with a data object or a data store.

    You can create a new data object or data store in the Attributes of the data object reference and data store reference:

    1. Click New.

    2. In the panel that opens, fill in the Name and (optional) Description fields and specify the Data Type (Item Definition) and Default value.

    3. Click Create and select.

  2. Define the Data Association

    The direction of the arrowhead of the data association determines whether the data element is a source for, or a target of, the activity or event.

    In the Attributes tab of the data association:

    • Click and select the Source Reference or the Target Reference from the dropdown list or create a new reference.

    To create a new reference:

    1. Click New.

    2. In the panel that opens, fill in the Name and (optional) Description fields and specify the Data Type.

    3. Click Create and select.