No Explore, é possível escrever fórmulas que viabilizam métricas e atributos personalizados. É importante criar fórmulas corretamente para garantir que elas funcionem. Se uma fórmula não estiver correta, o editor de fórmulas exibirá uma mensagem de erro em tempo real. A mensagem de erro identifica o problema e fornece orientações sobre como resolvê-lo.
Este artigo explica como corrigir uma fórmula configurada incorretamente em seus relatórios. Ele lista as mensagens de erro no editor de fórmulas e fornece conselhos sobre como corrigir sua fórmula, incluindo exemplos de fórmulas incorretas e corretas.
Este artigo contém os seguintes tópicos:
Artigos relacionados:
Correção de fórmulas mal configuradas
Se uma métrica ou atributo calculado contiver uma fórmula mal configurada, não retornará resultados. É possível identificar fórmulas mal configuradas verificando os lugares a seguir:
- Biblioteca de relatórios: Os relatórios que usam uma fórmula configurada incorretamente são exibidos na categoria Atualizações obrigatórias na Biblioteca de relatórios
- Biblioteca de painéis: Os painéis que usam relatórios afetados são exibidos na aba Atualizações necessárias na Biblioteca de painéis
- Criador de relatórios: uma mensagem de aviso é exibida no fim de um relatório que usa a fórmula
- Editor de fórmulas: uma mensagem de aviso é exibida no editor de fórmulas para a fórmula afetada
Para corrigir uma fórmula mal configurada, abra um relatório que a utilize e corrija-a no editor de fórmulas. Em seguida, publique novamente os painéis em que o relatório é utilizado.
) e selecionando Criado por.Como atualizar uma fórmula mal configurada
- No Explore, clique no ícone de relatórios (
) para abrir a Biblioteca de relatórios. -
Clique na aba Atualizações obrigatórias.
- Clique em um dos relatórios listados para abri-lo.
- Para cada métrica calculada ou atributo:
- Clique na métrica ou no atributo e clique no ícone de lápis.
-
Verifique a fórmula para identificar más configurações. As partes mal configuradas da fórmula são sublinhadas. Uma mensagem de erro diz o que precisa ser corrigido.
- Opcionalmente, crie uma cópia da métrica ou do atributo antes de fazer alterações. Isso evita que os relatórios existentes sejam afetados durante a solução de problemas.
-
Corrija os problemas com a fórmula especificados pela mensagem de erro. Confira nas seções abaixo mais orientações com mensagens de erro específicas.
Corrigir uma fórmula de atributo ou métrica calculada em um relatório também a corrige nos outros relatórios em que é usada.
- Opcionalmente, se você criou uma cópia da métrica ou do atributo, atualize a original.
- Salve o relatório
Como republicar os painéis afetados
- Clique no ícone de painel (
) para abrir a Biblioteca de painéis. - Clique na aba Atualizações obrigatórias.
- Passe o mouse sobre um dos painéis e clique em Editar.
- No painel, clique na seta suspensa ao lado de Compartilhar e selecione Publicar. Quando os usuários reabrirem o painel compartilhado, eles verão a versão mais recente
- Clique em Publicar.
Tipos de mensagens de erro no editor de fórmulas
Esta seção lista os seguintes tipos de mensagens de erro e fornece orientação sobre sua resolução:
Erros de fórmula mais comuns
Confira nas seções abaixo mais orientações sobre mensagens de erro específicas.
Mensagens de erro de sintaxe geral
Se você vir a seguinte mensagem de erro, isso significa que a sintaxe na sua fórmula está incorreta:
-
"Há um problema na fórmula. Confira a sintaxe do seu cálculo e tente novamente."
A tabela abaixo lista os motivos mais comuns para esse erro.
| Motivo | Fórmula incorreta | Fórmula correta |
|---|---|---|
| Você abriu, mas não fechou um colchete ou parêntese, ou 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 no editor de fórmulas, incluindo versões incorretas e corretas de uma fórmula.
As seções abaixo cobrem mensagens de erro de tipo de dados:
Expressões do tipo igual, diferente, menor que e maior que
| Exemplo de 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" Use o mesmo tipo de dado nos dois lados da expressão de igualdade. Um valor entre aspas é um 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] Use o mesmo tipo de dado 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" Use o mesmo tipo de dado nos dois lados da expressão de igual 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 Use o mesmo tipo de dado nos dois lados da expressão menor que. Um valor entre aspas é um 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 não use aspas. |
Operações aritméticas e junção de valor de texto
| Exemplo de 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]) Esta fórmula une o texto conforme mostrado na receita do Explore: Junção de atributos. Transforme o atributo numérico em texto com a 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]) Essa fórmula soma 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 tempo de tarefa adicional, que funciona sem transformação no Explore. Como alternativa, o atributo texto 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. Não use aspas 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. Em vez disso, use uma métrica. |
Funções
| Exemplo de 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 |
IF [Status do ticket] = "Open" THEN 1 ELSE 0 ENDIF ou IF [Status do ticket] = "Open" THEN "1" ELSE "0" ENDIF Os valores após THEN e ELSE devem ser do mesmo tipo. Aspas indicam texto, enquanto sua ausência indica um número. Corrija esse erro usando uma das duas maneiras acima. |
| Não é possível usar 1 como número e 2 como número. Use apenas valores booleanos | 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 Em vez disso, adicione condições. 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 transforma atributos de texto com valores numéricos em texto. O atributo ID do ticket é um campo numérico e não pode ser usado com essa função. Atributos de texto, como o ID externo do Ticket, podem ser usados. |
| 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]) |
LINK("https://seusubdominio.zendesk.com/agent/organizations/" + STRING([ID da organização do ticket]), [Nome da organização do ticket]) ou LINK("https://seusubdominio.zendesk.com/agente/organizacoes/" + STRING([ID da organização do ticket]), STRING([Caixa de seleção da organização])) A função LINK espera texto como o segundo parâmetro. Não utilize um atributo booleano. Você pode usar um atributo de texto ou transformar o atributo booleano 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, todas as condições de caso devem ser do tipo texto. Coloque o número 3 entre aspas para que ele se torne um texto. |
| 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. Coloque o número 2 entre aspas para que ele se torne um texto. |
| 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 as use se for um atributo numérico. A instância do segmento é numérica, portanto, não use aspas. |
| Unidade de tempo inválida para as datas fornecidas | DATE_DIFF([Resolução do ticket - data], [Criação do ticket - data], "minutos") | Ao usar a função DATE_DIFF, certifique-se de que a unidade de tempo (terceiro parâmetro) corresponda à precisão dos campos de data. Para datas sem detalhes de hora (horas, minutos), apenas "ano", "mês" ou "dia" são permitidos. Usar unidades sem suporte, como "minutos", acionará um erro. |
Mensagens de erro de agregador de métricas
| Exemplo de mensagem de erro | Fórmula incorreta | Fórmula correta |
|---|---|---|
| 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. | Se SUM(tempo de espera do solicitante (min))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF |
Se 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. Use o agregador VALUE aqui. |
| Não é possível usar o agregador COUNT(Tickets resolvidos). Use o agregador VALUE ou envolva as métricas na função ATTRIBUTE_FIX ou ATTRIBUTE_ADD. | SE 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") "Resolvido" ELSE "Unsolved" ENDIF Essa mensagem de erro aparece em atributos calculados. Corrija isso usando as mesmas condições que a métrica Tickets resolvidos. |
| 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. | SE COUNT(atribuições do ticket para dev)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
SE 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. Se a fórmula original for complexa, use a função ATTRIBUTE_FIX para especificar níveis de agregação. Calcule isso no nível ID do ticket de atualização. |
| Tempo no status já contém agregadores. Substitua AVG por SUM, ou certifique-se de que Tempo no status contém apenas agregadores VALUE. | AVG(Tempo no status) |
SUM(Tempo no status) Tempo no status é uma métrica aninhada com um agregador existente. Não é permitido calcular uma média acima de uma mediana. Defina o agregador de nível superior como SUM ou altere o agregador de nível inferior como VALUE. |
Outras mensagens de erro
| Exemplo de 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:
|
| [Grupo calculado] tem uma fórmula configurada incorretamente. Corrija-o antes de salvar. | IF [Grupo calculado] = "light" THEN TRUE ELSE FALSE ENDIF | O grupo calculado tem uma configuração incorreta. Primeiro, corrija isso. |
| 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) | Não adicione uma fórmula dentro dela mesma. Neste caso, o usuário está editando tickets de vendas e tentando incluí-los na 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 2º tempo de resposta é aninhada. São permitidos apenas até 3 níveis aninhados. |
| Não é possível usar [Grupo do ticket] aqui. INCLUDES_ALL só pode ser usado em atributos de tag. | INCLUDES_ALL([Grupo do ticket], "Support", "Sales") |
As funções INCLUDES funcionam apenas com atributos de tag. Para outros atributos, use a função IN. |
| [Métrica calculada de intervalo de datas] tem uma fórmula configurada incorretamente. Corrija-o antes de salvar. | COUNT([Métrica calculada de intervalo de datas]) | As métricas calculadas de intervalo de datas não são suportadas em métricas calculadas. Em vez disso, use um cálculo de métricas do resultado. |
| Você não pode usar [função] aqui. Use INCLUDES_ALL ou INCLUDES_ANY para os atributos de tag. | IF (CONTAINS([Tags de ticket],"vendas")) THEN "Vendas" ELSE "Prod" ENDIF |
INCLUDES_ALL([Tags de ticket], "Vendas", "Prod") Apenas o relatório INCLUDES_ALL e INCLUDES_ANY gera relatórios sobre tags. |