Erro ‘Cannot Convert’ em Fórmula do Notion: Como Corrigir
🔍 WiseChecker

Erro ‘Cannot Convert’ em Fórmula do Notion: Como Corrigir

Você está trabalhando em uma fórmula de banco de dados do Notion e vê a mensagem de erro “Cannot Convert” em vez do resultado esperado. Esse erro ocorre quando uma fórmula tenta alterar um valor de um tipo de dado para outro de uma forma que o Notion não suporta. Este artigo explica as três principais causas desse erro e fornece correções detalhadas para cada uma. Após a leitura, você será capaz de identificar a incompatibilidade exata de tipo de propriedade e corrigir a sintaxe da sua fórmula.

Principais Conclusões: Corrigindo o Erro “Cannot Convert” em Fórmulas do Notion

  • Incompatibilidade de tipo da propriedade da fórmula: Certifique-se de que o tipo de saída da fórmula corresponde ao tipo esperado do valor que você está atribuindo. Use a função format() para converter um número em texto, ou toNumber() para converter texto em número.
  • Referência de propriedade incompatível: Uma fórmula que referencia uma propriedade com um tipo não suportado — como arquivo, imagem ou rollup — falhará. Use prop("Nome da Propriedade") apenas com tipos de propriedade compatíveis (texto, número, data, caixa de seleção, seleção, seleção múltipla).
  • Conflito de tipo em função aninhada: Funções como dateAdd(), dateSubtract() e replace() esperam tipos de entrada específicos. Verifique se o primeiro argumento é do tipo correto (data para funções de data, texto para funções de string).

Por que o Notion Mostra o Erro “Cannot Convert” em uma Fórmula

As fórmulas do Notion trabalham com tipos de dados estritos. Cada propriedade em um banco de dados tem um tipo: texto, número, data, caixa de seleção, seleção, seleção múltipla, relação, rollup, fórmula, arquivo, imagem, telefone, e-mail, URL ou pessoa. Quando uma fórmula tenta combinar ou converter valores que pertencem a tipos incompatíveis, o Notion exibe o erro “Cannot Convert”. A mensagem de erro às vezes inclui contexto adicional, como “Cannot convert ‘text’ to ‘number'”, o que ajuda a identificar o problema.

A causa raiz é sempre uma incompatibilidade entre o tipo de entrada esperado pela função da fórmula e o tipo real do valor passado. Por exemplo, a função dateAdd() espera uma data como primeiro argumento. Se você passar uma string de texto, o Notion não consegue converter e gera o erro. Da mesma forma, operadores matemáticos como + e - esperam números; usá-los em valores de texto falha. Entender esse sistema de tipos é o primeiro passo para corrigir o erro.

Três Cenários Comuns que Disparam o Erro

O erro aparece em três situações específicas:

  • Incompatibilidade direta de tipo: O tipo de saída da fórmula não corresponde ao tipo do valor que ela produz. Por exemplo, uma propriedade de fórmula definida como “Número” que retorna uma string de texto.
  • Referência de propriedade incompatível: A fórmula usa prop() para referenciar uma propriedade cujo tipo não pode ser convertido para o tipo necessário. Referenciar uma propriedade “Arquivos e Mídia” dentro de uma operação matemática causa o erro.
  • Argumento de função incorreto: Uma função recebe um argumento do tipo errado. replace() espera três argumentos de texto; passar um número como segundo argumento falha.

Depois de identificar qual cenário corresponde à sua fórmula, você pode aplicar a correção correspondente.

Passos para Corrigir o Erro “Cannot Convert” em Fórmulas do Notion

Correção 1: Ajuste o Tipo de Saída da Fórmula

  1. Abra o banco de dados e localize a propriedade da fórmula
    Vá para o seu banco de dados do Notion. Clique no cabeçalho da propriedade da coluna de fórmula que mostra o erro. Selecione Editar propriedade no menu.
  2. Verifique a configuração do tipo da propriedade da fórmula
    No editor de propriedades, procure o menu suspenso Tipo. Ele mostra o tipo de saída esperado para a fórmula. As opções incluem Número, Texto, Data, Caixa de seleção e outras. Certifique-se de que esse tipo corresponde ao que sua fórmula realmente retorna.
  3. Altere o tipo para corresponder à saída da fórmula
    Se sua fórmula produz uma data, mas o tipo está definido como Número, altere o tipo para Data. Ou, se a fórmula retorna uma string de texto, mas o tipo está definido como Número, altere para Texto. Após a alteração, o erro deve desaparecer.
  4. Use funções de conversão explícitas, se necessário
    Se você não puder alterar o tipo de saída porque outras fórmulas dependem dele, envolva o resultado em uma função de conversão. Para converter um número em texto, use format(prop("Propriedade Numérica")). Para converter texto em número, use toNumber(prop("Propriedade de Texto")).

