Skip to content
ispyisail edited this page Sep 11, 2026 · 1 revision

DrΓ€hte ΓΌber Seiten hinweg verknΓΌpfen

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.


1. Die beiden HΓ€lften

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.


2. Die VerknΓΌpfung herstellen

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.


3. Was QET prΓΌft β€” und was nicht

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:

  1. Typ β€” ein next_report darf nur mit einem previous_report verknΓΌpft werden und umgekehrt.
  2. 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.


4. Was die Beschriftung zeigt

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.

Nur fΓΌnf Variablen wirken im Text eines Verweises

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.


5. Drahtnummern und die VerknΓΌpfung

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.

6. VerknΓΌpfungen prΓΌfen und ausgeben

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.csv

Das 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.


7. Wortgebrauch

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

8. Folioverweise sind keine Querverweise

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.


9. Was ΓΌberrascht

  • 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-links ist 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

Home

🌐 Languages β€” English Β· FranΓ§ais Β· Deutsch

Downloads

Windows without admin rights β€” the portable archive, no installer

Quick Start Guide

User Manual

FAQ

Tips & Tricks

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

File formats
Elements XML
Project XML
Development

Building from Source

Contributing Code

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

Development Roadmap

Vision β€” proposal, under discussion

Developer Tools

About

Features

History

Community

License

Contributing to this Wiki

Clone this wiki locally