표현식 편집 edit-expressions

이 페이지에서: 오케스트레이션된 캠페인에서 날짜, 문자열 및 숫자 값을 조작하기 위해 표현식 편집기를 사용하여 데이터베이스 필드, 변수 및 도우미 함수를 사용하여 규칙을 수동으로 작성하는 방법에 대해 알아봅니다.

NOTE
아래 섹션에서는 표현식 편집기를 사용하여 규칙을 작성하는 방법에 대한 정보를 제공합니다. 규칙을 작성하는 데 사용되는 구문은 개인화를 추가하는 데 사용되는 구문과 다릅니다.

표현식 편집기를 사용하여 작업 edit

표현식을 편집하려면 수동으로 조건을 입력하여 규칙을 형성해야 합니다. 이 모드에서는 날짜, 문자열, 숫자 필드 및 정렬과 같은 특정 쿼리를 수행하는 데 사용되는 값을 조작할 수 있는 고급 함수를 사용할 수 있습니다.

표현식 편집기는 규칙 빌더 표현식 편집 버튼에서 사용할 수 있으며, 사용자 정의 조건을 구성할 때 속성 및 값 필드에 사용할 수 있습니다.

속성 필드에서 액세스
값 필드에서 액세스
속성 필드에 대한 표현식 편집기 {align="center" width="200" modal="regular"}
값 필드에 대한 표현식 편집기 {align="center" width="200" modal="regular"}

표현식 편집기에서 제공하는 사항:

입력 필드에 직접 표현식을 입력하여 표현식을 편집합니다. 필드, 변수 또는 도우미 함수를 추가하려면 추가하려는 표현식에 커서를 놓고 + 단추를 클릭합니다.

표현식 편집기 인터페이스 {modal="regular"}

도우미 함수

쿼리 편집 도구를 사용하면 고급 함수를 사용하여 원하는 결과와 조작된 데이터 유형에 따라 복잡한 필터링을 수행할 수 있습니다. 다음 함수를 사용할 수 있습니다.

집계

집계 함수는 값 집합에 대해 계산을 수행합니다.

이름
설명
구문
Avg
숫자 유형 열의 평균을 반환합니다
Avg(<값>)
Count
열에서 null이 아닌 값을 셉니다
Count(<값>)
CountAll
반환된 값(모든 필드)을 셉니다
CountAll()
Countdistinct
열에서 중복되지 않고 null이 아닌 값을 셉니다
Countdistinct(<값>)
Max
숫자, 문자열 또는 날짜 유형 열의 최대값을 반환합니다
Max(<값>)
Min
숫자, 문자열 또는 날짜 유형 열의 최소값을 반환합니다
Min(<값>)
StdDev
숫자, 문자열 또는 날짜 열의 표준 편차를 반환합니다
StdDev(<값>)
StringAgg
두 번째 인수의 문자로 구분된 문자열 유형 열의 값 연결을 반환합니다
StringAgg(<값>, <문자열>)
Sum
숫자, 문자열 또는 날짜 유형 열 값의 합계를 반환합니다
Sum(<값>)

일자

날짜 함수는 날짜 또는 시간 값을 조작합니다.

