edz_import DE

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