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:

Typ — ein next_report darf nur mit einem previous_report verknü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.

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.