ヘルパー関数

パーソナライゼーションエディター内のヘルパー関数を使用して、データの操作、計算の実行、コンテンツの書式設定により、パーソナライズされたコンテンツエクスペリエンスを正確かつ効率的に定義します。 これらの機能、オペレーター、ヘルパーを調べて実験し、連携してカスタマイズされたデータ駆動型ジャーニーを作成する方法を見つけます。

集計関数

集計関数を使用して、複数の値をグループ化し、単一の要約値を形成します。 また、配列関数とリスト関数を使用すると、配列、リストおよび文字列とのインタラクションを定義しやすくなります。

平均 average

配列内の選択された値すべての算術平均を返すには、average 関数を使用します。

{%= average(array) %}

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

count count

指定された配列内の要素数を返すには、count 関数を使用します。

{%= count(array) %}

{%= count(orders) %}

max max

配列内の選択された値すべての最大値を返すには、max 関数を使用します。

{%= max(array) %}

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

min min

配列内の選択された値すべての最小値を返すには、min 関数を使用します。

{%= min(array) %}

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

sum sum

配列内の選択された値すべての合計を返すには、sum 関数を使用します。

{%= sum(array) %}

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

演算関数 maths

演算関数を使用して、値に対する基本的な計算を実行します。

add add

2 つの引数式の合計を求めるには、+ （加算）関数を使用します。

{%= double + double %}

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

multiple multiply

2 つの引数式の積を求めるには、* （乗算）関数を使用します。

{%= double * double %}

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

減算 substract

2 つの引数式の差を求めるには、- （減算）関数を使用します。

{%= double - double %}

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

除算 divide

2 つの引数式の商を求めるには、/ （除算）関数を使用します。

{%= double / double %}

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

remainder remainder

2 つの引数式を除算した後の剰余を求めるには、% （remainder）関数を使用します。

{%= double % double %}

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

配列およびリスト関数 arrays

これらの関数を使用すると、配列、リスト、および文字列の操作が容易になります。

countOnlyNull count-only-null

countOnlyNull 関数を使用すると、リスト内の null 値の数をカウントできます。

{%= countOnlyNull(array) %}

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

countWithNull count-with-null

countWithNull 関数を使用すると、null 値を含むリストのすべての要素をカウントできます。

{%= countWithNull(array) %}

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

distinct distinct

distinct 関数を使用して、重複値を削除して配列またはリストから値を取得します。

{%= distinct(array) %}

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

distinctCountWithNull distinct-count-with-null

distinctCountWithNull 関数を使用すると、null 値を含むリスト内の異なる値の数をカウントできます。

{%= distinctCountWithNull(array) %}

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

ヘッド head

配列またはリスト内の最初の項目を返すには、head 関数を使用します。

{%= head(array) %}

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

topN first-n

topN 関数は、指定された数式に基づいて配列を降順に並べ替え、最初の N 項目を返します。 配列のサイズが N 未満の場合は、並べ替えられた配列全体を返します。

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

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

in in

項目が配列またはリストのメンバーであるかどうかを判断するには、in 関数を使用します。

{%= in(value, array) %}

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

includes includes

配列またはリストに指定した項目が含まれているかどうかを確認するには、includes 関数を使用します。

{%= includes(array,item) %}

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

交わり intersects

intersects 関数は、2つの配列またはリストに、共通メンバーが 1 つ以上あるかどうかを判断するために使用されます。

{%= intersects(array1, array2) %}

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

bottomN last-n

bottomN 関数は、指定された数式に基づいて配列を昇順に並べ替え、最初の N 項目を返します。 配列のサイズが N 未満の場合は、並べ替えられた配列全体を返します。

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

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

notIn notin

項目が配列またはリストのメンバーでないかどうかを判断するには、notIn 関数を使用します。

{%= notIn(value, array) %}

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

subsetOf subset

特定の配列（配列 A）が別の配列（配列 B）のサブセットであるかどうかを判断するには、subsetOf 関数を使用します。 つまり、配列 A 内のすべての要素が配列 B の要素であるということです。

{%= subsetOf(array1, array2) %}

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

スーパーセットの superset