이름
설명
구문
AddDays
날짜에 일 수를 추가합니다
AddDays(<날짜>, <숫자>)
AddHours
날짜에 시간 수를 추가합니다
AddHours(<날짜>, <숫자>)
AddMinutes
날짜에 분 수를 추가합니다
AddMinutes(<날짜>, <숫자>)
AddMonths
날짜에 개월 수를 추가합니다
AddMonths(<날짜>, <숫자>)
AddSeconds
날짜에 초를 추가
AddSeconds(<날짜>, <숫자>)
AddYears
날짜에 연도 수를 추가합니다
AddYears(<날짜>, <숫자>)
ConvertNTZ
정의된 세션 TZ를 적용하여 타임스탬프 NTZ(시간대가 없는 타임스탬프)를 TZ(시간대가 있는 타임스탬프)로 변환합니다
ConvertNTZ(<날짜 + 시간>)
DateCmp
두 날짜를 비교합니다
DateCmp(<날짜>, <날짜>)
DateOnly
날짜만 반환합니다(시간은 00:00으로 설정)
DateOnly(<날짜>)
Day
날짜의 일을 나타내는 숫자를 반환합니다
Day(<날짜>)
DayOfYear
날짜의 연도 내 요일 숫자를 반환합니다
DayOfYear(<날짜>)
DaysAgo
현재 날짜에서 n일을 뺀 날짜에 해당하는 날짜를 반환합니다
DaysAgo(<숫자>)
DaysAgoInt
현재 날짜에서 n일을 뺀 날짜(정수 yyyymmdd)를 반환합니다
DaysAgoInt(<숫자>)
DaysDiff
두 날짜 사이의 일 수를 반환합니다
DaysDiff(<종료 일자>, <시작 일자>)
DaysOld
날짜를 일 단위로 반환합니다
DaysOld(<날짜>)
GetDate
서버의 현재 시스템 날짜를 반환합니다
GetDate()
Hour
날짜의 시간을 반환합니다
Hour(<날짜>)
HoursDiff
두 날짜 사이의 시간 수를 반환합니다
HoursDiff(<종료 일자>, <시작 일자>)
Minute
날짜의 분을 반환합니다
Minute(<날짜>)
MinutesDiff
두 날짜 사이의 분 수를 반환합니다
MinutesDiff(<종료 일자>, <시작 일자>)
Month
날짜의 월을 나타내는 숫자를 반환합니다
Month(<날짜>)
MonthsAgo
현재 날짜에서 n개월을 뺀 날짜를 반환합니다
MonthsAgo(<숫자>)
MonthsDiff
두 날짜 사이의 개월 수를 반환합니다
MonthsDiff(<종료 일자>, <시작 일자>)
MonthsOld
날짜를 월 단위로 반환합니다
MonthsOld(<날짜>)
Oldest
범위에서 가장 오래된 날짜를 반환합니다
Oldest(<날짜>, <날짜>)
Second
날짜의 초를 반환합니다
Second(<날짜>)
SecondsDiff
두 날짜 사이의 초 수를 반환합니다
SecondsDiff(<종료 일자>, <시작 >)
SubDays
날짜에서 일 수를 뺍니다
SubDays(<날짜>, <숫자>)
SubHours
날짜에서 시간 수를 뺍니다
SubHours(<날짜>, <숫자>)
SubMinutes
날짜에서 분 수를 뺍니다
SubMinutes(<날짜>, <숫자>)
SubMonths
날짜에서 개월 수를 뺍니다
SubMonths(<날짜>, <숫자>)
SubSeconds
날짜에서 초 수를 뺍니다
SubSeconds(<날짜>, <숫자>)
SubYears
날짜에서 연도 수를 뺍니다
SubYears(<날짜>, <숫자>)
ToDate
날짜 + 시간을 날짜로 변환합니다
ToDate(<날짜 + 시간>)
ToDateTime
문자열을 날짜 + 시간으로 변환합니다
ToDateTime(<문자열>)
ToTimestamp
문자열을 타임스탬프로 변환합니다
ToTimestamp(<문자열>)
ToTimeZone
날짜 + 시간을 시간대로 변환합니다
ToTimeZone(<날짜>, <시간대>)
TruncDate
날짜 + 시간을 가장 가까운 초로 반올림합니다
TruncDate(@lastModified, <초 수>)
TruncDateTZ
날짜 + 시간을 초 단위로 표시된 지정된 정밀도로 반올림합니다
TruncDateTZ(<날짜>, <초 수>, <시간대>)
TruncQuarter
날짜를 분기로 반올림합니다
TruncQuarter(<날짜>)
TruncTime
시간 부분을 가장 가까운 초로 반올림합니다
TruncTime(<날짜>, <초 수>)
TruncWeek
날짜를 주 단위로 반올림합니다
TruncWeek(<날짜>)
TruncYear
날짜 + 시간을 해당 연도의 1월 1일로 반올림합니다
TruncYear(<날짜>)
WeekDay
날짜의 요일을 나타내는 숫자를 반환합니다(0=월요일, 6=일요일)
WeekDay(<날짜>)
Year
날짜의 연도를 나타내는 숫자를 반환합니다
Year(<날짜>)
YearAndMonth
날짜의 연도와 월을 나타내는 숫자를 반환합니다
YearAndMonth(<날짜>)
YearsAgo
지정된 날짜와 현재 날짜 사이의 연도 수를 반환합니다
YearsAgo(<날짜>)
YearsDiff
두 날짜 사이의 연도 수를 반환합니다
YearsDiff(<종료 일자>, <시작 일자>)
YearsOld
날짜를 연 단위로 반환합니다.
YearsOld(<날짜>)
NOTE
DateOnly 함수는 운영자의 시간대가 아니라 서버의 시간대를 고려합니다.

