Skip to Content

Changes for page 8 Hierarchy

Last modified by Artur on 2025/09/10 11:19
From version 7.1
edited by Helena
on 2025/05/16 23:21
Change comment: There is no comment for this version
To version 1.1
edited by Helena
on 2025/05/15 09:59
Change comment: Changed document syntax from [XWiki 2.1] to [xwiki/2.1].

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,0 @@
1 -8 Hierarchy
Content
... ... @@ -1,107 +1,0 @@
1 -{{box title="**Contents**"}}
2 -{{toc/}}
3 -{{/box}}
4 -
5 -== 8.1 Scope ==
6 -
7 -The Codelist described in the section on structural definitions supports a simple [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] of [[Codes>>doc:xwiki:Glossary.Code.WebHome]] and restricts any child [[Code>>doc:xwiki:Glossary.Code.WebHome]] to having just one parent [[Code>>doc:xwiki:Glossary.Code.WebHome]]. Whilst this structure is useful for supporting the needs of the DataStructureDefinition and the
8 -
9 -MetadataStructureDefinition, it may not be sufficient for supporting the more complex associations between [[codes>>doc:xwiki:Glossary.Code.WebHome]] that are often found in coding schemes such as a classification scheme. Often, the Codelist used in a DataStructureDefinition is derived from a more complex coding scheme. Access to such a coding scheme can aid applications, such as OLAP applications or data visualisation systems, to give more views of the data than would be possible with the simple Codelist used in the DataStructureDefinition. A [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] may be linked to an IndentifiableArtefact, in order to assist
10 -
11 -Note that a [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] is not necessarily a balanced tree. A balanced tree is where (% style="color:#2ecc71" %)levels(%%) are pre-defined and fixed, (i.e. a (% style="color:#2ecc71" %)level(%%) always has the same set of [[codes>>doc:xwiki:Glossary.Code.WebHome]], and any [[code>>doc:xwiki:Glossary.Code.WebHome]] has a fixed parent and child relationship to other [[codes>>doc:xwiki:Glossary.Code.WebHome]]). A statistical classification is an example of a balanced tree, and the support for a balanced [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] is a subset, and special case, of hierarchies.
12 -
13 -The principal features of the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] are:
14 -
15 -1. A child [[code>>doc:xwiki:Glossary.Code.WebHome]] can have more than one parent.
16 -1. There can be more than one [[code>>doc:xwiki:Glossary.Code.WebHome]] that has no parent (i.e. more than one “root node”).
17 -1. The (% style="color:#2ecc71" %)levels(%%) in a [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] can be explicitly defined or they can be implicit: i.e. they exist only as parent/child relationships in the coding structure.
18 -1. Hierarchies may be associated to the structures they refer to, via the HierarchyAssociation.
19 -
20 -== 8.2 Inheritance ==
21 -
22 -=== 8.2.1 Class Diagram ===
23 -
24 -[[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_3a762d00.jpg||height="415" width="376"]]
25 -
26 -**Figure 35: Inheritance class diagram for the Hierarchy**
27 -
28 -=== 8.2.2 Explanation of the Diagram ===
29 -
30 -==== 8.2.2.1 Narrative ====
31 -
32 -The [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] and //HierarchyAssociation// inherit from //MaintainableArtefact// and thus have identification, naming, versioning and a [[maintenance agency>>doc:xwiki:Glossary.Maintenance agency.WebHome]]. The (% style="color:#2ecc71" %)Level(%%) is a //NameableArtefact// and therefore has an Id, multi-lingual name and multi-lingual description. A //HierachicalCode// is an //IdentifiableArtefact//.
33 -
34 -It is important to understand that the [[Codes>>doc:xwiki:Glossary.Code.WebHome]] participating in a [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] are not themselves contained in the list – they are referenced from the list and are maintained in one or more Codelists. This is explained in the narrative of the relationship class diagram below.
35 -
36 -==== 8.2.2.2 Definitions ====
37 -
38 -The definitions of the various classes, [[attributes>>doc:xwiki:Glossary.Attribute.WebHome]], and associations are shown in the relationship section below.
39 -
40 -== 8.3 Relationship ==
41 -
42 -=== 8.3.1 Class Diagram ===
43 -
44 -[[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_3b2435ad.jpg||height="376" width="560"]]
45 -
46 -**Figure 36: Relationship class diagram of the Hierarchy**
47 -
48 -=== 8.3.2 Explanation of the Diagram ===
49 -
50 -==== 8.3.2.1 Narrative ====
51 -
52 -The basic principles of the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] are:
53 -
54 -1. The [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] is a specification of the structure of the [[Codes>>doc:xwiki:Glossary.Code.WebHome]].
55 -1. The [[Codes>>doc:xwiki:Glossary.Code.WebHome]] in the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] are not themselves a part of the [[artefact>>doc:xwiki:Glossary.Artefact.WebHome]], rather they are references to [[Codes>>doc:xwiki:Glossary.Code.WebHome]] in one or more external Codelists.
56 -1. The [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] of [[Codes>>doc:xwiki:Glossary.Code.WebHome]] is specified in HierarchicalCode. This references the [[Code>>doc:xwiki:Glossary.Code.WebHome]] and its immediate child HierarchicalCodes.
57 -
58 -A [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] can have formal (% style="color:#2ecc71" %)levels(%%) (hasFormalLevels="true"). However, even if hasFormalLevels="false" the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] can still have one or more (% style="color:#2ecc71" %)Levels(%%) associated in order to document information about the HierarchicalCodes.
59 -
60 -If hasFormalLevels="false" the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] is “value based” comprising a [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] of [[codes>>doc:xwiki:Glossary.Code.WebHome]] with no formal (% style="color:#2ecc71" %)Levels(%%). If hasFormalLevels="true" then the [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] is “(% style="color:#2ecc71" %)level(%%) based” where each (% style="color:#2ecc71" %)Level(%%) is a formal (% style="color:#2ecc71" %)Level(%%) in the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]], such as those present in statistical classifications. In a “(% style="color:#2ecc71" %)level(%%) based” [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] each HierarchicalCode is linked to the (% style="color:#2ecc71" %)Level(%%) in which it resides. It is expected that all HierarchicalCodes at the same hierarchic (% style="color:#2ecc71" %)level(%%) defined by the +parent/+child association will be linked to the same (% style="color:#2ecc71" %)Level(%%). Note that the +(% style="color:#2ecc71" %)level(%%) association need only be specified if the HierarchicalCode is at a different hierarchical (% style="color:#2ecc71" %)level(%%) (implied by the HierarchicalCode parent/child association) than the actual (% style="color:#2ecc71" %)Level(%%) in the (% style="color:#2ecc71" %)level(%%) [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] (implied by the (% style="color:#2ecc71" %)Level(%%) parent/child association).
61 -
62 -[Note that organisations wishing to be compliant with accepted models for statistical classifications should ensure that the Id is the number associated with the (% style="color:#2ecc71" %)Level(%%), where (% style="color:#2ecc71" %)Levels(%%) are numbered consecutively starting with (% style="color:#2ecc71" %)level(%%) 1 at the highest (% style="color:#2ecc71" %)Level(%%)].
63 -
64 -The (% style="color:#2ecc71" %)Level(%%) may have CodingFormat information defined (e.g. coding type at that (% style="color:#2ecc71" %)level(%%)).
65 -
66 -A HierarchyAssociation links an IdentifiableArtefact (+linkedObject), that needs a [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]], with the latter (+linkedHierarchy). The association is performed in a certain context (+contextObject), e.g. a [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] in the context of a Dataflow.
67 -
68 -==== 8.3.2.2 Definitions ====
69 -
70 -(% style="width:1046.29px" %)
71 -|**Class**|**Feature**|(% style="width:683px" %)**Description**
72 -|Hierarchy|(((
73 -Inherits from:
74 -//MaintainableArtefact//
75 -)))|(% style="width:683px" %)A classification structure arranged in (% style="color:#2ecc71" %)levels(%%) of detail from the broadest to the most detailed (% style="color:#2ecc71" %)level(%%).
76 -| |hasFormalLevels|(% style="width:683px" %)(((
77 -If “true”, this indicates a [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] where the structure is arranged in (% style="color:#2ecc71" %)levels(%%) of detail from the broadest to the most detailed (% style="color:#2ecc71" %)level(%%).
78 -If “false”, this indicates a [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] structure where the items in the [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] have no formal (% style="color:#2ecc71" %)level(%%) structure.
79 -)))
80 -| |+[[codes>>doc:xwiki:Glossary.Code.WebHome]]|(% style="width:683px" %)Association to the top-(% style="color:#2ecc71" %)level(%%) [[Hierarchical Codes>>doc:xwiki:Glossary.Hierarchical code.WebHome]] in the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
81 -| |+(% style="color:#2ecc71" %)level|(% style="width:683px" %)Association to the top (% style="color:#2ecc71" %)Level(%%) in the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
82 -|(%%)(% style="color:#2ecc71" %)Level|(((
83 -Inherits from
84 -//NameableArtefact//
85 -)))|(% style="width:683px" %)(((
86 -In a “(% style="color:#2ecc71" %)level(%%) based” [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] this describes a group of [[Codes>>doc:xwiki:Glossary.Code.WebHome]] which are characterised by homogeneous coding, and where the parent of each [[Code>>doc:xwiki:Glossary.Code.WebHome]] in the group is at the same higher (% style="color:#2ecc71" %)level(%%) of the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
87 -In a “value based’ [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] this describes information about the [[Hierarchical Codes>>doc:xwiki:Glossary.Hierarchical code.WebHome]] at the specified nesting (% style="color:#2ecc71" %)level(%%).
88 -)))
89 -| |+codeFormat|(% style="width:683px" %)Association to the Coding Format.
90 -| |+child|(% style="width:683px" %)Association to a child (% style="color:#2ecc71" %)Level(%%) of (% style="color:#2ecc71" %)Level(%%).
91 -|CodingFormat| |(% style="width:683px" %)Specifies format information for the [[codes>>doc:xwiki:Glossary.Code.WebHome]] at this (% style="color:#2ecc71" %)level(%%) in the [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] such as whether the [[codes>>doc:xwiki:Glossary.Code.WebHome]] at the (% style="color:#2ecc71" %)level(%%) are alphabetic, numeric or alphanumeric and the [[code>>doc:xwiki:Glossary.Code.WebHome]] length.
92 -|HierarchicalCode| |(% style="width:683px" %)A hierarchic structure of [[code>>doc:xwiki:Glossary.Code.WebHome]] references.
93 -| |validFrom|(% style="width:683px" %)Date from which the construct is valid
94 -| |validTo|(% style="width:683px" %)Date from which construct is superseded.
95 -| |+[[code>>doc:xwiki:Glossary.Code.WebHome]]|(% style="width:683px" %)Association to the [[Code>>doc:xwiki:Glossary.Code.WebHome]] that is used at the specific point in the [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
96 -| |+child|(% style="width:683px" %)Association to a child [[Code>>doc:xwiki:Glossary.Code.WebHome]] in the [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
97 -| |+(% style="color:#2ecc71" %)level|(% style="width:683px" %)Association to a (% style="color:#2ecc71" %)Level(%%) where (% style="color:#2ecc71" %)levels(%%) have been defined for the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
98 -|Code| |(% style="width:683px" %)The [[Code>>doc:xwiki:Glossary.Code.WebHome]] to be used at this point in the [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
99 -| |/items|(% style="width:683px" %)Association to the [[Code list>>doc:xwiki:Glossary.Code list.WebHome]] containing the [[Code>>doc:xwiki:Glossary.Code.WebHome]].
100 -|Codelist| |(% style="width:683px" %)The [[Code list>>doc:xwiki:Glossary.Code list.WebHome]] containing the [[Code>>doc:xwiki:Glossary.Code.WebHome]].
101 -|HierarchyAssociation|(((
102 -Inherits from:
103 -//MaintainableArtefact//
104 -)))|(% style="width:683px" %)An association between an [[Identifiable Artefact>>doc:xwiki:Glossary.Identifiable artefact.WebHome]] and a [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]], within a specific context.
105 -| |+contextObject|(% style="width:683px" %)The context within which the association is performed.
106 -| |+linkedObject|(% style="width:683px" %)Associates the [[Identifiable Artefact>>doc:xwiki:Glossary.Identifiable artefact.WebHome]] that needs the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
107 -| |+linkedHierarchy|(% style="width:683px" %)Associated the [[Hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]].
SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_3a762d00.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -43.7 KB
Content
SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_3b2435ad.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -75.1 KB
Content