Wiki source code of 4 Specific Item Schemes

Version 6.1 by Helena on 2025/06/08 15:00

version	line-number	content
3.2	1	{{box title="Contents"}}
	2	{{toc/}}
	3	{{/box}}
1.1	4
3.2	5	== 4.1 Introduction ==
	6
5.2	7	The structures that are an arrangement of objects into [[hierarchies>>doc:sdmx:Glossary.Hierarchy.WebHome]] or lists based on characteristics, and which are maintained as a group inherit from //ItemScheme//. These concrete classes are:
1.1	8
	9	Codelist
	10	ConceptScheme
	11	CategoryScheme
	12	AgencyScheme, DataProviderScheme, MetadataProviderScheme,
	13	DataConsumerScheme, OrganisationUnitScheme, which all inherit from the abstract class //OrganisationScheme//
	14	ReportingTaxonomy
	15	TransformationScheme
	16	RulesetScheme
	17	UserDefinedOperatorScheme
	18	NamePersonalisationScheme
	19	CustomTypeScheme
	20	VtlMappingScheme
	21
5.2	22	Note that the [[VTL>>doc:sdmx:Glossary.Validation and transformation language.WebHome]] related schemes (the last 6 of the above list) are detailed in a dedicated section below (section 15).
1.1	23
3.3	24	== 4.2 Inheritance View ==
1.1	25
	26	The inheritance and relationship views are shown together in each of the diagrams in the specific sections below.
	27
3.3	28	== 4.3 Codelist ==
1.1	29
5.1	30	=== 4.3.1 Class Diagram ===
1.1	31
	32	[[image:1749246291075-895.jpeg]]
	33
	34	Figure 16: Class diagram of the Codelist
	35
3.3	36	=== 4.3.2 Explanation of the Diagram ===
1.1	37
3.3	38	==== 4.3.2.1 Narrative ====
1.1	39
5.2	40	The Codelist inherits from the //ItemScheme// and therefore has the following [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]: id uri urn (% style="color:#e74c3c" %)version(%%) validFrom validTo [[isExternalReference>>doc:sdmx:Glossary.isExternalReference.WebHome]] serviceURL structureURL isPartial
1.1	41
5.2	42	The [[Code>>doc:sdmx:Glossary.Code.WebHome]] inherits from //Item// and has the following [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]:
1.1	43
5.2	44	id
	45	uri
	46	urn
1.1	47
5.2	48	Both Codelist and [[Code>>doc:sdmx:Glossary.Code.WebHome]] have the association to InternationalString to support a multilingual name, an optional multi-lingual description, and an association to [[Annotation>>doc:sdmx:Glossary.Annotation.WebHome]] to support notes (not shown).
1.1	49
5.2	50	Through the inheritance the Codelist comprise one or more [[Codes>>doc:sdmx:Glossary.Code.WebHome]], and the [[Code>>doc:sdmx:Glossary.Code.WebHome]] itself can have one or more child [[Codes>>doc:sdmx:Glossary.Code.WebHome]] in the (inherited) [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]] association. Note that a child [[Code>>doc:sdmx:Glossary.Code.WebHome]] can have only one parent [[Code>>doc:sdmx:Glossary.Code.WebHome]] in this association. A more complex Hierarhcy, which allows multiple parents is described later.
1.1	51
6.1	52	A partial Codelist (where isPartial is set to 'true') is identical to a Codelist and contains the [[Code>>doc:sdmx:Glossary.Code.WebHome]] and associated names and descriptions, just as in a normal Codelist. However, its content is a subset of the full Codelist. The way this works is described in section [[3.5.3.1>>xwiki:3.5.3.1\|\|anchor="#H3.5.3.1Narrative"]] on //ItemScheme//.
1.1	53
3.3	54	==== 4.3.2.2 Definitions ====
1.1	55
5.2	56	(% style="width:912.835px" %)
	57	\|Class\|Feature\|(% style="width:656px" %)Description
1.1	58	\|Codelist\|(((
	59	Inherits from
	60	//ItemScheme//
5.2	61	)))\|(% style="width:656px" %)A list from which some statistical (% style="color:#e74c3c" %)concepts(%%) (coded (% style="color:#e74c3c" %)concepts(%%)) take their values.
	62	\|[[Code>>doc:sdmx:Glossary.Code.WebHome]]\|(((
1.1	63	Inherits from
	64	Item
5.2	65	)))\|(% style="width:656px" %)A language independent set of letters, numbers or symbols that represent a (% style="color:#e74c3c" %)concept(%%) whose meaning is described in a natural language.
	66	\| \|hierarchy\|(% style="width:656px" %)Associates the parent and the child [[codes>>doc:sdmx:Glossary.Code.WebHome]].
	67	\| \|extends\|(% style="width:656px" %)Associates a Codelist with any Codelists that it may extend.
1.1	68
	69	==== 4.3.3 Class Diagram – Codelist Extension ====
	70
	71	[[image:1749246291156-936.jpeg]]
	72
	73	Figure 17: Class diagram for Codelist Extension
	74
