Hilfsfunktionen

Verwenden Sie die Helper-Funktionen im Personalisierungseditor, um personalisierte Inhaltserlebnisse präzise und effizient zu definieren, indem Sie Daten bearbeiten, Berechnungen durchführen und Inhalte formatieren. Erkunden Sie diese Funktionen, Operatoren und Helper und experimentieren Sie mit ihnen, um zu erfahren, wie sie zusammenarbeiten, um Ihnen bei der Erstellung maßgeschneiderter, datengesteuerter Journey zu helfen.

Aggregationsfunktionen

Verwenden Sie Aggregationsfunktionen, um mehrere Werte zu gruppieren, um einen einzigen Zusammenfassungswert zu bilden. Sie können auch Array- und Listenfunktionen verwenden, um die Interaktion mit Arrays, Listen und Zeichenfolgen einfacher zu definieren.

Durchschnitt average

Verwenden Sie die Funktion average , um das arithmetische Mittel aller ausgewählten Werte im Array zurückzugeben.

{%= average(array) %}

{%=average(orders.order.price)%}

count count

Verwenden Sie die Funktion count , um die Anzahl der Elemente innerhalb des angegebenen Arrays zurückzugeben.

{%= count(array) %}

{%= count(orders) %}

max max

Verwenden Sie die Funktion max , um den größten der ausgewählten Werte im Array zurückzugeben.

{%= max(array) %}

{%=max(orders.order.price)%}

min min

Verwenden Sie die Funktion min , um den kleinsten aller ausgewählten Werte im Array zurückzugeben.

{%= min(array) %}

{%=min(orders.order.price) %}

sum sum

Verwenden Sie die Funktion sum , um die Summe aller ausgewählten Werte im Array zurückzugeben.

{%= sum(array) %}

 {%=sum(orders.order.price)%}

Arithmetische Funktionen maths

Verwenden Sie arithmetische Funktionen, um einfache Berechnungen für Werte durchzuführen.

hinzufügen add

Mit der Funktion + (Addition) können Sie die Summe zweier Argumentausdrücke ermitteln.

{%= double + double %}

{%= product1.price + product2.price %}

multiplizieren multiply

Verwenden Sie die Funktion * (Multiplikation), um das Produkt zweier Argumentausdrücke zu finden.

{%= double * double %}

{%= product.inventory * product.price %}

abziehen substract

Verwenden Sie die - (Subtraktion)-Funktion, um den Unterschied von zwei Argumentausdrücken zu finden.

{%= double - double %}

{%= product1.price - product2.price %}

Dividieren divide

Verwenden Sie die / (Division)-Funktion, um den Quotienten zweier Argumentausdrücke zu finden.

{%= double / double %}

{%= totalProduct.price / totalProduct.sold %}

Rest remainder

Verwenden Sie die Funktion % (Rest), um den Rest nach der Division der beiden Argumentausdrücke zu finden.

{%= double % double %}

{%= person.age % 5 = 0 %}

Array- und Listenfunktionen arrays

Verwenden Sie diese Funktionen, um die Interaktion mit Arrays, Listen und Zeichenfolgen zu vereinfachen.

countOnlyNull count-only-null

Mit der Funktion countOnlyNull können Sie die Anzahl der Nullwerte in einer Liste zählen.

{%= countOnlyNull(array) %}

{%= countOnlyNull([4,0,1,6,0,0]) %}

countWithNull count-with-null

Verwenden Sie die Funktion countWithNull , um alle Elemente einer Liste einschließlich Nullwerten zu zählen.

{%= countWithNull(array) %}

{%= countOnlyNull([4,0,1,6,0,0]) %}

distinct distinct

Verwenden Sie die Funktion distinct , um Werte aus einem Array oder einer Liste abzurufen, aus denen doppelte Werte entfernt wurden.

{%= distinct(array) %}

{%= distinct(person.orders.storeId).count() > 1 %}

distinctCountWithNull distinct-count-with-null

Mit der Funktion distinctCountWithNull können Sie die Anzahl verschiedener Werte in einer Liste einschließlich der Nullwerte zählen.

{%= distinctCountWithNull(array) %}

{%= distinctCountWithNull([10,2,10,null]) %}

anführen head

Verwenden Sie die Funktion head , um das erste Element in einem Array oder einer Liste zurückzugeben.

{%= head(array) %}

{%= head(topN(orders,price, 5)) %}

topN first-n

Die Funktion topN sortiert ein Array in absteigender Reihenfolge basierend auf dem angegebenen numerischen Ausdruck und gibt die ersten N Elemente zurück. Wenn die Array-Größe kleiner als N ist, wird das gesamte sortierte Array zurückgegeben.

{%= topN(array, value, amount) %}

{%= topN(orders,price, 5) %}

in in