特定の配列（配列 A）が別の配列（配列 B）のスーパーセットであるかどうかを判断するには、supersetOf 関数を使用します。 つまり、その配列 Aには配列 B のすべての要素が含まれます。

{%= supersetOf(array1, array2) %}

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

日付および時間関数 date-time

日付と時刻の関数を使用すると、値に対して日付と時刻の操作を実行できます。

addDays add-days

addDays 関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された日数で調整します。

{%= addDays(date, number) %}

addHours add-hours

addHours 関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された時間数で調整します。

{%= addHours(date, number) %}

addMinutes add-minutes

addMinutes 関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された分数で調整します。

{%= addMinutes(date, number) %}

addMonths add-months

addMonths 関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された月数で調整します。

{%= addMonths(date, number) %}

addSeconds add-seconds

addSeconds 関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された秒数で調整します。

{%= addSeconds(date, number) %}

addYeers add-years

addYears 関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された年数で調整します。

{%= addYears(date, number) %}

年齢 age

age 関数を使用して、指定された日付からの経過時間を取得します。

 {%= age(datetime) %}

ageInDay age-days

ageInDays 関数は、指定された日付から現在の日付までの経過日数を計算します。 将来の日付には負の値を使用し、過去の日付には正の値を使用します。

{%= ageInDays(date) %}

ageInMonth age-months

ageInMonths 関数は、指定された日付から現在の日付までの経過月数を計算します。 将来の日付には負の値を使用し、過去の日付には正の値を使用します。

{%= ageInMonths(date) %}

compareDates compare-dates

compareDates 関数は、最初の入力日付を他の入力日付と比較します。date1 が date2 と等しい場合は 0、date1 が date2 より前の場合は–1、date1 が date2 より後の場合は 1 が返されます。

{%= compareDates(date1, date2) %}

convertZonedDateTime convert-zoned-date-time

convertZonedDateTime 関数は、日時を指定されたタイムゾーンに変換します。

{%= convertZonedDateTime(dateTime, timezone) %}

currentTimeInMillis current-time

currentTimeInMillis 関数を使用して、現在の時刻をエポックミリ秒単位で取得します。

{%= currentTimeInMillis() %}

dateDiff date-diff

dateDiff 関数を使用すると、2 つの日付間の差異を日数単位で取得できます。

{%= dateDiff(datetime,datetime) %}

dayOfMonth day-month

dayOfMonth は、その月の日付を表す数値を返します。

{%= dayOfMonth(datetime) %}

曜日 day-week

dayOfWeek 関数を使用して曜日を取得します。

{%= dayOfWeek(datetime) %}

dayOyear day-year

dayOfYear 関数を使用して通日（1 月 1 日からの通算日数）を取得します。

{%= dayOfYear(datetime) %}

diffInSeconds diff-seconds

diffInSeconds 関数は、秒数単位で 2 つの日付間の差異を返します。

{%= diffInSeconds(endDate, startDate) %}

extractHours extract-hours

extractHours 関数は、指定されたタイムスタンプから時間コンポーネントを抽出します。

{%= extractHours(date) %}

extractMinutes extract-minutes

extractMinutes 関数は、指定されたタイムスタンプから分コンポーネントを抽出します。

{%= extractMinutes(date) %}

extractMonths extract-months

extractMonth 関数は、指定されたタイムスタンプから月コンポーネントを抽出します。

{%= extractMonths(date) %}

extractSeconds extract-seconds

extractSeconds 関数は、指定されたタイムスタンプから秒コンポーネントを抽出します。

{%= extractSeconds(date) %}

formatDate format-date

formatDate 関数を使用して、日時値を書式設定します。 形式は、有効な Java DateTimeFormat パターンである必要があります。

{%= formatDate(datetime, format) %}

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

パターン文字 pattern-characters

一部のパターン文字は似ているように見えるかもしれませんが、異なる概念を表しています。

日付をロケールサポートの形式にする format-date-locale

formatDate 関数を使用すると、目的のロケールなど、日付と時刻の値を対応する言語に依存する表現にフォーマットできます。 形式は、有効な Java DateTimeFormat パターンである必要があります。

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

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