3.3	75	==== 4.3.3.1 Narrative ====
1.1	76
5.5	77	A Codelist may extend other Codelists via the CodelistExtension class. The latter, via the sequence, indicates the order of precedence of the extended Codelists for conflict resolution of [[Codes>>doc:sdmx:Glossary.Code.WebHome]]. Besides that, the prefix property is used to ensure uniqueness of inherited [[Codes>>doc:sdmx:Glossary.Code.WebHome]] in the extending[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)^^~[1~]^^>>path:#_ftn1]](%%) Codelist in case conflicting [[Codes>>doc:sdmx:Glossary.Code.WebHome]] must be included in the latter. Each CodelistExtension association may include one InclusiveCodeSelection or one ExclusiveCodeSelection; those allow including or excluding a specific selection of [[Codes>>doc:sdmx:Glossary.Code.WebHome]] from the extended Codelists.
1.1	78
5.2	79	The [[code>>doc:sdmx:Glossary.Code.WebHome]] selection classes may have MemberValues in order to specify the subset of the [[Codes>>doc:sdmx:Glossary.Code.WebHome]] that should be included or excluded from the extended Codelist. A MemberValue may have a value that corresponds to a [[Code>>doc:sdmx:Glossary.Code.WebHome]], including its children [[Codes>>doc:sdmx:Glossary.Code.WebHome]] (via the cascadeValues property), or even include instances of the wildcard character ‘%’ in order to point to a set of [[Codes>>doc:sdmx:Glossary.Code.WebHome]] with common parts in their identifiers.
1.1	80
3.3	81	==== 4.3.3.2 Definitions ====
1.1	82
5.2	83	(% style="width:970.835px" %)
	84	\|Class\|Feature\|(% style="width:655px" %)Description
	85	\|CodelistExtension\| \|(% style="width:655px" %)The association between Codelists that may extend other Codelists.
	86	\| \|prefix\|(% style="width:655px" %)A prefix to be used for a Codelist used in a extension, in order to avoid [[Code>>doc:sdmx:Glossary.Code.WebHome]] Conflicts.
	87	\| \|sequence\|(% style="width:655px" %)(((
	88	The order that will be used when extending a Codelist, for resolving [[Code>>doc:sdmx:Glossary.Code.WebHome]] conflicts. The latest Codelist used overrides any previous Codelist.
1.1	89	)))
5.2	90	\|InclusiveCodeSelection\| \|(% style="width:655px" %)The subset of [[Codes>>doc:sdmx:Glossary.Code.WebHome]] to be included when extending a Codelist.
	91	\|ExclusiveCodeSelection\| \|(% style="width:655px" %)The subset of [[Codes>>doc:sdmx:Glossary.Code.WebHome]] to be excluded when extending a Codelist.
1.1	92	\|MemberValue\|(((
	93	Inherits from:
	94	//SelectionValue//
5.2	95	)))\|(% style="width:655px" %)A collection of values based on [[Codes>>doc:sdmx:Glossary.Code.WebHome]] and their children.
	96	\| \|cascadeValues\|(% style="width:655px" %)A property to indicate if the child [[Codes>>doc:sdmx:Glossary.Code.WebHome]] of the selected [[Code>>doc:sdmx:Glossary.Code.WebHome]] shall be included in the selection. It is also possible to include children and exclude the [[Code>>doc:sdmx:Glossary.Code.WebHome]] by using the 'excluderoot' value.
	97	\| \|value\|(% style="width:655px" %)The value of the [[Code>>doc:sdmx:Glossary.Code.WebHome]] to include in the selection. It may include the ‘%’ character as a wildcard.
1.1	98
3.3	99	=== 4.3.4 Class Diagram – Geospatial Codelist ===
1.1	100
	101	The geospatial support is implemented via an extension of the normal Codelist. This is illustrated in the following diagrams.
	102
	103	[[image:1749246291164-838.jpeg]]
	104
	105	Figure 18: Inheritance for the GeoCodelist
	106
	107	[[image:1749246291175-231.jpeg]]
	108
	109	Figure 19: Class diagram for Geospatial Codelist
	110
3.3	111	==== 4.3.4.1 Narrative ====
1.1	112
5.2	113	A //GeoCodelist// is a specialisation of Codelist that includes geospatial information, by comprising a set of special [[Codes>>doc:sdmx:Glossary.Code.WebHome]], i.e., //GeoRefCode//s. A //GeoCodelist// may be implemented by any of the two following classes, via the geoType property:
1.1	114
	115	GeographicCodelist
	116
	117	GeoGridCodelist
	118
5.2	119	The former, i.e., GeographicCodelist, comprises a set of GeoFeatureSetCodes, by adding a value in the [[Code>>doc:sdmx:Glossary.Code.WebHome]] that follows a pattern to represent a geo feature set.
1.1	120
	121	The latter, i.e., GeoGridCodelist, comprises a set of GridCodes, which are related to the gridDefinition specified in the GeoGridCodelist.
	122
3.3	123	==== 4.3.4.2 Definitions ====
1.1	124
5.2	125	(% style="width:960.835px" %)
	126	\|Class\|Feature\|(% style="width:559px" %)Description
