Helpfuncties

Met de Helper-functies in de verpersoonlijkingseditor kunt u nauwkeurig en efficiënt gepersonaliseerde inhoud definiëren door gegevens te manipuleren, berekeningen uit te voeren en inhoud op te maken. Experimenteer en experimenteer met deze functies, operatoren en helpers om te ontdekken hoe ze samenwerken om u te helpen op maat gemaakte, gegevensgestuurde reizen te maken.

Samenvoegingsfuncties

Gebruik aggregatiefuncties om meerdere waarden te groeperen en één samenvattingswaarde te maken. U kunt ook array- en lijstfuncties gebruiken om gemakkelijker interacties met arrays, lijsten en tekenreeksen te definiëren.

gemiddelde average

Gebruik de functie average om het rekenkundig gemiddelde van alle geselecteerde waarden binnen de array te retourneren.

Syntaxis
code language-sql
{%= average(array) %}

Voorbeeld

De volgende bewerking retourneert de gemiddelde prijs van alle orders.

code language-sql
{%=average(orders.order.price)%}

aantal count

Gebruik de functie count om het aantal elementen binnen de opgegeven array te retourneren.

Syntaxis
code language-sql
{%= count(array) %}

Voorbeeld

De volgende bewerking retourneert het aantal orders in de array.

code language-sql
{%= count(orders) %}

max max

Gebruik de functie max om de grootste van alle geselecteerde waarden binnen de array te retourneren.

Syntaxis
code language-sql
{%= max(array) %}

Voorbeeld

De volgende bewerking retourneert de hoogste prijs van alle orders.

code language-sql
{%=max(orders.order.price)%}

min min

Gebruik de functie min om de kleinste van alle geselecteerde waarden in de array te retourneren.

Syntaxis
code language-sql
{%= min(array) %}

Voorbeeld

De volgende bewerking retourneert de laagste prijs van alle orders.

code language-sql
{%=min(orders.order.price) %}

som sum

Gebruik de functie sum om de som van alle geselecteerde waarden in de array te retourneren.

Syntaxis
code language-sql
{%= sum(array) %}

Voorbeeld

De volgende bewerking retourneert de som van de prijzen van alle orders.

code language-sql
 {%=sum(orders.order.price)%}

Rekenkundige functies maths

Gebruik rekenkundige functies om basisberekeningen van waarden uit te voeren.

toevoegen add

Gebruik de functie + (optellen) om de som van twee argumentexpressies te vinden.

Syntaxis
code language-sql
{%= double + double %}

Voorbeeld

De volgende transactie geeft de prijs van twee verschillende producten weer.

code language-sql
{%= product1.price + product2.price %}

vermenigvuldigen multiply

Gebruik de functie * (vermenigvuldigen) om het product van twee argumentexpressies te zoeken.

Syntaxis
code language-sql
{%= double * double %}

Voorbeeld

Bij de volgende bewerking worden het product van de inventaris en de prijs van een product gevonden om de brutowaarde van het product te bepalen.

code language-sql
{%= product.inventory * product.price %}

aftrekken substract

Gebruik de functie - (aftrekken) om het verschil tussen twee argumentexpressies te vinden.

Syntaxis
code language-sql
{%= double - double %}

Voorbeeld

De volgende transactie vindt het prijsverschil tussen twee verschillende producten.

code language-sql
{%= product1.price - product2.price %}

delen divide

Gebruik de functie / (delen) om het quotiënt van twee argumentexpressies te vinden.

Syntaxis
code language-sql
{%= double / double %}

Voorbeeld

Met de volgende bewerking wordt het quotiënt gevonden tussen de totale verkochte producten en het totale verdiende geld om de gemiddelde kosten per object te zien.

code language-sql
{%= totalProduct.price / totalProduct.sold %}

restant remainder

Gebruik de functie % (rest) om de rest te zoeken na het delen van de twee argumentexpressies.

Syntaxis
code language-sql
{%= double % double %}

Voorbeeld

De volgende bewerking controleert of de leeftijd van de persoon met vijf personen kan worden gedeeld.

code language-sql
{%= person.age % 5 = 0 %}

Arrays en lijstfuncties arrays

Gebruik deze functies om interactie met arrays, lijsten en tekenreeksen eenvoudiger te maken.

countOnlyNull count-only-null

Gebruik de functie countOnlyNull om het aantal null-waarden in een lijst te tellen.

Syntaxis
code language-sql
{%= countOnlyNull(array) %}

Voorbeeld

code language-sql
{%= countOnlyNull([4,0,1,6,0,0]) %}

Retourneert 3.

countWithNull count-with-null

Gebruik de functie countWithNull om alle elementen van een lijst te tellen, inclusief null-waarden.

Syntaxis
code language-sql
{%= countWithNull(array) %}

Voorbeeld

code language-sql
{%= countOnlyNull([4,0,1,6,0,0]) %}

Retourneert 6.

onderscheiden distinct

Gebruik de functie distinct om waarden op te halen uit een array of lijst met verwijderde dubbele waarden.

Syntaxis
code language-sql
{%= distinct(array) %}

Voorbeeld

Met de volgende bewerking worden personen opgegeven die orders in meer dan één winkel hebben geplaatst.

code language-sql
{%= distinct(person.orders.storeId).count() > 1 %}

differentCountWithNull distinct-count-with-null

Gebruik de functie distinctCountWithNull om het aantal verschillende waarden in een lijst te tellen met inbegrip van de ongeldige waarden.

Syntaxis
code language-sql
{%= distinctCountWithNull(array) %}

Voorbeeld

code language-sql
{%= distinctCountWithNull([10,2,10,null]) %}

Retourneert 3.

kop head

Gebruik de functie head om het eerste item in een array of lijst te retourneren.

Syntaxis
code language-sql
{%= head(array) %}

Voorbeeld

De volgende bewerking retourneert de eerste van de bovenste vijf bestellingen met de hoogste prijs. Meer informatie over de topN functie kan in ​ eerst n in serie ​ sectie worden gevonden.

code language-sql
{%= head(topN(orders,price, 5)) %}

topN first-n

De functie topN sorteert een array in aflopende volgorde op basis van de opgegeven numerieke expressie en retourneert de eerste N -items. Wanneer de arraygrootte kleiner is dan N , wordt de volledige gesorteerde array geretourneerd.

Syntaxis
code language-sql
{%= topN(array, value, amount) %}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
{ARRAY} De array of lijst die moet worden gesorteerd.
{VALUE} De eigenschap die wordt gebruikt om de array of lijst te sorteren.
{AMOUNT} Het aantal objecten dat moet worden geretourneerd.

Voorbeeld

De volgende bewerking retourneert de eerste vijf bestellingen met de laagste prijs.

code language-sql
{%= topN(orders,price, 5) %}

in in

Gebruik de functie in om te bepalen of een item lid is van een array of lijst.

Syntaxis
code language-sql
{%= in(value, array) %}

Voorbeeld

De volgende bewerking definieert personen met verjaardagen in maart, juni of september.

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

include includes

Gebruik de functie includes om te bepalen of een array of lijst een bepaald item bevat.

