Enthält

Siehe auch: Beginnt mit, Endet mit

images/download/attachments/201666797/image-2025-4-1_15-45-23-version-1-modificationdate-1743515123663-api-v2.png

Der Enthält-Vergleichstyp prüft, ob der als Prüfwert (Wert-Konfiguration links) gegebene Text (String) die als Vergleichswert (Wert-Konfiguration rechts) definierte Zeichenfolge (String) exakt enthält.

  • 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) Enthält ($null) als nicht bestanden.

  • Bei vollständiger Übereinstimmung von Prüfwert und Vergleichswert gilt ein Enthält-Vergleich als bestanden.

  • Eine leere Zeichenfolge ("") kann als Prüfwert und als Vergleichswert verwendet werden. Eine Prüfung mit "" als Vergleichswert wird immer bestanden, sofern der Prüfwert ein String ist.

Konkrete Beispiele:

Prüfwert
(JSON-Notation)

Vergleichswert
(JSON-Notation)

Prüfergebnis

Kommentar

"123.45"
"123.45"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg
 true

Prüfwert Enthält Vergleichswert

"123.45"
"3.4"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg
 true

Prüfwert Enthält Vergleichswert

"123.45"
"34"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Prüfwert Enthält Vergleichswert nicht

""
"3.4"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Prüfwert Enthält Vergleichswert nicht

123.45
"3.4"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Prüfwert ist kein String

$null
"3.4"
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Prüfwert ist kein String

"123.45"
3.4
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Vergleichswert ist kein String

"123.45"
$null
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Vergleichswert ist kein String

"123.45"
""
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg
 true

Prüfwert Enthält Vergleichswert

$null
$null
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg
 false

Prüfwert ist kein StringVergleichswert ist kein String

""
""
images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg
 true

Prüfwert Enthält Vergleichswert

Konfiguration

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

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

Beispiel

Prüfen auf ein Klartext-Kennzeichen in einem Referenzattribut einer Adresse

Im Kontext einer "Adresse" (s. Adressen) soll der Wert eines Referenzattributs mit dem Referenztyp "Info" (REF_INFORMATION) nach einem Klartext-Kennzeichen ("§304") durchsucht werden, das als Qualifikationsmerkmal in einer Fallunterscheidung gilt.

Konfiguration:

In einem Zuordnungskriterium werden zwei Regeln in einer UND-Verknüpfung wie rechts abgebildet kombiniert:

  • Die Typprüfung stellt sicher, dass als Eingabewert eine Entität vom Typ "Adresse" (s. Adressen) vorliegt.

  • Die Objekt-Feld-Regel mit dem Enthält-Vergleich (unterhalb) wird nur dann ausgewertet:

    • Der Prüfwert wird über einen Typisiertes-Attribut (Wertauflöser)-Wertauflöser beschafft, der nach einem Referenzattribut vom Subtyp "Info" (Referenztyp) sucht und bei Erfolg über den verketteten Objekt-Feld-Wertauflöser dessen "Referenz" (reference) als String liefert.

    • Der Vergleichswert ("§304") wird rechts als statischer Text zugewiesen.

ANMERKUNG◄ Bei der Suche nach enthaltenem Text sollte immer in Betracht gezogen werden, dass der Vergleichswert auf als Teil eines längeren Kontexts irrtümlich gefunden werden könne. Im Fall der hier gesuchten Zeichenfolge "§304" ist die Erkennung vermutlich relativ präzise. Eine Suche nach "§30" würde irrtümlich auch "§304" finden.

images/download/attachments/201666797/image-2025-4-1_15-55-18-version-1-modificationdate-1743515718785-api-v2.png