Passar para o conteúdo principal

O campo Cálculo

Exiba um valor calculado automaticamente a partir de uma fórmula e configure o resultado, a fórmula, as condições, a exibição e a etiqueta de exportação.

Apresentação do campo Cálculo

O campo Cálculo exibe um valor calculado automaticamente a partir de uma fórmula, que pode utilizar os valores de outros campos do formulário.

Ele permite principalmente:

  • efetuar operações simples: adição, subtração, multiplicação, divisão;

  • calcular um total, uma média, um mínimo ou um máximo na coluna de uma tabela;

  • calcular uma duração entre duas horas ou duas datas;

  • utilizar funções matemáticas: potência, raiz quadrada, logaritmo, arredondamentos…;

  • obter um resultado diferente de acordo com uma ou várias condições;

  • juntar texto e valores em um mesmo resultado.

Adicionar o campo a um formulário

Na tela de criação de formulário, seja o formulário novo ou já existente, o catálogo de campos, à esquerda, os organiza em nove categorias. Apenas uma categoria fica aberta por vez: clique no nome dela para abri-la. O campo Cálculo é o único campo da categoria Cálculo. Ao passar o mouse sobre o campo, aparece uma breve descrição.

Há três formas de adicionar o campo:

  • Um clique em Cálculo: o campo é inserido logo após o campo selecionado. Se nenhum campo estiver selecionado, ele é adicionado no final do formulário.

  • Arrastar e soltar a partir do catálogo até o local desejado. Durante o movimento, as zonas de inserção aparecem em linhas pontilhadas.

  • O botão + que aparece abaixo do campo sobrevoado ou selecionado: ele abre um menu com uma pesquisa para inserir um campo exatamente nesse local.

Assim que é adicionado, o título do campo entra no modo de edição: digite o nome dele e confirme com a tecla Enter. Para renomeá-lo depois, clique duas vezes no nome. A Pré-visualização móvel é atualizada a cada modificação.

Acessar as opções do campo

Na área de edição, clique duas vezes no campo ou clique no ícone de lápis (Modificar). As opções são exibidas em forma de cartões.

Eles aparecem nesta ordem: Essencial, Fórmula, Condições de visibilidade, Exibição e disposição e Recursos Avançados, seguidos do Identificador técnico.

Não há botão de validação: cada configuração é aplicada imediatamente e a indicação ✓ Modificado aparece a cada alteração. Para navegar nas opções:

  • Desfazer (a seta no topo) ou Ctrl+Z: volta atrás.

  • ↑ e ↓ no cabeçalho: passam para o campo anterior ou seguinte, sem voltar ao formulário.

  • Voltar (a seta no canto superior esquerdo): sai das opções e volta ao formulário.

ℹ️ Bom saber
Apenas o botão Salvar grava definitivamente o formulário. Enquanto você não salvar, nada é enviado para os celulares.

Enquanto as opções estiverem abertas, o catálogo fica acinzentado. Feche-as para adicionar um novo campo.

Essencial

Este cartão reúne as configurações básicas do campo. Como o valor é calculado automaticamente, ele não oferece a opção Entrada obrigatória.

  • Título do campo: por padrão, ele tem o nome do tipo de campo ("Cálculo"), mas você pode modificá-lo.

  • Escolher um ícone (o botão à esquerda do título): exibe um ícone antes do título do campo, tanto no aplicativo móvel quanto na Entrada Web. Os ícones são organizados por temas (Estados e alertas, Setas e navegação, Pessoas e gênero etc.) e há uma pesquisa em inglês disponível. Nenhum ícone remove o ícone.

  • Tipo de resultado: Número ou Hora.

  • Número de decimais: número de algarismos exibidos depois da vírgula.

  • Resultado modificável: o usuário pode corrigir manualmente o resultado calculado.

  • Texto de ajuda exibido no celular: insira uma instrução destinada aos seus usuários. Durante o preenchimento, ela pode ser consultada tocando no ponto de interrogação exibido à direita do título do campo.

Fórmula

Este cartão contém a área de digitação da fórmula. Você pode escrever a fórmula diretamente ou montá-la com a ajuda da barra de ferramentas localizada acima.

A barra de ferramentas

Botão

Função

Campo

Insere o valor de um campo do formulário. O campo aparece na fórmula entre colchetes, por exemplo [Quantidade].

Função

Insere uma função: soma, média, arredondamento, condição…

+ − × ÷

