字段引用 field-references

字段引用可以附加到事件或字段组。 唯一有意义的信息是字段的名称及其路径。

如果您在字段中使用特殊字符,则需要使用双引号或简单引号。 以下是需要引用时的情况:

  • 该字段以数字字符开头
  • 字段以“ — ”字符开头
  • 该字段包含​ a-zA-Z0-9-_​以外的任何内容

例如,如果您的字段是​ 3h#{OpenWeather.weatherData.rain.'3h'} > 0

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

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

在表达式中,事件字段通过“@”引用,数据源字段通过“#”引用。

语法颜色用于直观地区分事件字段(绿色)和字段组(蓝色)。

字段引用的默认值 default-value

默认值可以与字段名称关联。 语法如下:

// event field
@event{<event name>.<XDM path to the field>, defaultValue: <default value expression>}
@event{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"}
NOTE
字段的类型和默认值必须相同。 例如,@event{LobbyBeacon.endUserIDs._experience.emailid.id, defaultValue : 2}无效,因为默认值为整数,而预期值应为字符串。

示例:

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

expression example:
- @event{OrderEvent.orderId}                                    -> "12345"
- @event{OrderEvent.producdId, defaultValue : "not specified" } -> "not specified" // default value, productId is not a field present in the payload
- @event{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")

对收藏集中字段的引用

集合中定义的元素使用特定函数allfirstlast引用。 有关详细信息,请参见此页面

示例:

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

对映射中定义的字段的引用

entry函数

为了检索映射中的元素,我们使用带有给定键的入口函数。 例如,在根据选定的命名空间定义事件的键时使用该变量。 有关详细信息,请参阅此页面

@event{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 ​定义其值。 参数可以是任何有效的表达式,即使来自还包含另一个参数的另一个数据源也是如此。

NOTE
在表达式中定义参数值时,右侧的选项卡消失。

使用以下语法:

#{<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: @event{Profile.address.localisation}}}
#{Weather.main.temperature, params: {localisation: #{GPSLocalisation.main.coordinates, params: {city: @event{Profile.address.city}}}}}
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76