Guía del usuario Cancelar

Prerrellenado de valores de campo de formulario web utilizando parámetros de URL

 

Guía de Adobe Acrobat Sign

Novedades

Introducción

Administrar

Enviar, firmar y administrar acuerdos

Capacidades y flujos de trabajo de acuerdos avanzados

Integrar con otros productos

Acrobat Sign Desarrolladores

Soporte y solución de problemas

Utilice parámetros de URL para rellenar los campos de formulario web

Para insertar valores en un campo de un formulario web, hay dos cosas que debe saber:

  • Cómo marcar un campo como disponible para los parámetros de URL
  • Creación de los parámetros de URL que se insertarán

 

Cómo marcar un campo como disponible para los parámetros de URL

  1. Cree o edite un formulario web para obtener acceso a los campos

  2. Agregue un campo de texto que desee rellenar a través de la URL

    •  Los campos de solo texto pueden aceptar valores
  3. Abra las propiedades del campo haciendo doble clic en ellas

  4. Edite el nombre del campo para que tenga significado. El nombre del campo es la primera parte del parámetro que utilizará, por lo que cuanto más corto mejor

  5. Marque la casilla que indique que Es posible que el valor predeterminado proceda de una dirección URL.

    • Opcionalmente, marque la casilla Solo lectura si no desea que se pueda editar el valor
  6. Haga clic en OK para guardar los parámetros

  7. Repita el procedimiento para todos los campos que necesiten aceptar un parámetro de la URL

  8. Haga clic en Guardar para guardar el formulario web

URL

En este ejemplo vamos a crear dos campos que debe rellenar la URL:

  • Branch_Office: un campo que acepta la cadena de sucursal (mostrada arriba)
  • Emp_ID: un campo que acepta el ID de empleado

 

Creación de los parámetros de URL que se insertarán

  1. Copie la URL desde el formulario web. La forma más sencilla de hacerlo es:

    • Edite el formulario web desde la página Administrar
    • Haga clic en el enlace Copiar URL del formulario web
    URL

    Las URL de formularios web resultan bastante largas, por lo que aquí se utiliza una abreviada como ejemplo (la suya será diferente):

    Ejemplo de URL:

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

  2. Pegue la URL del formulario web en un editor de texto (como el Bloc de notas)

  3. Agregar sus parámetros  

    • El inicio de los parámetros se identifica mediante la adición de un símbolo de almohadilla (#) al final de la URL del formulario web.
    • Agregue los parámetros en formato {nombre_de_campo}= {valor}

    URL de ejemplo con un parámetro

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

    • Se agregan varios valores insertando un símbolo et (&) entre los valores de campo.

    URL de ejemplo con dos parámetros

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

  4. Una vez que todos los pares de campo=valor se agreguen a la URL, copie la cadena completa y péguela en su navegador.

    El formulario web se representará con los campos rellenados:

    URL parámetros de un formulario web

Propiedades y limitaciones

  • La almohadilla solo se utiliza una vez para definir el principio de los parámetros
    • Utilizar una almohadilla posterior en un valor no afecta negativamente el resultado
  • Usar espacios en valores es aceptable
  • Usar espacios en el nombre del campo solo es aceptable si inserta explícitamente %20 como carácter de espacio en la URL
    • Esto funcionará: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • Esto no funcionará: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • Se recomienda utilizar un guion bajo en los nombres de campo en lugar de espacios. Le permite ahorrar tiempo en última instancia
  • No se permiten espacios entre el nombre del campo, los signos de igual y el principio del valor (Nombre del campo=Valor)
  • No hay espacios a cada lado del símbolo et (&) si tiene varios valores
  • No hay límite (con excepción, tal vez, de límites de longitud URL) al número de campos que pueden obtener su valor de parámetros de URL
  • Los campos de texto calculados no se pueden anular y no tienen la casilla que se muestra en sus propiedades de campo.
  • Los parámetros de URL no funcionan con los formularios web autenticados. Debido al uso de fragmentos hash de URL, si un formulario web está protegido mediante una contraseña u otro tipo de autenticación, los parámetros de URL no se enviarán al cliente después de que la autenticación se complete (el servidor nunca ve esa parte de la URL). 

 

Gestión de errores

  • Se omiten todos los parámetros de URL que no coinciden exactamente con un nombre de campo de formulario
  • Se ignora cualquier parámetro de URL que intente asignar un valor a un campo que no sea de texto o un campo de texto que no tenga activado Es posible que el valor predeterminado proceda de una dirección URL.