Reporting Taxonomy¶
A Reporting Taxonomy is an item scheme of Reporting Categories, which groups the structures (Data Structures, Metadata
Structures) and the dataflows or metadataflows used for a reporting exercise. Reporting categories are hierarchical:
a child category is nested inside its parent, exactly as in a Category Scheme. Documents start
ref: "ReportingTaxonomy=AGENCY:ID(1.0)".
Simple form¶
A reporting category with an English name only, and no references or children, is written as ID: "name".
format: "fusion-yaml(1.0.0)"
ref: "ReportingTaxonomy=SDMX:STAT_SUBJECT_MATTER(1.0.1)"
name: "TEST"
items:
- ECO_ACCOUNTS: "Economic accounts"
- MACROECO_STAT: "Macroeconomic statistics"
The document starts with the common header. The body is:
items: the top level reporting categories, in scheme order, written as described in Items.
Complex form¶
A reporting category becomes an object when it references structural or provisioning metadata, or when it has child categories (as well as for the usual reasons: a description, a non-English name, a uri, annotations or links).
format: "fusion-yaml(1.0.0)"
ref: "ReportingTaxonomy=SDMX:STAT_SUBJECT_MATTER(1.0.1)"
name: "TEST"
items:
- DEMO_SOCIAL_STAT:
name: "Demographic and social statistics"
items:
- LABOUR: "Labour"
- HEALTH:
name: "Health"
structuralMetadata: "DataStructure=NHS:COVID(1.1.0)"
- INCOME_CONSUMP: "Income and consumption"
- MACROECO_STAT:
name: "Macroeconomic statistics"
structuralMetadata: "DataStructure=ECB:EXR(1.2.0)"
- MACROECO_STAT:
name: "Macroeconomic statistics"
provisioningMetadata: "Dataflow=ECB:DF_EXR(1.2.0)"
structuralMetadatalists the Data Structures or Metadata Structures, andprovisioningMetadatalists the Dataflows or Metadataflows. Both are written as canonical values (Class=short URN), because each can reference more than one structure type.-
Each follows the value or array rule: one reference is written as a string, several as an array, in the order held by the reporting category:
-
Child reporting categories are written in a nested
itemsarray, after the references.
Field reference¶
| Field | Value | Written when |
|---|---|---|
partial |
true |
The taxonomy is partial. |
items |
Array of reporting categories | The taxonomy has at least one reporting category. |
items[].ID |
String (the English name), or an object | Always, one entry per reporting category. |
items[].ID.name, name-xx |
Localised text | The category has the name. |
items[].ID.description, description-xx |
Localised text | The category has the description. |
items[].ID.uri |
String | The category has a URI. |
items[].ID.structuralMetadata |
Canonical value, or array of canonical values | The category references structural metadata. |
items[].ID.provisioningMetadata |
Canonical value, or array of canonical values | The category references provisioning metadata. |
items[].ID.items |
Array of child reporting categories, same layout as items |
The category has children. |
items[].ID.annotations |
Annotations | The category has annotations. |
items[].ID.links |
Links | The category has links. |