Importer des pièces EPLAN (.edz)
QET peut importer une pièce depuis l'EPLAN Data Portal — le catalogue de
composants de référence en CAO électrique (ifm, Phoenix Contact, Siemens,
Rittal, Weidmüller, Schneider et d'autres) — directement dans une collection
d'éléments. Les pièces du portail sont livrées en fichiers .edz ; cette
fonction en lit les données factuelles et en génère un élément QET.
Ce n'est pas un import de symbole. Le résultat est un élément fonctionnel, correctement étiqueté, avec les bonnes bornes — pas une copie du symbole EPLAN du fabricant. Voir §3.
Source : sources/import/edz/ — le module porte son propre README de
développeur, sur lequel cette page s'appuie.
1. L'utiliser
Clic droit sur un dossier de collection modifiable dans le panneau des éléments → Importer une pièce EPLAN (.edz)… → choisissez le fichier. L'élément généré est écrit dans ce dossier et le panneau se recharge.
Seuls les fichiers .edz au format 7-Zip sont pris en charge aujourd'hui.
Certains exports EPLAN utilisent le format zip à la place (signature
PK\x03\x04 plutôt que celle de 7z) ; QET le détecte et le signale plutôt que
d'échouer silencieusement, mais ne peut pas encore l'importer.
2. Ce qui est importé
Un .edz est une archive contenant une définition de pièce (part.xml), une
macro EPLAN (.ema), une image produit et des métadonnées. QET ne lit que les
données portables de la pièce — les faits, pas la géométrie de symbole
propre à EPLAN :
Du .edz |
Devient |
|---|---|
Chaque <functiontemplate> avec une connexion physique |
une borne QET |
Désignation de broche (p. ex. 1, PE) |
l'étiquette de la borne |
| Fabricant | champ d'information manufacturer |
| Numéro de commande | manufacturer_reference |
Description (DESCR1) |
designation |
Commentaire (DESCR2) |
comment |
<name lang="xx">, un par langue fournie par la pièce |
un nom d'élément localisé, qui s'affiche dans la langue de l'interface de QET |
Ces quatre champs d'information sont exactement ceux que lit déjà la nomenclature — voir La base de données du projet — si bien qu'une pièce importée apparaît correctement dans une nomenclature sans réglage supplémentaire.
Les broches sont regroupées et triées par bloc fonctionnel, puis par
désignation à l'intérieur de ce bloc : les connexions de puissance/bornier
portant un terminalNr sont regroupées sur cette base ; les autres se
rabattent sur leur functiondefinition.
3. Le symbole est générique, volontairement
L'import dessine un simple rectangle de corps avec une borne orientée vers
l'ouest par broche — il ne reproduit pas la géométrie de la macro EPLAN. La
macro .ema est du PXF EPLAN tokenisé qui renvoie aux bibliothèques de
symboles propres à EPLAN ; il n'y a rien de portable à en tirer.
Le symbole générique suffit à câbler correctement la pièce et à l'intégrer immédiatement à une nomenclature. Pour un symbole plus soigné, ouvrez l'élément importé dans l'éditeur d'élément ensuite et redessinez le graphisme — les bornes, étiquettes et informations sont déjà correctes et n'ont pas besoin d'être touchées.
4. Une remarque sur l'origine des données
Les fichiers .edz se téléchargent depuis l'EPLAN Data Portal
(data.eplan.com), exploité par EPLAN Software & Service GmbH & Co. KG. Les
conditions d'utilisation du Data Portal restreignent l'usage des données
téléchargées aux produits EPLAN.
QET n'encourage ni ne cautionne le non-respect de ces conditions. Que
l'usage d'un .edz donné en dehors des produits EPLAN soit permis dépend de
l'accord que vous avez avec EPLAN et le fabricant de la pièce — QET n'est
partie à aucun de ces accords et ne peut pas répondre à votre place. En cas de
doute, adressez-vous directement à EPLAN ou au fabricant.
Ce que fait le lecteur de QET lui-même : il n'analyse que les données factuelles et portables de la pièce — désignations de broches, numéros de commande, noms de fabricants — et ne reproduit aucune géométrie ou donnée de symbole propriétaire EPLAN. C'est une description de ce que fait le code, pas un avis juridique sur votre situation particulière.
5. Comment ça s'articule
| Fichier | Rôle |
|---|---|
edzarchive.* |
extrait le .edz dans un dossier temporaire, localise part.xml |
edzsevenzip.* |
extraction 7-Zip via un SDK LZMA embarqué, en lecture seule — aucune installation externe de 7-Zip requise |
edzpart.* |
analyse part.xml selon le modèle portable du tableau ci-dessus |
edzelementbuilder.* |
construit le .elmt à partir de ce modèle |
edzimporter.* |
orchestre tout cela et écrit dans le dossier de collection choisi |
Les classes non-UI sont délibérément découplées du widget, si bien que toute
la chaîne est testable sans interface — docker compose run --rm qet-edz-fuzz fuzz directement EdzImporter::importToDirectory() contre un
corpus de fichiers .edz malformés sous AddressSanitizer/UBSan.
Voir aussi : Lier des éléments · La base de données du projet
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