지오마케팅

지오마케팅 함수는 지리적 값을 조작하는 데 사용됩니다.

이름
설명
구문
Distance
경도와 위도로 정의된 두 지점 사이의 거리를 도 단위로 반환합니다.
Distance(<경도 A>, <위도 A>, <경도 B>, <위도 B>)

숫자

숫자 함수는 텍스트를 숫자로 변환하는 데 사용됩니다.

이름
설명
구문
Abs
숫자의 절대값 반환
Abs(<숫자>)
Ceil
숫자보다 크거나 같은 최소 정수 반환
Ceil(<숫자>)
Floor
숫자보다 크거나 같은 가장 큰 정수를 반환합니다.
Floor(<숫자>)
Greatest
두 숫자 중 큰 숫자 반환
Greatest(<숫자 1>, <숫자 2>)
Least
두 숫자 중 작은 숫자 반환
Least(<숫자 1>, <숫자 2>)
Mod
n1을 n2로 나눈 정수의 나머지를 반환합니다.
Mod(<숫자 1>, <숫자 2>)
Percent
백분율로 표현된 두 수의 비율 반환
Percent(<숫자 1>, <숫자 2>)
Random
임의 값 반환
Random()
Round
숫자를 n개의 소수로 반올림
Round(<숫자>, <소수 자리수>)
Sign
숫자 기호 반환
Sign(<숫자>)
ToDouble
정수를 실수로 변환
ToDouble(<숫자>)
ToInt64
실수를 64비트 정수로 변환
ToInt64(<숫자>)
ToInteger
실수를 정수로 변환
ToInteger(<숫자>)
Trunc
n1에서 n2까지의 소수점 자르기
Trunc(<n1>, <n2>)

기타

이 테이블에는 사용 가능한 나머지 함수가 포함되어 있습니다.

이름
설명
구문
AESEncrypt
인수에 제공된 문자열 암호화
AESEncrypt(<값>)
Case
조건이 참이면 값 1을 반환합니다. 그렇지 않으면 값 2를 반환합니다.
Case(When(<조건>, <값 1>), Else(<값 2>))
ClearBit
값에서 플래그 삭제
ClearBit(<식별자>, <플래그>)
Coalesce
값 1이 0이거나 null이면 값 2 반환, 그렇지 않으면 값 1 반환
Coalesce(<값 1>, <값 2>)
Decode
값 1 = 값 2이면 값 3을 반환합니다. 그렇지 않으면 값 4를 반환합니다.
Decode(<값 1>, <값 2>, <값 3>, <값 4>)
Else
값 1 반환(case 함수의 매개 변수로만 사용할 수 있음)
Else(<값 1>, <값 2>)
GetEmailDomain
이메일 주소에서 도메인 추출
GetEmailDomain(<값>)
GetMirrorURL
미러 페이지 서버의 URL 검색
GetMirrorURL(<값>)
Iif
표현식이 참이면 값 1을 반환합니다. 그렇지 않으면 값 2를 반환합니다.
Iif(<조건>, <값 1>, <값 2>)
IsBitSet
플래그가 값에 있는지 표시
IsBitSet(<식별자>, <플래그>)
IsEmptyString
문자열이 비어 있으면 값 2를 반환하고, 그렇지 않으면 값 3을 반환합니다.
IsEmptyString(<값 1>, <값 2>, <값 3>)
NewUUID
고유 ID를 반환합니다.
NewUUID()
NoNull
인수가 NULL이면 빈 문자열 반환
NoNull(<값>)
RowId
행 번호 반환
RowId
SetBit
값에 플래그 강제 적용
SetBit(<식별자>, <플래그>)
ToBoolean
숫자를 부울로 변환
ToBoolean(<숫자>)
When
표현식이 참이면 값 1을 반환합니다. 그렇지 않으면 값 2를 반환합니다(case 함수의 매개변수로만 사용할 수 있음).
When(<조건>, <값 1>)