Inserem uma adição, uma subtração, uma multiplicação ou uma divisão. O sinal + também permite juntar texto e valores.

Se…

Abre um assistente para montar uma condição.

Texto

Insere um valor de texto, entre aspas.

⋯

Dá acesso aos outros operadores: Módulo, comparações e operadores lógicos. Uma pesquisa permite encontrá-los rapidamente.

Abaixo da fórmula, uma mensagem indica se ela é válida e quantos campos ela utiliza, por exemplo "Fórmula válida · 2 campo(s) referenciado(s)". Se a fórmula estiver incompleta, a mensagem "Expressão incompleta ou inválida." aparece em vermelho.

Os campos utilizáveis

O botão Campo oferece apenas os campos utilizáveis em um cálculo: campos de entrada, quadros de seleção, deslizadores, contadores, datas e horas, listas, escolhas únicas, referências, códigos de barras, marcadores NFC… A lista depende da localização do campo Cálculo:

  • fora de uma tabela: apenas os campos fora de tabela são oferecidos;

  • em uma tabela: as colunas dessa tabela são oferecidas além dos campos fora de tabela.

ℹ️ Bom saber
Para utilizar a coluna de uma tabela a partir de um campo Cálculo colocado fora da tabela, use as funções da categoria TABELAS (Soma, Média, Mínimo, Máximo).

As funções

O botão Função organiza as funções por tema, com uma pesquisa. O nome técnico de cada função é indicado abaixo do seu nome: é ele que aparece na fórmula. Posicione-se entre os parênteses de uma função para digitar um valor ou inserir um campo.

Tema

Função

Papel

Tabelas

Soma sum()

Soma os valores de uma coluna de tabela

Tabelas

Média avg()

Calcula a média dos valores de uma coluna de tabela

Tabelas

Mínimo min()

Retorna o menor valor de uma coluna de tabela

Tabelas

Máximo max()

Retorna o maior valor de uma coluna de tabela

Arredondamentos

Arredondamento para cima ceil()

Arredonda para o número inteiro superior

Arredondamentos

Arredondamento para baixo floor()

Arredonda para o número inteiro inferior

Matemática

Raiz quadrada sqrt()

Calcula a raiz quadrada de um valor

Matemática

Potência pow(x,y)

Eleva x à potência y

Matemática

Cosseno cos(), Seno sin()

Calcula o cosseno ou o seno de um valor

Matemática

Logaritmo natural log(), Exponencial exp()

Calcula o logaritmo natural ou a exponencial de um valor

Especiais

Identificador único unique_id

Gera um valor a partir da data, da hora e do identificador do usuário

Especiais

Condição if

Retorna um valor se a condição for verdadeira e outro se for falsa

Especiais

Condições em cascata ifs

Testa várias condições em ordem e retorna o valor da primeira condição verdadeira

Especiais

ItemRefNum item_ref_num

Lê o valor de uma coluna de lista, como um campo Referência, geralmente a partir de um Marcador NFC ou de um campo de entrada

Montar uma condição

O botão Se… abre um assistente que monta a condição para você, sem precisar digitar a sintaxe. Ele é composto de três partes:

  • SE: escolha um campo, um operador (=, ≠, <, ≤, >, ≥, está vazio, não está vazio) e um valor, outro campo ou um texto.

  • ENTÃO: resultado se a condição for verdadeira, digitado diretamente ou escolhido com o botão Campo.

  • SENÃO: resultado se a condição for falsa, digitado diretamente ou escolhido com o botão Campo.

Para combinar várias condições, clique em Adicionar uma condição e, em seguida, escolha como vinculá-las:

  • E: todas as condições devem ser verdadeiras;

  • OU: basta uma condição verdadeira.

A fórmula correspondente aparece acima do botão Inserir a condição. De acordo com a sua escolha, E aparece na forma && e OU na forma ||.

A captura abaixo mostra a preparação de um cálculo condicional com duas condições, vinculadas por E.

Em seguida, clique em Inserir a condição: ela é adicionada à fórmula com a função if. Veja o resultado depois que a condição é inserida.

Digitar uma condição manualmente

Você também pode escrever a condição diretamente na fórmula, na forma if(condição, valor_se_verdadeiro, valor_se_falso).

O assistente só oferece um resultado ENTÃO e um resultado SENÃO. Para obter um resultado diferente de acordo com a condição atendida, digite a função ifs:

ifs(condição1, valor1, condição2, valor2, …, valor_senão)

