Repository navigation
folio_links DE
Ein Draht, der am Rand einer Seite endet und auf einer anderen weiterlΓ€uft, wird in QElectroTech als Paar von Folioverweisen gezeichnet β ein Pfeil mit βweiter auf Seite 4β, ein zweiter auf Seite 4 mit βkommt von Seite 2β, und eine VerknΓΌpfung dazwischen.
Wortgebrauch. Diese Seite sagt Seite und Draht; der Code und manche Dialoge sagen Folio und Leiter. Gemeint ist dasselbe β siehe das Glossar am Ende.
Quellen: sources/qetgraphicsitem/reportelement.cpp,
sources/undocommand/linkelementcommand.cpp, sources/pdf_links.cpp.
Ein Folioverweis ist ein gewΓΆhnliches Element, dessen link_type einen von zwei
Werten hat:
link_type |
Editor-Beschriftung (FR) | Bedeutung |
|---|---|---|
next_report |
Renvoi de folio suivant | der Draht lΓ€uft von hier weiter |
previous_report |
Renvoi de folio prΓ©cΓ©dent | der Draht kommt hier von anderswo an |
Sie platzieren sie wie jedes andere Element aus dem Klemmen- und Verweis-Bereich der Sammlung und schlieΓen an jeden einen Draht an. Bis dahin sind es zwei zusammenhanglose Pfeile: Platzieren verknΓΌpft sie nicht. Die VerknΓΌpfung ist ein eigener, ausdrΓΌcklicher Schritt.
WΓ€hlen Sie einen Verweis aus und ΓΆffnen Sie seine Eigenschaften. Dort gibt es Element verknΓΌpfen, mit einer Liste der freien Verweise der jeweils anderen Art im Projekt β frei heiΓt βnoch mit nichts verknΓΌpftβ. Die Liste zeigt zu jedem Kandidaten Drahtnummer, Funktion, Spannung/Protokoll, Position und Foliotitel, sodass sich zwei Γ€hnliche Pfeile unterscheiden lassen.
WΓ€hlen Sie einen aus, und das Paar ist verknΓΌpft. Der Vorgang ist rΓΌckgΓ€ngig zu machen.
Zum UmverknΓΌpfen zuerst trennen: Ein Verweis hΓ€lt genau eine VerknΓΌpfung, und ein neuer Partner ersetzt den alten β der bisherige wird stillschweigend freigegeben.
Das lohnt sich genau zu wissen, denn es ist weniger, als die meisten annehmen. Ob zwei Elemente verknΓΌpft werden dΓΌrfen, entscheidet QET an zwei Punkten:
-
Typ β ein
next_reportdarf nur mit einemprevious_reportverknΓΌpft werden und umgekehrt. - Freiheit β beide mΓΌssen unverknΓΌpft sein (oder bereits miteinander verknΓΌpft).
Das ist der ganze Vertrag. QET prΓΌft nicht:
- ob die beiden Verweise auf verschiedenen Seiten liegen β zwei Verweise desselben Folios lassen sich verknΓΌpfen;
- ob ΓΌberhaupt ein Draht angeschlossen ist;
- ob die DrΓ€hte an beiden Enden zum selben Potential gehΓΆren, dieselbe Nummer tragen oder elektrisch irgendetwas miteinander zu tun haben;
- ob die Pfeile in sinnvolle Richtungen zeigen.
Eine Folioverweis-VerknΓΌpfung ist damit eine Aussage, die Sie ΓΌber Ihre Zeichnung treffen; QET gibt sie getreu wieder, ohne sie zu prΓΌfen. Zwei Pfeile kΓΆnnen KontinuitΓ€t zwischen DrΓ€hten behaupten, die nichts miteinander zu tun haben, und nichts widerspricht.
Wer das geprΓΌft haben will, prΓΌft es selbst β siehe Β§6.
Der Text eines Verweises handelt nicht von ihm selbst. Er beschreibt das andere Ende: wohin der Draht geht oder woher er kam.
Das Format stammt aus einer einzigen projektweiten Einstellung, Projekteigenschaften β Querverweise, gespeichert als:
<report label="%f-%l%c"/>Mit der Vorgabe %f-%l%c zeigt ein Verweis, dessen Partner auf Seite 4 in
Zeile B, Spalte 7 sitzt, 4-B7. Γndern Sie diese eine Einstellung, und alle
Verweise des Projekts Γ€ndern sich mit. Die Variablen sind die gewΓΆhnlichen
Beschriftungsvariablen β siehe Variablen und Formeln.
Da der Text aus der Position des Partners entsteht, folgt er dem Partner. Verschieben Sie den anderen Pfeil in eine andere Spalte oder fΓΌgen Sie davor eine Seite ein, aktualisiert sich die Beschriftung von selbst.
Der dynamische Text eines Verweises ist auf einen kleinen Satz beschrΓ€nkt β viel kleiner als bei einem gewΓΆhnlichen Element:
| Variable | Zeigt |
|---|---|
%{label} |
die Drahtnummer |
%{function} |
die Leiterfunktion |
%{tension_protocol} |
Spannung / Protokoll |
%{conductor_color} |
die Drahtfarbe |
%{conductor_section} |
den Drahtquerschnitt |
Alles andere wird aus dem zusammengesetzten Text eines Verweises entfernt. Wer
%{comment} oder ein Herstellerfeld auf einem Folioverweis erwartet hat, weiΓ
nun, warum es nicht erscheint.
Zwei Verhaltensweisen folgen daraus, dass ein Verweis ein Seitenwechselzeichen ist und kein echtes Betriebsmittel:
- Eine Verweisklemme zΓ€hlt nicht als Anschluss. Beim Aufbau der Drahtnummernliste werden Klemmen eines Verweiselements bewusst ΓΌbersprungen, denn sie stehen fΓΌr keine reale Klemme an realem Material. Ein Draht zwischen zwei Seiten erscheint nicht mit zwei zusΓ€tzlichen Enden.
- Die Nummerierung lΓ€uft nicht automatisch ΓΌber die VerknΓΌpfung. Die beiden DrΓ€hte sind getrennte Leiter auf getrennten Seiten, jeder in seinem Potential. Beiden Enden dieselbe Nummer zu geben, ist eine Frage konsequenter Nummerierung β siehe Automatische Nummerierung.
In einem exportierten PDF werden die VerknΓΌpfungen anklickbar. Die Beschriftung eines Verweises wird zu einem Hyperlink, der zum Partner auf der anderen Seite springt β ein Leser kann einem Draht mit der Maus durch einen Zeichnungssatz folgen.
Eine Bedingung gilt: Der Link entsteht nur, wenn der Text die Beschriftung
tatsΓ€chlich zeigt, also der Elementinfo-Text label ist oder ein
zusammengesetzter Text mit %{label}. Ein Verweis, dessen Text Sie ersetzt
haben, bleibt verknΓΌpft, ist im PDF aber nicht anklickbar.
Um alle VerknΓΌpfungen eines Projekts zu prΓΌfen, hilft die Kommandozeile:
qelectrotech --export-links meinprojekt.qet links.csvDas listet jedes verknΓΌpfbare Element und sein GegenstΓΌck auf und kennzeichnet Master, Slaves und Verweise ohne VerknΓΌpfung. Da QET beim Zeichnen nicht auf einen vergessenen Pfeil hinweist, ist das der praktische Weg, einen zu finden β ein Verweis ohne Partner ist ein Draht, der nirgendwohin fΓΌhrt.
| Diese Seite sagt | Der Code sagt | OberflΓ€che (FR) |
|---|---|---|
| Seite | diagram | folio |
| Draht | conductor | conducteur |
| VerknΓΌpfung zwischen Seiten | folio report | renvoi de folio |
| Pfeil nach vorn | next_report |
renvoi de folio suivant |
| Pfeil zurΓΌck | previous_report |
renvoi de folio prΓ©cΓ©dent |
| Querverweis | master / slave | rΓ©fΓ©rence croisΓ©e |
Die beiden Mechanismen sehen Γ€hnlich aus und werden oft verwechselt:
| Folioverweis | Querverweis | |
|---|---|---|
| Verbindet | einen Draht mit seiner Fortsetzung | eine Spule mit ihren Kontakten |
| Typen |
next_report β previous_report
|
master β slave
|
| Wie viele | genau ein Partner je Seite | ein Master, viele Slaves |
| Der Text zeigt | die Position des anderen Endes | die Kontaktliste bzw. die Position der Spule |
Querverweise behandelt Elemente verknΓΌpfen.
Eine gemeinsame Regel und eine zusΓ€tzliche: Beide verlangen passende Typen und einen freien Partner, doch ein Master/Slave-Paar hat eine EinschrΓ€nkung mehr β ein SPS-Master verknΓΌpft nur mit einem SPS-Slave, ein Nicht-SPS-Master nur mit einem Nicht-SPS-Slave.
- Zwei Pfeile zu platzieren verknΓΌpft sie nicht. Die VerknΓΌpfung ist eine ausdrΓΌckliche Handlung; eine Zeichnung kann fertig aussehen und gar keine enthalten.
-
Nichts validiert die VerknΓΌpfung. Gleiche Seite, kein Draht, fremde
Potentiale β alles erlaubt.
--export-linksist die PrΓΌfung. - VerknΓΌpfen ersetzt, es ergΓ€nzt nicht. Ein Verweis hat einen Partner; ein neuer gibt den alten stillschweigend frei.
- Die meisten Variablen wirken im Text eines Verweises nicht β nur die fΓΌnf aus Β§4.
- Die Beschriftung beschreibt den Partner, nicht sich selbst. Sieht eine Beschriftung falsch aus, gehΓΆrt meist der Pfeil am anderen Ende verschoben.
-
Ein Verweis, dessen Text
%{label}nicht zeigt, ist im PDF nicht anklickbar, obwohl die VerknΓΌpfung besteht.
Siehe auch: Elemente verknΓΌpfen Β· Variablen und Formeln Β· Automatische Nummerierung Β· QElectroTech automatisieren
Getting Started
π Languages β English Β· FranΓ§ais Β· Deutsch
Windows without admin rights β the portable archive, no installer
Guides
Conductors β wire properties, what feeds which export, cables, and hops where wires cross
Wires per terminal β limit the wires on a terminal, chain wiring instead of stars
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
Grid size and element size β why symbols aren't all the same scale, and scaling one without leaving the grid
Preferences reference β what each settings page does
Saving and loading settings β your whole setup in one file, to copy or keep
Keyboard-only control β mouseless QET, and what still needs a mouse
Mouse modifiers β what Shift, Ctrl and Alt change while you drag
3D mouse β SpaceMouse pan, zoom and buttons
Aligning items β snap symbols back to the grid, or line them up
Pictures on a sheet β labels, crop, transparency, what they cost in the file
Arcs and curved wires β the Arc tool, pulling an arc in or out, rounding a corner with a fillet, dashed arcs for lighting layouts
Grouping items β select, move and copy several items as one
Finding your place on a sheet β go to a cell like B13 or 4-B7, keep the headers in sight, show the cell limits, zoom and pan
Showing and hiding kinds of items β hide texts, wire numbers, shapes, pictures, tables or cross-references on every sheet
Drawing faster β place without dragging, the S shortcut bar, command search, gestures
Customising QElectroTech β keys, toolbar size and contents, the gesture ring (partly pending)
Managing collections β folders, writability, building your own shortlist
Templates β reusable multi-element blocks, placed by double-click or drag
Search & Replace β bulk property changes
Building a nomenclature query β the BOM/summary table builder
Linking wires across pages β sheet 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; command-line export and layers
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
MCP server β let an AI assistant read, verify and edit projects
Connecting an AI assistant β setup for Claude, Copilot, Gemini, Codex, Cursor, LM Studio
Script buttons β stored scripts with an icon, by hand or by an assistant
Live mode β an assistant working in the open project while you watch
Macro recorder β record a task by hand, for an assistant to script
Vision β proposal, under discussion
