Click the Select button next to the Record structure field and
then, in the Select a
Structure dialog box that opens, select the
map you want to use and then click OK.

This structure must have been previously
created in
Talend Data Mapper
.

Select the Input
Representation to use from the drop-down
list.

Supported input formats are Avro, COBOL, EDI,
Flat, IDocs, JSON and XML.

Click Next.

Tell the component where each new record
begins. In order for you to be able to do so, you need to
fully understand the structure of your data.

Exactly how you do this varies depending on
the input representation being used, and you will be
presented with one of the following options.

1. Select an appropriate record
   delimiter for your data. Note that you must specify
   this value without quotes.

   • Separator
     lets you specify a separator indicator, such as
     , to identify a new
     line.

     Supported indicators are
     for a Unix-type new line,
     
     for Windows and
     for Mac, and for tab characters.

   • Start/End
     with lets you specify the initial
     characters that indicate a new record, such as <root, or the characters
     that indicate where a record ends.

     Start with
     also supports new lines,
     
     for a Unix-type new line,
     for Windows and
     for Mac, and for
     tab characters.

     Select the Regular
     Expression check box if you to wish to
     enter a regular expression to match the start of a
     record. When you select XML or JSON, this check
     box is selected by default and a pre-configured
     regular expression is provided.

   • Sample File: To test the
     signature with a sample file, click the
     […] button, browse to the
     file you want to use as a sample, click
     Open, and then click
     Run to test your
     sample.

     Testing the signature lets you check
     that the total number of records and their minimum
     and maximum length corresponds to what you expect
     based on your knowledge of the data. This step
     assumes you have a local subset of your data to
     use as a sample.

   • Click Finish.

2. If your input representation is COBOL
   or Flat with positional and/or binary encoding
   properties, define the signature for the input
   record structure:

   • Input Record root
     corresponds to the root element in your input
     record.

   • Minimum Record
     Size corresponds to the size in bytes
     of the smallest record. If you set this value too
     low, you may encounter performance issues, since
     the component will perform more checks than
     necessary when looking for a new record.

   • Maximum Record
     Size corresponds to the size in bytes
     of the largest record, and is used to determine
     how much memory is allocated to read the
     input.

   • Sample from Workspace or
     Sample from File System: To
     test the signature with a sample file, click the
     […]
     button, and then browse to the file you want to
     use as a sample.

     Testing the signature lets you
     check that the total number of records and their
     minimum and maximum length corresponds to what you
     expect based on your knowledge of the data. This
     step assumes you have a local subset of your data
     to use as a sample.

   • Footer Size
     corresponds to the size in bytes of the footer, if
     any. At runtime, the footer will be ignored rather
     than being mistakenly included in the last record.
     Leave this field empty if there is no footer.

   • Click the Next button to open
     the Signature
     Parameters window, select the fields
     that define the signature of your record input
     structure (that is, to identify where a new record
     begins), update the Operation and Value columns as
     appropriate, and then click Next.

   • In the Record
     Signature Test window that opens, check
     that your Records are correctly delineated by
     scrolling through them with the
     Back and
     Next buttons and performing
     a visual check, and then click
     Finish.

Map the elements from the input structure to
the output structure in the new map that opens, and then
press Ctrl+S to save
your map.

For more information on creating maps, see
Talend Data Mapper User Guide.