1.1	127	\|//GeoCodelist//\|(((
	128	Abstract Class Sub Classes:
	129	GeographicCodelist
	130	GeoGridCodelist
5.2	131	)))\|(% style="width:559px" %)The abstract class that represents a special type of Codelist, which includes geospatial information.
	132	\| \|geoType\|(% style="width:559px" %)The type of Geo Codelist that the Codelist will become.
1.1	133	\|//GeoRefCode//\|(((
	134	Abstract Class
	135	Sub Classes:
	136	GeoFeatureSetCode
	137	GeoGridCode
5.2	138	)))\|(% style="width:559px" %)The abstract class that represents a special type of [[Code>>doc:sdmx:Glossary.Code.WebHome]], which includes geospatial information.
	139	\|GeographicCodelist\| \|(% style="width:559px" %)A special Codelist that has been extended to add a geographical feature set to each of its items, typically, this would include all types of administrative geographies.
	140	\|GeoGridCodelist\| \|(% style="width:559px" %)A [[code list>>doc:sdmx:Glossary.Code list.WebHome]] that has defined a geographical grid composed of cells representing regular squared portions of the Earth.
	141	\| \|gridDefinition\|(% style="width:559px" %)Contains a regular expression string corresponding to the grid definition for the GeoGrid Codelist.
	142	\|GeoFeatureSetCode\| \|(% style="width:559px" %)A [[Code>>doc:sdmx:Glossary.Code.WebHome]] that has a geo feature set.
	143	\| \|value\|(% style="width:559px" %)The geo feature set of the [[Code>>doc:sdmx:Glossary.Code.WebHome]], which represents a set of points defining a feature in a format defined a predefined pattern (see section 6).
	144	\|GeoGridCode\| \|(% style="width:559px" %)A [[Code>>doc:sdmx:Glossary.Code.WebHome]] that represents a Geo Grid Cell belonging in a specific grid definition.
	145	\| \|geoCell\|(% style="width:559px" %)The value used to assign the [[Code>>doc:sdmx:Glossary.Code.WebHome]] to one cell in the grid.
1.1	146
3.3	147	== 4.4 ValueList ==
1.1	148
3.3	149	=== 4.4.1 Class Diagram ===
1.1	150
	151	[[image:1749246291179-291.jpeg]]
	152
	153	Figure 20: Class diagram of the ValueList
	154
3.3	155	=== 4.4.2 Explanation of the Diagram ===
1.1	156
3.3	157	==== 4.4.2.1 Narrative ====
1.1	158
5.2	159	A ValueList inherits from //EnumeratedList// (and hence the //MaintenableArtefact//) and thus has the following [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]:
1.1	160
5.3	161	id
	162	uri
	163	urn
	164	(% style="color:#e74c3c" %)version(%%)
	165	validFrom
	166	validTo
	167	[[isExternalReference>>doc:sdmx:Glossary.isExternalReference.WebHome]]
	168	registryURL
	169	structureURL
	170	repositoryURL
1.1	171
5.2	172	ValueItem inherits from //EnumeratedItem//, which adds an id, with relaxed (% style="color:#e74c3c" %)constraints(%%), to the former.
1.1	173
5.2	174	Through the inheritance from //NameableArtefact// the ValueList has the association to InternationalString to support a multi-lingual name, an optional multi-lingual description, and an association to [[Annotation>>doc:sdmx:Glossary.Annotation.WebHome]] to support notes (not shown). Similarly, the ValueItem, inherits the association to InternationalString and to the [[Annotation>>doc:sdmx:Glossary.Annotation.WebHome]] from the //EnumeratedItem//.
1.1	175
	176	The ValueList can have one or more ValueItems.
	177
3.3	178	==== 4.4.2.2 Definitions ====
1.1	179
5.2	180	(% style="width:929.835px" %)
	181	\|Class\|(% style="width:175px" %)Feature\|(% style="width:632px" %)Description
	182	\|ValueList\|(% style="width:175px" %)(((
1.1	183	Inherits from
	184	//EnumeratedList//
5.2	185	)))\|(% style="width:632px" %)A list from which some statistical (% style="color:#e74c3c" %)concepts(%%) (enumerated (% style="color:#e74c3c" %)concepts(%%)) take their values.
	186	\|ValueItem\|(% style="width:175px" %)(((
1.1	187	Inherits from
	188	//EnumeratedItem//
5.2	189	)))\|(% style="width:632px" %)A language independent set of letters, numbers or symbols that represent a (% style="color:#e74c3c" %)concept(%%) whose meaning is described in a natural language.
1.1	190
3.3	191	== 4.5 Concept Scheme and Concepts ==
1.1	192
3.3	193	=== 4.5.1 Class Diagram - Inheritance ===
1.1	194
	195	[[image:1749246291184-799.jpeg]]
	196
5.4	197	Figure 21 Class diagram of the Concept Scheme
1.1	198
3.3	199	=== 4.5.2 Explanation of the Diagram ===
1.1	200
5.5	201	The ConceptScheme inherits from the //ItemScheme //and therefore has the following [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]:
1.1	202
5.2	203	id
	204	uri
	205	urn