Verwenden Sie die Funktion in , um zu bestimmen, ob ein Element Mitglied eines Arrays oder einer Liste ist.

{%= in(value, array) %}

{%= in (person.birthMonth, [3, 6, 9]) %}

Umfasst includes

Mit der Funktion includes können Sie bestimmen, ob ein Array oder eine Liste ein bestimmtes Element enthält.

{%= includes(array,item) %}

{%= includes(person.favoriteColors,"red") %}

überschneidet intersects

Mit der intersects-Funktion wird bestimmt, ob zwei Arrays oder Listen mindestens ein gemeinsames Element aufweisen.

{%= intersects(array1, array2) %}

{%= intersects(person.favoriteColors,["red", "blue", "green"]) %}

bottomN last-n

Die Funktion bottomN sortiert ein Array in aufsteigender Reihenfolge basierend auf dem angegebenen numerischen Ausdruck und gibt die ersten N Elemente zurück. Wenn die Array-Größe kleiner als N ist, wird das gesamte sortierte Array zurückgegeben.

{%= bottomN(array, value, amount) %}

{%= bottomN(orders,price, 5) %}

notIn notin

Verwenden Sie die Funktion notIn , um zu bestimmen, ob ein Element nicht Mitglied eines Arrays oder einer Liste ist.

{%= notIn(value, array) %}

{%= notIn(person.birthMonth ,[3, 6, 9]) %}

subsetOf subset

Verwenden Sie die Funktion subsetOf , um zu bestimmen, ob ein bestimmtes Array (Array A) eine Teilmenge eines anderen Arrays (Array B) ist. Mit anderen Worten: ob alle Elemente in Array A Elemente von Array B sind.

{%= subsetOf(array1, array2) %}

{%= subsetOf(person.favoriteCities,person.visitedCities) %}

Obermenge superset

Verwenden Sie die Funktion supersetOf , um zu bestimmen, ob ein bestimmtes Array (Array A) eine Obermenge eines anderen Arrays (Array B) ist. Mit anderen Worten: ob Array A alle Elemente in Array B enthält.

{%= supersetOf(array1, array2) %}

{%= supersetOf(person.eatenFoods,["sushi", "pizza"]) %}

Datums- und Uhrzeitfunktionen date-time

Verwenden Sie die Datums- und Uhrzeitfunktionen, um Datums- und Uhrzeitvorgänge für Werte durchzuführen.

Tage hinzufügen add-days

Die Funktion addDays passt ein bestimmtes Datum um eine angegebene Anzahl von Tagen an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.

{%= addDays(date, number) %}

Stunden hinzufügen add-hours

Die Funktion addHours passt ein bestimmtes Datum um eine angegebene Anzahl von Stunden an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.

{%= addHours(date, number) %}

Minuten hinzufügen add-minutes

Die Funktion addMinutes passt ein bestimmtes Datum um eine angegebene Anzahl von Minuten an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.

{%= addMinutes(date, number) %}

AddMonths add-months

Die Funktion addMonths passt ein bestimmtes Datum um eine angegebene Anzahl von Monaten an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.

{%= addMonths(date, number) %}

addSecond add-seconds

Die Funktion addSeconds passt ein bestimmtes Datum um eine angegebene Anzahl von Sekunden an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.

{%= addSeconds(date, number) %}

Jahre hinzufügen add-years

Die Funktion addYears passt ein bestimmtes Datum um eine angegebene Anzahl von Jahren an, wobei positive Werte zum Erhöhen und negative Werte zum Verringern verwendet werden.

{%= addYears(date, number) %}

age age

Verwenden Sie die age-Funktion, um das Alter zu einem bestimmten Datum abzurufen.

 {%= age(datetime) %}

pageInDays age-days

Die ageInDays berechnet die Anzahl der Tage zwischen dem angegebenen Datum und dem aktuellen Datum. Negative Werte werden für zukünftige Datumsangaben und positive Werte für vergangene Datumsangaben verwendet.

{%= ageInDays(date) %}

ageInMonths age-months

Die ageInMonths berechnet die Anzahl der Monate zwischen dem angegebenen Datum und dem aktuellen Datum. Negative Werte werden für zukünftige Datumsangaben und positive Werte für vergangene Datumsangaben verwendet.

{%= ageInMonths(date) %}

compareDates compare-dates

Die Funktion compareDates vergleicht das erste Eingabedatum mit einem anderen. Gibt 0 zurück, wenn date1 gleich date2 ist, -1, wenn date1 vor date2 liegt, und 1, wenn date1 nach date2 liegt.

{%= compareDates(date1, date2) %}

convertZonedDateTime convert-zoned-date-time

Die Funktion convertZonedDateTime wandelt eine Datums-/Uhrzeitangabe in eine bestimmte Zeitzone um.

{%= convertZonedDateTime(dateTime, timezone) %}

currentTimeInMillis current-time

