mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-09-20 07:14:13 +02:00
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."
+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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user