Wiki source code of Guidelines on Using SDMX Annotations

Version 1.9 by Helena K. on 2026/01/15 23:27

version	line-number	content
1.1	1	{{box title="Contents"}}
	2	{{toc/}}
	3	{{/box}}
	4
	5	= DOCUMENT HISTORY =
	6
	7	\|Version\|Date\|Comment
	8	\|1.0\|01/03/2021\|Initial version.
	9	\|2.0\|24/04/2025\|Adapted to SDMX 3.0. Extensions to controlled vocabulary. Clarified text.
	10
	11	= Introduction =
	12
	13	According to the SDMX documentation, the Annotation is a construct that contains user or organisation-specific metadata. The Annotation construct in SDMX is available to most of the SDMX structural metadata artefacts. This facility is essentially a flexible extension mechanism allowing metadata to be added to an SDMX structural artefact. Annotations are often used to store metadata in artefacts when there is no specific place for that information in the SDMX information model. Presentation metadata is a prime example, such as a default presentation for a dataflow.
	14
	15	Note that whilst the SDMX Annotation has a specific structure (Title, Type, URL, Text) individual organisations are free to use these in any way and any combination they wish. However, an Annotation can only be processed in a meaningful way (i.e. other than viewing it) by systems that understand its semantics.
	16
	17	The main advantage of the Annotation is its flexibility as all properties can be tailor-made and there is no limit to their number. This can prove very useful for specific applications, such as dissemination tools. The main drawback is poor interoperability as Annotations convey no semantics and are not standardised. This means that organisations that want to exchange Annotations and process them automatically must agree upon, at least, a common naming syntax.
	18
	19	The aim of this guideline is to improve machine interactions by proposing a controlled vocabulary for the Type property of the SDMX Annotation construct and a recommended usage for the other properties that will greatly improve the interoperability of Annotations between SDMX-compliant organisations.
	20
	21	The Controlled Vocabulary referred to above will be maintained as a SDMX Concept Scheme stored in the SDMX Global Repository.
	22
	23	= SDMX Information Model for the Annotation construct =
	24
	25	=== SDMX 2.1 ===
	26
	27	[[image:1768507168026-558.png]]
	28
	29	All classes derived from the abstract class AnnotableArtefact may have Annotations. The Annotation is used to convey extra information to describe SDMX constructs. This information may be in the form of a URL reference, a non-localised text, and/or multiple localised texts (represented by the one-to-many relationship to LocalisedString).
	30
	31	=== SDMX 3.0 ===
	32
	33	[[image:1768507168030-780.png]]
	34
	35	The URL can be localised which gives the advantage of linking to different resources depending on the language. It also removes the complexity of having to use AnnotationText in SDMX 2.1 to do this.
	36
	37	= Properties of the Annotation construct =
	38
	39	The properties of the Annotation construct are listed below. This information is taken from the [[SDMX official technical documentation>>url:https://sdmx.org/?page_id=5008]].
	40
1.2	41	\|Property\|(% style="width:823px" %)Description\|(% style="width:710px" %)Controlled vocabulary context
	42	\|id\|(% style="width:823px" %)Identifier for the Annotation. It can be used to disambiguate one Annotation from another where there are several Annotations for the same annotated object.\|(% style="width:710px" %)Id is set to @SDMX to identify it as part of the controlled vocabulary
	43	\|title\|(% style="width:823px" %)A title used to identify an Annotation.\|(% style="width:710px" %)A non-localised value for the annotation. Used when localisation is irrelevant.
	44	\|type\|(% style="width:823px" %)(((
1.1	45	Specifies how the Annotation is to be processed.
1.3	46	The type is often used as the usage context of the Annotation. The types are not enumerated{{footnote}}The technical standard does not enumerate the annotation types, however this guideline provides a recommended enumeration or controlled vocabulary{{/footnote}}, as these can be specified by the Annotation creator. The definitions and use of Annotation types should be documented by their creator.
1.2	47	)))\|(% style="width:710px" %)Identifies the usage (e.g. images are type IMAGE) of the annotation. The type values are enumerated in the controlled vocabulary table.
	48	\|url\|(% style="width:823px" %)(((
1.1	49	A link to external descriptive text.
	50	The url is a URI - typically a URL - which points to a resource. If a specific behaviour is desired, an Annotation type should be defined which specifies the use of this field more exactly.
1.2	51	)))\|(% style="width:710px" %)A non-localised URL reference to an external resource. Used when localisation is irrelevant.
	52	\|+url\|(% style="width:823px" %)SDMX 3.0 and later. An annotation may have several localised URLs\|(% style="width:710px" %)A localised URL reference to an external resource.
	53	\|+text\|(% style="width:823px" %)(((
1.1	54	An International String that provides the multilingual text content of the Annotation.
	55
	56	Text holds a language-specific string containing the text of the Annotation.
1.2	57	)))\|(% style="width:710px" %)A localised value for the annotation.
1.1	58
	59	= Introducing Standard Annotations =
	60
	61	As stated earlier, a major drawback of the Annotation construct is the fact that they are not standardised for reuse when exchanging structural metadata. Annotations are containers for additional information relating to the object to which they are attached. This means that for an Annotation to be interpreted in the same way by exchange partners, a reference is needed that defines some standard behaviour and implementation.
	62
	63	This guideline proposes an Annotation controlled vocabulary and guidelines on their (re)use for SDMX implementers.
	64
	65	A standard Annotation can be defined as an Annotation that has an agreed definition in the SDMX community. Some of them, especially the general and display-related annotations also have a described behaviour. They allow diverse systems to parse the information and perform a specific action in response.
	66
	67	= How to Identify Standard Annotations? =
	68
	69	In order to be able to configure their applications to implement actions based upon standard Annotations, systems must know how to identify such Annotations. This is done by setting the Annotation id property to “@SDMX” which indicates that the Annotation is part of the controlled vocabulary described in the section List of Standard Annotations, and avoids using “@SDMX” for other usage contexts. For example, ORDER could be the order of codes (as described in this controlled vocabulary) or some kind of order number (a different usage).
	70
	71	The additional mandatory information to be provided is the type property that specifies the type of action to be implemented. There may be other mandatory property values depending on the type of the standard Annotation.
	72
	73	== Examples ==
	74
	75	The green columns in the table below show example usages of standard Annotations. The orange “ORDER” column is not a standard Annotation because the usage context is not the same as the standard Annotation “ORDER”, therefore the id should not be “@SDMX”.
	76
1.2	77	\|id\|@SDMX\|(% style="width:249px" %)@SDMX\|(% style="width:209px" %)@SDMX*\|(% style="width:888px" %)(((
1.1	78	Not @SDMX
	79
	80	This is a “customer order no.” which is a different use case than the ORDER standard Annotation which is a list order
	81	)))
1.2	82	\|title\| \|(% style="width:249px" %) \|(% style="width:209px" %) \|(% style="width:888px" %)1934245
	83	\|type*\|NOT_DISPLAYED\|(% style="width:249px" %)EXCLUDES\|(% style="width:209px" %)ORDER\|(% style="width:888px" %)ORDER
	84	\|(% rowspan="2" %)+text\|(% rowspan="2" %) \|(% rowspan="2" style="width:249px" %) \|(% style="width:209px" %)en :10\|(% rowspan="2" style="width:888px" %)
	85	\|(% style="width:209px" %)fr :20
1.1	86
	87	~* denotes a mandatory information for standard Annotations
	88
	89	= The Business value of Standard Annotations =
	90
	91	The following diagram explains the business value and decision process when deciding whether to use a standard Annotation. As can be seen, if they are used then a maximum reuse is made of the Annotation itself, tools and processes. If they are not used then bespoke Annotations, agreements, tools and processing are required to understand and make use of the information in the Annotation, and it (plus supporting tools, processes, etc.) is harder to reuse.
	92
	93	[[image:1768507168033-962.png]]
	94
	95	= List of Standard Annotations =
	96
	97	This section lists the standard Annotations with their typical usage contexts. This list will be expanded over time as new implementations and needs arise. When references to external standards are made (e.g. skos or xkos specifications), the reader is invited to consult the “References” section for more information.
	98
	99	The list of standard Annotations will be available from the SDMX Registry as artefact: SDMX:CS_ANNOT(..*). Link: [[https:~~/~~/registry.sdmx.org/ws/public/sdmxapi/rest/conceptscheme/SDMX/CS_ANNOT/latest/?format=sdmx-2.1&detail=full&references=none>>url:https://registry.sdmx.org/ws/public/sdmxapi/rest/conceptscheme/SDMX/CS_ANNOT/latest/?format=sdmx-2.1&detail=full&references=none]]
	100
	101	Note: There are several Annotations that are types of name or label, e.g. FULL_NAME, SHORT_LABEL, ORIGINAL_LABEL. These Annotations have specific use cases that are described in the tables below and should not be used to replace an artefact’s or item scheme item’s Name and Description property.
	102
	103	== Relationships between Annotation properties ==
	104
1.2	105	=== Text value defaults and specific locale values ===
1.1	106
	107	Some use cases may benefit from having a single, default value for all locales/languages but also to set the value for certain locales. An example is ORDER where there may be a default list order for all locales but two locales have a specific order which is different from the default. In order to avoid having to state an order for every locale, the Annotation Title property may be used to state the default value, whereas the text property is used for the localised values.
	108
	109	Consider this annotation //Example~:// An ORDER annotation type that is attached to a code item ACME. If both the Annotation Text and Annotation Title have values, then the Annotation Text value (e.g. en:10,es:20) is used for the localized values instead of the Annotation Title (e.g. 30) which would only be taken if the locale in the context is not found among the specified ones.
	110
1.2	111	=== URL value defaults and specific locale values ===
1.1	112
	113	===== SDMX 2.1 and earlier =====
	114
	115	In SDMX 2.1, the Annotation’s URL property is a single, non-localised value. There may be cases where different URLs are required for certain locales. In this case, it is recommended to use the Annotation text property and state the language and URL in an HTML fragment, for example:
	116
	117	fr:<a href=”https:~/~/someLink”>
	118
	119	When both a URL and text property for the locale exists, the text property overrides (is used instead of) the URL property.
	120
	121	===== SDMX 3.0 and later =====
	122
	123	Multiple URL localised properties were introduced in SDMX 3.0. Therefore, the URL work-around in the above paragraph is not recommended. The URL property should be used as shown in the table.
	124
	125	== General and Display-related Annotation types ==
	126
1.3	127	\|(% style="width:152px" %)Annotation Type\|(% style="width:559px" %)Use Case\|Where to attach\|(((
1.1	128	+Text
	129
	130	Blue is optional
	131	)))\|(((
	132	Title
	133	Blue is optional
	134	)))\|(((
	135	SDMX 2.1:URL
	136	SDMX >=3.0:+URL
	137	Blue is optional
	138	)))
1.3	139	\|(% style="width:152px" %)FULL_NAME\|(% style="width:559px" %)Alternative name to be displayed for items in Item Schemes (e.g. Codelists, Concept Schemes, Category Schemes) whenever the item is displayed without its parent. For example, if a code list that has a hierarchy is displayed as a flat list, then this annotation may be used to provide sufficient context for the code. Concatenation of code + heading in NACE Rev.2.1
	140	en: A0123 Growing of citrus fruits\|(% style="width:20px" %)Item in an Item Scheme\|(% style="width:506px" %)(((
1.1	141	<language>:<content>,
	142	<language>:<content>,…
	143	//Example~://
	144	en:Labour force (Employment)
1.3	145	)))\|(% style="width:178px" %)<content>\|(% style="width:866px" %)
	146	\|(% style="width:152px" %)REPLACE_NAME\|(% style="width:559px" %)Replace each code name in a component by the value of another component in an observation or series\|(% style="width:20px" %)A Dataflow or DSD\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	147	<component Id to replace name>:<component Id to use name>
	148
	149	//Example~://
	150	CUST_BREAKDOWN:CUST_BREAKDOWN_LB
1.3	151	)))\|(% style="width:866px" %)
	152	\|(% style="width:152px" %)REPLACE_CONTENT\|(% style="width:559px" %)Replace the content in a component by the value of another component in an observation or series\|(% style="width:20px" %)A Dataflow or DSD\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	153	<component Id to replace content>:<component Id to use content>
	154
	155	//Example~://
	156
	157	REF_AREA:M49_CODE
1.3	158	)))\|(% style="width:866px" %)
	159	\|(% style="width:152px" %)COMPLEMENT\|(% style="width:559px" %)(((
1.1	160	Additional fixed text to be displayed in parenthesis after the code name.
	161
	162	E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes
	163	en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)
	164	en: 01 03 99 wastes not otherwise specified (NHAZW)
1.3	165	)))\|(% style="width:20px" %)Item in an Item Scheme\|(% style="width:506px" %)(((
1.1	166	<language>:<content>,
	167
	168	<language>:<content>,…
	169
	170	//Example~://
	171
	172	en:See reference metadata
1.3	173	)))\|(% style="width:178px" %)<content>\|(% style="width:866px" %)
	174	\|(% style="width:152px" %)ORDER\|(% style="width:559px" %)Explicit indication of a localised order of items in Items Schemes or artefacts (e.g. Codelist, Concept Scheme, Category Scheme, Dataflow, etc.)\|(% style="width:20px" %)(((
1.1	175	Either:
	176
	177	* an artefact, or;
	178	* an item in an Item Scheme
1.3	179	)))\|(% style="width:506px" %)(((
1.1	180	<language>:<content>,
	181
	182	<language>:<content>,…
	183
	184	//Example~://
	185
	186	en:10,es:20
1.3	187	)))\|(% style="width:178px" %)(((
1.1	188	<content>
	189
	190
1.3	191	)))\|(% style="width:866px" %)
	192	\|(% style="width:152px" %)TOTAL\|(% style="width:559px" %)(((
1.1	193	Code Item that represents a total value. If the attachment is:
	194
	195	* to a Code, the Annotation Text is optional and may contain an explanatory text;
1.3	196	* to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
	197	)))\|(% style="width:20px" %)(((
1.1	198	Either:
	199
	200	* a Code Item that represents a total value, or;
	201	* a Codelist to specify the code(s) with the total
1.3	202	)))\|(% style="width:506px" %)(((
1.1	203	<language>:<explanatory text>,
	204
	205	<language>:<explanatory text>,…
1.3	206	)))\|(% style="width:178px" %)(((
1.1	207	Attached to Code Item: <blank>
	208
	209	Attached to Codelist: <code>,<code>,…
1.3	210	)))\|(% style="width:866px" %)
	211	\|(% style="width:152px" %)DRILLDOWN\|(% style="width:559px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.\|(% style="width:20px" %)(((
1.1	212	Either:
	213
	214	* A Dataflow or DSD
1.3	215	)))\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	216	<concept Id>
	217
	218	//Example~://
	219
	220	DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