Verwenden Sie die currentTimeInMillis-Funktion, um die aktuelle Zeit in Epochenmillisekunden abzurufen.

{%= currentTimeInMillis() %}

Datumsdifferenz date-diff

Verwenden Sie die dateDiff-Funktion, um die Differenz zwischen zwei Daten als Anzahl von Tagen abzurufen.

{%= dateDiff(datetime,datetime) %}

Tag des Monats day-month

Die Funktion dayOfMonth gibt die Zahl zurück, die dem Tag des Monats entspricht.

{%= dayOfMonth(datetime) %}

Tag der Woche day-week

Verwenden Sie die Funktion dayOfWeek , um den Wochentag abzurufen.

{%= dayOfWeek(datetime) %}

dayOfYear day-year

Verwenden Sie die dayOfYear-Funktion, um den Tag des Jahres abzurufen.

{%= dayOfYear(datetime) %}

diffInSeconds diff-seconds

Die Funktion diffInSeconds gibt den Unterschied zwischen zwei Daten in Form von Sekunden zurück.

{%= diffInSeconds(endDate, startDate) %}

extractHours extract-hours

Die Funktion extractHours extrahiert die Stundenkomponente aus einem bestimmten Zeitstempel.

{%= extractHours(date) %}

extractMinutes extract-minutes

Die Funktion extractMinutes extrahiert die Minutenkomponente aus einem bestimmten Zeitstempel.

{%= extractMinutes(date) %}

ExtractMonths extract-months

Die Funktion extractMonth extrahiert die Monatskomponente aus einem bestimmten Zeitstempel.

{%= extractMonths(date) %}

extractSeconds extract-seconds

Die Funktion extractSeconds extrahiert die Sekundenkomponente aus einem bestimmten Zeitstempel.

{%= extractSeconds(date) %}

formatDate format-date

Verwenden Sie die formatDate-Funktion zum Formatieren eines Datums-/Uhrzeitwerts. Das Format muss ein gültiges Java-DateTimeFormat sein.

{%= formatDate(datetime, format) %}

{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}

Musterzeichen pattern-characters

Einige Musterbuchstaben sehen möglicherweise ähnlich aus, stellen jedoch unterschiedliche Konzepte dar.

Formatieren des Datums mit Unterstützung für Gebietsschema format-date-locale

Sie können die formatDate-Funktion verwenden, um einen Datums-/Uhrzeitwert in die entsprechende sprachabhängige Darstellung zu formatieren, z. B. für ein gewünschtes Gebietsschema. Das Format muss ein gültiges Java-DateTimeFormat sein.

{%= formatDate(datetime, format, locale) %}

