Skip to Content
Last modified by Artur K. on 2026/05/29 14:28
From version 1.11
edited by Helena K.
on 2026/01/15 23:41
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,96 +124,103 @@
124 124  
125 125  == General and Display-related Annotation types ==
126 126  
127 -|**Annotation Type**|(% style="width:524px" %)**Use Case**|(% style="width:198px" %)**Where to attach**|(% style="width:237px" %)(((
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" %)(((
128 128  **+Text
129 129  (% style="background-color:transparent" %)Blue is optional(%%)**
130 -)))|(% style="width:320px" %)(((
131 +)))|(% style="width:321px" %)(((
131 131  **Title
132 132  (% style="background-color:transparent" %)Blue is optional(%%)**
133 -)))|(% style="width:203px" %)(((
134 +)))|(% style="width:185px" %)(((
134 134  **SDMX 2.1:URL
135 135  SDMX >=3.0:+URL
136 136  (% style="background-color:transparent" %)Blue is optional(%%)**
137 137  )))
138 -|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 
139 -en: A0123 Growing of citrus fruits|(% style="width:198px" %)Item in an Item Scheme|(% style="width:237px" %)(((
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" %)(((
140 140  <language>:<content>,<language>:<content>,…
141 141  //Example~://
142 142  (% style="background-color:transparent" %)en:Labour force (Employment)
143 -)))|(% style="width:320px" %)<content>|(% style="width:203px" %)
144 -|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" %)(((
145 -<component Id to replace name>:<component Id to use name>
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>
146 146  //Example~://
147 -(% style="background-color:transparent" %)CUST_BREAKDOWN:CUST_BREAKDOWN_LB
148 -)))|(% style="width:203px" %)
149 -|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" %)(((
150 -<component Id to replace content>:<component Id to use content>
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>
151 151  //Example~://
152 152  (% style="background-color:transparent" %)REF_AREA:M49_CODE
153 -)))|(% style="width:203px" %)
154 -|COMPLEMENT|(% style="width:524px" %)(((
157 +)))|(% style="width:185px" %)
158 +|(% style="width:243px" %)COMPLEMENT|(% style="width:442px" %)(((
155 155  Additional fixed text to be displayed in parenthesis after the code name.
156 156  (% style="background-color:transparent" %)E.g. Representation of Non-hazardous (NHAZW), hazardous waste (HAZW) in the European List of Wastes(%%)
157 157  (% style="background-color:transparent" %)en: 01 03 04* acid-generating tailings from processing of sulphide ore (HAZW)(%%)
158 158  (% style="background-color:transparent" %)en: 01 03 99 wastes not otherwise specified (NHAZW)
159 -)))|(% style="width:198px" %)Item in an Item Scheme|(% style="width:237px" %)(((
163 +)))|(% style="width:246px" %)Item in an Item Scheme|(% style="width:289px" %)(((
160 160  <language>:<content>,<language>:<content>,…
161 161  
162 162  //Example~://
163 163  (% style="background-color:transparent" %)en:See reference metadata
164 -)))|(% style="width:320px" %)<content>|(% style="width:203px" %)
165 -|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" %)(((
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" %)(((
166 166  Either:
167 167  
168 168  * an artefact, or;
169 169  * an item in an Item Scheme
170 -)))|(% style="width:237px" %)(((
171 -<language>:<content>,<language>:<content>,…
174 +)))|(% style="width:289px" %)(((
175 +<language>:<content>,
176 +<language>:<content>,…
172 172  
173 173  //Example~://
174 174  (% style="background-color:transparent" %)en:10,es:20
175 -)))|(% style="width:320px" %)<content>|(% style="width:203px" %)
176 -|TOTAL|(% style="width:524px" %)(((
180 +)))|(% style="width:321px" %)<content>|(% style="width:185px" %)
181 +|(% style="width:243px" %)TOTAL|(% style="width:442px" %)(((
177 177  Code Item that represents a total value. If the attachment is:
178 178  
179 179  * to a Code, the Annotation Text is optional and may contain an explanatory text;
180 180  * to a Codelist, the Annotation Title is mandatory and includes the code(s) that represent a total
181 -)))|(% style="width:198px" %)(((
186 +)))|(% style="width:246px" %)(((
182 182  Either:
183 183  
184 184  * a Code Item that represents a total value, or;
185 185  * a Codelist to specify the code(s) with the total
186 -)))|(% style="width:237px" %)(((
191 +)))|(% style="width:289px" %)(((
187 187  <language>:<explanatory text>, 
188 188  (% style="background-color:transparent" %)<language>:<explanatory text>,…
189 -)))|(% style="width:320px" %)(((
194 +)))|(% style="width:321px" %)(((
190 190  Attached to Code Item: <blank>
191 191  (% style="background-color:transparent" %)Attached to Codelist: <code>,<code>,…
192 -)))|(% style="width:203px" %)
193 -|DRILLDOWN|(% style="width:524px" %)Denotes the concept that specifies whether observations are at the aggregate level or a drilldown.|(% style="width:198px" %)(((
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" %)(((
194 194  Either:
195 195  
196 196  * A Dataflow or DSD
197 -)))|(% style="width:237px" %) |(% style="width:320px" %)(((
202 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
198 198  <concept Id>
199 199  //Example~://
200 200  (% style="background-color:transparent" %)DD_DIM (this concept should be hidden using the NOT_DISPLAYED Annotation below)
201 -)))|(% style="width:203px" %)
202 -|DEPRECATED|(% style="width:524px" %)(((
206 +)))|(% style="width:185px" %)
207 +|(% style="width:243px" %)DEPRECATED|(% style="width:442px" %)(((
203 203  Indication that an Item in an Item Scheme or an artefact is deprecated.
204 204  For an item scheme item, the annotation value provides a replacement name for the code name.
205 205  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.
206 206  Suggestion to use a controlled vocabulary
207 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/CURRENT>>url:http://publications.europa.eu/resource/authority/concept-status/CURRENT]]>
208 -url: <[[http:~~/~~/publications.europa.eu/resource/authority/concept-status/DEPRECATED>>url:http://publications.europa.eu/resource/authority/concept-status/DEPRECATED]]>
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]]>
209 209  or
210 210  (% style="background-color:transparent" %)TITLE: true (false)
211 -)))|(% style="width:198px" %)(((
218 +)))|(% style="width:246px" %)(((
212 212  Either:
213 213  
214 214  * an artefact, or;
215 215  * an item in an Item Scheme
216 -)))|(% style="width:237px" %)(((
223 +)))|(% style="width:289px" %)(((
217 217  For item scheme item:
218 218  
219 219  <language>:<content>,<language>:<content>,…
... ... @@ -220,177 +220,448 @@
220 220  
221 221  //Example~://
222 222  (% style="background-color:transparent" %)en:deprecated,fr:obsolète
223 -)))|(% style="width:320px" %)<content>|(% style="width:203px" %)(((
230 +)))|(% style="width:321px" %)<content>|(% style="width:185px" %)(((
224 224  For artefact:
225 225  <see section URL value defaults and specific locale values>
226 226  )))
227 -|DEFAULT|(% style="width:524px" %)(((
234 +|(% style="width:243px" %)DEFAULT|(% style="width:442px" %)(((
228 228  Indication that an item in an Item Scheme or artefacts is to be selected by default.
229 229  
230 230  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
231 -)))|(% style="width:198px" %)(((
238 +)))|(% style="width:246px" %)(((
232 232  * Item in ItemScheme, or;
233 233  * DSD, or;
234 234  * a Dataflow
235 235  
236 236  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.
237 -)))|(% style="width:237px" %) |(% style="width:320px" %)(((
244 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
238 238  Attached to:
239 239  
240 240  - DSD or Dataflow:
241 -**<concept>=<code>+<code>+…,<concept>=<code>+<code>+…**
248 +**<concept>=<code>+<code>+…,
249 +<concept>=<code>+<code>+…**
242 242  
243 -//Example~:// FREQ=A+Q,TIME_PERIOD_START=2013-01,TIME_PERIOD_END=2018-12
244 -)))|(% style="width:203px" %)
245 -|IMAGE|(% style="width:524px" %)A visual identity to associate to Item Scheme Items or artefacts|(% style="width:198px" %)(((
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" %)(((
246 246  Either:
247 247  
248 248  * an artefact, or;
249 249  * an item in an item scheme
250 -)))|(% style="width:237px" %)(((
260 +)))|(% style="width:289px" %)(((
251 251  For localised content in SDMX 2.1
252 -
253 253  <language>:<HTML containing URL to the resource>,
254 -
255 255  <language>:<HTML containing URL to the resource>,…
256 256  
257 257  //Example~://
258 -
259 259  en:<a href=”https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg”>
260 -)))|(% style="width:320px" %) |(% style="width:203px" %)(((
267 +)))|(% style="width:321px" %) |(% style="width:185px" %)(((
261 261  See section URL value defaults and specific locale values.
262 262  
263 263  //Example~://
264 264  
265 -https:~/~/sdmx.org/wp-content/uploads/SDMX_map_small-220x220.jpg
272 +https:~/~/sdmx.org/wp-content/uploads/SDMX_map_
273 +small-220x220.jpg
266 266  )))
267 -|DRILLDOWN_CONCEPTS|(% style="width:524px" %)Concepts to be displayed in a drilldown operation|(% style="width:198px" %)Dataflow or DSD|(% style="width:237px" %) |(% style="width:320px" %)(((
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" %)(((
268 268  <concept Id>,<concept Id>,…
269 269  
270 270  Example :
271 -
272 272  DONOR,RECIPIENT,YEAR,PROJECT_ID, OBS_VALUE,DESCRIPTION,OWNER
273 -)))|(% style="width:203px" %)
274 -|NOT_DISPLAYED|(% style="width:524px" %)Used to hide components or their values in the presentation|(% style="width:198px" %)(((
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" %)(((
275 275  Either:
276 276  
277 277  * a Dataflow or DSD, or;
278 278  * an Item in an Item Scheme
279 -)))|(% style="width:237px" %) |(% style="width:320px" %)(((
286 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
280 280  Attached to Item in Item Scheme: <blank>
281 281  
282 282  Attached to Dataflow or DSD:
283 -
284 284  <concept Id>,<concept Id>,…
285 -
286 286  Example :
287 -
288 288  DD_DIM (to hide drilldown control concept)
289 -)))|(% style="width:203px" %)
290 -|LAYOUT_ROW|(% style="width:524px" %)Dimensions to be presented in rows (concepts on y-axis)|(% style="width:198px" %)(((
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" %)(((
291 291  Either:
292 292  
293 293  * an artefact, or;
294 294  * a Dimension
295 -)))|(% style="width:237px" %) |(% style="width:320px" %)(((
299 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
296 296  Attached to Dimension: <blank>
297 297  
298 298  Attached to Dataflow or DSD: <dimension Id>,<dimension Id >,…
299 299  
300 300  //Example~://
301 -
302 302  REF_AREA,MEASURE
303 -)))|(% style="width:203px" %)
304 -|LAYOUT_COLUMN|(% style="width:524px" %)Dimensions to be presented in columns (concepts on x-axis)|(% style="width:198px" %)(((
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" %)(((
305 305  Either:
306 306  
307 307  * an artefact, or;
308 308  
309 309  a Dimension
310 -)))|(% style="width:237px" %) |(% style="width:320px" %)(((
313 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
311 311  Attached to Dimension: <blank>
312 312  
313 313  Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
314 314  
315 315  //Example~://
316 -
317 317  TIME_PERIOD
318 -)))|(% style="width:203px" %)
319 -|LAYOUT_FLAG|(% style="width:524px" %)Indication that an attribute and its attribute value should be presented as a flag|(% style="width:198px" %)Dataflow|(% style="width:237px" %) |(% style="width:320px" %)(((
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" %)(((
320 320  <concept Id>,<concept Id>,...
321 321  
322 322  //Example~://
323 -
324 324  OBS_STATUS,CONF_STATUS
325 -)))|(% style="width:203px" %)
326 -|LAYOUT_NOTE|(% style="width:524px" %)Indication that an attribute and its attribute value should be presented as a note|(% style="width:198px" %)Dataflow|(% style="width:237px" %) |(% style="width:320px" %)(((
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" %)(((
327 327  <concept Id>,<concept Id>,...
328 328  
329 329  //Example~://
330 -
331 331  OBS_STATUS,CONF_STATUS
332 -)))|(% style="width:203px" %)
333 -|(((
332 +)))|(% style="width:185px" %)
333 +|(% style="width:243px" %)(((
334 334  METADATA
335 -)))|(% style="width:524px" %)Links an MSD directly to a DSD. Can be used to overcome the complexities of reference metadata linkage|(% style="width:198px" %)DSD|(% style="width:237px" %) |(% style="width:320px" %)MSD URI, e.g. urn:sdmx:org.sdmx.infomodel.metadatastructure.MetadataStructure =OECD:MSD_REF_METADATA(1.0)|(% style="width:203px" %)
336 -|LAYOUT_ROW_SECTION|(% style="width:524px" %)Dimension to be presented as a break-down concept at a third hierarchical level above columns and rows.|(% style="width:198px" %)(((
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" %)(((
337 337  Either:
338 338  
339 339  * an artefact, or;
340 340  * a Dimension
341 -)))|(% style="width:237px" %) |(% style="width:320px" %)(((
342 +)))|(% style="width:289px" %) |(% style="width:321px" %)(((
342 342  Attached to Dimension: <blank>
343 -
344 -Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
345 -
344 +~|Attached to Dataflow or DSD: <dimension Id>,<dimension Id>,…
346 346  //Example~://
347 -
348 348  SEX
349 -)))|(% style="width:203px" %)
350 -|EXT_RESOURCE|(% style="width:524px" %)(((
347 +)))|(% style="width:185px" %)
348 +|(% style="width:243px" %)EXT_RESOURCE|(% style="width:442px" %)(((
351 351  A localised link to an external resource associated to the annotated artefact. For example, an ontology item
352 -
353 -//a methodology// en:<a href:"[[https:~~/~~/ec.europa.eu/eurostat/web/waste/methodology>>url:https://ec.europa.eu/eurostat/web/waste/methodology]]">
354 -)))|(% style="width:198px" %)Any SDMX object|(% style="width:237px" %)(((
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" %)(((
355 355  For localised content in SDMX 2.1
356 -
357 - <language>:<HTML containing URL to the resource>,
358 -
353 +<language>:<HTML containing URL to the resource>,
359 359  <language>:<HTML containing URL to the resource>,…
360 360  
361 361  //Example~://
362 -
363 363  en:<a href=”[[http:~~/~~/rdf-vocabulary.ddialliance.org/xkos#depth>>url:http://rdf-vocabulary.ddialliance.org/xkos#depth]]”>
364 -)))|(% style="width:320px" %) |(% style="width:203px" %)(((
358 +)))|(% style="width:321px" %) |(% style="width:185px" %)(((
365 365  See section URL value defaults and specific locale values.
366 366  
367 367  //Example~://
368 368  
369 -http:~/~/rdf-vocabulary.ddialliance.org/xkos#depth
363 +http:~/~/rdf-vocabulary.ddialliance.org/
364 +xkos#depth
370 370  )))
371 -|COMBINED_CONCEPTS|(% style="width:524px" %)(((
366 +|(% style="width:243px" %)COMBINED_CONCEPTS|(% style="width:442px" %)(((
372 372  Comma-separated list of concept IDs to show as a concatenated label.
373 -
374 374  The listed concepts’ item contents may be concatenated to generate the target concept.
375 -
376 376  Multiple target concept combinations can be defined by separating the target concepts by ;
377 -)))|(% style="width:198px" %)Dataflow or DSD|(% style="width:237px" %)(((
370 +)))|(% style="width:246px" %)Dataflow or DSD|(% style="width:289px" %)(((
378 378  <language>:<display name>,
379 379  <language>:<display name>
380 -(% style="background-color:transparent" %)e.g. COMBINED_UNIT_MEASURE:PRICE_BASE, UNIT_MEASURE;COMBINED_MEASURE:MEASURE, REF_SECTOR{(en):Combined unit of measure;Combined measure}{(fr):Unité de mesure combinée;Mesure combinée}
381 -)))|(% style="width:320px" %) |(% style="width:203px" %)
382 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
383 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
384 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
385 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
386 -| |(% style="width:524px" %) |(% style="width:198px" %) |(% style="width:237px" %) |(% style="width:320px" %) |(% style="width:203px" %)
387 -
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" %)(((
377 +Comma-separated list of concept IDs that is used to define the full unit of measure. The concepts must be in the DSD.
388 388  
379 +The listed concepts’ item contents may be concatenated to generate the unit of measure label (unless the UNIT_MEASURE_LABEL annotation is present).
380 +)))|(% style="width:246px" %)Dataflow or DSD|(% style="width:289px" %) |(% style="width:321px" %)(((
381 +<concept Id>,<concept Id>,…
382 +
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.
388 +The concept must be in the DSD. UNIT_MEASURE_LABEL overrides the UNIT_MEASURE_CONCEPTS if both are provided.
389 +
390 +Also can be attached to items in item scheme, e.g.
391 +
392 +Text en:Gram
393 + fr: Gramme
394 +url:** **[[**http:~~/~~/data.europa.eu/gzn/su/G**>>url:http://data.europa.eu/gzn/su/G]]
395 +)))|(% style="width:246px" %)Dataflow or DSD, Item in an Item Scheme|(% style="width:289px" %)(((
396 +This is optional, used if a freetext label is required.
397 +
398 +<language>:<content>,
399 +<language>:<content>,…
400 +
401 +//Example~://
402 +
403 +en:USD, thousands
404 +fr:USD, milliers
405 +)))|(% style="width:321px" %)(((
406 +This is optional, used if an enumerated list is required.
407 +<concept Id>
408 +//Example~://
409 +UOM_ATTRIBUTE [This concept may contain the following items as units of measure:
410 +
411 +* National Currency, thousands
412 +* USD, thousands
413 +
414 +Index, based on National Currency]
415 +)))|(% style="width:185px" %)
416 +|(% style="width:243px" %)(((
417 +LAYOUT_TIME_PERIOD_DESC
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" %)(((
419 +//Example~://
420 +
421 +LAYOUT_TIME_PERIOD_DESC
422 +)))|(% style="width:185px" %)
423 +|(% style="width:243px" %)(((
424 +LAYOUT_CELL_ALIGN
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" %)(((
426 +<language>:<content>,
427 +<language>:<content>,…
428 +<content> values:RIGHT or LEFT
429 +)))|(% style="width:321px" %)Content values:RIGHT or LEFT|(% style="width:185px" %)
430 +|(% style="width:243px" %)(((
431 +MAX_TABLE_DATA
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" %)(((
433 +<integer>
434 +//Example~://
435 +15000
436 +)))|(% style="width:185px" %)
437 +|(% style="width:243px" %)(((
438 +MAXTEXTATTRIBUTELENGTH
439 +)))|(% style="width:442px" %)Increase the maximum length for textual attribute values|(% style="width:246px" %)DSD|(% style="width:289px" %) |(% style="width:321px" %)(((
440 +<integer>
441 +
442 +//Example~://
443 +
444 +500
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" %)(((
447 +<language>:<integer>,...
448 +//Example~://
449 +"en":"3","es":"4","fr":"5"
450 +)))|(% style="width:321px" %)(((
451 +<integer>
452 +
453 +//Example~://
454 +
455 +10
456 +)))|(% style="width:185px" %)
457 +
389 389  == Codelist and Statistical Classification-specific Annotations ==
390 390  
391 391  The categories below are used widely, for example by the European Statistical System (ESS), and the United Nations Statistics Division for its central framework classifications ISIC4{{footnote}}International Standard Industrial Classification of All Economic Activities{{/footnote}} and CPC{{footnote}}Central Product Classification{{/footnote}}.
392 392  
462 +(% style="width:1785.2px" %)
463 +|**Annotation Type**|(% style="width:463px" %)**Use Case**|(% style="width:247px" %)**Where to attach**|(% style="width:332px" %)(((
464 +**+Text
465 +Blue is optional**
466 +)))|(% style="width:224px" %)(((
467 +**Title
468 +Blue is optional**
469 +)))|(% style="width:229px" %)(((
470 +**SDMX 2.1:URL
471 +SDMX >=3.0:+URL
472 +Blue is optional**
473 +)))
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~://
393 393  
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>
486 +//Example~://
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>
496 +//Example~://
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" %)(((
505 +//Example~://
506 +
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" %)(((
519 +//Example~://
520 +
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>,
525 +
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 +
587 +//Example~://
588 +
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
605 +
606 +
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 +
630 +//Example~://
631 +en:NACE
632 +)))|(% style="width:224px" %) |(% style="width:229px" %)(((
633 +See section URL value defaults and specific locale values.
634 +
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
640 +
641 +//Examples~://
642 +URL <http:~/~/eurovoc.europa.eu/56> (National accounts)
643 +
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 +
651 +//Example~://
652 +
653 +En:national accounts
654 +)))|(% style="width:224px" %) |(% style="width:229px" %)(((
655 +See section URL value defaults and specific locale values.
656 +
657 +
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
671 +
394 394  = Concept Scheme SDMX:CS_ANNOT =
395 395  
396 396  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