Navigation:  Designer > Referenz >

GET_RELATION

Previous pageReturn to chapter overviewNext page

Eine GET_RELATION ist eine Funktion, die unter Übergabe benötigter Parameter Werte aus einem Datenbereich holt.

 

Beispiel:

Im Adressstamm befindet sich das Feld "Land", welches nur das 2stellige Länderkürzel beinhaltet.

Möchte man in einer Adressauswertung jetzt nicht nur das Kürzel, sondern den Namen des Landes ausdrucken, so benötigt man eine GET_RELATION auf den Länderstamm, da im Adressstamm nur das Kürzel zur Verfügung steht, aber nicht der Name des Landes.

 

Das Ergebnis wird dabei immer in eine Variable geschrieben. Dabei ist zu beachten, dass diese den gewünschten Wert aufnehmen kann, d.h. wenn der Wert z.B. 30 Zeichen umfasst, muss eine Variable mit 30 Zeichen deklariert werden.

 

Sonderfunktionen der GET_RELATION

GET_RELATIONs verfügen über Sonderfunktionen wie z.B. das Anlegen eines neuen Datensatzes mit dem aus einem Datenbereich geholten Wert. Die GET_RELATION gibt dabei den neu angelegten Index zurück, der nach Belieben weiter verwendet werden kann. So können GET_RELATIONs im Programm flexibel eingesetzt werden, z.B. für Stringverkettungen, Zeitberechnungen usw.

 

GET_RELATIONs stehen Ihnen in Formularen, Kalkulationen und Workflows zur Verfügung und sind in verschiedene Module unterteilt:

 

 

Beispiel einer GET_RELATION (Beispieldaten):

 

Sie möchten die eMail-Adresse der Adressnummer 10000 aus dem Adressstamm holen, um sie in ein neues Belegformular einzubinden. Dazu benötigen Sie die GET_RELATION 01:

 

GET_RELATION[01!VARIABLE!POS!LEN]

 

Deklarieren Sie zunächst eine Variable, welche die eMail-Adresse aufnimmt, z.B:

 

TMP_0_60= GET_RELATION[01!VARIABLE!POS!LEN]

 

TMP = Bezeichnung der Variablen

0 = Position der Variablen

60 = Zeichenlänge der Variablen

 

Ändern Sie nun die Parameter der GET_RELATION, um die gewünschten Werte zu erhalten:

 

TMP_0_60= GET_RELATION[01!10000!1330!60]

 

10000 = Adressnummer

1330 = Positionsnummer des Feldes E-MAIL-ADRESSE im Adressstamm

60 = Zeichenlänge des Feldes E-MAIL-ADRESSE im Adressstamm

 

Das Ergebnis dieser GET_RELATION lautet nun:

 

TMP_0_60=Platzke.IT-Technik@BWBeispieldaten.de