5.5	206	(% style="color:#e74c3c" %)version(%%) validFrom validTo
	207	[[isExternalReference>>doc:sdmx:Glossary.isExternalReference.WebHome]]
	208	registryURL
	209	structureURL
	210	repositoryURL
	211	isPartial
1.1	212
5.5	213	(% style="color:#e74c3c" %)Concept(%%) inherits from Item and has the following [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]:
	214
	215	id
	216	uri
	217	urn
	218
5.2	219	Through the inheritance from //NameableArtefact// both ConceptScheme and (% style="color:#e74c3c" %)Concept(%%) have the association to InternationalString to support a multi-lingual name, an optional multilingual description, and an association to [[Annotation>>doc:sdmx:Glossary.Annotation.WebHome]] to support notes (not shown).
1.1	220
5.2	221	Through the inheritance from //ItemScheme// the ConceptScheme comprise one or more (% style="color:#e74c3c" %)Concepts(%%), and the (% style="color:#e74c3c" %)Concept(%%) itself can have one or more child (% style="color:#e74c3c" %)Concepts(%%) in the (inherited) [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]] association. Note that a child (% style="color:#e74c3c" %)Concept(%%) can have only one parent (% style="color:#e74c3c" %)Concept(%%) in this association.
1.1	222
6.1	223	A partial ConceptScheme (where isPartial is set to “true”) is identical to a ConceptScheme and contains the (% style="color:#e74c3c" %)Concept(%%) and associated names and descriptions, just as in a normal ConceptScheme. However, its content is a subset of the full ConceptScheme. The way this works is described in section [[3.5.3.1>>xwiki:3.5.3.1\|\|anchor="#H3.5.3.1Narrative"]] on ItemScheme.
1.1	224
3.3	225	=== 4.5.3 Class Diagram Relationship ===
1.1	226
	227	[[image:1749246291189-654.jpeg]]
	228
	229	Figure 22: Relationship class diagram of the Concept Scheme
	230
3.3	231	=== 4.5.4 Explanation of the diagram ===
1.1	232
3.3	233	==== 4.5.4.1 Narrative ====
1.1	234
5.2	235	The ConceptScheme can have one or more (% style="color:#e74c3c" %)Concepts(%%). A (% style="color:#e74c3c" %)Concept(%%) can have zero or more child (% style="color:#e74c3c" %)Concepts(%%), thus supporting a [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]] of (% style="color:#e74c3c" %)Concepts(%%). Note that a child (% style="color:#e74c3c" %)Concept(%%) can have only one parent (% style="color:#e74c3c" %)Concept(%%) in this association. The purpose of the [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]] is to relate (% style="color:#e74c3c" %)concepts(%%) that have a semantic relationship: for example, a Reporting_Country and Vis_a_Vis_Country may both have Country as a parent (% style="color:#e74c3c" %)concept(%%), or a (% style="color:#e74c3c" %)CONTACT(%%) may have a PRIMARY_CONTACT as a child (% style="color:#e74c3c" %)concept(%%). It is not the purpose of such schemes to define reporting structures: these reporting structures are defined in the MetadataStructureDefinition.
1.1	236
5.2	237	The (% style="color:#e74c3c" %)Concept(%%) can be associated with a coreRepresentation. The coreRepresentation is the specification of the format and value domain of the (% style="color:#e74c3c" %)Concept(%%) when used on a structure like a DataStructureDefinition or a MetadataStructureDefinition, unless the specification of the [[Representation>>doc:sdmx:Glossary.Representation.WebHome]] is overridden in the relevant structure definition. In a hierarchical ConceptScheme the [[Representation>>doc:sdmx:Glossary.Representation.WebHome]] is inherited from the parent (% style="color:#e74c3c" %)Concept(%%) unless overridden at the (% style="color:#e74c3c" %)level(%%) of the child (% style="color:#e74c3c" %)Concept(%%).
1.1	238
5.2	239	The [[Representation>>doc:sdmx:Glossary.Representation.WebHome]] is documented in more detail in the section on the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] Base.
1.1	240
5.2	241	The (% style="color:#e74c3c" %)Concept(%%) may be related to a (% style="color:#e74c3c" %)concept(%%) described in terms of the ISO/IEC 11179 standard. The ISOConceptReference identifies this (% style="color:#e74c3c" %)concept(%%) and [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] in which it is contained.
1.1	242
3.3	243	==== 4.5.4.2 Definitions ====
1.1	244
5.2	245	(% style="width:912.835px" %)
	246	\|(% style="width:170px" %)Class\|(% style="width:184px" %)Feature\|(% style="width:548px" %)Description
	247	\|(% style="width:170px" %)(((
1.1	248	ConceptScheme
5.2	249	)))\|(% style="width:184px" %)(((
1.1	250	Inherits from
	251	//ItemScheme//
5.2	252	)))\|(% style="width:548px" %)The descriptive information for an arrangement or division of (% style="color:#e74c3c" %)concepts(%%) into groups based on characteristics, which the objects have in common.
	253	\|(% style="width:170px" %)(% style="color:#e74c3c" %)Concept\|(% style="width:184px" %)(((
1.1	254	Inherits from
	255	//Item//
5.2	256	)))\|(% style="width:548px" %)A (% style="color:#e74c3c" %)concept(%%) is a unit of knowledge created by a unique combination of characteristics.
	257	\|(% style="width:170px" %) \|(% style="width:184px" %)/hierarchy\|(% style="width:548px" %)Associates the parent and the child (% style="color:#e74c3c" %)concept(%%).
	258	\|(% style="width:170px" %) \|(% style="width:184px" %)coreRepresentation\|(% style="width:548px" %)Associates a [[Representation>>doc:sdmx:Glossary.Representation.WebHome]].
	259	\|(% style="width:170px" %) \|(% style="width:184px" %)+ISOConcept\|(% style="width:548px" %)Association to an ISO (% style="color:#e74c3c" %)concept(%%) reference.
	260	\|(% style="width:170px" %)ISOConceptReference\|(% style="width:184px" %) \|(% style="width:548px" %)The identity of an ISO (% style="color:#e74c3c" %)concept(%%) definition.
	261	\|(% style="width:170px" %) \|(% style="width:184px" %)conceptAgency\|(% style="width:548px" %)The [[maintenance agency>>doc:sdmx:Glossary.Maintenance agency.WebHome]] of the [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]] containing the (% style="color:#e74c3c" %)concept(%%).
	262	\|(% style="width:170px" %) \|(% style="width:184px" %)conceptSchemeID\|(% style="width:548px" %)The identifier of the [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]].
	263	\|(% style="width:170px" %) \|(% style="width:184px" %)conceptID\|(% style="width:548px" %)The identifier of the (% style="color:#e74c3c" %)concept(%%).
