Skip to main content
Todo campo de uma tabela (texto, número, moeda, data, seleção, etiqueta e os demais tipos) pode ser preenchido por uma pessoa ou pelo próprio Brainchat. Você escolhe isso no editor da coluna, em Comportamento → Como o campo é preenchido.

As três formas de preencher um campo

Exemplos:
Um campo com fórmula nunca é obrigatório: como ninguém o preenche, a opção de obrigatoriedade deixa de valer para ele.

Como escrever uma fórmula

  • Campos vão entre colchetes, pelo nome da coluna: [Valor], [Data de entrega].
  • Textos vão entre aspas: "Pago".
  • Funções têm nomes em inglês, no estilo do AppSheet: IF, SUM, LOOKUP, TODAY. Veja todas na Referência de funções.
  • Argumentos são separados por vírgula. Ponto e vírgula também é aceito.
  • Verdadeiro e falso são TRUE e FALSE.
  • Operadores: + - * / para contas, & para juntar textos, = <> < > <= >= para comparar.
  • [_THISROW].[Coluna] volta ao registro atual dentro de uma condição que percorre outra tabela (por exemplo, em SELECT).
O editor da fórmula sugere campos e funções enquanto você digita e aponta erros antes de salvar.

Fórmula gravada e fórmula calculada na hora

Gravada (padrão). O Brainchat calcula o valor em segundo plano sempre que o registro muda ou que muda algo em uma tabela que a fórmula lê. Como o resultado fica guardado no registro, ele funciona em todo lugar: grade, Kanban, ficha do registro, Studio, filtros, ordenação, exportação e API. Calculada na hora. Fórmulas que usam TODAY() ou NOW(), e campos que dependem delas, mudam de valor só com a passagem do tempo. Por isso, elas são calculadas no momento em que o registro é lido, e não gravadas. Exemplo: DAYS([Prazo], TODAY()) (dias até o prazo). Você não precisa escolher: o editor identifica o modo sozinho e mostra abaixo da fórmula se ela é gravada ou calculada na hora.

Recálculo da tabela inteira

Quando você cria ou altera uma fórmula em uma tabela com muitos registros, o Brainchat recalcula a tabela inteira em segundo plano. Enquanto isso:
  • A tela da tabela mostra o aviso “Calculando fórmulas: X de Y registros” com uma barra de progresso.
  • O campo fica vazio nos registros que o cálculo ainda não alcançou.
  • A tabela continua funcionando normalmente: dá para consultar, editar e criar registros.
Em tabelas grandes, revise a fórmula com calma antes de salvar: cada alteração recomeça o recálculo de todos os registros.

Ler dados de outras tabelas

Uma fórmula pode buscar e somar dados de outras tabelas da mesma organização.

Buscar um valor: LOOKUP

Exemplo: trazer o CPF da tabela “Cadastros” pelo e-mail do registro atual:
O primeiro [E-mail] é a coluna da tabela “Cadastros” onde procurar; o segundo é o e-mail do registro atual. Se nenhuma linha combinar, o resultado fica vazio.
  • LOOKUP_ALL tem os mesmos argumentos e devolve uma lista com o valor de todas as linhas que combinam.
  • SELECT("Tabela", [coluna], condição) devolve a lista dos valores de uma coluna nas linhas que atendem a uma condição. Exemplo: SUM(SELECT("Itens", [Total], [Pedido] = [Número])).
A ordem dos argumentos de LOOKUP e SELECT é a do Brainchat, diferente do AppSheet. No Brainchat, o nome da tabela vem sempre primeiro: LOOKUP("Tabela", [coluna de busca], valor, [coluna de retorno]) e SELECT("Tabela", [coluna], condição). Se você copiar uma fórmula do AppSheet, reorganize os argumentos.

Somar e resumir registros relacionados

Use [Relação].FUNÇÃO(...), em que [Relação] pode ser:
  • uma coluna de conexão do registro atual (os registros ligados a ele); ou
  • o nome de outra tabela que tem uma conexão apontando para esta (os registros de lá que apontam para o registro atual).
