Explore에서는 사용자 지정 메트릭 및 속성을 강화하는 수식을 작성할 수 있습니다. 수식이 올바르게 작동하려면 제대로 구성되어야 합니다.
수식이 제대로 구성되지 않으면 수식을 작성하거나 편집할 때 실시간으로 수식 편집기에 오류 메시지가 표시됩니다. 오류 메시지는 수식의 문제를 식별하고, 가능한 경우에는 문제 해결 방법에 대한 안내를 제공합니다.
이 문서에서는 보고서에서 잘못 구성된 수식을 수정하는 방법을 보여줍니다. 또한 수식 편집기에서 발생할 수 있는 오류 메시지를 나열하며 잘못된 수식과 올바른 수식의 예를 포함하여 수식을 수정하는 데 대한 추가적인 조언을 제공합니다.
이 문서에서는 다음과 같은 주제를 다룹니다.
관련 문서:
잘못 구성된 수식 수정하기
계산된 메트릭이나 속성이 잘못 구성된 수식을 포함하는 경우에는 결과가 리턴되지 않습니다. 다음과 같은 곳을 확인하여 잘못 구성된 수식을 식별할 수 있습니다.
- 보고서 라이브러리: 잘못 구성된 수식을 사용하는 보고서는 보고서 라이브러리의 업데이트 필요 카테고리에 나열됩니다.
- 대시보드 라이브러리: 영향을 받는 보고서를 사용하는 대시보드는 대시보드 라이브러리의 업데이트 필요 탭에 나열됩니다.
- 보고서 빌더: 경고 메시지는 수식을 사용하는 보고서의 아래쪽에 나타납니다.
- 수식 편집기: 수식 편집기에 영향을 받는 수식에 대한 경고 메시지가 나타납니다.
잘못 구성된 수식을 수정하려면 수식을 사용하는 보고서를 열고 수식 편집기에서 수정합니다. 그런 다음 보고서가 사용되는 모든 대시보드를 다시 게시합니다.
![](https://zen-marketing-documentation.s3.amazonaws.com/docs/en/explore_columns_icon.png)
- Explore에서 보고서 아이콘(
)을 클릭하여 보고서 라이브러리를 엽니다.
-
업데이트 필요 탭을 클릭합니다.
- 나열된 보고서 중 하나를 클릭하여 엽니다.
- 계산된 각 메트릭이나 속성에 대해 다음을 수행합니다.
- 메트릭 또는 속성을 클릭한 후 연필 아이콘을 클릭합니다.
- 수식을 확인하여 잘못 구성된 부분을 찾습니다. 수식의 잘못 구성된 부분에는 밑줄이 그어져 있습니다. 오류 메시지를 보고 무엇을 수정해야 하는지 알 수 있습니다.
- (선택 사항) 변경 작업을 하기 전에 메트릭이나 속성의 사본을 만듭니다. 이렇게 하면 문제 해결 과정 중에 기존 보고서가 영향을 받는 것을 피할 수 있습니다.
- 오류 메시지가 명시한 수식의 문제를 수정합니다. 특정 오류 메시지에 대한 추가적인 안내는 아래 섹션을 참조하세요.
한 보고서에서 계산된 메트릭이나 속성의 수식을 수정하면 이러한 메트릭이나 속성이 사용되는 다른 모든 보고서에서도 수정됩니다.
- (선택 사항) 메트릭이나 속성의 사본을 만들었으면 원본을 업데이트합니다.
- 보고서를 저장합니다.
영향을 받은 대시보드를 다시 게시하려면 다음과 같이 하세요.
-
대시보드 아이콘(
)을 클릭하여 대시보드 라이브러리를 엽니다.
- 업데이트 필요 탭을 클릭합니다.
- 대시보드 중 하나에 커서를 갖다 대고 편집을 클릭합니다.
- 대시보드에서 공유 옆의 드롭다운 화살표를 클릭하고 게시를 선택합니다. 다음에 사용자가 공유 대시보드를 볼 때에는 최신 버전을 보게 됩니다.
- 게시를 클릭합니다.
수식 편집기의 오류 메시지 유형
이 섹션에서는 다음과 같은 유형의 오류 메시지를 나열하고 그러한 오류 메시지를 해결하는 데 대한 조언을 제공합니다.
가장 일반적인 수식 오류
아래 동영상에서는 몇 가지 일반적인 경고를 수정하는 방법을 안내합니다.
특정 오류 메시지에 대한 추가적인 안내는 아래 섹션을 참조하세요.
일반 구문 오류 메시지
다음 오류 메시지가 보이면 수식의 일부 구문이 올바르지 않은 것입니다.
- "수식에 문제가 있습니다. 계산 구문을 확인하고 다시 시도하세요."
이 오류의 가장 일반적인 원인이 아래 표에 나와 있습니다.
이유 | 잘못된 수식 | 올바른 수식 |
---|---|---|
둥근 괄호나 대괄호를 열었지만 닫지 않았습니다. 또는 열은 수보다 닫은 수가 더 많습니다. | IF ([티켓 상태] = "Solved")) THEN [티켓 ID] ENDIF | IF ([티켓 상태] = "Solved") THEN [티켓 ID] ENDIF |
따옴표를 열었지만 닫지 않았습니다. | [티켓 상태] = "Solved | [티켓 상태] = "Solved" |
속성을 대괄호로 둘러싸지 않았습니다. | 티켓 상태 = "Solved" | [티켓 상태] = "Solved” |
메트릭 앞에 집계 방식을 추가하지 않았습니다. |
첫 번째 응답 시간(분) |
SUM(첫 번째 응답 시간(분)) |
IF 문에서 중요한 부분이 누락되었습니다. 이 예에서는 ENDIF가 누락되었습니다. |
IF ([티켓 상태] = "Solved") THEN [티켓 ID] |
IF ([티켓 상태] = "Solved") THEN [티켓 ID] ENDIF |
데이터 유형 오류 메시지
아래 표에는 수식의 잘못된 버전과 올바른 버전을 포함하여 수식 편집기에서 볼 수 있는 데이터 유형과 관련된 오류 메시지가 나와 있습니다.
아래 섹션에서는 데이터 유형 오류 메시지를 다룹니다.
다음과 같음, 다음과 같지 않음, 다음보다 작음 또는 다음보다 큼 표현식
오류 메시지 예 | 잘못된 수식 | 올바른 수식 |
---|---|---|
[프로젝트 단계]를 텍스트로, 1을 숫자로 사용할 수 없습니다. 동일한 유형을 사용하세요. | [프로젝트 단계]=1 |
[프로젝트 단계]="1" 등식의 양쪽에 동일한 데이터 유형이 사용되어야 합니다. 따옴표로 묶인 값은 텍스트로 간주되지만 따옴표가 없는 숫자는 숫자입니다. 프로젝트 단계는 텍스트 속성이므로 값에 따옴표가 있어야 합니다. |
[티켓 국가]를 텍스트로, [사용자 국가 코드]를 숫자로 사용할 수 없습니다. 동일한 유형을 사용하세요. | [티켓 국가]!=[사용자 국가 코드] |
[티켓 국가]!=[사용자 국가 이름] 부등식의 양쪽에 동일한 데이터 유형이 사용되어야 합니다. 티켓 국가는 텍스트이므로 오른쪽의 속성도 텍스트여야 합니다. |
[티켓 배정됨 - 날짜]를 텍스트로, 26을 숫자로 사용할 수 없습니다. 숫자나 텍스트만 사용하세요. | [티켓 배정됨 - 날짜] >= 26 |
[티켓 배정됨 - 날짜] >= "2023-01-26" 보다 크거나 같음 표현식의 양쪽에 동일한 데이터 유형이 사용되어야 합니다. 이 경우에는 따옴표로 묶인 날짜입니다. |
VALUE(상담사 답장)을 숫자로, 2를 텍스트로 사용할 수 없습니다. 숫자나 텍스트만 사용하세요. | VALUE(상담사 답장)<”2” |
VALUE(상담사 답장)<2 보다 작음 표현식의 양쪽에 동일한 데이터 유형이 사용되어야 합니다. 따옴표로 묶인 값은 텍스트로 간주되지만 따옴표가 없는 숫자는 숫자입니다. 상담사 답장은 메트릭이므로 값이 숫자여야 하고 따옴표를 사용하면 안 됩니다. |
산술 연산 및 텍스트 값 합치기
오류 메시지 예 | 잘못된 수식 | 올바른 수식 |
---|---|---|
[티켓 그룹]을 텍스트로, [티켓 ID]를 숫자로 사용할 수 없습니다. 숫자나 텍스트만 사용하세요. 필요하다면 STRING 함수를 사용하여 숫자를 텍스트로 변환하거나 NUMBER 함수를 사용하여 텍스트를 숫자로 변환하세요. | [티켓 그룹]+[티켓 ID] |
[티켓 그룹]+STRING([티켓 ID]) 이 수식의 목표는 Explore 사용법: 속성 합치기에서 소개한 대로 텍스트를 합치는 것입니다. 그런 이유로 STRING 함수를 통해 숫자 속성을 텍스트로 변환해야 합니다. |
VALUE(전체 해결 시간(분))을 숫자로, [추가 작업 시간]을 텍스트로 사용할 수 없습니다. 숫자나 텍스트만 사용하세요. 필요하다면 STRING 함수를 사용하여 숫자를 텍스트로 변환하거나 NUMBER 함수를 사용하여 텍스트를 숫자로 변환하세요. | VALUE(전체 해결 시간(분))+[추가 작업 시간] |
VALUE(전체 해결 시간(분))+NUMBER([추가 작업 시간]) 이 수식의 목표는 두 개의 값을 합하는 것입니다. 전체 해결 시간(분)은 숫자이지만 추가 작업 시간은 숫자 값이 안에 나열되어 있는 텍스트 필드입니다. 가장 좋은 접근 방식은 추가 작업 시간을 기록하기 위한 새 숫자 사용자 지정 필드를 Support에서 만드는 것입니다. 이 필드는 변환이 필요하지 않으며 Explore에서 "바로 이용 가능"합니다. 대안으로 NUMBER 함수를 통해 텍스트 속성을 숫자로 변환할 수 있습니다. |
VALUE(첫 번째 응답 시간(분))을 숫자로, "60"을 텍스트로 사용할 수 없습니다. 숫자만 사용하세요. | VALUE(첫 번째 응답 시간(분))/"60" |
VALUE(첫 번째 응답 시간(분))/60 나누기와 같은 산술 연산자에는 숫자 값이 필요합니다. 따옴표로 묶인 값은 텍스트로 간주되지만 따옴표가 없는 숫자는 숫자입니다. 여기서는 따옴표를 사용하면 안 됩니다. |
COUNT(댓글)을 숫자로, [공개 댓글]을 텍스트로 사용할 수 없습니다. 숫자만 사용하세요. | COUNT(댓글)-[공개 댓글] |
COUNT(댓글)-COUNT(공개 댓글) 빼기와 같은 산술 연산자에는 숫자 값이 필요합니다. 공개 댓글은 텍스트 속성입니다. 대신 메트릭을 사용해야 합니다. |
함수
오류 메시지 예 | 잘못된 수식 | 올바른 수식 |
---|---|---|
THEN 문에서 서로 다른 유형을 사용할 수 없습니다. 1은 숫자이고 "0"은 텍스트입니다. 동일한 유형을 사용하세요. | IF [티켓 상태]="Open" THEN 1 ELSE "0" ENDIF |
THEN 및 ELSE 키워드 뒤에 사용되는 값은 동일한 유형이어야 합니다. 따옴표로 묶인 값은 텍스트로 간주되지만 따옴표가 없는 숫자는 숫자입니다. 따라서 위에 표시된 것처럼 두 가지 방법으로 이 오류를 수정할 수 있습니다. |
1을 숫자로, 2를 숫자로 사용할 수 없습니다. 부울만 사용하세요. | IF 1 OR 2 THEN [티켓 ID] ENDIF |
IF VALUE(상담사 답장) = 1 OR VALUE(상담사 답장) = 2 THEN [티켓 ID] ENDIF IF 문 안의 조건 집합이 TRUE 또는 FALSE여야 합니다. 올바른 구문: IF TRUE OR FALSE THEN [티켓 ID] ENDIF 위에 표시된 것처럼 몇몇 조건을 추가해야 합니다. (단, 수식 편집기는 조건의 유효성을 평가하지 않습니다.) |
이 함수에서는 숫자를 사용할 수 없습니다. 텍스트를 사용하세요. | NUMBER([티켓 ID]) |
NUMBER([티켓 외부 ID]) NUMBER 함수는 숫자 값이 있는 텍스트 속성을 텍스트로 변환하기 위한 것입니다. 티켓 ID 속성은 숫자 필드이므로 이 함수와 함께 사용할 수 없습니다. 단, 티켓 외부 ID와 같은 텍스트 속성은 이 함수와 함께 사용할 수 있습니다. |
이 함수에서는 텍스트, 부울을 사용할 수 없습니다. 텍스트, 텍스트 또는 숫자를 사용하세요. | LINK("https://subdomain.zendesk.com/agent/organizations/" + STRING([티켓 조직 ID]), [조직 확인란]) |
LINK 함수는 두 번째 매개변수로 텍스트를 예상하므로 부울 속성을 사용할 수 없습니다. 위에 표시된 대로 두 가지 옵션이 있습니다. 텍스트 속성을 사용하거나, STRING 함수를 통해 부울 속성을 텍스트로 변환할 수 있습니다. |
여기에서 [티켓 만든 시간 - 월]을 텍스트로 사용할 수 없습니다. 타임스탬프 유형을 사용하세요. | DATE_LAST([티켓 만든 시간 - 월]) |
DATE_LAST([티켓 만든 시간 - 타임스탬프]) DATE_LAST 함수는 타임스탬프 속성을 예상합니다. |
다른 조건 유형을 사용할 수 없습니다. 텍스트 유형을 사용하세요. | SWITCH ([티켓 그룹]) {CASE "Support": "1" CASE 3: "2" } |
SWITCH ([티켓 그룹]) {CASE "Support": "1" CASE 3: "2" } 티켓 그룹은 텍스트 속성이므로 모든 케이스의 조건은 텍스트 유형이어야 합니다. 따옴표로 묶인 값은 텍스트로 간주되지만 따옴표가 없는 숫자는 숫자입니다. 따라서 3을 따옴표로 묶어야 합니다. |
SWITCH 문에서 서로 다른 유형을 사용할 수 없습니다. "1"은 텍스트이고 2는 숫자입니다. 동일한 유형을 사용하세요. | SWITCH ([티켓 그룹]) {CASE "Support": "1" CASE "IT": 2 } |
SWITCH ([티켓 그룹]) {CASE "Support": "1" CASE "IT": "2" } 모든 케이스의 결과가 동일한 유형이어야 합니다. 따옴표로 묶인 값은 텍스트로 간주되지만 따옴표가 없는 숫자는 숫자입니다. 따라서 2를 따옴표로 묶어야 합니다. |
배열에서 서로 다른 유형을 사용할 수 없습니다. 동일한 유형을 사용하세요. | IN([레그 인스턴스], ARRAY(1, "2", "3")) |
IN([레그 인스턴스], ARRAY(1, 2, 3)) 텍스트 속성인 경우에는 모든 값에 따옴표를 사용하고, 숫자 속성인 경우에는 모든 값에 따옴표를 사용하지 마세요. 레그 인스턴스는 숫자 속성이므로 수식에 따옴표를 사용하면 안 됩니다. |
메트릭 집계 방식 오류 메시지
오류 메시지 예 | 잘못된 수식 | 올바른 수식 |
---|---|---|
SUM(데이터베이스 메트릭) 집계 방식을 사용할 수 없습니다. VALUE 집계 방식, ATTRIBUTE_FIX 또는 ATTRIBUTE_ADD 함수를 사용하세요. | IF SUM(요청자 대기 시간(분))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF |
IF VALUE(요청자 대기 시간(분))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF 이 오류 메시지는 메트릭이 아니라 계산된 속성에 나타납니다. 이 경우에는 VALUE 집계 방식을 사용해야 합니다. |
계산된 속성에서 COUNT(해결된 티켓)을 사용할 수 없습니다. ATTRIBUTE_FIX 또는 ATTRIBUTE_ADD 함수에서 메트릭을 둘러싸세요. | IF COUNT(해결된 티켓)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ([티켓 상태 - 정렬되지 않음] = "Solved" OR [티켓 상태 - 정렬되지 않음] = "Closed") "Solved" ELSE "Unsolved" ENDIF 이 오류 메시지는 메트릭이 아니라 계산된 속성에 나타납니다. 이 오류를 수정하는 가장 좋은 방법은 해결된 티켓 메트릭에서 사용된 것과 동일한 조건을 사용하는 것입니다. 이 메트릭의 수식: IF ([티켓 상태 - 정렬되지 않음] = "Solved" OR [티켓 상태 - 정렬되지 않음] = "Closed") THEN [티켓 ID] ENDIF 따라서 위에 표시된 것처럼 수식을 업데이트할 수 있습니다. |
계산된 속성에서 COUNT(개발 팀에 티켓 배정)를 사용할 수 없습니다. ATTRIBUTE_FIX 또는 ATTRIBUTE_ADD 함수에서 메트릭을 둘러싸세요. | IF COUNT(개발 팀에 티켓 배정)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ATTRIBUTE_FIX(COUNT(개발 팀에 티켓 배정), [업데이트 티켓 ID])>1 THEN "Multiple escalations" ELSE "One or no escalations" ENDIF 이 오류 메시지는 메트릭이 아니라 계산된 속성에 나타납니다. 원래 수식이 더 복잡하고 재사용될 수 없는 경우에는 ATTRIBUTE_FIX 함수를 사용하여 이 속성을 집계해야 하는 수준을 지정해 보세요. 이 경우에는 업데이트 티켓 ID 수준에서 계산되어야 합니다. |
상태 시간에는 이미 집계 방식이 포함되어 있습니다. AVG를 SUM으로 바꾸거나 상태 시간에 VALUE 집계 방식만 포함하도록 하세요. | AVG(상태 시간) |
SUM(상태 시간) 상태 시간은 중첩 메트릭입니다. 수식에 이미 집계 방식이 포함되어 있습니다. 예를 들어 MED(첫 번째 응답 시간(시간))일 수 있습니다. 중간값 외에 평균을 계산하는 것은 허용되지 않으므로 최상위 수준 집계 방식을 SUM으로 설정하거나 하위 수준 집계 방식을 VALUE로 변경해야 합니다. |
기타 오류 메시지
오류 메시지 예 | 잘못된 수식 | 올바른 수식 |
---|---|---|
[티켓 상태]가 이 데이터 집합에 존재하지 않습니다. 오타가 있는지 확인하세요. | [티켓 상태들] ="Solved" |
[티켓 상태] ="Solved" 이 오류의 가장 일반적인 원인은 다음과 같습니다.
이 예에서는 속성의 이름에 오타가 있었습니다. |
[계산된 그룹]에 잘못 구성된 수식이 있습니다. 저장하기 전에 수정하세요. | IF [계산된 그룹] = "light" THEN TRUE ELSE FALSE ENDIF | 계산된 그룹의 수식에 일부 잘못 구성된 부분이 있습니다. 따라서 그러한 부분을 먼저 수정해야 합니다. |
계산이 여기 COUNT(영업 티켓)를 자체 참조합니다. 제거하거나 바꾸세요. | COUNT(영업 티켓)/COUNT(티켓) | 자체 안에 수식을 추가합니다. 이 경우 편집 중인 수식은 영업 티켓이며 사용자는 수식 안에 영업 티켓을 추가하려고 합니다. |
계산에 최대 3개 수준이 있습니다. 다음에서 중첩 계산을 제거합니다. SUM((두 번째 응답 시간) | MED(두 번째 응답 시간)/MED(첫 번째 응답 시간(분) | 두 번째 응답 시간 계산된 메트릭은 그 자체가 다른 계산을 기준으로 하는 또 다른 계산에 따릅니다. 이러한 계산을 중첩이라고 합니다. 중첩 수준은 최대 3개까지만 허용됩니다. |
여기서는 [티켓 그룹]을 사용할 수 없습니다. INCLUDES_ALL은 태그 속성에만 사용할 수 있습니다. | INCLUDES_ALL([티켓 그룹], "Support", "Sales") |
INCLUDES 함수는 태그 속성으로만 허용됩니다. 기타 속성의 경우 IN 함수를 사용합니다. |