Difference between revisions of "Fusion Transformer"

From Fusion Registry Wiki
Jump to navigation Jump to search
(Data Transformation)
(Data Transformation)
Line 79: Line 79:
  
 
  java -cp FusionTransformer.jar org.bis.fusion.dataparser.DataParserMain
 
  java -cp FusionTransformer.jar org.bis.fusion.dataparser.DataParserMain
 +
 +
For convenience there is a dataTransform.bat file provided that Windows users can use to launch the main class.
 +
 +
Example usage:<br>
 +
 +
dataTransform.bat -d TestData/inputData.ges -s TestData/inputDSD.ges -o output.xml -f compact<br>
 +
 +
For UNIX users there is an equivalent file: dataTransform.sh.<br>
 +
  
 
The following additional arguments are available:
 
The following additional arguments are available:

Revision as of 07:11, 9 June 2021

Overview

The Fusion Transformer is a command line application providing transformations between SDMX, and GESMES/TS data files and structure files.

The following data file formats are supported:

• Generic 1.0

• Generic 2.0

• Generic 2.1

• GenericTimeSeries (input only)

• Compact 1.0

• Compact 2.0

• StructureSpecific 2.1

• StructureSpecificTimeSeries 2.1 (input only)

• Message Group 1.0 (containing Compact or Generic Datasets only)

• Message Group 2.0 (containing Compact or Generic Datasets only)

• GESMES/TS


The following structure file formats are supported:

• SDMX Structure Document 1.0

• SDMX Structure Document 2.0

• SDMX Structure Document 2.1

• SDMX Registry Interface Document 2.0

• GESMES/TS


Structure Transformation

The Structure Transformer can be run by executing the command:

java -cp FusionTransformer.jar org.bis.fusion.dataparser.StructureParseMain


For convenience there is a structureTransform.bat file provided that Windows user can use to launch the main class.

Example usage:

structureTransform.bat -o ediStructreOut21.edi -s StructureOut21.xml -v edi

For UNIX users there is an equivalent file: structureTransform.sh.

The following additional arguments are available:

Argument Mandatory Description Allowed Arguments
-s <arg> False URI of structure file to transform. If this option is not specified or the argument is - then input is taken from Standard Input.
-o <arg> False Output file.

If this option is not specified or the argument is - then output is sent to Standard Output. ||

-v <arg> False The output version. edi / edi-lenient/ 1.0 / 2.0 / 2.1
-ug False If present will ‘upgrade group’ attributes in a SDMX v2.0 DSD to become a Dimension Group Attribute in v2.1. The Group will still be present in the DSD so the v2.1 Schema is backwards compatible with v2.0 (allowing data to be submitted as either a Group or Series level attribute). -No Arguments-
-edi_lenient False Puts the Transformer into EDI Lenient mode. -No Arguments-
-pretty_print False Outputs the SDMX-ML structures in a clearer fashion. -No Arguments-

Data Transformation

The Data Transformer can be run by executing the command:

java -cp FusionTransformer.jar org.bis.fusion.dataparser.DataParserMain

For convenience there is a dataTransform.bat file provided that Windows users can use to launch the main class.

Example usage:

dataTransform.bat -d TestData/inputData.ges -s TestData/inputDSD.ges -o output.xml -f compact

For UNIX users there is an equivalent file: dataTransform.sh.


The following additional arguments are available:

Argument Mandatory Description Allowed Arguments
-d <arg> False URI of data file to transform. If this option is not specified or the argument is - then input is taken from Standard Input.
-f <arg> True Output data format. compact / generic /edi
-o <arg> False Output file. If this option is not specified or the argument is - then output is sent to Standard Output.
-s <arg> True URI of structure file with DSD. 1.0 / 2.0 / 2.1
-v <arg> False Output SDMX Version if appropriate. -No Arguments-
-tf False Prevents the Time Format attribute from being output in SDMX-EDI. -No Arguments-
-edi_lenient False Puts the Transformer into EDI Lenient mode. -No Arguments-
-pretty_print False Outputs the SDMX-ML structures in a clearer fashion. -No Arguments-
-unify_monthly False Outputs SDMX-ML monthly data in the format YYYY-Mmm. -No Arguments-
-character_mapping False Enables character mapping mode. -No Arguments-
-edi_tf_attr False Creates the series attribute “Time Format” from an EDI input file. -No Arguments-