No Explore, é possível escrever fórmulas que viabilizam métricas e atributos personalizados. Para garantir que as fórmulas funcionem corretamente, crie-as adequadamente. Se sua fórmula não for criada corretamente, o editor de fórmulas exibirá uma mensagem de erro em tempo real enquanto você a escreve ou edita. 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 que você pode encontrar 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 um atributo ou métrica calculada contém uma fórmula mal configurada, não retornará resultados. É possível identificar fórmulas mal configuradas verificando os lugares a seguir:
- A 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
- A 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
- O criador de relatórios: Uma mensagem de aviso é exibida no fim de um relatório que usa a fórmula.
- O 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 usa a fórmula 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 relatórios existentes sejam afetados durante o processo de 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
O vídeo abaixo explica como corrigir alguns avisos 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 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.
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" 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
| 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]) 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
| 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 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 é: SE VERDADEIRO OU FALSO [ID do Ticket] ENDIF Em vez disso, adicione algumas condições. (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://subdomain.zendesk.com/ agent/organizations/" + STRING([ID da organização do ticket]), [Caixa de seleção da organização]) |
LINK(« ou LINK(« 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 de tickets]) {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
| 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. | 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. |
| 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. Sua fórmula já contém um agregador. Por exemplo, poderia ser MED(Tempo da primeira resposta (h)). Não é permitido calcular uma média sobre uma mediana, então o agregador de nível superior precisa ser definido como SUM ou o agregador de nível inferior precisa ser alterado para 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:
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. |
| 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 são permitidas somente com os atributos de tag. Para outros atributos, use a função IN. |