Skip to Content
Last modified by Artur K. on 2026/05/29 14:28
From version 1.9
edited by Helena K.
on 2026/01/15 23:27
Change comment: There is no comment for this version
To version 3.1
edited by Artur K.
on 2026/05/29 14:28
Change comment: Copied from sdmxsrlocalization:Methodology.Guidelines on Using SDMX Annotations.WebHome

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.helena
1 +xwiki:XWiki.arturkryazhev
Content
... ... @@ -22,13 +22,13 @@
22 22  
23 23  = SDMX Information Model for the Annotation construct =
24 24  
25 -=== SDMX 2.1 ===
25 +== SDMX 2.1 ==
26 26  
27 27  [[image:1768507168026-558.png]]
28 28  
29 29  All classes derived from the abstract class AnnotableArtefact may have Annotations. The Annotation is used to convey extra information to describe SDMX constructs. This information may be in the form of a URL reference, a non-localised text, and/or multiple localised texts (represented by the one-to-many relationship to LocalisedString).
30 30  
31 -=== SDMX 3.0 ===
31 +== SDMX 3.0 ==
32 32  
33 33  [[image:1768507168030-780.png]]
34 34  
... ... @@ -124,335 +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 -<language>:<content>,…
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>,…
143 143  //Example~://
144 -en:Labour force (Employment)
145 -)))|(% style="width:178px" %)<content>|(% style="width:866px" %)
146 -|(% style="width:152px" %)REPLACE_NAME|(% style="width:559px" %)Replace each code name in a component by the value of another component in an observation or series|(% style="width:20px" %)A Dataflow or DSD|(% style="width:506px" %) |(% style="width:178px" %)(((
147 -<component Id to replace name>:<component Id to use name>
148 -
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>
149 149  //Example~://
150 -CUST_BREAKDOWN:CUST_BREAKDOWN_LB
151 -)))|(% style="width:866px" %)
152 -|(% style="width:152px" %)REPLACE_CONTENT|(% style="width:559px" %)Replace the content in a component by the value of another component in an observation or series|(% style="width:20px" %)A Dataflow or DSD|(% style="width:506px" %) |(% style="width:178px" %)(((
153 -<component Id to replace content>:<component Id to use content>
154 -
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>
155 155  //Example~://
156 -
157 -REF_AREA:M49_CODE
158 -)))|(% style="width:866px" %)
159 -|(% 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" %)(((
160 160  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>,…
161 161  
162 -E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes
163 -en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)
164 -en: 01 03 99 wastes not otherwise specified (NHAZW)
165 -)))|(% style="width:20px" %)Item in an Item Scheme|(% style="width:506px" %)(((
166 -<language>:<content>,
167 -
168 -<language>:<content>,…
169 -
170 170  //Example~://
171 -
172 -en:See reference metadata
173 -)))|(% style="width:178px" %)<content>|(% style="width:866px" %)
174 -|(% style="width:152px" %)ORDER|(% style="width:559px" %)Explicit indication of a localised order of items in Items Schemes or artefacts (e.g. Codelist, Concept Scheme, Category Scheme, Dataflow, etc.)|(% style="width:20px" %)(((
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" %)(((
175 175  Either:
176 176  
177 177  * an artefact, or;
178 178  * an item in an Item Scheme
179 -)))|(% style="width:506px" %)(((
174 +)))|(% style="width:289px" %)(((
180 180  <language>:<content>,
181 -
182 182  <language>:<content>,…
183 183  
184 184  //Example~://
185 -
186 -en:10,es:20
187 -)))|(% style="width:178px" %)(((
188 -<content>
189 -
190 -
191 -)))|(% style="width:866px" %)
192 -|(% 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" %)(((
193 193  Code Item that represents a total value. If the attachment is:
194 194  
195 195  * to a Code, the Annotation Text is optional and may contain an explanatory text;
196 196  * to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
197 -)))|(% style="width:20px" %)(((
186 +)))|(% style="width:246px" %)(((
198 198  Either:
199 199  
200 200  * a Code Item that represents a total value, or;
201 201  * a Codelist to specify the code(s) with the total
202 -)))|(% style="width:506px" %)(((
203 -<language>:<explanatory text>,
204 -
205 -<language>:<explanatory text>,…
206 -)))|(% style="width:178px" %)(((
191 +)))|(% style="width:289px" %)(((
192 +<language>:<explanatory text>, 
193 +(% style="background-color:transparent" %)<language>:<explanatory text>,…
194 +)))|(% style="width:321px" %)(((
207 207  Attached to Code Item: <blank>
208 -
209 -Attached to Codelist: <code>,<code>,…
210 -)))|(% style="width:866px" %)
211 -|(% style="width:152px" %)DRILLDOWN|(% style="width:559px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|(% style="width:20px" %)(((
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" %)(((
212 212  Either:
213 213  
214 214  * A Dataflow or DSD
215 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
202 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
216 216  <concept Id>
217 -
218 218  //Example~://
219 -
220 -DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
221 -)))|(% style="width:866px" %)
222 -|(% 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" %)(((
223 223  Indication that an Item in an Item Scheme or an artefact is deprecated.
224 -
225 225  For an item scheme item, the annotation value provides a replacement name for the code name.
226 -
227 227  For an artefact, the URL points to the replacement artefact. May be used in conjunction with SUPERSEED where the replacement artefact references the replaced artefact.
228 -
229 229  Suggestion to use a controlled vocabulary
230 -
231 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
232 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
233 -
234 -or
235 -
236 -TITLE: true (false)
237 -)))|(% 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" %)(((
238 238  Either:
239 239  
240 240  * an artefact, or;
241 241  * an item in an Item Scheme
242 -)))|(% style="width:506px" %)(((
223 +)))|(% style="width:289px" %)(((
243 243  For item scheme item:
244 244  
245 -<language>:<content>,
226 +<language>:<content>,<language>:<content>,…
246 246  
247 -<language>:<content>,…
248 -
249 249  //Example~://
250 -
251 -en:deprecated,fr:obsolète
252 -)))|(% 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" %)(((
253 253  For artefact:
254 -
255 255  <see section URL value defaults and specific locale values>
256 -
257 -
258 258  )))
259 -|(% style="width:152px" %)DEFAULT|(% style="width:559px" %)(((
234 +|(% style="width:243px" %)DEFAULT|(% style="width:442px" %)(((
260 260  Indication that an item in an Item Scheme or artefacts is to be selected by default.
261 261  
262 262  The Annotation defines a selection so that a pre-defined default subset of data can be processed (e.g. visualised, extracted) instead of the entire dataset
263 -)))|(% style="width:20px" %)(((
238 +)))|(% style="width:246px" %)(((
264 264  * Item in ItemScheme, or;
265 265  * DSD, or;
266 266  * a Dataflow
267 267  
268 268  Note: A DEFAULT Annotation attached to a later level in this list supersedes that attached to an earlier level. E.g., a DEFAULT Annotation attached to individual Codes in Codelists is only to be used when there is no DEFAULT Annotation attached to the Dataflow nor to the DSD, and those of DSDs are only to be used when there is no DEFAULT Annotation attached to the Dataflow.
269 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
244 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
270 270  Attached to:
271 271  
272 272  - DSD or Dataflow:
273 -**<concept>=<code>+<code>+…,<concept>=<code>+<code>+…**
248 +**<concept>=<code>+<code>+…,
249 +<concept>=<code>+<code>+…**
274 274  
275 -//Example~:// FREQ=A+Q,TIME_PERIOD_START=2013-01,TIME_PERIOD_END=2018-12
276 -)))|(% style="width:866px" %)
277 -|(% style="width:152px" %)IMAGE|(% style="width:559px" %)A visual identity to associate to Item Scheme Items or artefacts|(% style="width:20px" %)(((
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" %)(((
278 278  Either:
279 279  
280 280  * an artefact, or;
281 281  * an item in an item scheme
282 -)))|(% style="width:506px" %)(((
260 +)))|(% style="width:289px" %)(((
283 283  For localised content in SDMX 2.1
284 -
285 285  <language>:<HTML containing URL to the resource>,
286 -
287 287  <language>:<HTML containing URL to the resource>,…
288 288  
289 289  //Example~://
290 -
291 291  en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”>
292 -)))|(% style="width:178px" %) |(% style="width:866px" %)(((
267 +)))|(% style="width:321px" %) |(% style="width:185px" %)(((
293 293  See section URL value defaults and specific locale values.
294 294  
295 295  //Example~://
296 -https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg
297 -
271 +
272 +https:~/~/sdmx.org/wp-content/uploads/SDMX_map_
273 +small-220x220.jpg
298 298  )))
299 -|(% style="width:152px" %)DRILLDOWN_CONCEPTS|(% style="width:559px" %)Concepts to be displayed in a drilldown operation|(% style="width:20px" %)Dataflow or DSD|(% style="width:506px" %) |(% style="width:178px" %)(((
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" %)(((
300 300  <concept Id>,<concept Id>,…
301 301  
302 302  Example :
303 -
304 -DONOR,RECIPIENT,YEAR,PROJECT_ID,OBS_VALUE,DESCRIPTION,OWNER
305 -)))|(% style="width:866px" %)
306 -|(% style="width:152px" %)NOT_DISPLAYED|(% style="width:559px" %)Used to hide components or their values in the presentation|(% style="width:20px" %)(((
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" %)(((
307 307  Either:
308 308  
309 309  * a Dataflow or DSD, or;
310 310  * an Item in an Item Scheme
311 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
286 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
312 312  Attached to Item in Item Scheme: <blank>
313 313  
314 314  Attached to Dataflow or DSD:
315 -
316 316  <concept Id>,<concept Id>,…
317 -
318 318  Example :
319 -
320 320  DD_DIM (to hide drilldown control concept)
321 -)))|(% style="width:866px" %)
322 -|(% style="width:152px" %)LAYOUT_ROW|(% style="width:559px" %)Dimensions to be presented in rows (concepts on y-axis)|(% style="width:20px" %)(((
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" %)(((
323 323  Either:
324 324  
325 325  * an artefact, or;
326 326  * a Dimension
327 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
299 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
328 328  Attached to Dimension: <blank>
329 329  
330 330  Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,…
331 331  
332 332  //Example~://
333 -
334 334  REF_AREA,MEASURE
335 -)))|(% style="width:866px" %)
336 -|(% style="width:152px" %)LAYOUT_COLUMN|(% style="width:559px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:20px" %)(((
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" %)(((
337 337  Either:
338 338  
339 339  * an artefact, or;
340 -* a Dimension
341 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
311 +
312 +a Dimension
313 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
342 342  Attached to Dimension: <blank>
343 343  
344 344  Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
345 345  
346 346  //Example~://
347 -
348 348  TIME_PERIOD
349 -)))|(% style="width:866px" %)
350 -|(% style="width:152px" %)LAYOUT_FLAG|(% style="width:559px" %)Indication that an attribute and its attribute value should be presented as a flag|(% style="width:20px" %)Dataflow|(% style="width:506px" %) |(% style="width:178px" %)(((
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" %)(((
351 351  <concept Id>,<concept Id>,...
352 352  
353 353  //Example~://
354 -
355 355  OBS_STATUS,CONF_STATUS
356 -)))|(% style="width:866px" %)
357 -|(% style="width:152px" %)LAYOUT_NOTE|(% style="width:559px" %)Indication that an attribute and its attribute value should be presented as a note|(% style="width:20px" %)Dataflow|(% style="width:506px" %) |(% style="width:178px" %)(((
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" %)(((
358 358  <concept Id>,<concept Id>,...
359 359  
360 360  //Example~://
361 -
362 362  OBS_STATUS,CONF_STATUS
363 -)))|(% style="width:866px" %)
364 -|(% style="width:152px" %)(((
332 +)))|(% style="width:185px" %)
333 +|(% style="width:243px" %)(((
365 365  METADATA
366 -
367 -
368 -)))|(% style="width:559px" %)Links an MSD directly to a DSD. Can be used to overcome the complexities of reference metadata linkage|(% style="width:20px" %)DSD|(% style="width:506px" %) |(% style="width:178px" %)MSD URI, e.g. urn:sdmx:org.sdmx.infomodel.metadatastructure.MetadataStructure=OECD:MSD_REF_METADATA(1.0)|(% style="width:866px" %)
369 -|(% style="width:152px" %)LAYOUT_ROW_SECTION|(% style="width:559px" %)Dimension to be presented as a break-down concept at a third hierarchical level above columns and rows.|(% style="width:20px" %)(((
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" %)(((
370 370  Either:
371 371  
372 372  * an artefact, or;
373 -
374 -a Dimension
375 -)))|(% style="width:506px" %) |(% style="width:178px" %)(((
341 +* a Dimension
342 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
376 376  Attached to Dimension: <blank>
377 -
378 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
379 -
344 +~|Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
380 380  //Example~://
381 -
382 382  SEX
383 -)))|(% style="width:866px" %)
384 -|(% style="width:152px" %)EXT_RESOURCE|(% style="width:559px" %)(((
347 +)))|(% style="width:185px" %)
348 +|(% style="width:243px" %)EXT_RESOURCE|(% style="width:442px" %)(((
385 385  A localised link to an external resource associated to the annotated artefact. For example, an ontology item
386 -
387 -//a methodology// en:<a href:"[[https:~~/~~/ec.europa.eu/eurostat/web/waste/methodology>>url:https://ec.europa.eu/eurostat/web/waste/methodology]]">
388 -)))|(% 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" %)(((
389 389  For localised content in SDMX 2.1
390 -
391 - <language>:<HTML containing URL to the resource>,
392 -
353 +<language>:<HTML containing URL to the resource>,
393 393  <language>:<HTML containing URL to the resource>,…
394 394  
395 395  //Example~://
396 -
397 397  en:<a href=”[[http:~~/~~/rdf-vocabulary.ddialliance.org/xkos#depth>>url:http://rdf-vocabulary.ddialliance.org/xkos#depth]]”>
398 -)))|(% style="width:178px" %) |(% style="width:866px" %)(((
358 +)))|(% style="width:321px" %) |(% style="width:185px" %)(((
399 399  See section URL value defaults and specific locale values.
400 400  
401 401  //Example~://
402 402  
403 -http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth
363 +http:~/~/rdf-vocabulary.ddialliance.org/
364 +xkos#depth
404 404  )))
405 -|(% style="width:152px" %)COMBINED_CONCEPTS|(% style="width:559px" %)(((
366 +|(% style="width:243px" %)COMBINED_CONCEPTS|(% style="width:442px" %)(((
406 406  Comma-separated list of concept IDs to show as a concatenated label.
407 -
408 408  The listed concepts’ item contents may be concatenated to generate the target concept.
409 -
410 410  Multiple target concept combinations can be defined by separating the target concepts by ;
411 -)))|(% style="width:20px" %)Dataflow or DSD|(% style="width:506px" %)(((
370 +)))|(% style="width:246px" %)Dataflow or DSD|(% style="width:289px" %)(((
412 412  <language>:<display name>,
413 -
414 414  <language>:<display name>
415 -
416 -e.g. COMBINED_UNIT_MEASURE:PRICE_BASE,UNIT_MEASURE;COMBINED_MEASURE:MEASURE,REF_SECTOR{(en):Combined unit of measure;Combined measure}{(fr):Unité de mesure combinée;Mesure combinée}
417 -)))|(% style="width:178px" %) |(% style="width:866px" %)
418 -|(% 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" %)(((
419 419  Comma-separated list of concept IDs that is used to define the full unit of measure. The concepts must be in the DSD.
420 420  
421 421  The listed concepts’ item contents may be concatenated to generate the unit of measure label (unless the UNIT_MEASURE_LABEL annotation is present).
422 -)))|(% 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" %)(((
423 423  <concept Id>,<concept Id>,…
424 424  
425 -//Example~:// UNIT_MEASURE,UNIT_MULT,TRANSFORMATION [could generate a value of Australian Dollar, Thousands, Non-transformed]
426 -)))|(% style="width:866px" %)
427 -|(% style="width:152px" %)(deprecated) UNIT_MEASURE_LABEL|(% style="width:559px" %)(((
428 -Indicates the concept that enumerates the full unit of measure labels.
429 -
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.
430 430  The concept must be in the DSD. UNIT_MEASURE_LABEL overrides the UNIT_MEASURE_CONCEPTS if both are provided.
431 431  
432 432  Also can be attached to items in item scheme, e.g.
433 433  
434 -Text en:Gram
435 - fr: Gramme
392 +Text en:Gram
393 + fr: Gramme
436 436  url:** **[[**http:~~/~~/data.europa.eu/gzn/su/G**>>url:http://data.europa.eu/gzn/su/G]]
437 -)))|(% 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" %)(((
438 438  This is optional, used if a freetext label is required.
439 439  
440 440  <language>:<content>,
441 -
442 442  <language>:<content>,…
443 443  
444 444  //Example~://
445 445  
446 446  en:USD, thousands
447 -
448 448  fr:USD, milliers
449 -)))|(% style="width:178px" %)(((
405 +)))|(% style="width:321px" %)(((
450 450  This is optional, used if an enumerated list is required.
451 -
452 452  <concept Id>
453 -
454 454  //Example~://
455 -
456 456  UOM_ATTRIBUTE [This concept may contain the following items as units of measure:
457 457  
458 458  * National Currency, thousands
... ... @@ -459,177 +459,262 @@
459 459  * USD, thousands
460 460  
461 461  Index, based on National Currency]
462 -)))|(% style="width:866px" %)
463 -|(% style="width:152px" %)(((
415 +)))|(% style="width:185px" %)
416 +|(% style="width:243px" %)(((
464 464  LAYOUT_TIME_PERIOD_DESC
465 -
466 -
467 -)))|(% style="width:559px" %)Indication that the display of the TIME_PERIOD dimension for a dataflow, or all dataflows of the same DSD, is to be done in descending sort order.|(% style="width:20px" %)Dataflow, DSD|(% style="width:506px" %) |(% style="width:178px" %)(((
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" %)(((
468 468  //Example~://
469 469  
470 470  LAYOUT_TIME_PERIOD_DESC
471 -)))|(% style="width:866px" %)
472 -|(% style="width:152px" %)(((
422 +)))|(% style="width:185px" %)
423 +|(% style="width:243px" %)(((
473 473  LAYOUT_CELL_ALIGN
474 -
475 -
476 -)))|(% style="width:559px" %)Indication to force the data cell alignment to the left or to the right. This can be defined generically for all locales or per locale.|(% style="width:20px" %)Dataflow, DSD, Dimension|(% style="width:506px" %)(((
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" %)(((
477 477  <language>:<content>,
478 -
479 479  <language>:<content>,…
480 -
481 -
482 482  <content> values:RIGHT or LEFT
483 -)))|(% style="width:178px" %)Content values:RIGHT or LEFT|(% style="width:866px" %)
484 -|(% style="width:152px" %)(((
429 +)))|(% style="width:321px" %)Content values:RIGHT or LEFT|(% style="width:185px" %)
430 +|(% style="width:243px" %)(((
485 485  MAX_TABLE_DATA
486 -
487 -
488 -)))|(% style="width:559px" %)Increase the maximum preview table size above default maximum limits for the number of observations retrieved from the SDMX web service and for the number of table cells|(% style="width:20px" %)Dataflow|(% style="width:506px" %) |(% style="width:178px" %)(((
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" %)(((
489 489  <integer>
490 -
491 491  //Example~://
492 -
493 493  15000
494 -)))|(% style="width:866px" %)
495 -|(% style="width:152px" %)(((
436 +)))|(% style="width:185px" %)
437 +|(% style="width:243px" %)(((
496 496  MAXTEXTATTRIBUTELENGTH
497 -
498 -
499 -)))|(% 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" %)(((
500 500  <integer>
501 501  
502 502  //Example~://
503 503  
504 504  500
505 -)))|(% style="width:866px" %)
506 -|(% style="width:152px" %)SEARCH_WEIGHT|(% style="width:559px" %)Indication of localised boosted dataflows in the search results when ordered by relevance|(% style="width:20px" %)Dataflow|(% style="width:506px" %)(((
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" %)(((
507 507  <language>:<integer>,...
508 508  //Example~://
509 509  "en":"3","es":"4","fr":"5"
510 -)))|(% style="width:178px" %)(((
450 +)))|(% style="width:321px" %)(((
511 511  <integer>
512 512  
513 513  //Example~://
514 514  
515 515  10
516 -)))|(% style="width:866px" %)
456 +)))|(% style="width:185px" %)
517 517  
518 518  == Codelist and Statistical Classification-specific Annotations ==
519 519  
520 520  The categories below are used widely, for example by the European Statistical System (ESS), and the United Nations Statistics Division for its central framework classifications ISIC4{{footnote}}International Standard Industrial Classification of All Economic Activities{{/footnote}} and CPC{{footnote}}Central Product Classification{{/footnote}}.
521 521  
522 -|**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" %)(((
523 523  **+Text
524 -(% style="background-color:transparent" %)Blue is optional(%%)**
525 -)))|(% style="width:320px" %)(((
465 +Blue is optional**
466 +)))|(% style="width:224px" %)(((
526 526  **Title
527 -(% style="background-color:transparent" %)Blue is optional(%%)**
528 -)))|(% style="width:203px" %)(((
468 +Blue is optional**
469 +)))|(% style="width:229px" %)(((
529 529  **SDMX 2.1:URL
530 530  SDMX >=3.0:+URL
531 -(% style="background-color:transparent" %)Blue is optional(%%)**
472 +Blue is optional**
532 532  )))
533 -|FULL_NAME|(% style="width:524px" %)Alternative name to be displayed for items in Item Schemes (e.g. Codelists, Concept Schemes, Category Schemes) whenever the item is displayed without its parent. For example, if a code list that has a hierarchy is displayed as a flat list, then this annotation may be used to provide sufficient context for the code. Concatenation of code + heading in NACE Rev.2.1 
534 -en: A0123 Growing of citrus fruits|(% style="width:198px" %)Item in an Item Scheme|(% style="width:237px" %)(((
535 -<language>:<content>,<language>:<content>,…
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~://
477 +
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>
536 536  //Example~://
537 -(% style="background-color:transparent" %)en:Labour force (Employment)
538 -)))|(% style="width:320px" %)<content>|(% style="width:203px" %)
539 -|REPLACE_NAME|(% style="width:524px" %)Replace each code name in a component by the value of another component in an observation or series|(% style="width:198px" %)A Dataflow or DSD|(% style="width:237px" %) |(% style="width:320px" %)(((
540 -<component Id to replace name>:<component Id to use name>
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
491 +
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>
541 541  //Example~://
542 -(% style="background-color:transparent" %)CUST_BREAKDOWN:CUST_BREAKDOWN_LB
543 -)))|(% style="width:203px" %)
544 -|REPLACE_CONTENT|(% style="width:524px" %)Replace the content in a component by the value of another component in an observation or series|(% style="width:198px" %)A Dataflow or DSD|(% style="width:237px" %) |(% style="width:320px" %)(((
545 -<component Id to replace content>:<component Id to use content>
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>,
502 +
503 +<language>:<content>,…
504 +)))|(% style="width:224px" %)(((
546 546  //Example~://
547 -(% style="background-color:transparent" %)REF_AREA:M49_CODE
548 -)))|(% style="width:203px" %)
549 -|COMPLEMENT|(% style="width:524px" %)(((
550 -Additional fixed text to be displayed in parenthesis after the code name.
551 -(% style="background-color:transparent" %)E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes(%%)
552 -(% style="background-color:transparent" %)en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)(%%)
553 -(% style="background-color:transparent" %)en: 01 03 99 wastes not otherwise specified (NHAZW)
554 -)))|(% style="width:198px" %)Item in an Item Scheme|(% style="width:237px" %)(((
555 -<language>:<content>,<language>:<content>,…
556 556  
507 +[Official French label “Transformation et conservation de la viande de boucherie” is shortened to] fr:Transf. & conserv. viande de boucherie
508 +
509 +In Codelist=IMF:CL_AREA(1.13)
510 +Code 4J837 European Union Intellectual Property Office has a Short_Label
511 +
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" %)(((
515 +<language>:<content>,
516 +
517 +<language>:<content>,…
518 +)))|(% style="width:224px" %)(((
557 557  //Example~://
558 -(% style="background-color:transparent" %)en:See reference metadata
559 -)))|(% style="width:320px" %)<content>|(% style="width:203px" %)
560 -|ORDER|(% style="width:524px" %)Explicit indication of a localised order of items in Items Schemes or artefacts (e.g. Codelist, Concept Scheme, Category Scheme, Dataflow, etc.)|(% style="width:198px" %)(((
561 -Either:
562 562  
563 -* an artefact, or;
564 -* an item in an Item Scheme
565 -)))|(% style="width:237px" %)(((
566 -<language>:<content>,<language>:<content>,…
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>,
567 567  
526 +<language>:<content>,…
527 +)))|(% style="width:224px" %)(((
528 +Example (from the US NAICS classification):
529 +
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" %)(((
533 +<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:
538 +
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>,
546 +<language>:<content>,…
547 +
548 +Example (from NACE Rev. 2 caselaw to code 01.62):
549 +
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" %)(((
553 +<language>:<content>,
554 +
555 +<language>:<content>,…
556 +)))|(% style="width:224px" %)(((
557 +Example (from ISIC Rev. 4 explanatory notes to code 2520 - Manufacture of weapons and ammunition):
558 +
559 +en:This class also includes:
560 +
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
566 +
567 +
568 +)))|(% style="width:332px" %)(((
569 +<language>:<content>,
570 +<language>:<content>,…
571 +)))|(% style="width:224px" %)(((
572 +Example (from ISIC Rev. 4 explanatory notes to code 2520 - Manufacture of weapons and ammunition):
573 +
574 +en:This class excludes:
575 +
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.
581 +
582 +
583 +)))
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>
586 +
568 568  //Example~://
569 -(% style="background-color:transparent" %)en:10,es:20
570 -)))|(% style="width:320px" %)<content>|(% style="width:203px" %)
571 -|TOTAL|(% style="width:524px" %)(((
572 -Code Item that represents a total value. If the attachment is:
573 573  
574 -* to a Code, the Annotation Text is optional and may contain an explanatory text;
575 -* to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
576 -)))|(% style="width:198px" %)(((
577 -Either:
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" %)(((
596 +See section URL value defaults and specific locale values.
597 +//Example~://
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]]
601 +)))
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
578 578  
579 -* a Code Item that represents a total value, or;
580 -* a Codelist to specify the code(s) with the total
581 -)))|(% style="width:237px" %)(((
582 -<language>:<explanatory text>, 
583 -(% style="background-color:transparent" %)<language>:<explanatory text>,…
584 -)))|(% style="width:320px" %)(((
585 -Attached to Code Item: <blank>
586 -(% style="background-color:transparent" %)Attached to Codelist: <code>,<code>,…
587 -)))|(% style="width:203px" %)
588 -|DRILLDOWN|(% style="width:524px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|(% style="width:198px" %)(((
589 -Either:
590 590  
591 -* A Dataflow or DSD
592 -)))|(% style="width:237px" %) |(% style="width:320px" %)(((
593 -<concept Id>
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.
610 +
611 +
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" %)(((
618 +See section URL value defaults and specific locale values.
619 +
620 +
621 +)))
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" %)(((
627 +<language>:<content>,
628 +<language>:<content>,…
629 +
594 594  //Example~://
595 -(% style="background-color:transparent" %)DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
596 -)))|(% style="width:203px" %)
597 -|DEPRECATED|(% style="width:524px" %)(((
598 -Indication that an Item in an Item Scheme or an artefact is deprecated.
599 -For an item scheme item, the annotation value provides a replacement name for the code name.
600 -For an artefact, the URL points to the replacement artefact. May be used in conjunction with SUPERSEED where the replacement artefact references the replaced artefact.
601 -Suggestion to use a controlled vocabulary
602 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
603 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
604 -or
605 -(% style="background-color:transparent" %)TITLE: true (false)
606 -)))|(% style="width:198px" %)(((
607 -Either:
631 +en:NACE
632 +)))|(% style="width:224px" %) |(% style="width:229px" %)(((
633 +See section URL value defaults and specific locale values.
608 608  
609 -* an artefact, or;
610 -* an item in an Item Scheme
611 -)))|(% style="width:237px" %)(((
612 -For item scheme item:
635 +
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
613 613  
614 -<language>:<content>,<language>:<content>,…
641 +//Examples~://
642 +URL <http:~/~/eurovoc.europa.eu/56> (National accounts)
615 615  
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" %)(((
647 +<language>:<content>,
648 +
649 +<language>:<content>,…
650 +
616 616  //Example~://
617 -(% style="background-color:transparent" %)en:deprecated,fr:obsolète
618 -)))|(% style="width:320px" %)<content>|(% style="width:203px" %)(((
619 -For artefact:
620 -<see section URL value defaults and specific locale values>
652 +
653 +En:national accounts
654 +)))|(% style="width:224px" %) |(% style="width:229px" %)(((
655 +See section URL value defaults and specific locale values.
656 +
657 +
621 621  )))
622 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
623 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
624 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
625 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
626 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
627 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
628 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
629 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
630 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
631 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
632 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
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
633 633  
634 634  = Concept Scheme SDMX:CS_ANNOT =
635 635  
© Semantic R&D Group, 2026