Correção 2: Remova ou Substitua Referências de Propriedade Incompatíveis

  1. Identifique qual referência de propriedade causa o erro
    Examine cada prop("Nome da Propriedade") em sua fórmula. Observe o tipo de cada propriedade referenciada. Passe o mouse sobre o nome da propriedade no editor de fórmulas para ver seu tipo.
  2. Substitua tipos de propriedade não suportados
    Propriedades do tipo Arquivo, Imagem, Telefone, E-mail, URL, Pessoa, Relação ou Rollup não podem ser usadas diretamente na maioria das fórmulas. Se você precisar do valor, extraia um subvalor compatível. Para uma propriedade Pessoa, use prop("Pessoa").first().name para obter o nome como texto. Para uma Relação, use prop("Relação").first().prop("Nome") para obter o título de uma página vinculada.
  3. Remova a referência incompatível se não for necessária
    Se a fórmula não precisar dessa propriedade, exclua a referência prop(). Por exemplo, se você incluiu acidentalmente prop("Imagem") em uma fórmula matemática, remova-a.

Correção 3: Corrija os Tipos dos Argumentos das Funções

  1. Verifique os requisitos de argumento de cada função
    Consulte a documentação de fórmulas do Notion para cada função que você usa. Por exemplo, dateAdd(data, número, string) requer uma data, um número e uma string de unidade como “days”. replace(texto, texto, texto) requer três valores de texto.
  2. Envolva argumentos em conversores de tipo
    Se um argumento for do tipo errado, use format() para converter um número em texto, ou toNumber() para converter texto em número. Para conversões de data, use fromTimestamp() ou parseDate() quando necessário.
  3. Teste cada função separadamente
    Simplifique sua fórmula para uma única chamada de função. Teste com valores estáticos — por exemplo, dateAdd(now(), 3, "days"). Se funcionar, adicione gradualmente outras partes até encontrar o argumento exato que causa o erro.

Se o Notion Ainda Mostrar “Cannot Convert” Após a Correção Principal

A fórmula referencia um rollup com uma agregação incompatível

Propriedades rollup podem agregar valores de bancos de dados relacionados. Se o método de agregação do rollup produzir um tipo que sua fórmula não consegue manipular, o erro persiste. Por exemplo, um rollup configurado como “Mostrar original” retorna um array, não um valor único. Envolva a referência do rollup em first() ou join() para obter um valor único do tipo correto.

A fórmula usa uma propriedade de seleção ou seleção múltipla sem extrair o nome

Propriedades de seleção e seleção múltipla retornam objetos, não texto simples. Quando você usa prop("Propriedade de Seleção") em uma fórmula de texto, o Notion não consegue converter o objeto em texto. Use prop("Propriedade de Seleção").name para extrair o nome da opção como texto. Para seleção múltipla, use prop("Propriedade de Seleção Múltipla").first().name ou join(prop("Propriedade de Seleção Múltipla").map(current.name), ", ").

A fórmula contém uma função aninhada que retorna uma incompatibilidade de tipo

Às vezes, a função externa recebe um valor de uma função interna que não é do tipo esperado. Por exemplo, format(dateAdd(now(), 3, "days")) funciona, mas dateAdd(format(now()), 3, "days") falha porque format() retorna texto, não uma data. Verifique o tipo de retorno de cada função aninhada e certifique-se de que corresponde ao requisito de entrada da função externa.

Causas e Correções do Erro de Fórmula do Notion Comparadas

Cenário de Erro Causa Correção
Tipo da fórmula definido como Número, mas retorna texto Incompatibilidade de tipo de saída nas configurações da propriedade Altere o tipo da propriedade para Texto ou envolva o resultado em toNumber()
prop("Imagem") usado em uma fórmula matemática Tipo de propriedade incompatível (Arquivo/Imagem) Remova a referência ou substitua por um valor extraído compatível
dateAdd(prop("Data em Texto"), 1, "days") Função espera data, mas recebe texto Use parseDate() para converter texto em data primeiro
replace(prop("Número"), "a", "b") Função espera texto, mas recebe número Use format(prop("Número")) para converter em texto
Propriedade rollup usada diretamente sem agregação Rollup retorna um array (Mostrar original) Adicione first() ou join() para extrair um valor único

A tabela acima resume os três principais cenários que você encontrará. Corresponder seu erro a uma dessas linhas fornece um caminho direto de correção.

Conclusão

Agora você pode identificar por que o Notion mostra o erro “Cannot Convert” e aplicar a correção correta. Verifique primeiro o tipo de saída da propriedade da fórmula, depois inspecione cada referência prop() em busca de tipos incompatíveis e, por fim, verifique os tipos dos argumentos das funções. Use format(), toNumber(), parseDate() e .name para converter valores entre tipos. Para fórmulas complexas, teste cada função individualmente para isolar o argumento problemático. Se você trabalha com rollups ou propriedades de seleção múltipla, lembre-se de extrair valores únicos antes de usá-los em cálculos.