Professional Documents
Culture Documents
Purpose
Reformat changes the record format of data records by dropping fields, or by using DML
expressions to add fields, combine fields, or transform the data in the records.
Parameter
Count (integer, required)
Sets the number of:
out ports
reject ports
error ports
transform parameters
Default is 1.
transformn(filename or string, optional)
Either the name of the file, or a transform string, containing a transform function
corresponding to an out port; n represents the number of an out port. Transform functions
for Reformat should have one input and one output.
Select (expression, optional)
Filter for data records before reformatting.
reject-threshold (choice, required)
The component's tolerance for reject events. See AGGREGATE components.
output-index (filename or string, optional)
Either the name of a file containing a transform function, or a transform string. The
Reformat component calls the specified transform function for each input record. The
transform function uses the value of the input record to direct that input record to a
particular output port. The expected output of the transform function is the index of an
output port (zero-based). The Reformat component directs the input record to the
identified output port and executes the transform function, if any, associated with that
port.
When you specify a value for output-index, each input record goes to exactly one
transform/output port pair. For example, suppose there are 100 input records and two
output ports. Each output port receives between 0 and 100 records. According to the
transform function you specify for output-index, the split can be 50/50, 60/40, 0/100,
99/1, or any other combination that adds up to 100.
If you do not specify a value for output-index, Reformat sends every input record to
every transform/output port pair. For example, if Reformat has two output ports and there
are no rejects, 100 input records results in 100 output records on each port for a total of
200 output records.
MULTI REFORMAT
Multi Reformat changes the record format of data records flowing between from one to
20 pairs of in and out ports by dropping fields, or by using DML expressions to add
fields, combine fields, or transform the data in the records. A typical use for Multi
Reformat is to put it immediately before a custom component that takes multiple inputs.
It is recommended to keep Automatic Flow Buffering, the default, turned on for MULTI
REFORMat. This component reads input from its flows in a specific order. Thus, turning
off Automatic Flow Buffering could cause deadlock...
Parameter
Count (integer, required)
An integer from 1 to 20 (default is 1) that sets the number of each of the following:
in ports
out ports
reject ports
error ports
transform parameters
transformn (filename or string, optional)
Either the name of the file or a transform string, containing a transform function
corresponding to an input/output port pairing; n represents the index on the input/output
pairing. Transform functions for Multi Reformat have one input and one output.
reject-threshold (choice, required)
The component's tolerance for reject events. See AGGREGATE component.
Logging (boolean, optional)
Specifies whether or not you want certain component events logged. See
AGGREGATE component.
Runtime behavior of MULTI REFORMAT
The Multi Reformat component behaves as if it were n Reformat components, each with
no select clause.
The component operates separately on the data flowing between each pair of its inn-outn
ports. The count parameter specifies the total number of port pairs. Each inn-outn port
pair has its own associated transformn to reformat the data flowing between those ports.
Separate errorn and rejectn ports are also associated with each pair of inn-outn ports.
The ramp and limit parameters do not affect the overall ramp and limit for all ports, but
rather are applied to each in/out port pairing.
Multi Reformat also performs automatic flow buffering. It reads from and writes to ports
as they become available.