No Explore, é possível escrever fórmulas que viabilizam métricas e atributos personalizados. Para que as fórmulas funcionem corretamente, elas precisam ser construídas de maneira adequada.
Se a sua fórmula não for construída adequadamente, o editar de fórmulas exibirá uma mensagem de erro em tempo real conforme você escreve ou edita a fórmula. A mensagem de erro identifica o problema com a fórmula e, se possível, fornece orientação sobre como resolver o problema.
Este artigo lista as mensagens de erro que você pode encontrar no editor de fórmulas e fornece mais orientação sobre como corrigir a sua fórmula, incluindo exemplos de fórmula incorretas e corretas.
Este artigo contém os seguintes tópicos:
- Mensagens de erro de sintaxe geral
- Mensagens de erro de tipo de dados
- Mensagens de erro de agregador de métricas
- Outras mensagens de erro
Artigos relacionados:
Mensagens de erro de sintaxe geral
Se você vir a seguinte mensagem de erro, isso significa que parte da sintaxe na sua fórmula está incorreta:
- "Há um problema na fórmula. Confira a sintaxe do seu cálculo e tente novamente."
Os motivos mais comuns para esse erro estão indicados na tabela abaixo.
Motivo | Fórmula incorreta | Fórmula correta |
---|---|---|
Você abriu, mas não fechou um colchete ou parênteses. Ou você fechou mais do que abriu. | IF ([Status do ticket] = "Solved")) THEN [ID do ticket] ENDIF | IF ([Status do ticket] = "Solved") THEN [ID do ticket] ENDIF |
Você abriu, mas não fechou as aspas. | [Status do ticket] = "Solved | [Status do ticket] = "Solved" |
Você não colocou o atributo entre colchetes. | Status do ticket = "Solved" | [Status do ticket] = "Solved" |
Você não adicionou um agregador na frente de uma métrica. |
Tempo da primeira resposta (min) |
SUM(Tempo da primeira resposta (min)) |
Uma parte essencial da declaração IF está faltando. Neste exemplo, está faltando ENDIF. |
IF ([Status do ticket] = "Solved") THEN [ID do ticket] |
IF ([Status do ticket] = "Solved") THEN [ID do ticket] ENDIF |
Mensagens de erro de tipo de dados
A tabela a seguir mostra mensagens de erro relacionadas a tipos de dados que você pode ver no editor de fórmulas, incluindo versões incorretas e corretas de uma fórmula. Para obter mais informações sobre tipos de dados, consulte Trabalho com tipos de dados em fórmulas do Explore.
As seções abaixo cobrem mensagens de erro de tipo de dados em:
Expressões do tipo igual, diferente, menor que e maior que
Mensagem de erro | Fórmula incorreta | Fórmula correta |
---|---|---|
Não é possível usar [Estágio do projeto] como texto e 1 como um número. Use o mesmo tipo. | [Estágio do projeto]=1 |
[Estágio do projeto]="1" O mesmo tipo de dado deve ser usado nos dois lados da expressão de igualdade. Um valor entre aspas é considerado texto, mas um número sem aspas é um número. Como Estágio do projeto é um atributo de texto, o valor deve ter aspas. |
Não é possível usar [País do ticket] como texto e [Código do país do usuário] como número. Use o mesmo tipo. | [País do ticket]!=[Código do país do usuário] |
[País do ticket]!=[Nome do país do usuário] O mesmo tipo de dado deve ser usado nos dois lados da expressão de desigualdade. País do ticket é texto, então o atributo à direita também deve ser texto. |
Não é possível usar [Ticket atribuído - Data] como texto e 26 como número. Use apenas números ou apenas texto. | [Ticket atribuído - Data] >= 26 |
[Ticket atribuído - Data] >= "2023-01-26" O mesmo tipo de dado deve ser usado nos dois lados da expressão de igualdade ou maior que. Neste caso, é uma data entre aspas. |
Não é possível usar VALUE(Respostas do agente) como número e 2 como texto. Use apenas números ou apenas texto. | VALUE(Respostas do agente)<"2" |
VALUE(Respostas do agente)<2 O mesmo tipo de dado deve ser usado nos dois lados da expressão menor que. Um valor entre aspas é considerado texto, mas um número sem aspas é um número. Como Respostas do agente é uma métrica, o valor deve ser um número, então as aspas não devem ser usadas. |
Operações aritméticas e junção de valor de texto
Mensagem de erro | Fórmula incorreta | Fórmula correta |
---|---|---|
Não é possível usar [Grupo do ticket] como texto e [ID do ticket] como número. Use apenas números ou apenas texto. Se necessário, use a função STRING para transformar números em texto ou a função NUMBER para transformar texto em números. | [Grupo do ticket]+[ID do ticket] |
[Grupo do ticket]+STRING([ID do ticket]) A meta dessa fórmula é juntar texto como apresentado em Receita do Explore: Junção de atributos. É por isso que o atributo numérico precisa ser transformado em texto por meio da função STRING. |
Não é possível usar VALUE(Tempo total de resolução (min)) como número e [Tempo adicional de tarefa] como texto. Use apenas números ou apenas texto. Se necessário, use a função STRING para transformar números em texto ou a função NUMBER para transformar texto em números. | VALUE(Tempo total de resolução (min))+[Tempo adicional de tarefa] |
VALUE(Tempo total de resolução (min))+NUMBER([Tempo adicional de tarefa]) A meta dessa fórmula é somar até dois valores. Tempo total de resolução (min) é um número, mas Tempo adicional de tarefa é um campo de texto com valores numéricos listados dentro dele. A melhor abordagem é criar um novo campo numérico personalizado no Support para registrar o tempo adicional de tarefa, o que não exige nenhuma transformação e funciona "pronto para uso" no Explore. Como alternativa, o próximo atributo pode ser transformado em um número por meio da função NUMBER. |
Não é possível usar VALUE(Tempo da primeira resposta (min)) como número e "60" como texto. Use apenas números. | VALUE(Tempo da primeira resposta (min))/"60" |
VALUE(Tempo da primeira resposta (h))/60 Operações aritméticas como divisão requerem valores numéricos. Um valor entre aspas é considerado texto, mas um número sem aspas é um número. As aspas não devem ser usadas aqui. |
Não é possível usar COUNT(Comentários) como número e [Comentário público] como texto. Use apenas números. | COUNT(Comentários)-[Comentários públicos] |
COUNT(Comentários)-COUNT(Comentários públicos) Operações aritméticas como subtração requerem valores numéricos. Comentário público é um atributo de texto. Você precisa usar uma métrica em vez disso. |
Funções
Mensagem de erro | Fórmula incorreta | Fórmula correta |
---|---|---|
Não é possível usar tipos diferentes na instrução THEN. 1 é um número e "0" é texto. Use o mesmo tipo. | IF [Status do ticket]="Open" THEN 1 ELSE "0" ENDIF |
Os valores usados após as palavras-chave THEN e ELSE devem ser do mesmo tipo. Um valor entre aspas é considerado texto, mas um número sem aspas é um número. Portanto, há duas maneiras de corrigir esse erro, como mostrado acima. |
Não é possível usar 1 como número e 2 como número. Use apenas boolianos. | IF 1 OR 2 THEN [ID do ticket] ENDIF |
IF VALUE(Respostas do agente)=1 OR VALUE(Respostas do agente)=2 THEN [ID do ticket] ENDIF As condições definidas dentro da declaração IF devem ser TRUE ou FALSE. A sintaxe correta é: IF TRUE OR FALSE THEN [ID do ticket] ENDIF Você precisa adicionar algumas condições, como mostrado acima. (No entanto, o editor de fórmulas não avalia a validade das condições em si.) |
Não é possível usar número nessa função. Use texto. | NUMBER([ID do ticket]) |
NUMBER([ID externa do ticket]) A função NUMBER é projetada para transformar atributos de texto com valores numéricos em texto. O atributo ID do ticket é um campo numérico, por isso não pode ser usado com essa função. No entanto, atributos de texto como ID externa do ticket podem. |
Não é possível usar texto, booliano nessa função. Use texto, texto ou número. | LINK("https://subdominio.zendesk.com/agente/organizacoes/"+STRING([ID da organização do ticket]), [Caixa de seleção da organização]) |
A função LINK espera texto como o segundo parâmetro, por isso você não pode usar um atributo booliano. Há duas opções, como mostrado acima. Você pode usar um atributo de texto ou transformar o atributo booliano em texto por meio da função STRING. |
Não é possível usar [Ticket criado - mês] como texto aqui. Use o tipo carimbo de data/hora. | DATE_LAST([Ticket criado - Mês]) |
DATE_LAST([Ticket criado - Carimbo de data/hora]) A função DATE_LAST espera um atributo de carimbo de data/hora. |
Não é possível usar tipos de condição diferentes. Use o tipo texto. | SWITCH ([Grupo do ticket]) {CASE "Support": "1" CASE 3: "2" } |
SWITCH ([Grupo do ticket]) {CASE "Support": "1" CASE 3: "2" } Como Grupo do ticket é um atributo de texto, as condições de todos os casos devem ser do tipo texto. Um valor entre aspas é considerado texto, mas um número sem aspas é um número. Portanto, o 3 precisa estar entre aspas. |
Não é possível usar tipos diferentes na instrução SWITCH. "1" é texto e 2 é número. Use o mesmo tipo. | SWITCH ([Grupo do ticket]) {CASE "Support": "1" CASE "IT": 2 } |
SWITCH ([Grupo do ticket]) {CASE "Support": "1" CASE "IT": "2" } Os resultados de todos os casos devem ser do mesmo tipo. Um valor entre aspas é considerado texto, mas um número sem aspas é um número. Portanto, o 2 precisa estar entre aspas. |
Você não pode usar tipos diferentes na matriz. Use o mesmo tipo. | IN([Instância do segmento], ARRAY(1, "2", "3")) |
IN([Instância do segmento], ARRAY(1, 2, 3)) Use aspas para todos os valores se for um atributo de texto, ou não use aspas para todos os valores se for um atributo numérico. Instância do segmento é um atributo numérico, então a fórmula não deve usar aspas. |
Mensagens de erro de agregador de métricas
Mensagem de erro | Fórmula incorreta | Fórmula correta |
---|---|---|
O agregador VALUE não pode ser usado com métricas calculadas. Use outro agregador ou uma métrica no nível do banco de dados. | VALUE(Tickets de vendas) / COUNT(Tickets) |
SUM(Tickets de vendas)/COUNT(Tickets) Essa fórmula serve para calcular a quantidade de tickets de vendas (uma métrica calculada) em relação a todos os tickets, mas o agregador VALUE não pode ser usado com uma métrica calculada. Como essa é uma operação aritmética simples, o agregador SUM pode ser usado em vez disso. |
O agregador VALUE não pode ser usado com métricas calculadas. Use outro agregador ou uma métrica no nível do banco de dados. | IF VALUE(Tempo da primeira resposta (h))>24 THEN "Long reply time" ELSE "Short reply time" ENDIF |
IF VALUE(Tempo da primeira resposta (min))>24*60 THEN "Long reply time" ELSE "Short reply time" ENDIF O agregador VALUE não pode ser usado com métricas calculadas como Tempo da primeira resposta (h), mas você pode conseguir o mesmo resultado substituindo-o por uma métrica a nível de banco de dados como Tempo da primeira resposta (min). |
O agregador VALUE não pode ser usado com métricas calculadas. Use outro agregador ou uma métrica no nível do banco de dados. | IF VALUE(Idade dos tickets sem resolução (dias))>90 THEN [ID do ticket] ENDIF |
IF DATE_DIFF(NOW(), [Ticket criado - Carimbo de data/hora], "nb_of_hours")>90 THEN [ID do ticket] ENDIF O agregador VALUE não pode ser usado com métricas calculadas como Idade dos tickets sem resolução (dias), que tem uma fórmula de: DATE_DIFF(NOW(), [Ticket criado - Carimbo de data/hora], "nb_of_hours"). No entanto, você pode usar a fórmula original em vez disso e obter uma fórmula final como mostrado acima. |
Não é possível usar o agregador SUM(métrica de banco de dados). Use o agregador VALUE, função ATTRIBUTE_FIX ou ATTRIBUTE_ADD. | IF SUM(Tempo de espera do solicitante (min))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF |
IF VALUE(Tempo de espera do solicitante (min))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF Essa mensagem de erro aparece em atributos calculados, não métricas. Nesse caso, você precisa usar o agregador VALUE. |
Não é possível usar COUNT(Tickets resolvidos) em um atributo calculado. Coloque a métrica entre a função ATTRIBUTE_FIX ou ATTRIBUTE_ADD. | IF COUNT(Tickets resolvidos)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ([Status do ticket - Sem classificação] = "Solved" OR [Status do ticket - Sem classificação] = "Closed") "Solved" ELSE "Unsolved" ENDIF Essa mensagem de erro aparece em atributos calculados, não métricas. A melhor maneira de corrigir esse erro é usando as mesmas condições usadas na métrica Tickets resolvidos. A fórmula dessa métrica é: IF ([Status do ticket - Sem classificação] = "Solved" OR [Status do ticket - Sem classificação] = "Closed") THEN [ID do ticket] ENDIF Assim você pode atualizar a fórmula como mostrado acima. |
Não é possível usar COUNT(Atribuições do ticket para Dev) em um atributo calculado. Coloque a métrica entre a função ATTRIBUTE_FIX ou ATTRIBUTE_ADD. | IF COUNT(Atribuições do ticket para Dev)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ATTRIBUTE_FIX(COUNT(Atribuições do ticket para Dev), [ID do ticket da atualização])>1 THEN "Multiple escalations" ELSE "One or no escalations" ENDIF Essa mensagem de erro aparece em atributos calculados, não métricas. Se a fórmula original for mais complexa e não puder ser reutilizada, tente usar a função ATTRIBUTE_FIX para especificar em quais níveis esse atributo deve ser agregado. Nesse caso, ele deve ser calculado no nível ID do ticket de atualização. |
Outras mensagens de erro
Mensagem de erro | Fórmula incorreta | Fórmula correta |
---|---|---|
[Statuses do ticket] não existe nesse conjunto de dados. Verifique se há um erro de digitação. | [Statuses do ticket] ="Solved" |
[Status do ticket] ="Solved" Os motivos mais comuns para esse erro são:
Nesse exemplo, havia um erro de digitação no nome do atributo. |
[Grupo calculado] tem uma fórmula configurada incorretamente. Corrija-o antes de salvar. | IF [Grupo calculado] = "light" THEN TRUE ELSE FALSE ENDIF | Grupo calculado tem erros de configuração na fórmula. Então você precisa corrigir isso antes. |
O cálculo faz referência a si mesmo aqui COUNT(Tickets de vendas). Remova-o ou substitua-o. | COUNT(Tickets de vendas)/COUNT(Tickets) | Você está inserindo uma fórmula dentro de si mesma. Nesse caso, a fórmula sendo editada é Tickets de vendas, e o usuário está tentando adicionar Tickets de vendas dentro da fórmula. |
Máximo de 3 níveis em um cálculo. Remova o cálculo aninhado aqui: SUM((tempo da segunda resposta) | MED(tempo da segunda resposta) / MED(Tempo da primeira resposta (min) | A métrica calculada Tempo da segunda resposta é baseada em outro cálculo que por si é baseado em outro cálculo. Esses cálculos são conhecidos como aninhados. São permitidos apenas até 3 níveis aninhados. |