1.1	264
3.3	265	== 4.6 Category Scheme ==
1.1	266
3.3	267	=== 4.6.1 Context ===
1.1	268
5.2	269	This package defines the structure that supports the definition of and relationships between [[categories>>doc:sdmx:Glossary.Category.WebHome]] in a [[category scheme>>doc:sdmx:Glossary.Category scheme.WebHome]]. It is similar to the package for [[concept scheme>>doc:sdmx:Glossary.Concept scheme.WebHome]]. An example of a [[category scheme>>doc:sdmx:Glossary.Category scheme.WebHome]] is one which categorises data – sometimes known as a subject matter domain scheme or a data [[category scheme>>doc:sdmx:Glossary.Category scheme.WebHome]]. Importantly, as will be seen later, the individual nodes in the scheme (the “[[categories>>doc:sdmx:Glossary.Category.WebHome]]”) can be associated to any set of IdentiableArtefacts in a Categorisation.
1.1	270
3.3	271	=== 4.6.2 Class diagram Inheritance ===
1.1	272
	273	[[image:1749246291193-743.jpeg]]
	274
	275	Figure 23 Inheritance Class diagram of the Category Scheme
	276
3.3	277	=== 4.6.3 Explanation of the Diagram ===
1.1	278
3.3	279	==== 4.6.3.1 Narrative ====
1.1	280
5.2	281	The [[categories>>doc:sdmx:Glossary.Category.WebHome]] are modelled as a hierarchical //ItemScheme//. The CategoryScheme inherits from the //ItemScheme// and has the following [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]:
1.1	282
5.2	283	id
	284	uri
	285	urn
	286	version
	287	validFrom
	288	validTo
	289	[[isExternalReference>>doc:sdmx:Glossary.isExternalReference.WebHome]]
	290	structureURL
	291	serviceURL
	292	isPartial
1.1	293
5.2	294	[[Category>>doc:sdmx:Glossary.Category.WebHome]] inherits from //Item// and has the following [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]:
1.1	295
5.2	296	id
	297	uri
	298	urn
1.1	299
5.2	300	Both CategoryScheme and [[Category>>doc:sdmx:Glossary.Category.WebHome]] have the association to InternationalString to support a multi-lingual name, an optional multi-lingual description, and an association to [[Annotation>>doc:sdmx:Glossary.Annotation.WebHome]] to support notes (not shown on the model).
1.1	301
5.2	302	Through the inheritance the CategoryScheme comprise one or more [[Categorys>>doc:sdmx:Glossary.Category.WebHome]], and the [[Category>>doc:sdmx:Glossary.Category.WebHome]] itself can have one or more child [[Category>>doc:sdmx:Glossary.Category.WebHome]] in the (inherited) [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]] association. Note that a child [[Category>>doc:sdmx:Glossary.Category.WebHome]] can have only one parent [[Category>>doc:sdmx:Glossary.Category.WebHome]] in this association.
1.1	303
6.1	304	A partial CategoryScheme (where isPartial is set to “true”) is identical to a CategoryScheme and contains the [[Category>>doc:sdmx:Glossary.Category.WebHome]] and associated names and descriptions, just as in a normal CategoryScheme. However, its content is a subset of the full CategoryScheme. The way this works is described in section [[3.5.3.1>>xwiki:3.5.3.1\|\|anchor="#H3.5.3.1Narrative"]] on ItemScheme.
1.1	305
3.3	306	=== 4.6.4 Class diagram Relationship ===
1.1	307
	308	[[image:1749246291197-631.jpeg]]
	309
