Last modified by Artur K. on 2026/05/29 14:28

From version 1.7
edited by Helena K.
on 2026/01/15 23:25
Change comment: There is no comment for this version
To version 2.1
edited by Helena K.
on 2026/01/16 00:05
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -124,341 +124,288 @@
124 124  
125 125  == General and Display-related Annotation types ==
126 126  
127 -|(% style="width:152px" %)Annotation Type|(% style="width:559px" %)Use Case|Where to attach|(((
128 -+Text
129 -
130 -Blue is optional
131 -)))|(((
132 -Title
133 -Blue is optional
134 -)))|(((
135 -SDMX 2.1:URL
127 +(% style="width:1790.2px" %)
128 +|(% style="width:243px" %)**Annotation Type**|(% style="width:442px" %)**Use Case**|(% style="width:246px" %)**Where to attach**|(% style="width:289px" %)(((
129 +**+Text
130 +(% style="background-color:transparent" %)Blue is optional(%%)**
131 +)))|(% style="width:321px" %)(((
132 +**Title
133 +(% style="background-color:transparent" %)Blue is optional(%%)**
134 +)))|(% style="width:185px" %)(((
135 +**SDMX 2.1:URL
136 136  SDMX >=3.0:+URL
137 -Blue is optional
137 +(% style="background-color:transparent" %)Blue is optional(%%)**
138 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 -
139 +|(% style="width:243px" %)FULL_NAME|(% style="width:442px" %)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:246px" %)Item in an Item Scheme|(% style="width:289px" %)(((
141 +<language>:<content>,<language>:<content>,…
145 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 -
143 +(% style="background-color:transparent" %)en:Labour force (Employment)
144 +)))|(% style="width:321px" %)<content>|(% style="width:185px" %)
145 +|(% style="width:243px" %)REPLACE_NAME|(% style="width:442px" %)Replace each code name in a component by the value of another component in an observation or series|(% style="width:246px" %)A Dataflow or DSD|(% style="width:289px" %) |(% style="width:321px" %)(((
146 +<component Id to replace name>:
147 +<component Id to use name>
152 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 -
149 +(% style="background-color:transparent" %)CUST_BREAKDOWN:CUST_
150 +BREAKDOWN_LB
151 +)))|(% style="width:185px" %)
152 +|(% style="width:243px" %)REPLACE_CONTENT|(% style="width:442px" %)Replace the content in a component by the value of another component in an observation or series|(% style="width:246px" %)A Dataflow or DSD|(% style="width:289px" %) |(% style="width:321px" %)(((
153 +<component Id to replace content>:
154 +<component Id to use content>
159 159  //Example~://
160 -
161 -REF_AREA:M49_CODE
162 -)))|(% style="width:866px" %)
163 -|(% style="width:152px" %)COMPLEMENT|(% style="width:559px" %)(((
156 +(% style="background-color:transparent" %)REF_AREA:M49_CODE
157 +)))|(% style="width:185px" %)
158 +|(% style="width:243px" %)COMPLEMENT|(% style="width:442px" %)(((
164 164  Additional fixed text to be displayed in parenthesis after the code name.
160 +(% style="background-color:transparent" %)E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes(%%)
161 +(% style="background-color:transparent" %)en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)(%%)
162 +(% style="background-color:transparent" %)en: 01 03 99 wastes not otherwise specified (NHAZW)
163 +)))|(% style="width:246px" %)Item in an Item Scheme|(% style="width:289px" %)(((
164 +<language>:<content>,<language>:<content>,…
165 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 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" %)(((
167 +(% style="background-color:transparent" %)en:See reference metadata
168 +)))|(% style="width:321px" %)<content>|(% style="width:185px" %)
169 +|(% style="width:243px" %)ORDER|(% style="width:442px" %)Explicit indication of a localised order of items in Items Schemes or artefacts (e.g. Codelist, Concept Scheme, Category Scheme, Dataflow, etc.)|(% style="width:246px" %)(((
179 179  Either:
180 180  
181 181  * an artefact, or;
182 182  * an item in an Item Scheme
183 -)))|(% style="width:506px" %)(((
174 +)))|(% style="width:289px" %)(((
184 184  <language>:<content>,
185 -
186 186  <language>:<content>,…
187 187  
188 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" %)(((
179 +(% style="background-color:transparent" %)en:10,es:20
180 +)))|(% style="width:321px" %)<content>|(% style="width:185px" %)
181 +|(% style="width:243px" %)TOTAL|(% style="width:442px" %)(((
197 197  Code Item that represents a total value. If the attachment is:
198 198  
199 199  * to a Code, the Annotation Text is optional and may contain an explanatory text;
200 200  * to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
201 -)))|(% style="width:20px" %)(((
186 +)))|(% style="width:246px" %)(((
202 202  Either:
203 203  
204 204  * a Code Item that represents a total value, or;
205 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" %)(((
191 +)))|(% style="width:289px" %)(((
192 +<language>:<explanatory text>, 
193 +(% style="background-color:transparent" %)<language>:<explanatory text>,…
194 +)))|(% style="width:321px" %)(((
211 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" %)(((
196 +(% style="background-color:transparent" %)Attached to Codelist: <code>,<code>,…
197 +)))|(% style="width:185px" %)
198 +|(% style="width:243px" %)DRILLDOWN|(% style="width:442px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|(% style="width:246px" %)(((
216 216  Either:
217 217  
218 218  * A Dataflow or DSD
219 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
202 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
220 220  <concept Id>
221 -
222 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" %)(((
205 +(% style="background-color:transparent" %)DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
206 +)))|(% style="width:185px" %)
207 +|(% style="width:243px" %)DEPRECATED|(% style="width:442px" %)(((
227 227  Indication that an Item in an Item Scheme or an artefact is deprecated.
228 -
229 229  For an item scheme item, the annotation value provides a replacement name for the code name.
230 -
231 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 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" %)(((
212 +url:
213 +<[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
214 +url:
215 +<[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
216 +or
217 +(% style="background-color:transparent" %)TITLE: true (false)
218 +)))|(% style="width:246px" %)(((
242 242  Either:
243 243  
244 244  * an artefact, or;
245 245  * an item in an Item Scheme
246 -)))|(% style="width:506px" %)(((
223 +)))|(% style="width:289px" %)(((
247 247  For item scheme item:
248 248  
249 -<language>:<content>,
226 +<language>:<content>,<language>:<content>,…
250 250  
251 -<language>:<content>,…
252 -
253 253  //Example~://
254 -
255 -en:deprecated,fr:obsolète
256 -)))|(% style="width:178px" %)<content>|(% style="width:866px" %)(((
229 +(% style="background-color:transparent" %)en:deprecated,fr:obsolète
230 +)))|(% style="width:321px" %)<content>|(% style="width:185px" %)(((
257 257  For artefact:
258 -
259 259  <see section URL value defaults and specific locale values>
260 -
261 -
262 262  )))
263 -|(% style="width:152px" %)DEFAULT|(% style="width:559px" %)(((
234 +|(% style="width:243px" %)DEFAULT|(% style="width:442px" %)(((
264 264  Indication that an item in an Item Scheme or artefacts is to be selected by default.
265 265  
266 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" %)(((
238 +)))|(% style="width:246px" %)(((
268 268  * Item in ItemScheme, or;
269 269  * DSD, or;
270 270  * a Dataflow
271 271  
272 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" %)(((
244 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
274 274  Attached to:
275 275  
276 276  - DSD or Dataflow:
277 -**<concept>=<code>+<code>+…,<concept>=<code>+<code>+…**
248 +**<concept>=<code>+<code>+…,
249 +<concept>=<code>+<code>+…**
278 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" %)(((
251 +//Example~:// FREQ=A+Q,TIME_PERIOD_
252 +START=2013-01,TIME_PERIOD_END
253 +~=2018-12
254 +)))|(% style="width:185px" %)
255 +|(% style="width:243px" %)IMAGE|(% style="width:442px" %)A visual identity to associate to Item Scheme Items or artefacts|(% style="width:246px" %)(((
282 282  Either:
283 283  
284 284  * an artefact, or;
285 285  * an item in an item scheme
286 -)))|(% style="width:506px" %)(((
260 +)))|(% style="width:289px" %)(((
287 287  For localised content in SDMX 2.1
288 -
289 289  <language>:<HTML containing URL to the resource>,
290 -
291 291  <language>:<HTML containing URL to the resource>,…
292 292  
293 293  //Example~://
294 -
295 295  en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”>
296 -)))|(% style="width:178px" %) |(% style="width:866px" %)(((
267 +)))|(% style="width:321px" %) |(% style="width:185px" %)(((
297 297  See section URL value defaults and specific locale values.
298 298  
299 299  //Example~://
300 300  
301 -https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg
302 -
303 -
272 +https:~/~/sdmx.org/wp-content/uploads/SDMX_map_
273 +small-220x220.jpg
304 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" %)(((
275 +|(% style="width:243px" %)DRILLDOWN_CONCEPTS|(% style="width:442px" %)Concepts to be displayed in a drilldown operation|(% style="width:246px" %)Dataflow or DSD|(% style="width:289px" %) |(% style="width:321px" %)(((
306 306  <concept Id>,<concept Id>,…
307 307  
308 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" %)(((
279 +DONOR,RECIPIENT,YEAR,PROJECT_ID, OBS_VALUE,DESCRIPTION,OWNER
280 +)))|(% style="width:185px" %)
281 +|(% style="width:243px" %)NOT_DISPLAYED|(% style="width:442px" %)Used to hide components or their values in the presentation|(% style="width:246px" %)(((
313 313  Either:
314 314  
315 315  * a Dataflow or DSD, or;
316 316  * an Item in an Item Scheme
317 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
286 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
318 318  Attached to Item in Item Scheme: <blank>
319 319  
320 320  Attached to Dataflow or DSD:
321 -
322 322  <concept Id>,<concept Id>,…
323 -
324 324  Example :
325 -
326 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" %)(((
293 +)))|(% style="width:185px" %)
294 +|(% style="width:243px" %)LAYOUT_ROW|(% style="width:442px" %)Dimensions to be presented in rows (concepts on y-axis)|(% style="width:246px" %)(((
329 329  Either:
330 330  
331 331  * an artefact, or;
332 332  * a Dimension
333 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
299 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
334 334  Attached to Dimension: <blank>
335 335  
336 336  Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,…
337 337  
338 338  //Example~://
339 -
340 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" %)(((
306 +)))|(% style="width:185px" %)
307 +|(% style="width:243px" %)LAYOUT_COLUMN|(% style="width:442px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:246px" %)(((
343 343  Either:
344 344  
345 345  * an artefact, or;
346 -* a Dimension
347 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
311 +
312 +a Dimension
313 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
348 348  Attached to Dimension: <blank>
349 349  
350 350  Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
351 351  
352 352  //Example~://
353 -
354 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" %)(((
320 +)))|(% style="width:185px" %)
321 +|(% style="width:243px" %)LAYOUT_FLAG|(% style="width:442px" %)Indication that an attribute and its attribute value should be presented as a flag|(% style="width:246px" %)Dataflow|(% style="width:289px" %) |(% style="width:321px" %)(((
357 357  <concept Id>,<concept Id>,...
358 358  
359 359  //Example~://
360 -
361 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" %)(((
326 +)))|(% style="width:185px" %)
327 +|(% style="width:243px" %)LAYOUT_NOTE|(% style="width:442px" %)Indication that an attribute and its attribute value should be presented as a note|(% style="width:246px" %)Dataflow|(% style="width:289px" %) |(% style="width:321px" %)(((
364 364  <concept Id>,<concept Id>,...
365 365  
366 366  //Example~://
367 -
368 368  OBS_STATUS,CONF_STATUS
369 -)))|(% style="width:866px" %)
370 -|(% style="width:152px" %)(((
332 +)))|(% style="width:185px" %)
333 +|(% style="width:243px" %)(((
371 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" %)(((
335 +)))|(% style="width:442px" %)Links an MSD directly to a DSD. Can be used to overcome the complexities of reference metadata linkage|(% style="width:246px" %)DSD|(% style="width:289px" %) |(% style="width:321px" %)MSD URI, e.g. urn:sdmx:org.sdmx.infomodel.
336 +metadatastructure. MetadataStructure =OECD:MSD_REF_METADATA(1.0)|(% style="width:185px" %)
337 +|(% style="width:243px" %)LAYOUT_ROW_SECTION|(% style="width:442px" %)Dimension to be presented as a break-down concept at a third hierarchical level above columns and rows.|(% style="width:246px" %)(((
376 376  Either:
377 377  
378 378  * an artefact, or;
379 -
380 -a Dimension
381 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
341 +* a Dimension
342 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
382 382  Attached to Dimension: <blank>
383 -
384 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
385 -
344 +~|Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
386 386  //Example~://
387 -
388 388  SEX
389 -)))|(% style="width:866px" %)
390 -|(% style="width:152px" %)EXT_RESOURCE|(% style="width:559px" %)(((
347 +)))|(% style="width:185px" %)
348 +|(% style="width:243px" %)EXT_RESOURCE|(% style="width:442px" %)(((
391 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" %)(((
350 +//a methodology// en:<a href: "[[https:~~/~~/ec.europa.eu/eurostat/web/waste/methodology>>url:https://ec.europa.eu/eurostat/web/waste/methodology]]">
351 +)))|(% style="width:246px" %)Any SDMX object|(% style="width:289px" %)(((
395 395  For localised content in SDMX 2.1
396 -
397 - <language>:<HTML containing URL to the resource>,
398 -
353 +<language>:<HTML containing URL to the resource>,
399 399  <language>:<HTML containing URL to the resource>,…
400 400  
401 401  //Example~://
402 -
403 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" %)(((
358 +)))|(% style="width:321px" %) |(% style="width:185px" %)(((
405 405  See section URL value defaults and specific locale values.
406 406  
407 407  //Example~://
408 408  
409 -http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth
363 +http:~/~/rdf-vocabulary.ddialliance.org/
364 +xkos#depth
410 410  )))
411 -|(% style="width:152px" %)COMBINED_CONCEPTS|(% style="width:559px" %)(((
366 +|(% style="width:243px" %)COMBINED_CONCEPTS|(% style="width:442px" %)(((
412 412  Comma-separated list of concept IDs to show as a concatenated label.
413 -
414 414  The listed concepts’ item contents may be concatenated to generate the target concept.
415 -
416 416  Multiple target concept combinations can be defined by separating the target concepts by ;
417 -)))|(% style="width:20px" %)Dataflow or DSD|(% style="width:506px" %)(((
370 +)))|(% style="width:246px" %)Dataflow or DSD|(% style="width:289px" %)(((
418 418  <language>:<display name>,
419 -
420 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" %)(((
373 +(% style="background-color:transparent" %)e.g. COMBINED_UNIT_MEASURE:
374 +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}
375 +)))|(% style="width:321px" %) |(% style="width:185px" %)
376 +|(% style="width:243px" %)(deprecated) UNIT_MEASURE_CONCEPTS|(% style="width:442px" %)(((
425 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 426  
427 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" %)(((
380 +)))|(% style="width:246px" %)Dataflow or DSD|(% style="width:289px" %) |(% style="width:321px" %)(((
429 429  <concept Id>,<concept Id>,…
430 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 -
383 +//Example~:// UNIT_MEASURE, UNIT_MULT,
384 +TRANSFORMATION [could generate a value of Australian Dollar, Thousands, Non-transformed]
385 +)))|(% style="width:185px" %)
386 +|(% style="width:243px" %)(deprecated) UNIT_MEASURE_LABEL|(% style="width:442px" %)(((
387 +Indicates the concept that enumerates the full unit of measure labels.
436 436  The concept must be in the DSD. UNIT_MEASURE_LABEL overrides the UNIT_MEASURE_CONCEPTS if both are provided.
437 437  
438 438  Also can be attached to items in item scheme, e.g.
439 439  
440 -Text en:Gram
441 - fr: Gramme
392 +Text en:Gram
393 + fr: Gramme
442 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" %)(((
395 +)))|(% style="width:246px" %)Dataflow or DSD, Item in an Item Scheme|(% style="width:289px" %)(((
444 444  This is optional, used if a freetext label is required.
445 445  
446 446  <language>:<content>,
447 -
448 448  <language>:<content>,…
449 449  
450 450  //Example~://
451 451  
452 452  en:USD, thousands
453 -
454 454  fr:USD, milliers
455 -)))|(% style="width:178px" %)(((
405 +)))|(% style="width:321px" %)(((
456 456  This is optional, used if an enumerated list is required.
457 -
458 458  <concept Id>
459 -
460 460  //Example~://
461 -
462 462  UOM_ATTRIBUTE [This concept may contain the following items as units of measure:
463 463  
464 464  * National Currency, thousands
... ... @@ -465,568 +465,263 @@
465 465  * USD, thousands
466 466  
467 467  Index, based on National Currency]
468 -)))|(% style="width:866px" %)
469 -|(% style="width:152px" %)(((
415 +)))|(% style="width:185px" %)
416 +|(% style="width:243px" %)(((
470 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" %)(((
418 +)))|(% style="width:442px" %)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:246px" %)Dataflow, DSD|(% style="width:289px" %) |(% style="width:321px" %)(((
474 474  //Example~://
475 475  
476 476  LAYOUT_TIME_PERIOD_DESC
477 -)))|(% style="width:866px" %)
478 -|(% style="width:152px" %)(((
422 +)))|(% style="width:185px" %)
423 +|(% style="width:243px" %)(((
479 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" %)(((
425 +)))|(% style="width:442px" %)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:246px" %)Dataflow, DSD, Dimension|(% style="width:289px" %)(((
483 483  <language>:<content>,
484 -
485 485  <language>:<content>,…
486 -
487 -
488 488  <content> values:RIGHT or LEFT
489 -)))|(% style="width:178px" %)Content values:RIGHT or LEFT|(% style="width:866px" %)
490 -|(% style="width:152px" %)(((
429 +)))|(% style="width:321px" %)Content values:RIGHT or LEFT|(% style="width:185px" %)
430 +|(% style="width:243px" %)(((
491 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" %)(((
432 +)))|(% style="width:442px" %)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:246px" %)Dataflow|(% style="width:289px" %) |(% style="width:321px" %)(((
495 495  <integer>
496 -
497 497  //Example~://
498 -
499 499  15000
500 -)))|(% style="width:866px" %)
501 -|(% style="width:152px" %)(((
436 +)))|(% style="width:185px" %)
437 +|(% style="width:243px" %)(((
502 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" %)(((
439 +)))|(% style="width:442px" %)Increase the maximum length for textual attribute values|(% style="width:246px" %)DSD|(% style="width:289px" %) |(% style="width:321px" %)(((
506 506  <integer>
507 507  
508 508  //Example~://
509 509  
510 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" %)(((
445 +)))|(% style="width:185px" %)
446 +|(% style="width:243px" %)SEARCH_WEIGHT|(% style="width:442px" %)Indication of localised boosted dataflows in the search results when ordered by relevance|(% style="width:246px" %)Dataflow|(% style="width:289px" %)(((
513 513  <language>:<integer>,...
514 -
515 515  //Example~://
516 -
517 517  "en":"3","es":"4","fr":"5"
518 -)))|(% style="width:178px" %)(((
450 +)))|(% style="width:321px" %)(((
519 519  <integer>
520 520  
521 521  //Example~://
522 522  
523 523  10
524 -)))|(% style="width:866px" %)
456 +)))|(% style="width:185px" %)
525 525  
526 526  == Codelist and Statistical Classification-specific Annotations ==
527 527  
528 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 529  
530 -
531 -|**Annotation Type**|(% style="width:524px" %)**Use Case**|(% style="width:198px" %)**Where to attach**|(% style="width:237px" %)(((
462 +(% style="width:1785.2px" %)
463 +|**Annotation Type**|(% style="width:463px" %)**Use Case**|(% style="width:247px" %)**Where to attach**|(% style="width:332px" %)(((
532 532  **+Text
533 -(% style="background-color:transparent" %)Blue is optional(%%)**
534 -)))|(% style="width:320px" %)(((
465 +Blue is optional**
466 +)))|(% style="width:224px" %)(((
535 535  **Title
536 -(% style="background-color:transparent" %)Blue is optional(%%)**
537 -)))|(% style="width:203px" %)(((
468 +Blue is optional**
469 +)))|(% style="width:229px" %)(((
538 538  **SDMX 2.1:URL
539 539  SDMX >=3.0:+URL
540 -(% style="background-color:transparent" %)Blue is optional(%%)**
472 +Blue is optional**
541 541  )))
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>,…
474 +|ORIGINAL_CODE|(% style="width:463px" %)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|(% style="width:247px" %)Item in an Item Scheme|(% style="width:332px" %) |(% style="width:224px" %)(((
475 +<original code>
476 +//Examples~://
565 565  
478 +* 0105.13 [Harmonized System]
479 +* 11.2.0.9 [COICOP classification]
480 +)))|(% style="width:229px" %)
481 +|HIER_CONTEXT|(% style="width:463px" %)(((
482 +In SDMX 2.1, a reference between a usage context and a hierarchy (that may be contained in a Hierarchical Codelist (HCL)).
483 +In SDMX 3.0, use the HierarchyAssociation artefact
484 +)))|(% style="width:247px" %)DSD or Dataflow|(% style="width:332px" %) |(% style="width:224px" %)(((
485 +<component Id>:<HCL Id>.<hierarchy Id>
566 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:
487 +REF_AREA: OECD.EDU:HCL_REF_AREA(1.0).REF_AREA provides the link to the reference area hierarchy for OECD education data
488 +)))|(% style="width:229px" %)
489 +|HIER_LEVEL|(% style="width:463px" %)(((
490 +Explicit specification of the hierarchical level of a code item
571 571  
572 -* an artefact, or;
573 -* an item in an Item Scheme
574 -)))|(% style="width:237px" %)(((
575 -<language>:<content>,<language>:<content>,…
576 -
492 +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]]
493 +text en:sections
494 +)))|(% style="width:247px" %)Code item|(% style="width:332px" %) |(% style="width:224px" %)(((
495 +<hierarchical level>
577 577  //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:
497 +1
498 +)))|(% style="width:229px" %)
499 +|SHORT_LABEL|(% style="width:463px" %)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)|(% style="width:247px" %)Artefact, or Concept,
500 +or Item in an Item Scheme|(% style="width:332px" %)(((
501 +<language>:<content>,
582 582  
583 -* 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:
587 -
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:
599 -
600 -* A Dataflow or DSD
601 -)))|(% style="width:237px" %) |(% style="width:320px" %)(((
602 -<concept Id>
503 +<language>:<content>,…
504 +)))|(% style="width:224px" %)(((
603 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:
617 617  
618 -* an artefact, or;
619 -* an item in an Item Scheme
620 -)))|(% style="width:237px" %)(((
621 -For item scheme item:
507 +[Official French label “Transformation et conservation de la viande de boucherie” is shortened to] fr:Transf. & conserv. viande de boucherie
622 622  
623 -<language>:<content>,<language>:<content>,…
509 +In Codelist=IMF:CL_AREA(1.13)
510 +Code 4J837 European Union Intellectual Property Office has a Short_Label
624 624  
625 -//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" %)
642 -
643 -
644 -
645 -|FULL_NAME|(% style="width:350px" %)Alternative name to be displayed for items in Item Schemes (e.g. Codelists, Concept Schemes, Category Schemes) whenever the item is displayed without its parent. For example, if a code list that has a hierarchy is displayed as a flat list, then this annotation may be used to provide sufficient context for the code. Concatenation of code + heading in NACE Rev.2.1 
646 -en: A0123 Growing of citrus fruits|Item in an Item Scheme|(% style="width:288px" %)(((
512 +EN:EUIPO
513 +)))|(% style="width:229px" %)
514 +|EXPLAN_LABEL|(% style="width:463px" %)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|(% style="width:247px" %)Item in an Item Scheme, mapping to Representation Maps|(% style="width:332px" %)(((
647 647  <language>:<content>,
516 +
648 648  <language>:<content>,…
518 +)))|(% style="width:224px" %)(((
649 649  //Example~://
650 -en:Labour force (Employment)
651 -)))|(% style="width:1427px" %)<content>|
652 -|REPLACE_NAME|Replace each code name in a component by the value of another component in an observation or series|A Dataflow or DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
653 -<component Id to replace name>:<component Id to use name>
654 654  
655 -//Example~://
521 +[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
522 +)))|(% style="width:229px" %)
523 +|EXPLAN_CONSOL|(% style="width:463px" %)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|(% style="width:247px" %)Item in an Item Scheme, mapping to Representation Maps|(% style="width:332px" %)(((
524 +<language>:<content>,
656 656  
657 -CUST_BREAKDOWN:CUST_BREAKDOWN_LB
658 -)))|
659 -|REPLACE_CONTENT|(% style="width:350px" %)Replace the content in a component by the value of another component in an observation or series|(% style="width:250px" %)A Dataflow or DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
660 -<component Id to replace content>:<component Id to use content>
526 +<language>:<content>,…
527 +)))|(% style="width:224px" %)(((
528 +Example (from the US NAICS classification):
661 661  
662 -//Example~://
663 -
664 -REF_AREA:M49_CODE
665 -)))|
666 -|(% style="width:199px" %)COMPLEMENT|(% style="width:350px" %)(((
667 -Additional fixed text to be displayed in parenthesis after the code name.
668 -
669 -E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes
670 -en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)
671 -en: 01 03 99 wastes not otherwise specified (NHAZW)
672 -)))|(% style="width:250px" %)Item in an Item Scheme|(% style="width:288px" %)(((
530 +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.
531 +)))|(% style="width:229px" %)
532 +|EXPLAN_INCLUDES|(% style="width:463px" %)Explanatory notes. Description of those things known specifically to be included in the concept. Synonyms Typical labels for such explanatory notes: "This class includes", "This category includes", "This position includes", "Includes", etc. Reference to external standard: xkos:inclusionNote or xkos:coreContentNote (if EXPLAN_INCLUDES_ALSO available)|(% style="width:247px" %)Item in an Item Scheme, mapping to Representation Maps|(% style="width:332px" %)(((
673 673  <language>:<content>,
534 +<language>:<content>,…
535 +)))|(% style="width:224px" %)(((
536 +Example (from ISIC Rev. 4 explanatory notes to code 2520 - Manufacture of weapons and ammunition):
537 +en: This class includes:
674 674  
539 +* manufacture of heavy weapons (artillery, mobile guns, rocket launchers, torpedo tubes, heavy machine guns)
540 +* manufacture of small arms (revolvers, shotguns, light machine guns)
541 +* manufacture of air or gas guns and pistols
542 +* manufacture of war ammunition
543 +)))|(% style="width:229px" %)
544 +|EXPLAN_CASELAW|(% style="width:463px" %)Explanatory notes. Indication that a decision on the classification has been made by the ad hoc Committee (concept generally described as “ruling”, “classification opinion”, classification decision; caselaw). : Reference to external standardxkos:caseLaw. The difference between caselaws and traditional explanatory notes is that caselaws are adopted during the time period between two official versions of a specific classification and have thus a slightly different status (e.g. from a legal viewpoint)|(% style="width:247px" %)Item in an Item Scheme|(% style="width:332px" %)(((
545 +<language>:<content>,
675 675  <language>:<content>,…
676 676  
677 -//Example~://
548 +Example (from NACE Rev. 2 caselaw to code 01.62):
678 678  
679 -en:See reference metadata
680 -)))|(% style="width:1427px" %)<content>|
681 -|(% style="width:199px" %)ORDER|(% style="width:350px" %)Explicit indication of a localised order of items in Items Schemes or artefacts (e.g. Codelist, Concept Scheme, Category Scheme, Dataflow, etc.)|(% style="width:250px" %)(((
682 -Either:
683 -
684 -* an artefact, or;
685 -* an item in an Item Scheme
686 -)))|(% style="width:288px" %)(((
550 +en:Automated egg hatching for poultry - Operation of livestock management systems]
551 +)))|(% style="width:224px" %) |(% style="width:229px" %)
552 +|EXPLAN_INCLUDES_ALSO|(% style="width:463px" %)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|(% style="width:247px" %)Item in an Item Scheme|(% style="width:332px" %)(((
687 687  <language>:<content>,
688 688  
689 689  <language>:<content>,…
556 +)))|(% style="width:224px" %)(((
557 +Example (from ISIC Rev. 4 explanatory notes to code 2520 - Manufacture of weapons and ammunition):
690 690  
691 -//Example~://
559 +en:This class also includes:
692 692  
693 -en:10,es:20
694 -)))|(% style="width:1427px" %)(((
695 -<content>
561 +* manufacture of hunting, sporting or protective firearms and ammunition
562 +* manufacture of explosive devices such as bombs, mines and torpedoes
563 +)))|(% style="width:229px" %)
564 +|EXPLAN_EXCLUDES|(% style="width:463px" %)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|(% style="width:247px" %)(((
565 +Item in an Item Scheme
696 696  
697 697  
698 -)))|
699 -|(% style="width:199px" %)TOTAL|(% style="width:350px" %)(((
700 -Code Item that represents a total value. If the attachment is:
701 -
702 -* to a Code, the Annotation Text is optional and may contain an explanatory text;
703 -
704 -to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
705 -)))|(% style="width:250px" %)(((
706 -Either:
707 -
708 -* a Code Item that represents a total value, or;
709 -* a Codelist to specify the code(s) with the total
710 -)))|(% style="width:288px" %)(((
711 -<language>:<explanatory text>,
712 -
713 -<language>:<explanatory text>,…
714 -)))|(% style="width:1427px" %)(((
715 -Attached to Code Item: <blank>
716 -
717 -Attached to Codelist: <code>,<code>,…
718 -)))|
719 -|(% style="width:199px" %)DRILLDOWN|(% style="width:350px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|(% style="width:250px" %)(((
720 -Either:
721 -
722 -* A Dataflow or DSD
723 -)))|(% style="width:288px" %) |(% style="width:1427px" %)(((
724 -<concept Id>
725 -
726 -//Example~://
727 -
728 -DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
729 -)))|
730 -|(% style="width:199px" %)DEPRECATED|(% style="width:350px" %)(((
731 -Indication that an Item in an Item Scheme or an artefact is deprecated.
732 -
733 -For an item scheme item, the annotation value provides a replacement name for the code name.
734 -
735 -For an artefact, the URL points to the replacement artefact. May be used in conjunction with SUPERSEED where the replacement artefact references the replaced artefact.
736 -
737 -Suggestion to use a controlled vocabulary
738 -
739 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
740 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
741 -
742 -or
743 -
744 -TITLE: true (false)
745 -)))|(% style="width:250px" %)(((
746 -Either:
747 -
748 -* an artefact, or;
749 -* an item in an Item Scheme
750 -)))|(% style="width:288px" %)(((
751 -For item scheme item:
752 -
568 +)))|(% style="width:332px" %)(((
753 753  <language>:<content>,
754 -
755 755  <language>:<content>,…
571 +)))|(% style="width:224px" %)(((
572 +Example (from ISIC Rev. 4 explanatory notes to code 2520 - Manufacture of weapons and ammunition):
756 756  
757 -//Example~://
574 +en:This class excludes:
758 758  
759 -en:deprecated,fr:obsolète
760 -)))|(% style="width:1427px" %)<content>|(((
761 -For artefact:
576 +* manufacture of percussion caps, detonators or signalling flares, see 2029
577 +* manufacture of cutlasses, swords, bayonets etc., see 2593
578 +)))|(% style="width:229px" %)
579 +|MAP_REFER|(% style="width:463px" %)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)|(% style="width:247px" %)Codelist, Concept Scheme, or another Item Scheme|(% style="width:332px" %) |(% style="width:224px" %)Id of an ItemSchemeMap returned by the Annotation URL|(% style="width:229px" %)(((
580 +See section URL value defaults and specific locale values.
762 762  
763 -<see section URL value defaults and specific locale values>
764 -
765 765  
766 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.
584 +|COMP_RULE|(% style="width:463px" %)Code item composition rule. For example, for code A the composition rule may be “A1+A2” where A1 and A2 are other codes in the same Codelist|(% style="width:247px" %)An Item in an Item Scheme|(% style="width:332px" %) |(% style="width:224px" %)(((
585 +<content>
769 769  
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
775 -
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:
779 -
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
784 -)))|
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 797  //Example~://
798 798  
799 -en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”>
800 -)))|(% style="width:1427px" %) |(((
589 +A1+A2
590 +)))|(% style="width:229px" %)
591 +|FOLLOWS|(% style="width:463px" %)(((
592 +A reference used to express the succession in time of Item Schemes.
593 +For example, NACE Rev. 2 is the successor of NACE Rev. 1.1
594 +Reference to external standard: skos:ConceptScheme - property: xkos:follows
595 +)))|(% style="width:247px" %)Codelist or Item Scheme|(% style="width:332px" %) |(% style="width:224px" %) |(% style="width:229px" %)(((
801 801  See section URL value defaults and specific locale values.
802 -
803 803  //Example~://
804 -
805 -https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg
806 -
807 -
598 +(CL_REGIONAL 3.1.1 follows CL_REGIONAL 3.1):
599 +[[https:~~/~~/registry.sdmx.org/ws/public/sdmxapi/
600 +rest/codelist/ESTAT/CL_REGIONAL/3.1>>url:https://registry.sdmx.org/ws/public/sdmxapi/rest/codelist/ESTAT/CL_REGIONAL/3.1]]
808 808  )))
809 -|(% style="width:199px" %)DRILLDOWN_CONCEPTS|(% style="width:350px" %)Concepts to be displayed in a drilldown operation|(% style="width:250px" %)Dataflow or DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
810 -<concept Id>,<concept Id>,…
602 +|HAS_VARIANT|(% style="width:463px" %)(((
603 +A reference used to express the relation between an Item Scheme and its variant(s).
604 +Reference to external standard: skos:ConceptScheme - property: xkos:variant
811 811  
812 -Example :
813 813  
814 -DONOR,RECIPIENT,YEAR,PROJECT_ID,OBS_VALUE,DESCRIPTION,OWNER
815 -)))|
816 -|(% style="width:199px" %)NOT_DISPLAYED|(% style="width:350px" %)Used to hide components or their values in the presentation|(% style="width:250px" %)(((
817 -Either:
607 +For //Example~:// CL_AREA has a variant CL_GEO
608 +)))|(% style="width:247px" %)Codelist or Item Scheme|(% style="width:332px" %) |(% style="width:224px" %) |(% style="width:229px" %)(((
609 +See section URL value defaults and specific locale values.
818 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 -
842 -//Example~://
843 -
844 -REF_AREA,MEASURE
845 -)))|
846 -|(% style="width:199px" %)LAYOUT_COLUMN|(% style="width:350px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:250px" %)(((
847 -Either:
848 -
849 -* an artefact, or;
850 -* a Dimension
851 -)))|(% style="width:288px" %) |(% style="width:1427px" %)(((
852 -Attached to Dimension: <blank>
853 -
854 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
855 -
856 -//Example~://
857 -
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>,...
862 -
863 -//Example~://
864 -
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>,...
869 -
870 -//Example~://
871 -
872 -OBS_STATUS,CONF_STATUS
873 -)))|
874 -|(% style="width:199px" %)(((
875 -METADATA
876 -
877 877  
878 -)))|(% style="width:350px" %)Links an MSD directly to a DSD. Can be used to overcome the complexities of reference metadata linkage|(% style="width:250px" %)DSD|(% style="width:288px" %) |(% style="width:1427px" %)MSD URI, e.g. urn:sdmx:org.sdmx.infomodel.metadatastructure.MetadataStructure=OECD:MSD_REF_METADATA(1.0)|
879 -|(% style="width:199px" %)LAYOUT_ROW_SECTION|(% style="width:350px" %)Dimension to be presented as a break-down concept at a third hierarchical level above columns and rows.|(% style="width:250px" %)(((
880 -Either:
881 -
882 -* an artefact, or;
883 -
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" %) |(((
612 +)))
613 +|SUPERSEED|(% style="width:463px" %)(((
614 +A reference to a previous version, if the current version obsoleted the previous one.
615 +May be used in conjunction with DEPRECATED.
616 +Reference to external standard: skos:ConceptScheme - property: xkos:supersedes
617 +)))|(% style="width:247px" %)Codelist or Item Scheme, or an artefact|(% style="width:332px" %) |(% style="width:224px" %) |(% style="width:229px" %)(((
909 909  See section URL value defaults and specific locale values.
910 910  
911 -//Example~://
912 -
913 -http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth
620 +
914 914  )))
915 -|(% style="width:199px" %)COMBINED_CONCEPTS|(% style="width:350px" %)(((
916 -Comma-separated list of concept IDs to show as a concatenated label.
917 -
918 -The listed concepts’ item contents may be concatenated to generate the target concept.
919 -
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 -
622 +|FAMILY_LABEL|(% style="width:463px" %)(((
623 +Label of the Classification Family (e.g. NACE, ISIC)
624 +Reference to external standard: skos:ConceptScheme - property: xkos:belongsTo
625 +label of the classification
626 +)))|(% style="width:247px" %)Codelist or Item Scheme|(% style="width:332px" %)(((
950 950  <language>:<content>,
951 -
952 952  <language>:<content>,…
953 953  
954 954  //Example~://
631 +en:NACE
632 +)))|(% style="width:224px" %) |(% style="width:229px" %)(((
633 +See section URL value defaults and specific locale values.
955 955  
956 -en:USD, thousands
957 -
958 -fr:USD, milliers
959 -)))|(% style="width:1427px" %)(((
960 -This is optional, used if an enumerated list is required.
961 -
962 -<concept Id>
963 -
964 -//Example~://
965 -
966 -UOM_ATTRIBUTE [This concept may contain the following items as units of measure:
967 -
968 -* National Currency, thousands
969 -* USD, thousands
970 -
971 -Index, based on National Currency]
972 -)))|
973 -|(% style="width:199px" %)(((
974 -LAYOUT_TIME_PERIOD_DESC
975 -
976 976  
977 -)))|(% style="width:350px" %)Indication that the display of the TIME_PERIOD dimension for a dataflow, or all dataflows of the same DSD, is to be done in descending sort order.|(% style="width:250px" %)Dataflow, DSD|(% style="width:288px" %) |(% style="width:1427px" %)(((
978 -//Example~://
636 +)))
637 +|COVERAGE_LABEL|(% style="width:463px" %)(((
638 +Label(s) of the item scheme’s coverage (e.g. National Accounts, Products, Activities, Occupations)
639 +Reference to external standard: skos:ConceptScheme - property: xkos:covers
979 979  
980 -LAYOUT_TIME_PERIOD_DESC
981 -)))|
982 -|(% style="width:199px" %)(((
983 -LAYOUT_CELL_ALIGN
641 +//Examples~://
642 +URL <http:~/~/eurovoc.europa.eu/56> (National accounts)
984 984  
985 -
986 -)))|(% style="width:350px" %)Indication to force the data cell alignment to the left or to the right. This can be defined generically for all locales or per locale.|(% style="width:250px" %)Dataflow, DSD, Dimension|(% style="width:288px" %)(((
644 +URL
645 +<http:~/~/publications.europa.eu/resource/authority/data-theme/REGI> (Regions and Cities)
646 +)))|(% style="width:247px" %)Codelist or Item Scheme|(% style="width:332px" %)(((
987 987  <language>:<content>,
988 988  
989 989  <language>:<content>,…
990 990  
991 -
992 -<content> values:RIGHT or LEFT
993 -)))|(% style="width:1427px" %)Content values:RIGHT or LEFT|
994 -|(% style="width:199px" %)(((
995 -MAX_TABLE_DATA
996 -
997 -
998 -)))|(% style="width:350px" %)Increase the maximum preview table size above default maximum limits for the number of observations retrieved from the SDMX web service and for the number of table cells|(% style="width:250px" %)Dataflow|(% style="width:288px" %) |(% style="width:1427px" %)(((
999 -<integer>
1000 -
1001 1001  //Example~://
1002 1002  
1003 -15000
1004 -)))|
1005 -|(% style="width:199px" %)(((
1006 -MAXTEXTATTRIBUTELENGTH
653 +En:national accounts
654 +)))|(% style="width:224px" %) |(% style="width:229px" %)(((
655 +See section URL value defaults and specific locale values.
1007 1007  
1008 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>
658 +)))
659 +|GEO_FEATURE_SET|(% style="width:463px" %)(((
660 +In Codelists, transmits GeoFeature values.Example for NUTS ID BE23
661 +url:
662 +[[http:~~/~~/data.europa.eu/nuts/geometry/2xr1qiv9>>url:http://data.europa.eu/nuts/geometry/2xr1qiv9]]
663 +)))|(% style="width:247px" %)Code in a Codelist. The Codelist must have an annotation attached with AnnotationType
664 +~=GEO_TYPE_GEOGRAPHIC|(% style="width:332px" %) |(% style="width:224px" %)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.|(% style="width:229px" %)
665 +|GEO_TYPE_GEOGRAPHIC|(% style="width:463px" %)Indicates that a codelist contains GeoFeature values via the GEO_FEATURE_SET annotation.|(% style="width:247px" %)Codelist|(% style="width:332px" %) |(% style="width:224px" %) |(% style="width:229px" %)
666 +|LEGAL_BASIS|(% style="width:463px" %)(((
667 +Indicates that the Legislation on which the codelist/nomenclature is based.
668 +Example for NACE Rev.2.1
669 +url: [[http:~~/~~/data.europa.eu/eli/reg_del/2023/137/oj>>url:http://data.europa.eu/eli/reg_del/2023/137/oj]]
670 +)))|(% style="width:247px" %)Codelist|(% style="width:332px" %) |(% style="width:224px" %) |(% style="width:229px" %)http:~/~/data.europa.eu/eli/reg_del/2023/137/oj
1011 1011  
1012 -//Example~://
1013 -
1014 -500
1015 -)))|
1016 -|(% style="width:199px" %)SEARCH_WEIGHT|(% style="width:350px" %)Indication of localised boosted dataflows in the search results when ordered by relevance|(% style="width:250px" %)Dataflow|(% style="width:288px" %)(((
1017 -<language>:<integer>,...
1018 -
1019 -//Example~://
1020 -
1021 -"en":"3","es":"4","fr":"5"
1022 -)))|(% style="width:1427px" %)(((
1023 -<integer>
1024 -
1025 -//Example~://
1026 -
1027 -10
1028 -)))|
1029 -
1030 1030  = Concept Scheme SDMX:CS_ANNOT =
1031 1031  
1032 1032  The Concept Scheme for standard Annotations will have the Maintenance Agency SDMX and will describe the following properties for each Annotation. For the information represented by Annotations, the value is in AnnotationTitle apart from the URL property where it is in AnnotationURL.
© Semantic R&D Group, 2026