Document toolboxDocument toolbox

Detacher

Description

This unit is a Processor unit type.

A unit that transforms an event containing a list into a sequence of events containing successive list items. This can be done simultaneously over several lists (producing a zip, not a cartesian product).

You specify fields in the input event containing lists to be detached and transformed into individual values in the output events.

An event comes in through the in port. The init port emits a signal stream to indicate the start of a list.

The unit processes and transforms the lists into individual values. The end port emits a signal stream to indicate the end of a list.

If some of the specified fields are not present or don't have the correct type, the event is sent to the malformed output port.

Successful N output events are sent to the out port, N being the max length of lists. Each of these events will contain "a slice" of original lists at a growing index. For lists shorter than the longest one, corresponding values will be null.

Configuration

After dragging this unit into the Flow canvas, double-click it to access its configuration options. The following table describes the configuration options of this unit:

Tab

Field

Description

Tab

Field

Description

General

Name

Enter a name for the unit. It must start with a letter, and cannot contain spaces. Only letters, numbers, and underscores are allowed.

Description

Enter a description detailing the scope of the unit.

Fields

Click the plus icon to add fields containing lists.

You can collapse and expand the fields using the icon, reorder using the arrows, or delete using the X icon.

You can also reorder the fields using drag and drop.

Name

Enter the name of the field in the input event containing a list.

Array

Whether collection type is Array (true) or Collection (false).

Component type

Class of collection/array items. Enter a java class qualified name.

Input ports

Port

Description

Port

Description

in

All events enter through this port. They must contain fields specified in settings, and comply with the specified type.

Output ports

Port

Description

Port

Description

init

Signal stream that indicates the start of a list.

out

Outputs the events containing the same fields as input events, but with single values instead of lists.

end

Signal stream that indicates the end of a list.

malformed

Outputs input events that don't have the specified fields or type.