1.3	221	)))\|(% style="width:866px" %)
	222	\|(% style="width:152px" %)DEPRECATED\|(% style="width:559px" %)(((
1.1	223	Indication that an Item in an Item Scheme or an artefact is deprecated.
	224
	225	For an item scheme item, the annotation value provides a replacement name for the code name.
	226
	227	For an artefact, the URL points to the replacement artefact. May be used in conjunction with SUPERSEED where the replacement artefact references the replaced artefact.
	228
	229	Suggestion to use a controlled vocabulary
	230
	231	url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
	232	url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
	233
	234	or
	235
	236	TITLE: true (false)
1.3	237	)))\|(% style="width:20px" %)(((
1.1	238	Either:
	239
	240	* an artefact, or;
	241	* an item in an Item Scheme
1.3	242	)))\|(% style="width:506px" %)(((
1.1	243	For item scheme item:
	244
	245	<language>:<content>,
	246
	247	<language>:<content>,…
	248
	249	//Example~://
	250
	251	en:deprecated,fr:obsolète
1.3	252	)))\|(% style="width:178px" %)<content>\|(% style="width:866px" %)(((
1.1	253	For artefact:
	254
	255	<see section URL value defaults and specific locale values>
	256
	257
	258	)))
1.3	259	\|(% style="width:152px" %)DEFAULT\|(% style="width:559px" %)(((
1.1	260	Indication that an item in an Item Scheme or artefacts is to be selected by default.
	261
	262	The Annotation defines a selection so that a pre-defined default subset of data can be processed (e.g. visualised, extracted) instead of the entire dataset
1.3	263	)))\|(% style="width:20px" %)(((
1.1	264	* Item in ItemScheme, or;
	265	* DSD, or;
	266	* a Dataflow
	267
	268	Note: A DEFAULT Annotation attached to a later level in this list supersedes that attached to an earlier level. E.g., a DEFAULT Annotation attached to individual Codes in Codelists is only to be used when there is no DEFAULT Annotation attached to the Dataflow nor to the DSD, and those of DSDs are only to be used when there is no DEFAULT Annotation attached to the Dataflow.
1.3	269	)))\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	270	Attached to:
	271
	272	- DSD or Dataflow:
