4D Doc Center : RELATE ONE

Home

4D v14.3

RELATE ONE


RELATE ONE ( Viele-Tabelle \| Feld {; Auswahl} )

Parameter	Typ	Beschreibung
Viele-Tabelle \| Feld	Tabelle, Feld	Tabelle bzw. Feld, von der die Verknüpfung ausgeht
Auswahl	Feld	Feld der Tabelle, zu der die Verknüpfung hingeht

Beschreibung

Der Befehl RELATE ONE hat zwei Syntaxmöglichkeiten.

Die erste Syntax, RELATE ONE(Viele-Tabelle) lädt alle automatischen Verknüpfungen der Tabelle Viele-Tabelle im aktuellen Prozess. Der Befehl lädt für jedes Feld in Viele-Tabelle mit einer automatischen Viele-zu-Eine Verknüpfung den verknüpften Datensatz der dazugehörigen Tabelle. Das ändert für diesen Prozess den aktuellen Datensatz in den verknüpften Tabellen.

Die zweite Syntax, RELATE ONE(Viele-Feld{;Auswahl}) lädt die Verknüpfung, die vom Datenfeld Viele-Feld ausgeht, d.h., sie sucht und lädt einen Datensatz der Tabelle, auf die sich die Verknüpfung bezieht. Sie muss nicht automatisch sein. Dieser Datensatz wird zum aktuellen Datensatz der verknüpften Tabelle. Enthält das aktuelle Formular Felder der aufgerufenen Tabelle, werden diese durch den Aufruf RELATE ONE aktualisiert.

Der optionale Parameter Auswahl kann nur angegeben werden, wenn Viele-Feld vom Typ alphanumerisch oder Text ist. Er muss ein Feld in der verknüpften Tabelle sein. Auswahl muss vom Typ Alpha, Text, Numerisch, Datum, Zeit oder Boolean sein; es kann weder vom Typ Bild noch BLOB sein.

Findet 4D beim Aufruf der Verknüpfung mehrere mögliche Datensätze, erscheint ein Fenster mit Werten des Aufruffeldes und des Feldes Auswahl. In dieser Liste können Sie dann den Datensatz auswählen, auf den die Verknüpfung zeigen soll.

Sie finden mehrere Datensätze, wenn Viele-Feld mit dem Joker (@) endet. Das Angeben von Auswahl hat denselben Effekt wie die Wahl automatischer Joker im Fenster Verknüpfungseigenschaften. Weitere Informationen dazu finden Sie im Abschnitt Viele-zu-Eine Optionen des Handbuchs 4D Designmodus.

Beispiel

Wir gehen aus von einer Tabelle[Rechnung] verknüpft mit der Tabelle[Kunden] mit zwei manuellen Verknüpfungen. Die erste geht von [Rechnung]stellen_an zu [Kunden]Nr, die zweite von [Rechnung]liefern_an zu [Kunden]Nr.

Da beide Verknüpfungen zur selben Tabelle [Kunden] gehen, können Sie nicht gleichzeitig die Adresse für die Rechnung und die Adresse für die Lieferung erhalten. Deshalb werden beide Adressen in einem Formular in Variablen gesetzt und jeweils RELATE ONE aufgerufen. Würden stattdessen die Datenfelder von [Kunden] angezeigt, würden nur die Daten von einer der beiden Verknüpfungen angezeigt.

Im folgenden sehen Sie zwei Objektmethoden für die Datenfelder [Rechnung]stellen_an und [Rechnung]liefern_an. Sie werden bei der Dateneingabe ausgeführt.

Die Objektmethode für das Datenfeld [Rechnung]stellen_an:

 RELATE ONE([Rechnung]stellen_an)

 vStrasse1:=[Kunden]Strasse

 vStadt1:=[Kunden]Stadt

 vLand1:=[Kunden]LKZ

 vPLZ1:=[Kunden]PLZ

Die Objektmethode für das Datenfeld [Rechnung]liefern_an:

 RELATE ONE([Rechnung]liefern_an)

 vStrasse2:=[Kunden]Strasse

 vStadt2:=[Kunden]Stadt

 vLand2:=[Kunden]LKZ

 vPLZ2:=[Kunden]PLZ

Systemvariablen und Mengen

Wurde der Befehl korrekt ausgeführt und die verknüpften Datensätze geladen, wird die Systemvariable OK auf 1 gesetzt. Hat der Benutzer im Dialogfenster der Datenauswahl auf Abbrechen geklickt, wird die Variable OK auf 0 (Null) gesetzt. Der Dialog erscheint, wenn der verknüpfte Datensatz geändert wurde.