Explore에서는 사용자 지정 메트릭 및 속성을 강화하는 수식을 작성할 수 있습니다. 수식이 올바르게 작동하도록 하려면 올바르게 구성하세요. 수식이 올바르게 구성되지 않으면 작성하거나 편집할 때 수식 편집기에 실시간으로 오류 메시지가 표시됩니다. 오류 메시지는 문제를 식별하고 해결 방법에 대한 안내를 제공합니다.
이 문서에서는 보고서에서 잘못 구성된 수식을 수정하는 방법에 대해 설명합니다. 수식 편집기에서 발생할 수 있는 오류 메시지를 나열하며 잘못된 수식과 올바른 수식의 예를 포함하여 수식을 수정하는 데 대한 조언을 제공합니다.
이 문서에서는 다음과 같은 주제를 다룹니다.
관련 문서:
잘못 구성된 수식 수정하기
계산된 메트릭이나 속성이 잘못 구성된 수식을 포함하는 경우에는 결과가 리턴되지 않습니다. 다음 위치를 확인하여 잘못 구성된 수식을 식별합니다.
- 보고서 라이브러리: 잘못 구성된 수식을 사용하는 보고서는 보고서 라이브러리의 업데이트 필요 카테고리에 나타납니다.
- 대시보드 라이브러리: 영향을 받는 보고서를 사용하는 대시보드는 대시보드 라이브러리의 업데이트 필요 탭에 나타납니다.
- 보고서 빌더: 경고 메시지는 수식을 사용하는 보고서의 아래쪽에 나타납니다.
- 수식 편집기: 수식 편집기에 영향을 받는 수식에 대한 경고 메시지가 나타납니다.
잘못 구성된 수식을 수정하려면 수식을 사용하는 보고서를 열고 수식 편집기에서 수정합니다. 그런 다음 보고서가 사용되는 모든 대시보드를 다시 게시합니다.
잘못 구성된 수식을 업데이트하려면 다음과 같이 하세요.
- 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 |
IF [티켓 상태] = "Open" THEN 1 ELSE 0 ENDIF 또는 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(” 또는 LINK(” 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(해결된 티켓) 집계 방식을 사용할 수 없습니다. VALUE 집계 방식을 사용하거나, 메트릭을 ATTRIBUTE_FIX 또는 ATTRIBUTE_ADD 함수로 래핑하세요. | IF COUNT(해결된 티켓)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ([티켓 상태 - 정렬되지 않음] = "Solved" OR [티켓 상태 - 정렬되지 않음] = "Closed") 이 오류 메시지는 메트릭이 아니라 계산된 속성에 나타납니다. 이 오류를 수정하는 가장 좋은 방법은 해결된 티켓 메트릭에서 사용된 것과 동일한 조건을 사용하는 것입니다. 따라서 위에 표시된 것처럼 수식을 업데이트할 수 있습니다. |
계산된 속성에서 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 함수를 사용합니다. |
[날짜 범위에서 계산된 메트릭]에 잘못 구성된 수식이 있습니다. 저장하기 전에 수정하세요. | COUNT([날짜 범위에서 계산된 메트릭]) |
날짜 범위에서 계산된 메트릭은 계산된 메트릭에서 지원되지 않습니다. 날짜 범위에서 계산된 메트릭을 사용하여 계산을 수행하려면 대신 결과 메트릭 계산을 이용하세요. |