1.2	273	<concept>=<code>+<code>+…,<concept>=<code>+<code>+…
1.1	274
	275	//Example~:// FREQ=A+Q,TIME_PERIOD_START=2013-01,TIME_PERIOD_END=2018-12
1.3	276	)))\|(% style="width:866px" %)
	277	\|(% style="width:152px" %)IMAGE\|(% style="width:559px" %)A visual identity to associate to Item Scheme Items or artefacts\|(% style="width:20px" %)(((
1.1	278	Either:
	279
	280	* an artefact, or;
	281	* an item in an item scheme
1.3	282	)))\|(% style="width:506px" %)(((
1.1	283	For localised content in SDMX 2.1
	284
	285	<language>:<HTML containing URL to the resource>,
	286
	287	<language>:<HTML containing URL to the resource>,…
	288
	289	//Example~://
	290
	291	en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”>
1.3	292	)))\|(% style="width:178px" %) \|(% style="width:866px" %)(((
1.1	293	See section URL value defaults and specific locale values.
	294
	295	//Example~://
	296	https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg
	297
	298	)))
1.3	299	\|(% style="width:152px" %)DRILLDOWN_CONCEPTS\|(% style="width:559px" %)Concepts to be displayed in a drilldown operation\|(% style="width:20px" %)Dataflow or DSD\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	300	<concept Id>,<concept Id>,…
	301
	302	Example :
	303
	304	DONOR,RECIPIENT,YEAR,PROJECT_ID,OBS_VALUE,DESCRIPTION,OWNER
