Relation Multi

Schlüsselkennung RM

Behandlung von Mehrfach-Zielen (Relation Multi).

Im regulären Ablauf wird die Formel für alle gefundenen Relationsziele bis zum Ende durchgeführt.

Durch die Nutzung von RM kann:

  • der Grenzwert zur Sonderbehandlung definiert werden
  • die Anzahl der zu behandelnden Multi-Ziele vorgegeben werden
  • ein Präfix/Suffix definiert werden, das anstelle der übergangenen Ziele ausgegeben wird.

Syntax:

RM  [p | s]  <counter> [ : <modcounter>]   [ " <text> " ];

p

Legt fest, dass der eingegebene Text <text> bei Erreichen des Grenzwerts (counter) Präfix werden soll.

s

Legt fest, dass der eingegebene Text <text> bei Erreichen des Grenzwerts (counter) Suffix werden soll.

counter

Definiert den Grenzwert, ab dem die Sonderbehandlung greifen soll. Erreicht die Anzahl der Objekte den Wert <counter>, wird die Anzahl der zu behandelnden Objekte auf den Wert von <modcounter> reduziert.

modcounter

Definiert die modifizierte Anzahl der zu behandelnden Objekte. Dies bedeutet, dass die Multibehandlung mit Erreichen dieser Anzahl beendet wird. Es wird dann nur noch das Suffix hinzugefügt.

<modcounter=0> hat eine Sonderfunktion:

  • Es findet keine Iteration über die gesammelten Multi-Objekte statt.
  • Das Präfix/Suffix wird zum Ergebnisstring dieses Formelelementes.
  • Das 'aktuelle' Objekt wird auf 'leer' gesetzt. Nachfolgende Statements werden nicht weiter ausgeführt, es sei denn, eine Sprungmarke ist gesetzt oder der Multizugriff ist mit einer Klammerung der Art [R…;RM…:0] versehen.

text

Text, der zum Präfix oder Suffix werden soll.

 Beispiele

Formel

 Wert des Formelattributes (Zeichenfolge)

…;RMpm"Text";…

Modifikation der Anzeige gefundener assoziierten Objekte.

Ist die Anzahl größer oder gleich m, erhalten die erzeugten Zeilen am Anfang den Text angefügt (p= Präfix).

…;RMm:n;…

Einschränkung der Anzeige der gefundenen assoziierten Objekte.

Ist die Anzahl größer oder gleich m, werden nur n Objekte angezeigt.

Ist die Anzahl kleiner m, werden alle Objekte angezeigt.

R100:223" / ";RM2:1;A5;

An einer Funktion: gibt die Namen aller mit der Funktion assoziierten Kabel, getrennt durch „ / “ an. Ist mehr als 1 Kabel mit der Funktion assoziiert, sollen nur 2 Kabel angezeigt werden.