Contains the classes to {@link Int.ecb.gesmescb.xml.sdmx.v2.compact.CompactReader read} SDMX-ML, particularly the Compact Data Format.

Introduction

Support for reading data files expressed in the SDMX-ML Compact Data formats has been added to the Gesmes/TS Suite. This document describes how to use the Gesmes/TS suite to read data files expressed using the SDMX-ML Compact Data format.

Requirements for the input data file

The following requirements must be met in order for the suite to successfully parse the data file

  1. The data file must be a valid SDMX-ML Compact Data file, in version 1.0 or 2.0 of the SDMX standard.

  2. It must be possible for the suite to determine the key family used to define the data. This can be accomplished either by using the keyFamilyURI of the DataSet element or by using the KeyFamilyRef and KeyFamilyAgency elements of the Header element.

  3. When timestamps are used (such as in the Prepared element), the following format should be used: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]Z (e.g.: 2009-04-20T17:00:00+02:00)

Properties

No extra behaviour can be set via the properties.

To make use of the Reader, ensure that BatchTextUI will use an XMLReader and that the dataReader of said XMLReader is a compactReader:

# Tell BatchTextUI to use an XMLREader Int.ecb.gesmescb.application.BatchTextUI.dataReaderClass=Int.ecb.gesmescb.xml.XMLReader # Configure the XML Reader to use the compact format reader. Int.ecb.gesmescb.xml.XMLReader.dataReader.documentReader=Int.ecb.gesmescb.xml.sdmx.v2.compact.CompactReader

Furthermore you might want to set the logging level:

# When debugging some xml classes we might want to override the default: Int.ecb.gesmescb.xml.sdmx.v2.compact.HeaderReader.level=CONFIG Int.ecb.gesmescb.xml.SDMXMLWriter.level=FINE