Beginnt mit

images/download/attachments/201666737/image-2025-4-1_15-17-37-version-1-modificationdate-1743513457504-api-v2.png

Der Beginnt mit-Vergleichstyp prüft, ob der als Prüfwert (Wert-Konfiguration links) gegebene Text (String) exakt mit der Zeichenfolge (String) beginnt, die als Vergleichswert (Wert-Konfiguration rechts) definiert ist.

Der Screenshot oben verwendet statische Text-Wertauflöser (s. Statische Werte) mit den Texten "Prüfwert" und "Vergleichswert", um das Zusammenspiel der Komponenten zu verdeutlichen.

►HINWEISE◄

Der Textvergleich berücksichtigt die Groß-/Kleinschreibung.
Eine automatische Umwandlung unpassender Werte in Text (String) findet nicht statt. Bei Bedarf kann der Eingabeobjekt (Typsicher)-Wertauflöser oder ein geeigneter Wertauflöser aus der Kategorie Textverarbeitung (Wertauflöser) verwendet werden, um einen anderen Datentyp in einen String umzuwandeln.

Sonderfälle:

Falls mindestens eine der Wert-Konfigurationen (Prüfwert, Vergleichswert) keinen String liefert, gilt die Prüfung als nicht bestanden.
Da auch "Kein Wert" ($null) kein String ist, gilt eine Prüfung wie ($null) Beginnt mit ($null) als nicht bestanden.
Bei vollständiger Übereinstimmung von Prüfwert und Vergleichswert gilt ein Beginnt mit-Vergleich als bestanden.
Eine leere Zeichenfolge ("") kann als Prüfwert und als Vergleichswert verwendet werden. Eine Prüfung mit"" alsVergleichswert wirdimmer bestanden, sofern derPrüfwert einString ist.

Konkrete Beispiele:

Prüfwert (JSON-Notation)	Vergleichswert (JSON-Notation)	Prüfergebnis	Kommentar
`"123.45"`	`"123.45"`	true	Prüfwert Beginnt mit Vergleichswert
`"123.45"`	`"12"`	true	Prüfwert Beginnt mit Vergleichswert
`"123.45"`	`"11"`	false	Prüfwert beginnt nicht mit Vergleichswert
`""`	`"12"`	false	Prüfwert beginnt nicht mit Vergleichswert
`123.45`	`"12"`	false	Prüfwert ist kein `String`
`$null`	`"12"`	false	Prüfwert ist kein `String`
`"123.45"`	`12`	false	Vergleichswert ist kein `String`
`"123.45"`	`$null`	false	Vergleichswert ist kein `String`
`"123.45"`	`""`	true	Prüfwert Beginnt mit Vergleichswert
`$null`	`$null`	false	Prüfwert ist kein `String`Vergleichswert ist kein `String`
`""`	`""`	true	Prüfwert Beginnt mit Vergleichswert

Konfiguration

Die Wert-Konfigurationen für Prüfwert (links) und Vergleichswert (rechts) sind für den Beginnt mit-Vergleichstyp nicht optional.

Beide Wert-Konfigurationen müssen zur Laufzeit Zeichenfolgen (String) liefern, sonst gilt die Objekt-Feld-Regel als nicht bestanden.

Beispiele

Auswerten einer Texteingabe

Eine Objekt-Feld-Regel soll eine Benutzereingabe so auswerten, dass jede Eingabe, die nicht mit dem Buchstaben "n" (bzw. "N") beginnt, als false ("Ablehnung") gewertet wird und alle anderen (außer "") als true ("Zustimmung").

►ANMERKUNG◄ Natürlich gibt es effektivere Möglichkeiten eine rein "binäre" Entscheidung von einem Benutzer abzufragen, etwa die Benutzer-Rückfrage-Ereignisaktion. Immerhin könnte ein Benutzer seine "Zustimmung" auch durch die Eingabe von "Natürlich!" ausdrücken wollen. Insofern soll dieses Beispiel eher die Verwendung des Beginnt mit-Wertauflösers demonstrieren und nicht die Best Practice in Lobster Data Platform / Orchestration.

Konfiguration:

Innerhalb einer Objekt-Feld-Regel werden im Prüfwert (links) folgende Wertauflöser verkettet:

Der Benutzereingabe-Wertauflöser beschafft die Eingabe vom Benutzer. Auf Details zur Konfiguration sei hier verzichtet.
Der verkettete Standardwert-Wertauflöser definiert den Text "n" als Standard für den Fall dass der Benutzer nichts eingibt.
Der Trim-Wertauflöser entfernt randständige Leerzeichen, die hier als unbeabsichtigte Eingabe gelten sollen.
Der In Kleinbuchstaben-Wertauflöser ersetzt alle Großbuchstaben durch Kleinbuchstaben, so dass die Prüfung mit dem Beginnt mit-Vergleichstyp indifferent für Groß- und Kleinschreibung wirkt.

Rechts wird der Kleinbuchstabe "n" (s. Statische Werte) als Vergleichswert gegenübergestellt.

►HINWEIS◄ Wie im Bild an der Beschriftung "nicht(...)" zu erkennen ist, wird der Beginnt mit-Vergleichstyp hier negiert (s. not (Vergleichstyp)), damit die Prüfung als bestanden gilt, falls die Benutzereingabe nicht mit "n" beginnt.

images/download/attachments/201666737/image-2025-4-1_15-21-10-version-1-modificationdate-1743513670712-api-v2.png

Vergleich zweier Textdateien

Im Kontext einer Ereignisbehandlung soll festgestellt werden, ob eine Textdatei version.txt durch "Verlängern" einer anderen Datei original.txt entstanden ist (oder mindestens sein könnte).

Beide Dateien liegen bereits als Uploads in einem für Lobster Data Platform / Orchestration lesbaren Pfad des Server-Dateisystems vor.

Konfiguration:

Innerhalb einer Objekt-Feld-Regel werden zwei Instanzen des Dateireferenz-Wertauflösers eingesetzt, um auf die die zu vergleichenden Dateien (in einem Unterverzeichnis test des designierten upload-Ordners für Lobster Data Platform / Orchestration) zuzugreifen.

Der Dateireferenz-Wertauflöser liefert primär ein "Inhalt"-Objekt als Rückgabewert, das den Klartext einer Textdatei als Byte-Array (byte[]) im Feld body wiedergibt. Allerdings bildet dieses Byte-Array per Standard auch die Basis für das String-Abbild des "Inhalt"-Objekts. Daher liefert für eine Textdatei der verkettete Eingabeobjekt (Typsicher)-Wertauflöser mit dem "Typ" String den für den Vergleich relevanten Klartext.

images/download/attachments/201666737/image-2025-4-1_15-25-30-version-1-modificationdate-1743513930719-api-v2.png

►ANMERKUNG◄ Die Objekt-Feld-Regel mit dem Beginnt mit-Vergleichstyp gilt auch dann als bestanden, wenn der Inhalt der Datei version.txt mit original.txt identisch ist. Um - wie oben formuliert - zuverlässig sicherzustellen, ob die Originaldatei tatsächlich "verlängert" wurde, muss also im Kontext einer UND-Verknüpfung durch eine weitere Bedingung ausgeschlossen werden, dass die Dateiinhalte identisch sind (z. B. mit not (Vergleichstyp) und Ist Gleich).