Changes for page SDMX 2.1 Standards. Section 6. Technical Notes
Last modified by Artur K. on 2025/08/19 10:43
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 16 added, 0 removed)
- 1747854163928-581.png
- 1747854190641-364.png
- 1747854236732-512.png
- 1747854286398-614.png
- 1747854385465-132.png
- 1747854406014-782.png
- 1747854424488-855.png
- 1747854453895-524.png
- 1747854476631-125.png
- 1747854493363-776.png
- 1747855024745-946.png
- 1747855054559-410.png
- 1747855075263-887.png
- 1747855402867-579.png
- 1747855462293-368.png
- 1747855493531-357.png
Details
- Page properties
-
- Content
-
... ... @@ -69,13 +69,15 @@ 69 69 70 70 To allow for applications which only understand time series data, variations of these formats have been introduced in the form of two data messages; //GenericTimeSeriesData// and //StructureSpecificTimeSeriesData//. It is important to note that these variations are built on the same root structure and can be processed in the same manner as the base format so that they do NOT introduce additional processing requirements. 71 71 72 -=== //Structure Definition// === 72 +(% class="wikigeneratedid" id="HStructureDefinition" %) 73 +**//Structure Definition//** 73 73 74 74 The SDMX-ML Structure Message supports the use of annotations to the structure, which is not supported by the SDMX-EDI syntax. 75 75 76 76 The SDMX-ML Structure Message allows for the structures on which a Data Structure Definition depends – that is, codelists and concepts – to be either included in the message or to be referenced by the message containing the data structure definition. XML syntax is designed to leverage URIs and other Internet-based referencing mechanisms, and these are used in the SDMX-ML message. This option is not available to those using the SDMX-EDI structure message. 77 77 78 -=== //Validation// === 79 +(% class="wikigeneratedid" id="HValidation" %) 80 +**//Validation//** 79 79 80 80 SDMX-EDI – as is typical of EDIFACT syntax messages – leaves validation to dedicated applications (“validation” being the checking of syntax, data typing, and adherence of the data message to the structure as described in the structural definition.) 81 81 ... ... @@ -83,19 +83,22 @@ 83 83 84 84 The SDMX-ML DSD-specific messages will allow validation of XML syntax and datatyping to be performed with a generic XML parser, and enforce agreement between the structural definition and the data to a moderate degree with the same tool. 85 85 86 -=== //Update and Delete Messages and Documentation Messages// === 88 +(% class="wikigeneratedid" id="HUpdateandDeleteMessagesandDocumentationMessages" %) 89 +//Update and Delete Messages and Documentation Messages// 87 87 88 88 All SDMX data messages allow for both delete messages and messages consisting of only data or only documentation. 89 89 90 -=== //Character Encodings// === 93 +(% class="wikigeneratedid" id="HCharacterEncodings" %) 94 +**//Character Encodings//** 91 91 92 92 All SDMX-ML messages use the UTF-8 encoding, while SDMX-EDI uses the ISO 8879-1 character encoding. There is a greater capacity with UTF-8 to express some character sets (see the “APPENDIX: MAP OF ISO 8859-1 (UNOC) CHARACTER SET (LATIN 1 OR “WESTERN”) in the document “SYNTAX AND DOCUMENTATION VERSION 2.0”.) Many transformation tools are available which allow XML instances with UTF-8 encodings to be expressed as ISO 8879-1-encoded characters, and to transform UTF-8 into ISO 8879-1. Such tools should be used when transforming SDMX-ML messages into SDMX-EDI messages and vice-versa. 93 93 94 -=== //Data Typing// === 98 +(% class="wikigeneratedid" id="HDataTyping" %) 99 +**//Data Typing//** 95 95 96 96 The XML syntax and EDIFACT syntax have different data-typing mechanisms. The section below provides a set of conventions to be observed when support for messages in both syntaxes is required. For more information on the SDMX-ML representations of data, see below. 97 97 98 -=== =3.3.2 Data Types ====103 +=== 3.3.2 Data Types === 99 99 100 100 The XML syntax has a very different mechanism for data-typing than the EDIFACT syntax, and this difference may create some difficulties for applications which support both EDIFACT-based and XML-based SDMX data formats. This section provides a set of conventions for the expression in data in all formats, to allow for clean interoperability between them. 101 101 ... ... @@ -409,7 +409,7 @@ 409 409 410 410 This is used to unambiguously state that a date-time represents an observation at a single point in time. Therefore, if one wants to use SDMX for data which is measured at a distinct point in time rather than being reported over a period, the date-time representation can be used. 411 411 412 -Representation: xs:dateTime (YYYY-MM-DDThh:mm:ss)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[1~]^^>>path:#_ftn1]] 417 +Representation: xs:dateTime (YYYY-MM-DDThh:mm:ss)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[1~]^^>>path:#_ftn1]] 413 413 414 414 === 4.2.6 Standard Reporting Period === 415 415 ... ... @@ -458,7 +458,7 @@ 458 458 Period Duration: P7D (seven days) 459 459 Limit per year: 53 460 460 Representation: common:ReportingWeekType (YYYY-Www, e.g. 2000-W53) 461 -Notes: There are either 52 or 53 weeks in a reporting year. This is based on the ISO 8601 definition of a week (Monday - Saturday), where the first week of a reporting year is defined as the week with the first Thursday on or after the reporting year start day.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[2~]^^>>path:#_ftn2]](%%) The reporting week is always represented as two digits, therefore 1-9 are 0 padded (e.g. 01). This allows the values to be sorted chronologically using textual sorting methods. 466 +Notes: There are either 52 or 53 weeks in a reporting year. This is based on the ISO 8601 definition of a week (Monday - Saturday), where the first week of a reporting year is defined as the week with the first Thursday on or after the reporting year start day.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[2~]^^>>path:#_ftn2]](%%) The reporting week is always represented as two digits, therefore 1-9 are 0 padded (e.g. 01). This allows the values to be sorted chronologically using textual sorting methods. 462 462 463 463 **Reporting Day**: 464 464 Period Indicator: D ... ... @@ -497,7 +497,7 @@ 497 497 g) If the [PERIOD_INDICATOR] is D, the [PERIOD_DURATION] is P1D. 498 498 499 499 **3. Determine [PERIOD_START]:** 500 -Subtract one from the [PERIOD_VALUE] and multiply this by the [PERIOD_DURATION]. Add[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[3~]^^>>path:#_ftn3]](%%) this to the [REPORTING_YEAR_BASE]. The result is the [PERIOD_START]. 505 +Subtract one from the [PERIOD_VALUE] and multiply this by the [PERIOD_DURATION]. Add[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[3~]^^>>path:#_ftn3]](%%) this to the [REPORTING_YEAR_BASE]. The result is the [PERIOD_START]. 501 501 502 502 **4. Determine the [PERIOD_END]:** 503 503 Multiply the [PERIOD_VALUE] by the [PERIOD_DURATION]. Add^^3^^ this to the [REPORTING_YEAR_BASE] add^^3^^ -P1D. The result is the [PERIOD_END]. ... ... @@ -642,9 +642,7 @@ 642 642 **Examples:** 643 643 644 644 **Gregorian Period** 645 - 646 646 Query Parameter: Greater than 2010 647 - 648 648 Literal Interpretation: Any data where the start period occurs after 2010-1231T23:59:59. 649 649 650 650 Example Matches: ... ... @@ -662,15 +662,11 @@ 662 662 * 2010-D185 or later (reporting year start day ~-~-07-01 or later) 663 663 664 664 **Reporting Period with explicit start day** 665 - 666 666 Query Parameter: Greater than or equal to 2009-Q3, reporting year start day = "-07-01" 667 - 668 668 Literal Interpretation: Any data where the start period occurs on after 2010-0101T00:00:00 (Note that in this case 2009-Q3 is converted to the explicit date range of 2010-01-01/2010-03-31 because of the reporting year start day value). Example Matches: Same as previous example 669 669 670 670 **Reporting Period with "Any" start day** 671 - 672 672 Query Parameter: Greater than or equal to 2010-Q3, reporting year start day = "Any" 673 - 674 674 Literal Interpretation: Any data with a reporting period where the start period is on or after the start period of 2010-Q3 for the same reporting year start day, or and data where the start period is on or after 2010-07-01. Example Matches: 675 675 676 676 * 2011 or later ... ... @@ -682,13 +682,10 @@ 682 682 * 2010-T3 (any reporting year start day) 683 683 * 2010-Q3 or later (any reporting year start day) 684 684 * 2010-M07 or later (any reporting year start day) 685 -* 2010-W27 or later (reporting year start day ~-~-01-01)^^4^^ 2010-D182 or later (reporting year start day ~-~-01-01) 686 -* 2010-W28 or later (reporting year start day ~-~-07-01)^^5^^ 684 +* 2010-W27 or later (reporting year start day ~-~-01-01){{footnote}}2010-Q3 (with a reporting year start day of --01-01) starts on 2010-07-01. This is day 4 of week 26, therefore the first week matched is week 27.{{/footnote}} 2010-D182 or later (reporting year start day ~-~-01-01) 685 +* 2010-W28 or later (reporting year start day ~-~-07-01){{footnote}}2010-Q3 (with a reporting year start day of --07-01) starts on 2011-01-01. This is day 6 of week 27, therefore the first week matched is week 28.{{/footnote}} 686 +* 2010-D185 or later (reporting year start day ~-~-07-01) 687 687 688 -^^4^^ 2010-Q3 (with a reporting year start day of ~-~-01-01) starts on 2010-07-01. This is day 4 of week 26, therefore the first week matched is week 27. 689 - 690 - 2010-D185 or later (reporting year start day ~-~-07-01) 691 - 692 692 == 4.3 Structural Metadata Querying Best Practices == 693 693 694 694 When querying for structural metadata, the ability to state how references should be resolved is quite powerful. However, this mechanism is not always necessary and can create an undue burden on the systems processing the queries if it is not used properly. ... ... @@ -705,8 +705,6 @@ 705 705 706 706 This mechanism is an “early binding” one – everything with a versioned identity is a known quantity, and will not change. It is worth pointing out that in some cases relationships are essentially one-way references: an illustrative case is that of Categories. While a Category may be referenced by many dataflows and metadata flows, the addition of more references from flow objects does not version the Category. This is because the flows are not properties of the Categories – they merely make references to it. If the name of a Category changed, or its subCategories changed, then versioning would be necessary. 707 707 708 -^^5^^ 2010-Q3 (with a reporting year start day of ~-~-07-01) starts on 2011-01-01. This is day 6 of week 27, therefore the first week matched is week 28. 709 - 710 710 Versioning operates at the level of versionable and maintainable objects in the SDMX information model. If any of the children of objects at these levels change, then the objects themselves are versioned. 711 711 712 712 One area which is much impacted by this versioning scheme is the ability to reference external objects. With the many dependencies within the various structural objects in SDMX, it is useful to have a scheme for external referencing. This is done at the level of maintainable objects (DSDs, code lists, concept schemes, etc.) In an SDMX-ML Structure Message, whenever an “isExternalReference” attribute is set to true, then the application must resolve the address provided in the associated “uri” attribute and use the SDMX-ML Structure Message stored at that location for the full definition of the object in question. Alternately, if a registry “urn” attribute has been provided, the registry can be used to supply the full details of the object. ... ... @@ -729,13 +729,13 @@ 729 729 730 730 [[image:1747836776649-282.jpeg]] 731 731 732 - 1.**1: Schematic of the Metadata Structure Definition**726 +**Figure 1: Schematic of the Metadata Structure Definition** 733 733 734 734 The MSD comprises the specification of the object types to which metadata can be reported in a Metadata Set (Metadata Target(s)), and the Report Structure(s) comprising the Metadata Attributes that identify the Concept for which metadata may be reported in the Metadata Set. Importantly, one Report Structure references the Metadata Target for which it is relevant. One Report Structure can reference many Metadata Target i.e. the same Report Structure can be used for different target objects. 735 735 736 736 [[image:1747836776655-364.jpeg]] 737 737 738 - 1.**2: Example MSD showing Metadata Targets**732 +**Figure 2: Example MSD showing Metadata Targets** 739 739 740 740 Note that the SDMX-ML schemas have explicit XML elements for each identifiable object type because identifying, for instance, a Maintainable Object has different properties from an Identifiable Object which must also include the agencyId, version, and id of the Maintainable Object in which it resides. 741 741 ... ... @@ -745,8 +745,10 @@ 745 745 746 746 [[image:1747836776658-510.jpeg]] 747 747 748 -**Figure 3: Example MSD showing specification of three Metadata Attributes **This example shows the following hierarchy of Metadata Attributes:742 +**Figure 3: Example MSD showing specification of three Metadata Attributes** 749 749 744 +This example shows the following hierarchy of Metadata Attributes: 745 + 750 750 Source – this is presentational and no metadata is expected to be reported at this level 751 751 752 752 * Source Type ... ... @@ -760,10 +760,7 @@ 760 760 761 761 **Figure 4: Example Metadata Set **This example shows: 762 762 763 -1. The reference to the MSD, Metadata Report, and Metadata Target 764 - 765 -(MetadataTargetValue) 766 - 759 +1. The reference to the MSD, Metadata Report, and Metadata Target (MetadataTargetValue) 767 767 1. The reported metadata attributes (AttributeValueSet) 768 768 769 769 = 6 Maintenance Agencies = ... ... @@ -820,8 +820,9 @@ 820 820 821 821 The Information Model for this is shown below: 822 822 816 +[[image:1747855024745-946.png]] 823 823 824 - **Figure 8: Information Model Extract for Concept Role**818 +**Figure 8: Information Model Extract for Concept Role** 825 825 826 826 It is possible to specify zero or more concept roles for a Dimension, Measure Dimension and Data Attribute (but not the ReportingYearStartDay). The Time Dimension, Primary Measure, and the Attribute ReportingYearStartDay have explicitly defined roles and cannot be further specified with additional concept roles. 827 827 ... ... @@ -841,13 +841,14 @@ 841 841 842 842 The Cross-Domain Concept Scheme maintained by SDMX contains concept role concepts (FREQ chosen as an example). 843 843 844 -[[image:17478 36776691-440.jpeg]]838 +[[image:1747855054559-410.png]] 845 845 840 + 846 846 Whether this is a role or not depends upon the application understanding that FREQ in the Cross-Domain Concept Scheme is a role of Frequency. 847 847 848 848 Using a Concept Scheme that is not the Cross-Domain Concept Scheme where it is required to assign a role using the Cross-Domain Concept Scheme. Again FREQ is chosen as the example. 849 849 850 -[[image:17478 36776693-898.jpeg]]845 +[[image:1747855075263-887.png]] 851 851 852 852 853 853 This explicitly states that this Dimension is playing a role identified by the FREQ concept in the Cross-Domain Concept Scheme. Again the application needs to understand what FREQ in the Cross-Domain Concept Scheme implies in terms of a role. ... ... @@ -897,7 +897,7 @@ 897 897 898 898 == 8.3 Rules for a Content Constraint == 899 899 900 -=== 8.3.1 Scope of a Content Constraint === 895 +=== 8.3.1 (% style="color:inherit; font-family:inherit; font-size:max(21px, min(23px, 17.4444px + 0.462963vw))" %)Scope of a Content Constraint(%%) === 901 901 902 902 A Content Constraint is used specify the content of a data or metadata source in terms of the component values or the keys. 903 903 ... ... @@ -936,54 +936,54 @@ 936 936 937 937 In view of the flexibility of constraints attachment, clear rules on their usage are required. These are elaborated below. 938 938 939 -=== 8.3.2 Multiple Content Constraints ===934 +=== 8.3.2 Multiple Content Constraints === 940 940 941 941 There can be many Content Constraints for any Constrainable Artefact (e.g. DSD), subject to the following restrictions: 942 942 943 - **8.3.2.1 Cube Region**938 +==== 8.3.2.1 Cube Region ==== 944 944 945 945 1. The constraint can contain multiple Member Selections (e.g. Dimension) but: 946 946 1. A specific Member Selection (e.g. Dimension FREQ) can only be contained in one Content Constraint for any one attached object (e.g. a specific DSD or specific Dataflow) 947 947 948 - **8.3.2.2 Key Set**943 +==== 8.3.2.2 Key Set ==== 949 949 950 950 Key Sets will be processed in the order they appear in the Constraint and wildcards can be used (e.g. any key position not reference explicitly is deemed to be “all values”). As the Key Sets can be “included” or “excluded” it is recommended that Key Sets with wildcards are declared before KeySets with specific series keys. This will minimize the risk that keys are inadvertently included or excluded. 951 951 952 -=== 8.3.3 Inheritance of a Content Constraint ===947 +=== 8.3.3 Inheritance of a Content Constraint === 953 953 954 - **8.3.3.1 Attachment levels of a Content Constraint**949 +==== 8.3.3.1 Attachment levels of a Content Constraint ==== 955 955 956 956 There are three levels of constraint attachment for which these inheritance rules apply: 957 957 958 - DSD/MSD – top level o Dataflow/Metadataflow – second level 953 +* DSD/MSD – top level 954 +** Dataflow/Metadataflow – second level 955 +*** Provision Agreement – third level 959 959 960 -§ Provision Agreement – third level 961 - 962 962 Note that these rules do not apply to the Simple Datasoucre or Queryable Datasource: the Content Constraint(s) attached to these artefacts are resolved for this artefact only and do not take into account Constraints attached to other artefacts (e.g. Provision Agreement. Dataflow, DSD). 963 963 964 964 It is not necessary for a Content Constraint to be attached to higher level artifact. e.g. it is valid to have a Content Constraint for a Provision Agreement where there are no constraints attached the relevant dataflow or DSD. 965 965 966 - **8.3.3.2 Cascade rules for processing Constraints**961 +==== 8.3.3.2 Cascade rules for processing Constraints ==== 967 967 968 968 The processing of the constraints on either Dataflow/Metadataflow or Provision Agreement must take into account the constraints declared at higher levels. The rules for the lower level constraints (attached to Dataflow/ Metadataflow and Provision Agreement) are detailed below. 969 969 970 970 Note that there can be a situation where a constraint is specified at a lower level before a constraint is specified at a higher level. Therefore, it is possible that a higher level constraint makes a lower level constraint invalid. SDMX makes no rules on how such a conflict should be handled when processing the constraint for attachment. However, the cascade rules on evaluating constraints for usage are clear - the higher level constraint takes precedence in any conflicts that result in a less restrictive specification at the lower level. 971 971 972 - **8.3.3.3 Cube Region**967 +==== 8.3.3.3 Cube Region ==== 973 973 974 974 1. It is not necessary to have a constraint on the higher level artifact (e.g. DSD referenced by the Dataflow) but if there is such a constraint at the higher level(s) then: 975 - 11. The lower level constraint cannot be less restrictive than the constraint specified for the same Member Selection (e.g. Dimension) at the next higher level which constraints that Member Selection (e.g. if the Dimension FREQ is constrained to A, Q in a DSD then the constraint at the Dataflow or Provision Agreement cannot be A, Q, M or even just M – it can only further constrain A,Q).976 - 11. The constraint at the lower level for any one Member Selection further constrains the content for the same Member Selection at the higher level(s).970 +a. The lower level constraint cannot be less restrictive than the constraint specified for the same Member Selection (e.g. Dimension) at the next higher level which constraints that Member Selection (e.g. if the Dimension FREQ is constrained to A, Q in a DSD then the constraint at the Dataflow or Provision Agreement cannot be A, Q, M or even just M – it can only further constrain A,Q). 971 +b. The constraint at the lower level for any one Member Selection further constrains the content for the same Member Selection at the higher level(s). 977 977 1. Any Member Selection which is not referenced in a Content Constraint is deemed to be constrained according to the Content Constraint specified at the next higher level which constraints that Member Selection. 978 978 1. If there is a conflict when resolving the constraint in terms of a lower-level constraint being less restrictive than a higher-level constraint then the constraint at the higher-level is used. 979 979 980 980 Note that it is possible for a Content Constraint at a higher level to constrain, say, four Dimensions in a single constraint, and a Content Constraint at a lower level to constrain the same four in two, three, or four Content Constraints. 981 981 982 - **8.3.3.4 Key Set**977 +==== 8.3.3.4 Key Set ==== 983 983 984 984 1. It is not necessary to have a constraint on the higher level artefact (e.g. DSD referenced by the Dataflow) but if there is such a constraint at the higher level(s) then: 985 - 11.The lower level constraint cannot be less restrictive than the constraint specified at the higher level.986 - 11.The constraint at the lower level for any one Member Selection further constrains the keys specified at the higher level(s).980 +a. The lower level constraint cannot be less restrictive than the constraint specified at the higher level. 981 +b. The constraint at the lower level for any one Member Selection further constrains the keys specified at the higher level(s). 987 987 1. Any Member Selection which is not referenced in a Content Constraint is deemed to be constrained according to the Content Constraint specified at the next higher level which constraints that Member Selection. 988 988 1. If there is a conflict when resolving the keys in the constraint at two levels, in terms of a lower-level constraint being less restrictive than a higher-level constraint, then the offending keys specified at the lower level are not deemed part of the constraint. 989 989 ... ... @@ -997,11 +997,12 @@ 997 997 1. At the lower level inherit all keys that match with the higher level constraint. 998 998 1. If there are keys in the lower level constraint that are not inherited then the key is invalid (i.e. it is less restrictive). 999 999 1000 - **8.3.4Constraints Examples**995 +=== 8.3.4 Constraints Examples === 1001 1001 1002 1002 The following scenario is used. 1003 1003 1004 -=== DSD === 999 +(% class="wikigeneratedid" id="HDSD" %) 1000 +__DSD__ 1005 1005 1006 1006 This contains the following Dimensions: 1007 1007 ... ... @@ -1013,111 +1013,47 @@ 1013 1013 In the DSD common code lists are used and the requirement is to restrict these at various levels to specify the actual code that are valid for the object to which the Content Constraint is attached. 1014 1014 1015 1015 1016 -|((( 1017 - 1018 -))) 1012 +[[image:1747855493531-357.png]] 1019 1019 1020 -|((( 1021 - 1022 -))) 1014 +**Figure 10: Example Scenario for Constraints** 1023 1023 1024 -|((( 1025 - 1026 -))) 1027 - 1028 -|((( 1029 -**Figure** 1030 -))) 1031 - 1032 -|((( 1033 -**10** 1034 -))) 1035 - 1036 -|((( 1037 -**:** 1038 -))) 1039 - 1040 -|((( 1041 -**~ Example Sce** 1042 -))) 1043 - 1044 -|((( 1045 -**nario for Constraints** 1046 -))) 1047 - 1048 -|((( 1049 -**~ ** 1050 -))) 1051 - 1052 - 1053 - 1054 1054 Constraints are declared as follows: 1055 1055 1018 +[[image:1747855462293-368.png]] 1056 1056 1057 -|((( 1058 - 1059 -))) 1020 +**Figure 11: Example Content Constraints** 1060 1060 1061 -|((( 1062 - 1063 -))) 1064 - 1065 -|((( 1066 - 1067 -))) 1068 - 1069 -|((( 1070 -**Figure** 1071 -))) 1072 - 1073 -|((( 1074 -**11** 1075 -))) 1076 - 1077 -|((( 1078 -**:** 1079 -))) 1080 - 1081 -|((( 1082 -**~ Example Content Constraints** 1083 -))) 1084 - 1085 -|((( 1086 -**~ ** 1087 -))) 1088 - 1089 - 1090 - 1091 1091 **Notes:** 1092 1092 1093 -1. AGE is constrained for the DSD and is further restricted for the Dataflow 1094 - 1095 -CENSUS_CUBE1. 1096 - 1024 +1. AGE is constrained for the DSD and is further restricted for the Dataflow CENSUS_CUBE1. 1097 1097 1. The same Constraint applies to both Provision Agreements. 1098 1098 1099 1099 The cascade rules elaborated above result as follows: 1100 1100 1101 -DSD 1029 +__DSD__ 1102 1102 1103 1103 ~1. Constrained by eliminating code 001 from the code list for the AGE Dimension. 1104 1104 1105 -=== Dataflow CENSUS_CUBE1 === 1033 +(% class="wikigeneratedid" id="HDataflowCENSUS_CUBE1" %) 1034 +__Dataflow CENSUS_CUBE1__ 1106 1106 1107 1107 1. Constrained by restricting the code list for the AGE Dimension to codes 002 and 003(note that this is a more restrictive constraint than that declared for the DSD which specifies all codes except code 001). 1108 1108 1. Restricts the CAS codes to 003 and 004. 1109 1109 1110 -=== Dataflow CENSUS_CUBE2 === 1039 +(% class="wikigeneratedid" id="HDataflowCENSUS_CUBE2" %) 1040 +__Dataflow CENSUS_CUBE2__ 1111 1111 1112 1112 1. Restricts the code list for the CAS Dimension to codes TOT and NAP. 1113 1113 1. Inherits the AGE constraint applied at the level of the DSD. 1114 1114 1115 -=== Provision Agreements CENSUS_CUBE1_IT === 1045 +(% class="wikigeneratedid" id="HProvisionAgreementsCENSUS_CUBE1_IT" %) 1046 +__Provision Agreements CENSUS_CUBE1_IT__ 1116 1116 1117 1117 1. Restricts the codes for the GEO Dimension to IT and its children. 1118 1118 1. Inherits the constraints from Dataflow CENSUS_CUBE1 for the AGE and CAS Dimensions. 1119 1119 1120 -=== Provision Agreements CENSUS_CUBE2_IT === 1051 +(% class="wikigeneratedid" id="HProvisionAgreementsCENSUS_CUBE2_IT" %) 1052 +__Provision Agreements CENSUS_CUBE2_IT__ 1121 1121 1122 1122 1. Restricts the codes for the GEO Dimension to IT and its children. 1123 1123 1. Inherits the constraints from Dataflow CENSUS_CUBE2 for the CAS Dimension. ... ... @@ -1125,17 +1125,20 @@ 1125 1125 1126 1126 The constraints are defined as follows: 1127 1127 1128 -=== DSD Constraint === 1060 +(% class="wikigeneratedid" id="HDSDConstraint" %) 1061 +__DSD Constraint__ 1129 1129 1130 1130 [[image:1747836776698-720.jpeg]] 1131 1131 1132 -=== Dataflow Constraints === 1065 +(% class="wikigeneratedid" id="HDataflowConstraints" %) 1066 +__Dataflow Constraints__ 1133 1133 1134 1134 [[image:1747836776701-360.jpeg]] 1135 1135 1136 1136 === [[image:1747836776707-834.jpeg]] === 1137 1137 1138 -=== Provision Agreement Constraint === 1072 +(% class="wikigeneratedid" id="HProvisionAgreementConstraint" %) 1073 +__Provision Agreement Constraint__ 1139 1139 1140 1140 [[image:1747836776710-262.jpeg]] 1141 1141 ... ... @@ -1147,7 +1147,7 @@ 1147 1147 1148 1148 == 9.2 Groups and Dimension Groups == 1149 1149 1150 -=== 9.2.1 Issue ===1085 +=== 9.2.1 Issue === 1151 1151 1152 1152 Version 2.1 introduces a more granular mechanism for specifying the relationship between a Data Attribute and the Dimensions to which the attribute applies. The technical construct for this is the Dimension Group. This Dimension Group has no direct equivalent in versions 2.0 and 1.0 and so the application transforming data from a version 2.1 data set to a version 2.0 or version 1.0 data set must decide to which construct the attribute value, whose Attribute is declared in a Dimension Group, should be attached. The closest construct is the “Series” attachment level and in many cases this is the correct construct to use. 1153 1153 ... ... @@ -1160,7 +1160,7 @@ 1160 1160 1161 1161 If the conditions defined in 9.2.1are true then on conversion to a version 2.0 or 1.0 DSD (Key Family) the Component/Attribute.attachmentLevel must be set to “Group” and the Component/Attribute/AttachmentGroup” is used to identify the Group. Note that under rule(1) in 1.2.1 this group will have been defined in the V 2.1 DSD and so will be present in the V 2.0 transformation. 1162 1162 1163 -=== 9.2.3 Data ===1098 +=== 9.2.3 Data === 1164 1164 1165 1165 If the conditions defined in 9.2.1are true then, on conversion from a 2.1 data set to a 2.0 or 1.0 dataset the attribute value will be placed in the relevant <Group>. If these conditions are not true then the attribute value will be placed in the <Series>. 1166 1166 ... ... @@ -1172,7 +1172,7 @@ 1172 1172 1173 1173 == 10.1 Introduction == 1174 1174 1175 -The Validation and Transformation Language (VTL) supports the definition of Transformations, which are algorithms to calculate new data starting from already existing ones[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[4~]^^>>path:#_ftn4]](%%). The purpose of the VTL in the SDMX context is to enable the: 1110 +The Validation and Transformation Language (VTL) supports the definition of Transformations, which are algorithms to calculate new data starting from already existing ones[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[4~]^^>>path:#_ftn4]](%%). The purpose of the VTL in the SDMX context is to enable the: 1176 1176 1177 1177 * definition of validation and transformation algorithms, in order to specify how to calculate new data from existing ones; 1178 1178 * exchange of the definition of VTL 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 Transformations describing the calculation algorithms); ... ... @@ -1194,10 +1194,8 @@ 1194 1194 1195 1195 The alias of a SDMX artefact can be its URN (Universal Resource Name), an abbreviation of its URN or another user-defined name. 1196 1196 1197 -In any case, the aliases used in the VTL transformations have to be mapped to the 1132 +In any case, the aliases used in the VTL transformations have to be mapped to the SDMX artefacts through the VtlMappingScheme and VtlMapping classes (see the section of the SDMX IM relevant to the VTL). A VtlMapping allows specifying the aliases to be used in the VTL transformations, rulesets[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[5~]^^>>path:#_ftn5]](%%) or user defined operators[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[6~]^^>>path:#_ftn6]](%%) to reference SDMX artefacts. A VtlMappingScheme is a container for zero or more VtlMapping. 1198 1198 1199 -SDMX artefacts through the VtlMappingScheme and VtlMapping classes (see the section of the SDMX IM relevant to the VTL). A VtlMapping allows specifying the aliases to be used in the VTL transformations, rulesets[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[5~]^^>>path:#_ftn5]](%%) or user defined operators[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[6~]^^>>path:#_ftn6]](%%) to reference SDMX artefacts. A VtlMappingScheme is a container for zero or more VtlMapping. 1200 - 1201 1201 The correspondence between an alias and a SDMX artefact must be one-to-one, meaning that a generic alias identifies one and just one SDMX artefact while a SDMX artefact is identified by one and just one alias. In other words, within a VtlMappingScheme an artefact can have just one alias and different artefacts cannot have the same alias. 1202 1202 1203 1203 The references through the URN and the abbreviated URN are described in the following paragraphs. ... ... @@ -1206,7 +1206,7 @@ 1206 1206 1207 1207 This approach has the advantage that in the VTL code the URN of the referenced artefacts is directly intelligible by a human reader but has the drawback that the references are verbose. 1208 1208 1209 -The SDMX URN[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[7~]^^>>path:#_ftn7]](%%) is the concatenation of the following parts, separated by special symbols like dot, equal, asterisk, comma, and parenthesis:^^ ^^ 1142 +The SDMX URN[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[7~]^^>>path:#_ftn7]](%%) is the concatenation of the following parts, separated by special symbols like dot, equal, asterisk, comma, and parenthesis:^^ ^^ 1210 1210 1211 1211 * SDMXprefix 1212 1212 * SDMX-IM-package-name ... ... @@ -1214,7 +1214,7 @@ 1214 1214 * agency-id 1215 1215 * maintainedobject-id 1216 1216 * maintainedobject-version 1217 -* container-object-id [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[8~]^^>>path:#_ftn8]] 1150 +* container-object-id [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[8~]^^>>path:#_ftn8]] 1218 1218 * object-id 1219 1219 1220 1220 The generic structure of the URN is the following: ... ... @@ -1233,13 +1233,13 @@ 1233 1233 1234 1234 The **agency-id** is the acronym of the agency that owns the definition of the artefact, for example for the Eurostat artefacts the agency-id is “ESTAT”). The agency-id can be composite (for example AgencyA.Dept1.Unit2). 1235 1235 1236 -The **maintainedobject-id** is the name of the maintained object which the artefact belongs to, and in case the artefact itself is maintainable[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[9~]^^>>path:#_ftn9]](%%), coincides with the name of the artefact. Therefore the maintainedobject-id depends on the class of the artefact: 1169 +The **maintainedobject-id** is the name of the maintained object which the artefact belongs to, and in case the artefact itself is maintainable[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[9~]^^>>path:#_ftn9]](%%), coincides with the name of the artefact. Therefore the maintainedobject-id depends on the class of the artefact: 1237 1237 1238 -* if the artefact is a ,,Dataflow,,,which is a maintainable class, the maintainedobject-id is the Dataflow name (dataflow-id);1239 -* if the artefact is a Dimension, MeasureDimension, TimeDimension, PrimaryMeasure or DataAttribute, which are not maintainable and belong to the ,,DataStructure,,maintainable class, the maintainedobject-id is the name of the DataStructure (dataStructure-id) which the artefact belongs to;1240 -* if the artefact is a ,,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 belongs to;1241 -* if the artefact is a ,,ConceptScheme,,,which is a maintainable class, ,, ,,the maintainedobject-id is the name of the ConceptScheme (conceptScheme-id);1242 -* if the artefact is a ,,Codelist,,,which is a maintainable class, the maintainedobject-id is the Codelist name (codelist-id).1171 +* if the artefact is a Dataflow, which is a maintainable class, the maintainedobject-id is the Dataflow name (dataflow-id); 1172 +* if the artefact is a Dimension, MeasureDimension, TimeDimension, PrimaryMeasure or DataAttribute, which are not maintainable and belong to the DataStructure maintainable class, the maintainedobject-id is the name of the DataStructure (dataStructure-id) which the artefact belongs to; 1173 +* if the artefact is a 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 belongs to; 1174 +* if the artefact is a ConceptScheme, which is a maintainable class, ,, ,,the maintainedobject-id is the name of the ConceptScheme (conceptScheme-id); 1175 +* if the artefact is a Codelist, which is a maintainable class, the maintainedobject-id is the Codelist name (codelist-id). 1243 1243 1244 1244 The **maintainedobject-version** is the version of the maintained object which the artefact belongs to (for example, possible versions are 1.0, 2.1, 3.1.2). 1245 1245 ... ... @@ -1247,18 +1247,13 @@ 1247 1247 1248 1248 The **object-id** is the name of the non-maintainable artefact (when the artefact is maintainable its name is already specified as the maintainedobject-id, see above), in particular it has to be specified: 1249 1249 1250 -* if the artefact is a Dimension, MeasureDimension, TimeDimension, PrimaryMeasure or DataAttribute (the object-id is the name of one of 1183 +* if the artefact is a Dimension, MeasureDimension, TimeDimension, PrimaryMeasure or DataAttribute (the object-id is the name of one of the artefacts above, which are data structure components) 1184 +* if the artefact is a Concept (the object-id is the name of the Concept) 1251 1251 1252 -the artefacts above,whichare data structure components)1186 +For example, by using the URN, the VTL transformation that sums two SDMX dataflows DF1 and DF2 and assigns the result to a third persistent dataflow DFR, assuming that DF1, DF2 and DFR are the maintainedobject-id of the three dataflows, that their version is 1.0 and their Agency is AG, would be written as[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[10~]^^>>path:#_ftn10]](%%): 1253 1253 1254 -* if the artefact is a ,,Concept ,,(the object-id is the name of the ,,Concept,,) 1255 - 1256 -For example, by using the URN, the VTL transformation that sums two SDMX dataflows DF1 and DF2 and assigns the result to a third persistent dataflow DFR, assuming that DF1, DF2 and DFR are the maintainedobject-id of the three dataflows, that their version is 1.0 and their Agency is AG, would be written as[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[10~]^^>>path:#_ftn10]](%%): 1257 - 1258 1258 ‘urn:sdmx:org.sdmx.infomodel.datastructure.Dataflow=AG:DFR(1.0)’ <- 1259 - 1260 1260 ‘urn:sdmx:org.sdmx.infomodel.datastructure.Dataflow=AG:DF1(1.0)’ + 1261 - 1262 1262 ‘urn:sdmx:org.sdmx.infomodel.datastructure.Dataflow=AG:DF2(1.0)’ 1263 1263 1264 1264 === 10.2.3 Abbreviation of the URN === ... ... @@ -1271,22 +1271,20 @@ 1271 1271 * The **SDMX-IM-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 packages and classes that allows this deduction is in the SDMX 2.1 Standards - Section 5 - Registry Specifications, paragraph 6.2.3). In particular, considering the object classes of the artefacts that VTL can reference, the package is: 1272 1272 ** “datastructure” for the classes Dataflow, Dimension, MeasureDimension, TimeDimension, PrimaryMeasure, DataAttribute, 1273 1273 ** “conceptscheme” for the classes Concept and ConceptScheme o “codelist” for the class Codelist. 1274 -* The **class-name** can be omitted as it can be deduced from the VTL invocation. In particular, starting from the VTL class of the invoked artefact (e.g. dataset, component, identifier, measure, attribute, variable, valuedomain), which is known given the syntax of the invoking VTL operator[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[11~]^^>>path:#_ftn11]](%%), the SDMX class can be deduced from the mapping rules between VTL and SDMX (see the section “Mapping between VTL and SDMX” hereinafter)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[12~]^^>>path:#_ftn12]](%%). 1275 -* 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 is invoked. For example, the agency-id can be omitted if it is the same as the invoking T ,,ransformationScheme,,and cannot be omitted if the artefact comes from another agency.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[13~]^^>>path:#_ftn13]](%%) Take also into account that, according to the VTL 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).1276 -* As for the **maintainedobject-id**, this is essential in some cases while in other cases it can be omitted: o if the referenced artefact is a ,,Dataflow,,,which is a maintainable class, the maintainedobject-id is the dataflow-id and obviously cannot be omitted;1277 -** if the referenced artefact is a Dimension, MeasureDimension, TimeDimension, PrimaryMeasure, 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 are always invoked within the invocation of a,,Dataflow,,,whose dataStructure-id can be deduced from the1202 +* The **class-name** can be omitted as it can be deduced from the VTL invocation. In particular, starting from the VTL class of the invoked artefact (e.g. dataset, component, identifier, measure, attribute, variable, valuedomain), which is known given the syntax of the invoking VTL operator[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[11~]^^>>path:#_ftn11]](%%), the SDMX class can be deduced from the mapping rules between VTL and SDMX (see the section “Mapping between VTL and SDMX” hereinafter)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[12~]^^>>path:#_ftn12]](%%). 1203 +* 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 is invoked. For example, the agency-id can be omitted if it is the same as the invoking TransformationScheme and cannot be omitted if the artefact comes from another agency.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[13~]^^>>path:#_ftn13]](%%) Take also into account that, according to the VTL 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). 1204 +* As for the **maintainedobject-id**, this is essential in some cases while in other cases it can be omitted: o if the referenced artefact is a Dataflow, which is a maintainable class, the maintainedobject-id is the dataflow-id and obviously cannot be omitted; 1205 +** if the referenced artefact is a Dimension, MeasureDimension, TimeDimension, PrimaryMeasure, 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 are always invoked within the invocation of a Dataflow, whose dataStructure-id can be deduced from the 1278 1278 1279 -SDMX structural definitions; o if the referenced artefact is a ,,Concept,,,which is not maintainable and belong to the,,ConceptScheme,,maintainable class,,, ,,the maintained object is the conceptScheme-id and cannot be omitted;1207 +SDMX structural definitions; o if the referenced artefact is a Concept, which is not maintainable and belong to the ConceptScheme maintainable class,,, ,,the maintained object is the conceptScheme-id and cannot be omitted; 1280 1280 1281 -* 1282 -** if the referenced artefact is a ,,ConceptScheme,,,which is a,, ,,maintainable class,,, ,,the maintained object is the,,conceptScheme-id,,and obviously cannot be omitted;1283 -** if the referenced artefact is a ,,Codelist,,,which is a maintainable class, the maintainedobject-id is the,,codelist-id,,and obviously cannot be omitted.1209 +* 1210 +** if the referenced artefact is a ConceptScheme, which is a,, ,,maintainable class,,, ,,the maintained object is the conceptScheme-id and obviously cannot be omitted; 1211 +** if the referenced artefact is a Codelist, which is a maintainable class, the maintainedobject-id is the codelist-id and obviously cannot be omitted. 1284 1284 * When the maintainedobject-id is omitted, the **maintainedobject-version** is omitted too. When the maintainedobject-id is not omitted and the maintainedobject-version is omitted, the version 1.0 is assumed by default.,, ,, 1285 1285 * As said, the **container-object-id** does not apply to the classes that can be referenced in VTL transformations, therefore is not present in their URN 1286 -* The **object-id** does not exist for the artefacts belonging to the ,,Dataflow, ConceptScheme,,and,,Codelist,,classes, while it exists and cannot be omitted for the artefacts belonging to the classes Dimension, MeasureDimension, TimeDimension, PrimaryMeasure, DataAttribute and Concept, as for1214 +* The **object-id** does not exist for the artefacts belonging to the Dataflow, ConceptScheme and Codelist classes, while it exists and cannot be omitted for the artefacts belonging to the classes Dimension, MeasureDimension, TimeDimension, PrimaryMeasure, DataAttribute and Concept, as for them the object-id is the main identifier of the artefact 1287 1287 1288 -them the object-id is the main identifier of the artefact 1289 - 1290 1290 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. 1291 1291 1292 1292 For example, the full formulation that uses the complete URN shown at the end of the previous paragraph: ... ... @@ -1299,11 +1299,11 @@ 1299 1299 1300 1300 DFR := DF1 + DF2 1301 1301 1302 -The references to the ,,Codelists,,can be simplified similarly. For example, given the non-abbreviated reference to the,,Codelist,,AG:CL_FREQ(1.0), which is[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[14~]^^>>path:#_ftn14]](%%):1228 +The references to the Codelists can be simplified similarly. For example, given the non-abbreviated reference to the Codelist AG:CL_FREQ(1.0), which is[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[14~]^^>>path:#_ftn14]](%%): 1303 1303 1304 1304 ‘urn:sdmx:org.sdmx.infomodel.codelist.Codelist=AG:CL_FREQ(1.0)’ 1305 1305 1306 -if the ,,Codelist,,is referenced from a ruleset scheme belonging to the agency AG, omitting all the optional parts, the abbreviated reference would become simply[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[15~]^^>>path:#_ftn15]](%%):1232 +if the Codelist is referenced from a ruleset scheme belonging to the agency AG, omitting all the optional parts, the abbreviated reference would become simply[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[15~]^^>>path:#_ftn15]](%%): 1307 1307 1308 1308 CL_FREQ 1309 1309 ... ... @@ -1313,7 +1313,7 @@ 1313 1313 1314 1314 SECTOR 1315 1315 1316 -For example, the transformation for renaming the component SECTOR of the dataflow DF1 into SEC can be written as[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[16~]^^>>path:#_ftn16]](%%): 1242 +For example, the transformation for renaming the component SECTOR of the dataflow DF1 into SEC can be written as[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[16~]^^>>path:#_ftn16]](%%): 1317 1317 1318 1318 ‘DFR(1.0)’ := ‘DF1(1.0)’ [rename SECTOR to SEC] 1319 1319 ... ... @@ -1347,9 +1347,9 @@ 1347 1347 1348 1348 The VTL 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. 1349 1349 1350 -In the signature, given the mapping between VTL and SDMX better described in the following paragraphs, a reference to a VTL Value Domain becomes a reference to a SDMX Codelist or to a SDMX ConceptScheme (for SDMX measure dimensions), while a reference to a VTL Represented Variable becomes a reference to a SDMX Concept, assuming for it a definite representation[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[17~]^^>>path:#_ftn17]](%%). 1276 +In the signature, given the mapping between VTL and SDMX better described in the following paragraphs, a reference to a VTL Value Domain becomes a reference to a SDMX Codelist or to a SDMX ConceptScheme (for SDMX measure dimensions), while a reference to a VTL Represented Variable becomes a reference to a SDMX Concept, assuming for it a definite representation[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[17~]^^>>path:#_ftn17]](%%). 1351 1351 1352 -In general, for referencing SDMX Codelists and Concepts, the conventions described in the previous paragraphs apply. In the Ruleset syntax, the elements that reference SDMX artefacts are called “valueDomain” and “variable” for the Datapoint Rulesets and “ruleValueDomain”, “ruleVariable”, “condValueDomain” “condVariable” for the Hierarchical Rulesets). 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.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[18~]^^>>path:#_ftn18]](%%) 1278 +In general, for referencing SDMX Codelists and Concepts, the conventions described in the previous paragraphs apply. In the Ruleset syntax, the elements that reference SDMX artefacts are called “valueDomain” and “variable” for the Datapoint Rulesets and “ruleValueDomain”, “ruleVariable”, “condValueDomain” “condVariable” for the Hierarchical Rulesets). 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.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[18~]^^>>path:#_ftn18]](%%) 1353 1353 1354 1354 In the body of the Rulesets, the Codes and in general all the Values can be written without any other specification, because the artefact which the Values are referred (Codelist, ConceptScheme, Concept) to can be deduced from the Ruleset signature. 1355 1355 ... ... @@ -1363,15 +1363,15 @@ 1363 1363 1364 1364 Every time a SDMX object is referenced in a VTL Transformation as an input operand, there is the need to generate a VTL definition of the object, so that the VTL operations can take place. This can be made starting from the SDMX definition and applying a SDMX-VTL mapping method in the direction from SDMX to VTL. The possible mapping methods from SDMX to VTL are described in the following paragraphs and are conceived to allow the automatic deduction of the VTL definition of the object from the knowledge of the SDMX definition. 1365 1365 1366 -In the opposite direction, every time an object calculated by means of VTL must be treated as a SDMX object (for example for exchanging it through SDMX), there is the need of a SDMX definition of the object, so that the SDMX operations can take place. The SDMX definition is needed for the VTL objects for which a SDMX use is envisaged[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[19~]^^>>path:#_ftn19]](%%). 1292 +In the opposite direction, every time an object calculated by means of VTL must be treated as a SDMX object (for example for exchanging it through SDMX), there is the need of a SDMX definition of the object, so that the SDMX operations can take place. The SDMX definition is needed for the VTL objects for which a SDMX use is envisaged[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[19~]^^>>path:#_ftn19]](%%). 1367 1367 1368 1368 The mapping methods from VTL to SDMX are described in the following paragraphs as well, however they do not allow the complete SDMX definition to be automatically deduced from the VTL definition, more than all because the former typically contains additional information in respect to the latter. For example, the definition of a SDMX DSD includes also some mandatory information not available in VTL (like the concept scheme to which the SDMX components refer, the assignmentStatus and attributeRelationship for the DataAttributes and so on). Therefore the mapping methods from VTL to SDMX provide only a general guidance for generating SDMX definitions properly starting from the information available in VTL, independently of how the SDMX definition it is actually generated (manually, automatically or part and part). 1369 1369 1370 1370 === 10.3.2 General mapping of VTL and SDMX data structures === 1371 1371 1372 -This section makes reference to the VTL “Model for data and their structure”[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[20~]^^>>path:#_ftn20]](%%) and the correspondent SDMX “Data Structure Definition”[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[21~]^^>>path:#_ftn21]](%%). 1298 +This section makes reference to the VTL “Model for data and their structure”[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[20~]^^>>path:#_ftn20]](%%) and the correspondent SDMX “Data Structure Definition”[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[21~]^^>>path:#_ftn21]](%%). 1373 1373 1374 -The main type of artefact that the VTL can manipulate is the VTL Data Set, which in general is mapped to the SDMX Dataflow. This means that a VTL Transformation, in the SDMX context, expresses the algorithm for calculating a derived Dataflow starting from some already existing Dataflows (either collected or derived).[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[22~]^^>>path:#_ftn22]](%%) 1300 +The main type of artefact that the VTL can manipulate is the VTL Data Set, which in general is mapped to the SDMX Dataflow. This means that a VTL Transformation, in the SDMX context, expresses the algorithm for calculating a derived Dataflow starting from some already existing Dataflows (either collected or derived).[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[22~]^^>>path:#_ftn22]](%%) 1375 1375 1376 1376 While the VTL Transformations are defined in term of Dataflow definitions, they are assumed to be executed on instances of such Dataflows, provided at runtime to the VTL engine (the mechanism for identifying the instances to be processed are not part of the VTL specifications and depend on the implementation of the VTL-based systems). As already said, the SDMX Datasets are instances of SDMX Dataflows, therefore a VTL Transformation defined on some SDMX Dataflows can be applied on some corresponding SDMX Datasets. 1377 1377 ... ... @@ -1381,7 +1381,7 @@ 1381 1381 1382 1382 SDMX DimensionComponent can be a Dimension, a TimeDimension or a MeasureDimension. Correspondingly, in the SDMX implementation of the VTL, the VTL Identifiers can be (optionally) distinguished in three sub-classes (Simple Identifier, Time Identifier, Measure Identifier) even if such a distinction is not evidenced in the VTL IM. 1383 1383 1384 -However, a VTL Data Structure can have any number of Identifiers, Measures and Attributes, while a SDMX 2.1 DataStructureDefinition can have any number of Dimensions and DataAttributes but just one PrimaryMeasure[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[23~]^^>>path:#_ftn23]](%%). This is due to a difference between SDMX 2.1 and VTL in the possible representation methods of the data that contain more measures. 1310 +However, a VTL Data Structure can have any number of Identifiers, Measures and Attributes, while a SDMX 2.1 DataStructureDefinition can have any number of Dimensions and DataAttributes but just one PrimaryMeasure[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[23~]^^>>path:#_ftn23]](%%). This is due to a difference between SDMX 2.1 and VTL in the possible representation methods of the data that contain more measures. 1385 1385 1386 1386 As for SDMX, because the data structure cannot contain more than one measure component (i.e., the primaryMeasure), the representation of data having more measures is possible only by means of a particular dimension, called MeasureDimension, which is aimed at containing the name of the measure concepts, so that for each observation the value contained in the PrimaryMeasure component is the value of the measure concept reported in the MeasureDimension component. 1387 1387 ... ... @@ -1391,28 +1391,25 @@ 1391 1391 1392 1392 === 10.3.3 Mapping from SDMX to VTL data structures === 1393 1393 1394 - **10.3.3.1 Basic Mapping **1320 +==== 10.3.3.1 Basic Mapping** ** ==== 1395 1395 1396 1396 The main mapping method from SDMX to VTL is called **Basic **mapping. This is considered as the default mapping method and is applied unless a different method is specified through the VtlMappingScheme and VtlDataflowMapping classes. 1842 When transforming **from SDMX to VTL**, this method consists in leaving the 1843 components unchanged and maintaining their names and roles, according to the 1844 following table: 1397 1397 1398 -|SDMX|VTL 1399 -|Dimension|(Simple) Identifier 1400 -|Time Dimension|(Time) Identifier 1401 -|Measure Dimension|(Measure) Identifier 1402 -|Primary Measure|Measure 1403 -|Data Attribute|Attribute 1324 +(% style="width:636.294px" %) 1325 +|(% style="width:286px" %)**SDMX**|(% style="width:347px" %)**VTL** 1326 +|(% style="width:286px" %)Dimension|(% style="width:347px" %)(Simple) Identifier 1327 +|(% style="width:286px" %)Time Dimension|(% style="width:347px" %)(Time) Identifier 1328 +|(% style="width:286px" %)Measure Dimension|(% style="width:347px" %)(Measure) Identifier 1329 +|(% style="width:286px" %)Primary Measure|(% style="width:347px" %)Measure 1330 +|(% style="width:286px" %)Data Attribute|(% style="width:347px" %)Attribute 1404 1404 1405 -According to this method, the resulting VTL structures are always mono-measure 1332 +According to this method, the resulting VTL structures are always mono-measure (i.e., they have just one measure component) and their Measure is the SDMX PrimaryMeasure. Nevertheless, if the SDMX data structure has a MeasureDimension, which can convey the name of one or more measure concepts, such unique measure component can contain the value of more (conceptual) measures (one for each observation). 1406 1406 1407 -(i.e., they have just one measure component) and their Measure is the SDMX 1408 - 1409 -PrimaryMeasure. Nevertheless, if the SDMX data structure has a MeasureDimension, which can convey the name of one or more measure concepts, such unique measure component can contain the value of more (conceptual) measures (one for each observation). 1410 - 1411 1411 As for the SDMX DataAttributes, in VTL they are all considered “at data point / observation level” (i.e. dependent on all the VTL Identifiers), because VTL does not have the SDMX AttributeRelationships, which defines the construct to which the DataAttribute is related (e.g. observation, dimension or set or group of dimensions, whole data set). 1412 1412 1413 1413 With the Basic mapping, one SDMX observation generates one VTL data point. 1414 1414 1415 - **10.3.3.2 Pivot Mapping**1338 +==== 10.3.3.2 Pivot Mapping ==== 1416 1416 1417 1417 An alternative mapping method from SDMX to VTL is the **Pivot **mapping, which is different from the Basic method only for the SDMX data structures that contain a MeasureDimension, which are mapped to multi-measure VTL data structures. 1418 1418 ... ... @@ -1432,29 +1432,27 @@ 1432 1432 1433 1433 The summary mapping table of the “pivot” mapping from SDMX to VTL for the SDMX data structures that contain a MeasureDimension is the following: 1434 1434 1435 -|SDMX|VTL 1436 -|Dimension|(Simple) Identifier 1437 -|TimeDimension|(Time) Identifier 1438 -|MeasureDimension & PrimaryMeasure|One Measure for each Concept of the SDMX Measure Dimension 1439 -|DataAttribute not depending on the MeasureDimension|Attribute 1440 -|DataAttribute depending on the MeasureDimension|One Attribute for each Concept of the SDMX Measure Dimension 1358 +(% style="width:941.294px" %) 1359 +|(% style="width:441px" %)**SDMX**|(% style="width:497px" %)**VTL** 1360 +|(% style="width:441px" %)Dimension|(% style="width:497px" %)(Simple) Identifier 1361 +|(% style="width:441px" %)TimeDimension|(% style="width:497px" %)(Time) Identifier 1362 +|(% style="width:441px" %)MeasureDimension & PrimaryMeasure|(% style="width:497px" %)One Measure for each Concept of the SDMX Measure Dimension 1363 +|(% style="width:441px" %)DataAttribute not depending on the MeasureDimension|(% style="width:497px" %)Attribute 1364 +|(% style="width:441px" %)DataAttribute depending on the MeasureDimension|(% style="width:497px" %)One Attribute for each Concept of the SDMX Measure Dimension 1441 1441 1442 -Using this mapping method, the components of the data structure can change in the conversion from SDMX to VTL and it must be taken into account that the VTL 1908statements can reference only the components of the resulting VTL data structure.1366 +Using this mapping method, the components of the data structure can change in the conversion from SDMX to VTL and it must be taken into account that the VTL statements can reference only the components of the resulting VTL data structure. 1443 1443 1444 -At observation / data point level, calling Cj (j=1, … n) the j^^th^^ Concept of the 1911MeasureDimension:1368 +At observation / data point level, calling Cj (j=1, … n) the j^^th^^ Concept of the MeasureDimension: 1445 1445 1446 - The set of SDMX observations having the same values for all the Dimensions except than the MeasureDimension become one multi-measure VTL Data Point, having one Measure for each Concept Cj of the SDMX MeasureDimension; 1370 +* The set of SDMX observations having the same values for all the Dimensions except than the MeasureDimension become one multi-measure VTL Data Point, having one Measure for each Concept Cj of the SDMX MeasureDimension; 1371 +* The values of the SDMX simple Dimensions, TimeDimension and DataAttributes not depending on the MeasureDimension (these components by definition have always the same values for all the observations of the set above) become the values of the corresponding VTL (simple) Identifiers, (time) Identifier and Attributes. 1372 +* The value of the PrimaryMeasure of the SDMX observation belonging to the set above and having MeasureDimension=Cj becomes the value of the VTL Measure Cj 1373 +* For the SDMX DataAttributes depending on the MeasureDimension, the value of the DataAttribute DA of the SDMX observation belonging to the set above and having MeasureDimension=Cj becomes the value of the VTL Attribute DA_Cj 1447 1447 1448 -* 1449 -** The values of the SDMX simple Dimensions, TimeDimension and DataAttributes not depending on the MeasureDimension (these components by definition have always the same values for all the observations of the set above) become the values of the corresponding VTL (simple) Identifiers, (time) Identifier and Attributes. 1450 -** The value of the PrimaryMeasure of the SDMX observation belonging to the set above and having MeasureDimension=Cj becomes the value of the VTL Measure Cj 1451 -** For the SDMX DataAttributes depending on the MeasureDimension, the value of the DataAttribute DA of the SDMX observation belonging to the set above and having MeasureDimension=Cj becomes the value of the VTL Attribute DA_Cj 1375 +==== 10.3.3.3 From SDMX DataAttributes to VTL Measures ==== 1452 1452 1453 -* *10.3.3.3From SDMX DataAttributes to VTLMeasures**1377 +* In some cases it may happen that the DataAttributes of the SDMX DataStructure need to be managed as Measures in VTL. Therefore, a variant of both the methods above consists in transforming all the SDMX DataAttributes in VTL Measures. When DataAttributes are converted to Measures, the two methods above are called Basic_A2M and Pivot_A2M (the suffix “A2M” stands for Attributes to Measures). Obviously, the resulting VTL data structure is, in general, multi-measure and does not contain Attributes. 1454 1454 1455 -* 1456 -** In some cases it may happen that the DataAttributes of the SDMX DataStructure need to be managed as Measures in VTL. Therefore, a variant of both the methods above consists in transforming all the SDMX DataAttributes in VTL Measures. When DataAttributes are converted to Measures, the two methods above are called Basic_A2M and Pivot_A2M (the suffix “A2M” stands for Attributes to Measures). Obviously, the resulting VTL data structure is, in general, multi-measure and does not contain Attributes. 1457 - 1458 1458 The Basic_A2M and Pivot_A2M behaves respectively like the Basic and Pivot methods, except that the final VTL components, which according to the Basic and Pivot methods would have had the role of Attribute, assume instead the role of Measure. 1459 1459 1460 1460 Proper VTL features allow changing the role of specific attributes even after the SDMX to VTL mapping: they can be useful when only some of the DataAttributes need to be managed as VTL Measures. ... ... @@ -1461,7 +1461,7 @@ 1461 1461 1462 1462 === 10.3.4 Mapping from VTL to SDMX data structures === 1463 1463 1464 - **10.3.4.1 Basic Mapping **1385 +==== 10.3.4.1 Basic Mapping** ** ==== 1465 1465 1466 1466 The main mapping method **from VTL to SDMX** is called **Basic **mapping as well. 1467 1467 ... ... @@ -1469,20 +1469,19 @@ 1469 1469 1470 1470 The method consists in leaving the components unchanged and maintaining their names and roles in SDMX, according to the following mapping table, which is the same as the basic mapping from SDMX to VTL, only seen in the opposite direction. 1471 1471 1472 -This mapping method cannot be applied for SDMX 2.1 if the VTL data structure has more than one measure component, given that the SDMX 2.1 DataStructureDefinition allows just one measure component (the 1393 +This mapping method cannot be applied for SDMX 2.1 if the VTL data structure has more than one measure component, given that the SDMX 2.1 DataStructureDefinition allows just one measure component (the PrimaryMeasure). In this case it becomes mandatory to specify a different mapping method through the VtlMappingScheme and VtlDataflowMapping classes.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[24~]^^>>path:#_ftn24]](%%) 1473 1473 1474 -P rimaryMeasure).In this case itbecomesmandatoryto specify adifferent1958 mappingmethodthroughtheVtlMappingSchemeandVtlDataflowMapping1959 classes.[[(%class="wikiinternallinkwikiinternallink wikiinternallinkwikiinternallinkwikiinternallinkwikiinternallink"%)^^~[24~]^^>>path:#_ftn24]](%%)1395 +Please note that the VTL measures can have any name while in SDMX 2.1 the MeasureComponent has the mandatory name “obs_value”, therefore the name of the VTL measure name must become “obs_value” in SDMX 2.1. 1475 1475 1476 -1960 Please note that the VTL measures can have any name while in SDMX 2.1 the 1961 MeasureComponent has the mandatory name “obs_value”, therefore the name of the VTL measure name must become “obs_value” in SDMX 2.1. 1477 - 1478 1478 Mapping table: 1479 1479 1480 -|VTL|SDMX 1481 -|(Simple) Identifier|Dimension 1482 -|(Time) Identifier|TimeDimension 1483 -|(Measure) Identifier|MeasureDimension 1484 -|Measure|PrimaryMeasure 1485 -|Attribute|DataAttribute 1399 +(% style="width:592.294px" %) 1400 +|(% style="width:253px" %)**VTL**|(% style="width:336px" %)**SDMX** 1401 +|(% style="width:253px" %)(Simple) Identifier|(% style="width:336px" %)Dimension 1402 +|(% style="width:253px" %)(Time) Identifier|(% style="width:336px" %)TimeDimension 1403 +|(% style="width:253px" %)(Measure) Identifier|(% style="width:336px" %)MeasureDimension 1404 +|(% style="width:253px" %)Measure|(% style="width:336px" %)PrimaryMeasure 1405 +|(% style="width:253px" %)Attribute|(% style="width:336px" %)DataAttribute 1486 1486 1487 1487 If the distinction between simple identifier, time identifier and measure identifier is not maintained in the VTL environment, the classification between Dimension, TimeDimension and MeasureDimension exists only in SDMX, as declared in the relevant DataStructureDefinition. 1488 1488 ... ... @@ -1492,14 +1492,12 @@ 1492 1492 1493 1493 As said, the resulting SDMX definitions must be compliant with the SDMX consistency rules. For example, the SDMX DSD must have the assignmentStatus, which does not exist in VTL, the AttributeRelationship for the DataAttributes and so on. 1494 1494 1495 - **10.3.4.2 Unpivot Mapping**1415 +==== 10.3.4.2 Unpivot Mapping ==== 1496 1496 1497 1497 An alternative mapping method from VTL to SDMX is the **Unpivot **mapping. 1498 1498 1499 -Although this mapping method can be used in any case, it makes major sense in case the VTL data structure has more than one measure component (multi-measures VTL structure). For such VTL structures, in fact, the basic method cannot be applied, given that by maintaining the data structure unchanged the resulting SDMX data structure would have more than one measure component, which is not allowed by SDMX 2.1 (it allows just one measure component, the PrimaryMeasure, called 1419 +Although this mapping method can be used in any case, it makes major sense in case the VTL data structure has more than one measure component (multi-measures VTL structure). For such VTL structures, in fact, the basic method cannot be applied, given that by maintaining the data structure unchanged the resulting SDMX data structure would have more than one measure component, which is not allowed by SDMX 2.1 (it allows just one measure component, the PrimaryMeasure, called “obs_value”). 1500 1500 1501 -“obs_value”). 1502 - 1503 1503 The multi-measures VTL structures have not a Measure Identifier (because the Measures are separate components) and need to be converted to SDMX dataflows having an added MeasureDimension which disambiguates the multiple measures, and an added PrimaryMeasure, in which the measures’ values are maintained. 1504 1504 1505 1505 The **unpivot** mapping behaves like follows: ... ... @@ -1515,34 +1515,25 @@ 1515 1515 1516 1516 The summary mapping table of the **unpivot** mapping method is the following: 1517 1517 1518 - 1519 -|VTL|SDMX 1520 -|(Simple) Identifier|Dimension 1521 -|(Time) Identifier|TimeDimension 1522 -|All Measure Components|((( 1523 -MeasureDimension (having one Measure Concept for each VTL measure component) & 1524 - 1525 -PrimaryMeasure 1436 +(% style="width:904.294px" %) 1437 +|(% style="width:368px" %)**VTL**|(% style="width:533px" %)**SDMX** 1438 +|(% style="width:368px" %)(Simple) Identifier|(% style="width:533px" %)Dimension 1439 +|(% style="width:368px" %)(Time) Identifier|(% style="width:533px" %)TimeDimension 1440 +|(% style="width:368px" %)All Measure Components|(% style="width:533px" %)((( 1441 +MeasureDimension (having one Measure Concept for each VTL measure component) & PrimaryMeasure 1526 1526 ))) 1527 -|Attribute |((( 1528 -DataAttribute depending on all 1529 - 1530 -SDMX Dimensions including the 1531 - 1532 -TimeDimension and except the MeasureDimension 1443 +|(% style="width:368px" %)Attribute |(% style="width:533px" %)((( 1444 +DataAttribute depending on all SDMX Dimensions including the TimeDimension and except the MeasureDimension 1533 1533 ))) 1534 1534 1535 1535 At observation / data point level: 1536 1536 1537 - a multi-measure VTL Data Point becomes a set of SDMX observations, one for each VTL measure 1449 +* a multi-measure VTL Data Point becomes a set of SDMX observations, one for each VTL measure 1450 +* the values of the VTL identifiers become the values of the corresponding SDMX Dimensions, for all the observations of the set above 1451 +* the name of the j^^th^^ VTL measure (e.g. “Cj”) becomes the value of the SDMX MeasureDimension of the j^^th^^ observation of the set (i.e. the Concept Cj) 1452 +* the value of the j^^th^^ VTL measure becomes the value of the SDMX PrimaryMeasure of the j^^th^^ observation of the set 1453 +* the values of the VTL Attributes become the values of the corresponding SDMX DataAttributes (in principle for all the observations of the set above) 1538 1538 1539 - the values of the VTL identifiers become the values of the corresponding SDMX Dimensions, for all the observations of the set above 1540 - 1541 -* 1542 -** the name of the j^^th^^ VTL measure (e.g. “Cj”) becomes the value of the SDMX MeasureDimension of the j^^th^^ observation of the set (i.e. the Concept Cj) 1543 -** the value of the j^^th^^ VTL measure becomes the value of the SDMX PrimaryMeasure of the j^^th^^ observation of the set 1544 -** the values of the VTL Attributes become the values of the corresponding SDMX DataAttributes (in principle for all the observations of the set above) 1545 - 1546 1546 If desired, this method can be applied also to mono-measure VTL structures, provided that none of the VTL components has already the role of measure identifier. 1547 1547 1548 1548 Like in the general case, a MeasureDimension component called “measure_name” would be added to the SDMX DataStructure and would have just one possible measure concept, corresponding to the unique VTL measure. The original VTL measure component would not become a Component in the SDMX data structure. The value of the VTL measure would be assigned to the SDMX PrimaryMeasure called “obs_value”. ... ... @@ -1549,29 +1549,31 @@ 1549 1549 1550 1550 In any case, the resulting SDMX definitions must be compliant with the SDMX consistency rules. For example, the possible Concepts of the SDMX MeasureDimension need to be listed in a SDMX ConceptScheme, with proper id, agency and version; moreover, the SDMX DSD must have the assignmentStatus, which does not exist in VTL, the attributeRelationship for the DataAttributes and so on. 1551 1551 1552 - **10.3.4.3 From VTL Measures to SDMX Data Attributes **1461 +==== 10.3.4.3 From VTL Measures to SDMX Data Attributes** ** ==== 1553 1553 1554 1554 For the multi-measure VTL structures (having more than one Measure Component), it may happen that the Measures of the VTL Data Structure need to be managed as DataAttributes in SDMX. Therefore a third mapping method consists in transforming one VTL measure in the SDMX primaryMeasure and all the other VTL Measures in SDMX DataAttributes. This method is called M2A (“M2A” stands for “Measures to DataAttributes”). 1555 1555 1556 1556 When applied to mono-measure VTL structures (having one Measure component), the M2A method behaves like the Basic mapping (the VTL Measure component becomes the SDMX primary measure “obs_value”, there is no additional VTL measure to be converted to SDMX DataAttribute). Therefore the mapping table is the same as for the Basic method: 1557 1557 1558 -|VTL|SDMX 1559 -|(Simple) Identifier|Dimension 1560 -|(Time) Identifier|TimeDimension 1561 -|(Measure) Identifier (if any)|MeasureDimension 1562 -|Measure|PrimaryMeasure 1563 -|Attribute|DataAttribute 1467 +(% style="width:591.294px" %) 1468 +|(% style="width:252px" %)**VTL**|(% style="width:336px" %)**SDMX** 1469 +|(% style="width:252px" %)(Simple) Identifier|(% style="width:336px" %)Dimension 1470 +|(% style="width:252px" %)(Time) Identifier|(% style="width:336px" %)TimeDimension 1471 +|(% style="width:252px" %)(Measure) Identifier (if any)|(% style="width:336px" %)MeasureDimension 1472 +|(% style="width:252px" %)Measure|(% style="width:336px" %)PrimaryMeasure 1473 +|(% style="width:252px" %)Attribute|(% style="width:336px" %)DataAttribute 1564 1564 1565 1565 For multi-measure VTL structures (having more than one Measure component), one VTL Measure becomes the SDMX PrimaryMeasure while the other VTL Measures maintain their names and values but assume the role of DataAttribute in SDMX. The choice of the VTL Measure that correspond to the SDMX PrimaryMeasure is left to the definer of the SDMX data structure definition. 1566 1566 1567 - 2Taking into account that the multi-measure VTL structures do not have a measure2073identifier, the mapping table is the following:1477 +Taking into account that the multi-measure VTL structures do not have a measure identifier, the mapping table is the following: 1568 1568 1569 -|VTL|SDMX 1570 -|(Simple) Identifier|Dimension 1571 -|(Time) Identifier|TimeDimension 1572 -|One of the Measures|PrimaryMeasure 1573 -|Other Measures|DataAttribute 1574 -|Attribute|DataAttribute 1479 +(% style="width:588.294px" %) 1480 +|(% style="width:259px" %)**VTL**|(% style="width:326px" %)**SDMX** 1481 +|(% style="width:259px" %)(Simple) Identifier|(% style="width:326px" %)Dimension 1482 +|(% style="width:259px" %)(Time) Identifier|(% style="width:326px" %)TimeDimension 1483 +|(% style="width:259px" %)One of the Measures|(% style="width:326px" %)PrimaryMeasure 1484 +|(% style="width:259px" %)Other Measures|(% style="width:326px" %)DataAttribute 1485 +|(% style="width:259px" %)Attribute|(% style="width:326px" %)DataAttribute 1575 1575 1576 1576 Even in this case, the resulting SDMX definitions must be compliant with the SDMX consistency rules. For example, the SDMX DSD must have the assignmentStatus, which does not exist in VTL, the attributeRelationship for the DataAttributes and so on. In particular, the primaryMeasure of the SDMX 2.1 DSD must be called “obs_value” and must be one of the VTL Measures, chosen by the DSD definer. 1577 1577 ... ... @@ -1579,7 +1579,6 @@ 1579 1579 1580 1580 In order to define and understand properly VTL transformations, the applied mapping methods must be specified in the SDMX structural metadata. If the default mapping method (Basic) is applied, no specification is needed. 1581 1581 1582 - 1583 1583 A customized mapping can be defined through the VtlMappingScheme and VtlDataflowMapping classes (see the section of the SDMX IM relevant to the VTL). A VtlDataflowMapping allows specifying the mapping methods to be used for a specific dataflow, both in the direction from SDMX to VTL (toVtlMappingMethod) and from VTL to SDMX (fromVtlMappingMethod); in fact a VtlDataflowMapping associates the structured URN that identifies a SDMX dataflow to its VTL alias and its mapping methods. 1584 1584 1585 1585 It is possible to specify the toVtlMappingMethod and fromVtlMappingMethod also for the conventional dataflow called “generic_dataflow”: in this case the specified mapping methods are intended to become the default ones, overriding the ... ... @@ -1588,35 +1588,28 @@ 1588 1588 1589 1589 The VtlMappingScheme is a container for zero or more VtlDataflowMapping (besides possible mappings to artefacts other than dataflows). 1590 1590 1591 -=== 10.3.6 Mapping dataflow subsets to distinct VTL data sets[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^**~[25~]**^^>>path:#_ftn25]](%%) === 1501 +=== 10.3.6 Mapping dataflow subsets to distinct VTL data sets[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^**~[25~]**^^>>path:#_ftn25]](%%) === 1592 1592 1593 1593 Until now it as been assumed to map one SMDX Dataflow to one VTL dataset and vice-versa. This mapping one-to-one is not mandatory according to VTL because a VTL data set is meant to be a set of observations (data points) on a logical plane, having the same logical data structure and the same general meaning, independently of the possible physical representation or storage (see VTL 2.0 User Manual page 1594 1594 1595 1595 24), therefore a SDMX Dataflow can be seen either as a unique set of data observations (corresponding to one VTL data set) or as the union of many sets of data observations (each one corresponding to a distinct VTL data set). 1596 1596 1597 -As a matter of fact, in some cases it can be useful to define VTL operations involving definite parts of a SDMX Dataflow instead than the whole.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[26~]^^>>path:#_ftn26]](%%) 1507 +As a matter of fact, in some cases it can be useful to define VTL operations involving definite parts of a SDMX Dataflow instead than the whole.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[26~]^^>>path:#_ftn26]](%%) 1598 1598 1599 -Therefore, in order to make the coding of VTL operations simpler when applied on parts of SDMX Dataflows, it is allowed to map distinct parts of a SDMX Dataflow to distinct VTL data sets according to the following rules and conventions. This kind of mapping is possible both from SDMX to VTL and from VTL to SDMX, as better explained below.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[27~]^^>>path:#_ftn27]](%%) 1509 +Therefore, in order to make the coding of VTL operations simpler when applied on parts of SDMX Dataflows, it is allowed to map distinct parts of a SDMX Dataflow to distinct VTL data sets according to the following rules and conventions. This kind of mapping is possible both from SDMX to VTL and from VTL to SDMX, as better explained below.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[27~]^^>>path:#_ftn27]](%%) 1600 1600 1601 - GivenaSDMX Dataflowandsomepredefined Dimensions of its1511 +Given a SDMX Dataflow and some predefined Dimensions of its DataStructure, it is allowed to map the subsets of observations that have the same combination of values for such Dimensions to correspondent VTL datasets. 1602 1602 1603 - DataStructure,it is allowedto map the subsetsof observations that have the samecombination ofvalues forsuchDimensionstocorrespondentVTL datasets.1513 +For example, assuming that the SDMX dataflow DF1(1.0) has the Dimensions INDICATOR, TIME_PERIOD and COUNTRY, and that the user declares the Dimensions INDICATOR and COUNTRY as basis for the mapping (i.e. the mapping dimensions): the observations that have the same values for INDICATOR and COUNTRY would be mapped to the same VTL dataset (and vice-versa). 1604 1604 1605 -For example, assuming that the SDMX dataflow DF1(1.0) has the Dimensions INDICATOR, TIME_PERIOD and COUNTRY, and that the user declares the 1606 - 1607 -Dimensions INDICATOR and COUNTRY as basis for the mapping (i.e. the mapping dimensions): the observations that have the same values for INDICATOR and COUNTRY would be mapped to the same VTL dataset (and vice-versa). 1608 - 1609 1609 In practice, this kind mapping is obtained like follows: 1610 1610 1611 -* For a given SDMX dataflow, the user (VTL definer) declares the dimension components on which the mapping will be based, in a given order.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[28~]^^>>path:#_ftn28]](%%) Following the example above, imagine that the user declares the dimensions INDICATOR and COUNTRY. 1517 +* For a given SDMX dataflow, the user (VTL definer) declares the dimension components on which the mapping will be based, in a given order.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[28~]^^>>path:#_ftn28]](%%) Following the example above, imagine that the user declares the dimensions INDICATOR and COUNTRY. 1612 1612 * The VTL dataset is given a name using a special notation also called “ordered concatenation” and composed of the following parts: 1613 -** The reference to the SDMX dataflow (expressed according to the rules described in the previous paragraphs, i.e. URN, abbreviated 1519 +** The reference to the SDMX dataflow (expressed according to the rules described in the previous paragraphs, i.e. URN, abbreviated URN or another alias); for example DF(1.0); 1520 +** a slash (“/”) as a separator; [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[29~]^^>>path:#_ftn29]] 1521 +** The reference to a specific part of the SDMX dataflow above, expressed as the concatenation of the values that the SDMX dimensions declared above must have, separated by dots (“.”) and written in the order in which these dimensions are defined[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[30~]^^>>path:#_ftn30]](%%) . For example POPULATION.USA would mean that such a VTL dataset is mapped to the SDMX observations for which the dimension //INDICATOR// is equal to POPULATION and the dimension //COUNTRY// is equal to USA. 1614 1614 1615 -URN or another alias); for example DF(1.0); o a slash (“/”) as a separator; [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[29~]^^>>path:#_ftn29]] 1616 - 1617 -* 1618 -** The reference to a specific part of the SDMX dataflow above, expressed as the concatenation of the values that the SDMX dimensions declared above must have, separated by dots (“.”) and written in the order in which these dimensions are defined[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[30~]^^>>path:#_ftn30]](%%) . For example POPULATION.USA would mean that such a VTL dataset is mapped to the SDMX observations for which the dimension //INDICATOR// is equal to POPULATION and the dimension //COUNTRY// is equal to USA. 1619 - 1620 1620 In the VTL transformations, this kind of dataset name must be referenced between single quotes because the slash (“/”) is not a regular character according to the VTL rules. 1621 1621 1622 1622 Therefore, the generic name of this kind of VTL datasets would be: ... ... @@ -1633,7 +1633,7 @@ 1633 1633 1634 1634 Let us now analyse the different meaning of this kind of mapping in the two mapping directions, i.e. from SDMX to VTL and from VTL to SDMX. 1635 1635 1636 -As already said, the mapping from SDMX to VTL happens when the VTL datasets are operand of VTL transformations, instead the mapping from VTL to SDMX happens when the VTL datasets are result of VTL transformations[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[31~]^^>>path:#_ftn31]](%%) and need to be treated as SDMX objects. This kind of mapping can be applied independently in the two directions and the Dimensions on which the mapping is based can be different in the two directions: these Dimensions are defined in the ToVtlSpaceKey and in the FromVtlSpaceKey classes respectively. 1539 +As already said, the mapping from SDMX to VTL happens when the VTL datasets are operand of VTL transformations, instead the mapping from VTL to SDMX happens when the VTL datasets are result of VTL transformations[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[31~]^^>>path:#_ftn31]](%%) and need to be treated as SDMX objects. This kind of mapping can be applied independently in the two directions and the Dimensions on which the mapping is based can be different in the two directions: these Dimensions are defined in the ToVtlSpaceKey and in the FromVtlSpaceKey classes respectively. 1637 1637 1638 1638 First, let us see what happens in the mapping direction from SDMX to VTL, i.e. when parts of a SDMX dataflow (e.g. DF1(1.0)) need to be mapped to distinct VTL datasets that are operand of some VTL transformations. 1639 1639 ... ... @@ -1643,7 +1643,7 @@ 1643 1643 1644 1644 //COUNTRYvalue//. For example, the VTL dataset ‘DF1(1.0)/POPULATION.USA’ would contain all the observations of DF1(1.0) having INDICATOR = POPULATION and COUNTRY = USA. 1645 1645 1646 -In order to obtain the data structure of these VTL datasets from the SDMX one, it is assumed that the SDMX dimensions on which the mapping is based are dropped, i.e. not maintained in the VTL data structure; this is possible because their values are fixed for each one of the invoked VTL datasets[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[32~]^^>>path:#_ftn32]](%%). After that, the mapping method from SDMX to VTL specified for the dataflow DF1(1.0) is applied (i.e. basic, pivot …). 1549 +In order to obtain the data structure of these VTL datasets from the SDMX one, it is assumed that the SDMX dimensions on which the mapping is based are dropped, i.e. not maintained in the VTL data structure; this is possible because their values are fixed for each one of the invoked VTL datasets[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[32~]^^>>path:#_ftn32]](%%). After that, the mapping method from SDMX to VTL specified for the dataflow DF1(1.0) is applied (i.e. basic, pivot …). 1647 1647 1648 1648 In the example above, for all the datasets of the kind 1649 1649 ... ... @@ -1663,7 +1663,7 @@ 1663 1663 1664 1664 … … … 1665 1665 1666 -In fact the VTL operator “sub” has exactly the same behaviour. Therefore, mapping different parts of a SDMX dataflow to different VTL datasets in the direction from SDMX to VTL through the ordered concatenation notation is equivalent to a proper use of the operator “**sub**” on such a dataflow. [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[33~]^^>>path:#_ftn33]] 1569 +In fact the VTL operator “sub” has exactly the same behaviour. Therefore, mapping different parts of a SDMX dataflow to different VTL datasets in the direction from SDMX to VTL through the ordered concatenation notation is equivalent to a proper use of the operator “**sub**” on such a dataflow. [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[33~]^^>>path:#_ftn33]] 1667 1667 1668 1668 In the direction from SDMX to VTL it is allowed to omit the value of one or more Dimensions on which the mapping is based, but maintaining all the separating dots (therefore it may happen to find two or more consecutive dots and dots in the beginning or in the end). The absence of value means that for the corresponding Dimension all the values are kept and the Dimension is not dropped. 1669 1669 ... ... @@ -1686,12 +1686,12 @@ 1686 1686 1687 1687 For example, let us assume that the VTL programmer wants to calculate the SDMX dataflow DF2(1.0) having the Dimensions TIME_PERIOD, INDICATOR, and COUNTRY and that such a programmer finds it convenient to calculate separately the parts of DF2(1.0) that have different combinations of values for INDICATOR and COUNTRY: 1688 1688 1689 -* each part is calculated as a VTL derived dataset, result of a dedicated VTL transformation; [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[34~]^^>>path:#_ftn34]](%%) 1690 -* the data structure of all these VTL datasets has the TIME_PERIOD identifier and does not have the INDICATOR and COUNTRY identifiers.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[35~]^^>>path:#_ftn35]] 1592 +* each part is calculated as a VTL derived dataset, result of a dedicated VTL transformation; [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[34~]^^>>path:#_ftn34]](%%) 1593 +* the data structure of all these VTL datasets has the TIME_PERIOD identifier and does not have the INDICATOR and COUNTRY identifiers.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[35~]^^>>path:#_ftn35]] 1691 1691 1692 -Under these hypothesis, such derived VTL datasets can be mapped to DF2(1.0) by declaring the Dimensions INDICATOR and COUNTRY as mapping dimensions[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[36~]^^>>path:#_ftn36]](%%). 1595 +Under these hypothesis, such derived VTL datasets can be mapped to DF2(1.0) by declaring the Dimensions INDICATOR and COUNTRY as mapping dimensions[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[36~]^^>>path:#_ftn36]](%%). 1693 1693 1694 -The corresponding VTL transformations, assuming that the result needs to be persistent, would be of this kind:^^ ^^[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[37~]^^>>path:#_ftn37]] 1597 +The corresponding VTL transformations, assuming that the result needs to be persistent, would be of this kind:^^ ^^[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[37~]^^>>path:#_ftn37]] 1695 1695 1696 1696 ‘DF2(1.0)///INDICATORvalue//.//COUNTRYvalue//’ <- expression 1697 1697 ... ... @@ -1758,9 +1758,9 @@ 1758 1758 1759 1759 …); 1760 1760 1761 -In other words, starting from the datasets explicitly calculated through VTL (in the example ‘DF2(1.0)/GDPPERCAPITA.USA’ and so on), the first step consists in calculating other (non-persistent) VTL datasets (in the example DF2bis_GDPPERCAPITA_USA and so on) by adding the identifiers INDICATOR and COUNTRY with the desired values (//INDICATORvalue// and //COUNTRYvalue)//. Finally, all these non-persistent data sets are united and give the final result DF2(1.0)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[38~]^^>>path:#_ftn38]](%%), which can be mapped one-to-one to the homonymous SDMX dataflow having the dimension components TIME_PERIOD, INDICATOR and COUNTRY. 1664 +In other words, starting from the datasets explicitly calculated through VTL (in the example ‘DF2(1.0)/GDPPERCAPITA.USA’ and so on), the first step consists in calculating other (non-persistent) VTL datasets (in the example DF2bis_GDPPERCAPITA_USA and so on) by adding the identifiers INDICATOR and COUNTRY with the desired values (//INDICATORvalue// and //COUNTRYvalue)//. Finally, all these non-persistent data sets are united and give the final result DF2(1.0)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[38~]^^>>path:#_ftn38]](%%), which can be mapped one-to-one to the homonymous SDMX dataflow having the dimension components TIME_PERIOD, INDICATOR and COUNTRY. 1762 1762 1763 -Therefore, mapping different VTL datasets having the same data structure to different parts of a SDMX dataflow, i.e. in the direction from VTL to SDMX, through the ordered concatenation notation is equivalent to a proper use of the operators “calc” and “union” on such datasets. [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[39~]^^>>path:#_ftn39]](%%)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[40~]^^>>path:#_ftn40]] 1666 +Therefore, mapping different VTL datasets having the same data structure to different parts of a SDMX dataflow, i.e. in the direction from VTL to SDMX, through the ordered concatenation notation is equivalent to a proper use of the operators “calc” and “union” on such datasets. [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[39~]^^>>path:#_ftn39]](%%)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[40~]^^>>path:#_ftn40]] 1764 1764 1765 1765 It is worth noting that in the direction from VTL to SDMX it is mandatory to specify the value for every Dimension on which the mapping is based (in other word, in the name of the calculated VTL dataset is not possible to omit the value of some of the Dimensions). 1766 1766 ... ... @@ -1809,7 +1809,7 @@ 1809 1809 1810 1810 Domain) is not identifiable. As a consequence, the definition of the VTL rulesets, which in VTL can refer either to enumerated or non-enumerated value domains, in SDMX can refer only to enumerated Value Domains (i.e. to SDMX Codelists). 1811 1811 1812 -As for the mapping between VTL variables and SDMX Concepts, it should be noted that these artefacts do not coincide perfectly. In fact, the VTL variables are represented variables, defined always on the same Value Domain (“Representation” in SDMX) independently of the data set / data structure in which they appear[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[41~]^^>>path:#_ftn41]](%%), while the SDMX Concepts can have different Representations in different DataStructures.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[42~]^^>>path:#_ftn42]](%%) This means that one SDMX Concept can correspond to many VTL Variables, one for each representation the Concept has. 1715 +As for the mapping between VTL variables and SDMX Concepts, it should be noted that these artefacts do not coincide perfectly. In fact, the VTL variables are represented variables, defined always on the same Value Domain (“Representation” in SDMX) independently of the data set / data structure in which they appear[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[41~]^^>>path:#_ftn41]](%%), while the SDMX Concepts can have different Representations in different DataStructures.[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[42~]^^>>path:#_ftn42]](%%) This means that one SDMX Concept can correspond to many VTL Variables, one for each representation the Concept has. 1813 1813 1814 1814 Therefore, it is important to be aware that some VTL operations (for example the binary operations at data set level) are consistent only if the components having the same names in the operated VTL data sets have also the same representation (i.e. the same Value Domain as for VTL). For example, it is possible to obtain correct results from the VTL expression 1815 1815 ... ... @@ -2154,7 +2154,7 @@ 2154 2154 |N|fixed number of digits used in the preceding textual representation of the month or the day 2155 2155 | | 2156 2156 2157 -The default conversion, either standard or customized, can be used to deduce automatically the representation of the components of the result of a VTL transformation. In alternative, the representation of the resulting SDMX Dataflow can be given explicitly by providing its DataStructureDefinition. In other words, the representation specified in the DSD, if available, overrides any default conversion[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[43~]^^>>path:#_ftn43]](%%). 2060 +The default conversion, either standard or customized, can be used to deduce automatically the representation of the components of the result of a VTL transformation. In alternative, the representation of the resulting SDMX Dataflow can be given explicitly by providing its DataStructureDefinition. In other words, the representation specified in the DSD, if available, overrides any default conversion[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[43~]^^>>path:#_ftn43]](%%). 2158 2158 2159 2159 === 10.4.5 Null Values === 2160 2160 ... ... @@ -2226,14 +2226,22 @@ 2226 2226 2227 2227 The difference between the two is that for the first method, **SubmitXml**, the XmlSerializer will expect an element named **input** to be an immediate child of the **SubmitXml** element in the SOAP body. The second method, **SubmitXmlAny**, will not care what the name of the child of the **SubmitXmlAny** element is. It will plug whatever XML is included into the input parameter. The message style from ASP.NET Help for the two methods is shown below. First we look at the message for the method without the **XmlAnyElement** attribute. 2228 2228 2132 +[[image:1747854163928-581.png]] 2133 + 2229 2229 Now we look at the message for the method that uses the **XmlAnyElement** attribute. 2230 2230 2136 +[[image:1747854190641-364.png]] 2137 + 2138 +[[image:1747854236732-512.png]] 2139 + 2231 2231 The method decorated with the **XmlAnyElement** attribute has one fewer wrapping elements. Only an element with the name of the method wraps what is passed to the **input** parameter. 2232 2232 2233 -For more information please consult: [[http:~~/~~/msdn.microsoft.com/en>>url:http://msdn.microsoft.com/en-us/library/aa480498.aspx]][[->>url:http://msdn.microsoft.com/en-us/library/aa480498.aspx]][[us/library/aa480498.aspx>>url:http://msdn.microsoft.com/en-us/library/aa480498.aspx]][[url:http://msdn.microsoft.com/en-us/library/aa480498.aspx]]2142 +For more information please consult: [[http:~~/~~/msdn.microsoft.com/en-us/library/aa480498.aspx>>http://msdn.microsoft.com/en-us/library/aa480498.aspx]] 2234 2234 2235 2235 Furthermore at this point the problem with the different requests has been solved. However there is still the difference in the produced WSDL that has to be taken care. The automatic generated WSDL now doesn’t insert the extra element, but defines the content of the operation wrapper element as “xsd:any” type. 2236 2236 2146 +[[image:1747854286398-614.png]] 2147 + 2237 2237 Without a common WSDL still the solution doesn’t enforce interoperability. In order to 2238 2238 2239 2239 “fix” the WSDL, there two approaches. The first is to intervene in the generation process. This is a complicated approach, compared to the second approach, which overrides the generation process and returns the envisioned WSDL for the SDMX Web Service. ... ... @@ -2246,16 +2246,28 @@ 2246 2246 2247 2247 In the context of the SDMX Web Service, applying the above solution translates into the following: 2248 2248 2160 +[[image:1747854385465-132.png]] 2161 + 2249 2249 The SOAP request/response will then be as follows: 2250 2250 2251 2251 **GenericData Request** 2252 2252 2166 +[[image:1747854406014-782.png]] 2167 + 2253 2253 **GenericData Response** 2254 2254 2170 +[[image:1747854424488-855.png]] 2171 + 2255 2255 For overriding the automatically produced WSDL, in the solution explorer right click the project and select “Add” -> “New item…”. Then select the “Global Application Class”. This will create “.asax” class file in which the following code should replace the existing empty method: 2256 2256 2174 +[[image:1747854453895-524.png]] 2175 + 2176 +[[image:1747854476631-125.png]] 2177 + 2257 2257 The SDMX_WSDL.wsdl should reside in the in the root directory of the application. After applying this solution the returned WSDL is the envisioned. Thus in the request message definition contains: 2258 2258 2180 +[[image:1747854493363-776.png]] 2181 + 2259 2259 ---- 2260 2260 2261 2261 [[~[1~]>>path:#_ftnref1]] The seconds can be reported fractionally ... ... @@ -2347,3 +2347,5 @@ 2347 2347 [[~[42~]>>path:#_ftnref42]] A Concept becomes a Component in a DataStructureDefinition, and Components can have different LocalRepresentations in different DataStructureDefinitions, also overriding the (possible) base representation of the Concept. 2348 2348 2349 2349 [[~[43~]>>path:#_ftnref43]] The representation given in the DSD should obviously be compatible with the VTL data type. 2273 + 2274 +{{putFootnotes/}}
- 1747854163928-581.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +29.8 KB - Content
- 1747854190641-364.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +31.5 KB - Content
- 1747854236732-512.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +2.0 KB - Content
- 1747854286398-614.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747854385465-132.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747854406014-782.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747854424488-855.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747854453895-524.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747854476631-125.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747854493363-776.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747855024745-946.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747855054559-410.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747855075263-887.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747855402867-579.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747855462293-368.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- 1747855493531-357.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content