Skip to Content
Last modified by Artur K. on 2026/05/29 14:28
From version 1.7
edited by Helena K.
on 2026/01/15 23:25
Change comment: There is no comment for this version
To version 1.11
edited by Helena K.
on 2026/01/15 23:41
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -124,410 +124,6 @@
124 124  
125 125  == General and Display-related Annotation types ==
126 126  
127 -|(% style="width:152px" %)Annotation Type|(% style="width:559px" %)Use Case|Where to attach|(((
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 -)))
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" %)(((
141 -<language>:<content>,
142 -
143 -<language>:<content>,…
144 -
145 -//Example~://
146 -
147 -en:Labour force (Employment)
148 -)))|(% style="width:178px" %)<content>|(% style="width:866px" %)
149 -|(% 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" %)(((
150 -<component Id to replace name>:<component Id to use name>
151 -
152 -//Example~://
153 -
154 -CUST_BREAKDOWN:CUST_BREAKDOWN_LB
155 -)))|(% style="width:866px" %)
156 -|(% 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" %)(((
157 -<component Id to replace content>:<component Id to use content>
158 -
159 -//Example~://
160 -
161 -REF_AREA:M49_CODE
162 -)))|(% style="width:866px" %)
163 -|(% style="width:152px" %)COMPLEMENT|(% style="width:559px" %)(((
164 -Additional fixed text to be displayed in parenthesis after the code name.
165 -
166 -E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes
167 -en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)
168 -en: 01 03 99 wastes not otherwise specified (NHAZW)
169 -)))|(% style="width:20px" %)Item in an Item Scheme|(% style="width:506px" %)(((
170 -<language>:<content>,
171 -
172 -<language>:<content>,…
173 -
174 -//Example~://
175 -
176 -en:See reference metadata
177 -)))|(% style="width:178px" %)<content>|(% style="width:866px" %)
178 -|(% 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" %)(((
179 -Either:
180 -
181 -* an artefact, or;
182 -* an item in an Item Scheme
183 -)))|(% style="width:506px" %)(((
184 -<language>:<content>,
185 -
186 -<language>:<content>,…
187 -
188 -//Example~://
189 -
190 -en:10,es:20
191 -)))|(% style="width:178px" %)(((
192 -<content>
193 -
194 -
195 -)))|(% style="width:866px" %)
196 -|(% style="width:152px" %)TOTAL|(% style="width:559px" %)(((
197 -Code Item that represents a total value. If the attachment is:
198 -
199 -* to a Code, the Annotation Text is optional and may contain an explanatory text;
200 -* to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
201 -)))|(% style="width:20px" %)(((
202 -Either:
203 -
204 -* a Code Item that represents a total value, or;
205 -* a Codelist to specify the code(s) with the total
206 -)))|(% style="width:506px" %)(((
207 -<language>:<explanatory text>,
208 -
209 -<language>:<explanatory text>,…
210 -)))|(% style="width:178px" %)(((
211 -Attached to Code Item: <blank>
212 -
213 -Attached to Codelist: <code>,<code>,…
214 -)))|(% style="width:866px" %)
215 -|(% 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" %)(((
216 -Either:
217 -
218 -* A Dataflow or DSD
219 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
220 -<concept Id>
221 -
222 -//Example~://
223 -
224 -DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
225 -)))|(% style="width:866px" %)
226 -|(% style="width:152px" %)DEPRECATED|(% style="width:559px" %)(((
227 -Indication that an Item in an Item Scheme or an artefact is deprecated.
228 -
229 -For an item scheme item, the annotation value provides a replacement name for the code name.
230 -
231 -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.
232 -
233 -Suggestion to use a controlled vocabulary
234 -
235 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
236 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
237 -
238 -or
239 -
240 -TITLE: true (false)
241 -)))|(% style="width:20px" %)(((
242 -Either:
243 -
244 -* an artefact, or;
245 -* an item in an Item Scheme
246 -)))|(% style="width:506px" %)(((
247 -For item scheme item:
248 -
249 -<language>:<content>,
250 -
251 -<language>:<content>,…
252 -
253 -//Example~://
254 -
255 -en:deprecated,fr:obsolète
256 -)))|(% style="width:178px" %)<content>|(% style="width:866px" %)(((
257 -For artefact:
258 -
259 -<see section URL value defaults and specific locale values>
260 -
261 -
262 -)))
263 -|(% style="width:152px" %)DEFAULT|(% style="width:559px" %)(((
264 -Indication that an item in an Item Scheme or artefacts is to be selected by default.
265 -
266 -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
267 -)))|(% style="width:20px" %)(((
268 -* Item in ItemScheme, or;
269 -* DSD, or;
270 -* a Dataflow
271 -
272 -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.
273 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
274 -Attached to:
275 -
276 -- DSD or Dataflow:
277 -**<concept>=<code>+<code>+…,<concept>=<code>+<code>+…**
278 -
279 -//Example~:// FREQ=A+Q,TIME_PERIOD_START=2013-01,TIME_PERIOD_END=2018-12
280 -)))|(% style="width:866px" %)
281 -|(% style="width:152px" %)IMAGE|(% style="width:559px" %)A visual identity to associate to Item Scheme Items or artefacts|(% style="width:20px" %)(((
282 -Either:
283 -
284 -* an artefact, or;
285 -* an item in an item scheme
286 -)))|(% style="width:506px" %)(((
287 -For localised content in SDMX 2.1
288 -
289 -<language>:<HTML containing URL to the resource>,
290 -
291 -<language>:<HTML containing URL to the resource>,…
292 -
293 -//Example~://
294 -
295 -en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”>
296 -)))|(% style="width:178px" %) |(% style="width:866px" %)(((
297 -See section URL value defaults and specific locale values.
298 -
299 -//Example~://
300 -
301 -https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg
302 -
303 -
304 -)))
305 -|(% 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" %)(((
306 -<concept Id>,<concept Id>,…
307 -
308 -Example :
309 -
310 -DONOR,RECIPIENT,YEAR,PROJECT_ID,OBS_VALUE,DESCRIPTION,OWNER
311 -)))|(% style="width:866px" %)
312 -|(% style="width:152px" %)NOT_DISPLAYED|(% style="width:559px" %)Used to hide components or their values in the presentation|(% style="width:20px" %)(((
313 -Either:
314 -
315 -* a Dataflow or DSD, or;
316 -* an Item in an Item Scheme
317 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
318 -Attached to Item in Item Scheme: <blank>
319 -
320 -Attached to Dataflow or DSD:
321 -
322 -<concept Id>,<concept Id>,…
323 -
324 -Example :
325 -
326 -DD_DIM (to hide drilldown control concept)
327 -)))|(% style="width:866px" %)
328 -|(% style="width:152px" %)LAYOUT_ROW|(% style="width:559px" %)Dimensions to be presented in rows (concepts on y-axis)|(% style="width:20px" %)(((
329 -Either:
330 -
331 -* an artefact, or;
332 -* a Dimension
333 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
334 -Attached to Dimension: <blank>
335 -
336 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,…
337 -
338 -//Example~://
339 -
340 -REF_AREA,MEASURE
341 -)))|(% style="width:866px" %)
342 -|(% style="width:152px" %)LAYOUT_COLUMN|(% style="width:559px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:20px" %)(((
343 -Either:
344 -
345 -* an artefact, or;
346 -* a Dimension
347 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
348 -Attached to Dimension: <blank>
349 -
350 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
351 -
352 -//Example~://
353 -
354 -TIME_PERIOD
355 -)))|(% style="width:866px" %)
356 -|(% 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" %)(((
357 -<concept Id>,<concept Id>,...
358 -
359 -//Example~://
360 -
361 -OBS_STATUS,CONF_STATUS
362 -)))|(% style="width:866px" %)
363 -|(% 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" %)(((
364 -<concept Id>,<concept Id>,...
365 -
366 -//Example~://
367 -
368 -OBS_STATUS,CONF_STATUS
369 -)))|(% style="width:866px" %)
370 -|(% style="width:152px" %)(((
371 -METADATA
372 -
373 -
374 -)))|(% 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" %)
375 -|(% 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" %)(((
376 -Either:
377 -
378 -* an artefact, or;
379 -
380 -a Dimension
381 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
382 -Attached to Dimension: <blank>
383 -
384 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
385 -
386 -//Example~://
387 -
388 -SEX
389 -)))|(% style="width:866px" %)
390 -|(% style="width:152px" %)EXT_RESOURCE|(% style="width:559px" %)(((
391 -A localised link to an external resource associated to the annotated artefact. For example, an ontology item
392 -
393 -//a methodology// en:<a href:"[[https:~~/~~/ec.europa.eu/eurostat/web/waste/methodology>>url:https://ec.europa.eu/eurostat/web/waste/methodology]]">
394 -)))|(% style="width:20px" %)Any SDMX object|(% style="width:506px" %)(((
395 -For localised content in SDMX 2.1
396 -
397 - <language>:<HTML containing URL to the resource>,
398 -
399 -<language>:<HTML containing URL to the resource>,…
400 -
401 -//Example~://
402 -
403 -en:<a href=”[[http:~~/~~/rdf-vocabulary.ddialliance.org/xkos#depth>>url:http://rdf-vocabulary.ddialliance.org/xkos#depth]]”>
404 -)))|(% style="width:178px" %) |(% style="width:866px" %)(((
405 -See section URL value defaults and specific locale values.
406 -
407 -//Example~://
408 -
409 -http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth
410 -)))
411 -|(% style="width:152px" %)COMBINED_CONCEPTS|(% style="width:559px" %)(((
412 -Comma-separated list of concept IDs to show as a concatenated label.
413 -
414 -The listed concepts’ item contents may be concatenated to generate the target concept.
415 -
416 -Multiple target concept combinations can be defined by separating the target concepts by ;
417 -)))|(% style="width:20px" %)Dataflow or DSD|(% style="width:506px" %)(((
418 -<language>:<display name>,
419 -
420 -<language>:<display name>
421 -
422 -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}
423 -)))|(% style="width:178px" %) |(% style="width:866px" %)
424 -|(% style="width:152px" %)(deprecated) UNIT_MEASURE_CONCEPTS|(% style="width:559px" %)(((
425 -Comma-separated list of concept IDs that is used to define the full unit of measure. The concepts must be in the DSD.
426 -
427 -The listed concepts’ item contents may be concatenated to generate the unit of measure label (unless the UNIT_MEASURE_LABEL annotation is present).
428 -)))|(% style="width:20px" %)Dataflow or DSD|(% style="width:506px" %) |(% style="width:178px" %)(((
429 -<concept Id>,<concept Id>,…
430 -
431 -//Example~:// UNIT_MEASURE,UNIT_MULT,TRANSFORMATION [could generate a value of Australian Dollar, Thousands, Non-transformed]
432 -)))|(% style="width:866px" %)
433 -|(% style="width:152px" %)(deprecated) UNIT_MEASURE_LABEL|(% style="width:559px" %)(((
434 -Indicates the concept that enumerates the full unit of measure labels.
435 -
436 -The concept must be in the DSD. UNIT_MEASURE_LABEL overrides the UNIT_MEASURE_CONCEPTS if both are provided.
437 -
438 -Also can be attached to items in item scheme, e.g.
439 -
440 -Text en:Gram
441 - fr: Gramme
442 -url:** **[[**http:~~/~~/data.europa.eu/gzn/su/G**>>url:http://data.europa.eu/gzn/su/G]]
443 -)))|(% style="width:20px" %)Dataflow or DSD, Item in an Item Scheme|(% style="width:506px" %)(((
444 -This is optional, used if a freetext label is required.
445 -
446 -<language>:<content>,
447 -
448 -<language>:<content>,…
449 -
450 -//Example~://
451 -
452 -en:USD, thousands
453 -
454 -fr:USD, milliers
455 -)))|(% style="width:178px" %)(((
456 -This is optional, used if an enumerated list is required.
457 -
458 -<concept Id>
459 -
460 -//Example~://
461 -
462 -UOM_ATTRIBUTE [This concept may contain the following items as units of measure:
463 -
464 -* National Currency, thousands
465 -* USD, thousands
466 -
467 -Index, based on National Currency]
468 -)))|(% style="width:866px" %)
469 -|(% style="width:152px" %)(((
470 -LAYOUT_TIME_PERIOD_DESC
471 -
472 -
473 -)))|(% 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" %)(((
474 -//Example~://
475 -
476 -LAYOUT_TIME_PERIOD_DESC
477 -)))|(% style="width:866px" %)
478 -|(% style="width:152px" %)(((
479 -LAYOUT_CELL_ALIGN
480 -
481 -
482 -)))|(% 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" %)(((
483 -<language>:<content>,
484 -
485 -<language>:<content>,…
486 -
487 -
488 -<content> values:RIGHT or LEFT
489 -)))|(% style="width:178px" %)Content values:RIGHT or LEFT|(% style="width:866px" %)
490 -|(% style="width:152px" %)(((
491 -MAX_TABLE_DATA
492 -
493 -
494 -)))|(% 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" %)(((
495 -<integer>
496 -
497 -//Example~://
498 -
499 -15000
500 -)))|(% style="width:866px" %)
501 -|(% style="width:152px" %)(((
502 -MAXTEXTATTRIBUTELENGTH
503 -
504 -
505 -)))|(% style="width:559px" %)Increase the maximum length for textual attribute values|(% style="width:20px" %)DSD|(% style="width:506px" %) |(% style="width:178px" %)(((
506 -<integer>
507 -
508 -//Example~://
509 -
510 -500
511 -)))|(% style="width:866px" %)
512 -|(% 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" %)(((
513 -<language>:<integer>,...
514 -
515 -//Example~://
516 -
517 -"en":"3","es":"4","fr":"5"
518 -)))|(% style="width:178px" %)(((
519 -<integer>
520 -
521 -//Example~://
522 -
523 -10
524 -)))|(% style="width:866px" %)
525 -
526 -== Codelist and Statistical Classification-specific Annotations ==
527 -
528 -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}}.
529 -
530 -
531 531  |**Annotation Type**|(% style="width:524px" %)**Use Case**|(% style="width:198px" %)**Where to attach**|(% style="width:237px" %)(((
532 532  **+Text
533 533  (% style="background-color:transparent" %)Blue is optional(%%)**
... ... @@ -628,153 +628,17 @@
628 628  For artefact:
629 629  <see section URL value defaults and specific locale values>
630 630  )))
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 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
634 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
635 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
636 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
637 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
638 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
639 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
640 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
641 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
642 -
643 -
644 -
645 -|FULL_NAME|(% style="width:350px" %)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 
646 -en: A0123 Growing of citrus fruits|Item in an Item Scheme|(% style="width:288px" %)(((
647 -<language>:<content>,
648 -<language>:<content>,…
649 -//Example~://
650 -en:Labour force (Employment)
651 -)))|(% style="width:1427px" %)<content>|
652 -|REPLACE_NAME|Replace each code name in a component by the value of another component in an observation or series|A Dataflow or DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
653 -<component Id to replace name>:<component Id to use name>
654 -
655 -//Example~://
656 -
657 -CUST_BREAKDOWN:CUST_BREAKDOWN_LB
658 -)))|
659 -|REPLACE_CONTENT|(% style="width:350px" %)Replace the content in a component by the value of another component in an observation or series|(% style="width:250px" %)A Dataflow or DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
660 -<component Id to replace content>:<component Id to use content>
661 -
662 -//Example~://
663 -
664 -REF_AREA:M49_CODE
665 -)))|
666 -|(% style="width:199px" %)COMPLEMENT|(% style="width:350px" %)(((
667 -Additional fixed text to be displayed in parenthesis after the code name.
668 -
669 -E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes
670 -en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)
671 -en: 01 03 99 wastes not otherwise specified (NHAZW)
672 -)))|(% style="width:250px" %)Item in an Item Scheme|(% style="width:288px" %)(((
673 -<language>:<content>,
674 -
675 -<language>:<content>,…
676 -
677 -//Example~://
678 -
679 -en:See reference metadata
680 -)))|(% style="width:1427px" %)<content>|
681 -|(% style="width:199px" %)ORDER|(% style="width:350px" %)Explicit indication of a localised order of items in Items Schemes or artefacts (e.g. Codelist, Concept Scheme, Category Scheme, Dataflow, etc.)|(% style="width:250px" %)(((
682 -Either:
683 -
684 -* an artefact, or;
685 -* an item in an Item Scheme
686 -)))|(% style="width:288px" %)(((
687 -<language>:<content>,
688 -
689 -<language>:<content>,…
690 -
691 -//Example~://
692 -
693 -en:10,es:20
694 -)))|(% style="width:1427px" %)(((
695 -<content>
696 -
697 -
698 -)))|
699 -|(% style="width:199px" %)TOTAL|(% style="width:350px" %)(((
700 -Code Item that represents a total value. If the attachment is:
701 -
702 -* to a Code, the Annotation Text is optional and may contain an explanatory text;
703 -
704 -to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
705 -)))|(% style="width:250px" %)(((
706 -Either:
707 -
708 -* a Code Item that represents a total value, or;
709 -* a Codelist to specify the code(s) with the total
710 -)))|(% style="width:288px" %)(((
711 -<language>:<explanatory text>,
712 -
713 -<language>:<explanatory text>,…
714 -)))|(% style="width:1427px" %)(((
715 -Attached to Code Item: <blank>
716 -
717 -Attached to Codelist: <code>,<code>,…
718 -)))|
719 -|(% style="width:199px" %)DRILLDOWN|(% style="width:350px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|(% style="width:250px" %)(((
720 -Either:
721 -
722 -* A Dataflow or DSD
723 -)))|(% style="width:288px" %) |(% style="width:1427px" %)(((
724 -<concept Id>
725 -
726 -//Example~://
727 -
728 -DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
729 -)))|
730 -|(% style="width:199px" %)DEPRECATED|(% style="width:350px" %)(((
731 -Indication that an Item in an Item Scheme or an artefact is deprecated.
732 -
733 -For an item scheme item, the annotation value provides a replacement name for the code name.
734 -
735 -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.
736 -
737 -Suggestion to use a controlled vocabulary
738 -
739 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
740 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
741 -
742 -or
743 -
744 -TITLE: true (false)
745 -)))|(% style="width:250px" %)(((
746 -Either:
747 -
748 -* an artefact, or;
749 -* an item in an Item Scheme
750 -)))|(% style="width:288px" %)(((
751 -For item scheme item:
752 -
753 -<language>:<content>,
754 -
755 -<language>:<content>,…
756 -
757 -//Example~://
758 -
759 -en:deprecated,fr:obsolète
760 -)))|(% style="width:1427px" %)<content>|(((
761 -For artefact:
762 -
763 -<see section URL value defaults and specific locale values>
764 -
765 -
766 -)))
767 -|(% style="width:199px" %)DEFAULT|(% style="width:350px" %)(((
227 +|DEFAULT|(% style="width:524px" %)(((
768 768  Indication that an item in an Item Scheme or artefacts is to be selected by default.
769 769  
770 770  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
771 -)))|(% style="width:250px" %)(((
231 +)))|(% style="width:198px" %)(((
772 772  * Item in ItemScheme, or;
773 773  * DSD, or;
774 774  * a Dataflow
775 775  
776 776  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.
777 -)))|(% style="width:288px" %) |(% style="width:1427px" %)(((
237 +)))|(% style="width:237px" %) |(% style="width:320px" %)(((
778 778  Attached to:
779 779  
780 780  - DSD or Dataflow:
... ... @@ -781,13 +781,13 @@
781 781  **<concept>=<code>+<code>+…,<concept>=<code>+<code>+…**
782 782  
783 783  //Example~:// FREQ=A+Q,TIME_PERIOD_START=2013-01,TIME_PERIOD_END=2018-12
784 -)))|
785 -|(% style="width:199px" %)IMAGE|(% style="width:350px" %)A visual identity to associate to Item Scheme Items or artefacts|(% style="width:250px" %)(((
244 +)))|(% style="width:203px" %)
245 +|IMAGE|(% style="width:524px" %)A visual identity to associate to Item Scheme Items or artefacts|(% style="width:198px" %)(((
786 786  Either:
787 787  
788 788  * an artefact, or;
789 789  * an item in an item scheme
790 -)))|(% style="width:288px" %)(((
250 +)))|(% style="width:237px" %)(((
791 791  For localised content in SDMX 2.1
792 792  
793 793  <language>:<HTML containing URL to the resource>,
... ... @@ -797,28 +797,26 @@
797 797  //Example~://
798 798  
799 799  en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”>
800 -)))|(% style="width:1427px" %) |(((
260 +)))|(% style="width:320px" %) |(% style="width:203px" %)(((
801 801  See section URL value defaults and specific locale values.
802 802  
803 803  //Example~://
804 804  
805 805  https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg
806 -
807 -
808 808  )))
809 -|(% style="width:199px" %)DRILLDOWN_CONCEPTS|(% style="width:350px" %)Concepts to be displayed in a drilldown operation|(% style="width:250px" %)Dataflow or DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
267 +|DRILLDOWN_CONCEPTS|(% style="width:524px" %)Concepts to be displayed in a drilldown operation|(% style="width:198px" %)Dataflow or DSD|(% style="width:237px" %) |(% style="width:320px" %)(((
810 810  <concept Id>,<concept Id>,…
811 811  
812 812  Example :
813 813  
814 -DONOR,RECIPIENT,YEAR,PROJECT_ID,OBS_VALUE,DESCRIPTION,OWNER
815 -)))|
816 -|(% style="width:199px" %)NOT_DISPLAYED|(% style="width:350px" %)Used to hide components or their values in the presentation|(% style="width:250px" %)(((
272 +DONOR,RECIPIENT,YEAR,PROJECT_ID, OBS_VALUE,DESCRIPTION,OWNER
273 +)))|(% style="width:203px" %)
274 +|NOT_DISPLAYED|(% style="width:524px" %)Used to hide components or their values in the presentation|(% style="width:198px" %)(((
817 817  Either:
818 818  
819 819  * a Dataflow or DSD, or;
820 820  * an Item in an Item Scheme
821 -)))|(% style="width:288px" %) |(% style="width:1427px" %)(((
279 +)))|(% style="width:237px" %) |(% style="width:320px" %)(((
822 822  Attached to Item in Item Scheme: <blank>
823 823  
824 824  Attached to Dataflow or DSD:
... ... @@ -828,13 +828,13 @@
828 828  Example :
829 829  
830 830  DD_DIM (to hide drilldown control concept)
831 -)))|
832 -|(% style="width:199px" %)LAYOUT_ROW|(% style="width:350px" %)Dimensions to be presented in rows (concepts on y-axis)|(% style="width:250px" %)(((
289 +)))|(% style="width:203px" %)
290 +|LAYOUT_ROW|(% style="width:524px" %)Dimensions to be presented in rows (concepts on y-axis)|(% style="width:198px" %)(((
833 833  Either:
834 834  
835 835  * an artefact, or;
836 836  * a Dimension
837 -)))|(% style="width:288px" %) |(% style="width:1427px" %)(((
295 +)))|(% style="width:237px" %) |(% style="width:320px" %)(((
838 838  Attached to Dimension: <blank>
839 839  
840 840  Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,…
... ... @@ -842,13 +842,14 @@
842 842  //Example~://
843 843  
844 844  REF_AREA,MEASURE
845 -)))|
846 -|(% style="width:199px" %)LAYOUT_COLUMN|(% style="width:350px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:250px" %)(((
303 +)))|(% style="width:203px" %)
304 +|LAYOUT_COLUMN|(% style="width:524px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:198px" %)(((
847 847  Either:
848 848  
849 849  * an artefact, or;
850 -* a Dimension
851 -)))|(% style="width:288px" %) |(% style="width:1427px" %)(((
308 +
309 +a Dimension
310 +)))|(% style="width:237px" %) |(% style="width:320px" %)(((
852 852  Attached to Dimension: <blank>
853 853  
854 854  Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
... ... @@ -856,33 +856,30 @@
856 856  //Example~://
857 857  
858 858  TIME_PERIOD
859 -)))|
860 -|(% style="width:199px" %)LAYOUT_FLAG|(% style="width:350px" %)Indication that an attribute and its attribute value should be presented as a flag|(% style="width:250px" %)Dataflow|(% style="width:288px" %) |(% style="width:1427px" %)(((
318 +)))|(% style="width:203px" %)
319 +|LAYOUT_FLAG|(% style="width:524px" %)Indication that an attribute and its attribute value should be presented as a flag|(% style="width:198px" %)Dataflow|(% style="width:237px" %) |(% style="width:320px" %)(((
861 861  <concept Id>,<concept Id>,...
862 862  
863 863  //Example~://
864 864  
865 865  OBS_STATUS,CONF_STATUS
866 -)))|
867 -|(% style="width:199px" %)LAYOUT_NOTE|(% style="width:350px" %)Indication that an attribute and its attribute value should be presented as a note|(% style="width:250px" %)Dataflow|(% style="width:288px" %) |(% style="width:1427px" %)(((
325 +)))|(% style="width:203px" %)
326 +|LAYOUT_NOTE|(% style="width:524px" %)Indication that an attribute and its attribute value should be presented as a note|(% style="width:198px" %)Dataflow|(% style="width:237px" %) |(% style="width:320px" %)(((
868 868  <concept Id>,<concept Id>,...
869 869  
870 870  //Example~://
871 871  
872 872  OBS_STATUS,CONF_STATUS
873 -)))|
874 -|(% style="width:199px" %)(((
332 +)))|(% style="width:203px" %)
333 +|(((
875 875  METADATA
876 -
877 -
878 -)))|(% style="width:350px" %)Links an MSD directly to a DSD. Can be used to overcome the complexities of reference metadata linkage|(% style="width:250px" %)DSD|(% style="width:288px" %) |(% style="width:1427px" %)MSD URI, e.g. urn:sdmx:org.sdmx.infomodel.metadatastructure.MetadataStructure=OECD:MSD_REF_METADATA(1.0)|
879 -|(% style="width:199px" %)LAYOUT_ROW_SECTION|(% style="width:350px" %)Dimension to be presented as a break-down concept at a third hierarchical level above columns and rows.|(% style="width:250px" %)(((
335 +)))|(% style="width:524px" %)Links an MSD directly to a DSD. Can be used to overcome the complexities of reference metadata linkage|(% style="width:198px" %)DSD|(% style="width:237px" %) |(% style="width:320px" %)MSD URI, e.g. urn:sdmx:org.sdmx.infomodel.metadatastructure.MetadataStructure =OECD:MSD_REF_METADATA(1.0)|(% style="width:203px" %)
336 +|LAYOUT_ROW_SECTION|(% style="width:524px" %)Dimension to be presented as a break-down concept at a third hierarchical level above columns and rows.|(% style="width:198px" %)(((
880 880  Either:
881 881  
882 882  * an artefact, or;
883 -
884 -a Dimension
885 -)))|(% style="width:288px" %) |(% style="width:1427px" %)(((
340 +* a Dimension
341 +)))|(% style="width:237px" %) |(% style="width:320px" %)(((
886 886  Attached to Dimension: <blank>
887 887  
888 888  Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
... ... @@ -890,12 +890,12 @@
890 890  //Example~://
891 891  
892 892  SEX
893 -)))|
894 -|(% style="width:199px" %)EXT_RESOURCE|(% style="width:350px" %)(((
349 +)))|(% style="width:203px" %)
350 +|EXT_RESOURCE|(% style="width:524px" %)(((
895 895  A localised link to an external resource associated to the annotated artefact. For example, an ontology item
896 896  
897 897  //a methodology// en:<a href:"[[https:~~/~~/ec.europa.eu/eurostat/web/waste/methodology>>url:https://ec.europa.eu/eurostat/web/waste/methodology]]">
898 -)))|(% style="width:250px" %)Any SDMX object|(% style="width:288px" %)(((
354 +)))|(% style="width:198px" %)Any SDMX object|(% style="width:237px" %)(((
899 899  For localised content in SDMX 2.1
900 900  
901 901   <language>:<HTML containing URL to the resource>,
... ... @@ -905,7 +905,7 @@
905 905  //Example~://
906 906  
907 907  en:<a href=”[[http:~~/~~/rdf-vocabulary.ddialliance.org/xkos#depth>>url:http://rdf-vocabulary.ddialliance.org/xkos#depth]]”>
908 -)))|(% style="width:1427px" %) |(((
364 +)))|(% style="width:320px" %) |(% style="width:203px" %)(((
909 909  See section URL value defaults and specific locale values.
910 910  
911 911  //Example~://
... ... @@ -912,121 +912,29 @@
912 912  
913 913  http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth
914 914  )))
915 -|(% style="width:199px" %)COMBINED_CONCEPTS|(% style="width:350px" %)(((
371 +|COMBINED_CONCEPTS|(% style="width:524px" %)(((
916 916  Comma-separated list of concept IDs to show as a concatenated label.
917 917  
918 918  The listed concepts’ item contents may be concatenated to generate the target concept.
919 919  
920 920  Multiple target concept combinations can be defined by separating the target concepts by ;
921 -)))|(% style="width:250px" %)Dataflow or DSD|(% style="width:288px" %)(((
377 +)))|(% style="width:198px" %)Dataflow or DSD|(% style="width:237px" %)(((
922 922  <language>:<display name>,
923 -
924 924  <language>:<display name>
925 -
926 -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}
927 -)))|(% style="width:1427px" %) |
928 -|(% style="width:199px" %)(deprecated) UNIT_MEASURE_CONCEPTS|(% style="width:350px" %)(((
929 -Comma-separated list of concept IDs that is used to define the full unit of measure. The concepts must be in the DSD.
930 -
931 -The listed concepts’ item contents may be concatenated to generate the unit of measure label (unless the UNIT_MEASURE_LABEL annotation is present).
932 -)))|(% style="width:250px" %)Dataflow or DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
933 -<concept Id>,<concept Id>,…
934 -
935 -//Example~:// UNIT_MEASURE,UNIT_MULT,TRANSFORMATION [could generate a value of Australian Dollar, Thousands, Non-transformed]
936 -)))|
937 -|(% style="width:199px" %)(deprecated) UNIT_MEASURE_LABEL|(% style="width:350px" %)(((
938 -Indicates the concept that enumerates the full unit of measure labels.
939 -
940 -The concept must be in the DSD. UNIT_MEASURE_LABEL overrides the UNIT_MEASURE_CONCEPTS if both are provided.
941 -
942 -Also can be attached to items in item scheme, e.g.
943 -
944 -Text en:Gram
945 - fr: Gramme
946 -url:** **[[**http:~~/~~/data.europa.eu/gzn/su/G**>>url:http://data.europa.eu/gzn/su/G]]
947 -)))|(% style="width:250px" %)Dataflow or DSD, Item in an Item Scheme|(% style="width:288px" %)(((
948 -This is optional, used if a freetext label is required.
949 -
950 -<language>:<content>,
951 -
952 -<language>:<content>,…
953 -
954 -//Example~://
955 -
956 -en:USD, thousands
957 -
958 -fr:USD, milliers
959 -)))|(% style="width:1427px" %)(((
960 -This is optional, used if an enumerated list is required.
961 -
962 -<concept Id>
963 -
964 -//Example~://
965 -
966 -UOM_ATTRIBUTE [This concept may contain the following items as units of measure:
967 -
968 -* National Currency, thousands
969 -* USD, thousands
970 -
971 -Index, based on National Currency]
972 -)))|
973 -|(% style="width:199px" %)(((
974 -LAYOUT_TIME_PERIOD_DESC
975 -
380 +(% style="background-color:transparent" %)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}
381 +)))|(% style="width:320px" %) |(% style="width:203px" %)
382 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
383 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
384 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
385 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
386 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
976 976  
977 -)))|(% style="width:350px" %)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:250px" %)Dataflow, DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
978 -//Example~://
979 979  
980 -LAYOUT_TIME_PERIOD_DESC
981 -)))|
982 -|(% style="width:199px" %)(((
983 -LAYOUT_CELL_ALIGN
389 +== Codelist and Statistical Classification-specific Annotations ==
984 984  
985 -
986 -)))|(% style="width:350px" %)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:250px" %)Dataflow, DSD, Dimension|(% style="width:288px" %)(((
987 -<language>:<content>,
391 +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}}.
988 988  
989 -<language>:<content>,…
990 990  
991 -
992 -<content> values:RIGHT or LEFT
993 -)))|(% style="width:1427px" %)Content values:RIGHT or LEFT|
994 -|(% style="width:199px" %)(((
995 -MAX_TABLE_DATA
996 -
997 -
998 -)))|(% style="width:350px" %)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:250px" %)Dataflow|(% style="width:288px" %) |(% style="width:1427px" %)(((
999 -<integer>
1000 -
1001 -//Example~://
1002 -
1003 -15000
1004 -)))|
1005 -|(% style="width:199px" %)(((
1006 -MAXTEXTATTRIBUTELENGTH
1007 -
1008 -
1009 -)))|(% style="width:350px" %)Increase the maximum length for textual attribute values|(% style="width:250px" %)DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
1010 -<integer>
1011 -
1012 -//Example~://
1013 -
1014 -500
1015 -)))|
1016 -|(% style="width:199px" %)SEARCH_WEIGHT|(% style="width:350px" %)Indication of localised boosted dataflows in the search results when ordered by relevance|(% style="width:250px" %)Dataflow|(% style="width:288px" %)(((
1017 -<language>:<integer>,...
1018 -
1019 -//Example~://
1020 -
1021 -"en":"3","es":"4","fr":"5"
1022 -)))|(% style="width:1427px" %)(((
1023 -<integer>
1024 -
1025 -//Example~://
1026 -
1027 -10
1028 -)))|
1029 -
1030 1030  = Concept Scheme SDMX:CS_ANNOT =
1031 1031  
1032 1032  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.
© Semantic R&D Group, 2026