Por exemplo, ifs([Quantidade] > 100, [Preço] * 0.8, [Quantidade] > 10, [Preço] * 0.9, [Preço]):

  • se a quantidade for maior que 100, o preço é multiplicado por 0,8;

  • caso contrário, se for maior que 10, o preço é multiplicado por 0,9;

  • caso contrário, o preço é exibido como está.

O último valor (aqui [Preço]) é obrigatório: é o resultado quando nenhuma condição é atendida.

Os operadores

A tabela abaixo lista os operadores utilizáveis para digitar uma fórmula manualmente. Eles também estão disponíveis na barra de ferramentas.

Tipo

Operador

Papel

Aritmético

+ - * /

Adição (ou junção de texto), subtração, multiplicação, divisão

Aritmético

%

Módulo: resto de uma divisão

Comparação

== !=

Igual a, diferente de

Comparação

< <=

Menor que, menor ou igual a

Comparação

> >=

Maior que, maior ou igual a

Lógico

&&

E lógico: todas as condições devem ser verdadeiras

Lógico

||

OU lógico: basta uma condição verdadeira

Lógico

!

NÃO lógico (a digitar na fórmula)

Lógico

? :

Condição ternária (a digitar na fórmula): (condição) ? valor_se_verdadeiro : valor_se_falso

Condições de visibilidade

Três modos são propostos:

  • Sempre visível: o campo sempre aparece durante o preenchimento.

  • Visível se: o campo só é exibido quando as condições que você definiu são atendidas.

  • Sempre oculto: o campo nunca é exibido durante o preenchimento, mas continua utilizável nas exportações.

Para o detalhe da configuração das condições, consulte o tutorial As condições de visibilidade.

Exibição e disposição

Este cartão personaliza a exibição do campo no aplicativo móvel.

  • Cor do título: escolha entre as cores propostas. A primeira opção, riscada, corresponde à ausência de cor.

  • Tamanho do título do campo: mova o cursor entre Aa (menor) e Aa (maior). A pré-visualização indica o tamanho obtido em pixels (11 px por padrão). Ele se aplica à fonte do título exibido no celular.

  • Na mesma linha que o campo anterior: esta opção coloca o campo ao lado do anterior. Ela exige que a opção que permite exibir vários campos em uma linha esteja ativada nas configurações do aplicativo móvel.

Recursos Avançados

  • Apenas leitura durante uma modificação: o campo continua visível, mas não pode mais ser modificado quando o dado é reaberto para edição.

  • Dado pessoal (LGPD): esta opção marca o campo como dado pessoal. O conteúdo dele fica então parcialmente oculto no histórico de dados: apenas os 3 últimos caracteres permanecem visíveis. Um clique no ícone de olho exibe o dado por completo: qualquer pessoa com acesso ao dado sempre pode, portanto, consultá-lo por completo.

  • Word: excluir a linha se estiver vazia: em uma exportação Word, o parágrafo que contém a etiqueta do campo é removido se o campo estiver vazio.

    Para saber mais, consulte o tutorial Marcações/etiquetas Block e exclusão de parágrafo.

Identificador técnico e etiqueta

Abaixo dos recursos avançados, o campo Identificador técnico exibe o identificador do campo. Ele é utilizado como está nos cálculos e nas automações.

A etiqueta a ser utilizada nas suas exportações personalizadas aparece logo abaixo: ##calculo2##, por exemplo. Um clique na etiqueta a copia.

As etiquetas são sempre delimitadas por duas cerquilhas (##). Para personalizá-las de acordo com as suas necessidades, consulte o tutorial Utilizar as etiquetas para personalizar as exportações.

💡 Dica

O identificador técnico, e portanto a etiqueta, só pode ser modificado enquanto o formulário não tiver sido salvo. Recomendamos personalizá-lo antes de salvar pela primeira vez.

Os casos de uso

O campo Cálculo atende a muitas necessidades. Os tutoriais a seguir detalham as mais comuns:

  • Contar o número de linhas de uma tabela

  • Controle de conformidade

  • Gerar um código de barras para uma exportação personalizada

  • Fazer um registro de horas com cálculos automáticos

  • Gerar um link que permite abrir o Google Maps

  • Criar um identificador personalizado

  • Gerar uma pontuação ou uma avaliação automática de acordo com critérios

  • Calcular o valor total de um orçamento

📚 Para saber mais

Encontre todos os tutoriais da coleção Casos de uso do campo Cálculo. Eles são fáceis de identificar: o nome deles começa com ✨.

Respondeu à sua pergunta?