*! version 1.6.0 16Jan2026

unicefdata_xmltoyaml — Convert SDMX XML structure to YAML

Syntax

unicefdata_xmltoyaml,
input(string)
output(string)
[use_python
noisily
]

Description

unicefdata_xmltoyaml converts SDMX dataflow structure definitions from XML format
(obtained from SDMX REST API) to YAML format for easier parsing and caching.

This utility is primarily used internally by schema_cache and unicefdata_sync.
Most users will not need to call this directly.

Options

input(string) is required. Path to input XML file from SDMX API.

output(string) is required. Path to output YAML file.

use_python uses Python implementation if available (faster for large structures).
Default: Stata implementation.

noisily displays conversion progress and statistics.

Examples

Convert downloaded SDMX structure to YAML:

. unicefdata_xmltoyaml, input(structure.xml) output(structure.yml)

Use Python implementation for faster conversion:

. unicefdata_xmltoyaml, input(large_structure.xml) output(large.yml) use_python

Technical Details

This command converts the hierarchical XML structure from:

https://sdmx.data.unicef.org/ws/public/sdmxapi/rest/structure/dataflow/UNICEF.DF_CME

into compressed YAML format for efficient local storage and parsing.

Author

João Pedro Azevedo, UNICEF

https://jpazvd.github.io

}

See also

unicefdata_sync

schema_cache

unicefdata