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
TRUEeFALSE. - Operadores:
+ - * /para contas,¶ juntar textos,= <> < > <= >=para comparar. [_THISROW].[Coluna]volta ao registro atual dentro de uma condição que percorre outra tabela (por exemplo, emSELECT).
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 usamTODAY() 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.
Ler dados de outras tabelas
Uma fórmula pode buscar e somar dados de outras tabelas da mesma organização.Buscar um valor: LOOKUP
[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_ALLtem 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])).
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}}.
[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:[Cliente] = ...), essa parte já filtra no banco.
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.