5.2	310	Figure 24: Relationship Class diagram of the [[Category Scheme>>doc:sdmx:Glossary.Category scheme.WebHome]]
1.1	311
5.2	312	The CategoryScheme can have one or more [[Categorys>>doc:sdmx:Glossary.Category.WebHome]]. The [[Category>>doc:sdmx:Glossary.Category.WebHome]] is Identifiable and has identity information. A [[Category>>doc:sdmx:Glossary.Category.WebHome]] can have zero or more child [[Categorys>>doc:sdmx:Glossary.Category.WebHome]], thus supporting a [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]] of [[Categorys>>doc:sdmx:Glossary.Category.WebHome]]. Any IdentifiableArtefact can be +categorisedBy a [[Category>>doc:sdmx:Glossary.Category.WebHome]]. This is achieved by means of a Categorisation. Each Categorisation can associate one IdentifiableArtefact with one [[Category>>doc:sdmx:Glossary.Category.WebHome]]. Multiple Categorisations can be used to build a set of IdentifiableArtefacts that are +categorisedBy the same [[Category>>doc:sdmx:Glossary.Category.WebHome]]. Note that there is no navigation (i.e. no embedded reference) to the Categorisation from the [[Category>>doc:sdmx:Glossary.Category.WebHome]]. From an implementation perspective this is necessary as Categorisation has no effect on the versioning of either the CategoryScheme or the IdentifiableArtefact.
1.1	313
3.3	314	==== 4.6.4.1 Definitions ====
1.1	315
5.2	316	(% style="width:935.835px" %)
	317	\|Class\|Feature\|(% style="width:601px" %)Description
1.1	318	\|CategoryScheme\|(((
	319	Inherits from
	320	//ItemScheme//
5.2	321	)))\|(% style="width:601px" %)The descriptive information for an arrangement or division of [[categories>>doc:sdmx:Glossary.Category.WebHome]] into groups based on characteristics, which the objects have in common.
	322	\| \|/items\|(% style="width:601px" %)Associates the [[categories>>doc:sdmx:Glossary.Category.WebHome]].
	323	\|[[Category>>doc:sdmx:Glossary.Category.WebHome]]\|(((
1.1	324	Inherits from
	325	//Item//
5.2	326	)))\|(% style="width:601px" %)An item at any (% style="color:#e74c3c" %)level(%%) within a classification, typically tabulation [[categories>>doc:sdmx:Glossary.Category.WebHome]], sections, subsections, divisions, subdivisions, groups, subgroups, classes and subclasses.
	327	\| \|/hierarchy\|(% style="width:601px" %)Associates the parent and the child [[Category>>doc:sdmx:Glossary.Category.WebHome]].
1.1	328	\|Categorisation\|(((
	329	Inherits from
	330	//MaintainableArtefact//
5.2	331	)))\|(% style="width:601px" %)Associates an Identifable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] with a [[Category>>doc:sdmx:Glossary.Category.WebHome]].
	332	\| \|+categorisedArtefact\|(% style="width:601px" %)Associates the Identifable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]].
	333	\| \|+categorisedBy\|(% style="width:601px" %)Associates the [[Category>>doc:sdmx:Glossary.Category.WebHome]].
1.1	334
3.3	335	== 4.7 Organisation Scheme ==
1.1	336
3.4	337	=== 4.7.1 Class Diagram ===
1.1	338
	339	[[image:1749246291201-410.jpeg]]
	340
	341	Figure 25 The Organisation Scheme class diagram
	342
3.4	343	=== 4.7.2 Explanation of the Diagram ===
1.1	344
3.4	345	==== 4.7.2.1 Narrative ====
1.1	346
	347	The //OrganisationScheme// is abstract. It contains //Organisation// which is also abstract. The //Organisation// can have child //Organisation//.
	348
	349	The //OrganisationScheme// can be one of five types:
	350
5.2	351	1. AgencyScheme – contains Agency which is restricted to a flat list of agencies (i.e., there is no [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]]). Note that the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] system of (Maintenance) Agency can be hierarchic and this is explained in more detail in the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”.
	352	1. DataProviderScheme – contains DataProvider which is restricted to a flat list of agencies (i.e., there is no [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]]).
	353	1. MetadataProviderScheme – contains MetadataProvider which is restricted to a flat list of agencies (i.e., there is no [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]]).
	354	1. DataConsumerScheme – contains DataConsumer which is restricted to a flat list of agencies (i.e., there is no [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]]).
	355	1. OrganisationUnitScheme – contains OrganisationUnit which does inherit the /[[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]] association from Organisation.
