tEDIFACTtoXML - 6.3

Talend Open Studio for Big Data Components Reference Guide

EnrichVersion
6.3
EnrichProdName
Talend Open Studio for Big Data
task
Data Governance
Data Quality and Preparation
Design and Development
EnrichPlatform
Talend Studio

Function

This component reads a United Nations/Electronic Data Interchange For Administration, Commerce and Transport (UN/EDIFACT) message and transforms it into the XML format according to the EDIFACT version and the EDIFACT family.

Purpose

This component is used to transform an EDIFACT message file into the XML format for better readability to users and compatibility with processing tools.

tEDIFACTtoXML Properties

Component family

XML/Unstructured > EDIFACT

 

Basic settings

Schema and Edit Schema

A schema is a row description, it defines the number of fields to be processed and passed on to the next component.

The schema of this component is fixed and read-only, with only one column: document.

 

EDI filename

Filepath to the EDIFACT message file to be transformed.

 

EDI version

Select the EDIFACT version of the input file.

 

Ignore new line

Select this check box to skip carriage returns in the input file.

 

Die on error

Select this check box to stop Job execution when an error is encountered. By default, this check box is cleared, and therefore illegal rows are skipped and the process is completed for the error free rows.

Advanced settings

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a Job level as well as at each component level.

Global Variables

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl + Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio User Guide.

Usage

This component is usually linked to an output component to gather the transformation result.

Limitation

n/a

Scenario: From EDIFACT to XML

This scenario describes a simple Job that reads a UN/EDIFACT Customs Cargo (CUSCAR) message file and saves it as an XML file.

  1. Drop the tEDIFACTtoXML component and the tFileOutputXML component from the Palette to the design workspace.

  2. Connect the tEDIFACTtoXML component and the tFileOutputXML component using a Row > Main connection.

  3. Double-click the tEDIFACTtoXML component to show its Basic settings view.

  4. Fill the EDI filename field with the full path to the input EDIFACT message file.

    In this use case, the input file is 99a_cuscar.edi.

  5. From EDI version list, select the EDIFACT version of the input file, D99A in this use case.

  6. Select the Ignore new line check box to skip the carriage return characters in the input file during the transformation.

  7. Leave the other parameters as they are.

  8. Double-click the tFileOutputXML component to show its Basic settings view.

  9. Fill the File Name field with the full path to the output XML file you want to generate.

    In this use case, the output XML is 99a_cuscar.xml.

  10. Leave the other parameters as they are.

  11. Save your Job and press F6 to run it.

    The input EDIFACT CUSCAR message file is transformed into the XML format and the output XML file is generated as defined.