Changes for page 9 Structure Set and Mappings

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

From 4.1 to 3.1

From version 3.1

edited by Helena
on 2025/05/19 23:53

Change comment: There is no comment for this version

To version 1.1

edited by Helena
on 2025/05/19 23:53

Change comment: Changed document syntax from [XWiki 2.1] to [xwiki/2.1].

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 0 added, 1 removed)
- SDMX_2-1_SECTION_2_InformationModel_2020-07_f7e5c308.png

Details

Page properties

Title

...	...	@@ -1,1 +1,0 @@
1		-9 Structure Set and Mappings

Content

@@ -1,400 +1,0 @@
--= {{id name="_Toc371045"/}}9 Structure Set and Mappings =
--
--== {{id name="_Toc371046"/}}9.1 Scope ==
--
--A ,,StructureSet,, allows components in one structure to be mapped to components in another structure of the same type. In this context the term “structure” is used loosely to 1786 include types of //ItemScheme//, types of //Structure//, and types of //StructureUsage//. The allowable structures that can be mapped, and the components that can be mapped within 1788 these structures are:
--
--:
--
--(((
--|**Structure Type**|**Component type**
--|Codelist|Code
--|Category Scheme|Category
--|Concept Scheme|Concept
--|Organisation Scheme|(((
--Organisation – this allows mapping any type of Organisation to any type of Organisation (e.g. a Data Provider to an
--
--Organisation Unit)
--)))
--|Hierarchical Codelist|Hierachical Code to Code or vice-versa
--|Data Structure Definition|(((
--Dimension, Measure Dimension, Time Dimension. Data Attribute, Primary
--
--Measure
--)))
--|Metadata Structure Definition|Target Object, Metadata Attribute
--|Dataflow Definition|None
--|Metadataflow Definition|None
--)))
--
--The ,,StructureSet,, can contain one or more “maps” and can define related structures (via the association +relatedStructure) which group related DataStructureDefinitions, MetadataStructureDefinitions, DataflowDefinintions,
--
--MetadataflowDefinintions.
--
--== {{id name="_Toc371047"/}}9.2 Structure Set ==
--
--=== {{id name="_Toc371048"/}}9.2.1 Class Diagram – Inheritance ===
--
--**Figure 32: Inheritance Class Diagram of the Structure Set**
--
--=== {{id name="_Toc371049"/}}9.2.2 Class Diagram – Relationship ===
--
--**Figure 33: Relationship Class diagram of the Structure Set**
--
--=== {{id name="_Toc371050"/}}9.2.3 Explanation of the Diagram ===
--
--==== 9.2.3.1 Narrative ====
--
--The StructureSet is a //MaintainableArtefact//. It can contain:
--
--1. A set of references to concrete sub-classes of //Structure// and //StructureUsage// (DataStructureDefinition, MetadataStructureDefinition, DataflowDefinition or MetadataflowDefinition) to indicate that a relationship exists between them. For example there may be a group of DataStructureDefinition which, together, form the definition of a cube, each
--
--DataStructureDefinition defining a part of the cube.
--
--1. A set of StructureMaps which define which components of one structure are equivalent to those in another in a ComponentMap.
--1. A set of ItemSchemeMaps which define the mapping between two concrete classes of ItemScheme, and the mapping of the Items in these schemes, such as the mapping of Codes in two Codelists..
--1. A set of HybridCodelistMaps which define the mapping between a Codelist and a HierachicalCodelist.
--
--The StructureMap references two //Structure//s or //StructureUsage//s. In concrete terms these references will be to DataStructureDefinitions, MetadataStructureDefinitions, DataflowDefinitions or MetadataflowDefinitions.
--
--==== 9.2.3.2 Definitions ====
--
--|**Class**|**Feature**|**Description**
--|StructureSet|(((
--Inherits from
--
--//MaintainableArtefact//
--)))|A maintainable collection of structural maps that link components together in a source/target relationship where there is a semantic equivalence between the source and the target components.
--||+relatedStructure|Association to a set of Data Structure Definitions and Metadata Structure Definitions.
--||+relatedStructureUsage|Association to a set of Dataflow Definition and Metadataflow Definition.
--||+map|Association to Structure Map.
--||+itemSchemeMap|Association to Item Scheme Map
--|StructureMap|(((
--Inherits from
--
--//NameableArtefact//
--)))|Links a source and target structure where there is a semantic equivalence between the source and the target structures.
--||sourceStructure|Association to the source Structure.
--||targetStructure|Association to the target Structure which must be of the same type as the source Structure.
--||sourceStructureUsage|Association to the source Structure Usage.
--||targetStructureUsage|Association to the target Structure Usage which must be of the same type as the source Structure Usage.
--
--== {{id name="_Toc371051"/}}9.3 Structure Map ==
--
--=== {{id name="_Toc371052"/}}9.3.1 Class Diagram ===
--
--:
--::
--:::
--::::
--:::::
--::::::
--:::::::
--::::::::
--:::::::::
--::::::::::
--
--(((
--|<<enumeration>> ToValueType
--|name : String description : String id : String
--)))
--
--**Figure 34: Class diagram of the Structure Map**
--
--=== {{id name="_Toc371053"/}}9.3.2 Explanation of the Diagram ===
--
--==== 9.3.2.1 Narrative ====
--
--The StructureMap contains a set of ComponentMaps, each one indicating equivalence between Components of the referenced //Structure//. ComponentMap has a //RepresentationMapping //which can be one of the concete classes of //ItemSchemeMap// (e.g. for a Dimension this would be a CodelistMap) or ToTextFormat which takes values: id, name, description. This instructs mapping tools to use the id, name or description of a coded component to determine equivalence with an uncoded component's value.
--
--An example of a ComponentMap is linking the source //Component// that is a Dimension in the source DataStructureDefinition (identified in the StructureMap) to the equivalent target //Component// that is a Dimension in the target DataStructureDefinition).
--
--==== 9.3.2.2 Definitions ====
--
--|**Class**|**Feature**|**Description**
--|StructureMap|(((
--Inherits from
--
--//NameableArtefact//
--)))|Links a source and target structure where there is a semantic equivalence between the source and the target structures.
--||alias|An alternate identification of the map, that allows the relation of multiple maps to be expressed by the sharing of this value.
--||+map|Association to the Component Map.
--|ComponentMap|(((
--Inherits from
--
--//AnnotableArtefact//
--)))|Links a source and target Component where there is a semantic equivalence between the source and the target Components.
--||alias|An alternate identification of the map, that allows the relation of multiple maps to be expressed by the sharing of this value.
--||preferredLanguage|Specifies the language to use for the content of the To Text Format option of RepresentationMap
--||+source|Association to the source Component.
--||+target|Association to the target Component.
--||+contentMap|Association to the constructs that map the content of the Components – this will be either one of sub classes of Item Scheme or a mapping to text.
--|//Representation Mapping//|(((
--AbstractClass Sub classes:
--
--SchemeMap
--
--ToTextFormat
--)))|Defines the mapping of the content of the source Component to the content of the target Component.
--|SchemeMap|(((
--Inherits from
--
--//RepresentationMapping &nbsp;&nbsp;&nbsp;//
--)))|Associates an Item Scheme Map
--|ToTextFormat|(((
--Inherits from
--
--//RepresentationMapping &nbsp;&nbsp;&nbsp;//
--)))|Defines the text format
--||textFormat|Text format type.
--||toValueType|Identifies the construct to be taken from the Item of the source Component when mapping the content of the source Component to the content of the target Component.
--|ToValueType||Enumeration of the construct in the Item.
--
--== {{id name="_Toc371054"/}}9.4 Item Scheme Map ==
--
--=== {{id name="_Toc371055"/}}9.4.1 Context ===
--
--The ItemSchemeMap is used to associate the //Item//s in two different //ItemSchemes//. This is a generic mechanism that can be used to map //Item//s. Specific models exist for mapping schemes where there is a semantic equivalence between //Item//s in the //ItemScheme//. The model supports the mapping of any two //ItemScheme//s of the same type. These are:
--
--* ConceptScheme
--* CategoryScheme
--* //OrganisationScheme//
--* Codelist
--* ReportingTaxonomy
--
--=== {{id name="_Toc371056"/}}9.4.2 Class Diagram ===
--
--[[image:SDMX_2-1_SECTION_2_InformationModel_2020-07_f7e5c308.png||height="343" width="553"]]
--
--**Figure 35: Class diagram of the Item Scheme Map**
--
--=== {{id name="_Toc371057"/}}9.4.3 Explanation of the Diagram ===
--
--==== 9.4.3.1 Narrative ====
--
--Both the ItemSchemeMap and the ItemAssociation inherit from NameableArtefact.
--
--Each of ConceptSchemeMap, CategorySchemeMap, CodelistMap and //OrganisationSchemeMap, //ReportingTaxonomyMap provides a mechanism for specifying semantic equivalence between the items (Concept, Category,Code, //Organisation, //ReportingCategory) in the scheme. Note that any type of //OrganisationScheme //and //Organisation// can be mapped (e.g. an Agency in an AgencyScheme can be mapped to an OrganisationUnit in an
--
--OrganisationUnitScheme).
--
--Each scheme map identifies a +source and +target scheme whose content is to be mapped. Note that many schemes can be joined together via a set of pair-wise mappings. The ConceptMap, CategoryMap, CodelistMap, OrganisationMap,and ReportingTaxonomyMap denotes which Concepts, Categorys, Codes, Organisations, and ReportingCategorys are semantically equivalent and a shared alias can be specified to refer to a set of mapped concepts to facilitate querying.
--
--==== 9.4.3.2 Definitions ====
--
--|**Class**|**Feature**|**Description**
--|//ItemSchemeMap//|Inherits from|Associates Schemes two Item
--||(((
--//NameableArtefact//
--
--//Sub Classes//
--
--ConceptSchemeMap
--
--CategorySchemeMap
--
--CodelistMap
--
--OrganisationSchemeMap
--
--ReportingTaxonomyScheme
--
--Map
--)))|
--||source|Association to the source Item Scheme.
--||target|Association to the target Item Scheme.
--||ItemAssociation|Association to the Item Association.
--|//ItemAssociation//|(((
--Inherits from
--
--//AnnotableArtefact//
--
--//Sub Classes//
--
--ConceptMap
--
--CategoryMap
--
--CodeMap
--
--OrganisationMap
--
--ReportingCategoryMap
--)))|
--||source|Association to the source Item.
--||target|Association to the target Item.
--|ConceptSchemeMap|(((
--Inherits from
--
--//ItemSchemeMap//
--)))|Associates a source and target Concept Scheme
--||/source|Association to the source Concept Scheme.
--||/target|Association to the target Concept Scheme.
--|ConceptMap|(((
--Inherits from
--
--//ItemAssociation//
--)))|Associates a source and target Concept.
--||/source|Association to the source Concept.
--||/target|Association to the target Concept.
--|CodelistMap|(((
--Inherits from
--
--//ItemSchemeMap//
--)))|Associates a source and target Code list.
--||/source|Association to the source Code list.
--||/target|Association to the target Code list.
--
--|CodeMap|(((
--Inherits from
--
--//ItemAssociation//
--)))|Associates a source and target Code.
--||/source|Association to the source Code.
--||/target|Association to the target Code.
--|CategorySchemeMap|(((
--Inherits from
--
--//ItemSchemeMap//
--)))|Associates a source and target Category Scheme.
--||/source|Association to the source Category Scheme.
--||/target|Association to the target Category Scheme.
--|CategoryMap|(((
--Inherits from
--
--//ItemAssociation//
--)))|Associates a source and target Category.
--||/source|Association to the source Category.
--||/target|Association to the target Category.
--|OrganisationSchemeMap|(((
--Inherits from
--
--//ItemSchemeMap//
--)))|Associates a source and target Organisation Scheme.
--||/source|Association to the source Organisation Scheme.
--||/target|Association to the target Organisation Scheme.
--|OrganisationMap|(((
--Inherits from
--
--//ItemAssociation//
--)))|Associates a source and target Organisation.
--||/source|Association to the source Organisation.
--||/target|Association to the target Organisation.
--|ReportingTaxonomyMap|(((
--Inherits from
--
--//ItemSchemeMap//
--)))|(((
--Associates a source and target Reporting
--
--Taxonomy.
--)))
--||/source|Association to the source Reporting Taxonomy.
--||/target|Association to the target Reporting Taxonomy.
--|ReportingCategoryMap|(((
--Inherits from
--
--//ItemAssociation//
--)))|(((
--Associates a source and target Reporting
--
--Category.
--)))
--||/source|Association to the source Reporting Category.
--||/target|Association to the target Reporting Category.
--
--== {{id name="_Toc371058"/}}9.5 Hybrid Codelist Map ==
--
--===== {{id name="_Toc371059"/}}9.5.1 Class Diagram =====
--
--[[image:SDMX_2-1_SECTION_2_InformationModel_2020-07_44d2e12d.png||height="305" width="558"]]
--
--**Figure 36: Class diagram of the Hybrid Codelist Map**
--
--===== {{id name="_Toc371060"/}}9.5.2 Explanation of the Diagram =====
--
--==== 9.5.2.1 Narrative ====
--
--The HybridCodelistMap maps the content of a Codelist and a HierachicalCodelist. It contains a mapping of the codes in the two schemes (HybridCodeMap). The HybridCodeMap maps either a Code or HierachicalCode to a Code or HierarchicalCode. The HierarchicalCode is identified by a combination of the Hierarchy and the HierarchicalCode.
--
--==== 9.5.2.2 Definitions ====
--
--|**Class**|**Feature**|**Description**
--|HybridCodelist Map|(((
--Inherits from
--
--//NameableArtefact//
--)))|Associates a Codelist and a Hierarchical Codelist.
--||alias|An alternate identification of the map, that allows the relation of multiple maps to be expressed by the sharing of this value.
--||+source|Association to the source List.
--||+target|Association to the target List.
--||+hybridCodeMap|Association to the set of Hybrid Code Maps in the Hybrid Codelist Map.
--|//SourceList//|(((
--Abstract Class
--
--Sub classes
--
--SourceCodelist
--
--SourceHierarchical
--
--Codelist
--)))|
--|//TargetList//|(((
--Abstract Class
--
--Sub classes
--
--TargetCodelist
--
--TargetHierarchical
--
--Codelist
--)))|
--|SourceCodelist// &nbsp;&nbsp;&nbsp;//||Identifies the Codelist where this is the source of the map.
--|TargetCodelist// &nbsp;&nbsp;&nbsp;//||Identifies the Codelist where this is the target of the map.
--|SourceHierarchical Codelist// &nbsp;&nbsp;&nbsp;//||Identifies the Hierarchical Codelist where this is the source of the map.
--|TargetHierarchical Codelist// &nbsp;&nbsp;&nbsp;//||Identifies the Hierarchical Codelist where this is the target of the map.
--|HybridCodeMap|(((
--Inherits from
--
--//AnnotableArtefact//
--)))|(((
--Associates the source and target codes in
--
--Hybrid Codelist Map.
--)))
--||+source|Associates the Source Code Map.
--||+target|Associates the Target Code Map.
--|//SourceCodeMap//|(((
--Abstract Class
--
--Sub classes
--
--SourceCode
--
--SourceHierarchical
--
--Code
--)))|
--|//TargetCodeMap//|(((
--Abstract Class
--
--Sub classes
--
--TargetCode
--
--TargetHierarchical
--
--Code
--)))|
--|SourceCode// &nbsp;&nbsp;&nbsp;//||Identifies the Code where this is the source of the map.
--|TargetCode// &nbsp;&nbsp;&nbsp;//||Identifies the Code where this is the target of the map.
--|SourceHierarchical Code// &nbsp;&nbsp;&nbsp;//||Identifies the Hierarchical Code where this is the source of the map
--|TargetHierarchical Code// &nbsp;&nbsp;&nbsp;//||Identifies the Hierarchical Code where this is the target of the map.
--|HierarchicalCode Reference||References both the Hierarchy and the Hierarchical Code in a Hierarchical Codelist.
--||(((
--+hierarchy
--
--+codeAssociation
--)))|Associates the Hierarchical Code in the Hierarchy of the Hierarchical Codelist.

SDMX_2-1_SECTION_2_InformationModel_2020-07_f7e5c308.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.helena

Size

...	...	@@ -1,1 +1,0 @@
1		-143.8 KB

Content