문자열

문자열 함수는 문자열 집합을 조작하는 데 사용됩니다.

이름
설명
구문
AllNonNull2
모든 매개 변수가 null이 아니고 비어 있지 않은지 표시
AllNonNull2(<문자열>, <문자열>)
AllNonNull3
모든 매개 변수가 null이 아니고 비어 있지 않은지 표시
AllNonNull3(<문자열>, <문자열>, <문자열>)
Ascii
문자열에서 첫 번째 문자의 ASCII 값을 반환합니다.
Ascii(<문자열>)
Char
'n' ASCII 코드에 해당하는 문자 반환
Char(<숫자>)
Charindex
문자열 1에서 문자열 2의 위치를 반환합니다.
Charindex(<문자열>, <문자열>)
dataLength
문자열의 크기를 바이트로 반환합니다.
dataLength(<문자열>)
GetLine
문자열의 n번째(1에서 n까지) 행 반환
GetLine(<문자열>)
IfEquals
처음 두 매개변수가 동일한 경우 세 번째 매개변수를 반환합니다. 그렇지 않으면 마지막 매개변수를 반환합니다.
IfEquals(<문자열>, <문자열>, <문자열>, <문자열>)
IsMemoNull
매개 변수로 전달된 메모가 null인지 표시
IsMemoNull(<메모>)
JuxtWords
매개변수로 전달된 문자열을 연결합니다. 필요한 경우 문자열 사이에 공백을 추가합니다.
JuxtWords(<문자열>, <문자열>)
JuxtWords3
매개변수로 전달된 문자열을 연결합니다. 필요한 경우 문자열 사이에 공백을 추가합니다.
JuxtWords3(<문자열>, <문자열>, <문자열>)
Left
문자열의 처음 n자 반환
Left(<문자열>, <숫자>)
Length
문자열의 길이를 반환합니다.
Length(<문자열>)
Line
문자열에서 n번째 줄을 추출합니다.
Line(<문자열>, <숫자>)
Lower
문자열을 소문자로 반환
Lower(<문자열>)
LPad
왼쪽에서 완성된 문자열 반환
LPad(<문자열>, <숫자>, <문자>)
Ltrim
문자열 왼쪽의 공백 제거
Ltrim(<문자열>)
Md5Digest
문자열의 MD5 키를 16진수로 반환
Md5Digest(<문자열>)
MemoContains
메모에 매개 변수로 전달된 문자열이 포함되어 있는지 지정
MemoContains(<메모>, <문자열>)
NodeValue
XPath 및 필드 데이터에서 XML 필드의 값을 추출합니다.
NodeValue(<문자열>, <문자열>)
Replace
지정한 문자열 값의 모든 항목을 다른 문자열 값으로 바꿉니다.
Replace(<문자열>, <문자열>, <문자열>)
Right
문자열의 마지막 n자 반환
Right(<문자열>)
RPad
오른쪽에 완성된 문자열 반환
RPad(<문자열>, <숫자>, <문자>)
Rtrim
문자열 오른쪽의 공백 제거
Rtrim(<문자열>)
Sha256Digest
문자열의 SHA256 키의 16진수 표현입니다.
Sha256Digest(<문자열>)
Sha512Digest
문자열의 SHA512 키의 16진수 표현입니다.
Sha512Digest(<문자열>)
Smart
각 단어의 첫 번째 문자가 대문자로 표시된 문자열 반환
Smart(<문자열>)
Substring
문자열의 문자 n1부터 시작하여 길이가 n2인 하위 문자열을 추출합니다.
Substring(<문자열>, <오프셋>, <길이>)
ToString
숫자를 문자열로 변환
ToString(<숫자>, <숫자>)
Upper
문자열을 대문자로 반환
Upper(<문자열>)
VirtualLink
다른 두 매개 변수가 동일한 경우 매개 변수로 전달된 링크의 외부 키 반환
VirtualLink(<숫자>, <<숫자>, <숫자>)
VirtualLinkStr
다른 두 매개 변수가 동일한 경우 매개 변수로 전달된 링크의 외부(텍스트) 키 반환
VirtualLinkStr(<문자열>, <숫자>, <숫자>)