1.3	305	)))\|(% style="width:866px" %)
	306	\|(% style="width:152px" %)NOT_DISPLAYED\|(% style="width:559px" %)Used to hide components or their values in the presentation\|(% style="width:20px" %)(((
1.1	307	Either:
	308
	309	* a Dataflow or DSD, or;
	310	* an Item in an Item Scheme
1.3	311	)))\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	312	Attached to Item in Item Scheme: <blank>
	313
	314	Attached to Dataflow or DSD:
	315
	316	<concept Id>,<concept Id>,…
	317
	318	Example :
	319
	320	DD_DIM (to hide drilldown control concept)
1.3	321	)))\|(% style="width:866px" %)
	322	\|(% style="width:152px" %)LAYOUT_ROW\|(% style="width:559px" %)Dimensions to be presented in rows (concepts on y-axis)\|(% style="width:20px" %)(((
1.1	323	Either:
	324
	325	* an artefact, or;
	326	* a Dimension
1.3	327	)))\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	328	Attached to Dimension: <blank>
	329
	330	Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,…
	331
	332	//Example~://
	333
	334	REF_AREA,MEASURE
1.3	335	)))\|(% style="width:866px" %)
	336	\|(% style="width:152px" %)LAYOUT_COLUMN\|(% style="width:559px" %)Dimensions to be presented in columns (concepts on x-axis)\|(% style="width:20px" %)(((
1.1	337	Either:
	338
	339	* an artefact, or;
	340	* a Dimension
1.3	341	)))\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	342	Attached to Dimension: <blank>
	343
	344	Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
	345
	346	//Example~://
	347
	348	TIME_PERIOD
1.3	349	)))\|(% style="width:866px" %)
	350	\|(% style="width:152px" %)LAYOUT_FLAG\|(% style="width:559px" %)Indication that an attribute and its attribute value should be presented as a flag\|(% style="width:20px" %)Dataflow\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	351	<concept Id>,<concept Id>,...
	352
	353	//Example~://
	354
	355	OBS_STATUS,CONF_STATUS