1.1	356
5.2	357	[[Reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] can be attached to the //Organisation// by means of the metadata attachment mechanism. This mechanism is explained in the [[Reference Metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] section of this document (see section 7). This means that the model does not specify the specific [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] that can be attached to a DataProvider, MetadataProvider, DataConsumer, OrganisationUnit or Agency, except for limited (% style="color:#e74c3c" %)Contact(%%) information.
1.1	358
6.1	359	A partial //OrganisationScheme// (where isPartial is set to “true”) is identical to an //OrganisationScheme// and contains the //Organisation// and associated names and descriptions, just as in a normal //OrganisationScheme//. However, its content is a subset of the full //OrganisationScheme//. The way this works is described in section [[3.5.3.1>>xwiki:3.5.3.1\|\|anchor="#H3.5.3.1Narrative"]] on //ItemScheme//.
1.1	360
3.4	361	==== 4.7.2.2 Definitions ====
1.1	362
5.2	363	(% style="width:946.835px" %)
	364	\|Class\|Feature\|(% style="width:540px" %)Description
1.1	365	\|//OrganisationScheme//\|(((
	366	Abstract Class
	367	Inherits from
	368	//ItemScheme//
	369	Sub classes are:
	370	AgencyScheme
	371	DataProviderScheme
	372	MetadataProviderScheme
	373	DataConsumerScheme
	374	OrganisationUnitScheme
5.2	375	)))\|(% style="width:540px" %)A maintained collection of Organisations.
	376	\| \|/items\|(% style="width:540px" %)Association to the Organisations in the scheme.
1.1	377	\|//Organisation//\|(((
	378	Abstract Class
	379	Inherits from
	380	//Item//
	381	Sub classes are:
	382	Agency
	383	DataProvider
	384	MetadataProvider
	385	DataConsumer
	386	OrganisationUnit
5.2	387	)))\|(% style="width:540px" %)An organisation is a unique framework of authority within which a person or persons act, or are designated to act, towards some purpose.
	388	\| \|+contact\|(% style="width:540px" %)Association to the (% style="color:#e74c3c" %)Contact(%%) information.
	389	\| \|/hierarchy\|(% style="width:540px" %)Association to child Organisations.
	390	\|(%%)(% style="color:#e74c3c" %)Contact\| \|(% style="width:540px" %)An instance of a role of an individual or an organization (or organization part or organization person) to whom an information item(s), a material object(s) and/or person(s) can be sent to or from in a specified context.
	391	\| \|name\|(% style="width:540px" %)The designation of the (% style="color:#e74c3c" %)Contact(%%) person by a linguistic expression.
	392	\| \|organisationUnit\|(% style="width:540px" %)The designation of the organisational structure by a linguistic expression, within which (% style="color:#e74c3c" %)Contact(%%) person works.
	393	\| \|responsibility\|(% style="width:540px" %)The function of the (% style="color:#e74c3c" %)contact(%%) person with respect to the organisation role for which this person is the (% style="color:#e74c3c" %)Contact(%%).
	394	\| \|telephone\|(% style="width:540px" %)The [[telephone number>>doc:sdmx:Glossary.Contact phone number.WebHome]] of the (% style="color:#e74c3c" %)Contact(%%).
	395	\| \|fax\|(% style="width:540px" %)The fax number of the (% style="color:#e74c3c" %)Contact(%%).
	396	\| \|email\|(% style="width:540px" %)The Internet e-mail address of the (% style="color:#e74c3c" %)Contact(%%).
	397	\| \|X400\|(% style="width:540px" %)The X400 address of the (% style="color:#e74c3c" %)Contact(%%).
	398	\| \|uri\|(% style="width:540px" %)The URL address of the (% style="color:#e74c3c" %)Contact(%%).
	399	\|AgencyScheme\| \|(% style="width:540px" %)A maintained collection of Maintenance Agencies.
	400	\| \|/items\|(% style="width:540px" %)Association to the [[Maintenance Agency>>doc:sdmx:Glossary.Maintenance agency.WebHome]] in the scheme.
	401	\|DataProviderScheme\| \|(% style="width:540px" %)A maintained collection of [[Data Providers>>doc:sdmx:Glossary.Data provider.WebHome]].
	402	\| \|/items\|(% style="width:540px" %)Association to the [[Data Providers>>doc:sdmx:Glossary.Data provider.WebHome]] in the scheme.
	403	\|MetadataProviderScheme\| \|(% style="width:540px" %)A maintained collection of Metadata Providers.
	404	\| \|/items\|(% style="width:540px" %)Association to the Metadata Providers in the scheme.
	405	\|DataConsumerScheme\| \|(% style="width:540px" %)A maintained collection of [[Data Consumers>>doc:sdmx:Glossary.Data consumer.WebHome]].
	406	\| \|/items\|(% style="width:540px" %)Association to the [[Data Consumers>>doc:sdmx:Glossary.Data consumer.WebHome]] in the scheme.
	407	\|OrganisationUnitScheme\| \|(% style="width:540px" %)A maintained collection of Organisation Units.
	408	\| \|/items\|(% style="width:540px" %)Association to the Organisation Units in the scheme.
