フィールド参照

フィールド参照は、イベントまたはフィールドグループに添付できます。 意味のある情報は、フィールドの名前とパスだけです。

フィールドに特殊文字を使用する場合は、二重または一重の引用符を使用する必要があります。次のような場合には引用符が必要です。

  • フィールドが数字で始まる
  • フィールドが「-」文字で始まる
  • フィールドに a_～_z、A_～_Z、0_～_9、、-_ 以外の文字が含まれる

例えば、フィールドが 3h: #{OpenWeather.weatherData.rain.'3h'} > 0 の場合

// event field
@{<event name>.<XDM path to the field>}
@{LobbyBeacon.endUserIDs._experience.emailid.id}

// field group
#{<data source name>.<field group name>.<path to the field>}
#{ExperiencePlatform.ProfileFieldGroup.profile.personalEmail.address}

式では、イベントフィールドは「@」で参照され、データソースフィールドは「#」で参照されます。

構文の色を使用して、イベントフィールド（緑）とフィールドグループ（青）を視覚的に区別します。

フィールド参照のデフォルト値

デフォルト値をフィールド名に関連付けることができます。構文は以下のとおりです。

// event field
@{<event name>.<XDM path to the field>, defaultValue: <default value expression>}
@{LobbyBeacon.endUserIDs._experience.emailid.id, defaultValue: "example@adobe.com"}
// field group
#{<data source name>.<field group name>.<path to the field>, defaultValue: <default value expression>}
#{ExperiencePlatform.ProfileFieldGroup.profile.personalEmail.address, defaultValue: "example@adobe.com"}
メモ

フィールドとデフォルト値のタイプは同じにする必要があります。例えば、@{LobbyBeacon.endUserIDs._experience.emailid.id, defaultValue : 2} は無効になります。想定される値は文字列であるにもかかわらず、デフォルト値が整数であるからです。

例：

// for an event 'OrderEvent' having the following payload:
{
    "orderId": "12345"
}

expression example:
- @{OrderEvent.orderId}                                    -> "12345"
- @{OrderEvent.producdId, defaultValue : "not specified" } -> "not specified" // default value, productId is not a field present in the payload
- @{OrderEvent.productId}                                  -> null


// for an entity 'Profile' on datasource 'ACP' having fields person/lastName, with fetched data such as:
{
    "person": {
        "lastName":"Snow"
    },
    "emails": [
        { "email":"john.snow@winterfell.westeros" },
        { "email":"snow@thewall.westeros" }
    ]
}

expression examples:
- #{ACP.Profile.person.lastName}                 -> "Snow"
- #{ACP.Profile.emails.at(1).email}              -> "snow@thewall.westeros"
- #{ACP.Profile.person.age, defaultValue : -1}   -> -1 // default value, age is not a field present in the payload
- #{ACP.Profile.person.age}                      -> null

任意の種類の式をデフォルト値として追加できます。唯一の制約は、期待されるデータ型を、式が返す必要があるということです。関数を使用する場合は、() で関数をカプセル化する必要があります。

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.any.time, defaultValue : (now())}
== date("2022-02-10T00:00:00Z")

コレクション内のフィールドへの参照

コレクション内で定義された要素は、特定の関数 all、first および last を使用して参照します。詳しくは、このページを参照してください。

例：

@{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all()

マップ内で定義されたフィールドへの参照

entry 関数

マップ内の要素を取得するには、指定のキーで entry 関数を使用します。例えば、イベントのキーを定義する際に、選択した名前空間に応じて使用します。名前空間の選択を参照してください。 詳しくは、このページを参照してください。

@{MyEvent.identityMap.entry('Email').first().id}

この式では、イベントの「IdentityMap」フィールドの「Email」キーのエントリを取得しています。「Email」エントリはコレクションであり、ここから「first()」を使用して最初の要素の「id」を取得しています。詳しくは、このページを参照してください。

firstEntryKey 関数

マップの最初のエントリキーを取得するには、firstEntryKey 関数を使用します。

次の例では、特定のリストの購読者の最初のメールアドレスを取得する方法を示しています。

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.email.subscriptions.entry('daily-email').subscribers.firstEntryKey()}

この例では、サブスクリプションリストの名前は daily-email です。メールアドレスは subscribers マップのキーとして定義され、サブスクリプションリストマップにリンクされています。

keys 関数

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

次の例では、特定のプロファイルについて、特定のリストの購読者に関連付けられているすべてのメールアドレスを取得する方法を示しています。

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.email.subscriptions.entry('daily-mail').subscribers.keys()

データソースのパラメーター値（データソースの動的な値）

パラメーターの呼び出しが必要な外部データソースからフィールドを選択すると、新しいタブが右側に表示され、そのパラメーターを指定できます。このページを参照してください。

より複雑なユースケースの場合、データソースのパラメーターをメイン式に含めるには、params キーワードを使用して、そのパラメーター値を定義できます。パラメーターは有効な式であれば、別のパラメーターも含む別のデータソースの式でも構いません。

メモ

式にパラメーター値を定義すると、右側のタブが消えます。

次の構文を使用します。

#{<datasource>.<field group>.fieldName, params: {<params-1-name>: <params-1-value>, <params-2-name>: <params-2-value>}}
  • <params-1-name>：データソースに存在する最初のパラメーターの正確な名前。
  • <params-1-value>：最初のパラメーターの値。任意の有効な式を指定できます。

例：

#{Weather.main.temperature, params: {localisation: @{Profile.address.localisation}}}
#{Weather.main.temperature, params: {localisation: #{GPSLocalisation.main.coordinates, params: {city: @{Profile.address.city}}}}}

このページ