Zeichenfolgen-Funktionen string-functions

concat(<string>,<string>)

concat(<listString>)

Gibt eine Zeichenfolge zurück.

concat("Hello","World")

Gibt „HelloWorld“ zurück.

concat(["Hello"," ","World"])

Gibt „Hello World“ zurück.

• Zeichenfolge

contain(<string>,<string>)

Gibt einen booleschen Wert zurück.

contain("rowing is great", "great")

Gibt „true“ zurück.

containIgnoreCase(<string>,<string>)

Gibt einen booleschen Wert zurück.

containIgnoreCase("rowing is great", "GREAT")

Gibt „true“ zurück.

endWith(<string>,<string>)

Gibt einen booleschen Wert zurück.

endWith("Hello World", "World")

Gibt „true“ zurück.

endWith("Hello World", "Hello")

Gibt „false“ zurück.

endWithIgnoreCase(<string>,<string>)

Gibt einen booleschen Wert zurück.

endWithIgnoreCase("rowing is great", "AT")

Gibt „true“ zurück.

• Zeichenfolge

equalIgnoreCase(<string>,<string>)

Gibt einen booleschen Wert zurück.

equalIgnoreCase("rowing is great", "rowing is GREAT")

Gibt „true“ zurück.

indexOf(<string>,<string>)

Gibt eine Ganzzahl zurück.

indexOf("Hello", "l")

Gibt 2 zurück.

Erklärung:

In „Hello“ befindet sich das erste Auftreten von „l“ an Position 2.

• Zeichenfolge

isEmpty(<string>)

Gibt einen booleschen Wert zurück.

isEmpty("")

Gibt „true“ zurück.

isEmpty("Hello World")

Gibt „false“ zurück.

isEmpty(<null>)

Gibt „false“ zurück.

• Zeichenfolge

isNotEmpty(<string>)

Gibt einen booleschen Wert zurück.

isNotEmpty("")

Gibt „false“ zurück.

isNotEmpty("hello")

Gibt „true“ zurück.

lastIndexOf(<string>,<string>)

Gibt eine Ganzzahl zurück.

lastIndexOf("Hello", "l")

Gibt 3 zurück.

Erklärung:

In „Hello“ befindet sich das letzte Auftreten von „l“ an Position 3.

• Zeichenfolge

length(<string>)

Gibt eine Ganzzahl zurück.

length("Hello World")

Gibt 11 zurück.

• Zeichenfolge

lower(<string>)

Gibt eine Zeichenfolge zurück.

lower("A")

Gibt „a“ zurück.

matchRegExp(<string>,<string>)

Gibt einen booleschen Wert zurück.

matchRegExp("12345", "\\d+")

Gibt „true“ zurück.

• Zeichenfolge

notEqualIgnoreCase(<string>,<string>)

Gibt einen booleschen Wert zurück.

replace(<base>,<target>,<replacement>)

Gibt eine Zeichenfolge zurück.

replace("Hello World", "l", "x")

Gibt „Hexlo World“ zurück.

Beispiel mit RegExp:

Da der Zielparameter ein regulärer Ausdruck ist, müssen Sie je nach der Zeichenfolge, die Sie ersetzen möchten, möglicherweise einige Zeichen auslassen. Siehe folgendes Beispiel:

• auszuwertende Zeichenfolge: |OFFER_A|OFFER_B
• bereitgestellt von einem Profilattribut #{ExperiencePlatform.myFieldGroup.profile.myOffers}
• Zeichenfolge, die ersetzt werden soll: |OFFER_A
• Zeichenfolge ersetzt durch: ''
• Sie müssen \\ vor dem Zeichen | hinzufügen.

Der Ausdruck lautet:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|OFFER_A', '')

Die zurückgegebene Zeichenfolge lautet: |OFFER_B

Sie können auch die Zeichenfolge erstellen, die mit einem bestimmten Attribut ersetzt werden soll:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|' + #{ExperiencePlatform.myFieldGroup.profile.myOfferCode}, '')

replaceAll(<baseString>,<sourceString>,<replacementString>)

Gibt eine Zeichenfolge zurück.

replaceAll("Hello World", "l", "x")

Gibt „Hexxo Worxd“ zurück.

Da der Zielparameter ein regulärer Ausdruck ist, müssen Sie je nach der Zeichenfolge, die Sie ersetzen möchten, möglicherweise einige Zeichen auslassen. Siehe das Beispiel in der Funktion replace.

split(<input string>, <separator string>)

