EPLAN-Teile importieren (.edz)
QET kann ein Teil aus dem EPLAN Data Portal importieren — dem
De-facto-Bauteilkatalog der Elektro-CAD (ifm, Phoenix Contact, Siemens,
Rittal, Weidmüller, Schneider und weitere) — direkt in eine
Elementesammlung. Portal-Teile werden als .edz-Dateien ausgeliefert; diese
Funktion liest die sachlichen Daten daraus und erzeugt ein QET-Element.
Das ist kein Symbolimport. Das Ergebnis ist ein funktionsfähiges, korrekt beschriftetes Element mit den richtigen Klemmen — keine Kopie des EPLAN-Symbols des Herstellers. Siehe §3.
Quelle: sources/import/edz/ — das Modul trägt ein eigenes
Entwickler-README, auf dem diese Seite beruht.
1. Verwendung
Rechtsklick auf einen beschreibbaren Sammlungsordner im Elementpanel → EPLAN-Teil importieren (.edz)… → Datei wählen. Das erzeugte Element wird in diesen Ordner geschrieben, und das Panel lädt neu.
Unterstützt werden heute nur .edz-Dateien im 7-Zip-Format. Manche
EPLAN-Exporte verwenden stattdessen das Zip-Format (Signatur PK\x03\x04
statt der von 7z); QET erkennt das und meldet es, statt still zu scheitern,
kann es aber noch nicht importieren.
2. Was importiert wird
Eine .edz ist ein Archiv mit einer Teiledefinition (part.xml), einem
EPLAN-Makro (.ema), einem Produktbild und Metadaten. QET liest nur die
portablen Teiledaten — die Fakten, nicht die EPLAN-eigene
Symbolgeometrie:
Aus der .edz |
Wird zu |
|---|---|
Jede <functiontemplate> mit physischem Anschluss |
eine QET-Klemme |
Pinbezeichnung (z. B. 1, PE) |
die Beschriftung der Klemme |
| Hersteller | Informationsfeld manufacturer |
| Bestellnummer | manufacturer_reference |
Beschreibung (DESCR1) |
designation |
Kommentar (DESCR2) |
comment |
<name lang="xx">, eine je vom Teil gelieferter Sprache |
ein lokalisierter Elementname, der in der jeweiligen QET-Oberflächensprache erscheint |
Genau diese vier Informationsfelder liest die Stückliste bereits — siehe Die Projektdatenbank — ein importiertes Teil erscheint also ohne weitere Einrichtung korrekt in einer Stückliste.
Die Pins werden nach ihrem Funktionsblock gruppiert und sortiert, innerhalb
dessen nach Bezeichnung: Leistungs-/Klemmenanschlüsse mit terminalNr
werden danach gruppiert; andere fallen auf ihre functiondefinition zurück.
3. Das Symbol ist absichtlich generisch
Der Import zeichnet ein schlichtes Körperrechteck mit einer nach Westen
ausgerichteten Klemme je Pin — die Geometrie des EPLAN-Makros wird nicht
reproduziert. Das .ema-Makro ist tokenisiertes EPLAN-PXF, das auf
EPLAN-eigene Symbolbibliotheken verweist; daran ist nichts Portables zu
gewinnen.
Das generische Symbol genügt, um das Teil korrekt zu verdrahten und sofort in eine Stückliste aufzunehmen. Für ein ansehnlicheres Symbol öffnen Sie das importierte Element anschließend im Element-Editor und zeichnen die Grafik neu — Klemmen, Beschriftungen und Informationen stimmen bereits und müssen nicht angefasst werden.
4. Eine Anmerkung zur Herkunft der Daten
.edz-Dateien werden aus dem EPLAN Data Portal (data.eplan.com)
heruntergeladen, betrieben von der EPLAN Software & Service GmbH & Co. KG.
Die Nutzungsbedingungen des Data Portal beschränken die Verwendung
heruntergeladener Daten auf EPLAN-Produkte.
QET befürwortet oder ermutigt keinen Verstoß gegen diese Bedingungen. Ob
die Verwendung einer bestimmten .edz außerhalb von EPLAN-Produkten erlaubt
ist, hängt von Ihrer Vereinbarung mit EPLAN und dem Hersteller des Teils ab —
QET ist an keiner dieser Vereinbarungen beteiligt und kann das nicht für Sie
beantworten. Im Zweifel wenden Sie sich direkt an EPLAN oder den Hersteller.
Was QETs eigener Leser tut: Er liest nur die sachlichen, portablen Teiledaten — Pinbezeichnungen, Bestellnummern, Herstellernamen — und reproduziert keine EPLAN-eigene Geometrie oder Symboldaten. Das ist eine Beschreibung dessen, was der Code tut, keine Rechtsberatung zu Ihrer konkreten Situation.
5. Wie es zusammenspielt
| Datei | Rolle |
|---|---|
edzarchive.* |
entpackt die .edz in ein temporäres Verzeichnis, findet part.xml |
edzsevenzip.* |
7-Zip-Entpackung über ein mitgeliefertes, nur entpackendes LZMA-SDK — keine externe 7-Zip-Installation nötig |
edzpart.* |
liest part.xml in das portable Modell aus der obigen Tabelle |
edzelementbuilder.* |
baut daraus das .elmt |
edzimporter.* |
steuert das Vorstehende und schreibt in den gewählten Sammlungsordner |
Die Nicht-UI-Klassen sind bewusst vom Widget entkoppelt, sodass die gesamte
Kette ohne Oberfläche testbar ist — docker compose run --rm qet-edz-fuzz
fuzzt EdzImporter::importToDirectory() direkt gegen einen Korpus
fehlerhafter .edz-Dateien unter AddressSanitizer/UBSan.
Siehe auch: Elemente verknüpfen · Die Projektdatenbank
Getting Started
🌐 Languages — English · Français · Deutsch
Guides
Conductors — wire properties, what feeds which export, and cables
Wire & cable catalogue — cable types, IEC 60757 core colours, assigning a core to a conductor
Printing and exporting — paper, PDF, images, and what each path does differently
Linking elements — master, slave, terminal
PLC modules — I/O tables and linking a wire to a specific point
Using the element editor — drawing tools, saving, checks
Preferences reference — what each settings page does
Keyboard-only control — mouseless QET, and the one real gap
Mouse modifiers — what Shift, Ctrl and Alt change while you drag
Managing collections — folders, writability, building your own shortlist
Templates — reusable multi-element blocks, and why clicking one does nothing
Search & Replace — bulk property changes
Building a nomenclature query — the BOM/summary table builder
Linking wires across pages — folio reports
Variables & formulas — %f, %{label}, sequences
Auto-numbering — schemes, sequences, freezing
Terminal strips — strips, levels, bridges
Title block templates — the .titleblock format
Importing EPLAN parts (.edz) — EPLAN Data Portal
DXF import & export — two unrelated features, one format
The project database — the in-memory SQLite cache
Development
Automating QET — CLI, XML formats, external tools
CLI Reference — command line usage
JavaScript Scripting — --run, geometry editing, undo
Vision — proposal, under discussion
