Changes for page Guidelines on Using SDMX Annotations
Last modified by Artur K. on 2026/05/29 14:28
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -124,417 +124,15 @@ 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 127 +== == 129 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(%%)** 534 -)))|(% style="width: 465px" %)(((132 +)))|(% style="width:320px" %)((( 535 535 **Title 536 536 (% style="background-color:transparent" %)Blue is optional(%%)** 537 -)))|((( 135 +)))|(% style="width:203px" %)((( 538 538 **SDMX 2.1:URL 539 539 SDMX >=3.0:+URL 540 540 (% style="background-color:transparent" %)Blue is optional(%%)** ... ... @@ -544,421 +544,107 @@ 544 544 <language>:<content>,<language>:<content>,… 545 545 //Example~:// 546 546 (% style="background-color:transparent" %)en:Labour force (Employment) 547 -)))|(% style="width: 465px" %)<content>|548 -|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: 465px" %)(((145 +)))|(% style="width:320px" %)<content>|(% style="width:203px" %) 146 +|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" %)((( 549 549 <component Id to replace name>:<component Id to use name> 550 550 //Example~:// 551 551 (% style="background-color:transparent" %)CUST_BREAKDOWN:CUST_BREAKDOWN_LB 552 -)))| 553 -|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: 465px" %)(((150 +)))|(% style="width:203px" %) 151 +|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" %)((( 554 554 <component Id to replace content>:<component Id to use content> 555 555 //Example~:// 556 556 (% style="background-color:transparent" %)REF_AREA:M49_CODE 557 -)))| 558 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 559 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 560 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 561 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 562 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 563 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 564 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 565 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 566 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 567 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 568 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 569 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 570 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 571 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 572 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 573 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:465px" %) | 574 - 575 - 576 - 577 -|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 578 -en: A0123 Growing of citrus fruits|Item in an Item Scheme|(% style="width:288px" %)((( 579 -<language>:<content>, 580 -<language>:<content>,… 581 -//Example~:// 582 -en:Labour force (Employment) 583 -)))|(% style="width:1427px" %)<content>| 584 -|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" %)((( 585 -<component Id to replace name>:<component Id to use name> 586 - 587 -//Example~:// 588 - 589 -CUST_BREAKDOWN:CUST_BREAKDOWN_LB 590 -)))| 591 -|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" %)((( 592 -<component Id to replace content>:<component Id to use content> 593 - 594 -//Example~:// 595 - 596 -REF_AREA:M49_CODE 597 -)))| 598 -|(% style="width:199px" %)COMPLEMENT|(% style="width:350px" %)((( 155 +)))|(% style="width:203px" %) 156 +|COMPLEMENT|(% style="width:524px" %)((( 599 599 Additional fixed text to be displayed in parenthesis after the code name. 158 +(% style="background-color:transparent" %)E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes(%%) 159 +(% style="background-color:transparent" %)en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)(%%) 160 +(% style="background-color:transparent" %)en: 01 03 99 wastes not otherwise specified (NHAZW) 161 +)))|(% style="width:198px" %)Item in an Item Scheme|(% style="width:237px" %)((( 162 +<language>:<content>,<language>:<content>,… 600 600 601 -E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes 602 -en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW) 603 -en: 01 03 99 wastes not otherwise specified (NHAZW) 604 -)))|(% style="width:250px" %)Item in an Item Scheme|(% style="width:288px" %)((( 605 -<language>:<content>, 606 - 607 -<language>:<content>,… 608 - 609 609 //Example~:// 610 - 611 -en:See reference metadata 612 -)))|(% style="width:1427px" %)<content>| 613 -|(% 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" %)((( 165 +(% style="background-color:transparent" %)en:See reference metadata 166 +)))|(% style="width:320px" %)<content>|(% style="width:203px" %) 167 +|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" %)((( 614 614 Either: 615 615 616 616 * an artefact, or; 617 617 * an item in an Item Scheme 618 -)))|(% style="width:2 88px" %)(((619 -<language>:<content>, 172 +)))|(% style="width:237px" %)((( 173 +<language>:<content>,<language>:<content>,… 620 620 621 -<language>:<content>,… 622 - 623 623 //Example~:// 624 - 625 -en:10,es:20 626 -)))|(% style="width:1427px" %)((( 627 -<content> 628 - 629 - 630 -)))| 631 -|(% style="width:199px" %)TOTAL|(% style="width:350px" %)((( 176 +(% style="background-color:transparent" %)en:10,es:20 177 +)))|(% style="width:320px" %)<content>|(% style="width:203px" %) 178 +|TOTAL|(% style="width:524px" %)((( 632 632 Code Item that represents a total value. If the attachment is: 633 633 634 634 * to a Code, the Annotation Text is optional and may contain an explanatory text; 635 - 636 -to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total 637 -)))|(% style="width:250px" %)((( 182 +* to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total 183 +)))|(% style="width:198px" %)((( 638 638 Either: 639 639 640 640 * a Code Item that represents a total value, or; 641 641 * a Codelist to specify the code(s) with the total 642 -)))|(% style="width:288px" %)((( 643 -<language>:<explanatory text>, 644 - 645 -<language>:<explanatory text>,… 646 -)))|(% style="width:1427px" %)((( 188 +)))|(% style="width:237px" %)((( 189 +<language>:<explanatory text>, 190 +(% style="background-color:transparent" %)<language>:<explanatory text>,… 191 +)))|(% style="width:320px" %)((( 647 647 Attached to Code Item: <blank> 648 - 649 -Attached to Codelist: <code>,<code>,… 650 -)))| 651 -|(% 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" %)((( 193 +(% style="background-color:transparent" %)Attached to Codelist: <code>,<code>,… 194 +)))|(% style="width:203px" %) 195 +|DRILLDOWN|(% style="width:524px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|(% style="width:198px" %)((( 652 652 Either: 653 653 654 654 * A Dataflow or DSD 655 -)))|(% style="width:2 88px" %) |(% style="width:1427px" %)(((199 +)))|(% style="width:237px" %) |(% style="width:320px" %)((( 656 656 <concept Id> 657 - 658 658 //Example~:// 659 - 660 -DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below) 661 -)))| 662 -|(% style="width:199px" %)DEPRECATED|(% style="width:350px" %)((( 202 +(% style="background-color:transparent" %)DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below) 203 +)))|(% style="width:203px" %) 204 +|DEPRECATED|(% style="width:524px" %)((( 663 663 Indication that an Item in an Item Scheme or an artefact is deprecated. 664 - 665 665 For an item scheme item, the annotation value provides a replacement name for the code name. 666 - 667 667 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. 668 - 669 669 Suggestion to use a controlled vocabulary 670 - 671 671 url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]> 672 672 url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]> 673 - 674 -or 675 - 676 -TITLE: true (false) 677 -)))|(% style="width:250px" %)((( 211 +or 212 +(% style="background-color:transparent" %)TITLE: true (false) 213 +)))|(% style="width:198px" %)((( 678 678 Either: 679 679 680 680 * an artefact, or; 681 681 * an item in an Item Scheme 682 -)))|(% style="width:2 88px" %)(((218 +)))|(% style="width:237px" %)((( 683 683 For item scheme item: 684 684 685 -<language>:<content>, 221 +<language>:<content>,<language>:<content>,… 686 686 687 -<language>:<content>,… 688 - 689 689 //Example~:// 690 - 691 -en:deprecated,fr:obsolète 692 -)))|(% style="width:1427px" %)<content>|((( 224 +(% style="background-color:transparent" %)en:deprecated,fr:obsolète 225 +)))|(% style="width:320px" %)<content>|(% style="width:203px" %)((( 693 693 For artefact: 694 - 695 695 <see section URL value defaults and specific locale values> 696 - 697 - 698 698 ))) 699 -|(% style="width:199px" %)DEFAULT|(% style="width:350px" %)((( 700 -Indication that an item in an Item Scheme or artefacts is to be selected by default. 229 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 230 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 231 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 232 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 233 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 234 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 235 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 236 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 237 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 238 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 239 +| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %) 701 701 702 -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 703 -)))|(% style="width:250px" %)((( 704 -* Item in ItemScheme, or; 705 -* DSD, or; 706 -* a Dataflow 241 +== Codelist and Statistical Classification-specific Annotations == 707 707 708 -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. 709 -)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 710 -Attached to: 243 +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}}. 711 711 712 -- DSD or Dataflow: 713 -**<concept>=<code>+<code>+…,<concept>=<code>+<code>+…** 714 714 715 -//Example~:// FREQ=A+Q,TIME_PERIOD_START=2013-01,TIME_PERIOD_END=2018-12 716 -)))| 717 -|(% style="width:199px" %)IMAGE|(% style="width:350px" %)A visual identity to associate to Item Scheme Items or artefacts|(% style="width:250px" %)((( 718 -Either: 719 - 720 -* an artefact, or; 721 -* an item in an item scheme 722 -)))|(% style="width:288px" %)((( 723 -For localised content in SDMX 2.1 724 - 725 -<language>:<HTML containing URL to the resource>, 726 - 727 -<language>:<HTML containing URL to the resource>,… 728 - 729 -//Example~:// 730 - 731 -en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”> 732 -)))|(% style="width:1427px" %) |((( 733 -See section URL value defaults and specific locale values. 734 - 735 -//Example~:// 736 - 737 -https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg 738 - 739 - 740 -))) 741 -|(% 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" %)((( 742 -<concept Id>,<concept Id>,… 743 - 744 -Example : 745 - 746 -DONOR,RECIPIENT,YEAR,PROJECT_ID,OBS_VALUE,DESCRIPTION,OWNER 747 -)))| 748 -|(% style="width:199px" %)NOT_DISPLAYED|(% style="width:350px" %)Used to hide components or their values in the presentation|(% style="width:250px" %)((( 749 -Either: 750 - 751 -* a Dataflow or DSD, or; 752 -* an Item in an Item Scheme 753 -)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 754 -Attached to Item in Item Scheme: <blank> 755 - 756 -Attached to Dataflow or DSD: 757 - 758 -<concept Id>,<concept Id>,… 759 - 760 -Example : 761 - 762 -DD_DIM (to hide drilldown control concept) 763 -)))| 764 -|(% style="width:199px" %)LAYOUT_ROW|(% style="width:350px" %)Dimensions to be presented in rows (concepts on y-axis)|(% style="width:250px" %)((( 765 -Either: 766 - 767 -* an artefact, or; 768 -* a Dimension 769 -)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 770 -Attached to Dimension: <blank> 771 - 772 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,… 773 - 774 -//Example~:// 775 - 776 -REF_AREA,MEASURE 777 -)))| 778 -|(% style="width:199px" %)LAYOUT_COLUMN|(% style="width:350px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:250px" %)((( 779 -Either: 780 - 781 -* an artefact, or; 782 -* a Dimension 783 -)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 784 -Attached to Dimension: <blank> 785 - 786 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,… 787 - 788 -//Example~:// 789 - 790 -TIME_PERIOD 791 -)))| 792 -|(% 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" %)((( 793 -<concept Id>,<concept Id>,... 794 - 795 -//Example~:// 796 - 797 -OBS_STATUS,CONF_STATUS 798 -)))| 799 -|(% 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" %)((( 800 -<concept Id>,<concept Id>,... 801 - 802 -//Example~:// 803 - 804 -OBS_STATUS,CONF_STATUS 805 -)))| 806 -|(% style="width:199px" %)((( 807 -METADATA 808 - 809 - 810 -)))|(% 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)| 811 -|(% 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" %)((( 812 -Either: 813 - 814 -* an artefact, or; 815 - 816 -a Dimension 817 -)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 818 -Attached to Dimension: <blank> 819 - 820 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,… 821 - 822 -//Example~:// 823 - 824 -SEX 825 -)))| 826 -|(% style="width:199px" %)EXT_RESOURCE|(% style="width:350px" %)((( 827 -A localised link to an external resource associated to the annotated artefact. For example, an ontology item 828 - 829 -//a methodology// en:<a href:"[[https:~~/~~/ec.europa.eu/eurostat/web/waste/methodology>>url:https://ec.europa.eu/eurostat/web/waste/methodology]]"> 830 -)))|(% style="width:250px" %)Any SDMX object|(% style="width:288px" %)((( 831 -For localised content in SDMX 2.1 832 - 833 - <language>:<HTML containing URL to the resource>, 834 - 835 -<language>:<HTML containing URL to the resource>,… 836 - 837 -//Example~:// 838 - 839 -en:<a href=”[[http:~~/~~/rdf-vocabulary.ddialliance.org/xkos#depth>>url:http://rdf-vocabulary.ddialliance.org/xkos#depth]]”> 840 -)))|(% style="width:1427px" %) |((( 841 -See section URL value defaults and specific locale values. 842 - 843 -//Example~:// 844 - 845 -http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth 846 -))) 847 -|(% style="width:199px" %)COMBINED_CONCEPTS|(% style="width:350px" %)((( 848 -Comma-separated list of concept IDs to show as a concatenated label. 849 - 850 -The listed concepts’ item contents may be concatenated to generate the target concept. 851 - 852 -Multiple target concept combinations can be defined by separating the target concepts by ; 853 -)))|(% style="width:250px" %)Dataflow or DSD|(% style="width:288px" %)((( 854 -<language>:<display name>, 855 - 856 -<language>:<display name> 857 - 858 -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} 859 -)))|(% style="width:1427px" %) | 860 -|(% style="width:199px" %)(deprecated) UNIT_MEASURE_CONCEPTS|(% style="width:350px" %)((( 861 -Comma-separated list of concept IDs that is used to define the full unit of measure. The concepts must be in the DSD. 862 - 863 -The listed concepts’ item contents may be concatenated to generate the unit of measure label (unless the UNIT_MEASURE_LABEL annotation is present). 864 -)))|(% style="width:250px" %)Dataflow or DSD|(% style="width:288px" %) |(% style="width:1427px" %)((( 865 -<concept Id>,<concept Id>,… 866 - 867 -//Example~:// UNIT_MEASURE,UNIT_MULT,TRANSFORMATION [could generate a value of Australian Dollar, Thousands, Non-transformed] 868 -)))| 869 -|(% style="width:199px" %)(deprecated) UNIT_MEASURE_LABEL|(% style="width:350px" %)((( 870 -Indicates the concept that enumerates the full unit of measure labels. 871 - 872 -The concept must be in the DSD. UNIT_MEASURE_LABEL overrides the UNIT_MEASURE_CONCEPTS if both are provided. 873 - 874 -Also can be attached to items in item scheme, e.g. 875 - 876 -Text en:Gram 877 - fr: Gramme 878 -url:** **[[**http:~~/~~/data.europa.eu/gzn/su/G**>>url:http://data.europa.eu/gzn/su/G]] 879 -)))|(% style="width:250px" %)Dataflow or DSD, Item in an Item Scheme|(% style="width:288px" %)((( 880 -This is optional, used if a freetext label is required. 881 - 882 -<language>:<content>, 883 - 884 -<language>:<content>,… 885 - 886 -//Example~:// 887 - 888 -en:USD, thousands 889 - 890 -fr:USD, milliers 891 -)))|(% style="width:1427px" %)((( 892 -This is optional, used if an enumerated list is required. 893 - 894 -<concept Id> 895 - 896 -//Example~:// 897 - 898 -UOM_ATTRIBUTE [This concept may contain the following items as units of measure: 899 - 900 -* National Currency, thousands 901 -* USD, thousands 902 - 903 -Index, based on National Currency] 904 -)))| 905 -|(% style="width:199px" %)((( 906 -LAYOUT_TIME_PERIOD_DESC 907 - 908 - 909 -)))|(% 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" %)((( 910 -//Example~:// 911 - 912 -LAYOUT_TIME_PERIOD_DESC 913 -)))| 914 -|(% style="width:199px" %)((( 915 -LAYOUT_CELL_ALIGN 916 - 917 - 918 -)))|(% 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" %)((( 919 -<language>:<content>, 920 - 921 -<language>:<content>,… 922 - 923 - 924 -<content> values:RIGHT or LEFT 925 -)))|(% style="width:1427px" %)Content values:RIGHT or LEFT| 926 -|(% style="width:199px" %)((( 927 -MAX_TABLE_DATA 928 - 929 - 930 -)))|(% 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" %)((( 931 -<integer> 932 - 933 -//Example~:// 934 - 935 -15000 936 -)))| 937 -|(% style="width:199px" %)((( 938 -MAXTEXTATTRIBUTELENGTH 939 - 940 - 941 -)))|(% style="width:350px" %)Increase the maximum length for textual attribute values|(% style="width:250px" %)DSD|(% style="width:288px" %) |(% style="width:1427px" %)((( 942 -<integer> 943 - 944 -//Example~:// 945 - 946 -500 947 -)))| 948 -|(% 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" %)((( 949 -<language>:<integer>,... 950 - 951 -//Example~:// 952 - 953 -"en":"3","es":"4","fr":"5" 954 -)))|(% style="width:1427px" %)((( 955 -<integer> 956 - 957 -//Example~:// 958 - 959 -10 960 -)))| 961 - 962 962 = Concept Scheme SDMX:CS_ANNOT = 963 963 964 964 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.