LiveCycle Workbench ES Help
Creating Processes > Implementing Business Logic > Configuring events to control flow in a process > Creating filters and data maps for events

Creating filters and data maps for events

Filters and data maps are used in events for different purposes:

• A filter specifies the conditions that must be met for an event to be received. That is, the filter must resolve to true for an event to be received.
• A data map specifies the data that is stored when an event is received. This allows you to select data from an event and assign it to process variables, thereby passing data back into the process for use in a later step.

  Note:   For start points, any data being mapped from an event to a process variable requires that the variable be defined as an input variable.

Event filters and data maps both use expressions of a similar form:

   expression1 operation expression2

• For filters, expression1 is an XPath expression that evaluates to the event template or the process data tree. The operator is an arithmetical operator that you choose. expression2 is an XPath expression that evaluates to a literal value or a value from the event template.
• For data maps, expression1 is an XPath expression that evaluates to a variable in the process data tree. The operator is always the equal sign (=). expression2 is an XPath expression that evaluates to the value of a variable in the source data.

The exact format of the expressions depends on the type of event and the variables in the event template and process data tree.

In the following example event filter, if the creditscore event data item contains a value greater than 800, the filter resolves to true:

   /data/applicants/Applicant/creditscore > 800

In the following example data map, the expression maps a credit score from an application form into a variable for use later in the process.

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

An event filter can have multiple filter expressions. If more than one expression is present, all expressions must evaluate to true for an event to be received. If you do not specify any event filter expressions, the filter always resolves as true.

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

For both filters and data maps, you enter the expressions in the Properties dialog box for the event. You can enter the expression in these ways:

• Type the expression directly.
• Double-click a variable in the data tree box.
• Click the ellipsis button to display the XPath Builder dialog box, in which you can then create the expression.

To create an event filter or data map:

1. Open the Properties dialog box for an event.
2. Create the first expression of the filter or data map:
   • For a filter, create it in the Event Data Name box and then select an operator from the list.
   • For a data map, create it in the Process Data Name box.
3. Create the second expression for the filter or data map:
   • For a filter, create it in the Event Data Value box.
   • For a data map, create it in the Event Content box.
4. Click Add.
5. (Optional) Repeat steps 2 to 4 to create additional filter or data map expressions.
6. Click OK.

See also

Process variables

Process data model

Creating XPath Expressions

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/livecycle/es/wb_help/00000590.html

Add Comment