Difference between revisions of "Fusion Transformer"
(→Structure Transformation) |
(→Data Transformation) |
||
Line 76: | Line 76: | ||
=Data Transformation= | =Data Transformation= | ||
+ | The Data Transformer can be run by executing the command: | ||
+ | |||
+ | java -cp FusionTransformer.jar org.bis.fusion.dataparser.DataParserMain | ||
+ | |||
+ | The following additional arguments are available: | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! 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- | ||
+ | |- | ||
+ | |} |
Revision as of 06:09, 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
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- |