Function Name |
EDI Data Target | ||||
Category |
EDI | ||||
Icon |
 |
||||
Description |
Allows data to be written to an EDI document. | ||||
Inputs |
|
||||
Outputs |
|
||||
Properties |
|
||||
Usage
The EDI Data target makes it possible to create EDI documents within the Data Mapper.
Creating an EDI data source
To begin, drag the EDI Source component from the EDI section of the Component Palette onto a new Data Mapper file.
This will cause the wizard to launch
This wizard page makes it possible to select the required EDI standard.
Once a standard has been selected the next button is enabled and we can move onto the next wizard page.
The default terminators and separators will be selected based on the standard selected on the previous page.
These are common default values, however the files you need to write may use different values and so you should change these values as appropriate.
These values are set when you first run the Wizard, however you can change them inside the Data Mapper by selecting the Component and selecting Properties from the right click menu.
Write End of Line
When checked, each segment is written to a new line.
If it is not checked, the entire EDI document is written onto a single line.
Write Missing Trailing Components
When checked, separators are added for all empty components within an element.
If it is not checked, then trailing empty components are omitted.
Write Missing Trailing Elements
When checked, empty fields and separators are added for all empty Elements within a segment.
If it is not checked, then trailing empty elements are omitted.
Pad Fields to Minimum Length (0s and spaces)
When checked, all fields (Elements and Components) are padded to the Minimum Length specified in the standard. Text fields are right padded with spaces, and numeric fields are left padded with zeros.
If it is not checked, then the fields are written using the specified values and any padding should be done using components within the Data Mapper transform before connecting to the EDI Target Component.
Pad Empty Fields to Minimum Length
When checked, all empty fields (Elements and Components) are padded to the Minimum Length specified in the standard using spaces.
If it is not checked, then the fields are written with empty values and any padding should be done using components within the Data Mapper transform before connecting to the EDI Target Component.
Truncate Fields to Minimum Length (0s and spaces)
When checked, all fields (Elements and Components) are truncated by removing zeros and spaces to the Minimum Length specified in the standard. Text fields have trailing spaces truncated from the right, and numeric fields have leading zeros truncated from the left.
If it is not checked, then the fields are written using the specified values and any truncating should be done using components within the Data Mapper transform before connecting to the EDI Target Component.
Truncate Fields to Maximum Length
When checked, all fields (Elements and Components) are truncated to the Maximum Length specified in the standard. Text fields are truncated from the right, and numeric fields are truncated from the left.
If it is not checked, then the fields are written using the specified values and any truncating should be done using components within the Data Mapper transform before connecting to the EDI Target Component.
Write UNA Segment (EDIFACT ONLY)
When checked, the optional UNA segment is written into the output using the values set in the writer properties.
If it is not checked, the optional UNA segment is omitted from the output.
Use UNA Syntax Version 4 (EDIFACT ONLY)
Only available when Write UNA Segment option is selected.
When checked, the 'Repetition Separator' value is written as UNA position 5 in the output.
If it is not checked, the UNA position 5 is written as a space character in the output.
When the wizard is complete pressing the Finish button will created the EDI Source on the transform.
Inputs
The component has a root input called 'Filename', each value provided to this is treated as a filename and a new EDI document is created.
If the 'Filename' input (and the 'Data' Output) is not connected then the "Default Target Uri" is used (see properties window).
The child inputs are all specific to the EDI standard you selected when the component was created.
Outputs
The Data output returns the resulting EDI document as a string. This allows it to be consumed by other components rather than just being written to a file.
If the Data output is connected the Default Target Uri property is ignored.
It is an error to have connections to BOTH the Data output and the Filename input.