Window

이름
설명
구문
_Over__
두 번째 매개변수로 입력된 필드에 대해 파티션 또는 정렬 기준에 대해 첫 번째 매개변수로 입력된 SQL 함수 호출을 실행합니다.
_Over_(<값>, <값>)
Desc
내림차순 정렬 적용
Desc(<값 1>)
OrderBy
파티션 내의 결과 정렬
OrderBy(<값 1>)
PartitionBy
테이블에서 쿼리 결과 분할
PartitionBy(<값 1>)
RowNum
테이블 파티션 및 정렬 시퀀스에 따라 줄 번호를 생성합니다.
RowNum(PartitionBy(<값 1>), OrderBy(<값 1>))
AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to use the expression editor to manually build rule conditions with fields, variables, and helper functions for manipulating dates, strings, numbers, and other values in Orchestrated campaigns.

Intents:

  • Open the expression editor from the Attribute or Value field when configuring a custom condition in the rule builder.
  • Enter an expression directly in the input field, or insert a field, variable, or helper function using the + button.
  • Use helper functions (Aggregate, Date, Geomarketing, Numeric, Others, String, Window) to manipulate dates, strings, numeric values, and sorting.
  • Insert variables into an expression from the Value field.

Glossary:

  • Expression editor: a mode accessed from the rule builder Edit expression button that lets you manually enter conditions to form a rule, using advanced functions (product-specific)
  • Helper functions: functions sorted by category (Aggregate, Date, Geomarketing, Numeric, Others, String, Window) available in the expression editor to manipulate values (product-specific)
  • Fields: items available in the expression editor that correspond to the targeting dimension of the query (product-specific)
  • Variables: items available in the expression editor, from the Value field menu, that can be used in an expression (product-specific)

Guardrails:

  • The expression editor is available from the rule builder Edit expression button, for the Attribute and Value fields, when configuring a custom condition.
  • The variables menu in the expression editor is available only for the Value field, not for the Attribute field.
  • The DateOnly function takes into account the server’s timezone, not the operator’s.

Terminology:

  • Canonical name: expression editor — variants: Edit expression
  • Do not confuse: “fields” (correspond to the targeting dimension of the query) ≠ “variables” (listed in a separate menu, available from the Value field)

FAQ:

  • Q: Where is the expression editor available from? — The rule builder Edit expression button, for the Attribute and Value fields, when configuring a custom condition.
  • Q: How do I add a field, variable, or helper function to an expression? — Place your cursor in the expression where you want to add it and click the + button.
  • Q: What categories of helper functions are available? — Aggregate, Date, Geomarketing, Numeric, Others, String, and Window.
  • Q: Does the DateOnly function use my local timezone? — No, it takes into account the server’s timezone, not the operator’s.
  • Q: Can I use variables from the Attribute field? — No, the variables menu is available only for the Value field.

Related pages:

  • For using variables in an expression from the Value field: Learn how to use variables in Orchestrated campaigns (orchestrated/variables-orchestrated-campaigns.md)

Personas:

  • marketer: Can open the expression editor from the Attribute or Value field when configuring a custom condition, and enter an expression directly in the input field. Can place the cursor and select the + button to add a field, variable, or helper function. Can use helper functions sorted by category, such as Aggregate, Date, Geomarketing, Numeric, Others, String, and Window, to manipulate dates, strings, numeric values, and sorting. The page states that the variables menu is available only for the Value field. Where: “Work with the expression editor”.

Onboarding:

  • Level: Experienced
  • First minimal step: Select the Edit expression button for the Attribute or Value field when configuring a custom condition.
  • Next: Learn how to use variables in the expression editor: Use variables in Orchestrated campaigns (orchestrated/variables-orchestrated-campaigns.md)
recommendation-more-help
journey-optimizer-help