Verify the forum's wire-label-printing workflow and document it properly

The user pointed at forum mentions of a "wire printing feature" -- checked
the actual QET forum (viewtopic.php?id=1496, "Discussion sur la liste des
fileries") rather than re-grepping source, since that's a source of truth
grep can't see. It confirms the earlier correction rather than
contradicting it: QET has no built-in wire-marker/ferrule label printer.
What the forum actually discusses is exporting the wiring list as CSV
(Joshua's own words, quoted on the thread: "Project menu -> export the
list of conductor names") and feeding it into a label printer's own
software -- Brady, WAGO Smart-Printer, Phoenix Contact tools, and Cembre's
SW-code/.FNR system were all named. A professional panel builder reported
the export lacks quantity consolidation (duplicate rows instead of one row
with a count), costing him real time on a large job.

Verified the exact menu wording against source rather than trusting the
forum's paraphrase: qetdiagrameditor.cpp's Project menu has "Exporter la
liste des noms de conducteurs" (-> ConductorNumExport, the CLI's
--export-wires) and "Exporter le plan de câblage" (-> WiringListExport,
the CLI's --export-cables/--export-wiring) -- so the GUI menu items and
the CLI verbs already documented in api_reference are the same underlying
export, not two different things.

Enriches api_reference (EN/FR/DE) with this as a "Worth knowing" bullet:
the real menu names, the real printer brands people actually feed this
into, and the verified duplicate-row limitation. Tightens the
user_manual.md printing-diagrams note (which already correctly said QET
has no such feature) to point here for the concrete workflow instead of
just gesturing at "an external tool."
ispyisail
2026-09-12 08:09:09 +12:00
parent 60807be235
commit c640b69f6d
6 changed files with 74 additions and 27 deletions
+17 -2
@@ -49,9 +49,9 @@ Ausnahmen.
| `--export-png` | ein Verzeichnis | je ein `NN_Titel.png` pro Folio |
| `--export-svg` | ein Verzeichnis | je ein `NN_Titel.svg` pro Folio |
| `--export-bom` | CSV | Stückliste, aus der Projektdatenbank — dieselbe Quelle wie der GUI-Export |
| `--export-wiring` | CSV | Von-Nach-Verdrahtungsliste, eine Zeile je Leiter |
| `--export-wiring` | CSV | Von-Nach-Verdrahtungsliste, eine Zeile je Leiter — entspricht dem Menü *Projekt → Verdrahtungsliste (Datenbank)* / *Verdrahtungsplan exportieren* |
| `--export-cables` | CSV | dieselbe logische Liste, aber aus dem Dokument-XML gebildet |
| `--export-wires` | CSV | Leiternummern |
| `--export-wires` | CSV | Leiternummern — entspricht dem Menü *Projekt → Liste der Leiternamen exportieren* |
| `--export-nets` | CSV | elektrische Netze — zu Potentialen gruppierte Klemmen |
| `--export-links` | CSV | Querverweise, mit Kennzeichnung unverknüpfter Master und Slaves |
| `--info` | JSON | struktureller Abzug: Element- und Leiterzahlen je Folio, unverbundene Klemmen. Schreibt nach **stdout**, wenn kein Pfad angegeben ist |
@@ -91,6 +91,21 @@ CI-Kette verwenden.
- Absturzsicherungen sind im Kommandozeilenmodus bewusst abgeschaltet: Ihr
Schreibvorgang im Hintergrund konkurriert mit dem Prozessende.
- `QT_QPA_PLATFORM=offscreen` genügt für diese Verben. Xvfb wird nicht benötigt.
- **Das ist auch QETs echte Antwort auf „Drahtbeschriftungen drucken".**
QET hat keinen eingebauten Drucker für Drahtmarkierungen/Aderendhülsen
(siehe den Abschnitt Diagramme drucken im Benutzerhandbuch für das, was
Drucken tatsächlich abdeckt). Der im Forum dokumentierte Arbeitsablauf
besteht darin, dieses CSV zu exportieren und in die eigene Software eines
Etikettendruckers einzuspeisen — Brady, WAGO Smart-Printer und die
Phoenix-Contact-Werkzeuge nehmen allesamt CSV direkt entgegen. Eine
bekannte Einschränkung, von einem Schaltschrankbauer im Forum gemeldet:
Der Export liefert eine Zeile je Leiter ohne Mengenzusammenfassung, N
identische Etiketten erscheinen also als N doppelte Zeilen statt einer
Zeile mit Mengenspalte — vor dem Druck einer größeren Charge in einer
Tabellenkalkulation entdoppeln. Cembre-artige Drucker, die eine
`.FNR`-Datei oder eine Support-Code-Spalte brauchen, werden von diesem
Export gar nicht erst erzeugt; diese Zuordnung muss von Hand aus dem CSV
gebaut werden.
### Beispiel: eine Revisionskette
+17 -2
@@ -50,9 +50,9 @@ exceptions signalées plus bas.
| `--export-png` | un répertoire | un `NN_Titre.png` par folio |
| `--export-svg` | un répertoire | un `NN_Titre.svg` par folio |
| `--export-bom` | CSV | nomenclature, depuis la base de données du projet — la même source que l'export de l'interface |
| `--export-wiring` | CSV | liste de câblage de-à, une ligne par conducteur |
| `--export-wiring` | CSV | liste de câblage de-à, une ligne par conducteur — équivaut au menu *Projet → Liste de câblage (base de données)* / *Exporter le plan de câblage* |
| `--export-cables` | CSV | la même liste logique, construite depuis le XML du document |
| `--export-wires` | CSV | numéros de conducteurs |
| `--export-wires` | CSV | numéros de conducteurs — équivaut au menu *Projet → Exporter la liste des noms de conducteurs* |
| `--export-nets` | CSV | réseaux électriques — bornes groupées en potentiels |
| `--export-links` | CSV | renvois de folio, signalant maîtres et esclaves sans lien |
| `--info` | JSON | relevé structurel : comptes d'éléments et de conducteurs par folio, bornes non connectées. Écrit sur **stdout** si aucun chemin n'est donné |
@@ -93,6 +93,21 @@ d'intégration continue.
en mode ligne de commande : leur écriture en arrière-plan entre en
concurrence avec la fin du processus.
- `QT_QPA_PLATFORM=offscreen` suffit pour ces verbes. Xvfb n'est pas nécessaire.
- **C'est aussi la vraie réponse de QET à « imprimer des étiquettes de
fils ».** QET n'a pas d'imprimante intégrée de repères de fils/manchons
(voir la section Impression des diagrammes du manuel utilisateur pour ce
que l'impression couvre réellement). Le flux documenté sur le forum
consiste à exporter ce CSV et à l'introduire dans le logiciel propre
d'une imprimante d'étiquettes — Brady, WAGO Smart-Printer et les outils
Phoenix Contact acceptent tous le CSV directement. Une limite connue,
signalée par un tableautier sur le forum : l'export sort une ligne par
conducteur sans consolidation de quantité, donc N étiquettes identiques
sortent comme N lignes dupliquées plutôt qu'une ligne avec une colonne
quantité — prévoyez de dédoublonner dans un tableur avant d'imprimer un
grand lot. Les imprimantes de type Cembre nécessitant un fichier `.FNR`
ou une colonne de code support ne sont pas produites par cet export du
tout ; cette correspondance doit être construite à la main depuis le
CSV.
### Exemple : une chaîne de révision
+14 -2
@@ -47,9 +47,9 @@ qelectrotech --export-pdf myproject.qet out.pdf
| `--export-png` | a directory | one `NN_Title.png` per folio |
| `--export-svg` | a directory | one `NN_Title.svg` per folio |
| `--export-bom` | CSV | bill of materials, from the project database — same source as the GUI export |
| `--export-wiring` | CSV | from-to wiring list, one row per conductor |
| `--export-wiring` | CSV | from-to wiring list, one row per conductor — same as menu *Project → Wiring list (database)* / *Export the wiring plan* |
| `--export-cables` | CSV | the same logical list, built from the document XML instead |
| `--export-wires` | CSV | conductor numbers |
| `--export-wires` | CSV | conductor numbers — same as menu *Project → Export the list of conductor names* |
| `--export-nets` | CSV | electrical nets — terminals grouped into potentials |
| `--export-links` | CSV | cross-references, flagging masters and slaves with no link |
| `--info` | JSON | structural dump: per-folio element and conductor counts, unconnected terminals. Writes to **stdout** if no output path is given |
@@ -86,6 +86,18 @@ That makes it safe to use in a CI pipeline directly.
- Crash-recovery backups are disabled in CLI mode on purpose — the background
backup write races process exit.
- `QT_QPA_PLATFORM=offscreen` is enough for these verbs. No Xvfb is required.
- **This is also QET's real answer to "print wire labels."** There is no
built-in wire-marker/ferrule label printer in QET (see the User Manual's
Printing Diagrams section for what printing *does* cover). The documented forum workflow is to export this CSV
and feed it into a label printer's own software — Brady, WAGO
Smart-Printer and Phoenix Contact's tools all accept CSV directly. A
known limitation, reported by a panel builder on the forum: the export
is one row per conductor with no quantity consolidation, so N identical
labels come out as N duplicate rows rather than one row with a quantity
column — expect to de-duplicate in a spreadsheet before printing a large
batch. Cembre-style printers that need a `.FNR` file or support-code
column aren't produced by this export at all; that mapping has to be
built by hand from the CSV.
### Example: a revision pipeline
+9 -8
@@ -486,14 +486,15 @@ Maßstabseinstellung — ein Folio wird automatisch an die Seite angepasst.
eigene Druckfunktion.** Sie werden wie jedes andere Element mit dem Folio
gedruckt oder exportiert — es gibt keinen eigenen Schalter, um sie ein-
oder auszublenden (anders als bei Klemmenmarkierungen, die einen solchen
haben — siehe **[Einstellungsreferenz](preferences-DE)** §3), und QET hat
keinen eingebauten Generator für einen Bogen physischer
Drahtmarkierungs-/Aderendhülsen-Etiketten. Wer das braucht: Die
Verdrahtungsliste selbst lässt sich als Daten exportieren — siehe
**[Drähte über Seiten hinweg verknüpfen](folio_links-DE)** und
**[QElectroTech automatisieren](api_reference-DE)** (`--export-wiring`) —
und kann den Seriendruck oder das Vorlagen-Werkzeug eines
Etikettendruckers speisen.
haben — siehe **[Einstellungsreferenz](preferences-DE)** §3).
**QET hat keinen eingebauten Drucker für physische
Drahtmarkierungs-/Aderendhülsen-Etiketten.** Dafür exportieren Sie die
Verdrahtungsliste als CSV (Menü *Projekt*, oder `--export-wiring`) und
speisen sie in die eigene Software eines Etikettendruckers ein — siehe
**[QElectroTech automatisieren](api_reference-DE)**, das den real
genutzten Arbeitsablauf (Brady, WAGO, Phoenix Contact) und eine bekannte
Einschränkung mit doppelten Zeilen bei größeren Aufträgen behandelt.
### Diagramme exportieren
+9 -7
@@ -488,13 +488,15 @@ pas une fonction d'impression séparée.** Elles s'impriment ou s'exportent
avec le folio comme tout autre élément — il n'y a pas de bascule pour les
inclure ou les exclure spécifiquement (contrairement aux marqueurs de
bornes, qui en ont une — voir
**[Référence des préférences](preferences-FR)** §3), et QET n'a aucun
générateur intégré de planche d'étiquettes physiques de repérage de fil.
Si vous en avez besoin, la liste de câblage elle-même s'exporte comme
donnée — voir **[Lier des fils d'une page à l'autre](folio_links-FR)** et
**[Automatiser QElectroTech](api_reference-FR)** (`--export-wiring`) — et
peut alimenter le publipostage ou l'outil de modèles de votre imprimante
d'étiquettes.
**[Référence des préférences](preferences-FR)** §3).
**QET n'a aucune imprimante intégrée d'étiquettes physiques de repérage de
fil/manchon.** Pour cela, exportez la liste de câblage en CSV (menu
*Projet*, ou `--export-wiring`) et introduisez-la dans le logiciel propre
d'une imprimante d'étiquettes voir
**[Automatiser QElectroTech](api_reference-FR)**, qui couvre le flux réel
utilisé (Brady, WAGO, Phoenix Contact) et une limite connue avec des lignes
dupliquées sur de gros lots.
### Exporter les Diagrammes
+8 -6
@@ -475,12 +475,14 @@ manual scale setting — a folio is fit to the page automatically.
print feature.** They print or export as part of the folio like any other
item — there's no toggle to include or exclude them specifically (unlike
terminal markers, which do have one — see
**[Preferences reference](preferences)** §3), and QET has no built-in
generator for a sheet of physical wire-marker/ferrule labels. If you need
that, the wiring list itself is exportable as data — see
**[Linking wires across pages](folio_links)** and
**[Automating QElectroTech](api_reference)** (`--export-wiring`) — and can
feed a label-printer's own mail-merge or template tool.
**[Preferences reference](preferences)** §3).
**QET has no built-in physical wire-marker/ferrule label printer.** For
that, export the wiring list as CSV (*Project* menu, or `--export-wiring`)
and feed it into a label printer's own software — see
**[Automating QElectroTech](api_reference)**, which covers the real-world
workflow (Brady, WAGO, Phoenix Contact) and a known limitation with
duplicate rows on large jobs.
### Exporting Diagrams