Syntaxis
code language-sql
{%= includes(array,item) %}

Voorbeeld

De volgende bewerking definieert personen van wie de favoriete kleur rood bevat.

code language-sql
{%= includes(person.favoriteColors,"red") %}

doorsnede intersects

De functie intersects wordt gebruikt om te bepalen of twee arrays of lijsten ten minste één gemeenschappelijk lid hebben.

Syntaxis
code language-sql
{%= intersects(array1, array2) %}

Voorbeeld

De volgende bewerking definieert personen van wie de favoriete kleuren ten minste een van de kleuren rood, blauw of groen zijn.

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

bottomN last-n

De functie bottomN sorteert een array in oplopende volgorde op basis van de opgegeven numerieke expressie en retourneert de eerste N -items. Wanneer de arraygrootte kleiner is dan N , wordt de volledige gesorteerde array geretourneerd.

Syntaxis
code language-sql
{%= bottomN(array, value, amount) %}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
{ARRAY} De array of lijst die moet worden gesorteerd.
{VALUE} De eigenschap die wordt gebruikt om de array of lijst te sorteren.
{AMOUNT} Het aantal objecten dat moet worden geretourneerd.

Voorbeeld

De volgende bewerking retourneert de laatste vijf bestellingen met de hoogste prijs.

code language-sql
{%= bottomN(orders,price, 5) %}

notIn notin

Gebruik de functie notIn om te bepalen of een item geen lid is van een array of lijst.

NOTE
De notIn functie ** zorgt ook ervoor dat geen van beide waarde aan ongeldig is. Daarom zijn de resultaten geen exacte negatie van de functie in .
Syntaxis
code language-sql
{%= notIn(value, array) %}

Voorbeeld

De volgende bewerking definieert personen met verjaardagen die zich niet in maart, juni of september bevinden.

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

subsetOf subset

Gebruik de functie subsetOf om te bepalen of een specifieke array (array A) een subset is van een andere array (array B). Met andere woorden, alle elementen in array A zijn elementen van array B.

Syntaxis
code language-sql
{%= subsetOf(array1, array2) %}

Voorbeeld

De volgende bewerking definieert mensen die al hun favoriete steden hebben bezocht.

code language-sql
{%= subsetOf(person.favoriteCities,person.visitedCities) %}

supersetOf superset

Gebruik de functie supersetOf om te bepalen of een specifieke array (array A) een superset is van een andere array (array B). Met andere woorden, die array A bevat alle elementen in array B.

Syntaxis
code language-sql
{%= supersetOf(array1, array2) %}

Voorbeeld

De volgende bewerking definieert mensen die sushi en pizza hebben gegeten ten minste één keer.

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

Datum- en tijdfuncties date-time

Gebruik de datum- en tijdfuncties om datum- en tijdbewerkingen op waarden uit te voeren.

addDays add-days

De functie addDays past een bepaalde datum met een bepaald aantal dagen aan, gebruikend positieve waarden aan toename en negatieve waarden aan decrement.

Syntaxis
code language-sql
{%= addDays(date, number) %}

Voorbeeld

  • Invoer: {%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %}
  • Uitvoer: 2024-11-11T17:19:51Z

addHours add-hours

De functie addHours past een bepaalde datum met een bepaald aantal uren aan, gebruikend positieve waarden aan toename en negatieve waarden aan decrement.

Syntaxis
code language-sql
{%= addHours(date, number) %}

Voorbeeld

  • Invoer: {%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %}
  • Uitvoer: 2024-11-01T18:19:51Z

addMinutes add-minutes

De functie addMinutes past een bepaalde datum met een opgegeven aantal minuten aan, waarbij positieve waarden worden gebruikt voor verhogen en negatieve waarden voor verlagen.

Syntaxis
code language-sql
{%= addMinutes(date, number) %}

Voorbeeld

  • Invoer: {%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %}
  • Uitvoer: 2024-11-01T18:09:51Z

addMonths add-months

De functie addMonths past een bepaalde datum met een bepaald aantal maanden aan, gebruikend positieve waarden aan toename en negatieve waarden aan decrement.

Syntaxis
code language-sql
{%= addMonths(date, number) %}

Voorbeeld

  • Invoer: {%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %}
  • Uitvoer: 2025-01-01T17:19:51Z

addSeconds add-seconds

De functie addSeconds past een bepaalde datum met een bepaald aantal seconden aan, waarbij positieve waarden worden gebruikt om te verhogen en negatieve waarden om te verlagen.

Syntaxis
code language-sql
{%= addSeconds(date, number) %}

Voorbeeld

  • Invoer: {%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %}
  • Uitvoer: 2024-11-01T17:20:01Z

addYear add-years

De functie addYears past een bepaalde datum met een bepaald aantal jaren aan, gebruikend positieve waarden aan toename en negatieve waarden aan decrement.

Syntaxis
code language-sql
{%= addYears(date, number) %}

Voorbeeld

  • Invoer: {%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %}
  • Uitvoer: 2026-11-01T17:19:51Z

ouderdom age

Gebruik de functie age om de leeftijd vanaf een bepaalde datum op te halen.

Syntaxis
code language-sql
 {%= age(datetime) %}

ageInDays age-days

De functie ageInDays berekent het aantal dagen dat is verstreken tussen de opgegeven datum en de huidige datum. Het gebruikt negatief voor toekomstige data en positief voor vroegere data.

Syntaxis
code language-sql
{%= ageInDays(date) %}

Voorbeeld

currentDate = 2025-01-07T12 :17: 10.720122+05 :30 (Azië/Kolkata)

  • Invoer: {%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%}
  • Uitvoer: 5

ageInMonths age-months

De functie ageInMonths berekent het aantal maanden dat is verstreken tussen de opgegeven datum en de huidige datum. Het gebruikt negatief voor toekomstige data en positief voor vroegere data.

Syntaxis
code language-sql
{%= ageInMonths(date) %}

Voorbeeld

currentDate = 2025-01-07T12 :22: 46.993748+05 :30 (Azië/Kolkata)

  • Invoer: {%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%}
  • Uitvoer: 12

compareDates compare-dates

De functie compareDates vergelijkt de eerste invoerdatum met de andere. Het keert 0 terug als date1 aan date2 gelijk is, -1 als date1 vóór date2 komt, en 1 als date1 na date2 komt.

Syntaxis
code language-sql
{%= compareDates(date1, date2) %}

Voorbeeld

  • Invoer: {%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%}
  • Uitvoer: -1

convertZonedDateTime convert-zoned-date-time

De functie convertZonedDateTime zet een datum-tijd om in een bepaalde tijdzone.

Syntaxis
code language-sql
{%= convertZonedDateTime(dateTime, timezone) %}

Voorbeeld

  • Invoer: {%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%}
  • Uitvoer: 2019-02-19T11:39+03:30[Asia/Tehran]

currentTimeInMillis current-time

Gebruik de functie currentTimeInMillis om de huidige tijd in epoch milliseconds op te halen.

Syntaxis
code language-sql
{%= currentTimeInMillis() %}

dateDiff date-diff

Gebruik de functie dateDiff om het verschil tussen twee datums in aantal dagen op te halen.

