Como Usar a Função prop() no Notion Formula 2.0

Você quer referenciar o valor de uma propriedade dentro de uma expressão do Notion Formula 2.0. A função prop() é a única maneira de obter dados de uma coluna do banco de dados para uma fórmula. Sem prop(), sua fórmula não consegue acessar nenhuma propriedade, impossibilitando cálculos ou transformações. Este artigo explica como prop() funciona, como escrevê-la corretamente e como evitar erros comuns de sintaxe.

O que é a função prop() no Notion Formula 2.0?

O Notion Formula 2.0 é uma reescrita do mecanismo de fórmulas. No sistema original, você podia referenciar uma propriedade digitando seu nome diretamente. No Formula 2.0, toda referência a propriedade deve usar a função prop(). Essa mudança torna as fórmulas mais explícitas e fáceis de depurar. A função prop() recebe um argumento: o nome da propriedade como uma string de texto. Ela retorna o valor atual dessa propriedade para a linha onde a fórmula é avaliada.

A função diferencia maiúsculas de minúsculas. Se você escrever prop(“due date”) mas a propriedade se chama “Due Date”, a fórmula retorna um resultado vazio. O Notion não mostra um erro para um nome incompatível; ele simplesmente retorna um valor nulo. Essa falha silenciosa é o erro mais comum ao aprender prop().

prop() funciona com todos os tipos de propriedade: texto, número, data, seleção, seleção múltipla, caixa de seleção, URL, e-mail, telefone e relação. O tipo de retorno corresponde ao tipo da propriedade. Por exemplo, prop(“Preço”) retorna um número se a coluna Preço for uma propriedade numérica. Você pode então usar funções numéricas como round() ou add() nesse resultado.

Pré-requisitos para usar prop()

Antes de escrever uma fórmula com prop(), confirme duas coisas. Primeiro, seu banco de dados deve ter pelo menos uma propriedade com um nome definido. Segundo, a própria propriedade de fórmula deve estar configurada para Formula 2.0. Você pode verificar isso clicando na propriedade de fórmula e observando o editor. Se você vir uma opção chamada “Usar Formula 2.0” no topo do editor, certifique-se de que ela esteja ativada.

Passos para escrever uma fórmula usando prop()

1. Abra o banco de dados onde deseja adicionar a fórmula
   Navegue até a página do Notion que contém seu banco de dados. Clique em qualquer lugar dentro do banco de dados para selecioná-lo. Se você estiver criando uma nova propriedade de fórmula, deve estar em uma visualização do banco de dados, não em uma página avulsa.
2. Adicione uma nova propriedade de fórmula
   Clique no sinal de mais (+) no canto superior direito do banco de dados. Um menu aparece. Role para baixo e selecione Fórmula. Uma nova coluna aparece com um editor de fórmula vazio.
3. Ative o Formula 2.0
   Clique no cabeçalho da propriedade de fórmula para abrir o editor. No topo do editor, localize a opção Usar Formula 2.0. Clique para ativar. O fundo do editor muda ligeiramente para indicar que você está usando a nova sintaxe.
4. Digite a função prop()
   No editor de fórmula, digite prop(". Uma lista suspensa aparece mostrando todos os nomes de propriedades do seu banco de dados. Selecione a propriedade que deseja referenciar. O Notion insere o nome exato, incluindo espaços e capitalização. Feche a função com ).
5. Encadeie funções adicionais, se necessário
   Após prop() retornar um valor, você pode envolvê-lo com outras funções. Por exemplo, para converter um número em texto, use format(prop("Preço")). Para adicionar 7 dias a uma data, use dateAdd(prop("Data de Início"), 7, "days"). Digite a função externa primeiro e depois coloque prop() dentro dos parênteses dela.
6. Teste a fórmula
   Após escrever a fórmula, pressione Enter ou clique fora do editor. O Notion avalia a fórmula para cada linha. Verifique se a saída corresponde ao esperado. Se a coluna mostrar um valor em branco, verifique novamente o nome da propriedade dentro de prop().

Erros comuns ao usar prop()

A fórmula retorna valores vazios ou nulos

Isso acontece quando o nome da propriedade dentro de prop() não corresponde ao nome real da coluna. O Notion trata o nome da propriedade como texto que diferencia maiúsculas de minúsculas. Um espaço extra ou uma letra errada faz a função retornar nulo. Para corrigir, abra o editor de fórmula e apague o texto dentro de prop(). Em seguida, redigite prop(" e selecione a propriedade na lista suspensa. Não digite o nome manualmente a menos que tenha certeza da grafia exata.

Usar prop() em uma propriedade de rollup ou fórmula

prop() pode referenciar propriedades de rollup e fórmula, mas o valor obtido depende da origem. Se você referenciar uma propriedade de rollup, prop() retorna o valor agregado, não os dados originais vinculados. Se referenciar outra propriedade de fórmula, prop() retorna o resultado dessa fórmula. Isso pode criar referências circulares se duas fórmulas se referenciarem mutuamente. O Notion evita referências circulares mostrando um erro. Para evitar isso, referencie apenas propriedades de rollup ou fórmula que não dependam da fórmula atual.

Esquecer de ativar o Formula 2.0

Se a opção estiver desativada, o Notion usa a sintaxe antiga de fórmulas. Na sintaxe antiga, prop() não é reconhecida. O editor pode mostrar uma linha vermelha de erro sob prop(). Para corrigir, ative a opção. Se você tiver fórmulas existentes escritas na sintaxe antiga, ativar o Formula 2.0 pode quebrá-las. Você deve reescrever essas fórmulas para usar prop().

Item	Sintaxe Antiga (Formula 1.0)	Nova Sintaxe (Formula 2.0)
Referenciar uma propriedade	Digitar o nome da propriedade diretamente, ex.: Preço	Usar a função prop(), ex.: prop("Preço")
Diferenciação de maiúsculas/minúsculas	Não diferencia	Diferencia
Erro em nome incorreto	Mostra um erro vermelho	Retorna nulo silenciosamente
Compatibilidade com novas funções	Sem suporte para novas funções como dateAdd	Suporte total para todas as funções do Formula 2.0

Agora você pode referenciar qualquer propriedade em uma expressão do Notion Formula 2.0 usando prop(). Comece escrevendo uma fórmula simples que retorne o valor de uma única propriedade, como prop("Nome da Tarefa"). Depois experimente combinar prop() com funções como format(), contains() e dateBetween(). Um próximo passo útil é criar uma fórmula que calcule dias até um prazo usando dateBetween(prop("Data de Vencimento"), now(), "days").