getCurrentZonedDateTime get-current-zoned-date-time

getCurrentZonedDateTime 関数は、タイムゾーン情報を含む現在の日時を返します。

{%= getCurrentZonedDateTime() %}

diffInHour hours-difference

diffInHours 関数は、時間数単位で 2 つの日付間の差異を返します。

{%= diffInHours(endDate, startDate) %}

diffInMinute diff-minutes

diffInMinutes 関数は、2 つの日付間の差異を分単位で返します。

{%= diffInMinutes(endDate, startDate) %}

diffInMonths months-difference

diffInMonths 関数は、月数単位で 2 つの日付間の差異を返します

{%= diffInMonths(endDate, startDate) %}

setDays set-days

setDays 関数を使用して、指定された日時の日付を設定します。

{%= setDays(datetime, day) %}

setHours set-hours

setHours 関数を使用して日時の時を設定します。

{%= setHours(datetime, hour) %}

toDateTime string-to-date-time

toDateTime 関数は、文字列を日付に変換します。無効な入力に対する出力として、エポック日付を返します。

{%= toDateTime(string, string) %}

toUtc to-utc

toUTC 関数を使用して日時を UTC に変換します。

{%= toUTC(datetime) %}

truncateToStartOfDay truncate-day

truncateToStartOfDay 関数を使用して、指定された日時を、時刻 00:00 の日の始めに設定して変更します。

{%= truncateToStartOfDay(date) %}

truncateToStartOfQuarter truncate-quarter

truncateToStartOfQuarter 関数を使用すると、日時を四半期の最初の日（1 月 1 日、4 月 1 日、7 月 1 日、10 月 1 日など） :0000 に切り捨てることができます。

{%= truncateToStartOfQuarter(dateTime) %}

truncateToStartOfWeek truncate-week

truncateToStartOfWeek 関数は、指定された日時を週の初め（月曜日の 00:00）に設定して変更します。

{%= truncateToStartOfWeek(dateTime) %}

truncateToStartOfYear truncate-year

truncateToStartOfYear 関数を使用すると、指定された日時を年の最初の日（1 月 1 日）の 00:00 に切り捨てて変更できます。

{%= truncateToStartOfYear(dateTime) %}

週間/年 week-of-year

weekOfYear 関数を使用して、年の週番号（何週目か）を取得します。

{%= weekOfYear(datetime) %}

diffInYears diff-years

2 つの日付間の年単位の差異を返すには、diffInYears 関数を使用します。

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

演算子関数 operators

ブール関数と比較関数を使用して、論理評価を実行します。

and and

and 関数は、論理積を作成するために使用されます。

{%= query1 and query2 %}

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

または or

or 関数は、論理和を作成するために使用されます。

{%= query1 or query2 %}

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

等しい operator-equals

=（次に等しい）関数は、ある値または式が別の値または式と等しいかどうかを確認します。

{%= expression = value %}

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

次と等しくない notequal

!=（次と等しくない）関数は、ある値または式が別の値または式と等しく​ ない ​かどうかを確認します。

{%= expression != value %}

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

指定の値より大きい greaterthan

> （次より大きい）関数を使用すると、最初の値が 2 番目の値より大きいかどうかを確認できます。

{%= expression1 > expression2 %}

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

次よりも大きいか等しい greaterthanorequal

>= （同じかそれ以上）関数を使用すると、最初の値が 2 番目の値以上かどうかを確認できます。

{%= expression1 >= expression2 %}

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

指定の値未満 lessthan

< （次より小さい）比較関数を使用すると、最初の値が 2 番目の値より小さいかどうかを確認できます。

{%= expression1 < expression2 %}

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

次よりも小さいか等しい lessthanorequal

<= （同じかそれ以下）比較関数を使用すると、最初の値が 2 番目の値以下かどうかを確認できます。

{%= expression1 <= expression2 %}

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

動的関数 dynamic-helpers

動的ヘルパー関数を使用して、条件付き評価、イテレーション、変数割り当てを動的パーソナライゼーションに使用します。

デフォルトのフォールバック値 default-value