1.3	356	)))\|(% style="width:866px" %)
	357	\|(% style="width:152px" %)LAYOUT_NOTE\|(% style="width:559px" %)Indication that an attribute and its attribute value should be presented as a note\|(% style="width:20px" %)Dataflow\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	358	<concept Id>,<concept Id>,...
	359
	360	//Example~://
	361
	362	OBS_STATUS,CONF_STATUS
1.3	363	)))\|(% style="width:866px" %)
	364	\|(% style="width:152px" %)(((
1.1	365	METADATA
	366
	367
1.3	368	)))\|(% style="width:559px" %)Links an MSD directly to a DSD. Can be used to overcome the complexities of reference metadata linkage\|(% style="width:20px" %)DSD\|(% style="width:506px" %) \|(% style="width:178px" %)MSD URI, e.g. urn:sdmx:org.sdmx.infomodel.metadatastructure.MetadataStructure=OECD:MSD_REF_METADATA(1.0)\|(% style="width:866px" %)
	369	\|(% style="width:152px" %)LAYOUT_ROW_SECTION\|(% style="width:559px" %)Dimension to be presented as a break-down concept at a third hierarchical level above columns and rows.\|(% style="width:20px" %)(((
1.1	370	Either:
	371
	372	* an artefact, or;
	373
	374	a Dimension
1.3	375	)))\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	376	Attached to Dimension: <blank>
	377
	378	Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
	379
	380	//Example~://
	381
	382	SEX
1.3	383	)))\|(% style="width:866px" %)
	384	\|(% style="width:152px" %)EXT_RESOURCE\|(% style="width:559px" %)(((
1.1	385	A localised link to an external resource associated to the annotated artefact. For example, an ontology item
	386
	387	//a methodology// en:<a href:"[[https:~~/~~/ec.europa.eu/eurostat/web/waste/methodology>>url:https://ec.europa.eu/eurostat/web/waste/methodology]]">
1.3	388	)))\|(% style="width:20px" %)Any SDMX object\|(% style="width:506px" %)(((
1.1	389	For localised content in SDMX 2.1
	390
	391	<language>:<HTML containing URL to the resource>,
	392
	393	<language>:<HTML containing URL to the resource>,…
	394
	395	//Example~://
	396
	397	en:<a href=”[[http:~~/~~/rdf-vocabulary.ddialliance.org/xkos#depth>>url:http://rdf-vocabulary.ddialliance.org/xkos#depth]]”>
1.3	398	)))\|(% style="width:178px" %) \|(% style="width:866px" %)(((
1.1	399	See section URL value defaults and specific locale values.
	400
	401	//Example~://
	402
	403	http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth
	404	)))
1.3	405	\|(% style="width:152px" %)COMBINED_CONCEPTS\|(% style="width:559px" %)(((
1.1	406	Comma-separated list of concept IDs to show as a concatenated label.
	407
	408	The listed concepts’ item contents may be concatenated to generate the target concept.
	409
	410	Multiple target concept combinations can be defined by separating the target concepts by ;
1.3	411	)))\|(% style="width:20px" %)Dataflow or DSD\|(% style="width:506px" %)(((
1.1	412	<language>:<display name>,
	413
	414	<language>:<display name>
	415
	416	e.g. COMBINED_UNIT_MEASURE:PRICE_BASE,UNIT_MEASURE;COMBINED_MEASURE:MEASURE,REF_SECTOR{(en):Combined unit of measure;Combined measure}{(fr):Unité de mesure combinée;Mesure combinée}
1.3	417	)))\|(% style="width:178px" %) \|(% style="width:866px" %)
	418	\|(% style="width:152px" %)(deprecated) UNIT_MEASURE_CONCEPTS\|(% style="width:559px" %)(((
1.1	419	Comma-separated list of concept IDs that is used to define the full unit of measure. The concepts must be in the DSD.
	420
	421	The listed concepts’ item contents may be concatenated to generate the unit of measure label (unless the UNIT_MEASURE_LABEL annotation is present).
1.3	422	)))\|(% style="width:20px" %)Dataflow or DSD\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	423	<concept Id>,<concept Id>,…
	424
	425	//Example~:// UNIT_MEASURE,UNIT_MULT,TRANSFORMATION [could generate a value of Australian Dollar, Thousands, Non-transformed]
1.3	426	)))\|(% style="width:866px" %)
	427	\|(% style="width:152px" %)(deprecated) UNIT_MEASURE_LABEL\|(% style="width:559px" %)(((
1.1	428	Indicates the concept that enumerates the full unit of measure labels.
	429
	430	The concept must be in the DSD. UNIT_MEASURE_LABEL overrides the UNIT_MEASURE_CONCEPTS if both are provided.
	431
	432	Also can be attached to items in item scheme, e.g.
	433
	434	Text en:Gram
	435	fr: Gramme
	436	url: [[http:~~/~~/data.europa.eu/gzn/su/G>>url:http://data.europa.eu/gzn/su/G]]
1.3	437	)))\|(% style="width:20px" %)Dataflow or DSD, Item in an Item Scheme\|(% style="width:506px" %)(((
1.1	438	This is optional, used if a freetext label is required.
	439
	440	<language>:<content>,
	441
	442	<language>:<content>,…
	443
	444	//Example~://
	445
	446	en:USD, thousands
	447
	448	fr:USD, milliers
1.3	449	)))\|(% style="width:178px" %)(((
1.1	450	This is optional, used if an enumerated list is required.
	451
	452	<concept Id>
	453
	454	//Example~://
	455
	456	UOM_ATTRIBUTE [This concept may contain the following items as units of measure:
	457
	458	* National Currency, thousands
	459	* USD, thousands
	460
	461	Index, based on National Currency]
1.3	462	)))\|(% style="width:866px" %)
	463	\|(% style="width:152px" %)(((
1.1	464	LAYOUT_TIME_PERIOD_DESC
	465
	466
1.3	467	)))\|(% style="width:559px" %)Indication that the display of the TIME_PERIOD dimension for a dataflow, or all dataflows of the same DSD, is to be done in descending sort order.\|(% style="width:20px" %)Dataflow, DSD\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	468	//Example~://
	469
	470	LAYOUT_TIME_PERIOD_DESC
1.3	471	)))\|(% style="width:866px" %)
	472	\|(% style="width:152px" %)(((
1.1	473	LAYOUT_CELL_ALIGN
	474
	475
1.3	476	)))\|(% style="width:559px" %)Indication to force the data cell alignment to the left or to the right. This can be defined generically for all locales or per locale.\|(% style="width:20px" %)Dataflow, DSD, Dimension\|(% style="width:506px" %)(((
1.1	477	<language>:<content>,
	478
	479	<language>:<content>,…
	480
	481
	482	<content> values:RIGHT or LEFT
1.3	483	)))\|(% style="width:178px" %)Content values:RIGHT or LEFT\|(% style="width:866px" %)
	484	\|(% style="width:152px" %)(((
1.1	485	MAX_TABLE_DATA
	486
	487
1.3	488	)))\|(% style="width:559px" %)Increase the maximum preview table size above default maximum limits for the number of observations retrieved from the SDMX web service and for the number of table cells\|(% style="width:20px" %)Dataflow\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	489	<integer>
	490
	491	//Example~://
	492
	493	15000