{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY", "fr_FR") %}

getCurrentZonedDateTime get-current-zoned-date-time

Die Funktion getCurrentZonedDateTime gibt das aktuelle Datum und die aktuelle Uhrzeit mit Zeitzoneninformationen zurück.

{%= getCurrentZonedDateTime() %}

diffInHours hours-difference

Die Funktion diffInHours gibt den Unterschied zwischen zwei Daten in Form von Stunden zurück.

{%= diffInHours(endDate, startDate) %}

diffInMinutes diff-minutes

Die diffInMinutes gibt die Differenz zwischen zwei Daten in Minuten zurück.

{%= diffInMinutes(endDate, startDate) %}

diffInMonths months-difference

Die Funktion diffInMonths gibt den Unterschied zwischen zwei Daten in Form von Monaten zurück.

{%= diffInMonths(endDate, startDate) %}

setDays set-days

Verwenden Sie die setDays , um den Tag des Monats für die Datums-/Uhrzeitangabe festzulegen.

{%= setDays(datetime, day) %}

setHours set-hours

Legen Sie mit der setHours die Stunde der Datums-/Uhrzeitangabe fest.

{%= setHours(datetime, hour) %}

toDateTime string-to-date-time

Die Funktion toDateTime wandelt eine Zeichenfolge in ein Datum um. Bei einer ungültigen Eingabe wird als Ausgabe das Epochen-Datum zurückgegeben.

{%= toDateTime(string, string) %}

toUTC to-utc

Verwenden Sie die toUTC-Funktion, um eine Datums-/Uhrzeitangabe in UTC zu konvertieren.

{%= toUTC(datetime) %}

truncateToStartOfDay truncate-day

Verwenden Sie die truncateToStartOfDay, um eine bestimmte Datums-/Uhrzeitangabe zu ändern, indem Sie sie auf den Beginn des Tages mit der Zeit 00:00 festlegen.

{%= truncateToStartOfDay(date) %}

truncateToStartOfQuarter truncate-quarter

Verwenden Sie die Funktion truncateToStartOfQuarter , um eine Datums-/Uhrzeitangabe auf den ersten Tag des Quartals zu kürzen (z. B. 1. Januar, 1. April, 1. Juli, 1. Oktober) um 00 :00.

{%= truncateToStartOfQuarter(dateTime) %}

truncateToStartOfWeek truncate-week

Die truncateToStartOfWeek-Funktion ändert eine bestimmte Datums-/Uhrzeitangabe, indem sie sie auf den Beginn der Woche (Montag um 00 Uhr) :00.

{%= truncateToStartOfWeek(dateTime) %}

truncateToStartOfYear truncate-year

Verwenden Sie die truncateToStartOfYear, um eine bestimmte Datums-/Uhrzeitangabe zu ändern, indem Sie sie auf 00 :00 auf den ersten Tag des Jahres (1. Januar) kürzen.

{%= truncateToStartOfYear(dateTime) %}

weekOfYear week-of-year

Verwenden Sie die weekOfYear-Funktion, um die Woche des Jahres abzurufen.

{%= weekOfYear(datetime) %}

diffInYears diff-years

Verwenden Sie die diffInYears-Funktion, um die Differenz zwischen zwei Daten in Jahren zurückzugeben.

{%= diffInYears(endDate, startDate) %}: int

Operatorfunktionen operators

Verwenden Sie die booleschen und Vergleichsfunktionen, um logische Auswertungen durchzuführen.

und and

Die Funktion and wird zur Erstellung einer logischen Verknüpfung verwendet.

{%= query1 and query2 %}

{%= profile.homeAddress.country = "France" and profile.person.birthYear = 1985 %}

oder or

Die Funktion or wird verwendet, um eine logische Trennung zu erstellen.

{%= query1 or query2 %}

{%= profile.homeAddress.country = "France" or profile.person.birthYear = 1985 %}

ist gleich operator-equals

Die Funktion = (gleich) prüft, ob ein Wert oder Ausdruck gleich einem anderen Wert oder Ausdruck ist.

{%= expression = value %}

{%= profile.homeAddress.country = "France" %}

ungleich notequal

Die Funktion != (ungleich) prüft, ob ein Wert oder Ausdruck ungleich einem anderen Wert oder Ausdruck ist.

{%= expression != value %}

{%= profile.homeAddress.country != "France" %}

größer als greaterthan

Verwenden Sie die Funktion > (größer als), um zu überprüfen, ob der erste Wert größer als der zweite ist.

{%= expression1 > expression2 %}

{%= profile.person.birthYear > 1970 %}

Größer oder gleich greaterthanorequal

Mit der Funktion >= (größer oder gleich) können Sie überprüfen, ob der erste Wert größer oder gleich dem zweiten Wert ist.

{%= expression1 >= expression2 %}

{%= profile.person.birthYear >= 1970 %}

kleiner als lessthan

Verwenden Sie die Vergleichsfunktion < (kleiner als), um zu überprüfen, ob der erste Wert kleiner als der zweite ist.

{%= expression1 < expression2 %}

{%= profile.person.birthYear < 2000 %}

Kleiner oder gleich lessthanorequal

Mit der Vergleichsfunktion <= (kleiner oder gleich) können Sie überprüfen, ob der erste Wert kleiner oder gleich dem zweiten Wert ist.

{%= expression1 <= expression2 %}

{%= profile.person.birthYear <= 2000 %}

Dynamische Funktionen dynamic-helpers

Verwenden Sie die dynamischen Hilfsfunktionen, um bedingte Auswertungen, Iterationen und Variablenzuweisungen für die dynamische Personalisierung zu verwenden.

Standardwert für Fallback default-value

Der Helper Default Fallback Value wird verwendet, um einen standardmäßigen Fallback-Wert zurückzugeben, wenn ein Attribut leer oder null ist. Dieser Mechanismus funktioniert für Profilattribute und Journey-Ereignisse.

Hello {%=profile.personalEmail.name.firstName ?: "there" %}!

if (conditions) if-function

Der Helper if wird zum Definieren eines bedingten Blocks verwendet.
Wenn die Auswertung des Ausdrucks „true“ zurückgibt, wird der Block dargestellt, andernfalls wird er übersprungen.

{%#if contains(account.accountOrganization.primaryEmailDomain, ".edu")%}
<a href="https://www.adobe.com/academia">Check out this link</a>

{
    {
        {%#if condition1%} element_1
        {%else if condition2%} element_2
        {%else%} default_element
        {%/if%}
    }
}

außer unless

Verwenden Sie den unless Helper , um einen bedingten Block zu definieren. Im Gegensatz zur Hilfsfunktion if wird der Block gerendert, wenn die Auswertung des Ausdrucks „falsch“ zurückgibt.

{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}

{%#unless endsWith(account.accountOrganization.primaryEmailDomain}, ".edu")%}
Some Normal Content
{%else%}
Some edu specific content
{%/unless%}

jeweils each

Verwenden Sie den each Helper , um die Elemente eines Arrays zu verarbeiten.

Die Hilfsstruktur ist {{#each ArrayName}} YourContent-{{/each}}

Sie können das Keyword this innerhalb des Blocks verwenden, um auf die einzelnen Array-Elemente zu verweisen. Verwenden Sie {{@index}} , um den Index des Array-Elements zu rendern.

{{#each profile.productsInCart}}
    <li>{{this.name}}</li>
{{/each}}

{{#each profile.homeAddress.city}}
  {{@index}} : {{this}}<br>
{{/each}}

{{#each profile.products as |product|}}
    <li>{{product.productName}} {{product.productRating}}</li>
{{/each}}

mit with

Verwenden Sie den with Helper , um das Evaluierungs-Token des Vorlagenteils zu ändern.

{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}

{{#with profile.person.name as |name|}}
 Hi {{name.firstName}} {{name.lastName}}!
 Checkout our trending products for today!
{{/with}}

belassen let

Die let-Funktion ermöglicht das Speichern eines Ausdrucks als Variable, die später in einer Abfrage verwendet werden kann.

{% let variable = expression %} {{variable}}

{% let sum = 0%}
    {{#each profile.productsInCart as |p|}}
        {%#if p.price>100 and p.price<1000%}
            {%let sum = sum + p.price %}
        {%/if%}
    {{/each}}
{{sum}}

Ausführungsmetadaten execution-metadata

Verwenden Sie den executionMetadata, um benutzerdefinierte Schlüssel-Wert-Paare dynamisch im Ausführungskontext der Nachricht zu erfassen und zu speichern.

Mit dieser Funktion können Sie kontextuelle Informationen an beliebige native Aktionen Ihrer Kampagnen oder Journeys anhängen. Verwenden Sie diese Option, um kontextuelle Echtzeit-Versanddaten für verschiedene Zwecke in externe Systeme zu exportieren, z. B. Tracking, Analyse, Personalisierung und nachgelagerte Verarbeitung.

Beispielsweise können Sie den executionMetadata Helper verwenden, um eine bestimmte ID an jeden Versand anzuhängen, der an jedes Profil gesendet wird. Diese Informationen werden zur Laufzeit generiert und die angereicherten Ausführungsmetadaten können dann zur nachgelagerten Abstimmung mit einer externen Reporting-Plattform exportiert werden.

{{executionMetadata key="your_key" value="your_value"}}

"_experience": {
  "customerJourneyManagement": {
    "messageExecution": {
      "metadata": {
        "your_key": "your_value"
      }
    }
  }
}

{{executionMetadata key="firstName" value=profile.person.name.firstName}}

{
  "key": "firstName",
  "value": "Alex"
}

Zuordnungsfunktionen maps

Verwenden Sie Zuordnungsfunktionen in der Personalisierung, um die Interaktion mit Zuordnungen zu erleichtern.

get get

Verwenden Sie die Funktion get , um den Wert einer Zuordnung für einen bestimmten Schlüssel abzurufen.

{%= get(map, string) %}

{%= get(identityMap,"example@example.com") %}

Schlüssel keys

Verwenden Sie die Funktion keys , um alle Schlüssel für eine bestimmte Zuordnung abzurufen.

{%= keys(map) %}

{%= keys(identityMap) %}

Werte values

Die values-Funktion wird zum Abrufen aller Werte einer gegebenen Zuordnung verwendet.

{%= values(map) %}

{%= values(identityMap) %}

Mathematische Funktionen math

Erfahren Sie, wie Sie im Personalisierungseditor mathematische Funktionen verwenden.

absolut absolute

Verwenden Sie die Funktion absolute , um eine Zahl in ihren absoluten Wert zu konvertieren.

{%= absolute(int) %}: int

formatNumber format-number

Verwenden Sie die Funktion formatNumber , um eine beliebige Zahl in eine sprachabhängige Darstellung zu formatieren.

Sie akzeptiert eine Zahl und eine Zeichenfolge, die das Gebietsschema darstellt, und gibt eine formatierte Zeichenfolge der Zahl im gewünschten Gebietsschema zurück.

{%= formatNumber(number/double,string) %}: string

{%= formatNumber(123456.789, "ar_EG") %}

random random

Verwenden Sie die Funktion random , um einen zufälligen Wert zwischen 0 und 1 zurückzugeben.

{%= random() %}: double

abgerundet round-down

Mit der Funktion roundDown können Sie eine Zahl abrunden.

{%= roundDown(double) %}: double

aufrunden round-up

Mit der Funktion roundUp können Sie eine Zahl aufrunden.

{%= roundUp(double) %}: double

toHexString to-hex-string

Die Funktion toHexString konvertiert eine beliebige Zahl in ihre hexadezimale Zeichenfolge.

{%= toHexString(number) %}: string

{%= toHexString(158) %}

toInt to-int

Verwenden Sie die Funktion toInt , um Typen (number, double, integer, long, float, short, byte, boolean, string) in eine Ganzzahl zu konvertieren.

{%= toInt(<valueToConvert>) %}: integer

{%= toInt(42.6) %}: integer

toPercentage to-percentage

Verwenden Sie die Funktion toPercentage , um eine Zahl in einen Prozentwert zu konvertieren.

{%= toPercentage(double) %}: string

toPrecision to-precision

Verwenden Sie die Funktion toPrecision , um eine Zahl in die erforderliche Präzision zu konvertieren.

{%= toPrecision(double,int) %}: string

toString to-string

Die Funktion toString konvertiert eine beliebige Zahl in ihre Zeichenfolgendarstellung.

{%= toString(string) %}: string

{%= toString(12) %}

Objektfunktionen objects

Objektfunktionen zum Abfragen von Objekteigenschaften oder Attributen.

isNull isNull

Die isNull-Funktion ermittelt, ob eine Objektreferenz nicht vorhanden ist.

{%= isNull(object) %}

{%= isNull(person.homeAddress) %}

isNotNull isNotNull

Die isNotNull-Funktion ermittelt, ob eine Objektreferenz nicht vorhanden ist.

{%= isNotNull(object) %}

{%= isNotNull(person.homeAddress) %}

Zeichenfolgen-Funktionen string-functions

Erfahren Sie, wie Sie im Personalisierungseditor Zeichenfolgenfunktionen verwenden können.

Binnenmajuskel camelCase

Mit der Funktion camelCase wird der erste Buchstabe eines jeden Wortes einer Zeichenfolge großgeschrieben.

{%= camelCase(string)%}

{%= camelCase(profile.homeAddress.street) %}

charCodeAt char-code-at

Die Funktion charCodeAt gibt den ASCII-Wert eines Zeichens zurück, z. B. die Funktion charCodeAt in JavaScript. Als Eingabeargumente werden eine Zeichenfolge und eine Ganzzahl (die die Position eines Zeichens definiert) benötigt und der entsprechende ASCII-Wert wird zurückgegeben.

{%= charCodeAt(string,int) %}: int

{%= charCodeAt("some", 1)%}

concat concate

Die Funktion concat kombiniert zwei Zeichenfolgen zu einer.

{%= concat(string,string) %}

{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

enthält contains

Verwenden Sie die Funktion contains , um zu bestimmen, ob eine Zeichenfolge eine angegebene Unterzeichenfolge enthält.

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}

doesNotContains doesNotContain

Verwenden Sie die Funktion doesNotContain , um zu bestimmen, ob eine Zeichenfolge eine angegebene Unterzeichenfolge nicht enthält.

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}

{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

doesNotEndWith doesNotEndWith

Verwenden Sie die Funktion doesNotEndWith , um zu bestimmen, ob eine Zeichenfolge nicht mit einer angegebenen Unterzeichenfolge endet.

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

doesNotEndWith(person.emailAddress,".com")

doesNotStartWith doesNotStartWith

Verwenden Sie die Funktion doesNotStartWith , um zu bestimmen, ob eine Zeichenfolge nicht mit einer angegebenen Unterzeichenfolge beginnt.

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

{%= doesNotStartWith(person.name,"Joe")%}

Encode64 encode64

Verwenden Sie die Funktion encode64 zum Codieren einer Zeichenfolge, um personenbezogene Daten (PI) beizubehalten, z. B. zur Aufnahme in eine URL.

{%= encode64(string) %}

endet mit endsWith

Verwenden Sie die Funktion endsWith , um zu bestimmen, ob eine Zeichenfolge mit einer angegebenen Unterzeichenfolge endet.

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

{%= endsWith(person.emailAddress,".com") %}

ist gleich equals

Mit der Funktion equals können Sie bestimmen, ob eine Zeichenfolge gleich der angegebenen Zeichenfolge ist, wobei zwischen Groß- und Kleinschreibung unterschieden wird.

{%= equals(STRING_1, STRING_2) %}

{%=equals(profile.person.name,"John") %}

equalsIgnoreCase equalsIgnoreCase

Mit der Funktion equalsIgnoreCase können Sie bestimmen, ob eine Zeichenfolge gleich der angegebenen Zeichenfolge ist, wobei nicht zwischen Groß- und Kleinschreibung unterschieden wird.

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

{%= equalsIgnoreCase(profile.person.name,"John") %}

extractEmailDomain extractEmailDomain

Extrahieren Sie mit der Funktion extractEmailDomain die Domain einer E-Mail-Adresse.

{%= extractEmailDomain(string) %}

{%= extractEmailDomain(profile.personalEmail.address) %}

formatCurrency format-currency

Verwenden Sie die Funktion formatCurrency , um eine beliebige Zahl in die entsprechende sprachabhängige Währungsdarstellung zu konvertieren, je nachdem, welches Gebietsschema als Zeichenfolge im zweiten Argument übergeben wurde.

{%= formatCurrency(number/double,string) %}: string

{%= formatCurrency(56L,"en_GB") %}

getUrlHost get-url-host

Verwenden Sie die Funktion getUrlHost , um den Host-Namen einer URL abzurufen.

{%= getUrlHost(string) %}: string

{%= getUrlHost("https://www.myurl.com/contact") %}

getUrlPath get-url-path

Verwenden Sie die Funktion getUrlPath , um den Pfad nach dem Domain-Namen einer URL abzurufen.

{%= getUrlPath(string) %}: string

{%= getUrlPath("https://www.myurl.com/contact.html") %}

getUrlProtocol get-url-protocol

Verwenden Sie die Funktion getUrlProtocol , um das Protokoll einer URL abzurufen.

{%= getUrlProtocol(string) %}: string

{%= getUrlProtocol("https://www.myurl.com/contact.html") %}

indexOf index-of

Verwenden Sie die Funktion indexOf , um die Position (im ersten Argument) des ersten Auftretens des zweiten Parameters zurückzugeben. Gibt -1 zurück, wenn keine Übereinstimmung vorliegt.

{%= indexOf(STRING_1, STRING_2) %}: integer

{%= indexOf("hello world","world" ) %}

isEmpty isEmpty

Verwenden Sie die Funktion isEmpty , um zu bestimmen, ob eine Zeichenfolge leer ist.

{%= isEmpty(string) %}

{%= isEmpty(profile.mobilePhone.number) %}

isNotEmpty is-not-empty

Verwenden Sie die Funktion isNotEmpty , um zu bestimmen, ob eine Zeichenfolge nicht leer ist.

{= isNotEmpty(string) %}: boolean

{%= isNotEmpty(profile.mobilePhone.number) %}

lastIndexOf last-index-of

Verwenden Sie die Funktion lastIndexOf , um die Position (im ersten Argument) des letzten Auftretens des zweiten Parameters zurückzugeben. Gibt -1 zurück, wenn keine Übereinstimmung vorliegt.

{= lastIndexOf(STRING_1, STRING_2) %}: integer

{%= lastIndexOf("hello world","o" ) %}

leftTrim leftTrim

Verwenden Sie die Funktion leftTrim , um Leerzeichen vom Anfang einer Zeichenfolge zu entfernen.

{%= leftTrim(string) %}

length length

Verwenden Sie die Funktion length , um die Anzahl der Zeichen in einer Zeichenfolge oder einem Ausdruck abzurufen.

{%= length(string) %}

{%= length(profile.homeAddress.city) %}

Gefällt mir like

Verwenden Sie die Funktion like , um zu bestimmen, ob eine Zeichenfolge einem angegebenen Muster entspricht.

{%= like(STRING_1, STRING_2) %}

{%= like(profile.homeAddress.city, "%es%")%}

Kleinbuchstaben lower

Verwenden Sie die Funktion lowerCase , um eine Zeichenfolge in Kleinbuchstaben zu konvertieren.

{%= lowerCase(string) %}

{%= lowerCase(profile.person.name.firstName) %}

„matches“ matches

Verwenden Sie die Funktion matches , um zu bestimmen, ob eine Zeichenfolge mit einem bestimmten regulären Ausdruck übereinstimmt. Weitere Informationen zu Übereinstimmungsmustern in regulären Ausdrücken finden Sie in Dokumentation zu Oracle.

{%= matches(STRING_1, STRING_2) %}

{%= matches(person.name.,"(?i)^John") %}

Maske mask

Verwenden Sie die Funktion mask , um einen Teil einer Zeichenfolge durch „X“-Zeichen zu ersetzen.

{%= mask(string,integer,integer) %}

{%= mask("123456789",1,2) %}

md5 md5

Verwenden Sie die Funktion md5 , um den MD5-Hash einer Zeichenfolge zu berechnen und zurückzugeben.

{%= md5(string) %}: string

{%= md5("hello world") %}

notEqualTo notEqualTo

Verwenden Sie die Funktion notEqualTo , um zu bestimmen, ob eine Zeichenfolge nicht gleich der angegebenen Zeichenfolge ist.

{%= notEqualTo(STRING_1, STRING_2) %}

{%= notEqualTo(profile.person.name,"John") %}

notEqualWithIgnoreCase not-equal-with-ignore-case

Verwenden Sie die notEqualWithIgnoreCase-Funktion, um zwei Zeichenfolgen zu vergleichen, wobei die Groß-/Kleinschreibung ignoriert wird.

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean

{%= notEqualTo(profile.person.name,"john") %}

RegexGroup regexGroup

Verwenden Sie die regexGroup-Funktion, um spezifische Informationen basierend auf dem bereitgestellten regulären Ausdruck zu extrahieren.

{%= regexGroup(STRING, EXPRESSION, GROUP) %}

{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

replace replace

Verwenden Sie die Funktion replace , um eine bestimmte Unterzeichenfolge in einer Zeichenfolge durch eine andere Unterzeichenfolge zu ersetzen.

{%= replace(STRING_1,STRING_2,STRING_3) %}:string

{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

replaceAll replaceAll

Verwenden Sie die Funktion replaceAll , um alle Unterzeichenfolgen eines Textes, die mit dem Regex-Ausdruck übereinstimmen, durch die angegebene literale Ersatzzeichenfolge zu ersetzen. Regex verfügt über eine besondere Handhabung von \ und + und alle Regex-Ausdrücke folgen der PQL-Escaping-Strategie. Die Ersetzung erfolgt vom Anfang der Zeichenfolge zum Ende, z. B. führt ein Ersetzen von aa durch b in der Zeichenfolge aaa zu ba statt zu ab.

{%= replaceAll(string,string,string) %}

RightTrim rightTrim

Die Funktion rightTrim entfernt Leerzeichen vom Ende einer Zeichenfolge.

{%= rightTrim(string) %}

SHA256 sha256

Mit der Funktion sha256 wird der sha256-Hash eines Strings berechnet und zurückgegeben.

{%= sha256(string) %} : string

{%= sha256("Eliechxh")%}

split split

Verwenden Sie die Funktion split , um eine Zeichenfolge durch ein bestimmtes Zeichen zu teilen.

{%= split(string,string) %}

startsWith startsWith

Verwenden Sie die Funktion startsWith , um zu bestimmen, ob eine Zeichenfolge mit einer angegebenen Unterzeichenfolge beginnt.

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

{%= startsWith(person.name,"Joe") %}

stringToDate string-to-date

Die Funktion stringToDate konvertiert einen Zeichenfolgenwert in einen Datums-/Uhrzeitwert. Es gibt zwei Argumente: Zeichenfolgendarstellung eines Datums/Uhrzeit und Zeichenfolgendarstellung des Formatierers.

{= stringToDate("date-time value","formatter" %}

{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}

string_to_integer string-to-integer

Verwenden Sie die Funktion string_to_integer , um einen Zeichenfolgenwert in einen ganzzahligen Wert zu konvertieren.

{= string_to_integer(string) %}: int

stringToNumber string-to-number

Verwenden Sie die Funktion stringToNumber , um eine Zeichenfolge in eine Zahl zu konvertieren. Bei einer ungültigen Eingabe wird dieselbe Zeichenfolge als Ausgabe zurückgegeben.

{%= stringToNumber(string) %}: double

substr sub-string

Verwenden Sie die Funktion substr , um die Unterzeichenfolge des Zeichenfolgenausdrucks zwischen dem Anfangsindex und dem Endindex zurückzugeben.

{= substr(string, integer, integer) %}: string

titleCase titleCase

Verwenden Sie die Funktion titleCase , um die ersten Buchstaben jedes Wortes einer Zeichenfolge großzuschreiben.

{%= titleCase(string) %}

{%= titleCase(profile.person.location.Street) %}

toBool to-bool

Verwenden Sie die Funktion toBool , um einen Argumentwert je nach Typ in einen booleschen Wert zu konvertieren.

{= toBool(string) %}: boolean

toDateTime to-date-time

Verwenden Sie die Funktion toDateTime , um die Zeichenfolge in ein Datum zu konvertieren. Bei einer ungültigen Eingabe wird als Ausgabe das Epochen-Datum zurückgegeben.

{%= toDateTime(string, string) %}: date-time

toDateTimeOnly to-date-time-only

Verwenden Sie die Funktion toDateTimeOnly , um einen Argumentwert in einen Uhrzeit-/Datumswert zu konvertieren. Bei einer ungültigen Eingabe wird als Ausgabe das Epoch-Datum zurückgegeben. Diese Funktion akzeptiert die Feldtypen string, date, long und integer.

{%= toDateTimeOnly(string/date/long/int) %}: date-time

trim trim

Die Funktion trim entfernt alle Leerzeichen vom Anfang und Ende einer Zeichenfolge.

{%= trim(string) %}

Großbuchstaben upper

Mit der Funktion upperCase wird eine Zeichenfolge in Großbuchstaben umgewandelt.

{%= upperCase(string) %}

{%= upperCase(profile.person.name.lastName) %}

urlDecode url-decode

Verwenden Sie die Funktion urlDecode zum Decodieren einer URL-codierten Zeichenfolge.

{%= urlDecode(string) %}: string

urlEncode url-encode

Verwenden Sie die Funktion urlEncode , um eine Zeichenfolge als URL zu codieren.

{%= urlEncode(string) %}: string