Teilstring

Im Beispiel rechts wurde für den Startindex der Wert -10 direkt eingegeben. Der zurückgegebene Ausschnitt beginnt also mit dem zehnten Zeichen von hinten in der als Eingabewert übergebenen Zeichenfolge.

Für den Parameter Max. Länge wird ein Variable-Wertauflöser verwendet, damit zur Laufzeit der Wert der Variablen maxCharacters verwendet wird, um die Länge des Abschnitts zu begrenzen

►HINWEIS◄ Ausgehend von der per Standard vorgesehenen Direkteingabe muss die Definition eines Wertauflösers per Klick auf den kleinen grauen Pfeil links unten im Eingabewert (s. Startindex im Screenshot) eingeleitet werden. Wird anstelle eines Wertauflösers "kein Wert" (aus dem Kontextmenü) ausgewählt, erscheint beim nächsten Aufklappen des Teilstring-Wertauflösers wieder die Direkteingabe.

Damit die "Segmentierung" der Zeichenfolge bei Bedarf möglichst einfach angepasst werden kann, wird in der folgenden Konfiguration die gewünschte Länge der betreffenden Segmente über eine statische Zeichenfolge definiert, die als Array von Ganzzahlen in der JSON-Notation interpretiert werden kann: [3,1,6,1,0]

Der Wert 0 an der letzten Position bedeutet dabei, dass alle Zeichen nach der 11-stelligen (3+1+6+1) Containernummer ausgegeben werden sollen.

Der Objekt aus JSON erzeugen-Wertauflöser erzeugt aus dem statischen Text eine Liste von Ganzzahlen, die im Kopf einer Für jeden Eintrag wiederholen (Schleife) im Parameter Wertauflöser für Einträge verarbeitet werden kann.

Im Kopf der Schleife legt der Parameter String in Variable speichern fest, dass der Eingabewert (die Zeichenfolge, die strukturiert werden soll) in der Variablen input gespeichert wird. Diese Variable ermöglicht den Zugriff auf die Zeichenfolge innerhalb einer Iteration der Schleife.

Der Screenshot rechts zeigt im Aktionsblock für die Iteration eine Setze Wert-Ereignisaktion, die verwendet wird, um die strukturierte Zeichenfolge für die Ausgabe in der Variablen output sukzessive aufzubauen. Dazu wird (rechts) ein Textverkettung-Wertauflöser verwendet, der mit jeder Iteration einen weiteren Teilstring aus der Variablen input an den bisherigen Inhalt der Variablen output anhängt.

Je Iteration ändern sich dabei die Parameter im Teilstring-Wertauflöser:

• Der Startindex wird aus einer Variablen cursor gelesen, die im folgenden Schritt je Iteration neu berechnet wird.
  
  

• Als Max. Länge wird die für die jeweilige Iteration als Bezugsobjekt geltende Ganzzahl aus dem im Kopf der Schleife definierten Array verwendet, die der Objekt-Feld-Wertauflöser ohne Angabe eines Felds liefert.

Vor jedem "Anhang" aus der input-Variablen wird ein Leerzeichen eingefügt (s. Position 2 im Textverkettung-Wertauflöser).

Um überschüssige Leerzeichen zu eliminieren, wird an zwei Stellen der Trim-Wertauflöser verkettet:

• In der Verkettung mit dem Teilstring-Wertauflöser verhindert der "innere" Trim-Wertauflöser, dass im output ein doppeltes Leerzeichen vor dem Beschreibungstext erscheint, der schon im input durch ein Leerzeichen getrennt ist.
  
  

• Der "äußere" Trim-Wertauflöser unterhalb der Textverkettung dient im Wesentlichen dazu, dass führende Leerzeichen vor dem ersten Segment zu eliminieren, das entsteht, weil die Variable output in der ersten Iteration noch kein Zeichen enthält.

Die Variable cursor wird verwendet, um den Startpunkt für die jeweils nächste Iteration zu definieren. Dies erreicht eine weitere Setze Wert-Ereignisaktion, in der die Anzahl der in der aktuellen Iteration übernommenen Zeichen (s. Variable segment im Berechne Wert-Wertauflöser) zum bisherigen Wert von cursor addiert wird. Der "Wert" (value) dieser Summe definiert dem Startindex für den nächsten "zu kopierenden" Abschnitt. Er wird der Variablen cursor zugewiesen.

►WICHTIG◄ Den in der Schleife verwendeten Variablen output und cursor sollten vor dem Beginn der Schleife mit dem Wert $null bzw. 0 initialisiert werden, da sonst "Vorbelegungen" dieser Variablen das Ergebnis verfälschen können.