1.3	494	)))\|(% style="width:866px" %)
	495	\|(% style="width:152px" %)(((
1.1	496	MAXTEXTATTRIBUTELENGTH
	497
	498
1.3	499	)))\|(% style="width:559px" %)Increase the maximum length for textual attribute values\|(% style="width:20px" %)DSD\|(% style="width:506px" %) \|(% style="width:178px" %)(((
1.1	500	<integer>
	501
	502	//Example~://
	503
	504	500
1.3	505	)))\|(% style="width:866px" %)
	506	\|(% style="width:152px" %)SEARCH_WEIGHT\|(% style="width:559px" %)Indication of localised boosted dataflows in the search results when ordered by relevance\|(% style="width:20px" %)Dataflow\|(% style="width:506px" %)(((
1.1	507	<language>:<integer>,...
	508	//Example~://
	509	"en":"3","es":"4","fr":"5"
1.3	510	)))\|(% style="width:178px" %)(((
1.1	511	<integer>
	512
	513	//Example~://
	514
	515	10
1.3	516	)))\|(% style="width:866px" %)
1.1	517
	518	== Codelist and Statistical Classification-specific Annotations ==
	519
1.3	520	The categories below are used widely, for example by the European Statistical System (ESS), and the United Nations Statistics Division for its central framework classifications ISIC4{{footnote}}International Standard Industrial Classification of All Economic Activities{{/footnote}} and CPC{{footnote}}Central Product Classification{{/footnote}}.
1.1	521
1.5	522	\|Annotation Type\|(% style="width:524px" %)Use Case\|(% style="width:198px" %)Where to attach\|(% style="width:237px" %)(((
1.4	523	**+Text
	524	(% style="background-color:transparent" %)Blue is optional(%%)**
1.7	525	)))\|(% style="width:320px" %)(((
1.4	526	**Title
	527	(% style="background-color:transparent" %)Blue is optional(%%)**
1.7	528	)))\|(% style="width:203px" %)(((
1.4	529	**SDMX 2.1:URL
1.3	530	SDMX >=3.0:+URL
1.4	531	(% style="background-color:transparent" %)Blue is optional(%%)**
1.3	532	)))
1.5	533	\|FULL_NAME\|(% style="width:524px" %)Alternative name to be displayed for items in Item Schemes (e.g. Codelists, Concept Schemes, Category Schemes) whenever the item is displayed without its parent. For example, if a code list that has a hierarchy is displayed as a flat list, then this annotation may be used to provide sufficient context for the code. Concatenation of code + heading in NACE Rev.2.1
	534	en: A0123 Growing of citrus fruits\|(% style="width:198px" %)Item in an Item Scheme\|(% style="width:237px" %)(((
	535	<language>:<content>,<language>:<content>,…
	536	//Example~://
	537	(% style="background-color:transparent" %)en:Labour force (Employment)
1.7	538	)))\|(% style="width:320px" %)<content>\|(% style="width:203px" %)
	539	\|REPLACE_NAME\|(% style="width:524px" %)Replace each code name in a component by the value of another component in an observation or series\|(% style="width:198px" %)A Dataflow or DSD\|(% style="width:237px" %) \|(% style="width:320px" %)(((
1.5	540	<component Id to replace name>:<component Id to use name>
	541	//Example~://
	542	(% style="background-color:transparent" %)CUST_BREAKDOWN:CUST_BREAKDOWN_LB
1.7	543	)))\|(% style="width:203px" %)
	544	\|REPLACE_CONTENT\|(% style="width:524px" %)Replace the content in a component by the value of another component in an observation or series\|(% style="width:198px" %)A Dataflow or DSD\|(% style="width:237px" %) \|(% style="width:320px" %)(((
1.5	545	<component Id to replace content>:<component Id to use content>
	546	//Example~://
	547	(% style="background-color:transparent" %)REF_AREA:M49_CODE
1.7	548	)))\|(% style="width:203px" %)
1.6	549	\|COMPLEMENT\|(% style="width:524px" %)(((
	550	Additional fixed text to be displayed in parenthesis after the code name.
	551	(% style="background-color:transparent" %)E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes(%%)
	552	(% style="background-color:transparent" %)en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)(%%)
	553	(% style="background-color:transparent" %)en: 01 03 99 wastes not otherwise specified (NHAZW)
	554	)))\|(% style="width:198px" %)Item in an Item Scheme\|(% style="width:237px" %)(((
	555	<language>:<content>,<language>:<content>,…
	556
	557	//Example~://
	558	(% style="background-color:transparent" %)en:See reference metadata
1.7	559	)))\|(% style="width:320px" %)<content>\|(% style="width:203px" %)
1.6	560	\|ORDER\|(% style="width:524px" %)Explicit indication of a localised order of items in Items Schemes or artefacts (e.g. Codelist, Concept Scheme, Category Scheme, Dataflow, etc.)\|(% style="width:198px" %)(((
	561	Either:
	562
	563	* an artefact, or;
	564	* an item in an Item Scheme
	565	)))\|(% style="width:237px" %)(((
	566	<language>:<content>,<language>:<content>,…
	567
	568	//Example~://
	569	(% style="background-color:transparent" %)en:10,es:20
1.7	570	)))\|(% style="width:320px" %)<content>\|(% style="width:203px" %)
1.6	571	\|TOTAL\|(% style="width:524px" %)(((
	572	Code Item that represents a total value. If the attachment is:
	573
	574	* to a Code, the Annotation Text is optional and may contain an explanatory text;
	575	* to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
	576	)))\|(% style="width:198px" %)(((
	577	Either:
	578
	579	* a Code Item that represents a total value, or;
	580	* a Codelist to specify the code(s) with the total
	581	)))\|(% style="width:237px" %)(((
	582	<language>:<explanatory text>,
	583	(% style="background-color:transparent" %)<language>:<explanatory text>,…
1.7	584	)))\|(% style="width:320px" %)(((
1.6	585	Attached to Code Item: <blank>
	586	(% style="background-color:transparent" %)Attached to Codelist: <code>,<code>,…
1.7	587	)))\|(% style="width:203px" %)
1.6	588	\|DRILLDOWN\|(% style="width:524px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.\|(% style="width:198px" %)(((
	589	Either:
	590
	591	* A Dataflow or DSD
1.7	592	)))\|(% style="width:237px" %) \|(% style="width:320px" %)(((
1.6	593	<concept Id>
	594	//Example~://
	595	(% style="background-color:transparent" %)DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
1.7	596	)))\|(% style="width:203px" %)
	597	\|DEPRECATED\|(% style="width:524px" %)(((
	598	Indication that an Item in an Item Scheme or an artefact is deprecated.
	599	For an item scheme item, the annotation value provides a replacement name for the code name.
	600	For an artefact, the URL points to the replacement artefact. May be used in conjunction with SUPERSEED where the replacement artefact references the replaced artefact.
	601	Suggestion to use a controlled vocabulary
	602	url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
	603	url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
	604	or
	605	(% style="background-color:transparent" %)TITLE: true (false)
	606	)))\|(% style="width:198px" %)(((
	607	Either:
1.1	608
1.7	609	* an artefact, or;
	610	* an item in an Item Scheme
	611	)))\|(% style="width:237px" %)(((
	612	For item scheme item:
1.1	613
1.7	614	<language>:<content>,<language>:<content>,…
1.3	615
1.7	616	//Example~://
	617	(% style="background-color:transparent" %)en:deprecated,fr:obsolète
	618	)))\|(% style="width:320px" %)<content>\|(% style="width:203px" %)(((
	619	For artefact:
	620	<see section URL value defaults and specific locale values>
	621	)))
	622	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	623	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	624	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	625	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	626	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	627	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	628	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	629	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	630	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	631	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	632	\| \|(% style="width:524px" %) \|(% style="width:198px" %) \|(% style="width:237px" %) \|(% style="width:320px" %) \|(% style="width:203px" %)
	633
