Storing event data to process variables

* New for 9.5 *

For event catches, receives, and start points, you can select data from an event and store it in process variables for use for a later step in the process. A process data map specifies the data that is stored when an event is acted on. You can store event data and event message data.

Hinweis: For event start points, any data being mapped from an event to a process variable requires that the variable is configured as an input variable. (See Process input and output data.)

Process data maps consist of expressions in the following form:

expression1 operator expression2

  • expression1 is an XPath expression that evaluates to a value in the process data tree.

  • operation is always the equal sign (=).

  • expression2 is an XPath expression that evaluates to a value in the event’s source data set or a value in the process data tree.

In the following example process data map, the expression stores a credit score from an application form in the creditscore variable.

/process_data/@creditscore = /data/applicants/Applicant/creditscore

A process data map can have multiple expressions. Each expression can map a different piece of data as required. If you do not specify any process data map expressions, no data is saved for later use in the process.

In addition to event data, you can send addition event message data for an event receive. The data that you receive is not typically altered during process execution because it is a document of record. The data can also be used by the process to validate the XML document structure.

Add a process data map

* New for 9.5 *

  1. If you are modifying an existing event receive, event catch, or event start point, right-click it and select Event Properties, otherwise, proceed to step 2.

  2. In the Process Data Map tab, click Add button.

  3. Click the ellipsis button beside the Process Data box.

  4. In the Asynchronous Event Receive Configuration dialog box, create the XPath expression to represent the process variable to store the event message data to, and click OK.

  5. Click the ellipsis button beside the Event Content box.

  6. In the Event Content dialog box, double-click the element representing the event data or event message data to store to the process variable and click OK.

  7. (Optional) Repeat steps 2 – 6 to add additional process data mappings. Click OK.

Edit a process data map

* New for 9.5 *

  1. If you are modifying an existing event receive, right-click an event receive and select Event Properties, otherwise, proceed to step 2.

  2. In the Process Data Map tab, select a process data entry and click the Edit button.

  3. In the Map Data dialog box, modify values in the Process Data and Event Content boxes, and click OK.

  4. Repeat steps 2-3 as necessary and click OK.

Delete a process data map

  1. If you are modifying an existing event receive, right-click an event receive and select Event Properties, otherwise, proceed to step 2.

  2. In the Process Data Map tab, select process data entry and click the Remove button.

  3. Repeat step 2 as necessary and click OK.