Skip to Content

Wiki source code of 9 Concept Roles

Version 13.1 by Helena on 2025/07/20 12:45
Show last authors
1 {{box title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 == 9.1 Overview ==
6
7 The [[DSD>>doc:Glossary.Data structure definition.WebHome]] [[Components>>doc:Glossary.Component.WebHome]] of [[Dimension>>doc:Glossary.Dimension.WebHome]] and [[Attribute>>doc:Glossary.Attribute.WebHome]] can play a specific role in the [[DSD>>doc:Glossary.Data structure definition.WebHome]] and it is important to some applications that this role is specified. For instance, the following roles are some examples:
8
9 * **Frequency **– in a [[data set>>doc:Glossary.Data set.WebHome]] the content of this [[Component>>doc:Glossary.Component.WebHome]] contains information on the frequency of the observation values.
10 * **Geography** – in a [[data set>>doc:Glossary.Data set.WebHome]] the content of this [[Component>>doc:Glossary.Component.WebHome]] contains information on the geographic location of the observation values.
11
12 == 9.2 Information Model ==
13
14 The Information Model for this is shown below:
15
16 [[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_2a51ef88.jpg||height="296" width="557"]]
17
18 (% class="wikigeneratedid" id="HFigure19:InformationModelExtractforConceptRole" %)
19 **Figure 19: Information Model Extract for Concept Role**
20
21 It is possible to specify zero or more (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) roles for a [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]], [[Measure>>doc:sdmx:Glossary.Measure.WebHome]] and Data [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]]. The Time [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] has explicitly defined roles and cannot be further specified with additional (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) roles.
22
23 == 9.3 Technical Mechanism ==
24
25 The mechanism for maintain and using (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) roles is as follows:
26
27 1. A standard [[Concept Scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] maintained in the [[Global Registry>>doc:sdmx:Glossary.Global registry.WebHome]], with the following identification: [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]]:CONCEPT_ROLES(1.0.0), shall include the default roles, specified by the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] SWG (as detailed in 9.5).
28 1. Any recognized Agency can have a [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] that contains (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) that identify (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) roles. Indeed, from a technical perspective any agency can have more than one of these schemes, though this is not recommended.
29 1. The [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] that contains the "role" (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) can contain (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) that do not play a role.
30 1. There is no explicit indication on the (% style="color:#e74c3c" %)[[Concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) whether it is a 'role' (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%).
31 1. Therefore, any (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) in any [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] is capable of being a 'role' (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%).
32 1. It is the responsibility of Agencies to ensure their community knows which (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) in which [[concept schemes>>doc:sdmx:Glossary.Concept scheme.WebHome]] play a 'role' and the significance and interpretation of this role. In other words, such (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) must be known by applications, there is no technical mechanism that can inform an application on how to process such a 'role'.
33 1. If the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) referenced in the (% style="color:#e74c3c" %)[[Concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) Identity in a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] [[component>>doc:sdmx:Glossary.Component.WebHome]] ([[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]], [[Measure>>doc:sdmx:Glossary.Measure.WebHome]] [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]], [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]]) is contained in the [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] containing (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) roles then the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] [[component>>doc:sdmx:Glossary.Component.WebHome]] could play the role implied by the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%), if this is understood by the processing application.
34 1. If the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) referenced in the (% style="color:#e74c3c" %)[[Concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) Identity in a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] [[component>>doc:sdmx:Glossary.Component.WebHome]] ([[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]], [[Measure>>doc:sdmx:Glossary.Measure.WebHome]] [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]], [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]]) is not contained in the [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] containing (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) roles, and the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] [[component>>doc:sdmx:Glossary.Component.WebHome]] is playing a role, then the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) role is identified by the (% style="color:#e74c3c" %)[[Concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) Role in the schema.
35
36 == 9.4 SDMX-ML Examples in a DSD ==
37
38 The standard roles [[Concept Scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]], is still a normal [[Concept Scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]], thus it may be used also for the (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) identity of a [[Component>>doc:sdmx:Glossary.Component.WebHome]], e.g., the 'FREQ'
39
40 :
41
42 [[image:1747386659499-933.png]]
43
44 Given this is the standard roles [[Concept Scheme>>doc:Glossary.Concept scheme.WebHome]], any application should interpret the above [[Dimension>>doc:Glossary.Dimension.WebHome]] to have the role of Frequency.
45
46 Using a [[Concept Scheme>>doc:Glossary.Concept scheme.WebHome]] that is not the standard roles [[Concept Scheme>>doc:Glossary.Concept scheme.WebHome]] where it is required to assign a role using the standard roles [[Concept Scheme>>doc:Glossary.Concept scheme.WebHome]]. Again, FREQ is chosen as the example.
47
48 [[image:1747386677366-237.png]]
49
50 This explicitly states that this [[Dimension>>doc:Glossary.Dimension.WebHome]] is playing a role identified by the FREQ (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) in the standard roles [[Concept Scheme>>doc:Glossary.Concept scheme.WebHome]]. Again, the application must interpret this as a Frequency role.
51
52 In other cases where a role from a non-standard roles [[Concept Scheme>>doc:Glossary.Concept scheme.WebHome]] is used, then the application has to know how to interpret the provided roles, e.g., like in the case below:
53
54 [[image:1747386694309-599.png]]
55
56 This is all that is required for interoperability within a community. Having a standard roles [[Concept Scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]], maintained by the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] SWG, allows the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] community to have a common understanding of the roles, while also being able to extend the roles in bilateral (or multilateral) agreements, by maintaining their own roles [[Concept Scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]]. This will then ensure there is interoperability between systems that understand the use of these (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%).
57
58 Note that each of the [[Components>>doc:sdmx:Glossary.Component.WebHome]] (Data [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]], [[Measure>>doc:sdmx:Glossary.Measure.WebHome]], [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]], Time [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]) has a mandatory identity association ((% style="color:#e74c3c" %)[[Concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) Identity) and if this (% style="color:#e74c3c" %)[[Concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) also identifies the role then it must be interpreted accordingly.
59
60 In order for these roles to be extensible and also to enable user communities to maintain community-specific roles, the roles are maintained in a controlled vocabulary which is implemented in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] as (% style="color:#e74c3c" %)[[Concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) in a [[Concept Scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]]. The [[Component>>doc:sdmx:Glossary.Component.WebHome]] optionally references this (% style="color:#e74c3c" %)[[Concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) if it is required to declare the role explicitly. Note that a [[Component>>doc:sdmx:Glossary.Component.WebHome]] can play more than one role and therefore multiple "role" (% style="color:#e74c3c" %)[[concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) can be referenced.
61
62 == 9.5 SDMX standard roles Concept Scheme ==
63
64 As of [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] 3.0, there is a predefined [[Concept Scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]], with a set of (% style="color:#e74c3c" %)[[Concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%) that are considered the standard roles for [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]]. Beyond that, a user is free to add other roles, using custom [[Concept Schemes>>doc:sdmx:Glossary.Concept scheme.WebHome]]. This predefined [[Concept Scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] is the result of the SWG guidelines for (% style="color:#e74c3c" %)[[Concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) Roles, plus that for [[Measure>>doc:sdmx:Glossary.Measure.WebHome]], and includes the following (% style="color:#e74c3c" %)[[Concepts>>doc:sdmx:Glossary.Concept.WebHome]](%%):
65
66 (% style="width:1183.29px" %)
67 |COMMENT|[[Comment>>doc:Glossary.Comment.WebHome]]|(% style="width:723px" %)Descriptive text which can be attached to data or metadata.
68 |ENTITY|Entity|(% style="width:723px" %)Describes the subject of the [[data set>>doc:Glossary.Data set.WebHome]] (e.g., a country).
69 |FLAG|Flag|(% style="width:723px" %)Coded [[attribute>>doc:Glossary.Attribute.WebHome]] in a [[data set>>doc:Glossary.Data set.WebHome]] that represents qualitative information for the cell or partial key (e.g. series) value.
70 |FREQ|Frequency|(% style="width:723px" %)Time interval at which the source data are collected.
71 |GEO|Geographical|(% style="width:723px" %)Geographic area to which the measured statistical phenomenon relates.
72 |OPERATION|Statistical operation|(% style="width:723px" %)Signifies statistical operations have been done on the observations.
73 |VARIABLE|Variable|(% style="width:723px" %)Characteristic of a unit being observed that may assume more than one of a set of values to which a numerical [[measure>>doc:Glossary.Measure.WebHome]] or a [[category>>doc:Glossary.Category.WebHome]] from a classification can be assigned.
74 |MEASURE|[[Measure>>doc:Glossary.Measure.WebHome]]|(% style="width:723px" %)Used for emulating the functionality of the deprecated MeasureDimension.
75 |GEO_FEATU RE_SET|Geographical Feature Set|(% style="width:723px" %)Georeferencing information to describe the location or the shape of a [[statistical unit>>doc:Glossary.Statistical unit.WebHome]], recognizable object or geographical area.
76 |PRIMARY|Primary [[Measure>>doc:Glossary.Measure.WebHome]]|(% style="width:723px" %)Used for backwards compatibility with [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 2.1 and back, or when the “Primary [[Measure>>doc:Glossary.Measure.WebHome]]” (% style="color:#e74c3c" %)[[concept>>doc:sdmx:Glossary.Concept.WebHome]](%%) is needed.