필드 참조 concept_fkj_ll5_dgb
필드 참조는 이벤트 또는 필드 그룹에 첨부할 수 있습니다. 유일한 의미 있는 정보는 필드의 이름과 경로입니다.
필드에 특수 문자를 사용하는 경우 큰따옴표나 간단한 따옴표를 사용해야 합니다. 견적이 필요한 경우는 다음과 같습니다.
- 필드는 숫자로 시작합니다.
- 필드는 "-" 문자로 시작합니다.
- 필드에 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}
식에서 이벤트 필드는 "@"에서 참조되고 데이터 소스 필드는 "#"에서 참조됩니다.
구문 색상은 이벤트 필드(녹색)와 필드 그룹(파란색)을 시각적으로 구분하는 데 사용됩니다.
필드 참조의 기본값 default-value
기본값은 필드 이름과 연결할 수 있습니다. 구문은 다음과 같습니다.
// 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"}
예:
// 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' 키에 대한 항목을 가져옵니다. '이메일'항목은 '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}}}}}