Guia do Usuário Cancelar

Adicionar campos calculados a um formulário

 

Guia do Adobe Acrobat Sign

Novidades

Introdução

Administrar

Enviar, assinar e gerenciar contratos

Recursos e fluxos de trabalho avançados de contratos

Integrar a outros produtos

Acrobat Sign Developer

Suporte e solução de problemas

Campos calculados são parte de formulários Avançados e, como tal, estão incluídos somente com os níveis de serviço de várias licenças.


Visão geral

O Adobe Acrobat Sign fornece a capacidade de atualizar dinamicamente os campos em um documento (contrato) com base nos dados inseridos pelo signatário no momento da assinatura. Isso pode ser feito com Campos calculados. Você pode usar campos calculados para configurar regras dentro de um documento (ou um modelo de documento) antes de enviá-lo para assinatura. Essas regras são processadas quando o signatário interage com o documento e o atualiza dinamicamente com base nos campos/valores.

Os campos calculados podem ser definidos em documentos usando qualquer um dos seguintes mecanismos:


Casos de uso dos campos calculados

Os campos calculados podem ser usados em todos os cenários nos quais o documento precisa ser atualizado dinamicamente na hora da assinatura. Abaixo estão algumas amostras de casos de uso dos campos calculados. Esses casos de uso são apenas para fins de ilustração.

1. Configuração de um formulário de pedido – Os campos calculados podem ser usados para criar um formulário de pedido no qual o signatário tem a opção de escolher de uma lista de itens disponíveis e especificar uma quantidade. Selecionar um item na lista atualiza o formulário com o preço do item selecionado de forma automática. A quantidade selecionada pelo signatário também resulta no custo total do item calculado. O formulário também pode incorporar cálculos adicionais para determinar o imposto total do pedido ou calcular um desconto de volume com base nas regras da empresa de oferta de descontos para clientes.

2. Preenchimento automático da data de expiração do termo de contrato – Para contratos que permitem que os usuários escolham o extensão do termo na hora da assinatura (6 mês, 12 mês, 24 mês etc.), é possível usar um campo calculado para preencher de forma automática a data final do contrato com base nessa escolha.

3. Formulários de cadastro com várias opções – Um campo calculado pode ser usado para configurar formulários de cadastro (como formulários de associação) no qual a pessoa que assina o formulário pode escolher de um conjunto de opções disponíveis. As opções feitas pelo signatário podem influenciar outros aspectos dinâmicos do formulário, como os termos com os quais o signatário está concordando, a duração do contrato e também o custo total.


Noções básicas de campos calculados

Qualquer campo de formulário, campo de caixa de seleção ou campo do botão de opção em um formulário do Acrobat Sign pode ser marcado como um campo calculado. Na hora da assinatura, o signatário não poderá inserir um valor diretamente em campos designados como campos calculados. O valor do campo é calculado de forma automática com base nas regras definidas no formulário.

A definição de um campo calculado consiste em duas partes: a expressão e a formatação.

Expressão

Obrigatório

Define a fórmula/regra sobre como o valor do campo designado é calculado. O Acrobat Sign avalia a expressão na hora da assinatura e o valor resultante é exibido no campo.

Formato

Opcional

O valor resultante de um campo calculado também pode ser formatado como data, número ou moeda, basta especificar um formato.

Os campos calculados podem ser definidos com tags de texto do Acrobat Sign, com o aplicativo web do Acrobat Sign ou com campos de formulário de PDF. Ao usar tags de texto ou campos de formulário de PDF do Acrobat Sign para definir campos calculados, a expressão para o cálculo é estabelecida utilizando uma diretiva denominada “calc”. A formatação do campo calculado pode ser definida usando uma diretiva chamada “format”.

Exemplo

{{someCalculatedField_es_:signer1:calc(someExpn):format(formatType, someFormat)}}

Esse exemplo mostra tags de texto em uso para definir um campo dentro de um documento chamado “someCalculatedField”. Este campo é atribuído ao destinatário identificado como signer1. O valor desse campo é calculado com base na fórmula especificada no “someExpn”. O tipo de valor resultante é especificado pelo parâmetro “formatType” e formatados com base no formato definido como “someFormat”.

O ambiente de criação do aplicativo web do Acrobat Sign oferece um construtor de expressão totalmente funcional para definir fórmulas de campos calculados. Consulte Uso do construtor de expressões para especificar campos calculados para obter mais detalhes sobre a criação de expressões.


Expressões de campos calculados

