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.

Observação: A partir de 13 de agosto de 2024, os relatórios com fórmulas configuradas incorretamente que podem ter funcionado anteriormente deixarão de funcionar e uma mensagem de erro será exibida. Para obter mais informações, consulte o artigo: Anúncio da remoção dos cálculos inválidos no Explore.

Este artigo contém os seguintes tópicos:

  • Correção de fórmulas mal configuradas
  • Tipos de mensagens de erro no editor de fórmulas

Artigos relacionados:

  • Recursos de criação de fórmulas
  • Referência de funções do Explore

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.

Observação: se uma fórmula mal configurada é aninhada dentro de um cálculo não baseado em fórmula (como uma métrica de intervalo de datas ou um atributo de grupo ou conjunto), nenhuma mensagem de erro é exibida no cálculo não baseado em fórmula. Para ver a mensagem de erro no editor de fórmulas, abra o cálculo aninhado original.
Dica: você pode pedir que os criadores dos relatórios corrijam as próprias fórmulas. A coluna Criado por na Biblioteca de relatórios mostra qual usuário criou cada relatório. Se Criado por não estiver aparecendo, adicione essa coluna clicando no ícone de colunas () e selecionando Criado por.

Como atualizar uma fórmula mal configurada

  1. No Explore, clique no ícone de relatórios () para abrir a Biblioteca de relatórios.
  2. Clique na aba Atualizações obrigatórias.

  3. Clique em um dos relatórios listados para abri-lo.
  4. Para cada métrica calculada ou atributo:
    1. Clique na métrica ou no atributo e clique no ícone de lápis.
    2. 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.

    3. 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.
    4. 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.

    5. Opcionalmente, se você criou uma cópia da métrica ou do atributo, atualize a original.
  5. Salve o relatório

Como republicar os painéis afetados

  1. Clique no ícone de painel () para abrir a Biblioteca de painéis.
  2. Clique na aba Atualizações obrigatórias.
  3. Passe o mouse sobre um dos painéis e clique em Editar.
  4. 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.
  5. 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
  • 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

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
  • Operações aritméticas e junção de valor de texto
  • Funções

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(«
https://subdomain.zendesk
.com
/agent/organizations/” +
STRING([ID da organização do ticket]), [Nome da organização do ticket])

ou

LINK(«
https://subdomain.zendesk
.com
/agent/organizations/” +
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, 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. 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. Nesse caso, você precisa usar o agregador VALUE.

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

SE ([Status do ticket - Sem classificação] = "Solved" OU [Status do ticket - Sem classificação] = "Closed")
ENTÃO "Resolvido" OU "Não resolvido" 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.

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. 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, 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:

  • O atributo ou a métrica usada é outro conjunto de dados.
  • Há um erro de digitação no nome do atributo ou da métrica.
  • O nome do atributo ou da métrica não está escrito no idioma do perfil do usuário.
  • A fórmula faz referência a uma métrica ou atributo calculado que inclui aspas no nome. Remova as aspas para corrigir o erro.

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")
  • INCLUDES_ALL([Tags de ticket], "support", "sales")

  • IN([Grupo do ticket], ARRAY( "Support", "Sales"))

As funções INCLUDES são permitidas somente com os 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. Para realizar cálculos usando métricas calculadas de intervalo de datas, use umcálculo de métrica de resultado .

Powered by Zendesk