Organization Mappings
Organization mappings are stored separately from OSS mappings under data/orgs/.
Folder Layout
Each organization gets its own folder:
Each file uses the same JSON structure as an OSS mapping.
Rules
- Put the file into
data/orgs/<org>/. - Set
canonical.srcto the organization name. For files indata/orgs/siemens/, the source must besiemens. - Do not use reserved organization names.
stableMapandriskyMapare reserved. - Do not overlap with OSS data.
Organization identifiers and aliases must not collide with identifiers or aliases from
data/. - Keep the same file rules as OSS mappings. Filename, alias keys, rejected handling, risky handling, and version checks still apply.
What Is Allowed
- Different organizations may reuse the same identifiers or aliases.
- Organization mappings are loaded into their own top-level map in
merged_data.json. - All libraries can query organization mappings through the optional
orgparameter.
Adding a New Organization
Adding files under data/orgs/<org>/ is only one part of the change. A new organization must also be added to the Organization enum in each library so it can be selected through the public API.