CCMM Utilities

This repository contains tools which enable better usage of CCMM.

While the internal structure of each tool may vary to accommodate specific requirements, they generally follow this convention:

• scripts/: Source code and execution logic.
• output/: Destination for generated files and results.

A utility to resolve recursive XSD <xs:include> directives, consolidate namespaces (ccmm, gml), and deduplicate <xs:import> statements into a single, self-contained flattened schema.

• Usage: Can be executed locally via Python (flatten_schema.py) or triggered manually via GitHub Actions, which automatically commits the output to flattenCCMM/output/CCMM_flattened.xsd.
• Key Features:
  • Flattens multi-file XSD architectures into a single schema file.
  • Ensures correct placement and deduplication of external namespace imports (<xs:import>).
  • Accepts both local XSD file paths and remote GitHub repository URLs as input.

An utility to visualize CCMM XSD structures where mandatory parts are in bold.

• Automation: This tool is triggered if the visualization script is modified or if the flattened schema in flattenCCMM changes.

An utility transforming xml metadata conformant to the dataset/schema.xsd to the RDF representation using dataset/lifting.xslt. On the input there is xml metadata file, a repository and branch and on the output are serialized Turtle, XML/RDF and JSON-LD corresponding to the JSON-LD context given by the branch.

Utility also contains the script comparing generated files as a basic ground graph triples, blank nodes and full RDF canonicalization. This checks whether the graph behind specific serializations is the same.

An utility transforming CCMM XML metadata between CCMM 2.0.0 and CCMM 1.1.0 (both directions) using XSLT 3.0 stylesheets (requires Saxon-HE 10+). It allows storing metadata in CCMM 2.0.0 while the National Metadata Directory (NMA) still accepts only CCMM 1.1.0. Every value the transformation had to choose, invent, merge or drop is marked in the output by an XML comment starting with ccmm-migration:. Losses, decisions and recommendations for each direction are described in the known-issues files.

Utility also contains a test runner which transforms the CCMM samples in both directions including round trips and validates the outputs against the target XSD, plus a SHACL check of the lifted RDF.

• Automation: None, the tests are run manually (python3 tests/run_tests.py <CCMM v2.0.0 checkout> <CCMM 1.1.0 checkout>).