Concatenating Events

If you have several Events of the same type that form a logical entity, you can concatenate the Events in the same Message configuration.

PageIN example

If input data contains multi-page documents with different page layout, for example one layout on the first page and another layout on following pages, you can concatenate Events, i.e. create one PageIN Event for each page type in the same Message configuration.

Figure 52

Input with three different page layouts (page 1, 2, and 3).

Figure 53

Message configuration with three concatenated PageIN Events.

The fields defined in the concatenated Events will be appended to the same Message structure. When all fields are appended to the Message structure, it is passed on to the Process(es) in the Message.

Patterns

You must use different patterns, or multiple patterns, to specify when to trigger which Event.

Non-recurring fields

If non-recurring fields are defined in several Events, the StreamServer tries to add the same field to the Message structure several times.

If all documents in the input contains all page types defined by the concatenated Events, you should only define non-recurring fields once in all concatenated Events, and not once per Event.

If there are documents in the input that do not contain all page types, you need to define non-recurring fields in several Events. For example, if a non-recurring field normally is defined in the first of the concatenated Events, and the input document only contains the page type specified by the second Event, this field must also be defined, with the same name, in the second Event.

Recurring fields and blocks

You can use recurring fields and blocks from all concatenated Events when you configure the Process(es) in the Message configuration. Note though that all fields and blocks must have unique names.

Block priority

If you use block priorities to group blocks, you must make sure blocks of the same type have the same priorities in all concatenated Events.

To concatenate Events

1	Add the Events to the Message view and configure the Events.

2	Configure the Process(es).

3	Right-click the first Event and select Settings. The Event Settings dialog box opens.

4	On the Event Order tab, select the appropriate option (First, Repeating, or Last). See Ordering the concatenated Events.

5	Repeat steps 3 and 4 for all other Events.

Overriding Event order settings using scripts

You can use the EndMessage scripting function in a Retrieved script to override the Event order settings.