Skip to Content
Last modified by Helena on 2025/09/10 11:19
From version 17.1
edited by Artur
on 2025/05/27 12:07
Change comment: There is no comment for this version
To version 15.1
edited by Artur
on 2025/05/22 14:56
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,7 +4,7 @@
4 4  
5 5  == 12.1 Introduction ==
6 6  
7 -The [[Validation and Transformation Language>>doc:Glossary.Validation and transformation language.WebHome]] ([[VTL>>doc:Glossary.Validation and transformation language.WebHome]]) supports the definition of Transformations, which are algorithms to calculate new data starting from already existing ones{{footnote}}The Validation and Transformation Language is a standard language designed and published under the SDMX initiative. VTL is described in the VTL User and Reference Guides available on the SDMX website [[https://sdmx.org]].{{/footnote}}. The purpose of the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] context is to enable the:
7 +The [[Validation and Transformation Language>>doc:Glossary.Validation and transformation language.WebHome]] ([[VTL>>doc:Glossary.Validation and transformation language.WebHome]]) supports the definition of Transformations, which are algorithms to calculate new data starting from already existing ones{{footnote}}The Validation and Transformation Language is a standard language designed and published under the SDMX initiative. VTL is described in the VTL User and Reference Guides available on the SDMX website https://sdmx.org.{{/footnote}}. The purpose of the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] context is to enable the:
8 8  
9 9  * definition of validation and transformation algorithms, in order to specify how to calculate new data from existing ones;
10 10  * exchange of the definition of [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] algorithms, also together the definition of the data structures of the involved data (for example, exchange the data structures of a reporting framework together with the validation rules to be applied, exchange the input and output data structures of a calculation task together with the [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] Transformations describing the calculation algorithms);
... ... @@ -39,17 +39,17 @@
39 39  The [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] URN{{footnote}}For a complete description of the structure of the URN see the SDMX 2.1 Standards - Section 5 - Registry Specifications, paragraph 6.2.2 ("Universal Resource Name (URN)").{{/footnote}} is the concatenation of the following parts, separated by special symbols like dot, equal, asterisk, comma, and parenthesis:
40 40  
41 41  * SDMXprefix
42 -* SDMX-IM-package-name
42 +* [[SDMX-IM>>doc:Glossary.SDMX Information Model.WebHome]]-package-name
43 43  * class-name
44 44  * agency-id
45 45  * maintainedobject-id
46 -* maintainedobject-version
46 +* maintainedobject-(% style="color:#e74c3c" %)version
47 47  * container-object-id{{footnote}}The container-object-id can repeat and may not be present.{{/footnote}}
48 48  * object-id
49 49  
50 50  The generic structure of the URN is the following:
51 51  
52 -SDMXprefix.[[SDMX-IM>>doc:Glossary.SDMX Information Model.WebHome]]-package-name.class-name=agency-id:maintainedobject-id (maintainedobject-version).*container-object-id.object-id
52 +SDMXprefix.[[SDMX-IM>>doc:Glossary.SDMX Information Model.WebHome]]-package-name.class-name=agency-id:maintainedobject-id (maintainedobject-(% style="color:#e74c3c" %)version(%%)).*container-object-id.object-id
53 53  
54 54  The **SDMXprefix** is "urn:[[sdmx>>doc:Glossary.Statistical data and metadata exchange.WebHome]]:org", always the same for all [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[artefacts>>doc:Glossary.Artefact.WebHome]].
55 55  
... ... @@ -66,7 +66,7 @@
66 66  * if the [[artefact>>doc:Glossary.Artefact.WebHome]] is a (% style="color:#e74c3c" %)Concept(%%), 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;
67 67  * if the [[artefact>>doc:Glossary.Artefact.WebHome]] is a Codelist, which is a maintainable class, the maintainedobject-id is the Codelist name (codelist-id).
68 68  
69 -The maintainedobject-version is the (% style="color:#e74c3c" %)version(%%), 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).
69 +The maintainedobject-(% style="color:#e74c3c" %)version(%%) is the (% style="color:#e74c3c" %)version(%%), 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).
70 70  
71 71  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
72 72  
... ... @@ -95,7 +95,7 @@
95 95  ** if the referenced [[artefact>>doc:Glossary.Artefact.WebHome]] is a [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension, [[Measure>>doc:Glossary.Measure.WebHome]], DataAttribute, which are not maintainable and belong to the DataStructure maintainable class, the maintainedobject-id is the dataStructure-id and can be omitted, given that these [[components>>doc:Glossary.Component.WebHome]] are always invoked within the invocation of a [[Dataflow>>doc:Glossary.Dataflow.WebHome]], whose dataStructure-id can be deduced from the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] structural definitions;
96 96  ** if the referenced [[artefact>>doc:Glossary.Artefact.WebHome]] is a (% style="color:#e74c3c" %)Concept(%%), which is not maintainable and belong to the ConceptScheme maintainable class, the maintained object is the conceptScheme-id and cannot be omitted;
97 97  ** if the referenced [[artefact>>doc:Glossary.Artefact.WebHome]] is a Codelist, which is a maintainable class, the maintainedobject-id is the codelist-id and obviously cannot be omitted.
98 -* When the maintainedobject-id is omitted, the maintainedobject-(% style="color:#e74c3c" %)version(%%) is omitted too. When the maintainedobject-id is not omitted and the maintainedobject-version is omitted, the (% style="color:#e74c3c" %)version(%%) 1.0 is assumed by default. • As said, 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
98 +* When the maintainedobject-id is omitted, the maintainedobject-(% style="color:#e74c3c" %)version(%%) is omitted too. When the maintainedobject-id is not omitted and the maintainedobject-(% style="color:#e74c3c" %)version(%%) is omitted, the (% style="color:#e74c3c" %)version(%%) 1.0 is assumed by default. • As said, 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
99 99  * The object-id does not exist for the [[artefacts>>doc:Glossary.Artefact.WebHome]] belonging to the [[Dataflow>>doc:Glossary.Dataflow.WebHome]], and Codelist classes, while it exists and cannot be omitted for the [[artefacts>>doc:Glossary.Artefact.WebHome]] belonging to the classes [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension, [[Measure>>doc:Glossary.Measure.WebHome]], DataAttribute and (% style="color:#e74c3c" %)Concept(%%), as for them the object-id is the main identifier of the [[artefact>>doc:Glossary.Artefact.WebHome]]
100 100  
101 101  The simplified object identifier is obtained by omitting all the first part of the URN, including the special characters, till the first part not omitted.