1.1	634	= Concept Scheme SDMX:CS_ANNOT =
	635
	636	The Concept Scheme for standard Annotations will have the Maintenance Agency SDMX and will describe the following properties for each Annotation. For the information represented by Annotations, the value is in AnnotationTitle apart from the URL property where it is in AnnotationURL.
	637
1.3	638	\|Property\|(% style="width:309px" %)Representation in Concept\|(% style="width:1173px" %)Description
	639	\|Code\|(% style="width:309px" %)Concept Id\|(% style="width:1173px" %)The Annotation Type column, e.g. NOT_DISPLAYED, EXCLUDES
	640	\|Name\|(% style="width:309px" %)Concept Name\|(% style="width:1173px" %)Short description of the standard Annotation derived from the “Use case” column
	641	\|Representation\|(% style="width:309px" %)Concept Core Representation\|(% style="width:1173px" %)Allowable type or format for the Annotation
	642	\|Description\|(% style="width:309px" %)Concept Description\|(% style="width:1173px" %)The information in the “Use case” column. Possible to add more contextual information. Specific details can be described here, such as if the value should be in AnnotationText or AnnotationTitle
	643	\|Artefact(s)\|(% style="width:309px" %)Annotation Type: Artefact(s)\|(% style="width:1173px" %)The information in the “Where to attach” column
	644	\|URL\|(% style="width:309px" %)Annotation Type: URL\|(% style="width:1173px" %)The Annotation URL column. The value is in URL
