Last modified by Helena on 2025/09/10 11:19

From version 5.4
edited by Elena
on 2025/06/16 16:33
Change comment: There is no comment for this version
To version 7.1
edited by Elena
on 2025/06/16 17:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -14,30 +14,30 @@
14 14  
15 15  === 4.2.1 Defining Concepts ===
16 16  
17 -Any [[component>>doc:sdmx:Glossary.Component.WebHome]] of a data or [[metadata structure definition>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] must take its semantic from a (% style="color:#e74c3c" %)concept(%%). This (% style="color:#e74c3c" %)concept(%%) is important in that it:
17 +Any [[component>>doc:sdmx:Glossary.Component.WebHome]] of a data or [[metadata structure definition>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] must take its semantic from a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%). This concept is important in that it:
18 18  
19 19  1. Provides a detailed definition of the [[component>>doc:sdmx:Glossary.Component.WebHome]] which describes the structure of the data or metadata.
20 -1. Can allow data and metadata for different structures to be comparable when (% style="color:#e74c3c" %)concepts(%%) are reused.
20 +1. Can allow data and metadata for different structures to be comparable when (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) are reused.
21 21  
22 -It is important when defining (% style="color:#e74c3c" %)concepts(%%) to first consider (% style="color:#e74c3c" %)concepts(%%) which are already defined within a given community, whether it be the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] community as a whole or a smaller community of users in a particular sector. As general rule, one should not define a new (% style="color:#e74c3c" %)concept(%%) when an existing (% style="color:#e74c3c" %)concept(%%) will suffice. By reusing an existing (% style="color:#e74c3c" %)concept(%%), data and metadata are more easily understood in a wider range of applications. This leads to greater interoperability and [[comparability>>doc:sdmx:Glossary.Comparability.WebHome]] of data/metadata.
22 +It is important when defining (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) to first consider (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) which are already defined within a given community, whether it be the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] community as a whole or a smaller community of users in a particular sector. As general rule, one should not define a new (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) when an existing (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) will suffice. By reusing an existing (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%), data and metadata are more easily understood in a wider range of applications. This leads to greater interoperability and [[comparability>>doc:sdmx:Glossary.Comparability.WebHome]] of data/metadata.
23 23  
24 -Assuming new (% style="color:#e74c3c" %)concepts(%%) are to be defined, the first step is to determine an appropriate grouping for (% style="color:#e74c3c" %)concepts(%%). In [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]], all (% style="color:#e74c3c" %)concepts(%%) are defined in schemes. These schemes serve to group similar (% style="color:#e74c3c" %)concepts(%%) into groups which can be useful for maintenance purposes. One possible distinction to be used to determine the grouping of (% style="color:#e74c3c" %)concepts(%%) is their intended usage. If (% style="color:#e74c3c" %)concepts(%%) are only to be used for metadata, it may be best to group these into a single scheme. Similarly, if (% style="color:#e74c3c" %)concepts(%%) are only to be used for data, these too may be grouped into a single scheme. It is important to consider that (% style="color:#e74c3c" %)concepts(%%) themselves are not versioned, rather the schemes in which they are defined are versioned. This means that if any property of a (% style="color:#e74c3c" %)concept(%%) is to change, the (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)version(%%) of the scheme in which it is defined must change if the scheme is marked as “final”. This in effect (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)versions(%%) all (% style="color:#e74c3c" %)concepts(%%) defined in that scheme. Therefore, when grouping (% style="color:#e74c3c" %)concepts(%%) into schemes it is important to consider the stability of the (% style="color:#e74c3c" %)concept(%%) definitions.
24 +Assuming new (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) are to be defined, the first step is to determine an appropriate grouping for (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%). In [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]], all (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) are defined in schemes. These schemes serve to group similar (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) into groups which can be useful for maintenance purposes. One possible distinction to be used to determine the grouping of (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) is their intended usage. If (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) are only to be used for metadata, it may be best to group these into a single scheme. Similarly, if (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) are only to be used for data, these too may be grouped into a single scheme. It is important to consider that (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) themselves are not versioned, rather the schemes in which they are defined are versioned. This means that if any property of a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) is to change, the [[version>>doc:Glossary.Version.WebHome]] of the scheme in which it is defined must change if the scheme is marked as “final”. This in effect versions all (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) defined in that scheme. Therefore, when grouping (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) into schemes it is important to consider the stability of the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) definitions.
25 25  
26 -A (% style="color:#e74c3c" %)concept(%%) itself consists of three main [[components>>doc:sdmx:Glossary.Component.WebHome]]:
26 +A (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) itself consists of three main [[components>>doc:sdmx:Glossary.Component.WebHome]]:
27 27  
28 28  1. Its identification, which must be unique within the scheme.
29 29  1. Its name.
30 30  1. Its description.
31 31  
32 -Note that the description is not mandatory, but is highly recommended in order to provide a more complete definition of a (% style="color:#e74c3c" %)concept(%%). When you consider that these (% style="color:#e74c3c" %)concepts(%%) are the building blocks which are constructed to define the structure of all data and metadata in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]], it should be apparent why complete definitions are important.
32 +Note that the description is not mandatory, but is highly recommended in order to provide a more complete definition of a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%). When you consider that these (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) are the building blocks which are constructed to define the structure of all data and metadata in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]], it should be apparent why complete definitions are important.
33 33  
34 -In addition to the basic definition properties of the (% style="color:#e74c3c" %)concept(%%), a (% style="color:#e74c3c" %)concept(%%) can reference another (% style="color:#e74c3c" %)concept(%%) from within the same scheme as its parent (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%). The exact nature of this parent child relationship is not strictly enforced by the standard, but it is typically used to denote the child (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) is a specialization of the parent. For example, one may have a (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) which defines a [[reference area>>doc:sdmx:Glossary.Reference area.WebHome]] (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) as a "geographic area to which a measured statistical phenomenon relates". In order to allow for more specific types of [[references areas>>doc:sdmx:Glossary.Reference area.WebHome]], one might define (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concepts(%%) for countries as well as groups of geographically similar countries (e.g. continents) and political countries (e.g. military or economic alliances). These child (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concepts(%%) could reference the [[reference area>>doc:sdmx:Glossary.Reference area.WebHome]] (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) as a parent in order to note that they are specializations of a [[reference area>>doc:sdmx:Glossary.Reference area.WebHome]]". An example of this can be seen in the Common Structures sample set. In this sample the [[confidentiality status>>doc:sdmx:Glossary.Confidentiality - status.WebHome]] references the [[confidentiality>>doc:sdmx:Glossary.Confidentiality.WebHome]] (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) as a parent. The status is a specialization of a general [[confidentiality>>doc:sdmx:Glossary.Confidentiality.WebHome]] (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%).
34 +In addition to the basic definition properties of the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%), a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) can reference another (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) from within the same scheme as its parent (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%). The exact nature of this parent child relationship is not strictly enforced by the standard, but it is typically used to denote the child (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) is a specialization of the parent. For example, one may have a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) which defines a [[reference area>>doc:sdmx:Glossary.Reference area.WebHome]] (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) as a "geographic area to which a measured statistical phenomenon relates". In order to allow for more specific types of [[references areas>>doc:sdmx:Glossary.Reference area.WebHome]], one might define (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) for countries as well as groups of geographically similar countries (e.g. continents) and political countries (e.g. military or economic alliances). These child (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) could reference the [[reference area>>doc:sdmx:Glossary.Reference area.WebHome]] (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) as a parent in order to note that they are specializations of a [[reference area>>doc:sdmx:Glossary.Reference area.WebHome]]". An example of this can be seen in the Common Structures sample set. In this sample the [[confidentiality status>>doc:sdmx:Glossary.Confidentiality - status.WebHome]] references the [[confidentiality>>doc:sdmx:Glossary.Confidentiality.WebHome]] (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) as a parent. The status is a specialization of a general [[confidentiality>>doc:sdmx:Glossary.Confidentiality.WebHome]] (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%).
35 35  
36 -< note the test for whether something is a specialization is to ask the question “is xxx a type of yyy” In the Cross Domain (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)Concepts(%%) the question would be “Is [[confidentiality status>>doc:sdmx:Glossary.Confidentiality - status.WebHome]] a type of [[confidentiality>>doc:sdmx:Glossary.Confidentiality.WebHome]]”. The answer is “no”. The problem here is that the cross domain (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concepts(%%) are grouped, often in a structural and not semantic sense. This, unfortunately, is carried over in the [[SDMX-ML>>doc:sdmx:Glossary.SDMX-ML.WebHome]] and needs to be rectified.>
36 +< note the test for whether something is a specialization is to ask the question “is xxx a type of yyy” In the Cross Domain (% style="color:#e74c3c" %)[[Concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) the question would be “Is [[confidentiality status>>doc:sdmx:Glossary.Confidentiality - status.WebHome]] a type of [[confidentiality>>doc:sdmx:Glossary.Confidentiality.WebHome]]”. The answer is “no”. The problem here is that the cross domain (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) are grouped, often in a structural and not semantic sense. This, unfortunately, is carried over in the [[SDMX-ML>>doc:sdmx:Glossary.SDMX-ML.WebHome]] and needs to be rectified.>
37 37  
38 -When a [[component>>doc:sdmx:Glossary.Component.WebHome]] in a structure definition takes its semantic from a (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%), it always is provided a value in the data or metadata reported against the structure. A (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) can define the default nature of these values. This is done with a definition of a //core [[representation>>doc:sdmx:Glossary.Representation.WebHome]]//. The core [[representation>>doc:sdmx:Glossary.Representation.WebHome]] can either be a un-coded text format, in which a data type is defined along with [[facets>>doc:sdmx:Glossary.Facet.WebHome]] which serve to further restrict that data type, or a coded enumeration in which a [[code list>>doc:sdmx:Glossary.Code list.WebHome]] can be referenced. In the case where an enumerated core [[representation>>doc:sdmx:Glossary.Representation.WebHome]] is defined, the nature of the enumeration values can be described in the same manner that the un-coded text format could be. Note that if a (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) is not provided a core [[representation>>doc:sdmx:Glossary.Representation.WebHome]], it is assumed to have an unbounded value set (i.e. it could be represented by a variety of [[code lists>>doc:sdmx:Glossary.Code list.WebHome]] or un-enumerated formats when used in a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] or [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]]). However, as with any core [[representation>>doc:sdmx:Glossary.Representation.WebHome]], a usage of the (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) in a structure definition can always provide a local [[representation>>doc:sdmx:Glossary.Representation.WebHome]] which overrides the core [[representation>>doc:sdmx:Glossary.Representation.WebHome]] of the (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%).
38 +When a [[component>>doc:sdmx:Glossary.Component.WebHome]] in a structure definition takes its semantic from a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%), it always is provided a value in the data or metadata reported against the structure. A (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) can define the default nature of these values. This is done with a definition of a //core [[representation>>doc:sdmx:Glossary.Representation.WebHome]]//. The core [[representation>>doc:sdmx:Glossary.Representation.WebHome]] can either be a un-coded text format, in which a data type is defined along with [[facets>>doc:sdmx:Glossary.Facet.WebHome]] which serve to further restrict that data type, or a coded enumeration in which a [[code list>>doc:sdmx:Glossary.Code list.WebHome]] can be referenced. In the case where an enumerated core [[representation>>doc:sdmx:Glossary.Representation.WebHome]] is defined, the nature of the enumeration values can be described in the same manner that the un-coded text format could be. Note that if a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) is not provided a core [[representation>>doc:sdmx:Glossary.Representation.WebHome]], it is assumed to have an unbounded value set (i.e. it could be represented by a variety of [[code lists>>doc:sdmx:Glossary.Code list.WebHome]] or un-enumerated formats when used in a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] or [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]]). However, as with any core [[representation>>doc:sdmx:Glossary.Representation.WebHome]], a usage of the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) in a structure definition can always provide a local [[representation>>doc:sdmx:Glossary.Representation.WebHome]] which overrides the core [[representation>>doc:sdmx:Glossary.Representation.WebHome]] of the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%).
39 39  
40 -Finally, in order to provide a more complete conceptual definition, the (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) can reference an ISO 11179 (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%). The intention of this reference is to reference the ISO 11179 (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) definition from which this [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] (% style="color: rgb(231, 76, 60); color: rgb(231, 76, 60)" %)concept(%%) definition is derived.
40 +Finally, in order to provide a more complete conceptual definition, the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) can reference an ISO 11179 (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%). The intention of this reference is to reference the ISO 11179 (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) definition from which this [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) definition is derived.
41 41  
42 42  === 4.2.2 Defining Code Lists ===
43 43  
... ... @@ -64,19 +64,19 @@
64 64  (% style="text-align: center;" %)
65 65  **{{id name="image_3"/}}Figure 3: Schematic of the Data Structure Definition**
66 66  
67 -Each [[component>>doc:sdmx:Glossary.Component.WebHome]] must reference a (% style="color:#e74c3c" %)concept(%%) from which it takes its semantic. This (% style="color:#e74c3c" %)concept(%%) defines the meaning of the [[component>>doc:sdmx:Glossary.Component.WebHome]]. Typically, the [[component>>doc:sdmx:Glossary.Component.WebHome]] will also take its identity from this (% style="color:#e74c3c" %)concept(%%), although it is possible for a (data) structure-specific identity to be created. Regardless of whether the (% style="color:#e74c3c" %)concept(%%) identity is used or a local identifier is assigned, the identifier of a [[component>>doc:sdmx:Glossary.Component.WebHome]] must be unique within the scope of all data structure [[components>>doc:sdmx:Glossary.Component.WebHome]].
67 +Each [[component>>doc:sdmx:Glossary.Component.WebHome]] must reference a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) from which it takes its semantic. This (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) defines the meaning of the [[component>>doc:sdmx:Glossary.Component.WebHome]]. Typically, the [[component>>doc:sdmx:Glossary.Component.WebHome]] will also take its identity from this (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%), although it is possible for a (data) structure-specific identity to be created. Regardless of whether the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) identity is used or a local identifier is assigned, the identifier of a [[component>>doc:sdmx:Glossary.Component.WebHome]] must be unique within the scope of all data structure [[components>>doc:sdmx:Glossary.Component.WebHome]].
68 68  
69 -A [[component>>doc:sdmx:Glossary.Component.WebHome]] can also inherit the [[representation>>doc:sdmx:Glossary.Representation.WebHome]] of the (% style="color:#e74c3c" %)concept(%%) from which it takes its semantic, or it can provide a data structure specific [[representation>>doc:sdmx:Glossary.Representation.WebHome]] for the (% style="color:#e74c3c" %)concept(%%). This [[representation>>doc:sdmx:Glossary.Representation.WebHome]] can be either [[code>>doc:sdmx:Glossary.Code.WebHome]] or un-coded, although some [[component>>doc:sdmx:Glossary.Component.WebHome]] types have more restrictive [[representations>>doc:sdmx:Glossary.Representation.WebHome]].
69 +A [[component>>doc:sdmx:Glossary.Component.WebHome]] can also inherit the [[representation>>doc:sdmx:Glossary.Representation.WebHome]] of the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) from which it takes its semantic, or it can provide a data structure specific [[representation>>doc:sdmx:Glossary.Representation.WebHome]] for the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%). This [[representation>>doc:sdmx:Glossary.Representation.WebHome]] can be either [[code>>doc:sdmx:Glossary.Code.WebHome]] or un-coded, although some [[component>>doc:sdmx:Glossary.Component.WebHome]] types have more restrictive representations.
70 70  
71 -A data structure [[component>>doc:sdmx:Glossary.Component.WebHome]] can also reference a collection of (% style="color:#e74c3c" %)concepts(%%) for the purpose of identifying specific roles that the (% style="color:#e74c3c" %)concept(%%) serves in the data structure. For example, a user community may define a collection of (% style="color:#e74c3c" %)concepts(%%) which are intended to note special roles for data structure [[components>>doc:sdmx:Glossary.Component.WebHome]] (e.g. the [[unit of measure>>doc:sdmx:Glossary.Unit of measure.WebHome]]). A [[component>>doc:sdmx:Glossary.Component.WebHome]] can reference any of these (% style="color:#e74c3c" %)concepts(%%) in order to specify that the role identified by the (% style="color:#e74c3c" %)concept(%%) is being served by the [[component>>doc:sdmx:Glossary.Component.WebHome]]. Note that a [[component>>doc:sdmx:Glossary.Component.WebHome]] is implied to serve the role of the (% style="color:#e74c3c" %)concept(%%) from which it takes its identity, therefore it does not need to reference this (% style="color:#e74c3c" %)concept(%%) again.
71 +A data structure [[component>>doc:sdmx:Glossary.Component.WebHome]] can also reference a collection of (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) for the purpose of identifying specific roles that the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) serves in the data structure. For example, a user community may define a collection of (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) which are intended to note special roles for data structure [[components>>doc:sdmx:Glossary.Component.WebHome]] (e.g. the [[unit of measure>>doc:sdmx:Glossary.Unit of measure.WebHome]]). A [[component>>doc:sdmx:Glossary.Component.WebHome]] can reference any of these (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) in order to specify that the role identified by the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) is being served by the [[component>>doc:sdmx:Glossary.Component.WebHome]]. Note that a [[component>>doc:sdmx:Glossary.Component.WebHome]] is implied to serve the role of the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) from which it takes its identity, therefore it does not need to reference this (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) again.
72 72  
73 73  ===== //4.3.1.1.1 Primary Measure// =====
74 74  
75 -Every data structure must define a primary [[measure>>doc:sdmx:Glossary.Measure.WebHome]]. This [[component>>doc:sdmx:Glossary.Component.WebHome]] always has a fixed identifier (OBS_VALUE), and its purpose is to given a consistent data structure [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] where the observed value can be found. This makes the processing of data messages much more consistent, as the measured value is always readily found. The primary [[measure>>doc:sdmx:Glossary.Measure.WebHome]] can define a [[representation>>doc:sdmx:Glossary.Representation.WebHome]], or it can inherit the [[representation>>doc:sdmx:Glossary.Representation.WebHome]] from the (% style="color:#e74c3c" %)concept(%%) from which it takes its semantic (this (% style="color:#e74c3c" %)concept(%%) can have, but need not have, and Id of OBS_VALUE).
75 +Every data structure must define a primary [[measure>>doc:sdmx:Glossary.Measure.WebHome]]. This [[component>>doc:sdmx:Glossary.Component.WebHome]] always has a fixed identifier (OBS_VALUE), and its purpose is to given a consistent data structure [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] where the observed value can be found. This makes the processing of data messages much more consistent, as the measured value is always readily found. The primary [[measure>>doc:sdmx:Glossary.Measure.WebHome]] can define a [[representation>>doc:sdmx:Glossary.Representation.WebHome]], or it can inherit the [[representation>>doc:sdmx:Glossary.Representation.WebHome]] from the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) from which it takes its semantic (this (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) can have, but need not have, and Id of OBS_VALUE).
76 76  
77 77  ===== //4.3.1.1.2 Dimensions// =====
78 78  
79 -The identification of the phenomenon being measured is achieved through the [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] descriptor. Any given data structure must have at least one [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]]. The [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] (in some models these are known as “classificatory variables”) reference (% style="color:#e74c3c" %)concepts(%%) which define identifying properties of the phenomenon being measured. In a [[dataset>>doc:sdmx:Glossary.Data set.WebHome]], each [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is given a value. This set of [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] values is often referred to as a key. In any given [[data set>>doc:sdmx:Glossary.Data set.WebHome]], there can only be one observed value and collection of data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] (metadata) values per key. Therefore, a key uniquely identities any observed phenomenon.
79 +The identification of the phenomenon being measured is achieved through the [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] descriptor. Any given data structure must have at least one [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]]. The [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] (in some models these are known as “classificatory variables”) reference (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) which define identifying properties of the phenomenon being measured. In a [[dataset>>doc:sdmx:Glossary.Data set.WebHome]], each [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is given a value. This set of [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] values is often referred to as a key. In any given [[data set>>doc:sdmx:Glossary.Data set.WebHome]], there can only be one observed value and collection of data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] (metadata) values per key. Therefore, a key uniquely identities any observed phenomenon.
80 80  
81 81  There are two specialized [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] that can be defined only once for a data structure. The first is the time [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]]. The time [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] represents the point in time at which the phenomenon was observed. If the explicit time [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is used, then it must use any or all of the allowable time [[representations>>doc:sdmx:Glossary.Representation.WebHome]] defined in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]]. These [[representations>>doc:sdmx:Glossary.Representation.WebHome]] are:
82 82  
... ... @@ -91,11 +91,11 @@
91 91  
92 92  The other specialized [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]]. A [[measure>>doc:sdmx:Glossary.Measure.WebHome]] can refer to a collection of properties for which phenomena is being measured for an entity classified by the other [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] of the data structure (e.g. the demographic [[measures>>doc:sdmx:Glossary.Measure.WebHome]] in the demography data structure). A [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] might also refer to the different means in which a phenomenum may be measured (e.g. weight, volume, and price for a commodity).
93 93  
94 -A [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] must always take its [[representation>>doc:sdmx:Glossary.Representation.WebHome]] from a [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]]. This [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] must define a collection of (% style="color:#e74c3c" %)concepts(%%) which define the value set of the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)concept(%%). An example of this can be seen in the Eurostat Demography data structure. For example, the demography [[measures>>doc:sdmx:Glossary.Measure.WebHome]] [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] (DEMO_MEASURES) contains only (% style="color:#e74c3c" %)concepts(%%) which define demographic measurements.
94 +A [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] must always take its [[representation>>doc:sdmx:Glossary.Representation.WebHome]] from a [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]]. This [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] must define a collection of (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) which define the value set of the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%). An example of this can be seen in the Eurostat Demography data structure. For example, the demography [[measures>>doc:sdmx:Glossary.Measure.WebHome]] [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] (DEMO_MEASURES) contains only (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) which define demographic measurements.
95 95  
96 -An advantage of defining a [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is that it also allows for a more explicit definition of the [[representation>>doc:sdmx:Glossary.Representation.WebHome]] of the observed value for a given [[measure>>doc:sdmx:Glossary.Measure.WebHome]]. This is achieved by defining core [[representations>>doc:sdmx:Glossary.Representation.WebHome]] for the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)concepts(%%). Note that it is necessary that the primary [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[representation>>doc:sdmx:Glossary.Representation.WebHome]] in this case be a superset of all possible [[representations>>doc:sdmx:Glossary.Representation.WebHome]] of the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] (% style="color:#e74c3c" %)concepts(%%). This is demonstrated in the Eurostat Demography data structure. An analysis of the demography [[measures>>doc:sdmx:Glossary.Measure.WebHome]] [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] shows that the number of deaths in a year is measured as an integer, whereas the life expectancy is measured as a [[decimal>>doc:sdmx:Glossary.Decimals.WebHome]] with only one [[decimal>>doc:sdmx:Glossary.Decimals.WebHome]] digit. This [[representation>>doc:sdmx:Glossary.Representation.WebHome]] is carried over to the structure specific schema when the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is used as the observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]], and explicit [[measures>>doc:sdmx:Glossary.Measure.WebHome]] are used. This can be seen in the data structure specific schema for the demography data structure.
96 +An advantage of defining a [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is that it also allows for a more explicit definition of the [[representation>>doc:sdmx:Glossary.Representation.WebHome]] of the observed value for a given [[measure>>doc:sdmx:Glossary.Measure.WebHome]]. This is achieved by defining core [[representations>>doc:sdmx:Glossary.Representation.WebHome]] for the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%). Note that it is necessary that the primary [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[representation>>doc:sdmx:Glossary.Representation.WebHome]] in this case be a superset of all possible [[representations>>doc:sdmx:Glossary.Representation.WebHome]] of the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%). This is demonstrated in the Eurostat Demography data structure. An analysis of the demography [[measures>>doc:sdmx:Glossary.Measure.WebHome]] [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] shows that the number of deaths in a year is measured as an integer, whereas the life expectancy is measured as a [[decimal>>doc:sdmx:Glossary.Decimals.WebHome]] with only one [[decimal>>doc:sdmx:Glossary.Decimals.WebHome]] digit. This [[representation>>doc:sdmx:Glossary.Representation.WebHome]] is carried over to the structure specific schema when the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is used as the observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]], and explicit [[measures>>doc:sdmx:Glossary.Measure.WebHome]] are used. This can be seen in the data structure specific schema for the demography data structure.
97 97  
98 -By defining a [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]], a user of the data reported against the data structure will be able to better understand the relationships that exist between the observed values. Another advantage of using a [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is that the data structure can be specific to the [[representation>>doc:sdmx:Glossary.Representation.WebHome]] of observed value because it relates to a specific [[measure>>doc:sdmx:Glossary.Measure.WebHome]] (i.e. it is a (% style="color:#e74c3c" %)concept(%%) in a the [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] referenced from the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]]).
98 +By defining a [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]], a user of the data reported against the data structure will be able to better understand the relationships that exist between the observed values. Another advantage of using a [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is that the data structure can be specific to the [[representation>>doc:sdmx:Glossary.Representation.WebHome]] of observed value because it relates to a specific [[measure>>doc:sdmx:Glossary.Measure.WebHome]] (i.e. it is a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) in a the [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] referenced from the [[measure>>doc:sdmx:Glossary.Measure.WebHome]] [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]]).
99 99  
100 100  ===== //4.3.1.1.3 Attributes// =====
101 101  
... ... @@ -109,10 +109,12 @@
109 109  
110 110  === 4.3.2 Data Sets ===
111 111  
112 -Every [[data set>>doc:sdmx:Glossary.Data set.WebHome]] in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] must conform to a [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]]. As described above, the [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] organizes (% style="color:#e74c3c" %)concept(%%) definitions into various [[components>>doc:sdmx:Glossary.Component.WebHome]] which identify and supplement the data. When processing data, it is critical to be able to retrieved and fully understand the [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]]. A clear understanding the data structure is dependent on well defined (% style="color:#e74c3c" %)concepts(%%). Therefore, useful data starts with well defined (% style="color:#e74c3c" %)concepts(%%). Ultimately, understanding is dependent upon understanding the (% style="color:#e74c3c" %)concepts(%%) which define what is being measured.
112 +Every [[data set>>doc:sdmx:Glossary.Data set.WebHome]] in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] must conform to a [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]]. As described above, the [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] organizes (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) definitions into various [[components>>doc:sdmx:Glossary.Component.WebHome]] which identify and supplement the data. When processing data, it is critical to be able to retrieved and fully understand the [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]]. A clear understanding the data structure is dependent on well defined (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%). Therefore, useful data starts with well defined (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%). Ultimately, understanding is dependent upon understanding the (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) which define what is being measured.
113 113  
114 -In terms of processing data, the [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] provides enough information so that the data can be validated and understood. However, the data structure does not dictate the exact orientation of the data. The orientation of the data is defined by the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] itself. However, [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] only allows for two basic orientations:
114 +In terms of processing data, the [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] provides enough information so that the data can be validated and understood. However, the data structure does not dictate the exact orientation of the data.
115 115  
116 +The orientation of the data is defined by the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] itself. However, [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] only allows for two basic orientations:
117 +
116 116  1. A flat list of observations in which the full key is provided for each observed value.
117 117  1. A collection of observations in series where all but one [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] has the same value and each observation is distinguished by the other [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (e.g. a time series in which a series has a key and each observation in the series has a distinct time value). This [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] if known as the observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]].
118 118  
... ... @@ -120,9 +120,9 @@
120 120  
121 121  [[Data sets>>doc:sdmx:Glossary.Data set.WebHome]] note the orientation by defining the observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]]. In the case of the flat orientation, the observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is actually all [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]]. In the second case, it is a specific [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] from the data structure (this must be the same [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] for the entire [[data set>>doc:sdmx:Glossary.Data set.WebHome]]).
122 122  
123 -This observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] dictates where [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] should be present, based on the [[attribute relationships>>doc:sdmx:Glossary.Attribute relationship.WebHome]] defined in the data structure. Any [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] which has a relationship with the observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (i.e. the [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is a part of a group or a set of [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] with which the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has an “[[attribute relationship>>doc:sdmx:Glossary.Attribute relationship.WebHome]]”) must exist at the observation (% style="color:#e74c3c" %)level(%%). This also holds true if an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has a relationship with the primary [[measure>>doc:sdmx:Glossary.Measure.WebHome]]. If an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has a relationship with no data structure [[components>>doc:sdmx:Glossary.Component.WebHome]], then only one value is provided per [[data set>>doc:sdmx:Glossary.Data set.WebHome]] (i.e. the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] exists at the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] (% style="color:#e74c3c" %)level(%%)).
125 +This observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] dictates where [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] should be present, based on the [[attribute relationships>>doc:sdmx:Glossary.Attribute relationship.WebHome]] defined in the data structure. Any [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] which has a relationship with the observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (i.e. the [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is a part of a group or a set of [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] with which the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has an “[[attribute relationship>>doc:sdmx:Glossary.Attribute relationship.WebHome]]”) must exist at the observation level. This also holds true if an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has a relationship with the primary [[measure>>doc:sdmx:Glossary.Measure.WebHome]]. If an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has a relationship with no data structure [[components>>doc:sdmx:Glossary.Component.WebHome]], then only one value is provided per [[data set>>doc:sdmx:Glossary.Data set.WebHome]] (i.e. the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] exists at the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] level).
124 124  
125 -If an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has a relationship with a group, or specifies a group for attachment, the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] will be communicated at the group (% style="color:#e74c3c" %)level(%%). In all other cases the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] will exist at the series (% style="color:#e74c3c" %)level(%%).
127 +If an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has a relationship with a group, or specifies a group for attachment, the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] will be communicated at the group (% style="color:#e74c3c" %)level(%%). In all other cases the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] will exist at the series level.
126 126  
127 127  Data can be expressed in one of four formats;
128 128  
... ... @@ -131,9 +131,9 @@
131 131  1. Structure specific
132 132  1. Time series structure specific
133 133  
134 -The time series formats are actually equivalent in content of their more generalized counterparts when they specify the time [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] at the observation (% style="color:#e74c3c" %)level(%%). Therefore, with the exception of the root element name, a generic [[data set>>doc:sdmx:Glossary.Data set.WebHome]] with time at the observation (% style="color:#e74c3c" %)level(%%) will be the same as a time series generic [[data set>>doc:sdmx:Glossary.Data set.WebHome]]. The difference in these formats is that the time series only allows for time to be the [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] at the observation (% style="color:#e74c3c" %)level(%%).
136 +The time series formats are actually equivalent in content of their more generalized counterparts when they specify the time [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] at the observation level. Therefore, with the exception of the root element name, a generic [[data set>>doc:sdmx:Glossary.Data set.WebHome]] with time at the observation level will be the same as a time series generic [[data set>>doc:sdmx:Glossary.Data set.WebHome]]. The difference in these formats is that the time series only allows for time to be the [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] at the observation level.
135 135  
136 -Note that regardless of the organisation or the format, the data expressed is always the same. This can be seen by examining the various data messages for the ECB Exchange Rates data. Regardless of the organisation or the format, the data expressed is always the same. In fact, this even holds true for the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] values even though they are expressed at different (% style="color:#e74c3c" %)levels(%%) depending on their relationships. This serves to show that it is critical that the [[attribute relationship>>doc:sdmx:Glossary.Attribute relationship.WebHome]] be specified correctly, otherwise the correct value cannot be expressed in a data message.
138 +Note that regardless of the organisation or the format, the data expressed is always the same. This can be seen by examining the various data messages for the ECB Exchange Rates data. Regardless of the organisation or the format, the data expressed is always the same. In fact, this even holds true for the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] values even though they are expressed at different levels depending on their relationships. This serves to show that it is critical that the [[attribute relationship>>doc:sdmx:Glossary.Attribute relationship.WebHome]] be specified correctly, otherwise the correct value cannot be expressed in a data message.
137 137  
138 138  == 4.4 Metadata ==
139 139  
... ... @@ -142,9 +142,9 @@
142 142  1. Structured and validated
143 143  1. Late bound to the [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] or data to which it applies
144 144  
145 -Consider (% style="color:#e74c3c" %)contact(%%) information for a [[data set>>doc:sdmx:Glossary.Data set.WebHome]]. This information could be contained is a single data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] which could be carried in the data message. However, the nature of data [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] is that they have no sub structure. Therefore, there would be no means of separating the name of the (% style="color:#e74c3c" %)contact(%%) person from the [[phone number>>doc:sdmx:Glossary.Contact phone number.WebHome]] (outside of creating many [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] to hold this information). In addition, this (% style="color:#e74c3c" %)contact(%%) information is probably subject to change. It would not make much sense to update the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] when the data itself is unchanged simply to specify a new (% style="color:#e74c3c" %)contact(%%).
147 +Consider [[contact>>doc:Glossary.Contact.WebHome]] information for a [[data set>>doc:sdmx:Glossary.Data set.WebHome]]. This information could be contained is a single data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] which could be carried in the data message. However, the nature of data [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] is that they have no sub structure. Therefore, there would be no means of separating the name of the contact person from the [[phone number>>doc:sdmx:Glossary.Contact phone number.WebHome]] (outside of creating many [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] to hold this information). In addition, this [[contact>>doc:Glossary.Contact.WebHome]] information is probably subject to change. It would not make much sense to update the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] when the data itself is unchanged simply to specify a new [[contact>>doc:Glossary.Contact.WebHome]].
146 146  
147 -This is where [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] is useful. The structure of (% style="color:#e74c3c" %)contact(%%) information can be clearly specified, and attached dynamically to the data. This same dynamic applies to [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] as well. Although all [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] [[components>>doc:sdmx:Glossary.Component.WebHome]] contain [[annotations>>doc:sdmx:Glossary.Annotation.WebHome]], these often do not allow for the structure that is necessary to communicate the desired information.
149 +This is where [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] is useful. The structure of [[contact>>doc:Glossary.Contact.WebHome]] information can be clearly specified, and attached dynamically to the data. This same dynamic applies to [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] as well. Although all [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] [[components>>doc:sdmx:Glossary.Component.WebHome]] contain [[annotations>>doc:sdmx:Glossary.Annotation.WebHome]], these often do not allow for the structure that is necessary to communicate the desired information.
148 148  
149 149  A major use case for [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] is in the support of quality frameworks, where the metadata are not concerned with a [[data set>>doc:sdmx:Glossary.Data set.WebHome]] but with the processes, regulations, and policies of data collection and dissemination.
150 150  
... ... @@ -184,7 +184,7 @@
184 184  
185 185  ===== //4.4.1.1.4 Constraint Content Target// =====
186 186  
187 -The (% style="color:#e74c3c" %)constraint(%%) content target is used to attach metadata to data by referencing an attachment (% style="color:#e74c3c" %)constraint(%%). This attachment (% style="color:#e74c3c" %)constraint(%%) in turn defines the [[data set>>doc:sdmx:Glossary.Data set.WebHome]](s) and keys to which the metadata applies. This is equivalent to using the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] or identifiable object target along with the key descriptor values target. The difference is that the attachment (% style="color:#e74c3c" %)constraint(%%) allows the target set to be defined once, and be reused by multiple reports, whereas the former method would require that the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] (or equivalent data structure, [[dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], or [[provision agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]]) reference and key descriptor value set be repeated for each report. Only one (% style="color:#e74c3c" %)constraint(%%) content target can occur within a metadata target.
189 +The [[constraint>>doc:Glossary.Constraint.WebHome]] content target is used to attach metadata to data by referencing an attachment [[constraint>>doc:Glossary.Constraint.WebHome]]. This attachment [[constraint>>doc:Glossary.Constraint.WebHome]] turn defines the [[data set>>doc:sdmx:Glossary.Data set.WebHome]](s) and keys to which the metadata applies. This is equivalent to using the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] or identifiable object target along with the key descriptor values target. The difference is that the attachment [[constraint>>doc:Glossary.Constraint.WebHome]] allows the target set to be defined once, and be reused by multiple reports, whereas the former method would require that the [[data set>>doc:sdmx:Glossary.Data set.WebHome]] (or equivalent data structure, [[dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], or [[provision agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]]) reference and key descriptor value set be repeated for each report. Only one [[constraint>>doc:Glossary.Constraint.WebHome]] content target can occur within a metadata target.
188 188  
189 189  ===== //4.4.1.1.5 Report Period Target// =====
190 190  
... ... @@ -205,11 +205,11 @@
205 205  
206 206  ===== //4.4.1.2.1 Metadata Attribute// =====
207 207  
208 -A metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is [[component>>doc:sdmx:Glossary.Component.WebHome]] of the content of a metadata report. Similar to a data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] in a data structure, the metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] takes its semantic from a (% style="color:#e74c3c" %)concept(%%). This (% style="color:#e74c3c" %)concept(%%) serves to define the meaning of the information contained in the report. As with data structure [[components>>doc:sdmx:Glossary.Component.WebHome]], it is important to make use of common (% style="color:#e74c3c" %)concepts(%%) whenever possible, as this makes the metadata relatable to other metadata reports.
210 +A metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is [[component>>doc:sdmx:Glossary.Component.WebHome]] of the content of a metadata report. Similar to a data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] in a data structure, the metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] takes its semantic from a (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%). This [[concept>>doc:sdmx:Glossary.Concept.WebHome]] serves to define the meaning of the information contained in the report. As with data structure [[components>>doc:sdmx:Glossary.Component.WebHome]], it is important to make use of common (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) whenever possible, as this makes the metadata relatable to other metadata reports.
209 209  
210 -The content of a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] can be a value and/or other metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]. The value of a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] can serve a number of purposes. First, as with a data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] it can be an enumerated value from a [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[code list>>doc:sdmx:Glossary.Code list.WebHome]]. It can also be a noncoded value of any given data type. Where the metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] value differs from that of a data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is that if the value is textual, it can be represented in parallel language values, and if necessary be structured using XHTML. It is not necessary that a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has a value, as it might only serve to contain other metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] for the purpose of organising metadata reports (in which case the metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is designated as “isPresentational” indicating that no value is expected to be reported for the metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] in a report).l.
212 +The content of a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] can be a value and/or other metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]. The value of a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] can serve a number of purposes. First, as with a data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] it can be an enumerated value from a [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[code list>>doc:sdmx:Glossary.Code list.WebHome]]. It can also be a noncoded value of any given data type. Where the metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] value differs from that of a data [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is that if the value is textual, it can be represented in parallel language values, and if necessary be structured using XHTML. It is not necessary that a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] has a value, as it might only serve to contain other metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] for the purpose of organising metadata reports (in which case the metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is designated as “isPresentational” indicating that no value is expected to be reported for the metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] in a report).
211 211  
212 -Metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] are not reusable across various (% style="color:#e74c3c" %)levels(%%) of a report structure. If an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is intended to occur at multiple (% style="color:#e74c3c" %)levels(%%), it must be redefined at each (% style="color:#e74c3c" %)level(%%). However, the identification of a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is only required to be unique within the scope within which it is defined. Therefore, if the intention is to reuse a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] at different (% style="color:#e74c3c" %)levels(%%), it is recommended that the same identification be used to convey this intention. It should also be noted that within a scope, a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] can have cardinality (minimum and maximum number of occurrences). This allows metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] to be repeated at various (% style="color:#e74c3c" %)levels(%%), as well as giving the report structure the ability to enforce content requirements.
214 +Metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] are not reusable across various levels of a report structure. If an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is intended to occur at multiple levels, it must be redefined at each level. However, the identification of a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is only required to be unique within the scope within which it is defined. Therefore, if the intention is to reuse a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] at different levels, it is recommended that the same identification be used to convey this intention. It should also be noted that within a scope, a metadata [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] can have cardinality (minimum and maximum number of occurrences). This allows metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] to be repeated at various levels, as well as giving the report structure the ability to enforce content requirements.
213 213  
214 214  === 4.4.2 Metadata Sets ===
215 215  
... ... @@ -217,7 +217,7 @@
217 217  
218 218  The manner in which a metadata report is related to an object is through the specification of its target. The metadata structure defines the possible types of targets for a given report structure, and an instance of a report uses one of these target types to identify the actual target of the metadata. The target is essentially a collection of references to data or [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] and possibly a period to which the report applies. It is assumed that any system processing metadata reports will be able to resolve these references, or perhaps more appropriately, any system working with data or [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] will be able to process the related metadata reports.
219 219  
220 -The actual content of the report is always contained in an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] set. This [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] set is the collection of metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] for which values are provided. As with data, the key to a useful metadata report is understanding what is being reported. This comes down to effective (% style="color:#e74c3c" %)concept(%%) usage. The content of any report is essentially made up of values reported against (% style="color:#e74c3c" %)concepts(%%). In order for systems to understand the meaning of the metadata, they must understand the (% style="color:#e74c3c" %)concepts(%%).
222 +The actual content of the report is always contained in an [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] set. This [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] set is the collection of metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] for which values are provided. As with data, the key to a useful metadata report is understanding what is being reported. This comes down to effective (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) usage. The content of any report is essentially made up of values reported against (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%). In order for systems to understand the meaning of the metadata, they must understand the (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%).
221 221  
222 222  With the [[metadata structure definition>>doc:sdmx:Glossary.Metadata structure definition.WebHome]], the content of any report can be evaluated for completeness and validity. From the metadata structure, one can determine if all necessary metadata [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] are present for a given report structure and if the values assigned to them are allowable based on the [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] definition.
223 223