1.1	409	\|Agency\|(((
	410	Inherits from
	411	//Organisation//
5.2	412	)))\|(% style="width:540px" %)Responsible agency for maintaining [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] such as statistical classifications, glossaries, [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] such as Data and [[Metadata Structure Definitions>>doc:sdmx:Glossary.Metadata structure definition.WebHome]], (% style="color:#e74c3c" %)Concepts(%%) and [[Code>>doc:sdmx:Glossary.Code.WebHome]] lists.
1.1	413	\|DataProvider\|(((
	414	Inherits from
	415	//Organisation//
5.2	416	)))\|(% style="width:540px" %)An organisation that produces data.
1.1	417	\|MetadataProvider\|(((
	418	Inherits from
	419	//Organisation//
5.2	420	)))\|(% style="width:540px" %)An organisation that produces [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]].
1.1	421	\|DataConsumer\|(((
	422	Inherits from
	423	//Organisation//
5.2	424	)))\|(% style="width:540px" %)An organisation using data as input for further processing.
1.1	425	\|OrganisationUnit\|(((
	426	Inherits from
	427	//Organisation//
5.2	428	)))\|(% style="width:540px" %)A designation in the organisational structure.
	429	\| \|/hierarchy\|(% style="width:540px" %)Association to child Organisation Units
1.1	430
3.4	431	== 4.8 Reporting Taxonomy ==
1.1	432
3.4	433	=== 4.8.1 Class Diagram ===
1.1	434
	435	[[image:1749246291205-630.jpeg]]
	436
	437	Figure 26: Class diagram of the Reporting Taxonomy
	438
4.1	439	=== 4.8.2 Explanation of the Diagram ===
1.1	440
4.1	441	==== 4.8.2.1 Narrative ====
1.1	442
	443	In some data reporting environments, and in particular those in primary reporting, a report may comprise a variety of heterogeneous data, each described by a different //Structure//. Equally, a specific disseminated or published report may also comprise a variety of heterogeneous data. The definition of the set of linked sub reports is supported by the ReportingTaxonomy.
	444
5.2	445	The ReportingTaxonomy is a specialised form of //ItemScheme//. Each ReportingCategory of the ReportingTaxonomy can link to one or more //StructureUsage// which itself can be one of [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], or [[Metadataflow>>doc:sdmx:Glossary.Metadataflow.WebHome]], and one or more //Structure//, which itself can be one of DataStructureDefinition or MetadataStructureDefinition. It is expected that within a specific ReportingTaxonomy each [[Category>>doc:sdmx:Glossary.Category.WebHome]] that is linked in this way will be linked to the same class (e.g. all [[Category>>doc:sdmx:Glossary.Category.WebHome]] in the scheme will link to a [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]). Note that a ReportingCategory can have child ReportingCategory and in this way it is possible to define a hierarchical ReportingTaxonomy. It is possible in this taxonomy that some ReportingCategory are defined just to give a reporting structure. For instance:
1.1	446
	447	Section 1
	448
	449	1. linked to Datafow_1
	450	1. linked to Datafow_2
	451
	452	Section 2
	453
	454	1. linked to Datafow_3
	455	1. linked to Datafow_4
	456
5.2	457	Here, the nodes of Section 1 and Section 2 would not be linked to [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] but the other would be linked to a [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] (and hence the DataStructureDefinition).
1.1	458
6.1	459	A partial ReportingTaxonomy (where isPartial is set to “true”) is identical to a ReportingTaxonomy and contains the ReportingCategory and associated names and descriptions, just as in a normal ReportingTaxonomy. However, its content is a sub set of the full ReportingTaxonomy The way this works is described in section [[3.5.3.1>>doc:Methodology.SDMX 3\.1 Standards\. Section 2\. Information model.3 SDMX Base Package.WebHome\|\|anchor="#H3.5.3.1Narrative"]] on //ItemScheme//.
1.1	460
4.1	461	==== 4.8.2.2 Definitions ====
1.1	462
5.2	463	(% style="width:969.835px" %)
	464	\|Class\|Feature\|(% style="width:668px" %)Description
1.1	465	\|ReportingTaxonomy\|(((
	466	Inherits from
	467	//ItemScheme//
5.2	468	)))\|(% style="width:668px" %)A scheme which defines the composition structure of a data report where each [[component>>doc:sdmx:Glossary.Component.WebHome]] can be described by an independent [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] or [[Metadataflow>>doc:sdmx:Glossary.Metadataflow.WebHome]].
	469	\| \|/items\|(% style="width:668px" %)Associates the Reporting [[Category>>doc:sdmx:Glossary.Category.WebHome]]
	470	\|ReportingCategory\|Inherits from //Item//\|(% style="width:668px" %)A [[component>>doc:sdmx:Glossary.Component.WebHome]] that gives structure to the report and links to data and metadata.
	471	\| \|/hierarchy\|(% style="width:668px" %)Associates child Reporting [[Category>>doc:sdmx:Glossary.Category.WebHome]].
	472	\| \|+flow\|(% style="width:668px" %)Association to the data and [[metadata flows>>doc:sdmx:Glossary.Metadataflow.WebHome]] that link to metadata about the provisioning and related data and [[metadata sets>>doc:sdmx:Glossary.Metadata set.WebHome]], and the structures that define them.
	473	\| \|+structure\|(% style="width:668px" %)Association to the [[Data Structure Definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] and [[Metadata Structure Definitions>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] which define the [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] describing the data and metadata that are contained at this part of the report.
1.1	474
	475
	476
	477	----
	478
	479	[[~[1~]>>path:#_ftnref1]] The Codelist that extends 0..* Codelists is the 'extending' Codelist, while the Codelist(s) that are inherited is/are the 'extended' Codelist(s).