Syntaxis
code language-sql
{%= dateDiff(datetime,datetime) %}

dayOfMonth day-month

De dayOfMonth retourneert het getal dat de dag van de maand vertegenwoordigt.

Syntaxis
code language-sql
{%= dayOfMonth(datetime) %}

Voorbeeld

  • Invoer: {%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %}
  • Uitvoer: 5

DayOfWeek day-week

Gebruik de functie dayOfWeek om de dag van de week op te halen.

Syntaxis
code language-sql
{%= dayOfWeek(datetime) %}

dayOfYear day-year

Gebruik de functie dayOfYear om de dag van het jaar op te halen.

Syntaxis
code language-sql
{%= dayOfYear(datetime) %}

diffInSeconds diff-seconds

De functie diffInSeconds retourneert het verschil tussen twee datums in seconden.

Syntaxis
code language-sql
{%= diffInSeconds(endDate, startDate) %}

Voorbeeld

  • Invoer: {%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%}
  • Uitvoer: 50

extractHours extract-hours

De functie extractHours extraheert de uurcomponent uit een bepaald tijdstempel.

Syntaxis
code language-sql
{%= extractHours(date) %}

Voorbeeld

  • Invoer: {%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 17

extractMinutes extract-minutes

De functie extractMinutes extraheert de component minute uit een bepaald tijdstempel.

Syntaxis
code language-sql
{%= extractMinutes(date) %}

Voorbeeld

  • Invoer: {%= extractMinutes(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 19

extractMonths extract-months

De functie extractMonth extraheert de component month uit een opgegeven tijdstempel.

Syntaxis
code language-sql
{%= extractMonths(date) %}

Voorbeeld

  • Invoer: {%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 11

extractSeconds extract-seconds

De functie extractSeconds extraheert de tweede component uit een bepaald tijdstempel.

Syntaxis
code language-sql
{%= extractSeconds(date) %}

Voorbeeld

  • Invoer: {%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 51

formatDate format-date

Gebruik de functie formatDate om een datumtijdwaarde op te maken. De indeling moet een geldig Java DateTimeFormat -patroon zijn.

Syntaxis
code language-sql
{%= formatDate(datetime, format) %}

Waar de eerste tekenreeks het datumkenmerk is en de tweede waarde hoe u de datum wilt omzetten en weergeven.

note
NOTE
Als een datumpatroon ongeldig is, wordt de datum teruggezet naar de ISO-standaardindeling.
U kunt de datum die functies gebruiken Java zoals samengevat in ​ documentatie van Oracle ​

Voorbeeld

De volgende bewerking retourneert de datum in de volgende notatie: DD-MM-YY.

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

Patroontekens pattern-characters

Sommige patroonletters kunnen er hetzelfde uitzien, maar vertegenwoordigen verschillende concepten.

Patroon
Betekenis
Voorbeeld (voor 2023-12-31T10:15:30Z)
y
Kalenderjaar (standaardjaar)
2023
Y
Weekjaar (ISO 8601). Het kan per jaar verschillen.
2024 (31 december 2023 valt in de eerste week van 2024)
M
Maand van jaar (1-12 of tekst zoals Jan, January)
12 of Dec
m
Minuut-van-uur (0-59)
15
d
Dag van de maand (1-31)
31
D
Jaar (1-366)
365

Datumnotatie met ondersteuning voor landinstellingen format-date-locale

Met de functie formatDate kunt u een datumtijdwaarde opmaken in de corresponderende taalgevoelige representatie, bijvoorbeeld voor een gewenste landinstelling. De indeling moet een geldig Java DateTimeFormat -patroon zijn.

Syntaxis
code language-sql
{%= formatDate(datetime, format, locale) %}

Waar de eerste tekenreeks het datumkenmerk is, is de tweede waarde hoe u de datum wilt converteren en weergeven, en de derde waarde vertegenwoordigt de landinstelling in tekenreeksindeling.

note
NOTE
Als een datumpatroon ongeldig is, wordt de datum teruggezet naar de ISO-standaardindeling.
U kunt de datum het formatteren functies van Java zoals samengevat in de ​ documentatie van Oracle ​ gebruiken.
U kunt het formatteren en geldige scènes gebruiken zoals samengevat in de ​ documentatie van Oracle ​ en ​ Gesteunde scènes ​.

Voorbeeld

De volgende bewerking retourneert de datum in de volgende notatie: dd-MM-YY en landinstelling FRANKRIJK.

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

getCurrentZonedDateTime get-current-zoned-date-time

De functie getCurrentZonedDateTime retourneert de huidige datum en tijd met informatie over de tijdzone.

Syntaxis
code language-sql
{%= getCurrentZonedDateTime() %}

Voorbeeld

  • Invoer: {%= getCurrentZonedDateTime() %}
  • Uitvoer: 2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]

diffInHours hours-difference

De functie diffInHours retourneert het verschil tussen twee datums in termen van uren.

Syntaxis
code language-sql
{%= diffInHours(endDate, startDate) %}

Voorbeeld

  • Invoer: {%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%}
  • Uitvoer: 10

diffInMinutes diff-minutes

De functie diffInMinutes retourneert het verschil tussen twee datums in minuten.

Syntaxis
code language-sql
{%= diffInMinutes(endDate, startDate) %}

Voorbeeld

  • Invoer: {%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%}
  • Uitvoer: 60

diffInMonths months-difference

De functie diffInMonths retourneert het verschil tussen twee datums in termen van maanden.

Syntaxis
code language-sql
{%= diffInMonths(endDate, startDate) %}

Voorbeeld

  • Invoer: {%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%}
  • Uitvoer: 3

setDays set-days

Gebruik de functie setDays om de dag van de maand voor de opgegeven datum-tijd in te stellen.

Syntaxis
code language-sql
{%= setDays(datetime, day) %}

setHours set-hours

Gebruik de functie setHours om het uur van de datum-tijd in te stellen.

Syntaxis
code language-sql
{%= setHours(datetime, hour) %}

toDateTime string-to-date-time

De functie toDateTime zet een tekenreeks om in datum. De epochdatum wordt geretourneerd als uitvoer voor ongeldige invoer.

Syntaxis
code language-sql
{%= toDateTime(string, string) %}

Voorbeeld

  • Invoer: {%=toDateTime("2024-11-01T17:19:51Z")%}
  • Uitvoer: 2024-11-01T17:19:51Z

toUTC to-utc

Gebruik de functie toUTC om een datetime om te zetten in UTC.

Syntaxis
code language-sql
{%= toUTC(datetime) %}

truncateToStartOfDay truncate-day

Gebruik de truncateToStartOfDay functie om een bepaalde datum-tijd te wijzigen door het aan het begin van de dag met tijd bij 00 :00 te plaatsen.

Syntaxis
code language-sql
{%= truncateToStartOfDay(date) %}

Voorbeeld

  • Invoer: {%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %}
  • Uitvoer: 2024-11-01T00:00Z

truncateToStartOfQuarter truncate-quarter

Gebruik de functie truncateToStartOfQuarter wordt gebruikt om een datum-tijd aan de eerste dag van zijn kwartaal (zoals 1 Januari, 1 April, 1 Juli, 1 Oktober 1) om 00 te beknotten :00.

Syntaxis
code language-sql
{%= truncateToStartOfQuarter(dateTime) %}

Voorbeeld

  • Invoer: {%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 2024-10-01T00:00Z

truncateToStartOfWeek truncate-week

De functie truncateToStartOfWeek wijzigt een bepaalde datum-tijd door het aan het begin van de week (Maandag bij 00 :00 te plaatsen).

Syntaxis
code language-sql
{%= truncateToStartOfWeek(dateTime) %}

Voorbeeld

  • Invoer: {%= truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday
  • Uitvoer: 2024-11-18T00:00Z // monday

truncateToStartOfYear truncate-year

Gebruik de functie truncateToStartOfYear om een bepaalde datum-tijd te wijzigen door het te beknotten aan de eerste dag van het jaar (1 Januari) bij 00 :00.

Syntaxis
code language-sql
{%= truncateToStartOfYear(dateTime) %}

Voorbeeld

  • Invoer: {%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%}
  • Uitvoer: 2024-01-01T00:00Z

weekOfYear week-of-year

Gebruik de functie weekOfYear om de week van het jaar op te halen.

Syntaxis
code language-sql
{%= weekOfYear(datetime) %}

diffInYear diff-years

Gebruik de functie diffInYears om het verschil tussen twee datums in termen van jaren te retourneren.

Syntaxis
code language-sql
{%= diffInYears(endDate, startDate) %}: int

Voorbeeld

  • Invoer: {%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%}
  • Uitvoer: 5

Operator-functies operators

Gebruik de functies Boolean en Compare om logische evaluaties uit te voeren.

en and

De functie and wordt gebruikt om een logische combinatie te maken.

Syntaxis
code language-sql
{%= query1 and query2 %}

Voorbeeld

De volgende operatie retourneert alle mensen in het thuisland (Frankrijk) en het geboortejaar (1985).

code language-sql
{%= profile.homeAddress.country = "France" and profile.person.birthYear = 1985 %}

of or

De functie or wordt gebruikt om een logische scheiding te maken.

Syntaxis
code language-sql
{%= query1 or query2 %}

Voorbeeld

De volgende operatie retourneert alle mensen in het thuisland (Frankrijk) of het geboortejaar (1985).

code language-sql
{%= profile.homeAddress.country = "France" or profile.person.birthYear = 1985 %}

equals operator-equals

De functie = (equals) controleert of een waarde of expressie gelijk is aan een andere waarde of expressie.

Syntaxis
code language-sql
{%= expression = value %}

Voorbeeld

De volgende operatie controleert of het thuisadresland Frankrijk is.

code language-sql
{%= profile.homeAddress.country = "France" %}

niet gelijk aan notequal

De != (niet gelijk aan) functie controleert of één waarde of uitdrukking ​niet gelijk aan een andere waarde of een uitdrukking is.

Syntaxis
code language-sql
{%= expression != value %}

Voorbeeld

De volgende operatie controleert of het thuisadresland niet Frankrijk is.

code language-sql
{%= profile.homeAddress.country != "France" %}

groter dan greaterthan

Controleer met de functie > (groter dan) of de eerste waarde groter is dan de tweede waarde.

Syntaxis
code language-sql
{%= expression1 > expression2 %}

Voorbeeld

De volgende bewerking definieert personen die strikt na 1970 geboren zijn.

code language-sql
{%= profile.person.birthYear > 1970 %}

groter dan of gelijk aan greaterthanorequal

Gebruik de functie >= (groter dan of gelijk aan) om te controleren of de eerste waarde groter dan of gelijk is aan de tweede waarde.

Syntaxis
code language-sql
{%= expression1 >= expression2 %}

Voorbeeld

In de volgende bewerking worden personen gedefinieerd die in of na 1970 zijn geboren.

code language-sql
{%= profile.person.birthYear >= 1970 %}

minder dan lessthan

Gebruik de vergelijkingsfunctie < (kleiner dan) om te controleren of de eerste waarde kleiner is dan de tweede waarde.

Syntaxis
code language-sql
{%= expression1 < expression2 %}

Voorbeeld

In de volgende bewerking worden personen gedefinieerd die vóór 2000 zijn geboren.

code language-sql
{%= profile.person.birthYear < 2000 %}

kleiner dan of gelijk aan lessthanorequal

Gebruik de vergelijkingsfunctie <= (kleiner dan of gelijk aan) om te controleren of de eerste waarde kleiner dan of gelijk is aan de tweede waarde.

Syntaxis
code language-sql
{%= expression1 <= expression2 %}

Voorbeeld

De volgende bewerking definieert personen die in 2000 of eerder zijn geboren.

code language-sql
{%= profile.person.birthYear <= 2000 %}

Dynamische functies dynamic-helpers

Gebruik de dynamische hulpfuncties om voorwaardelijke evaluaties, herhaling en veranderlijke toewijzingen voor dynamische verpersoonlijking te gebruiken.

Standaardwaarde voor alternatieven default-value

De Default Fallback Value helper wordt gebruikt om een standaardreservewaarde terug te keren als een attribuut leeg of ongeldig is. Dit mechanisme werkt voor Profielkenmerken en Reisgebeurtenissen.

Syntaxis
code language-sql
Hello {%=profile.personalEmail.name.firstName ?: "there" %}!

In dit voorbeeld wordt de waarde there weergegeven als het firstName -kenmerk van dit profiel leeg of null is.

if (voorwaarden) if-function

De hulpfunctie if wordt gebruikt om een voorwaardelijk blok te definiëren.
Als de uitdrukkingsevaluatie waar terugkeert, wordt het blok teruggegeven anders wordt het overgeslagen.

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

Na de hulpfunctie if kunt u een instructie else invoeren om een codeblok op te geven dat moet worden uitgevoerd als dezelfde voorwaarde false is.
De instructie elseif geeft een nieuwe voorwaarde op die moet worden getest als de eerste instructie false retourneert.

Formaat

code language-sql
{
    {
        {%#if condition1%} element_1
        {%else if condition2%} element_2
        {%else%} default_element
        {%/if%}
    }
}

tenzij unless

Met de unless -hulplijn kunt u een voorwaardelijk blok definiëren. Als de evaluatie van de expressie false retourneert, wordt het blok gerenderd als dit tegengesteld is aan de if helper.

Syntaxis
code language-sql
{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}

Voorbeeld

Geef wat inhoud weer op basis van de extensie van het e-mailadres:

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

elk each

Gebruik de hulpfunctie each om een array te doorlopen.

De hulpstructuur is



De hulpstructuur is

De hulpstructuur is U kunt het trefwoord this in het blok gebruiken om naar de afzonderlijke arrayitems te verwijzen. Gebruik {{@index}} om de index van het element van de array te renderen.

De hulpstructuur is

De hulpstructuur is +++Syntaxis

De hulpstructuur is

De hulpstructuur is

**Voorbeeld**

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

Voorbeeld

Een lijst met producten weergeven die deze gebruiker in zijn winkelwagentje heeft:

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

+++

with with

Gebruik de with helper om het evaluatietoken van malplaatje-deel te veranderen.

Syntaxis
code language-sql
{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}

De hulpfunctie with is nuttig om ook een sneltoetsvariabele te definiëren.

Voorbeeld

Gebruik with voor het aliasing van lange variabelenamen naar kortere:

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

laten let

Met de functie let kan een expressie worden opgeslagen als een variabele die later in een query moet worden gebruikt.

Syntaxis
code language-sql
{% let variable = expression %} {{variable}}

Voorbeeld

In het volgende voorbeeld kunt u de totale som van prijzen voor producten in de winkelwagen berekenen met prijzen tussen 100 en 1000.

code language-sql
{% let sum = 0%}
    {{#each profile.productsInCart as |p|}}
        {%#if p.price>100 and p.price<1000%}
            {%let sum = sum + p.price %}
        {%/if%}
    {{/each}}
{{snippet-not-found:sum}}

Metagegevens voor uitvoering execution-metadata

AVAILABILITY
Deze mogelijkheid is in Beperkte Beschikbaarheid. Neem contact op met uw Adobe-vertegenwoordiger voor toegang.

Gebruik executionMetadata om aangepaste sleutel-waardeparen dynamisch vast te leggen en op te slaan in de context van de berichtuitvoering.

Met deze functie kunt u contextafhankelijke informatie toevoegen aan elke native actie van uw campagnes of reizen. Gebruik dit programma om contextuele gegevens voor levering in real time naar externe systemen te exporteren voor verschillende doeleinden, zoals reeksspatiëring, analyse, personalisatie en downstreamverwerking.

NOTE
Aangepaste acties ondersteunen de functie executionMetadata niet.

U kunt bijvoorbeeld de hulpfunctie executionMetadata gebruiken om een specifieke id toe te voegen aan elke levering die naar elk profiel wordt verzonden. Deze informatie wordt tijdens runtime gegenereerd en de verrijkte metagegevens voor uitvoering kunnen vervolgens worden geëxporteerd voor afstemming op een extern rapportageplatform.

Syntaxis
code language-none
{{executionMetadata key="your_key" value="your_value"}}

In deze syntaxis verwijst key naar de naam van de metagegevens en is value de metagegevens die moeten worden voortgezet.

hoe het werkt

Selecteer een element uit de inhoud van uw kanaal in een campagne of een rit en voeg, met de personalisatie-editor, de executionMetadata -hulplijn toe aan dit element.

note
NOTE
De functie executionMetadata is niet zichtbaar wanneer de inhoud zelf wordt weergegeven.

Tijdens runtime wordt de metagegevenswaarde toegevoegd aan de bestaande Message Feedback Event Dataset met het volgende schema:

code language-none
"_experience": {
  "customerJourneyManagement": {
    "messageExecution": {
      "metadata": {
        "your_key": "your_value"
      }
    }
  }
}
note important
IMPORTANT
Er is een bovengrens van 2kb op de belangrijkste waardeparen per actie. Als de limiet van 2 kB wordt overschreden, wordt het bericht nog steeds geleverd, maar een van de sleutelwaardeparen kan worden afgekapt.

Voorbeeld

code language-none
{{executionMetadata key="firstName" value=profile.person.name.firstName}}

In dit voorbeeld, uitgaande van profile.person.name.firstName = “Alex”, is de resulterende entiteit:

code language-none
{
  "key": "firstName",
  "value": "Alex"
}

Toewijzingsfuncties maps

Gebruik kaartfuncties in personalisatie om interactie met kaarten eenvoudiger te maken.

get get

Gebruik de functie get om de waarde van een kaart voor een bepaalde sleutel op te halen.

Syntaxis
code language-sql
{%= get(map, string) %}

Voorbeeld

Met de volgende bewerking wordt de waarde van de identiteitskaart voor de sleutel example@example.com opgehaald.

code language-sql
{%= get(identityMap,"example@example.com") %}

toetsen keys

Gebruik de functie keys om alle sleutels voor een bepaalde kaart terug te winnen.

Syntaxis
code language-sql
{%= keys(map) %}

Voorbeeld

Met de volgende bewerking worden alle toetsen voor de kaart identityMap opgehaald.

code language-sql
{%= keys(identityMap) %}

waarden values

De functie values wordt gebruikt om alle waarden van een bepaalde kaart op te halen.

Syntaxis
code language-sql
{%= values(map) %}

Voorbeeld

Met de volgende bewerking worden alle waarden voor de kaart identityMap opgehaald.

code language-sql
{%= values(identityMap) %}

Math-functies math

Leer hoe te om functies Math in de verpersoonlijkingsredacteur te gebruiken.

absoluut absolute

Gebruik de functie absolute om een getal om te zetten in de absolute waarde ervan.

Syntaxis
code language-sql
{%= absolute(int) %}: int

formatNumber format-number

Gebruik de functie formatNumber om een willekeurig nummer op te maken in de taalgevoelige representatie.

Het accepteert een getal en een tekenreeks die de landinstelling vertegenwoordigen en retourneert een opgemaakte tekenreeks van het getal in de gewenste landinstelling.

Syntaxis
code language-sql
{%= formatNumber(number/double,string) %}: string

U kunt het formatteren en geldige scènes gebruiken zoals samengevat in de ​ documentatie van Oracle ​ en ​ Gesteunde scènes ​{_blank}

Voorbeeld

Deze query retourneert een opgemaakte tekenreeks in het Arabisch die overeenkomt met 123456,789 als het invoernummer.

code language-sql
{%= formatNumber(123456.789, "ar_EG") %}

willekeurig random

Gebruik de functie random om een willekeurige waarde tussen 0 en 1 te retourneren.

Syntaxis
code language-sql
{%= random() %}: double

roundDown round-down

Gebruik de functie roundDown om een getal omlaag te afronden.

Syntaxis
code language-sql
{%= roundDown(double) %}: double

roundUp round-up

Gebruik de functie roundUp om een getal naar boven te afronden.

Syntaxis
code language-sql
{%= roundUp(double) %}: double

toHexString to-hex-string

De functie toHexString zet om het even welk aantal in zijn hexadecimale koord om.

Syntaxis
code language-sql
{%= toHexString(number) %}: string

Voorbeeld

Deze query retourneert de hexadecimale waarde 158 als 9e.

code language-sql
{%= toHexString(158) %}

toInt to-int

Gebruik de functie toInt om typen (getal, dubbel, geheel, lang, zwevend, kort, byte, boolean, tekenreeks) om te zetten in een geheel getal.

Syntaxis
code language-sql
{%= toInt(<valueToConvert>) %}: integer

Voorbeeld

Deze vraag keert de geheelwaarde van 42.6 als 42 terug.

code language-sql
{%= toInt(42.6) %}: integer

toPercentage to-percentage

Gebruik de functie toPercentage om een getal om te zetten in een percentage.

Syntaxis
code language-sql
{%= toPercentage(double) %}: string

toPrecision to-precision

Gebruik de functie toPrecision om een getal om te zetten in de vereiste precisie.

Syntaxis
code language-sql
{%= toPrecision(double,int) %}: string

toString to-string

De functie toString zet een willekeurig getal om in de tekenreeksrepresentatie.

Syntaxis
code language-sql
{%= toString(string) %}: string

Voorbeeld

Deze query retourneert "12" .

code language-sql
{%= toString(12) %}

Objectfuncties objects

Objectfuncties om objecteigenschappen of -kenmerken te controleren.

isNull isNull

De functie isNull bepaalt of een objectverwijzing niet bestaat.

Syntaxis
code language-sql
{%= isNull(object) %}

Voorbeeld

De volgende verrichting controleert als het huisadres van de persoon niet bestaat.

code language-sql
{%= isNull(person.homeAddress) %}

isNotNull isNotNull

De functie isNotNull bepaalt of een objectverwijzing bestaat.

Syntaxis
code language-sql
{%= isNotNull(object) %}

Voorbeeld

De volgende verrichting controleert als het huisadres van de persoon bestaat.

code language-sql
{%= isNotNull(person.homeAddress) %}

Reeksfuncties string-functions

Leer hoe te om de functies van het Koord in de verpersoonlijkingsredacteur te gebruiken.

camelCase camelCase

De functie camelCase maakt een hoofdletter van de eerste letter van elk woord van een tekenreeks.

Syntaxis
code language-sql
{%= camelCase(string)%}

Voorbeeld

Met de volgende functie krijgt de eerste letter van een woord een hoofdletter in het hoofdletteradres van het profiel.

code language-sql
{%= camelCase(profile.homeAddress.street) %}

charCodeAt char-code-at

De functie charCodeAt retourneert de ASCII-waarde van een teken, net als de functie charCodeAt in JavaScript. Er wordt een tekenreeks en een geheel getal gebruikt (de positie van een teken wordt gedefinieerd) als invoerargumenten en de bijbehorende ASCII-waarde wordt geretourneerd.

Syntaxis
code language-sql
{%= charCodeAt(string,int) %}: int

Voorbeeld

De volgende functie retourneert de ASCII-waarde o (111).

code language-sql
{%= charCodeAt("some", 1)%}

concat concate

De functie concat combineert twee tekenreeksen in één.

Syntaxis
code language-sql
{%= concat(string,string) %}

Voorbeeld

De volgende functie combineert profielstad en land in één enkele koord.

code language-sql
{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

contains contains

Gebruik de functie contains om te bepalen of een tekenreeks een opgegeven subtekenreeks bevat.

Syntaxis
code language-sql
{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
STRING_1 De tekenreeks die de controle moet uitvoeren.
STRING_2 De tekenreeks waarnaar moet worden gezocht binnen de eerste tekenreeks.
CASE_SENSITIVE Een optionele parameter om te bepalen of de controle hoofdlettergevoelig is. Mogelijke waarden: true (standaard) / false.

Voorbeelden

  • De volgende functie controleert of de voornaam van het profiel de letter A bevat (in hoofdletters of kleine letters). Als het profiel dat wel doet, wordt true geretourneerd. Zo niet, dan wordt false geretourneerd.

    code language-sql
    {%= contains(profile.person.name.firstName, "A", false) %}
    
  • De volgende query bepaalt, met hoofdlettergevoeligheid, of het e-mailadres van de persoon de tekenreeks 2010@gm bevat.

    code language-sql
    {%= contains(profile.person.emailAddress,"2010@gm") %}
    

doesNotContain doesNotContain

Gebruik de functie doesNotContain om te bepalen of een tekenreeks geen opgegeven subtekenreeks bevat.

Syntaxis
code language-sql
{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
STRING_1 De tekenreeks die de controle moet uitvoeren.
STRING_2 De tekenreeks waarnaar moet worden gezocht binnen de eerste tekenreeks.
CASE_SENSITIVE Een optionele parameter om te bepalen of de controle hoofdlettergevoelig is. Mogelijke waarden: true (standaard) / false.

Voorbeeld

De volgende query bepaalt, met hoofdlettergevoeligheid, of het e-mailadres van de persoon de tekenreeks 2010@gm niet bevat.

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

doesNotEndWith doesNotEndWith

Gebruik de functie doesNotEndWith om te bepalen of een tekenreeks niet eindigt met een opgegeven subtekenreeks.

Syntaxis
code language-sql
{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks waarnaar moet worden gezocht binnen de eerste tekenreeks.
{CASE_SENSITIVE} Een optionele parameter om te bepalen of de controle hoofdlettergevoelig is. Mogelijke waarden: true (standaard) / false.

Voorbeeld

De volgende query bepaalt, met hoofdlettergevoeligheid, of het e-mailadres van de persoon niet eindigt met .com.

code language-sql
doesNotEndWith(person.emailAddress,".com")

doesNotStartWith doesNotStartWith

Gebruik de functie doesNotStartWith om te bepalen of een tekenreeks niet begint met een opgegeven subtekenreeks.

Syntaxis
code language-sql
{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks waarnaar moet worden gezocht binnen de eerste tekenreeks.
{CASE_SENSITIVE} Een optionele parameter om te bepalen of de controle hoofdlettergevoelig is. Mogelijke waarden: true (standaard) / false.

Voorbeeld

De volgende query bepaalt, met hoofdlettergevoeligheid, of de naam van de persoon niet begint met Joe.

code language-sql
{%= doesNotStartWith(person.name,"Joe")%}

encode64 encode64

Gebruik de functie encode64 om een tekenreeks te coderen zodat Personal Information (PI) behouden blijft, bijvoorbeeld om in een URL te worden opgenomen.

Syntaxis
code language-sql
{%= encode64(string) %}

endWith endsWith

Gebruik de functie endsWith om te bepalen of een tekenreeks eindigt met een opgegeven subtekenreeks.

Syntaxis
code language-sql
{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks waarnaar moet worden gezocht binnen de eerste tekenreeks.
{CASE_SENSITIVE} Een optionele parameter om te bepalen of de controle hoofdlettergevoelig is. Mogelijke waarden: true (standaard) / false.

Voorbeeld

De volgende query bepaalt, met hoofdlettergevoeligheid, of het e-mailadres van de persoon eindigt met .com.

code language-sql
{%= endsWith(person.emailAddress,".com") %}

equals equals

Gebruik de functie equals om te bepalen of een tekenreeks gelijk is aan de opgegeven tekenreeks, met hoofdlettergevoeligheid.

Syntaxis
code language-sql
{%= equals(STRING_1, STRING_2) %}
table 0-row-2 1-row-2 2-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks die met de eerste tekenreeks moet worden vergeleken.

Voorbeeld

De volgende query bepaalt, met hoofdlettergevoeligheid, of de naam van de persoon John is.

code language-sql
{%=equals(profile.person.name,"John") %}

equalsIgnoreCase equalsIgnoreCase

Gebruik de functie equalsIgnoreCase om te bepalen of een tekenreeks gelijk is aan de opgegeven tekenreeks, zonder hoofdlettergevoeligheid.

Syntaxis
code language-sql
{%= equalsIgnoreCase(STRING_1, STRING_2) %}
table 0-row-2 1-row-2 2-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks die met de eerste tekenreeks moet worden vergeleken.

Voorbeeld

De volgende query bepaalt, zonder hoofdlettergevoeligheid, of de naam van de persoon John is.

code language-sql
{%= equalsIgnoreCase(profile.person.name,"John") %}

extractEmailDomain extractEmailDomain

Gebruik de functie extractEmailDomain om het domein van een e-mailadres te extraheren.

Syntaxis
code language-sql
{%= extractEmailDomain(string) %}

Voorbeeld

De volgende query extraheert het e-maildomein van het persoonlijke e-mailadres.

code language-sql
{%= extractEmailDomain(profile.personalEmail.address) %}

formatCurrency format-currency

Gebruik de functie formatCurrency om een willekeurig getal om te zetten in de corresponderende taalgevoelige valutarepresentatie, afhankelijk van de landinstelling die als een tekenreeks in het tweede argument is doorgegeven.

Syntaxis
code language-sql
{%= formatCurrency(number/double,string) %}: string

Voorbeeld

Deze query retourneert £ 56,00

code language-sql
{%= formatCurrency(56L,"en_GB") %}

getUrlHost get-url-host

Gebruik de functie getUrlHost om de hostnaam van een URL op te halen.

Syntaxis
code language-sql
{%= getUrlHost(string) %}: string

Voorbeeld

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

Retourneert “www.myurl.com”

getUrlPath get-url-path

Gebruik de functie getUrlPath om het pad na de domeinnaam van een URL op te halen.

Syntaxis
code language-sql
{%= getUrlPath(string) %}: string

Voorbeeld

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

Retourneert “/contact.html”

getUrlProtocol get-url-protocol

Gebruik de functie getUrlProtocol om het protocol van een URL op te halen.

Syntaxis
code language-sql
{%= getUrlProtocol(string) %}: string

Voorbeeld

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

Retourneert “http”

indexOf index-of

Gebruik de functie indexOf om de positie (in het eerste argument) van de eerste instantie van de tweede parameter te retourneren. Retourneert -1 als er geen overeenkomend actiepunt is.

Syntaxis
code language-sql
{%= indexOf(STRING_1, STRING_2) %}: integer
table 0-row-2 1-row-2 2-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks die moet worden gezocht in de eerste parameter

Voorbeeld

code language-sql
{%= indexOf("hello world","world" ) %}

Retourneert 6.

isEmpty isEmpty

Gebruik de functie isEmpty om te bepalen of een tekenreeks leeg is.

Syntaxis
code language-sql
{%= isEmpty(string) %}

Voorbeeld

De volgende functie retourneert ‘true’ als het mobiele telefoonnummer van het profiel leeg is. Anders wordt false geretourneerd.

code language-sql
{%= isEmpty(profile.mobilePhone.number) %}

isNotEmpty is-not-empty

Gebruik de functie isNotEmpty om te bepalen of een tekenreeks niet leeg is.

Syntaxis
code language-sql
{= isNotEmpty(string) %}: boolean

Voorbeeld

De volgende functie retourneert ‘true’ als het mobiele telefoonnummer van het profiel niet leeg is. Anders wordt false geretourneerd.

code language-sql
{%= isNotEmpty(profile.mobilePhone.number) %}

lastIndexOf last-index-of

Gebruik de functie lastIndexOf om de positie (in het eerste argument) van de laatste instantie van de tweede parameter te retourneren. Retourneert -1 als er geen overeenkomend actiepunt is.

Syntaxis
code language-sql
{= lastIndexOf(STRING_1, STRING_2) %}: integer
table 0-row-2 1-row-2 2-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks die moet worden gezocht in de eerste parameter

Voorbeeld

code language-sql
{%= lastIndexOf("hello world","o" ) %}

Retourneert 7.

leftTrim leftTrim

Gebruik de functie leftTrim om witruimten te verwijderen uit het begin van een tekenreeks.

Syntaxis
code language-sql
{%= leftTrim(string) %}

length length

Gebruik de functie length om het aantal tekens in een tekenreeks of expressie op te halen.

Syntaxis
code language-sql
{%= length(string) %}

Voorbeeld

De volgende functie retourneert de lengte van de stadsnaam van het profiel.

code language-sql
{%= length(profile.homeAddress.city) %}

leuk like

Gebruik de functie like om te bepalen of een tekenreeks overeenkomt met een opgegeven patroon.

Syntaxis
code language-sql
{%= like(STRING_1, STRING_2) %}
table 0-row-2 1-row-2 2-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2}

De expressie die moet overeenkomen met de eerste tekenreeks. Er zijn twee ondersteunde speciale tekens voor het maken van een expressie: % en _ .

  • % wordt gebruikt om nul of meer tekens te vertegenwoordigen.
  • _ wordt gebruikt om precies één teken te vertegenwoordigen.

Voorbeeld

Met de volgende query worden alle steden opgehaald waar profielen met het patroon es in de live map staan.

code language-sql
{%= like(profile.homeAddress.city, "%es%")%}

lowerCase lower

Gebruik de functie lowerCase om een tekenreeks om te zetten in kleine letters.

Syntaxis
code language-sql
{%= lowerCase(string) %}

Voorbeeld

Deze functie converteert de voornaam van het profiel naar kleine letters.

code language-sql
{%= lowerCase(profile.person.name.firstName) %}

overeenkomsten matches

Gebruik de functie matches om te bepalen of een tekenreeks overeenkomt met een specifieke reguliere expressie. Voor meer informatie over passende patronen in regelmatige uitdrukkingen, verwijs naar ​ de documentatie van Oracle ​.

Syntaxis
code language-sql
{%= matches(STRING_1, STRING_2) %}

Voorbeeld

De volgende query bepaalt, zonder hoofdlettergevoeligheid, of de naam van de persoon begint met John.

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

masker mask

Gebruik de functie mask om een deel van een tekenreeks te vervangen door ‘X’-tekens.

Syntaxis
code language-sql
{%= mask(string,integer,integer) %}

Voorbeeld

De volgende query vervangt de tekenreeks “123456789” door “X”, behalve voor het eerste en laatste 2 tekens.

code language-sql
{%= mask("123456789",1,2) %}

De query retourneert 1XXXXXX89 .

md5 md5

Gebruik de functie md5 om de md5-hash van een tekenreeks te berekenen en te retourneren.

Syntaxis
code language-sql
{%= md5(string) %}: string

Voorbeeld

code language-sql
{%= md5("hello world") %}

Retourneert “5eb63be01eeed093cb22bb8f5acdc3”

notEqualTo notEqualTo

Gebruik de functie notEqualTo om te bepalen of een tekenreeks niet gelijk is aan de opgegeven tekenreeks.

Syntaxis
code language-sql
{%= notEqualTo(STRING_1, STRING_2) %}
table 0-row-2 1-row-2 2-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks die met de eerste tekenreeks moet worden vergeleken.

Voorbeeld

De volgende query bepaalt, met hoofdlettergevoeligheid, of de naam van de persoon niet John is.

code language-sql
{%= notEqualTo(profile.person.name,"John") %}

notEqualWithIgnoreCase not-equal-with-ignore-case

Gebruik de functie notEqualWithIgnoreCase om twee tekenreeksen te vergelijken waarbij hoofdletters en kleine letters worden genegeerd.

Syntaxis
code language-sql
{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
table 0-row-2 1-row-2 2-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks die met de eerste tekenreeks moet worden vergeleken.

Voorbeeld

De volgende query bepaalt of de naam van de persoon niet john is, zonder hoofdlettergevoeligheid.

code language-sql
{%= notEqualTo(profile.person.name,"john") %}

regexGroup regexGroup

Gebruik de functie regexGroup om specifieke informatie te extraheren op basis van de reguliere expressie die wordt opgegeven.

Syntaxis
code language-sql
{%= regexGroup(STRING, EXPRESSION, GROUP) %}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
{STRING} De tekenreeks die de controle moet uitvoeren.
{EXPRESSION} De reguliere expressie die moet overeenkomen met de eerste tekenreeks.
{GROUP} Expressiegroep die moet worden gebruikt.

Voorbeeld

De volgende query extraheert de domeinnaam uit een e-mailadres.

code language-sql
{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

vervangen replace

Gebruik de functie replace om een bepaalde subtekenreeks in een tekenreeks te vervangen door een andere subtekenreeks.

Syntaxis
code language-sql
{%= replace(STRING_1,STRING_2,STRING_3) %}:string
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
{STRING_1} De tekenreeks waar de subtekenreeks moet worden vervangen.
{STRING_2} The substring to replace.
{STRING_3} De vervangende subtekenreeks.

Voorbeeld

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

Retourneert Hello Mark, here is your monthly newsletter!

replaceAll replaceAll

Gebruik de functie replaceAll om alle subtekenreeksen van een tekst te vervangen die overeenkomt met de expressie regex met de opgegeven letterlijke vervangende tekenreeks. Regex hanteert speciale functies voor \ en + en alle regex-expressies volgen de PQL escapstrategie. De vervanging vindt plaats vanaf het begin van de tekenreeks tot het einde, bijvoorbeeld wanneer aa wordt vervangen door b in de tekenreeks aaa , resulteert in ba in plaats van ab .

Syntaxis
code language-sql
{%= replaceAll(string,string,string) %}
note
NOTE
Wanneer de uitdrukking die als tweede argument wordt genomen een speciaal regex karakter is, gebruik dubbele backslash (//). Speciale regex-tekens zijn: [., +, *, ?, ^, $, (, ), [, ], {, }, |, .]
Leer meer in ​ documentatie van Oracle ​.

rightTrim rightTrim

De functie rightTrim verwijdert witruimten van het einde van een tekenreeks.

Syntaxis
code language-sql
{%= rightTrim(string) %}

sha256 sha256

De functie sha256 berekent en retourneert de sha256-hash van een tekenreeks.

Syntaxis
code language-sql
{%= sha256(string) %} : string

Voorbeeld

code language-sql
{%= sha256("Eliechxh")%}

Retourneert 0b0b207880b999adaad6231026abf87caa30760b6f326b21727b61139332257d

splitsen split

Gebruik de functie split om een tekenreeks te splitsen op een bepaald teken.

Syntaxis
code language-sql
{%= split(string,string) %}

startWith startsWith

Gebruik de functie startsWith om te bepalen of een tekenreeks begint met een opgegeven subtekenreeks.

Syntaxis
code language-sql
{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
table 0-row-2 1-row-2 2-row-2 3-row-2
Argument Beschrijving
{STRING_1} De tekenreeks die de controle moet uitvoeren.
{STRING_2} De tekenreeks waarnaar moet worden gezocht binnen de eerste tekenreeks.
{CASE_SENSITIVE} Een optionele parameter om te bepalen of de controle hoofdlettergevoelig is. De standaardwaarde is true.

Voorbeeld

De volgende query bepaalt, met hoofdlettergevoeligheid, of de naam van de persoon begint met Joe.

code language-sql
{%= startsWith(person.name,"Joe") %}

stringToDate string-to-date

De functie stringToDate zet een tekenreekswaarde om in een datum-tijdwaarde. Er zijn twee argumenten: tekenreeksrepresentatie van een datum- en tekenreeksrepresentatie van de formatter.

Syntaxis
code language-sql
{= stringToDate("date-time value","formatter" %}

Voorbeeld

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

string_to_integer string-to-integer

Gebruik de functie string_to_integer om een tekenreekswaarde om te zetten in een geheel-getalwaarde.

Syntaxis
code language-sql
{= string_to_integer(string) %}: int

stringToNumber string-to-number

Gebruik de functie stringToNumber om een tekenreeks om te zetten in een getal. Deze geeft dezelfde tekenreeks als uitvoer voor ongeldige invoer.

Syntaxis
code language-sql
{%= stringToNumber(string) %}: double

substr sub-string

Gebruik de functie substr om de subtekenreeks van de tekenreeksexpressie tussen de beginindex en de eindindex te retourneren.

Syntaxis
code language-sql
{= substr(string, integer, integer) %}: string

titleCase titleCase

Gebruik de functie titleCase om eerste letters van elk woord van een tekenreeks met hoofdletters te maken.

Syntaxis
code language-sql
{%= titleCase(string) %}

Voorbeeld

Als de persoon in Washington high street woont, retourneert deze functie Washington High Street .

code language-sql
{%= titleCase(profile.person.location.Street) %}

toBool to-bool

Gebruik de functie toBool om een argumentwaarde in een booleaanse waarde om te zetten, afhankelijk van het type.

Syntaxis
code language-sql
{= toBool(string) %}: boolean

toDateTime to-date-time

Gebruik de functie toDateTime om een tekenreeks om te zetten in een datum. De epochdatum wordt geretourneerd als uitvoer voor ongeldige invoer.

Syntaxis
code language-sql
{%= toDateTime(string, string) %}: date-time

toDateTimeOnly to-date-time-only

Gebruik de functie toDateTimeOnly om een argumentwaarde om te zetten in een waarde met alleen de datumtijd. De epochdatum wordt geretourneerd als uitvoer voor ongeldige invoer. Deze functie accepteert veldtypen tekenreeks, datum, lang en geheel getal.

Syntaxis
code language-sql
{%= toDateTimeOnly(string/date/long/int) %}: date-time

bijsnijden trim

De functie trim verwijdert alle witruimten vanaf het begin en aan het einde van een tekenreeks.

Syntaxis
code language-sql
{%= trim(string) %}

upperCase upper

De functie upperCase zet een tekenreeks om in hoofdletters.

Syntaxis
code language-sql
{%= upperCase(string) %}

Voorbeeld

Deze functie converteert de achternaam van het profiel naar hoofdletters.

code language-sql
{%= upperCase(profile.person.name.lastName) %}

urlDecode url-decode

Gebruik de functie urlDecode om een URL-gecodeerde tekenreeks te decoderen.

Syntaxis
code language-sql
{%= urlDecode(string) %}: string

urlEncode url-encode

Gebruik de functie urlEncode om een tekenreeks als een URL te coderen.

Syntaxis
code language-sql
{%= urlEncode(string) %}: string
recommendation-more-help
journey-optimizer-b2b-help-user