FULL_NAME annotations for alternative labels in SDMX-CSV downloads
As a .Stat DE user (of data downloads, e.g. in the visualisation page and data viewer)
In order to ease understanding the statistical meaning of dimension values at hierarchy leaf levels ("child codes") when there is no information about their hierarchical parents
I want to get the dimension value's localised alternative label if that was defined by the data owner.
Scenario 1: The SDMX-CSV download uses localised alternative labels defined in "FULL_NAME" annotations
Given that I'm using the SDMX API (NSI web service) to request data in SDMX-CSV format
When there is an alternative label defined for a child (non-root) code through its "FULL_NAME" annotation for the current locale
Then in the generated SDMX-CSV message, the original code's name is replaced by the localised alternative label.
References
- Aha! functional specifications https://oecd.aha.io/features/ONEDATA-72
- Syntax in the Item of an ItemScheme (e.g. Code in a Codelist):
"annotations": [{ "text": { "en": "This is my full name", "fr": "Ceci est mon nom complet" }, "type": "FULL_NAME" }]
Dataflow test example
The following dataflow has alternative labels in one codelist with a simple hierarchy DIMENSION_SECTION3: https://dotstatcor-dev2.main.oecd.org/PMPMDataExplorer/#/vis?locale=en&endpointId=PM&agencyId=OECD&code=TEST_ANN2&version=1.6