1.1	645
	646	== Example of a Concept ==
	647
	648	\|Concept Id\|NOT_DISPLAYED
	649	\|Concept Name\|Used to hide components or their values in the presentation
	650	\|Concept Core Representation\|/TextFormat@textType="String"
	651	\|Concept Description\|To hide dimensions and attributes in a display (e.g. a table). For example, if they have only one allowed, available or selected value
	652	\|Concept: Annotation: Type: Artefact(s)\|Either a Dataflow or DSD, or an item in an item scheme
	653
	654	=== SDMX-ML of the Example ===
	655
	656	<str:Concept id="NOT_DISPLAYED">
	657	<com:Annotations>
	658	<com:Annotation>
	659	<com:AnnotationTitle>Either a Dataflow or DSD, or an item in an item scheme</com:AnnotationTitle>
	660	<com:AnnotationType>Artefact(s)</com:AnnotationType>
	661	</com:Annotation>
	662	</com:Annotations>
	663	<com:Name xml:lang="en">Used to hide components or their values in the presentation</com:Name>
	664	<com:Description xml:lang="en">To hide dimensions and attributes in a display (e.g. a table). For example, if they have only one allowed, available or selected value</com:Description>
	665	<str:CoreRepresentation>
	666	<str:TextFormat textType="String"/>
	667	</str:CoreRepresentation>
	668	</str:Concept>
	669
	670	= References =
	671
	672	* [[Formalization of the Structure and Content of Statistical Classifications>>url:https://urldefense.com/v3/__https:/eur02.safelinks.protection.outlook.com/?url=https3A2F2Furldefense.com2Fv32F__https3A2Feur02.safelinks.protection.outlook.com2F3Furl3Dhttps3A2F2Fec.europa.eu2Feurostat2Framon2Fmiscellaneous2Fgen_intro_classif_files2FStructure_and_content_of_classifications_version_1_0_October_2019.docx26data3D027C017CDavid.BARRACLOUGH40oecd.org7Cf9cb429291334e5170cb08d80c883aeb7Cac41c7d41f61460db0f4fc925a2b471c7C07C17C63727312654330364526sdata3Dl012BEX3SNWREH2FElV3r9Ld2BG49l7ouvFi7pqAGYg2Ss3D26reserved3D0__3BJSUlJSUlJSUlJSUlJSUlJSUlJSU!!DOxrgLBm!Q_cL04DGMBYhHfuPQVRMMCKao1C3QuaoJxBTxO4_mSKNMGfLjmV2UTCtAhTDvbMAZtNzrTZ324&data=027C017CDavid.BARRACLOUGH40oecd.org7Ca70a73c696814b06406408d80d1d93367Cac41c7d41f61460db0f4fc925a2b471c7C07C17C637273768055440921&sdata=r4CVvCdYBIU39XMN0qNmt2FC9FIS7AnXrzYcjuzDe0Dc3D&reserved=0__;JSUlJSUlJSUlJSoqKioqKioqJSUqKioqKioqKiUlKioqKiUlJSUlJSUlJSUlJSUl!!DOxrgLBm!RCGOp-FMBfmiP7CvEwdSAhL4XCil-vey-z32n6uxoCDXVTN7rXWXG442IZgqwpmM4wKQq908$]]
	673	* [[SDMX Global Registry>>url:https://registry.sdmx.org/overview.html]]
	674	* [[SDMX Glossary 2.1>>url:https://sdmx.org/wp-content/uploads/SDMX_Glossary_version_2_1-Final-2.docx]]
	675	* SDMX Standards, “[[Information Model: UML Conceptual Design>>url:https://sdmx.org/wp-content/uploads/SDMX_2_0_SECTION_02_InformationModel.pdf]]”, version 2.1
	676	* [[SKOS Specification>>url:https://www.w3.org/TR/2009/REC-skos-reference-20090818/]]
	677	* [[XKOS Specification>>url:https://ddialliance.org/Specification/XKOS/1.2/OWL/xkos.html]]
	678
	679	----
	680
1.3	681	{{putFootnotes/}}