Changes for page 12 Validation and Transformation Language (VTL)

Last modified by Helena K. on 2026/06/10 10:09

From 10.10 to 10.9 From 11.1 to 10.11

From version 10.11

edited by Helena K.
on 2026/06/10 10:03

Change comment: There is no comment for this version

To version 10.10

edited by Helena K.
on 2026/06/10 10:00

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -376,15 +376,15 @@
  Given a [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] and some predefined [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] of its DataStructure, it is allowed to map the subsets of observations that have the same combination of values for such [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] to correspondent [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] [[datasets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].
--For example, assuming that the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] DF1(1.0.0) has the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]], TIME_PERIOD and COUNTRY, and that the user declares the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]] and COUNTRY as basis for the mapping (i.e. the mapping [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]): the observations that have the same values for [[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]] and COUNTRY would be mapped to the same [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] (and vice-versa). In practice, this kind mapping is obtained like follows:
++For example, assuming that the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] DF1(1.0.0) has the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]], TIME_PERIOD and COUNTRY, and that the user declares the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]] and COUNTRY as basis for the mapping (i.e. the mapping [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]): the observations that have the same values for [[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]] and COUNTRY would be mapped to the same [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] (and vice-versa). In practice, this kind (% style="color:#e74c3c" %)mapping(%%) is obtained like follows:
--* For a given [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], the user ([[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] definer) declares the DimensionComponents on which the mapping will be based, in a given order.{{footnote}}This definition is made through the ToVtlSubspace and ToVtlSpaceKey classes and/or the FromVtlSuperspace and FromVtlSpaceKey classes, depending on the direction of the mapping (“key” means “dimension”). The mapping of Dataflow subsets can be applied independently in the two directions, also according to different Dimensions. When no Dimension is declared for a given direction, it is assumed that the option of mapping different parts of a SDMX Dataflow to different VTL Data Sets is not used.{{/footnote}} Following the example above, imagine that the user declares the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]] and COUNTRY.
++* For a given [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], the user ([[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] definer) declares the DimensionComponents on which the (% style="color:#e74c3c" %)mapping(%%) will be based, in a given order.{{footnote}}This definition is made through the ToVtlSubspace and ToVtlSpaceKey classes and/or the FromVtlSuperspace and FromVtlSpaceKey classes, depending on the direction of the mapping (“key” means “dimension”). The mapping of Dataflow subsets can be applied independently in the two directions, also according to different Dimensions. When no Dimension is declared for a given direction, it is assumed that the option of mapping different parts of a SDMX Dataflow to different VTL Data Sets is not used.{{/footnote}} Following the example above, imagine that the user declares the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]] and COUNTRY.
  * The [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] [[Data Set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] is given a name using a special notation also called “ordered concatenation” and composed of the following parts:
  ** The reference to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] (expressed according to the rules described in the previous paragraphs, i.e. URN, abbreviated URN or another alias); for example DF(1.0.0);
  ** a slash (“/”) as a separator;{{footnote}}As a consequence of this formalism, a slash in the name of the VTL Data Set assumes the specific meaning of separator between the name of the Dataflow and the values of some of its Dimensions.{{/footnote}}
  ** The reference to a specific part of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] above, expressed as the concatenation of the values that the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] DimensionComponents declared above must have, separated by dots (“.”) and written in the order in which these DimensionComponents are defined{{footnote}}This is the order in which the dimensions are defined in the ToVtlSpaceKey class or in the FromVtlSpaceKey class, depending on the direction of the mapping.{{/footnote}}. For example
--POPULATION.USA would mean that such a [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] [[Data Set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] is mapped to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] observations for which the [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] //[[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]]// is equal to POPULATION and the [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] //COUNTRY// is equal to USA.
++POPULATION.USA would mean that such a [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] [[Data Set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] is (% style="color:#e74c3c" %)mapped(%%) to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] observations for which the [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] //[[INDICATOR>>doc:sdmx:Glossary 2\.1.Statistical indicator.WebHome]]// is equal to POPULATION and the [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] //COUNTRY// is equal to USA.
  In the [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] Transformations, this kind of [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] name must be referenced between single quotes because the slash (“/”) is not a regular character according to the [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] rules.