Repository navigation
edz_import FR
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.
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.
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.
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.
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.
| 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
