Use referências de campo, literais, operadores e funções para criar fórmulas para campos calculados no Adobe Acrobat Sign.
Insira fórmulas na propriedade Fórmula de um campo configurado com Tipo de valor > Calculado. Esta referência descreve a sintaxe de expressão disponível para criar essas fórmulas.
Para configurar o próprio campo, consulte Criar um campo calculado.
Criar uma fórmula
Uma fórmula pode conter um ou mais destes elementos:
| Elemento | Use-o para | Exemplo |
|---|---|---|
| Referência de campo | Usar um valor de outro campo | preço * quantidade |
| Literal | Incluir um número fixo, valor de texto ou data | total * 0.10 |
| Operador | Realizar operações aritméticas, de comparação ou de texto | subtotal + impostos |
| Função | Realizar um cálculo predefinido ou uma operação lógica | max(value1, value2) |
As fórmulas também podem fazer referência a outros campos calculados.
Referenciar campos pelo nome
Use o nome do campo para referenciar seu valor em uma fórmula.
Por exemplo:
preço * quantidade
utiliza os valores dos campos denominados preço e quantidade.
Se o nome de um campo contiver espaços, coloque o nome completo entre colchetes:
[Unit price] * quantidade
Use nomes de campos significativos e exclusivos para que as fórmulas continuem compreensíveis mesmo quando o formulário for alterado.
Consulte Propriedades de campo de formulário para saber os requisitos de nome de campo.
Usar valores literais
Um literal é um valor fixo incluído diretamente na fórmula.
Alguns exemplos incluem:
- Números: 10
- Texto: “Aprovado”
- Datas usadas pelas funções de data compatíveis.
Coloque as cadeias de texto entre aspas simples ou duplas.
Por exemplo:
"Aprovado"
Valores literais podem ser combinados com campos, operadores e funções.
Operadores compatíveis
Use operadores para realizar cálculos, combinar texto ou comparar valores.
| Operador | Operação |
|---|---|
| + | Adicionar |
| - | Subtrair |
| / | Dividir |
| * | Multiplicar |
| & | Combinar strings de texto |
| = | Igual a |
| != | Não é igual a |
| < | Menor que |
| <= | Menor que ou igual a |
| > | Maior que |
| >= | Maior que ou igual a |
| % | Retornar o resto da divisão |
| ^ | Elevar um valor a uma potência |
Operadores de comparação retornam um resultado verdadeiro ou falso e podem ser usados dentro de funções lógicas.
Por exemplo:
total >= 1000
avalia se o valor de total é pelo menos 1000.
Funções matemáticas
| Função | Resultado |
|---|---|
| abs(number1) | Retorna o valor absoluto de um número. |
| roundUp(number1) | Arredonda um número para cima. |
| roundDown(number1) | Arredonda um número para baixo. |
| round(number1) | Arredonda um número para o inteiro mais próximo. |
| min(number1, number2) | Retorna o menor de dois números. |
| max(number1, number2) | Retorna o maior de dois números. |
Exemplo
max(Amount1, Amount2)
retorna o maior entre os dois valores de campo.
Funções de data.
| Função | Resultado |
|---|---|
| datePart(part, date) | Retorna uma parte especificada de uma data como um número inteiro. |
| dateAdd(part, date, addition) | Adiciona um número especificado de partes de data a uma data. Use um valor negativo para subtrair. |
| dateDiff(part, date1, date2) | Retorna a diferença entre duas datas utilizando a parte da data especificada. |
| daysIn(part, date) | Retorna o número de dias na parte especificada de uma data. |
| date(string) | Converte um valor de texto que representa uma data em um valor de data que pode ser usado por outras funções. |
| now() | Retorna a data e a hora quando a fórmula é avaliada. |
Valores da parte da data
Use esses valores para o argumento de parte nas funções de data compatíveis:
| Valor | Parte da data ou da hora |
|---|---|
| y | Ano |
| q | Trimestre |
| m | Mês |
| d | Dia |
| h | Hora |
| n | Minuto |
| s | Segundo |
Exemplo
dateAdd("d", StartDate, 30)
adiciona 30 dias ao valor do campo StartDate.
Use um número negativo para calcular uma data anterior:
dateAdd("d", StartDate, -7)
Funções lógicas
Use funções lógicas quando um valor calculado depende de uma ou mais condições.
| Função | Resultado |
|---|---|
| if(logical_test, value_if_true, value_if_false) | Retorna um valor quando o teste é verdadeiro e outro quando é falso. |
| and(logical1, logical2, ...) | Retorna verdadeiro somente quando todas as condições especificadas forem verdadeiras. |
| or(logical1, logical2, ...) | Retorna verdadeiro quando pelo menos uma das condições especificadas for verdadeira. |
| not(logical) | Inverte um resultado verdadeiro ou falso. |
| lookup(sourceField, values, default_value) | Retorna um valor associado ao campo de origem ou um valor padrão quando não for encontrada nenhuma correspondência. |
Use if para escolher entre os resultados
Por exemplo:
if(Total >= 1000, "Aprovação necessária", "Aprovado")
retorna um valor de texto quando Total é pelo menos 1000 e outro quando não é.
Os resultados verdadeiro e falso também podem conter expressões.
Combinar testes lógicos (and, or, not)
Use e quando todas as condições precisarem ser verdadeiras:
and(Age >= 18, Consent = "Yes")
Use or quando qualquer condição puder ser verdadeira:
or(State = "CA", State = "OR")
Use not quando precisar do oposto de uma condição:
not(Status = "Closed")
Mapeie um valor para outro usando a função de pesquisa
Use lookup quando um valor de origem deve retornar um valor correspondente.
Por exemplo:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
retorna o nome do estado mapeado quando existe uma combinação e Other quando não existe.
Isso é útil quando o valor de origem vem de um conjunto definido de escolhas, como um campo Lista suspensa ou Botão de opção.
Exemplos de fórmula
Calcular um valor
quantidade * [Preço unitário]
Multiplica uma quantidade por um preço unitário.
Adicionar vários valores
subtotal + tax + shipping
Adiciona valores de três campos.
Calcular uma porcentagem
subtotal * taxRate
Multiplica um campo por uma taxa armazenada em outro campo.
Retornar um valor condicionalmente
if(quantidade >= 10, [Preço unitário] * 0.9, [Preço unitário])
retorna um valor com desconto quando a quantidade atinge o limite definido.
Calcular uma data futura
dateAdd("m", StartDate, 12)
retorna uma data 12 meses após StartDate.
Combinar texto
RecipientName & " - " & Company
combina valores de campo e texto literal em um único resultado.
Criar fórmulas mais fáceis de manter
Use nomes de campo descritivos e mantenha os cálculos relacionados tão simples quanto o formulário permitir.
Ao revisar uma fórmula, confirme que:
- Todos os campos referenciados existem.
- Os nomes de campo correspondem aos nomes usados na fórmula.
- Os campos que contêm espaços são colocados entre colchetes.
- Os textos literais são colocados entre aspas.
- As funções contêm os argumentos necessários.
- O campo calculado produz o valor desejado para as entradas previstas do destinatário.
Para configurar o campo calculado e formatar resultados de Número, consulte Criar um campo calculado.
Simplifique seu trabalho com o Acrobat Sign
Gerencie e assine documentos online de forma rápida e fácil.
