Skip to content

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)"
Source: reportingtaxonomy/testStructuralMetadata.yaml (trimmed)

- MACROECO_STAT:
    name: "Macroeconomic statistics"
    provisioningMetadata: "Dataflow=ECB:DF_EXR(1.2.0)"
Source: reportingtaxonomy/testProvisioningMetadata.yaml (excerpt)

  • structuralMetadata lists the Data Structures or Metadata Structures, and provisioningMetadata lists 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:

    - MACROECO_STAT:
        name: "Macroeconomic statistics"
        structuralMetadata:
        - "DataStructure=ECB:EXR(1.2.0)"
        - "DataStructure=NHS:COVID(1.1.0)"
    
  • Child reporting categories are written in a nested items array, 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.