ヘルパー関数

パーソナライゼーションエディター内のヘルパー関数を使用して、データの操作、計算の実行、コンテンツのフォーマットなどをおこない、パーソナライズされたコンテンツエクスペリエンスを正確かつ効率的に定義します。 これらの機能、オペレーター、ヘルパーがどのように連携するかを探索して実験し、カスタマイズされたデータドリブン型のジャーニーを構築するのに役立つかをご確認ください。

集計関数

集計関数を使用して複数の値をグループ化し、単一の概要値を形成します。 また、配列関数とリスト関数を使用して、配列、リスト、文字列の操作を簡単に定義することもできます。

平均 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

+ （加算）関数を使用して、2つの引数式の合計を検索します。

{%= double + double %}

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

乗算 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つの引数式を分割した後の残りを検索します。

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

リスト内の異なる値の数をnull値を含めてカウントするには、distinctCountWithNull関数を使用します。

{%= distinctCountWithNull(array) %}

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

head 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(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

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

{%= subsetOf(array1, array2) %}

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

スーパーセットの superset

supersetOf関数を使用して、特定の配列（配列A）が別の配列（配列B）のスーパーセットであるかどうかを判断します。 つまり、その配列 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) %}

addYears add-years

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

{%= addYears(date, number) %}

年齢 age

age関数を使用して、特定の日付から年齢を取得します。

 {%= age(datetime) %}

ageInDays age-days

ageInDays関数は、指定された日付から現在の日付までの経過日数を計算します。 将来の日付にはマイナスを使用し、過去の日付にはプラスを使用します。

{%= ageInDays(date) %}

ageInMonths 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) %}

DayOfWeek day-week

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

{%= dayOfWeek(datetime) %}

dayOfYear day-year

dayOfYear関数を使用して、年の日付を取得します。

{%= 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() %}

diffInHours hours-difference

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

{%= diffInHours(endDate, startDate) %}

diffInMinutes 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関数を使用すると、00:00の時点で日時を四半期の最初の日（1月1日、4月1日、7月1日、10月1日など）に切り捨てることができます。

{%= truncateToStartOfQuarter(dateTime) %}

truncateToStartOfWeek truncate-week

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

{%= truncateToStartOfWeek(dateTime) %}

truncateToStartOfYear truncate-year

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

{%= truncateToStartOfYear(dateTime) %}

weekOfYear week-of-year

weekOfYear関数を使用して、年の週を取得します。

{%= weekOfYear(datetime) %}

diffInYears diff-years

diffInYears関数を使用して、2つの日付の差を年で返します。

{%= 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 ヘルパーを使用します。 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

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

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

roundUp round-up

roundUp関数を使用して数値を切り上げます。

{%= roundUp(double) %}: double

toHexString to-hex-string

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

{%= toHexString(number) %}: string

{%= toHexString(158) %}

toInt to-int

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

{%= 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関数を使用して、URLに含めるなど、個人情報（PI）を保存する文字列をエンコードします。

{%= 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(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

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

{= 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関数を使用して、正規表現式と一致するテキストのすべての部分文字列を、指定されたリテラル置換文字列に置き換えます。 Regexは\と+の特別な処理を行い、すべての正規表現はPQL エスケープ ストラテジーに従います。 文字列の先頭から末尾まで置換が行われます。例えば、文字列aaを文字列aaaのbに置き換えると、abではなくbaになります。

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

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

{%= urlEncode(string) %}: string