Run your own
The full dictionary was never a download away. It was an export away.
IEC publishes the Common Data Dictionary and licenses its full use inside your organization. This guide takes you from cdd.iec.ch to a locally-running OpenCDD browsing the complete data — every attribute this site's public demo filters out, licensed to you by IEC.
§ Why this way
The IEC CDD License Agreement is precise about what may be redistributed: the § 5 FREE ATTRIBUTES, and the IEC 62720 units dictionary in its entirety (see our compliance matrix). Everything else — definitions, remarks, version history, the lot — is licensed to you for use inside your organization (§ 8), but not to us for republishing.
So we don't republish it. Instead: you export the dictionaries from IEC directly, and OpenCDD converts them into a working local dictionary in one command. You get the full data, under the license IEC granted you, and OpenCDD stays a clean-room engine.
§ Step 1 — Accept the license at cdd.iec.ch
Open the CDD and accept the terms.
Go to cdd.iec.chand accept the license agreement when prompted. That agreement — the same one this site follows to the letter — is what licenses your internal use of the full content (§ 8). No account is needed for the public dictionaries.
§ Step 2 — Search for everything, per kind
One search per entity kind, * matches all.
Open the CDD search, click Search, pick an entity kind, enter * in the term field, and click Export selected. Repeat once per kind:
- Classes
- Properties
- Value lists
- Value terms
- Units
- Relations
- Lists of units
- DET classification
Each export arrives as a zip of per-kind Excel files — the IEC 62656-1 Parcel format that OpenCDD reads natively.
§ Step 3 — Convert with the opencdd gem
One command turns the export into an OpenCDD dictionary.
You need Ruby 3.1+. Install the gem, save the script, run it:
gem install opencdd# convert.rb — IEC CDD export -> OpenCDD dictionary
# ruby convert.rb "<unzipped export dir or single file>" <slug>
require "opencdd"
source, slug = ARGV[0], ARGV[1]
abort "usage: ruby convert.rb <source> <slug>" unless source && slug
db = Opencdd::Database.load(source)
Dir.mkdir(slug) unless Dir.exist?(slug)
File.write(
File.join(slug, "database.json"),
Opencdd::Exporters::Json.new.to_json(db),
)
puts "Wrote #{slug}/database.json (#{db.classes.size} classes)"ruby convert.rb "export_CDD_IEC61360 in EXCEL format" iec61360The converter accepts every layout the gem reads: the per-kind Excel export folder, a single exported .xls, a ParcelMaker workbook, or a sharded per-class directory. AddOpencdd::Cddal.serialize(db)if you also want the plain-text CDDAL form.
§ Step 4 — Run OpenCDD on your dictionary
Drop it into the browser and go.
Clone the browser, copy your converted dictionary into its data directory, and register it in the catalog:
git clone https://github.com/opencdd/opencdd.github.io
cd opencdd.github.io
cp -r iec61360 src/content/data/Add an entry for your dictionary to src/content/data/index.json:
{
"slug": "iec61360",
"parcelId": "IEC61360",
"title": "IEC 61360 (local)",
"sourceLanguage": "en",
"translationLanguages": [],
"counts": { "class": 0, "property": 0, "value_list": 0,
"value_term": 0, "unit": 0, "relation": 0,
"view_control": 0 },
"metaClassIrdis": []
}Counts are optional — pages derive real numbers from the data at runtime. Then run it:
npm install
npm run dev # http://localhost:4321§ What you get locally
Everything. Definitions, remarks, dates, status, source-document references, full version history — the complete attribute set, licensed to your organization by IEC. The public site on purpose shows only the § 5 FREE ATTRIBUTES; your local OpenCDD shows it all. Same identifiers, same IRDIs, same engine.