A expressão define a fórmula/regra para determinar o valor do campo calculado. Uma expressão pode conter um ou mais dos seguintes elementos:

Literal

Especifica um valor real que é usado como parte da expressão. As expressőes podem ser valores de cadeias de caracteres, números ou datas. Por exemplo:

  • {{helloField_es_:signer1:calc(“Hello”)}} – Este literal define o valor do campo chamado “helloField” para Hello.
  • {{numField_es_:signer1:calc(10)}} – Este literal ajusta o valor do campo chamado “numField”  para 10.
  • {{date_es_:isdate(format="mmm d, yyyy")}} – Este literal inclui uma vírgula, que é um delimitador especial. Para que a vírgula faça parte da cadeia de caracteres formatada, a expressão deve ser apresentada como um valor literal.
  • {{date_es_:isdate(format='d "day of" mmmm, yyyy')}} - É possível inserir uma string de caracteres literal em um cálculo de data.  A string de caracteres literal deve ser colocada entre aspas simples ou duplas. 
    • O cálculo acima produz uma string como: dia 12 de dezembro de 2012

Cadeias de caracteres que precisam ser incluídas em uma expressão deve ser delimitadas por aspas (duplas (”) ou simples (')). Se for necessário incluir aspas (simples ou dupla) no valor resultante, basta adicionar uma barra invertida (\) para fechar as aspas.

Observação importante: a partir de agora, todos os exemplos exibirão apenas as expressões, a sintaxe completa para a tag de texto será omitida.

Operadores

Os operadores são usados para implementar uma ou várias operações como parte da expressão. Por exemplo:

• 6 + 4 – Este operador resulta no campo calculado sendo preenchido pelo valor 10.

• 5/22/2016 - 3 – Este operador resulta no campo calculado sendo preenchido pelo valor 5/19/2016.

Consulte Operadores suportados para obter uma lista dos operadores aceitos nas expressões.

Campos

Os campos existentes dentro de um documento podem ser usados para uma expressão se referindo ao campo por nome. Os campos podem ser campos do Acrobat Sign (como: Assinatura, Campo de data, Nome do signatário, Empresa signatária etc.), campos definidos no documento ou outros campos calculados. Por exemplo:

• price * quantity – Essa expressão se refere a dois outros campos dentro do documento chamados “preço” e “quantidade”. O resultado da multiplicação dos valores destes dois campos preencherá o campo calculado.

• signerName & “employee of” & signerCompany – Essa expressão se refere a dois campos no documento, “signerName” e “signerCompany”, que são pré-preenchidos pelo Acrobat Sign se os dados estiverem disponíveis, e os concatena. Se o nome do signatário é “Casey Jones” e a empresa é “Acme Corp”, esta expressão resultará no preenchimento do valor “Casey Jones employee of Acme Corp” no campo calculado.

Se um nome de campo contém um espaço, ele deve ser colocado dentro de colchetes ([]) para que seja possível fazer referência a ele em uma expressão. Por exemplo [nome de campo com espaços] fará referência a um campo no documento chamado “nome de campo com espaços”.

Funções

As expressões também podem incluir uma ou mais funções da lista de funções compatíveis com o Acrobat Sign. As funções especificadas são avaliadas durante o processo de assinatura do contrato e o valor resultante é exibido no campo calculado. Por exemplo:

• dateAdd(d, signedDate, 3) – Esta expressão usa a função “dateAdd” e especifica a adição de 3 dias à data de assinatura do contrato. Portanto, se o documento for assinado em 5/22/2016, o valor resultante da expressão será 5/25/2016.

Números negativos podem ser usados para subtrair efetivamente a partir da data.

Consulte Funções compatíveis para uma lista de funções compatíveis nas expressões.


Operadores compatíveis

Os operadores a seguir são suportados em campos calculados.

+

Somar dois números.

-

Subtrai dois números.

/

Divide dois números.

*

Multiplica dois números.

&

Concatenar duas strings.

=

Igual a. Compara dois valores e retorna “true” se forem iguais e “false” se não forem.

!=

Diferentes. Compara dois valores e retorna “true” se forem diferentes e “false” se forem iguais.

Menor que. Compara dois valores e retorna um Booleano (verdadeiro ou falso) se o primeiro valor é menor que o segundo valor.

>=

Maiores ou iguais a. Compara dois valores e retorna um Booleano (verdadeiro ou falso) se o primeiro valor é maior que ou igual ao segundo valor.

<=

Menores ou iguais a. Compara dois valores e retorna um Booleano (verdadeiro ou falso) se o primeiro valor é menor que ou igual ao segundo valor.

Maior que. Compara dois valores e retorna um Booleano (verdadeiro ou falso) se o primeiro valor é maior que o segundo valor.

%

Operador de módulo. Retorna o resto da divisão de dois números.

^

Operador de expoente. Retorna o valor exponencial dos números especificados.


Funções compatíveis

As seguintes funções são compatíveis ao especificar expressões dentro de um campo calculado.

Função

Categoria

Descrição

abs(number1)

Matemática

Retorna o valor absoluto do número “number1”.

roundUp(number1)

Matemática

Arredondar o número “number1”.

roundDown(number1)

Matemática

Arredondar o número para baixo “number1”.

round(number1)

Matemática

Arredonda o número “number1”, para o inteiro mais próximo.

min(number1,number2)

Matemática

Retorna o menor de dois números “number1” e “number2”.

max(number1,number2)

Matemática

Retorna o maior de dois números “number1” e “number2”.

datePart(part, date)

Data

Retorna a parte da data especificada no primeiro argumento como um número inteiro. Por exemplo: datePart(m, 5/22/2016) retornará 5, a parte do mês da data.

Consulte Valores aceitos para partes de datas abaixo para obter informações sobre os valores aceitáveis para o atributo da parte.

dateAdd(part, date, addition)

Data

Acrescenta o número de partes especificado (por exemplo, "d" para dia, "m" para mês ou "y" para ano) a uma data para calcular uma data no futuro. Você pode usar números ou nomes de campos.

Por exemplo: dateAdd("m", "Jan 1, 2016", 3) retornaria a data de 1 de abril de 2016. Neste exemplo, a fórmula adiciona 3 meses à data definida.

Números negativos podem ser usados para subtrair efetivamente a partir da data.

dateDiff(part, date1, date2)

Data

Retorna o número de partes (por exemplo, "d" para dias, "h" para horas ou "n" para minutos) entre as duas datas. Você pode usar números ou nomes de campos.

Por exemplo: dateDiff("d", "Jan 1, 2016", "Jan 2, 2016") retornaria um valor de 1 para representar um dia entre 1 de janeiro e 2 de janeiro.

daysIn(part, date)

Data

Retorna o número de dias contidos na parte (por exemplo, "d" para dia, "m" para mês ou "y" para ano) para a data especificada. Você pode usar números ou nomes de campos.

Por exemplo: daysIn("m", "Feb 1, 2016") retorna um valor 29 para os dias em fevereiro de 2016 e daysIn("a", "02/01/2015") retorna 365 para os dias em 2015.

date(string)

Data

Converte um valor de cadeia de caracteres como “1/1/2016” em um objeto de data que possa ser usado em outras funções.

now()

Data

Retorna a data e a hora de avaliação da fórmula, mais frequentemente quando a página para assinar eletronicamente é carregada.

if(logical_test, value_if_true, value_if_false)

Lógica

Avalia "logical_test". “logical_test” pode ser outra expressão. Se for verdadeira, retorna o valor especificado em “value_if_true”. Se for falsa retorna o valor de “value_if_false”. Os atributos “value_if_true” e “value_if_false” também podem ser expressões.

Por exemplo: if (1>0, "Correto", "Incorreto") retornaria "Correto".

and(logical1, logical2, ...)

Lógica

Retorna como “true” somente se todos os argumentos lógicos são avaliados como verdadeiro. Caso contrário, retorna como “false”.

Por exemplo: and (1>0, 2>1) retornaria “true” e and (1>0, 2=1) retornaria “false”.

or(logical1, logical2, ...)

Lógica

Retorna “true” se qualquer um dos argumentos lógicos (logical1, logical2,...) for avaliado como verdadeiro. Se todos os argumentos lógicos são avaliados como falso, esse será o valor “false”.

Por exemplo: or (1>0, 2>1) retornará “true”. or (1>0, 2=1) retornará “false”.

not(logical)

Lógica

Retorna o valor oposto de "logical". Portanto, se "logical" é avaliado como falso, retorna “true”. Se for avaliado como verdadeiro, retorna “false”. Por exemplo, not (1>0) retornaria “false”.
lookup(sourceField,("value1=return1,value2=return2", "default_value") Lógica

Avalia um campo de origem “valor de retorno” (usado em botões de opções e áreas para soltar itens) para preencher um valor padrão no campo calculado com base em uma lista de possíveis valores.

Por exemplo: lookup(stateField, “CA=California,UT=Utah,MA=Massachusetts,WA=Washington”,”None”)

Retornaria Califórnia se stateField fosse CA, ou Utah se stateField fosse UT etc.  Se nenhuma correspondência for encontrada, retorna Nenhum.


Valores aceitos para partes de datas

Os valores a seguir podem ser usados em funções de data ao especificar a parte da data em que a função deve operar.

Parte

Parte da data a que a função será aplicada

y

Ano

q

Trimestre

m

Mês

d

Dia

h

Hora

n

Minuto

s

Segundo


Formatação de campos calculados

Além de especificar a expressão para um campo calculado o valor de saída também pode ser formatado. O resultado pode ser formatado como texto (o padrão) ou como número ou data.

Quando usada com tags de texto, a diretiva de formato utiliza dois argumentos: FormatType e Format.

FormatType

Especifica o tipo de valor que o campo calculado representa. Os valores aceitos para este parâmetro são: número e data.

Formato

Especifica a estrutura do valor de saída a ser inserido no campo calculado.


Formatação de campos calculados como números

Os caracteres a seguir podem ser usados para definir a formatação de uma saída em formato de número

Caractere de formato

Descrição

_

(Sublinhado). Representa o espaço reservado para qualquer dígito.

9

Representa o espaço reservado para qualquer dígito.

.

Local de um ponto decimal obrigatório (ou símbolo adequado ao local).

0

Localizado à esquerda ou à direita de um ponto decimal obrigatório. Teclados com zeros.

( )

Se o número for menor do que zero, coloca a máscara entre parênteses.

+

Adiciona um sinal de soma antes de um número positivo; um sinal de subtração antes de um número negativo.

-

Adiciona um espaço antes de um número positivo; um sinal de subtração antes de um número negativo.

,

Separa cada terceira casa decimal com uma vírgula (ou caractere separador adequado ao local).

$

Coloca um cifrão de dólar (ou símbolo adequado ao local) antes do número formatado. Quando determinado, deve ser o primeiro caractere da cadeia de caracteres de formato.

%

Converte um valor numérico no campo para uma porcentagem. Multiplica-o por 100 e acrescenta

o sinal de % no final. Quando determinado, deve ser o último caractere da cadeia de caracteres de formato.


Formatação campos calculados como datas

Os caracteres a seguir podem ser usados para definir a formatação de uma saída em formato de data.

Formato

Descrição

Exemplo

s

Os segundos do minuto, entre 0-59.

"0" a "59"

ss

Os segundos do minuto com zero à esquerda, se necessário.

"00" a "59"

n

O minuto da hora, entre 0-59.

"0" ou "59"

nn

O minuto da hora com zero à esquerda, se necessário.

"00" ou "59"

h

A hora do dia, entre 1-12.

"1" a "12"

hh

A hora do dia com zero à esquerda, se necessário.

"01" a "12"

H

A hora do dia, entre 0-23.

"0" a "23"

HH

A hora do dia com zero à esquerda, se necessário.

"00" a "23"

d

O dia do mês, entre 1 e 31.

"1" a "31"

dd

O dia do mês com zero à esquerda, se necessário.

"01" a "31"

ddd

Nome abreviado do dia.

"Seg" a "Dom"

dddd

O nome inteiro do dia.

"Segunda-feira" a "Domingo"

m

O mês do ano, entre 1-12.

"1" a "12"

mm

O mês do ano com zero à esquerda, se necessário.

"01" a "12"

mmm

Nome do mês abreviado.

"Jan" a "Dez"

mmmm

O nome inteiro do mês.

"Janeiro" a "Dezembro"

yy

O ano como um número de dois dígitos.

"99" ou "15"

yyyy

O ano como um número completo de quatro dígitos.

"1999" ou "2015"

t

Exibe o primeiro caractere do designador A.M./P.M.

"A" ou "P"

tt

Exibe o designador A.M./P.M.

"AM" ou "PM"


Exemplos de formatação

Os exemplos a seguir mostram como formatar a data e o número em calculado campos.

  • Um campo calculado formatado como data:

{{myField_es_:calc(otherDateField + 3):format(date, "mmm dd, yyyy")}}

A saída será algo como “22 de maio de 2016”.

  • Um campo calculado formatado como número.

{{myTax_es_:calc(total * taxrate):format(number, "$,.00") }}

A saída será algo como “$ 1.987,65”.


Uso do construtor de expressões para definir campos calculados

Os campos calculados podem ser definidos por meio do ambiente de criação do Acrobat Sign. As etapas abaixo servem como guia para definir um campo calculado no ambiente de criação.

1. Arraste e solte um campo no documento. Clique duas vezes no campo que adicionou para acionar a caixa de diálogo das propriedades. Dê ao campo um nome adequado. Altere o atributo Tipo de valor, usando a lista suspensa, para Valor calculado. Isso indica que o valor do campo será determinado com base em um cálculo na hora da assinatura.

Campo Tipo de valor

 

2. Digite a expressão do cálculo no campo de texto chamado Fórmula ou clique no botão de função (fx) para abrir o construtor de expressões.

Construtor de fórmula

 

3. Use esse construtor para definir a expressão para o campo calculado (consulte a figura abaixo). A Área da expressão na parte superior mostra a fórmula que será usada para calcular o valor do campo. Você pode digitar a fórmula na área da expressão ou usar o ambiente de criação para gerar a fórmula. O construtor de expressões fornece uma lista de todas as Funções disponíveis, uma lista de Campos de formulário existentes no documento e uma lista de Operadores compatíveis para ajudar na criação das expressões. Você pode adicionar um campo ou uma função a uma fórmula clicando duas vezes no item na lista localizada no construtor de expressões. Também é possível adicionar operadores à expressão clicando em um operador específico na lista.

4. Quando terminar de definir a expressão, é possível checar a sintaxe clicando no botão Verificar sintaxe e salvar as alterações.

5. Defina o tipo de campos calculados usando a lista suspensa Exibir como.

Exibir como campo

 

6. Se o valor Exibir como é uma data ou um número, defina a valor de campo Formato de data/número usando a lista suspensa. Você também pode selecionar Formatação personalizada para definir a formatação que desejar para o campo.

Formato de campo de número


Campos calculados com a formatação Moeda

A formatação Moeda de um campo calculado insere um símbolo de moeda antes do valor calculado. (Caso contrário, o cálculo é simples, feito conforme indicado pela fórmula.)

O símbolo inserido é baseado nas seguintes regras:     

  • Se os campos de origem contiverem uma validação de Moeda dos EUA, o símbolo exibido será o do dólar dos EUA: US$
  • Se os campos de origem contiverem uma validação de Moeda do Reino Unido, o símbolo exibido será o da libra esterlina: £

Para que a formatação Moeda funcione, o campo calculado deve ser configurado com:

  • o valor Exibir como definido como Número
  • o valor Formato de número definido como Moeda
Calcular campo - Formato de moeda

Os campos de origem usados no cálculo podem ser validados como Número ou Moeda:

Calcular campo - Número de origem
Campo de origem validado como número

Calcular campo - Moeda de origem
Campo de origem validado como moeda

Cuidado:

Ao calcular o valor de um campo formatado como Moeda, o Acrobat Sign não contabiliza nenhum tipo de câmbio de moeda (Forex).

  • O campo calculado está executando apenas a matemática do cálculo
  • O formato do campo (Moeda) só insere o símbolo da moeda



Exemplos de campos calculados

 

  • {{shipState_es_:signer1:calc([billingState]):showif(sameAs=unchecked)}}
    • Um campo atribuído ao primeiro signatário que será exibido somente quando outro campo chamado “sameAs” (uma caixa de seleção) estiver desmarcada. O valor do campo é preenchido de forma automática com o valor do campo “billingState” que o signatário inseriu no documento.
  • {{total_es_:signer1:calc(q1*pr1):format(Number,”$,0.00”):align(right)}}
    • Um campo no documento atribuído ao primeiro signatário. Seu valor é calculado de forma automática conforme o produto dos valores nos campos “q1” e “pr1”. O valor resultante é formatado como moeda, exibido com um símbolo de dólar ($) na frente do número e com duas casas decimais. O valor é alinhado à direita dentro do campo.
  • price_es_:signer1:calc(if(pn1=”W1”,9.99,if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}
    • Um campo chamado “price” (preço) que é calculado com base no valor selecionado pelo signatário em outros campos “pn1” no documento. Neste exemplo, se o campo “pn1” for igual a W1, o valor exibido no campo “price” (preço) é 9,99; se o campo “pn1” for igual a W2, o valor exibido é 5,99 e assim por diante. Se nenhum dos valores corresponderem ao do campo “pn1”, o valor exibido é 0. Com esse mecanismo, os campos calculados podem ser usados para preencher o preço de um item de forma automática com base na seleção que o signatário fez durante o processo de assinatura.

 

Receba ajuda com mais rapidez e facilidade

Novo usuário?