© Metadata Technology

ESCWA SDMX Workshop

Session: Hierarchical Code List and Statistical Classification

© Metadata Technology

Hierarchical Code List (HCL): Schematic

Hierarchical Code

Hierarchical Code

HCLHCL

references

CodeCode

Code ListCode List

LevelLevel

child hierarchical codes•HCL

•Allows One Code to have many Parent Codes•Allows Hierarchical Codes to be built from many Code Lists•Can have formal Levels•Note that Codes are not maintained in an HCL – an HCL references Codes in Code Lists –i.e. it is a “view” on Codes in one or more Code Lists

•Code List•Can have a hierarchy of codes but one Code can have only one Parent Code

•SDMX is not a Classification Management System

HierarchyHierarchy

parent code

child level

© Metadata Technology

Example: HCL with Codes Having Multiple Parents: Simple Code Lists

IAEG Resources: HCL/HierarchicalCodelistExample.xml

© Metadata Technology

Example: HCL with Codes Having Multiple Parents: Hierarchical Code List

© Metadata Technology

Example: HCL with Codes Having Multiple Parents: Hierarchical Code List

© Metadata Technology

Hierarchical Code List: XML

Note the use of the XML hierarchy to build a code hierarchy

http://localhost:8080/FusionRegistry/ws/restInterfaceV2_1/HierarchicalCodelist/IIAEG/HCL_COUNTRY_GROUPS

© Metadata Technology

Example Classification

NACE Codes in SDMX

© Metadata Technology

NACE: Extract

© Metadata Technology

NACE Extract: SDMX Code ListUpload: IAEG Resources HCL/Nace_Codes.xml

© Metadata Technology

NACE Extract: SDMX Code List (XML)

One Code can have a maximum of one parent

Note that there is no structure to carry the semantic for the “Level” – for this you need a Hierarchical Code List

http://localhost:8080/FusionRegistry/ws/restInterfaceV2_1/Codelist/IAEG/CL_NACE_CODES

© Metadata Technology

Hierarchical Code List (HCL): Schematic

Hierarchical Code

Hierarchical Code

HCLHCL

CodeCode

Code ListCode ListLevelLevelHierarchyHierarchy

parent code

HCL_NACE

SECTION DIVISION GROUP CLASS

H_NACE

AA

CL_NACE_CODES

01011

01011

BB

© Metadata Technology

Classification: Neuchâtel

© Metadata Technology

Hierarchical Code List: SDMX Model

Codelist

Code

1

1..*

1

1..*

/items

HierarchicalCodelist

HierarchicalCode

validFrom : DatevalidTo : Date

0..*

0..1

+child

0..*

+parent

0..1

0..*

1

0..*

+code1

Hierarchy

hasFormalLevels : Boolean

1..*

+hierarchy

1..*

0..*

+codes

0..*

CodingFormat

codingFormat : Facet

Level0..1

0..*

+level

0..1

0..*

0..1

+level

0..10..1

+child

0..1

+parent

0..*

+codeFormat

0..*

Note that the HCL does not contain codes – it references them from an SDMX Code List

© Metadata Technology

Classification: Neuchâtel and SDMXCategory/Categorisation

Hierarchical Code List

VersionableNot Directly SupportedCode List Map

Code Map

Level

Hierarchical Code

Category

Categorisation

Not Supported

© Metadata Technology

Code Map: SDMX Model

Codelist

CodelistMap

Code

CodeMap

1

/source

11

/target

1

0..*

/itemAssociation

0..*

1

/source

1 1

/target

1

•A Code in one Code List can be mapped to multiple Codes in another Code List – each one is a separate Code Map