Gibt eine listString zurück.

split("A_B_C", "_")

Gibt ["A","B","C"] zurück

Beispiel mit dem Ereignisfeld „event.appVersion“ mit dem Wert: 20.45.2.3434

split(@event{event.appVersion}, "\\.")

Gibt ["20", "45", "2", "3434"] zurück

startWith(<string>,<string>)

Geben einen booleschen Wert zurück.

startWith("Hello World", "Hello")

Gibt „true“ zurück.

startWith("Hello World", "World")

Gibt „false“ zurück.

startWithIgnoreCase(<string>,<string>)

Geben einen booleschen Wert zurück.

startWithIgnoreCase("rowing is great", "RO")

Gibt „true“ zurück.

substr(<string>,<beginIndex>)

substr(<string>,<beginIndex>,<endIndex>)

Gibt eine Zeichenfolge zurück.

substr("Hello World",6)

Gibt „World“ zurück.

substr("Hello World", 0, 5)

Gibt „Hello“ zurück.

trim(<string>)

Gibt eine Zeichenfolge zurück.

trim(" Hello ")

Gibt „Hello“ zurück.

upper(<string>)

Gibt eine Zeichenfolge zurück.

upper("b")

Gibt „B“ zurück.

uuid()

Gibt eine Zeichenfolge zurück.

uuid()

Gibt „79e70b7f-8a85-400b-97a1-9f9826121553“ zurück.

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page documents all string functions available in AJO journey expressions, covering text search, comparison, transformation, extraction, validation, replacement, splitting, and unique identifier generation.

Intents:

• Concatenate two or more strings using concat
• Search for a substring within a string (case-sensitive or case-insensitive) using contain or containIgnoreCase
• Compare two strings while ignoring case using equalIgnoreCase or notEqualIgnoreCase
• Check whether a string starts or ends with a specific prefix or suffix using startWith, endWith, and their case-insensitive variants
• Extract a substring by index positions using substr
• Replace the first or all occurrences of a pattern in a string using replace or replaceAll
• Split a string into a list of tokens by a separator using split
• Generate a random UUID for unique identifier needs using uuid
• Check if a string is empty or non-empty using isEmpty or isNotEmpty

Glossary:

• RegExp: A regular expression pattern used as the target parameter in replace, replaceAll, and matchRegExp — special characters must be escaped with \\
• UUID: Universal Unique IDentifier — a randomly generated string identifier returned by uuid()
• substr: Extracts a portion of a string by specifying a start index and optional end index (zero-based)

Guardrails:

• The target parameter in replace and replaceAll is treated as a RegExp; special characters (e.g., |, .) must be escaped with \\
• replace replaces only the first matching occurrence; use replaceAll to replace every occurrence
• isEmpty returns false for null values (not true); null is not considered an empty string
• indexOf and lastIndexOf return -1 when no match is found
• String index positions are zero-based (the first character is at position 0)

Terminology:

• Canonical name: String functions — Acronym: none — variants: text functions, string manipulation functions
• Synonyms: “contain” = “substring check”; “split” = “tokenize string”; “trim” = “strip whitespace”
• Do not confuse: “replace” (first occurrence only) ≠ “replaceAll” (all occurrences)
• Do not confuse: “indexOf” (first occurrence position) ≠ “lastIndexOf” (last occurrence position)
• Do not confuse: “isEmpty” (true only for zero-length string) ≠ null check (isEmpty returns false for null)
• Do not confuse: “equalIgnoreCase” (returns true when equal ignoring case) ≠ “notEqualIgnoreCase” (returns true when different ignoring case)

FAQ:

• Q: How do I check if a string contains a substring regardless of case? — Use containIgnoreCase("myString", "searchTerm"), which returns true if the search term is found in any case.
• Q: What is the difference between replace and replaceAll? — replace substitutes only the first matching occurrence; replaceAll substitutes every occurrence in the string.
• Q: Why do I need to escape the | character in replace? — The target parameter is treated as a regular expression; | is a special RegExp character and must be escaped as \\| to be treated as a literal pipe.
• Q: Does isEmpty return true for null? — No, isEmpty returns false for null; it only returns true for a zero-length string "".
• Q: How do I extract the major version number from a version string like “20.45.2.3434”? — Use getListItem(split(@event{event.appVersion}, "\\."), 0) to split by dot and retrieve the first element.
• Q: How do I generate a unique identifier in a journey expression? — Use uuid(), which returns a randomly generated UUID string with no parameters required.