Guia do Usuário Cancelar

Preencher valores de campo de formulário web usando parâmetros de URL

 

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

Use os parâmetros de URL para preencher campos do formulário da Web

Para inserir valores em um campo do formulário da Web, há duas coisas que você precisa saber:

  • Como marcar um campo como disponível para os parâmetros de URL
  • Como criar os parâmetros de URL que devem ser inseridos

 

Como marcar um campo como disponível para os parâmetros de URL

  1. Crie ou edite um formulário da Web para obter acesso aos campos

  2. Adicione o campo de texto que você deseja preencher por meio do URL

    •  Somente os campos de texto podem aceitar valores
  3. Clique duas vezes no campo para abrir as propriedades dele

  4. Edite o nome do campo com algo significativo. O nome do campo é a primeira parte do parâmetro que você usará, em geral é melhor mais curto

  5. Marque a caixa que diz O valor padrão pode ser derivado do URL

    • Opcionalmente, marque a caixa Somente leitura se você não quiser que o valor seja editável
  6. Clique em OK para salvar os parâmetros

  7. Repita o procedimento para todos os campos que deverão aceitar um parâmetro do URL

  8. Clique em Salvar para salvar o formulário da Web

URL

Neste exemplo estamos criando dois campos que devem ser preenchidos pelo URL:

  • Branch_Office: um campo que aceita a cadeia de caracteres da filial (mostrada acima)
  • Emp_ID: um campo que aceita a ID de funcionário

 

Como criar os parâmetros de URL que devem ser inseridos

  1. Copie o URL do formulário da Web. A maneira mais fácil de fazer isso é:

    • Edite o formulário da Web na página Gerenciar
    • Clique no link Copiar URL do formulário da Web
    URL

    Os URLs dos formulários web são muito longos, portanto usamos aqui um abreviado como exemplo (o seu será diferente):

    URL de exemplo:

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*

  2. Colar o URL do formulário da Web em um editor de texto (como o Bloco de Notas)

  3. Adicionar seus parâmetros  

    • O início dos parâmetros é identificado ao adicionar um hash (cerquilha, #) no final do URL do formulário da Web.
    • Em seguida, adicione os parâmetros no formato de {field_name}={value} 

    Exemplo de URL com um parâmetro

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621

    • Vários valores são adicionados inserindo um sinal tipográfico (&) entre os valores do campo.

    Exemplo de URL com dois parâmetros

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621&Emp_ID=429939

  4. Uma vez que todos os pares de campo=valor estiverem adicionados ao URL, copie toda a cadeia de caracteres e cole-a em seu navegador.

    O formulário da Web será renderizado com os campos preenchidos:

    URL parâmetros em um formulário web

Propriedades e restrições

  • Você usa a cerquilha (#) apenas uma vez para definir o início dos parâmetros
    • Usar uma cerquilha subsequente em um valor não afeta negativamente o resultado
  • É aceitável usar espaços nos valores
  • Usar espaços no nome de campo só é aceitável se você inserir explicitamente %20 como o caractere de espaço no URL
    • Isso funcionará: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • Isso não funcionará: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • Normalmente é recomendo que um sublinhado seja usado em nomes de campo em vez de espaços. Isso economizará tempo
  • Não há espaço permitido entre o Nome do campo, o sinal de igual e o início do valor (Fieldname=Value)
  • Nenhum espaço ao lado do sinal tipográfico se você tiver vários valores
  • Não há limite (a não ser talvez os limites de comprimento do URL) para o número de campos que podem obter seus valores dos parâmetros de URL
  • Os campos de texto calculados não podem ser substituídos e não têm uma caixa de seleção exibida em nas propriedades de campo.
  • Os parâmetros de URL não funcionam com formulários da Web autenticados. Devido ao uso de fragmentos de hash do URL, se um formulário da Web for protegido por uma senha ou outra autenticação, os parâmetros de URL não serão transmitidos de volta ao cliente depois que a autenticação for concluída (o servidor nunca vê essa parte do URL). 

 

Tratamento de erros

  • Qualquer parâmetro de URL que não corresponder ao nome do campo de formulário exatamente será ignorado
  • Qualquer parâmetro de URL que tente atribuir um valor a um campo que não seja de texto ou um campo de texto que não tenha a opção O valor padrão pode ser derivado do URL será ignorado