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
-
... ... @@ -43,7 +43,7 @@ 43 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 44 |**type**|(% style="width:823px" %)((( 45 45 Specifies how the Annotation is to be processed. 46 -The **type** is often used as the usage context of the Annotation. The types are not enumerated [[~[1~]>>path:#_ftn1]], as these can be specified by the Annotation creator. The definitions and use of Annotation types should be documented by their creator.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. 47 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 48 |**url**|(% style="width:823px" %)((( 49 49 A link to external descriptive text. ... ... @@ -124,23 +124,20 @@ 124 124 125 125 == General and Display-related Annotation types == 126 126 127 -|Annotation Type|Use Case|Where to attach|((( 127 +|(% style="width:152px" %)Annotation Type|(% style="width:559px" %)Use Case|Where to attach|((( 128 128 +Text 129 129 130 130 Blue is optional 131 131 )))|((( 132 132 Title 133 - 134 134 Blue is optional 135 135 )))|((( 136 136 SDMX 2.1:URL 137 - 138 138 SDMX >=3.0:+URL 139 - 140 140 Blue is optional 141 141 ))) 142 -|FULL_NAME|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 143 -en: A0123 Growing of citrus fruits|Item in an Item Scheme|((( 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" %)((( 144 144 <language>:<content>, 145 145 146 146 <language>:<content>,… ... ... @@ -148,28 +148,28 @@ 148 148 //Example~:// 149 149 150 150 en:Labour force (Employment) 151 -)))|<content>| 152 -|REPLACE_NAME|Replace each code name in a component by the value of another component in an observation or series|A Dataflow or DSD| |((( 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" %)((( 153 153 <component Id to replace name>:<component Id to use name> 154 154 155 155 //Example~:// 156 156 157 157 CUST_BREAKDOWN:CUST_BREAKDOWN_LB 158 -)))| 159 -|REPLACE_CONTENT|Replace the content in a component by the value of another component in an observation or series|A Dataflow or DSD| |((( 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" %)((( 160 160 <component Id to replace content>:<component Id to use content> 161 161 162 162 //Example~:// 163 163 164 164 REF_AREA:M49_CODE 165 -)))| 166 -|COMPLEMENT|((( 162 +)))|(% style="width:866px" %) 163 +|(% style="width:152px" %)COMPLEMENT|(% style="width:559px" %)((( 167 167 Additional fixed text to be displayed in parenthesis after the code name. 168 168 169 169 E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes 170 170 en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW) 171 171 en: 01 03 99 wastes not otherwise specified (NHAZW) 172 -)))|Item in an Item Scheme|((( 169 +)))|(% style="width:20px" %)Item in an Item Scheme|(% style="width:506px" %)((( 173 173 <language>:<content>, 174 174 175 175 <language>:<content>,… ... ... @@ -177,13 +177,13 @@ 177 177 //Example~:// 178 178 179 179 en:See reference metadata 180 -)))|<content>| 181 -|ORDER|Explicit indication of a localised order of items in Items Schemes or artefacts (e.g. Codelist, Concept Scheme, Category Scheme, Dataflow, etc.)|((( 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" %)((( 182 182 Either: 183 183 184 184 * an artefact, or; 185 185 * an item in an Item Scheme 186 -)))|((( 183 +)))|(% style="width:506px" %)((( 187 187 <language>:<content>, 188 188 189 189 <language>:<content>,… ... ... @@ -191,43 +191,42 @@ 191 191 //Example~:// 192 192 193 193 en:10,es:20 194 -)))|((( 191 +)))|(% style="width:178px" %)((( 195 195 <content> 196 196 197 197 198 -)))| 199 -|TOTAL|((( 195 +)))|(% style="width:866px" %) 196 +|(% style="width:152px" %)TOTAL|(% style="width:559px" %)((( 200 200 Code Item that represents a total value. If the attachment is: 201 201 202 202 * to a Code, the Annotation Text is optional and may contain an explanatory text; 203 - 204 -to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total 205 -)))|((( 200 +* to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total 201 +)))|(% style="width:20px" %)((( 206 206 Either: 207 207 208 208 * a Code Item that represents a total value, or; 209 209 * a Codelist to specify the code(s) with the total 210 -)))|((( 206 +)))|(% style="width:506px" %)((( 211 211 <language>:<explanatory text>, 212 212 213 213 <language>:<explanatory text>,… 214 -)))|((( 210 +)))|(% style="width:178px" %)((( 215 215 Attached to Code Item: <blank> 216 216 217 217 Attached to Codelist: <code>,<code>,… 218 -)))| 219 -|DRILLDOWN|Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|((( 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" %)((( 220 220 Either: 221 221 222 222 * A Dataflow or DSD 223 -)))| |((( 219 +)))|(% style="width:506px" %) |(% style="width:178px" %)((( 224 224 <concept Id> 225 225 226 226 //Example~:// 227 227 228 228 DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below) 229 -)))| 230 -|DEPRECATED|((( 225 +)))|(% style="width:866px" %) 226 +|(% style="width:152px" %)DEPRECATED|(% style="width:559px" %)((( 231 231 Indication that an Item in an Item Scheme or an artefact is deprecated. 232 232 233 233 For an item scheme item, the annotation value provides a replacement name for the code name. ... ... @@ -242,12 +242,12 @@ 242 242 or 243 243 244 244 TITLE: true (false) 245 -)))|((( 241 +)))|(% style="width:20px" %)((( 246 246 Either: 247 247 248 248 * an artefact, or; 249 249 * an item in an Item Scheme 250 -)))|((( 246 +)))|(% style="width:506px" %)((( 251 251 For item scheme item: 252 252 253 253 <language>:<content>, ... ... @@ -257,7 +257,7 @@ 257 257 //Example~:// 258 258 259 259 en:deprecated,fr:obsolète 260 -)))|<content>|((( 256 +)))|(% style="width:178px" %)<content>|(% style="width:866px" %)((( 261 261 For artefact: 262 262 263 263 <see section URL value defaults and specific locale values> ... ... @@ -264,17 +264,17 @@ 264 264 265 265 266 266 ))) 267 -|DEFAULT|((( 263 +|(% style="width:152px" %)DEFAULT|(% style="width:559px" %)((( 268 268 Indication that an item in an Item Scheme or artefacts is to be selected by default. 269 269 270 270 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 271 -)))|((( 267 +)))|(% style="width:20px" %)((( 272 272 * Item in ItemScheme, or; 273 273 * DSD, or; 274 274 * a Dataflow 275 275 276 276 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. 277 -)))| |((( 273 +)))|(% style="width:506px" %) |(% style="width:178px" %)((( 278 278 Attached to: 279 279 280 280 - DSD or Dataflow: ... ... @@ -281,13 +281,13 @@ 281 281 **<concept>=<code>+<code>+…,<concept>=<code>+<code>+…** 282 282 283 283 //Example~:// FREQ=A+Q,TIME_PERIOD_START=2013-01,TIME_PERIOD_END=2018-12 284 -)))| 285 -|IMAGE|A visual identity to associate to Item Scheme Items or artefacts|((( 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" %)((( 286 286 Either: 287 287 288 288 * an artefact, or; 289 289 * an item in an item scheme 290 -)))|((( 286 +)))|(% style="width:506px" %)((( 291 291 For localised content in SDMX 2.1 292 292 293 293 <language>:<HTML containing URL to the resource>, ... ... @@ -297,7 +297,7 @@ 297 297 //Example~:// 298 298 299 299 en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”> 300 -)))| |((( 296 +)))|(% style="width:178px" %) |(% style="width:866px" %)((( 301 301 See section URL value defaults and specific locale values. 302 302 303 303 //Example~:// ... ... @@ -306,19 +306,19 @@ 306 306 307 307 308 308 ))) 309 -|DRILLDOWN_CONCEPTS|Concepts to be displayed in a drilldown operation|Dataflow or DSD| |((( 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" %)((( 310 310 <concept Id>,<concept Id>,… 311 311 312 312 Example : 313 313 314 314 DONOR,RECIPIENT,YEAR,PROJECT_ID,OBS_VALUE,DESCRIPTION,OWNER 315 -)))| 316 -|NOT_DISPLAYED|Used to hide components or their values in the presentation|((( 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" %)((( 317 317 Either: 318 318 319 319 * a Dataflow or DSD, or; 320 320 * an Item in an Item Scheme 321 -)))| |((( 317 +)))|(% style="width:506px" %) |(% style="width:178px" %)((( 322 322 Attached to Item in Item Scheme: <blank> 323 323 324 324 Attached to Dataflow or DSD: ... ... @@ -328,13 +328,13 @@ 328 328 Example : 329 329 330 330 DD_DIM (to hide drilldown control concept) 331 -)))| 332 -|LAYOUT_ROW|Dimensions to be presented in rows (concepts on y-axis)|((( 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" %)((( 333 333 Either: 334 334 335 335 * an artefact, or; 336 336 * a Dimension 337 -)))| |((( 333 +)))|(% style="width:506px" %) |(% style="width:178px" %)((( 338 338 Attached to Dimension: <blank> 339 339 340 340 Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,… ... ... @@ -342,13 +342,13 @@ 342 342 //Example~:// 343 343 344 344 REF_AREA,MEASURE 345 -)))| 346 -|LAYOUT_COLUMN|Dimensions to be presented in columns (concepts on x-axis)|((( 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" %)((( 347 347 Either: 348 348 349 349 * an artefact, or; 350 350 * a Dimension 351 -)))| |((( 347 +)))|(% style="width:506px" %) |(% style="width:178px" %)((( 352 352 Attached to Dimension: <blank> 353 353 354 354 Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,… ... ... @@ -356,33 +356,33 @@ 356 356 //Example~:// 357 357 358 358 TIME_PERIOD 359 -)))| 360 -|LAYOUT_FLAG|Indication that an attribute and its attribute value should be presented as a flag|Dataflow| |((( 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" %)((( 361 361 <concept Id>,<concept Id>,... 362 362 363 363 //Example~:// 364 364 365 365 OBS_STATUS,CONF_STATUS 366 -)))| 367 -|LAYOUT_NOTE|Indication that an attribute and its attribute value should be presented as a note|Dataflow| |((( 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" %)((( 368 368 <concept Id>,<concept Id>,... 369 369 370 370 //Example~:// 371 371 372 372 OBS_STATUS,CONF_STATUS 373 -)))| 374 -|((( 369 +)))|(% style="width:866px" %) 370 +|(% style="width:152px" %)((( 375 375 METADATA 376 376 377 377 378 -)))|Links an MSD directly to a DSD. Can be used to overcome the complexities of reference metadata linkage|DSD| |MSD URI, e.g. urn:sdmx:org.sdmx.infomodel.metadatastructure.MetadataStructure=OECD:MSD_REF_METADATA(1.0)| 379 -|LAYOUT_ROW_SECTION|Dimension to be presented as a break-down concept at a third hierarchical level above columns and rows.|((( 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" %)((( 380 380 Either: 381 381 382 382 * an artefact, or; 383 383 384 384 a Dimension 385 -)))| |((( 381 +)))|(% style="width:506px" %) |(% style="width:178px" %)((( 386 386 Attached to Dimension: <blank> 387 387 388 388 Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,… ... ... @@ -390,12 +390,12 @@ 390 390 //Example~:// 391 391 392 392 SEX 393 -)))| 394 -|EXT_RESOURCE|((( 389 +)))|(% style="width:866px" %) 390 +|(% style="width:152px" %)EXT_RESOURCE|(% style="width:559px" %)((( 395 395 A localised link to an external resource associated to the annotated artefact. For example, an ontology item 396 396 397 397 //a methodology// en:<a href:"[[https:~~/~~/ec.europa.eu/eurostat/web/waste/methodology>>url:https://ec.europa.eu/eurostat/web/waste/methodology]]"> 398 -)))|Any SDMX object|((( 394 +)))|(% style="width:20px" %)Any SDMX object|(% style="width:506px" %)((( 399 399 For localised content in SDMX 2.1 400 400 401 401 <language>:<HTML containing URL to the resource>, ... ... @@ -405,7 +405,7 @@ 405 405 //Example~:// 406 406 407 407 en:<a href=”[[http:~~/~~/rdf-vocabulary.ddialliance.org/xkos#depth>>url:http://rdf-vocabulary.ddialliance.org/xkos#depth]]”> 408 -)))| |((( 404 +)))|(% style="width:178px" %) |(% style="width:866px" %)((( 409 409 See section URL value defaults and specific locale values. 410 410 411 411 //Example~:// ... ... @@ -412,29 +412,29 @@ 412 412 413 413 http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth 414 414 ))) 415 -|COMBINED_CONCEPTS|((( 411 +|(% style="width:152px" %)COMBINED_CONCEPTS|(% style="width:559px" %)((( 416 416 Comma-separated list of concept IDs to show as a concatenated label. 417 417 418 418 The listed concepts’ item contents may be concatenated to generate the target concept. 419 419 420 420 Multiple target concept combinations can be defined by separating the target concepts by ; 421 -)))|Dataflow or DSD|((( 417 +)))|(% style="width:20px" %)Dataflow or DSD|(% style="width:506px" %)((( 422 422 <language>:<display name>, 423 423 424 424 <language>:<display name> 425 425 426 426 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} 427 -)))| | 428 -|(deprecated) UNIT_MEASURE_CONCEPTS|((( 423 +)))|(% style="width:178px" %) |(% style="width:866px" %) 424 +|(% style="width:152px" %)(deprecated) UNIT_MEASURE_CONCEPTS|(% style="width:559px" %)((( 429 429 Comma-separated list of concept IDs that is used to define the full unit of measure. The concepts must be in the DSD. 430 430 431 431 The listed concepts’ item contents may be concatenated to generate the unit of measure label (unless the UNIT_MEASURE_LABEL annotation is present). 432 -)))|Dataflow or DSD| |((( 428 +)))|(% style="width:20px" %)Dataflow or DSD|(% style="width:506px" %) |(% style="width:178px" %)((( 433 433 <concept Id>,<concept Id>,… 434 434 435 435 //Example~:// UNIT_MEASURE,UNIT_MULT,TRANSFORMATION [could generate a value of Australian Dollar, Thousands, Non-transformed] 436 -)))| 437 -|(deprecated) UNIT_MEASURE_LABEL|((( 432 +)))|(% style="width:866px" %) 433 +|(% style="width:152px" %)(deprecated) UNIT_MEASURE_LABEL|(% style="width:559px" %)((( 438 438 Indicates the concept that enumerates the full unit of measure labels. 439 439 440 440 The concept must be in the DSD. UNIT_MEASURE_LABEL overrides the UNIT_MEASURE_CONCEPTS if both are provided. ... ... @@ -444,7 +444,7 @@ 444 444 Text en:Gram 445 445 fr: Gramme 446 446 url:** **[[**http:~~/~~/data.europa.eu/gzn/su/G**>>url:http://data.europa.eu/gzn/su/G]] 447 -)))|Dataflow or DSD, Item in an Item Scheme|((( 443 +)))|(% style="width:20px" %)Dataflow or DSD, Item in an Item Scheme|(% style="width:506px" %)((( 448 448 This is optional, used if a freetext label is required. 449 449 450 450 <language>:<content>, ... ... @@ -456,7 +456,7 @@ 456 456 en:USD, thousands 457 457 458 458 fr:USD, milliers 459 -)))|((( 455 +)))|(% style="width:178px" %)((( 460 460 This is optional, used if an enumerated list is required. 461 461 462 462 <concept Id> ... ... @@ -469,21 +469,21 @@ 469 469 * USD, thousands 470 470 471 471 Index, based on National Currency] 472 -)))| 473 -|((( 468 +)))|(% style="width:866px" %) 469 +|(% style="width:152px" %)((( 474 474 LAYOUT_TIME_PERIOD_DESC 475 475 476 476 477 -)))|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.|Dataflow, DSD| |((( 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" %)((( 478 478 //Example~:// 479 479 480 480 LAYOUT_TIME_PERIOD_DESC 481 -)))| 482 -|((( 477 +)))|(% style="width:866px" %) 478 +|(% style="width:152px" %)((( 483 483 LAYOUT_CELL_ALIGN 484 484 485 485 486 -)))|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.|Dataflow, DSD, Dimension|((( 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" %)((( 487 487 <language>:<content>, 488 488 489 489 <language>:<content>,… ... ... @@ -490,235 +490,467 @@ 490 490 491 491 492 492 <content> values:RIGHT or LEFT 493 -)))|Content values:RIGHT or LEFT| 494 -|((( 489 +)))|(% style="width:178px" %)Content values:RIGHT or LEFT|(% style="width:866px" %) 490 +|(% style="width:152px" %)((( 495 495 MAX_TABLE_DATA 496 496 497 497 498 -)))|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|Dataflow| |((( 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" %)((( 499 499 <integer> 500 500 501 501 //Example~:// 502 502 503 503 15000 504 -)))| 505 -|((( 500 +)))|(% style="width:866px" %) 501 +|(% style="width:152px" %)((( 506 506 MAXTEXTATTRIBUTELENGTH 507 507 508 508 509 -)))|Increase the maximum length for textual attribute values|DSD| |((( 505 +)))|(% style="width:559px" %)Increase the maximum length for textual attribute values|(% style="width:20px" %)DSD|(% style="width:506px" %) |(% style="width:178px" %)((( 510 510 <integer> 511 511 512 512 //Example~:// 513 513 514 514 500 515 -)))| 516 -|SEARCH_WEIGHT|Indication of localised boosted dataflows in the search results when ordered by relevance|Dataflow|((( 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" %)((( 517 517 <language>:<integer>,... 518 518 519 519 //Example~:// 520 520 521 521 "en":"3","es":"4","fr":"5" 522 -)))|((( 518 +)))|(% style="width:178px" %)((( 523 523 <integer> 524 524 525 525 //Example~:// 526 526 527 527 10 528 -)))| 524 +)))|(% style="width:866px" %) 529 529 530 530 == Codelist and Statistical Classification-specific Annotations == 531 531 532 -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 [[~[2~]>>path:#_ftn2]]and CPC[[~[3~]>>path:#_ftn3]].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}}. 533 533 534 -|Annotation Type|Use Case|Where to attach|((( 535 -+Text 536 536 537 - Blue isoptional538 - )))|(((539 - Title540 - 541 - Blueis optional542 -) ))|(((543 - SDMX2.1:URL544 - 531 +|**Annotation Type**|(% style="width:524px" %)**Use Case**|(% style="width:198px" %)**Where to attach**|(% style="width:237px" %)((( 532 +**+Text 533 +(% style="background-color:transparent" %)Blue is optional(%%)** 534 +)))|(% style="width:320px" %)((( 535 +**Title 536 +(% style="background-color:transparent" %)Blue is optional(%%)** 537 +)))|(% style="width:203px" %)((( 538 +**SDMX 2.1:URL 545 545 SDMX >=3.0:+URL 546 - 547 -Blue is optional 540 +(% style="background-color:transparent" %)Blue is optional(%%)** 548 548 ))) 549 -|ORIGINAL_CODE|Code as displayed in other representations, such as official or original documentation (i.e. possibly containing dots, spaces, etc.). Reference to external standard: skos:notation|Item in an Item Scheme| |((( 550 -<original code> 542 +|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 543 +en: A0123 Growing of citrus fruits|(% style="width:198px" %)Item in an Item Scheme|(% style="width:237px" %)((( 544 +<language>:<content>,<language>:<content>,… 545 +//Example~:// 546 +(% style="background-color:transparent" %)en:Labour force (Employment) 547 +)))|(% style="width:320px" %)<content>|(% style="width:203px" %) 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:320px" %)((( 549 +<component Id to replace name>:<component Id to use name> 550 +//Example~:// 551 +(% style="background-color:transparent" %)CUST_BREAKDOWN:CUST_BREAKDOWN_LB 552 +)))|(% style="width:203px" %) 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:320px" %)((( 554 +<component Id to replace content>:<component Id to use content> 555 +//Example~:// 556 +(% style="background-color:transparent" %)REF_AREA:M49_CODE 557 +)))|(% style="width:203px" %) 558 +|COMPLEMENT|(% style="width:524px" %)((( 559 +Additional fixed text to be displayed in parenthesis after the code name. 560 +(% style="background-color:transparent" %)E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes(%%) 561 +(% style="background-color:transparent" %)en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)(%%) 562 +(% style="background-color:transparent" %)en: 01 03 99 wastes not otherwise specified (NHAZW) 563 +)))|(% style="width:198px" %)Item in an Item Scheme|(% style="width:237px" %)((( 564 +<language>:<content>,<language>:<content>,… 551 551 552 -//Examples~:// 566 +//Example~:// 567 +(% style="background-color:transparent" %)en:See reference metadata 568 +)))|(% style="width:320px" %)<content>|(% style="width:203px" %) 569 +|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" %)((( 570 +Either: 553 553 554 -* 0105.13 [Harmonized System] 555 -* 11.2.0.9 [COICOP classification] 556 -)))| 557 -|HIER_CONTEXT|((( 558 -In SDMX 2.1, a reference between a usage context and a hierarchy (that may be contained in a Hierarchical Codelist (HCL)). 572 +* an artefact, or; 573 +* an item in an Item Scheme 574 +)))|(% style="width:237px" %)((( 575 +<language>:<content>,<language>:<content>,… 559 559 560 -In SDMX 3.0, use the HierarchyAssociation artefact 561 -)))|DSD or Dataflow| |((( 562 -<component Id>:<HCL Id>.<hierarchy Id> 563 - 564 564 //Example~:// 578 +(% style="background-color:transparent" %)en:10,es:20 579 +)))|(% style="width:320px" %)<content>|(% style="width:203px" %) 580 +|TOTAL|(% style="width:524px" %)((( 581 +Code Item that represents a total value. If the attachment is: 565 565 566 - REF_AREA:OECD.EDU:HCL_REF_AREA(1.0).REF_AREAprovidesthelinktothereferenceareahierarchyforOECDeducationdata567 -) ))|568 -| HIER_LEVEL|(((569 -E xplicitspecification of thehierarchical level of a code item583 +* to a Code, the Annotation Text is optional and may contain an explanatory text; 584 +* to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total 585 +)))|(% style="width:198px" %)((( 586 +Either: 570 570 571 -Reference to external standard: xkos:ClassificationLevel - property: xkos:xdepth url: [[http:~~/~~/data.europa.eu/ux2/nace2.1/sections>>url:http://data.europa.eu/ux2/nace2.1/sections]] 588 +* a Code Item that represents a total value, or; 589 +* a Codelist to specify the code(s) with the total 590 +)))|(% style="width:237px" %)((( 591 +<language>:<explanatory text>, 592 +(% style="background-color:transparent" %)<language>:<explanatory text>,… 593 +)))|(% style="width:320px" %)((( 594 +Attached to Code Item: <blank> 595 +(% style="background-color:transparent" %)Attached to Codelist: <code>,<code>,… 596 +)))|(% style="width:203px" %) 597 +|DRILLDOWN|(% style="width:524px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|(% style="width:198px" %)((( 598 +Either: 572 572 573 -text en:sections 574 -)))|Code item| |((( 575 -<hierarchical level> 600 +* A Dataflow or DSD 601 +)))|(% style="width:237px" %) |(% style="width:320px" %)((( 602 +<concept Id> 603 +//Example~:// 604 +(% style="background-color:transparent" %)DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below) 605 +)))|(% style="width:203px" %) 606 +|DEPRECATED|(% style="width:524px" %)((( 607 +Indication that an Item in an Item Scheme or an artefact is deprecated. 608 +For an item scheme item, the annotation value provides a replacement name for the code name. 609 +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. 610 +Suggestion to use a controlled vocabulary 611 +url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]> 612 +url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]> 613 +or 614 +(% style="background-color:transparent" %)TITLE: true (false) 615 +)))|(% style="width:198px" %)((( 616 +Either: 576 576 618 +* an artefact, or; 619 +* an item in an Item Scheme 620 +)))|(% style="width:237px" %)((( 621 +For item scheme item: 622 + 623 +<language>:<content>,<language>:<content>,… 624 + 577 577 //Example~:// 626 +(% style="background-color:transparent" %)en:deprecated,fr:obsolète 627 +)))|(% style="width:320px" %)<content>|(% style="width:203px" %)((( 628 +For artefact: 629 +<see section URL value defaults and specific locale values> 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" %) 578 578 579 -1 580 -)))| 581 -|SHORT_LABEL|A short label, typically for dissemination purposes where long labels are sometimes not appropriate for presentation in tables where space is an important parameter (generally less than 40 or 50 characters)|Artefact, or Concept, or Item in an Item Scheme|((( 582 -<language>:<content>, 583 583 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>, 584 584 <language>:<content>,… 585 -)))|((( 586 586 //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> 587 587 588 - [Official French label “Transformation et conservation dela viandede boucherie” is shortened to] fr:Transf. & conserv. viande de boucherie655 +//Example~:// 589 589 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> 590 590 591 -In Codelist=IMF:CL_AREA(1.13) 592 -Code 4J837 European Union Intellectual Property Office has a Short_Label 662 +//Example~:// 593 593 594 -E N:EUIPO664 +REF_AREA:M49_CODE 595 595 )))| 596 -|EXPLAN_LABEL|An explanatory text that specifies “other” and similar categories. An example is the Combined Nomenclature classification where the many codes labelled “other” are complemented by a verbose text describing in detail the content of the code item|Item in an Item Scheme, mapping to Representation Maps|((( 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" %)((( 597 597 <language>:<content>, 598 598 599 599 <language>:<content>,… 600 - )))|(((676 + 601 601 //Example~:// 602 602 603 -[EU Combined Nomenclature official label for code 3824 99 57 reads “Other”, which is not very informative for the user; instead the EXPLAN_LABEL reads] en:Cartridges and refills, filled, for electronic cigarettes, and preparations for use in the cartridges and refills, not containing nicotine or its salts, ethers, esters or other derivatives thereof 604 -)))| 605 -|EXPLAN_CONSOL|Explanatory notes. An explanatory text to be used when objects included in and excluded from a classification position are consolidated, i.e. are presented together. Reference to external standard: skos:scopeNote|Item in an Item Scheme, mapping to Representation Maps|((( 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" %)((( 606 606 <language>:<content>, 607 607 608 608 <language>:<content>,… 609 -)))|((( 610 -Example (from the US NAICS classification): 611 611 612 -en:Industries in the Food Manufacturing subsector transform livestock and agricultural products into products for intermediate or final consumption. […] The food products manufactured in these establishments are typically sold to wholesalers or retailers for distribution to consumers, but establishments primarily engaged in retailing bakery and candy products made on the premises not for immediate consumption are included. Establishments primarily engaged in manufacturing beverages are classified in Subsector 312, Beverage and Tobacco Product Manufacturing. 691 +//Example~:// 692 + 693 +en:10,es:20 694 +)))|(% style="width:1427px" %)((( 695 +<content> 696 + 697 + 613 613 )))| 614 -| EXPLAN_INCLUDES|Explanatorynotes. Description of those things known specificallyto be includedinthe concept. Synonyms Typical labels for such explanatory notes:"Thisclass includes", "Thiscategoryincludes", "This position includes", "Includes", etc. Reference to external standard:xkos:inclusionNoteor xkos:coreContentNote (if EXPLAN_INCLUDES_ALSO available)|Item in an Item Scheme, mapping to Representation Maps|(((615 - <language>:<content>,699 +|(% style="width:199px" %)TOTAL|(% style="width:350px" %)((( 700 +Code Item that represents a total value. If the attachment is: 616 616 617 -<language>:<content>,… 618 -)))|((( 619 -Example (from ISIC Rev. 4 explanatory notes to code 2520 - Manufacture of weapons and ammunition): 702 +* to a Code, the Annotation Text is optional and may contain an explanatory text; 620 620 621 -en: This class includes: 704 +to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total 705 +)))|(% style="width:250px" %)((( 706 +Either: 622 622 623 -* manufacture of heavy weapons (artillery, mobile guns, rocket launchers, torpedo tubes, heavy machine guns) 624 -* manufacture of small arms (revolvers, shotguns, light machine guns) 625 -* manufacture of air or gas guns and pistols 626 -* manufacture of war ammunition 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>,… 627 627 )))| 628 -| EXPLAN_CASELAW|Explanatorynotes. Indication thatadecision onthe classificationhasbeenmadebythead hocCommittee (conceptgenerallydescribed as “ruling”, “classification opinion”, classification decision;caselaw). : Referenceto external standardxkos:caseLaw. Thedifferencebetween caselaws and traditional explanatory notesis that caselaws are adoptedduringthetime period betweentwo officialversionsofaspecific classification andhave thus a slightlydifferentstatus (e.g. from alegal viewpoint)|Item in an Item Scheme|(((629 - <language>:<content>,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: 630 630 631 -<language>:<content>,… 722 +* A Dataflow or DSD 723 +)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 724 +<concept Id> 632 632 633 -Example (from NACE Rev. 2 caselaw to code 01.62):726 +//Example~:// 634 634 635 -en:Automated egg hatching for poultry - Operation of livestock management systems] 636 -)))| | 637 -|EXPLAN_INCLUDES_ALSO|Explanatory notes. Description of those things which can be considered as borderline cases and are generally based on consensus rather than strict methodological principles (e.g. classifying wooden shoes as handicraft rather than shoes). Typical labels for such explanatory notes: "This class includes also", "This category includes also", "This position includes also ", "Includes also", etc. Reference to external standard: xkos:additionalContentNote|Item in an Item Scheme|((( 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 + 638 638 <language>:<content>, 639 639 640 640 <language>:<content>,… 641 -)))|((( 642 -Example (from ISIC Rev. 4 explanatory notes to code 2520 - Manufacture of weapons and ammunition): 643 643 644 - en:This class also includes:757 +//Example~:// 645 645 646 -* manufacture of hunting, sporting or protective firearms and ammunition 647 -* manufacture of explosive devices such as bombs, mines and torpedoes 648 -)))| 649 -|EXPLAN_EXCLUDES|Explanatory notes. Description of those things which are explicitly excluded from a category. Typical labels for such explanatory notes: "This class excludes", "This category excludes", "This position excludes", "Excludes", etc. Reference to external standards: xkos:exclusionNote|((( 650 -Item in an Item Scheme 759 +en:deprecated,fr:obsolète 760 +)))|(% style="width:1427px" %)<content>|((( 761 +For artefact: 651 651 763 +<see section URL value defaults and specific locale values> 764 + 652 652 653 -)))|((( 654 -<language>:<content>, 766 +))) 767 +|(% style="width:199px" %)DEFAULT|(% style="width:350px" %)((( 768 +Indication that an item in an Item Scheme or artefacts is to be selected by default. 655 655 656 -<language>:<content>,… 657 -)))|((( 658 -Example (from ISIC Rev. 4 explanatory notes to code 2520 - Manufacture of weapons and ammunition): 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" %)((( 772 +* Item in ItemScheme, or; 773 +* DSD, or; 774 +* a Dataflow 659 659 660 -en:This class excludes: 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" %)((( 778 +Attached to: 661 661 662 -* manufacture of percussion caps, detonators or signalling flares, see 2029 663 -* manufacture of cutlasses, swords, bayonets etc., see 2593 780 +- DSD or Dataflow: 781 +**<concept>=<code>+<code>+…,<concept>=<code>+<code>+…** 782 + 783 +//Example~:// FREQ=A+Q,TIME_PERIOD_START=2013-01,TIME_PERIOD_END=2018-12 664 664 )))| 665 -|MAP_REFER|A reference to a classification mapping or transformation, e.g. an SDMX Structure Map. Reference to external standard: skos:mappingRelation (skos:broadMatch, skos:narrowMatch, skos:closeMatch, skos:exactMatch or skos:relatedMatch)|Codelist, Concept Scheme, or another Item Scheme| |Id of an ItemSchemeMap returned by the Annotation URL|((( 785 +|(% style="width:199px" %)IMAGE|(% style="width:350px" %)A visual identity to associate to Item Scheme Items or artefacts|(% style="width:250px" %)((( 786 +Either: 787 + 788 +* an artefact, or; 789 +* an item in an item scheme 790 +)))|(% style="width:288px" %)((( 791 +For localised content in SDMX 2.1 792 + 793 +<language>:<HTML containing URL to the resource>, 794 + 795 +<language>:<HTML containing URL to the resource>,… 796 + 797 +//Example~:// 798 + 799 +en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”> 800 +)))|(% style="width:1427px" %) |((( 666 666 See section URL value defaults and specific locale values. 667 667 803 +//Example~:// 804 + 805 +https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg 806 + 668 668 669 669 ))) 670 -| COMP_RULE|Codeitem compositionrule.Forexample, for codeAthecompositionrulemay be “A1+A2”where A1 andA2 areothercodesinthesameCodelist|AnItemin an Item Scheme||(((671 -<con tent>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" %)((( 810 +<concept Id>,<concept Id>,… 672 672 812 +Example : 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" %)((( 817 +Either: 818 + 819 +* a Dataflow or DSD, or; 820 +* an Item in an Item Scheme 821 +)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 822 +Attached to Item in Item Scheme: <blank> 823 + 824 +Attached to Dataflow or DSD: 825 + 826 +<concept Id>,<concept Id>,… 827 + 828 +Example : 829 + 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" %)((( 833 +Either: 834 + 835 +* an artefact, or; 836 +* a Dimension 837 +)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 838 +Attached to Dimension: <blank> 839 + 840 +Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,… 841 + 673 673 //Example~:// 674 674 675 -A 1+A2844 +REF_AREA,MEASURE 676 676 )))| 677 -| FOLLOWS|(((678 - A reference used to express the succession intime of Item Schemes.846 +|(% style="width:199px" %)LAYOUT_COLUMN|(% style="width:350px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:250px" %)((( 847 +Either: 679 679 680 -For example, NACE Rev. 2 is the successor of NACE Rev. 1.1 849 +* an artefact, or; 850 +* a Dimension 851 +)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 852 +Attached to Dimension: <blank> 681 681 682 -Reference to external standard: skos:ConceptScheme - property: xkos:follows 683 -)))|Codelist or Item Scheme| | |((( 684 -See section URL value defaults and specific locale values. 854 +Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,… 685 685 686 686 //Example~:// 687 687 688 -(CL_REGIONAL 3.1.1 follows CL_REGIONAL 3.1): 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" %)((( 861 +<concept Id>,<concept Id>,... 689 689 690 -[[https:~~/~~/registry.sdmx.org/ws/public/sdmxapi/rest/codelist/ESTAT/CL_REGIONAL/3.1>>url:https://registry.sdmx.org/ws/public/sdmxapi/rest/codelist/ESTAT/CL_REGIONAL/3.1]] 691 -))) 692 -|HAS_VARIANT|((( 693 -A reference used to express the relation between an Item Scheme and its variant(s). 863 +//Example~:// 694 694 695 -Reference to external standard: skos:ConceptScheme - property: xkos:variant 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" %)((( 868 +<concept Id>,<concept Id>,... 696 696 870 +//Example~:// 697 697 698 -For //Example~:// CL_AREA has a variant CL_GEO 699 -)))|Codelist or Item Scheme| | |((( 700 -See section URL value defaults and specific locale values. 872 +OBS_STATUS,CONF_STATUS 873 +)))| 874 +|(% style="width:199px" %)((( 875 +METADATA 701 701 702 702 703 -))) 704 -| SUPERSEED|(((705 - A reference to a previous version, ifthecurrent version obsoleted the previous one.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" %)((( 880 +Either: 706 706 707 - Maybe used in conjunctionwith DEPRECATED.882 +* an artefact, or; 708 708 709 -Reference to external standard: skos:ConceptScheme - property: xkos:supersedes 710 -)))|Codelist or Item Scheme, or an artefact| | |((( 884 +a Dimension 885 +)))|(% style="width:288px" %) |(% style="width:1427px" %)((( 886 +Attached to Dimension: <blank> 887 + 888 +Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,… 889 + 890 +//Example~:// 891 + 892 +SEX 893 +)))| 894 +|(% style="width:199px" %)EXT_RESOURCE|(% style="width:350px" %)((( 895 +A localised link to an external resource associated to the annotated artefact. For example, an ontology item 896 + 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" %)((( 899 +For localised content in SDMX 2.1 900 + 901 + <language>:<HTML containing URL to the resource>, 902 + 903 +<language>:<HTML containing URL to the resource>,… 904 + 905 +//Example~:// 906 + 907 +en:<a href=”[[http:~~/~~/rdf-vocabulary.ddialliance.org/xkos#depth>>url:http://rdf-vocabulary.ddialliance.org/xkos#depth]]”> 908 +)))|(% style="width:1427px" %) |((( 711 711 See section URL value defaults and specific locale values. 712 712 713 - 911 +//Example~:// 912 + 913 +http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth 714 714 ))) 715 -| FAMILY_LABEL|(((716 - Label of theClassificationFamily(e.g. NACE, ISIC)915 +|(% style="width:199px" %)COMBINED_CONCEPTS|(% style="width:350px" %)((( 916 +Comma-separated list of concept IDs to show as a concatenated label. 717 717 718 - Referencetoexternalstandard:skos:ConceptScheme- property: xkos:belongsTo918 +The listed concepts’ item contents may be concatenated to generate the target concept. 719 719 720 -label of the classification 721 -)))|Codelist or Item Scheme|((( 920 +Multiple target concept combinations can be defined by separating the target concepts by ; 921 +)))|(% style="width:250px" %)Dataflow or DSD|(% style="width:288px" %)((( 922 +<language>:<display name>, 923 + 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 + 722 722 <language>:<content>, 723 723 724 724 <language>:<content>,… ... ... @@ -725,65 +725,91 @@ 725 725 726 726 //Example~:// 727 727 728 -en:NACE 729 -)))| |((( 730 -See section URL value defaults and specific locale values. 956 +en:USD, thousands 731 731 732 - 733 -))) 734 -|COVERAGE_LABEL|((( 735 -Label(s) of the item scheme’s coverage (e.g. National Accounts, Products, Activities, Occupations) 958 +fr:USD, milliers 959 +)))|(% style="width:1427px" %)((( 960 +This is optional, used if an enumerated list is required. 736 736 737 - Reference toexternal standard: skos:ConceptScheme- property: xkos:covers962 +<concept Id> 738 738 739 -//Example s~://964 +//Example~:// 740 740 741 -UR L<http:~/~/eurovoc.europa.eu/56>(National accounts)966 +UOM_ATTRIBUTE [This concept may contain the following items as units of measure: 742 742 743 -URL <http:~/~/publications.europa.eu/resource/authority/data-theme/REGI> (Regions and Cities) 744 -)))|Codelist or Item Scheme|((( 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 + 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 + 980 +LAYOUT_TIME_PERIOD_DESC 981 +)))| 982 +|(% style="width:199px" %)((( 983 +LAYOUT_CELL_ALIGN 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" %)((( 745 745 <language>:<content>, 746 746 747 747 <language>:<content>,… 748 748 749 -//Example~:// 750 750 751 -En:national accounts 752 -)))| |((( 753 -See section URL value defaults and specific locale values. 992 +<content> values:RIGHT or LEFT 993 +)))|(% style="width:1427px" %)Content values:RIGHT or LEFT| 994 +|(% style="width:199px" %)((( 995 +MAX_TABLE_DATA 754 754 755 755 756 -))) 757 -|GEO_FEATURE_SET|((( 758 -In Codelists, transmits GeoFeature values. 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> 759 759 760 -Example for NUTS ID BE23 761 -url:[[http:~~/~~/data.europa.eu/nuts/geometry/2xr1qiv9>>url:http://data.europa.eu/nuts/geometry/2xr1qiv9]] 762 -)))|Code in a Codelist. The Codelist must have an annotation attached with AnnotationType=GEO_TYPE_GEOGRAPHIC| |A set of points defining a feature following the 1363 ISO/IEC 13249-3:2016 standard to conform Well-known Text (WKT) for the 1364 representation of geometries. See SDMX STANDARDS: SECTION 6 for further information on the format.| 763 -|GEO_TYPE_GEOGRAPHIC|Indicates that a codelist contains GeoFeature values via the GEO_FEATURE_SET annotation.|Codelist| | | 764 -|LEGAL_BASIS|((( 765 -Indicates that the Legislation on which the codelist/nomenclature is based. 1001 +//Example~:// 766 766 767 -Example for NACE Rev.2.1 1003 +15000 1004 +)))| 1005 +|(% style="width:199px" %)((( 1006 +MAXTEXTATTRIBUTELENGTH 768 768 769 -url: [[http:~~/~~/data.europa.eu/eli/reg_del/2023/137/oj>>url:http://data.europa.eu/eli/reg_del/2023/137/oj]] 770 -)))|Codelist| | |http:~/~/data.europa.eu/eli/reg_del/2023/137/oj 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> 771 771 1012 +//Example~:// 772 772 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>,... 773 773 1019 +//Example~:// 774 774 1021 +"en":"3","es":"4","fr":"5" 1022 +)))|(% style="width:1427px" %)((( 1023 +<integer> 775 775 1025 +//Example~:// 1026 + 1027 +10 1028 +)))| 1029 + 776 776 = Concept Scheme SDMX:CS_ANNOT = 777 777 778 778 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. 779 779 780 -|**Property**|**Representation in Concept**|**Description** 781 -|**Code**|Concept Id|The Annotation Type column, e.g. NOT_DISPLAYED, EXCLUDES 782 -|**Name**|Concept Name|Short description of the standard Annotation derived from the “Use case” column 783 -|**Representation**|Concept Core Representation|Allowable type or format for the Annotation 784 -|**Description**|Concept Description|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 785 -|**Artefact(s)**|Annotation Type: Artefact(s)|The information in the “Where to attach” column 786 -|**URL**|Annotation Type: URL|The Annotation URL column. The value is in URL 1034 +|**Property**|(% style="width:309px" %)**Representation in Concept**|(% style="width:1173px" %)**Description** 1035 +|**Code**|(% style="width:309px" %)Concept Id|(% style="width:1173px" %)The Annotation Type column, e.g. NOT_DISPLAYED, EXCLUDES 1036 +|**Name**|(% style="width:309px" %)Concept Name|(% style="width:1173px" %)Short description of the standard Annotation derived from the “Use case” column 1037 +|**Representation**|(% style="width:309px" %)Concept Core Representation|(% style="width:1173px" %)Allowable type or format for the Annotation 1038 +|**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 1039 +|**Artefact(s)**|(% style="width:309px" %)Annotation Type: Artefact(s)|(% style="width:1173px" %)The information in the “Where to attach” column 1040 +|**URL**|(% style="width:309px" %)Annotation Type: URL|(% style="width:1173px" %)The Annotation URL column. The value is in URL 787 787 788 788 == Example of a Concept == 789 789 ... ... @@ -793,8 +793,6 @@ 793 793 |**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 794 794 |**Concept: Annotation: Type: Artefact(s)**|Either a Dataflow or DSD, or an item in an item scheme 795 795 796 -=== === 797 - 798 798 === SDMX-ML of the Example === 799 799 800 800 <str:Concept id="NOT_DISPLAYED"> ... ... @@ -822,8 +822,4 @@ 822 822 823 823 ---- 824 824 825 -[[~[1~]>>path:#_ftnref1]] The technical standard does not enumerate the annotation types, however this guideline provides a recommended enumeration or controlled vocabulary 826 - 827 -[[~[2~]>>path:#_ftnref2]] International Standard Industrial Classification of All Economic Activities 828 - 829 -[[~[3~]>>path:#_ftnref3]] Central Product Classification 1077 +{{putFootnotes/}}