Changes for page 12 Validation and Transformation Language (VTL)
Last modified by Helena K. on 2026/06/10 10:09
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -55,7 +55,7 @@ 55 55 56 56 The [[SDMX-IM>>doc:Glossary.SDMX Information Model.WebHome]]-package-name** **is the concatenation of the string** **"[[sdmx>>doc:Glossary.Statistical data and metadata exchange.WebHome]].infomodel." with the package-name, which the [[artefact>>doc:Glossary.Artefact.WebHome]] belongs to. For example, for referencing a [[Dataflow>>doc:Glossary.Dataflow.WebHome]] the [[SDMX-IM>>doc:Glossary.SDMX Information Model.WebHome]]-package-name is "[[sdmx>>doc:Glossary.Statistical data and metadata exchange.WebHome]].infomodel.datastructure", because the class [[Dataflow>>doc:Glossary.Dataflow.WebHome]] belongs to the package "datastructure". 57 57 58 -The class-name is the name of the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] object class, which the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] object belongs to (e.g., for referencing a [[Dataflow>>doc:Glossary.Dataflow.WebHome]] the class-name is "[[Dataflow>>doc:Glossary.Dataflow.WebHome]]"). The [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] can reference [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[artefacts>>doc:Glossary.Artefact.WebHome]] that belong to the classes [[Dataflow>>doc:Glossary.Dataflow.WebHome]], [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension, [[Measure>>doc:Glossary.Measure.WebHome]], DataAttribute, (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%), [[Codelist>>doc:Glossary.Code list.WebHome]].58 +The class-name is the name of the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] object class, which the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] object belongs to (e.g., for referencing a [[Dataflow>>doc:Glossary.Dataflow.WebHome]] the class-name is "[[Dataflow>>doc:Glossary.Dataflow.WebHome]]"). The [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] can reference [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[artefacts>>doc:Glossary.Artefact.WebHome]] that belong to the classes [[Dataflow>>doc:Glossary.Dataflow.WebHome]], [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension, [[Measure>>doc:Glossary.Measure.WebHome]], DataAttribute, [[Concept>>doc:Glossary.Concept.WebHome]], [[Codelist>>doc:Glossary.Code list.WebHome]]. 59 59 60 60 The agency-id is the acronym of the agency that owns the definition of the [[artefact>>doc:Glossary.Artefact.WebHome]], for example for the Eurostat [[artefacts>>doc:Glossary.Artefact.WebHome]] the agency-id is "ESTAT"). The agency-id can be composite (for example AgencyA.Dept1.Unit2). 61 61 ... ... @@ -66,10 +66,10 @@ 66 66 67 67 DataStructure maintainable class, the maintainedobject-id is the name of the DataStructure (dataStructure-id) which the [[artefact>>doc:Glossary.Artefact.WebHome]] belongs to; 68 68 69 -* if the [[artefact>>doc:Glossary.Artefact.WebHome]] is a (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%), which is not maintainable and belongs to the ConceptScheme maintainable class, the maintainedobject-id is the name of the ConceptScheme (conceptScheme-id) which the [[artefact>>doc:Glossary.Artefact.WebHome]] belongs to;69 +* if the [[artefact>>doc:Glossary.Artefact.WebHome]] is a [[Concept>>doc:Glossary.Concept.WebHome]], which is not maintainable and belongs to the ConceptScheme maintainable class, the maintainedobject-id is the name of the ConceptScheme (conceptScheme-id) which the [[artefact>>doc:Glossary.Artefact.WebHome]] belongs to; 70 70 * if the [[artefact>>doc:Glossary.Artefact.WebHome]] is a [[Codelist>>doc:Glossary.Code list.WebHome]], which is a maintainable class, the maintainedobject-id is the [[Codelist>>doc:Glossary.Code list.WebHome]] name ([[codelist>>doc:Glossary.Code list.WebHome]]-id). 71 71 72 -The maintainedobject-version is the [[version>>doc:Glossary.Version.WebHome]], according to the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] versioning rules, of the maintained object which the [[artefact>>doc:Glossary.Artefact.WebHome]] belongs to (for example, possible (% style="color:#e74c3c" %)versions(%%)might be 1.0, 2.3, 1.0.0, 2.1.0 or 3.1.2).72 +The maintainedobject-version is the [[version>>doc:Glossary.Version.WebHome]], according to the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] versioning rules, of the maintained object which the [[artefact>>doc:Glossary.Artefact.WebHome]] belongs to (for example, possible versions might be 1.0, 2.3, 1.0.0, 2.1.0 or 3.1.2). 73 73 74 74 The container-object-id does not apply to the classes that can be referenced in [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Transformations, therefore is not present in their URN. 75 75 ... ... @@ -76,11 +76,11 @@ 76 76 The object-id is the name of the non-[[maintainable artefact>>doc:Glossary.Maintainable artefact.WebHome]] (when the [[artefact>>doc:Glossary.Artefact.WebHome]] is maintainable its name is already specified as the maintainedobject-id, see above), in particular it has to be specified: 77 77 78 78 * if the [[artefact>>doc:Glossary.Artefact.WebHome]] is a [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension, [[Measure>>doc:Glossary.Measure.WebHome]] or DataAttribute (the object-id is the name of one of the [[artefacts>>doc:Glossary.Artefact.WebHome]] above, which are data structure components) 79 -* if the [[artefact>>doc:Glossary.Artefact.WebHome]] is a (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%)(the object-id is the name of the(% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%))79 +* if the [[artefact>>doc:Glossary.Artefact.WebHome]] is a [[Concept>>doc:Glossary.Concept.WebHome]] (the object-id is the name of the [[Concept>>doc:Glossary.Concept.WebHome]]) 80 80 81 81 82 82 83 -For example, by using the URN, the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Transformation that sums two [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Dataflows>>doc:Glossary.Dataflow.WebHome]] DF1 and DF2 and assigns the result to a third persistent [[Dataflow>>doc:Glossary.Dataflow.WebHome]] DFR, assuming that DF1, DF2 and DFR are the maintainedobject-id of the three [[Dataflows>>doc:Glossary.Dataflow.WebHome]], that their (% style="color:#e74c3c" %)[[version>>doc:Glossary.Version.WebHome]](%%)is 1.0.0 and their Agency is AG, would be written as83 +For example, by using the URN, the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Transformation that sums two [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Dataflows>>doc:Glossary.Dataflow.WebHome]] DF1 and DF2 and assigns the result to a third persistent [[Dataflow>>doc:Glossary.Dataflow.WebHome]] DFR, assuming that DF1, DF2 and DFR are the maintainedobject-id of the three [[Dataflows>>doc:Glossary.Dataflow.WebHome]], that their [[version>>doc:Glossary.Version.WebHome]] is 1.0.0 and their Agency is AG, would be written as 84 84 85 85 {{footnote}}Since these references to SDMX objects include non-permitted characters as per the VTL ID notation, they need to be included between single quotes, according to the VTL rules for irregular names.{{/footnote}}: 86 86 ... ... @@ -97,7 +97,7 @@ 97 97 * The SDMXprefix can be omitted for all the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] objects, because it is a prefixed string (urn:[[sdmx>>doc:Glossary.Statistical data and metadata exchange.WebHome]]:org), always the same for [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] objects. 98 98 * The [[SDMX-IM>>doc:Glossary.SDMX Information Model.WebHome]]-package-name** **can be omitted as well because it can be deduced from the class-name that follows it (the table of the [[SDMX-IM>>doc:Glossary.SDMX Information Model.WebHome]] packages and classes that allows this deduction is in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 2.1 Standards - Section 5 - Registry Specifications, paragraph 6.2.3). In particular, considering the object classes of the [[artefacts>>doc:Glossary.Artefact.WebHome]] that [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] can reference, the package is: 99 99 ** "datastructure" for the classes [[Dataflow>>doc:Glossary.Dataflow.WebHome]], [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension, [[Measure>>doc:Glossary.Measure.WebHome]], DataAttribute, 100 -** "conceptscheme" for the class (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%),100 +** "conceptscheme" for the class [[Concept>>doc:Glossary.Concept.WebHome]], 101 101 ** "codelist" for the class Codelist. 102 102 * The class-name can be omitted as it can be deduced from the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] invocation. In particular, starting from the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] class of the invoked [[artefact>>doc:Glossary.Artefact.WebHome]] (e.g. [[dataset>>doc:Glossary.Data set.WebHome]], [[component>>doc:Glossary.Component.WebHome]], identifier, [[measure>>doc:Glossary.Measure.WebHome]], [[attribute>>doc:Glossary.Attribute.WebHome]], variable, valuedomain), which is known given the syntax of the invoking [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] operator{{footnote}}For the syntax of the VTL operators see the VTL Reference Manual{{/footnote}}, the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] class can be deduced from the mapping rules between [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] and [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] (see the section "Mapping between [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] and [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]" hereinafter){{footnote}}In case the invoked artefact is a VTL component, which can be invoked only within the invocation of a VTL data set (SDMX Dataflow), the specific SDMX class-name (e.g. Dimension, TimeDimension, Measure or DataAttribute) can be deduced from the data structure of the SDMX Dataflow, which the component belongs to.{{/footnote}}. 103 103 * If the agency-id is not specified, it is assumed by default equal to the agency-id of the TransformationScheme, UserDefinedOperatorScheme or RulesetScheme from which the [[artefact>>doc:Glossary.Artefact.WebHome]] is invoked. For example, the agencyid can be omitted if it is the same as the invoking TransformationScheme and cannot be omitted if the [[artefact>>doc:Glossary.Artefact.WebHome]] comes from another agency{{footnote}}If the Agency is composite (for example AgencyA.Dept1.Unit2), the agency is considered different even if only part of the composite name is different (for example AgencyA.Dept1.Unit3 is a different Agency than the previous one). Moreover the agency-id cannot be omitted in part (i.e., if a TransformationScheme owned by AgencyA.Dept1.Unit2 references an artefact coming from AgencyA.Dept1.Unit3, the specification of the agency-id becomes mandatory and must be complete, without omitting the possibly equal parts like AgencyA.Dept1){{/footnote}}. Take also into account that, according to the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] consistency rules, the agency of the result of a Transformation must be the same as its TransformationScheme, therefore the agency-id can be omitted for all the results (left part of Transformation statements). ... ... @@ -144,9 +144,9 @@ 144 144 145 145 > 'DFR(1.0.0)' := 'DF1(1.0.0)' [rename SECTOR to SEC] 146 146 147 -In the references to the (% style="color:#e74c3c" %)[[Concepts>>doc:Glossary.Concept.WebHome]](%%), which can exist for example in the definition of the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Rulesets, at least the conceptScheme-id and the(% style="color:#e74c3c" %)[[concept>>doc:Glossary.Concept.WebHome]](%%)-id must be specified.147 +In the references to the [[Concepts>>doc:Glossary.Concept.WebHome]], which can exist for example in the definition of the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Rulesets, at least the conceptScheme-id and the [[concept>>doc:Glossary.Concept.WebHome]]-id must be specified. 148 148 149 -An example of non-abbreviated reference, if the conceptScheme-id is CS1 and the (% style="color:#e74c3c" %)[[concept>>doc:Glossary.Concept.WebHome]](%%)-id is SECTOR, is the following:149 +An example of non-abbreviated reference, if the conceptScheme-id is CS1 and the [[concept>>doc:Glossary.Concept.WebHome]]-id is SECTOR, is the following: 150 150 151 151 > 'urn:sdmx:org.sdmx.infomodel.conceptscheme.Concept=AG:CS1(1.0.0).SECTOR' 152 152 ... ... @@ -158,7 +158,7 @@ 158 158 159 159 > 'DFR(1.0.0)' := between ( 'DF1(1.0.0)', 0, 25000 ) 160 160 161 -The [[artefact>>doc:Glossary.Artefact.WebHome]] ([[Component>>doc:Glossary.Component.WebHome]], (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%), [[Codelist>>doc:Glossary.Code list.WebHome]] …) which the Values are referred to can be deduced from the context in which the reference is made, taking also into account the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] syntax. In the Transformation above, for example, the values 0 and 2500 are compared to the values of the [[measures>>doc:Glossary.Measure.WebHome]] of DF1(1.0.0).161 +The [[artefact>>doc:Glossary.Artefact.WebHome]] ([[Component>>doc:Glossary.Component.WebHome]], [[Concept>>doc:Glossary.Concept.WebHome]], [[Codelist>>doc:Glossary.Code list.WebHome]] …) which the Values are referred to can be deduced from the context in which the reference is made, taking also into account the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] syntax. In the Transformation above, for example, the values 0 and 2500 are compared to the values of the [[measures>>doc:Glossary.Measure.WebHome]] of DF1(1.0.0). 162 162 163 163 === 12.2.4 User-defined alias === 164 164 ... ... @@ -172,13 +172,13 @@ 172 172 173 173 The [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Rulesets have a signature, in which the Value Domains or the Variables on which the Ruleset is defined are declared, and a body, which contains the Rules. 174 174 175 -In the signature, given the mapping between [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] and [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] better described in the following paragraphs, a reference to a [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Value Domain becomes a reference to a [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Codelist>>doc:Glossary.Code list.WebHome]], while a reference to a [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Represented Variable becomes a reference to a [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%), assuming for it a definite representation{{footnote}}Rulesets of this kind cannot be reused when the referenced Concept has a different representation.{{/footnote}}.175 +In the signature, given the mapping between [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] and [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] better described in the following paragraphs, a reference to a [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Value Domain becomes a reference to a [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Codelist>>doc:Glossary.Code list.WebHome]], while a reference to a [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Represented Variable becomes a reference to a [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Concept>>doc:Glossary.Concept.WebHome]], assuming for it a definite representation{{footnote}}Rulesets of this kind cannot be reused when the referenced Concept has a different representation.{{/footnote}}. 176 176 177 -In general, for referencing [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Codelists>>doc:Glossary.Code list.WebHome]] and (% style="color:#e74c3c" %)[[Concepts>>doc:Glossary.Concept.WebHome]](%%), the conventions described in the previous paragraphs apply. In the Ruleset syntax, the elements that reference [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[artefacts>>doc:Glossary.Artefact.WebHome]] are called "valueDomain" and "variable" for the Datapoint Rulesets and "ruleValueDomain", "ruleVariable", "condValueDomain" "condVariable" for the Hierarchical Rulesets).177 +In general, for referencing [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Codelists>>doc:Glossary.Code list.WebHome]] and [[Concepts>>doc:Glossary.Concept.WebHome]], the conventions described in the previous paragraphs apply. In the Ruleset syntax, the elements that reference [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[artefacts>>doc:Glossary.Artefact.WebHome]] are called "valueDomain" and "variable" for the Datapoint Rulesets and "ruleValueDomain", "ruleVariable", "condValueDomain" "condVariable" for the Hierarchical Rulesets). 178 178 179 179 The syntax of the Ruleset signature allows also to define aliases of the elements above, these aliases are valid only within the specific Ruleset definition statement and cannot be mapped to [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]].{{footnote}}See also the section "VTL-DL Rulesets" in the VTL Reference Manual.{{/footnote}} 180 180 181 -In the body of the Rulesets, the [[Codes>>doc:Glossary.Code.WebHome]] and in general all the Values can be written without any other specification, because the [[artefact>>doc:Glossary.Artefact.WebHome]], which the Values are referred ([[Codelist>>doc:Glossary.Code list.WebHome]], (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%))to can be deduced from the Ruleset signature.181 +In the body of the Rulesets, the [[Codes>>doc:Glossary.Code.WebHome]] and in general all the Values can be written without any other specification, because the [[artefact>>doc:Glossary.Artefact.WebHome]], which the Values are referred ([[Codelist>>doc:Glossary.Code list.WebHome]], [[Concept>>doc:Glossary.Concept.WebHome]]) to can be deduced from the Ruleset signature. 182 182 183 183 == 12.3 Mapping between SDMX and VTL artefacts == 184 184 ... ... @@ -338,7 +338,7 @@ 338 338 339 339 If desired, this method can be applied also to mono-[[measure>>doc:Glossary.Measure.WebHome]] [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] structures, provided that none of the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] [[Components>>doc:Glossary.Component.WebHome]] has already the role of [[Measure>>doc:Glossary.Measure.WebHome]] Identifier. Like in the general case, a MeasureDimension [[component>>doc:Glossary.Component.WebHome]] called “measure_name” is added to the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] DataStructure, in this case it has just one possible [[Code>>doc:Glossary.Code.WebHome]], corresponding to the name of the unique [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] [[Measure>>doc:Glossary.Measure.WebHome]]. The original [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] [[Measure>>doc:Glossary.Measure.WebHome]] would not become a [[Component>>doc:Glossary.Component.WebHome]] in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] data structure. The value of the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] [[Measure>>doc:Glossary.Measure.WebHome]] would be assigned to the unique [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Measure>>doc:Glossary.Measure.WebHome]] called “obs_value”. 340 340 341 -In any case, the resulting [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] definitions must be compliant with the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] consistency rules. For example, the possible [[Codes>>doc:Glossary.Code.WebHome]] of the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] MeasureDimension need to be listed in a [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Codelist, with proper id, agency and (% style="color:#e74c3c" %)[[version>>doc:Glossary.Version.WebHome]](%%); moreover, the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[DSD>>doc:Glossary.Data structure definition.WebHome]] must have the AttributeRelationship for the DataAttributes, which does not exist in [[VTL>>doc:Glossary.Validation and transformation language.WebHome]].341 +In any case, the resulting [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] definitions must be compliant with the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] consistency rules. For example, the possible [[Codes>>doc:Glossary.Code.WebHome]] of the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] MeasureDimension need to be listed in a [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Codelist, with proper id, agency and [[version>>doc:Glossary.Version.WebHome]]; moreover, the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[DSD>>doc:Glossary.Data structure definition.WebHome]] must have the AttributeRelationship for the DataAttributes, which does not exist in [[VTL>>doc:Glossary.Validation and transformation language.WebHome]]. 342 342 343 343 ==== 12.3.4.3 From VTL Measures to SDMX Data Attributes ==== 344 344 ... ... @@ -443,7 +443,7 @@ 443 443 444 444 Let us now analyse the mapping direction from [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] to [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]. 445 445 446 -In this situation, distinct parts of a [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:Glossary.Dataflow.WebHome]] are calculated as distinct [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] [[datasets>>doc:Glossary.Data set.WebHome]], under the (% style="color:#e74c3c" %)[[constraint>>doc:Glossary.Constraint.WebHome]](%%)that they must have the same [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] data structure.446 +In this situation, distinct parts of a [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:Glossary.Dataflow.WebHome]] are calculated as distinct [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] [[datasets>>doc:Glossary.Data set.WebHome]], under the [[constraint>>doc:Glossary.Constraint.WebHome]] that they must have the same [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] data structure. 447 447 448 448 For example, let us assume that the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] programmer wants to calculate the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Dataflow>>doc:Glossary.Dataflow.WebHome]] DF2(1.0.0) having the [[Dimensions>>doc:Glossary.Dimension.WebHome]] TIME_PERIOD, INDICATOR, and COUNTRY and that such a programmer finds it convenient to calculate separately the parts of DF2(1.0.0) that have different combinations of values for INDICATOR and COUNTRY: 449 449 ... ... @@ -495,7 +495,7 @@ 495 495 (% style="width:706.294px" %) 496 496 |(% style="width:257px" %)VTL|(% style="width:446px" %)SDMX 497 497 |(% style="width:257px" %)**[[Data Set>>doc:Glossary.Data set.WebHome]] [[Component>>doc:Glossary.Component.WebHome]]**|(% style="width:446px" %)Although this abstraction exists in [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]], it does not have an explicit definition and correspond to a [[Component>>doc:Glossary.Component.WebHome]] (either a DimensionComponent or a [[Measure>>doc:Glossary.Measure.WebHome]] or a DataAttribute) belonging to one specific [[Dataflow>>doc:Glossary.Dataflow.WebHome]]^^43^^ 498 -|(% style="width:257px" %)**Represented Variable**|(% style="width:446px" %) (% style="color:#e74c3c" %)**[[Concept>>doc:Glossary.Concept.WebHome]]**(%%)with a definite [[Representation>>doc:Glossary.Representation.WebHome]]498 +|(% style="width:257px" %)**Represented Variable**|(% style="width:446px" %)**[[Concept>>doc:Glossary.Concept.WebHome]]** with a definite [[Representation>>doc:Glossary.Representation.WebHome]] 499 499 |(% style="width:257px" %)**Value Domain**|(% style="width:446px" %)((( 500 500 **[[Representation>>doc:Glossary.Representation.WebHome]]** (see the Structure 501 501 Pattern in the Base Package) ... ... @@ -523,11 +523,11 @@ 523 523 524 524 if the matching [[components>>doc:Glossary.Component.WebHome]] in DS_a and DS_b (e.g. ref_date, geo_area, sector …) refer to the same general [[representation>>doc:Glossary.Representation.WebHome]]. In simpler words, DS_a and DS_b must use the same values/[[codes>>doc:Glossary.Code.WebHome]] (for ref_date, geo_area, sector … ), otherwise the relevant values would not match and the result of the operation would be wrong. 525 525 526 -As mentioned, the property above is not enforced by construction in [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]], and different [[representations>>doc:Glossary.Representation.WebHome]] of the same (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%)can be not compatible one another (for example, it may happen that geo_area is represented by ISO-alpha-3 [[codes>>doc:Glossary.Code.WebHome]] in DS_a and by ISO alpha-2 [[codes>>doc:Glossary.Code.WebHome]] in DS_b). Therefore, it will be up to the definer of [[VTL>>doc:Glossary.Validation and transformation language.WebHome]]526 +As mentioned, the property above is not enforced by construction in [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]], and different [[representations>>doc:Glossary.Representation.WebHome]] of the same [[Concept>>doc:Glossary.Concept.WebHome]] can be not compatible one another (for example, it may happen that geo_area is represented by ISO-alpha-3 [[codes>>doc:Glossary.Code.WebHome]] in DS_a and by ISO alpha-2 [[codes>>doc:Glossary.Code.WebHome]] in DS_b). Therefore, it will be up to the definer of [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] 527 527 528 -Transformations to ensure that the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] expressions are consistent with the actual [[representations>>doc:Glossary.Representation.WebHome]] of the correspondent [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] (% style="color:#e74c3c" %)[[Concepts>>doc:Glossary.Concept.WebHome]](%%).528 +Transformations to ensure that the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] expressions are consistent with the actual [[representations>>doc:Glossary.Representation.WebHome]] of the correspondent [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Concepts>>doc:Glossary.Concept.WebHome]]. 529 529 530 -It remains up to the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]-[[VTL>>doc:Glossary.Validation and transformation language.WebHome]] definer also the assurance of the consistency between a [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Ruleset defined on Variables and the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Components>>doc:Glossary.Component.WebHome]] on which the Ruleset is applied. In fact, a [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Ruleset is expressed by means of the values of the Variables (i.e. [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] (% style="color:#e74c3c" %)[[Concepts>>doc:Glossary.Concept.WebHome]](%%)), i.e. assuming definite [[representations>>doc:Glossary.Representation.WebHome]] for them (e.g. ISOalpha-3 for country). If the Ruleset is applied to [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Components>>doc:Glossary.Component.WebHome]] that have the same name of the(% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%)they refer to but different [[representations>>doc:Glossary.Representation.WebHome]] (e.g. ISO-alpha-2 for country), the Ruleset cannot work properly.530 +It remains up to the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]-[[VTL>>doc:Glossary.Validation and transformation language.WebHome]] definer also the assurance of the consistency between a [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Ruleset defined on Variables and the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Components>>doc:Glossary.Component.WebHome]] on which the Ruleset is applied. In fact, a [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Ruleset is expressed by means of the values of the Variables (i.e. [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Concepts>>doc:Glossary.Concept.WebHome]]), i.e. assuming definite [[representations>>doc:Glossary.Representation.WebHome]] for them (e.g. ISOalpha-3 for country). If the Ruleset is applied to [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Components>>doc:Glossary.Component.WebHome]] that have the same name of the [[Concept>>doc:Glossary.Concept.WebHome]] they refer to but different [[representations>>doc:Glossary.Representation.WebHome]] (e.g. ISO-alpha-2 for country), the Ruleset cannot work properly. 531 531 532 532 == 12.4 Mapping between SDMX and VTL Data Types == 533 533