As funções aceitas depois do ponto são SUM, SUMUNIQUE (soma uma vez por chave), COUNT, AVERAGE, MAX, MIN, FIRST, LIST, UNIQUE, MAXBY e MINBY. A condição, quando houver, vai como último argumento. MAXBY e MINBY trazem outro campo do registro com o maior (ou menor) valor: [Agendamentos].MAXBY([Data], [Unidade]) devolve a Unidade do agendamento com a Data mais recente. Para limitar, acrescente a condição como terceiro argumento: [Agendamentos].MAXBY([Data], [Unidade], [Status] = "Realizado").

Nome da tabela

As tabelas são citadas pelo nome, entre aspas. O editor guarda a referência à tabela e sempre mostra o nome atual, então renomear uma tabela não quebra as fórmulas que a usam.

Quem pode citar outra tabela

  • Ao salvar a fórmula, só podem ser citadas tabelas da mesma organização que você consegue ler.
  • Depois de salva, quem vê o registro vê o valor calculado, mesmo sem acesso à tabela de origem (como no AppSheet). Pense nisso antes de trazer dados sigilosos para uma tabela com acesso mais amplo.

Atributos do registro

Todo registro tem atributos fixos, que não fazem parte das colunas da tabela: Código, Criado em, Atualizado em, Criado por e Atualizado por. Eles são preenchidos pelo sistema; você só escolhe mostrar ou esconder cada um. Quando um fluxo do Flow cria ou altera o registro, Criado por e Atualizado por mostram o fluxo, como se ele fosse uma conta de serviço. Gravações da API, de sincronização ou do agente aparecem sem autor (feitas pelo sistema). Nas expressões, use: Exemplo de fórmula: dias desde a criação do registro, DAYS(TODAY(), CREATED_AT()).
As funções de pessoa (USERID(), USEREMAIL(), USERNAME(), USERROLE()) indicam quem cria o registro em Valor inicial e quem vê ou age nas regras de exibição, edição e validação. Em um campo com Fórmula e em gravações sem pessoa (Flow, API, agendamento) elas ficam vazias. Para guardar quem criou o registro, use Valor inicial USEREMAIL() ou mostre o atributo Criado por.

Datas e fuso horário

Todas as datas das fórmulas (TODAY(), NOW(), dia, mês, hora, diferença entre datas) usam o fuso horário da organização, e não o do computador de quem está vendo.

No Flow

O Flow usa as mesmas expressões:
  • nas condições de passos e caminhos;
  • dentro de qualquer texto, com {{=expressão}}.
No Flow, os campos são citados pelo caminho, com pontos: [trigger.row_data.valor]. Exemplo de mensagem com o total calculado:

Filtrar a Busca com uma expressão

No passo Buscar registro, o campo Só registros em que aceita uma expressão avaliada em cada registro da tabela. Os campos do registro são citados pelo nome da coluna; os dados do fluxo, pelo caminho:
As datas usam o fuso da organização. A tabela é lida em páginas; quando a expressão compara uma coluna com um valor fixo ou do fluxo ([Cliente] = ...), essa parte já filtra no banco.
TODAY() e NOW() não disparam um fluxo sozinhos: o valor muda com o tempo, mas o registro não é alterado. Para agir sobre registros vencidos, crie um fluxo Em um horário (por exemplo, todo dia às 7h) com uma Busca filtrada por [Vencimento] < TODAY() e uma Repetição sobre os registros encontrados.

Quem criou e quem alterou o registro

Em fluxos disparados por uma tabela, o gatilho traz quem criou e quem alterou o registro: Para o fluxo só rodar quando uma pessoa alterou o registro (e não outro fluxo), use no filtro do gatilho: trigger.updated_by.kind é igual a person.

Erros comuns


Próximo passo

Referência de funções

Todas as funções disponíveis, com exemplos.