Default Fallback Value ヘルパーは、属性が空または null の場合にデフォルトのフォールバック値を返すために使用されます。このメカニズムは、プロファイル属性とジャーニーイベントで機能します。

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

if （条件） if-function

if ヘルパーを使用して、条件ブロックを定義します。
式の評価結果が true の場合、ブロックはレンダリングされます。true でない場合はスキップされます。

{%#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%}
    }
}

unless unless

unless ヘルパーを使用して、条件ブロックを定義します。 if ヘルパーとは異なり、式の評価結果が false の場合にブロックがレンダリングされます。

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

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

それぞれ each

each ヘルパーを使用して、配列に対して反復処理を行います。

ヘルパー構造は {{#each ArrayName}} YourContent {{/each}} です

ブロック内でキーワード this を使用して、個々の配列項目を参照できます。 {{@index}} を使用して、配列の要素のインデックスをレンダリングします。

{{#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}}

次を使用 with

template-part の評価トークンを変更するには、with ヘルパーを使用します。

{{#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}}

let let

let 関数を使用すると、式を変数として保存し、後からクエリで使用できます。

{% 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}}

実行メタデータ execution-metadata

executionMetadata を使用して、カスタムのキーと値のペアをキャプチャし、メッセージ実行コンテキストに動的に保存します。

この関数を使用すると、キャンペーンやジャーニーの任意のネイティブアクションにコンテキスト情報を追加できます。これを使用すると、トラッキング、分析、パーソナライゼーション、ダウンストリーム処理など、様々な目的でリアルタイム配信のコンテキストデータを外部システムに書き出すことができます。

例えば、executionMetadata ヘルパーを使用して、各プロファイルに送信される各配信に特定の ID を追加できます。 この情報は実行時に生成され、強化された実行メタデータは外部レポートプラットフォームとのダウンストリームの紐付けのためにエクスポートできます。

{{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"
}

マップ関数 maps

パーソナライゼーションでマップ関数を使用すると、マップとのやり取りが容易になります。

get get

get 関数を使用して、指定されたキーのマップの値を取得します。

{%= get(map, string) %}

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

キー keys

keys 関数を使用して、特定のマップのすべてのキーを取得します。

{%= keys(map) %}

{%= keys(identityMap) %}

値 values

values 関数は、特定のマップのすべての値を取得するために使用されます。

{%= values(map) %}

{%= values(identityMap) %}

数学関数 math

パーソナライゼーションエディターで数学関数を使用する方法を説明します。

絶対パス absolute

absolute 関数を使用して、数値をその絶対値に変換します。

{%= absolute(int) %}: int

formatNumber format-number

formatNumber 関数を使用すると、任意の数値を言語依存の表現に書式設定できます。

ロケールを表す数値および文字列を受け入れて、目的のロケールで書式設定された数値の文字列を返します。

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

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

random random

random 関数を使用すると、0 ～ 1 の間のランダムな値を返します。

{%= random() %}: double

roundDown round-down

roundDown 関数を使用すると、数値を切り捨てることができます。

{%= roundDown(double) %}: double

切り上げ round-up

roundUp 関数を使用すると、数値を切り上げることができます。

{%= roundUp(double) %}: double

toHexString to-hex-string

この toHexString 関数は、任意の数を 16 進文字列に変換します。

{%= toHexString(number) %}: string

{%= toHexString(158) %}

toInt to-int

型（number、double、integer、long、float、short、byte、boolean、string）を整数に変換するには、toInt 関数を使用します。

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

{%= toInt(42.6) %}: integer

toPercentage to-percentage

toPercentage 関数を使用して数値をパーセンテージに変換します。

{%= toPercentage(double) %}: string

toPrecision to-precision

toPrecision 関数を使用して、数値を必要な精度に変換します。

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

toString to-string

toString 関数は、任意の数値を文字列表現に変換します。

{%= toString(string) %}: string

{%= toString(12) %}

オブジェクト関数 objects

オブジェクトのプロパティまたは属性を照会するオブジェクト関数。

isNull isNull

isNull 関数は、オブジェクト参照が存在しないかどうかを判定します。

{%= isNull(object) %}

{%= isNull(person.homeAddress) %}

isNotNull isNotNull

isNotNull 関数は、オブジェクト参照が存在するかどうかを判定します。

{%= isNotNull(object) %}

{%= isNotNull(person.homeAddress) %}

文字列関数 string-functions

パーソナライゼーションエディターで文字列関数を使用する方法を説明します。

camelCase camelCase

camelCase 関数は、文字列の各単語の最初の文字を大文字にします。

{%= camelCase(string)%}

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

charCodeAt char-code-at

charCodeAt 関数は、JavaScriptの charCodeAt 関数と同様に、文字の ASCII 値を返します。 文字列と整数（文字の位置を定義する）を入力引数として受け取り、対応する ASCII 値を返します。

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

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

concat concate

concat 関数は、2 つの文字列を 1 つに結合します。

{%= concat(string,string) %}

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

指定の語を含む contains

文字列が指定の部分文字列を含んでいるかどうかを判定するには、contains 関数を使用します。

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

doesNotContain doesNotContain

文字列が指定の部分文字列を含んでいないかどうかを判定するには、doesNotContain 関数を使用します。

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

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

doesNotEndWith doesNotEndWith

文字列の末尾が指定の部分文字列になっていないかどうかを判定するには、doesNotEndWith 関数を使用します。

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

doesNotEndWith(person.emailAddress,".com")

doesNotStartWith doesNotStartWith

文字列の先頭が指定の部分文字列になっていないかどうかを判定するには、doesNotStartWith 関数を使用します。

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

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

encode64 encode64

encode64 関数を使用して、個人情報（PI）を URL に含めるなどの個人情報を保持する文字列をエンコードします。

{%= encode64(string) %}

endsWith endsWith

文字列が指定の部分文字列で終わることを判別するには、endsWith 関数を使用します。

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

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

等しい equals

文字列が指定の文字列に等しいかどうかを判定するには、equals 関数を使用します。

{%= equals(STRING_1, STRING_2) %}

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

equalsIgnoreCase equalsIgnoreCase

大文字と小文字を区別せずに、文字列が指定の文字列に等しいかどうかを判定するには、equalsIgnoreCase 関数を使用します。

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

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

extractEmailDomain extractEmailDomain

extractEmailDomain 関数を使用して、メールアドレスのドメインを抽出します。

{%= extractEmailDomain(string) %}

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

formatCurrency format-currency

formatCurrency 関数を使用すると、2 番目の引数で文字列として渡されたロケールに応じて、任意の数値を対応する言語に依存する通貨表現に変換できます。

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

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

getUrlHost get-url-host

getUrlHost 関数を使用して、URL のホスト名を取得します。

{%= getUrlHost(string) %}: string

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

getUrlPath get-url-path

getUrlPath 関数を使用して、URL のドメイン名の後のパスを取得します。

{%= getUrlPath(string) %}: string

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

getUrlProtocol get-url-protocol

getUrlProtocol 関数を使用して、URL のプロトコルを取得します。

{%= getUrlProtocol(string) %}: string

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

indexOf index-of

indexOf 関数を使用すると、2 番目のパラメーターが最初に現れる（最初の引数内の）位置を返します。 一致するものがない場合は「-1」を返します。

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

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

isEmpty isEmpty

isEmpty 関数を使用すると、文字列が空かどうかを判断できます。

{%= isEmpty(string) %}

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

isNotEmpty is-not-empty

isNotEmpty 関数を使用すると、文字列が空でないかどうかを判定できます。

{= isNotEmpty(string) %}: boolean

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

lastIndexOf last-index-of

lastIndexOf 関数を使用して、2 番目のパラメーターが最後に現れる（最初の引数内の）位置を返します。 一致するものがない場合は「-1」を返します。

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

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

leftTrim leftTrim

文字列の先頭から空白を削除するには、leftTrim 関数を使用します。

{%= leftTrim(string) %}

length length

文字列または式の文字数を取得するには、length 関数を使用します。

{%= length(string) %}

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

like like

文字列が指定のパターンと一致するかどうかを判定するには、like 関数を使用します。

{%= like(STRING_1, STRING_2) %}

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

lowercase lower

文字列を小文字に変換するには、lowerCase 関数を使用します。

{%= lowerCase(string) %}

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

一致する matches

matches 関数を使用すると、文字列が特定の正規表現に一致することを判別できます。 正規表現のマッチングパターンについて詳しくは、Oracleのドキュメント ​ を参照してください。

{%= matches(STRING_1, STRING_2) %}

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

マスク mask

mask 関数を使用すると、文字列の一部を「X」の文字に置き換えることができます。

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

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

md5 md5

md5 関数を使用して、文字列の md5 ハッシュを計算して返します。

{%= md5(string) %}: string

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

notEqualTo notEqualTo

文字列が指定の文字列に等しくないかどうかを判定するには、notEqualTo 関数を使用します。

{%= notEqualTo(STRING_1, STRING_2) %}

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

notEqualWithIgnoreCase not-equal-with-ignore-case

notEqualWithIgnoreCase 関数を使用すると、大文字と小文字を区別せずに、2 つの文字列を比較できます。

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

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

regexGroup regexGroup

regexGroup 関数を使用して、指定された正規表現に基づいて特定の情報を抽出します。

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

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

replace replace

文字列内の特定の部分文字列を別の部分文字列で置き換えるには、replace 関数を使用します。

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

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

replaceAll replaceAll

replaceAll 関数を使用すると、正規表現式に一致するテキストのすべてのサブ文字列を、指定されたリテラル置換文字列に置き換えることができます。 正規表現には \ と + の特別な処理があり、すべての正規表現はPQL エスケープ戦略に従います。 置換は、文字列の先頭から末尾に向かって行われます。例えば、文字列内の aa を b に置き換えると aaa ba ではなく ab になります。

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

rightTrim rightTrim

rightTrim 関数は、文字列の末尾から空白を削除します。

{%= rightTrim(string) %}

sha256 sha256

sha256 関数は、文字列の sha256 ハッシュを計算して返します。

{%= sha256(string) %} : string

{%= sha256("Eliechxh")%}

split split

文字列を特定の文字で分割するには、split 関数を使用します。

{%= split(string,string) %}

startsWith startsWith

startsWith 関数を使用すると、文字列が指定の部分文字列で始まるかどうかを判定できます。

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

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

stringToDate string-to-date

stringToDate 関数は、文字列値を日時値に変換します。 日時の文字列表現とフォーマッターの文字列表現の 2 つの引数を取ります。

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

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

string_to_integer string-to-integer

文字列値を整数値に変換するには、string_to_integer 関数を使用します。

{= string_to_integer(string) %}: int

stringToNumber string-to-number

文字列を数値に変換するには、stringToNumber 関数を使用します。 無効な入力の出力と同じ文字列を返します。

{%= stringToNumber(string) %}: double

substr sub-string

開始インデックスと終了インデックスの間の文字列式の部分文字列を返すには、substr 関数を使用します。

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

titleCase titleCase

titleCase 関数を使用すると、文字列の各単語の最初の文字を大文字にすることができます。

{%= titleCase(string) %}

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

toBool to-bool

toBool 関数を使用して、引数の値を、型に応じてブール値に変換します。

{= toBool(string) %}: boolean

toDateTime to-date-time

toDateTime 関数を使用して、文字列を日付に変換します。 無効な入力に対する出力として、エポック日付を返します。

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

toDateTimeOnly to-date-time-only

toDateTimeOnly 関数を使用して、引数の値を日時のみの値に変換します。 無効な入力に対する出力として、エポック日付を返します。この関数は、文字列、日付、長さおよび整数のフィールドタイプを受け入れます。

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

trim trim

trim 関数は、文字列の先頭と末尾にあるすべての空白を削除します。

{%= trim(string) %}

uppercase upper

upperCase 関数は、文字列を大文字に変換します。

{%= upperCase(string) %}

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

urlDecode url-decode

urlDecode 関数を使用して、URL エンコードされた文字列をデコードします。

{%= urlDecode(string) %}: string

urlEncode url-encode

urlEncode 関数を使用して、文字列を URL としてエンコードします。

{%= urlEncode(string) %}: string