Información general

Las etiquetas de texto de Adobe Sign son elementos textuales con un formato especial que se pueden colocar en cualquier lugar dentro del contenido de un documento y que especifican la ubicación, el tamaño y el tipo de campos tales como los de firma y de iniciales, de las casillas de verificación, los botones de opción y los campos de formulario, así como reglas de procesamiento avanzado de campos opcionales. Las etiquetas de texto también se pueden utilizar al crear archivos PDF con campos de formulario. Consulte la guía de referencia Creación de formularios en Acrobat.

Las etiquetas de texto se convierten en campos de formulario de Adobe Sign cuando el documento se envía para firmar o se carga. Las etiquetas de texto de Adobe Sign pueden colocarse en cualquier tipo de documento, como un archivo PDF, de Microsoft Word, de PowerPoint, de Excel y archivos de texto (.txt, .rtf).

Por ejemplo:

{{Sig_es_:signer1:signature}}

Un campo de firma asignado al destinatario identificado como “signer1”.

{{Cmpy_es_:signer2:company}}

Un campo que se refiere al nombre de la empresa del destinatario identificado como “signer2”.

{{address_es_:signer1}}

Un campo para que el destinatario identificado como “signer1” escriba su dirección.

{{*city_es_:signer1}}

Un campo obligatorio para que el destinatario identificado como “signer1” escriba el nombre de su ciudad.

{{!price}}

Un campo de solo lectura. Los destinatarios no pueden cambiar el valor de este campo.

Las etiquetas de texto de Adobe Sign ofrecen un exhaustivo mecanismo para configurar plantillas de documentos que permiten colocar campos de firma y de iniciales, recopilar datos de las distintas partes involucradas en un acuerdo, definir reglas de validación para los datos recogidos y añadir condiciones que se deban cumplir. Una vez que un documento está configurado correctamente con las etiquetas de texto, se puede utilizar como plantilla al enviar documentos para firmar a fin de garantizar que los datos recopilados para los acuerdos sean coherentes y válidos en toda la organización.

Nota:

Cuando corresponde, se indican las características y funciones específicas de los planes Adobe Sign – Business, Adobe Sign – Enterprise o de ambos.

Guía de inicio rápido sobre las etiquetas de texto

Ejemplos de etiquetas de texto

En todos los ejemplos siguientes, se presupone que las etiquetas se utilizan dentro del contenido de un documento. Al usar las etiquetas como nombres de campo de formulario PDF, omita las llaves de apertura (“{{”) y cierre (“}}”).

Campos de firma y de iniciales

{{Sig_es_:signer1:signature}}

Un campo de firma asignado al destinatario identificado como “signer1”.

{{Int_es_:signer1:initials}}

Un campo de iniciales asignado al destinatario identificado como “signer1”.

{{SigB_es_:signer1:signatureblock}}

Un bloque de firma asignado al destinatario identificado como “signer1”.

{{OSig_es_:signer1:optsignature}}

Un campo de firma opcional asignado al destinatario identificado como “signer1”.

{{OInt_es_:signer1:optinitials}}

Un campo de iniciales opcional asignado al destinatario identificado como “signer1”.

{{SigStamp_es_:signer1:stampimage(25)}} Un campo de sello que puede utilizarse como opción de firma. Los sellos no son obligatorios a menos que no haya otros campos de firma para el firmante.


Campos de función del destinatario

Los campos de firmante y remitente se utilizan para indicar las funciones de los destinatarios en un acuerdo.

Campo del firmante

La función “signer” (firmante) especifica el primer destinatario (firmante o aprobador) que no es el remitente. La función “signer1” identifica al primer destinatario en todos los casos. El destinatario identificado como “signer1” podría ser el remitente si esta es la primera persona que firma o aprueba el acuerdo.

{{Cmpy_es_:signer1:company}}

Un campo para que el destinatario identificado como “signer1” escriba el nombre de su empresa.

{{N_es_:signer2:fullname}}

Un campo de solo lectura para que el destinatario identificado como “signer2” escriba su nombre completo.

{{Dte_es_:signer1:date}}

Un campo de solo lectura que contiene la fecha de la firma.

{{Em_es_:signer1:email}}

Un campo de solo lectura que contiene la dirección de correo electrónico del firmante.

Nota:

 En lugar de utilizar las funciones “sender” y “signer” (remitente y firmante), otro método consiste en utilizar solo las funciones “signer1”, “signer2”, “signer3”, etc. Asegúrese de añadir a los participantes en el orden correcto al enviar el documento.

 

Campo del remitente

La función “sender” (remitente) solo se puede utilizar cuando se elige la opción “Tengo que firmar en primer/último lugar” durante el proceso de envío. La función “sender” especifica siempre un campo asignado al remitente, independientemente de si firma el primero o el último.

{{*Ttl_es_:sender:title}}

Un campo obligatorio para que el remitente escriba su cargo.

Nota:

En lugar de utilizar las funciones “sender” y “signer”, otro método consiste en utilizar solo las funciones “signer1”, “signer2”, “signer3”, etc. Asegúrese de añadir a los destinatarios en el orden correcto al enviar el documento.


Campos prerrellenados

{{price_es_:prefill}}

Un campo que el remitente rellena antes de enviar el documento.


Campos de texto

{{address_es_:signer1}}

Un campo opcional para que el destinatario identificado como “signer1” escriba su dirección.

{{*city_es_:signer1}}

Un campo obligatorio para que el destinatario identificado como “signer1” escriba el nombre de su ciudad.


Campos de solo lectura

{{!price}}

Un campo de solo lectura. Los firmantes no pueden cambiar su valor.


Casillas de verificación

{{[]}}

Una casilla de verificación.

{{[x]}}

Una casilla de verificación marcada de forma predeterminada.


Botones de opción

{{(Red)Color}}

Un botón de opción que tiene el valor “Red” (rojo) cuando se selecciona.


Imágenes

{{Image1_es_:signer1:inlineimage(4)}}
Un campo de imagen en línea con una altura de 4 líneas.


Validación de campos

{{*Mobile_es_:signer1:phone}}

Un campo de teléfono obligatorio para escribir números telefónicos con el formato de EE. UU.

{{d_es_:signer1:num(>0,<60)}}

Un campo de número opcional que permite valores del 0 al 60.


Reglas condicionales

{{field_es_:showif(price>60)}}

Un campo que muestra si el precio (“price”) tiene un valor superior a 60.


Campos calculados

{{TV_es_:calc([SubTotal]+[Tax])}}

Un campo cuyo valor se calcula automáticamente como la suma de los campos “SubTotal” (subtotal) y “Tax” (impuestos).


Conversión de las etiquetas de texto en campos de formulario

Longitud de campo y formato

Cuando se utilizan etiquetas de texto en un documento editable, Adobe Sign superpone un rectángulo que abarca la extensión completa de la etiqueta de texto (desde el comienzo, “{{”, hasta el final, “}}”) y convierte la etiqueta de texto en el campo de formulario correspondiente de Adobe Sign.

La longitud del campo de formulario se puede aumentar añadiendo caracteres de espacio en blanco al principio de la etiqueta de texto (inmediatamente después de “{{”) o al final (justo antes de “}}”). El campo de formulario se puede hacer más pequeño reduciendo el tamaño de fuente de la etiqueta de texto hasta conseguir la longitud adecuada.

El formato del campo de formulario (tamaño de fuente, color, etc.) lo determina el formato de la primera llave (“{”). Para garantizar que Adobe Sign procese correctamente las etiquetas de texto, hay que especificar las definiciones de las etiquetas en fuentes comunes que se usen en el documento (Helvetica, Times, Arial, Verdana o Courier). Para forzar el uso de un estilo de fuente específico, consulte la sección Aspecto de fuente.

Las definiciones de las etiquetas de texto distinguen entre mayúsculas y minúsculas y deben escribirse en minúscula. 

La imagen siguiente muestra etiquetas de texto en un documento de Microsoft Word.

Image1

La extensión completa de la etiqueta de texto, desde la llave de apertura hasta la llave de cierre, debe caber en una sola línea. Si la etiqueta de texto abarca varias líneas, ya sea en el documento de origen o en el PDF procesado, Adobe Sign no reconocerá correctamente el campo de formulario y el firmante podría ver el texto subyacente al firmar el documento.

Las llaves, cuando se utilizan en formularios PDF, no se deben incluir en el nombre de los campos de formulario PDF. El tamaño del campo está determinado por el tamaño del campo de formulario PDF y el formato de los datos introducidos en el campo lo definen las propiedades del campo de formulario PDF.

Image2

Un mismo documento no puede incluir campos de formulario PDF y campos definidos mediante etiquetas de texto.

 

Interacción con campos de formulario durante la firma

Las etiquetas de texto anteriores se convierten en los campos rellenables siguientes durante el proceso de firma:

image 3


Campos de formulario en el documento firmado

Después de combinarse los datos en el documento firmado, en el PDF firmado aparecería lo siguiente:

Image 4


Etiquetas de texto largas

Cuando se utilizan en documentos editables, las etiquetas de texto que contienen muchas directivas pueden llegar a ser muy extensas, por lo que podría ser difícil especificar campos pequeños en el documento. Adobe Sign proporciona un método sencillo que permite especificar etiquetas más cortas en el documento.

Por ejemplo, si necesita poner un campo de teléfono obligatorio asignado al remitente, en lugar de colocar la etiqueta

{{*Mobile_es_:signer1:phone}} completa, puede usar una etiqueta más corta, {{$mob}}, en la ubicación correcta del documento y añadir espacios en blanco para ajustar el tamaño del campo. La definición completa de la etiqueta de texto,

{{#mob=*Mobile_es_:signer1:phone}}, se puede colocar en otra parte del documento. Consulte Acortamiento de etiquetas de texto para obtener más información sobre este tema.

Análisis en profundidad de las etiquetas de texto

Sintaxis de las etiquetas de texto

Una etiqueta de texto de Adobe Sign se define del modo siguiente:

Desglose de la etiqueta de texto

A continuación, detallamos sus componentes:

  • Necesario: un indicador opcional que especifica si el campo en cuestión es obligatorio y si el firmante debe rellenarlo durante la firma. Si el indicador no aparece, el campo de formulario no es obligatorio y el firmante puede rellenar un valor durante la firma (pero no es obligatorio).
  • Solo lectura: un indicador opcional que especifica que el campo en cuestión es de solo lectura. Marcar un campo como de solo lectura garantiza que nadie pueda modificar sus datos durante la firma. Los datos se pueden combinar en campos de solo lectura con MegaSign o las API de Adobe Sign a través de CSV antes de enviar el documento para su firma.
  • Nombre del campo: un nombre único que identifica este campo concreto dentro del documento. El nombre del campo se utiliza para identificar los valores que se proporcionan durante la firma cuando los datos se exportan desde el servicio.

Nota:

  • Si un documento contiene más de una etiqueta de texto con el mismo nombre, pero con directivas diferentes o si las directivas están en un orden diferente entre las etiquetas de texto del mismo nombre, Adobe Sign añade automáticamente “efield” + número único + “_” al principio del nombre. Por ejemplo, si hay dos campos llamados “Dirección” en el documento, Adobe Sign cambia el nombre de uno de ellos por “efield2_Dirección”.
  •  Si hay dos etiquetas de texto con el mismo nombre de campo, las mismas directivas y el mismo orden de directivas dentro de un documento, estos campos se consideran copias. Los datos introducidos en un campo se copian automáticamente en la otra ubicación de campo dentro del documento.

  • Identificador ES: una cadena de texto especifica (“_es_”) que se debe incluir después del nombre del campo en la etiqueta de texto para activar funciones específicas de Adobe Sign. Si el identificador de Adobe Sign no se incluye después del nombre del campo, se añade un campo de formulario al documento sin directivas.
  • Directiva: una lista de una o varias definiciones que empiezan por dos puntos (“:”) y especifican la función, el tipo de campo y reglas adicionales de procesamiento de campos que definen el tipo de los datos que se pueden introducir en el campo. Las directivas se pueden definir en cualquier orden.
    • Función: el participante al que está asociado este campo (p. ej., remitente, firmante, etc.).
    • Tipo de campo: el tipo de campo de formulario de Adobe Sign (por ejemplo, de firma, de iniciales, de casilla de verificación o de texto).
    • Reglas: reglas de procesamiento avanzado, como validación de datos, lógica para ocultar o mostrar campos según ciertas condiciones, etc.


Control de las interacciones con los campos durante la firma

Los campos de formulario de un documento se pueden asignar a un firmante determinado durante el flujo de trabajo de firma. Adobe Sign garantiza que un firmante solo pueda interactuar con los campos que se le han asignado durante la firma. Los campos de formulario se pueden asignar a un firmante específico añadiendo una directiva determinada en la etiqueta de texto.


Asignación de campos de formulario a firmantes concretos

Adobe Sign admite las siguientes directivas para asignar campos de formulario a firmantes concretos.

{{Field2_es_:signer1}}

Un campo del acuerdo que se asigna a la primera persona que no es el remitente del acuerdo.

{{Field3_es_:signer1}}

{{Field4_es_:signer2}}

Si un acuerdo necesita más de un firmante y todos ellos tienen que proporcionar datos durante la firma, los campos del acuerdo se pueden asignar a firmantes concretos usando la directiva “signer<x>”, donde <x> es el orden en el que los firmantes firman el acuerdo. Los campos marcados con la directiva “signer1” se asignan al primer firmante, los campos marcados con la directiva “signer2”, al segundo y así sucesivamente. Adobe Sign garantiza que un firmante solo pueda interactuar con los campos que tiene asignados.

Si el remitente del acuerdo es la primera persona que firma, este verá los campos marcados como “signer1” además del que esté marcado como “sender”.


Datos prerrellenados por el remitente

En algunos casos, el remitente no tiene que firmar el acuerdo, pero tiene que cumplimentar datos antes de que se envíe el acuerdo para firmarlo. Esto se hace añadiendo la directiva “prefill” en los campos de formulario pertinentes del acuerdo. Adobe Sign permite al remitente cumplimentar los campos antes de enviar el acuerdo para su firma.

{{Field5_es_:prefill}}

Campo del acuerdo que debe rellenar el remitente antes de que se envíe para firmarlo.

Nota:

El prerrellenado está activado de forma predeterminada en los documentos cargados en la biblioteca de documentos de Adobe Sign. El prerrellenado se puede habilitar activando la opción “Campos Vista previa y Agregar firma” al enviar documentos. Para activar “prefill” en todos los acuerdos enviados desde la página “Enviar” independientemente de si la opción “Vista previa” está activada, póngase en contacto con la asistencia de Adobe.


Campos sin asignar

Durante la firma, cualquier firmante puede rellenar un campo que no tenga una directiva asignándolo a un destinatario determinado. Una vez que se haya rellenado el campo, se bloquea para evitar que los firmantes siguientes cambien su valor.

{{Address}}

Un campo de un acuerdo que cualquier firmante puede rellenar.

{{zip_es_:zip4}}

Un campo de un acuerdo para que cualquier firmante introduzca en él un código postal con validación.


Tipos de campos básicos de Adobe Sign

En un documento se puede crear una gran variedad de tipos de campos colocando directivas específicas en las etiquetas de texto. Adobe Sign interpreta las etiquetas y las convierte en los campos de formulario adecuados durante la firma. Todos los tipos de campos que se pueden añadir a un documento mediante la aplicación web de Adobe Sign también se pueden especificar a través de etiquetas de texto.


Campos de firma y de iniciales

Puede situar los campos de firma o iniciales de Adobe Sign en ubicaciones concretas del documento añadiendo una directiva para designar el tipo del campo de firma. De forma predeterminada, los campos de firma y de iniciales son obligatorios.

Sin embargo, algunos documentos requieren que el firmante firme o ponga sus iniciales, de manera opcional, en ubicaciones específicas del documento. Los campos opcionales de firma o de iniciales también se pueden definir dentro de un documento utilizando etiquetas de texto.

Nota:

Adobe Sign requiere que un documento contenga como mínimo una firma por cada uno de los firmantes del documento. Los aprobadores de un documento no necesitan contar con un campo de firma en el documento durante la firma.

{{Sig1_es_:sender:signature}}

Un campo de firma obligatorio asignado al remitente.

{{Int1_es_:signer1:initials}}

Un campo de iniciales obligatorio asignado al destinatario identificado como “signer1”.

{{OSig1_es_:signer2:optsignature}}

Un campo de firma opcional asignado al destinatario identificado como “signer2”.

{{OInt1_es_:signer1:optinitials}}

Un campo de iniciales opcional asignado al destinatario identificado como “signer1”.

{{SigStamp_es_:signer1:stampimage(25)}} Un campo de sello que puede utilizarse como opción de firma. Los sellos no son obligatorios a menos que no haya otros campos de firma para el firmante.


Campos especiales de Adobe Sign

Adobe Sign proporciona campos especiales que se pueden colocar en el documento para recopilar información del firmante, como el cargo que ocupa o el nombre de su empresa. Si la información de estos campos ya está disponible, Adobe Sign los rellena automáticamente al mostrar el documento al firmante durante la firma.

{{Ttl1_es_:title}}

Un campo para indicar el cargo del firmante.

{{Cmpy1_es_:company}}

Un campo para escribir la empresa del firmante.


Campos especiales de solo lectura

Además, Adobe Sign permite recoger en el acuerdo la fecha de la firma, la dirección de correo electrónico y el nombre del firmante. Estos campos los rellena automáticamente Adobe Sign y el firmante no los puede modificar al firmar el acuerdo.

{{Dte1_es_:date}}

Un campo que captura automáticamente la fecha de la firma.

{{Em1_es_:email}}

Un campo que captura automáticamente la dirección de correo electrónico del firmante. Cuando se utiliza en los widgets de Adobe Sign, el campo de la dirección de correo electrónico lo puede editar el firmante al firmar el widget. Dependiendo de la configuración de la cuenta, Adobe Sign comprueba la dirección de correo electrónico que ha proporcionado el firmante antes de completar el proceso de firma del widget.

{{Name1_es_:fullname}}

Un campo para escribir el nombre completo del firmante.


Bloque de firma

Si no se coloca ningún campo de firma en el documento para un firmante determinado, Adobe Sign pone automáticamente un bloque de firma al final del documento para dicho firmante. De forma predeterminada, un bloque de firma incluye los campos de firma y de dirección de correo electrónico. Sin embargo, si el administrador de cuentas o grupos ha habilitado el ajuste “Solicitar a los firmantes que proporcionen el cargo al firmar electrónicamente” o “Solicitar a los firmantes que proporcionen el nombre de su empresa al firmar electrónicamente” (o ambos, en Preferencias de firma), los campos del cargo y la empresa se incluyen en el bloque de firma. En la imagen siguiente se ve un bloque de firma con los cuatro campos.

Bloque de firma

Si lo desea, puede colocar el bloque de firma completo de Adobe Sign en el documento usando la directiva “signatureblock”.

{{SBlk1_es_:signatureblock}}

Coloca el bloque de firma dentro del documento en la ubicación especificada.


Campos de texto

Todos los campos definidos dentro de un documento que no contienen directivas adicionales de definición de tipo de campo se consideran campos de texto rellenables en el documento.

{{propertyName_es_:signer}}

Define un campo de texto editable llamado “propertyName” dentro de un documento.


Definición de campos obligatorios u opcionales

En la mayoría de los campos, se puede indicar si son obligatorios u opcionales. Adobe Sign garantiza que un firmante no pueda firmar un acuerdo antes de que se rellenen todos los campos obligatorios.

De forma predeterminada, todos los campos son opcionales salvo los siguientes:

  • Los campos de firma y de iniciales son obligatorios de forma predeterminada a menos que se definan con las etiquetas de texto “optsignature” u “optinitials”. Consulte Campos de firma y de iniciales para obtener más información sobre estas etiquetas de texto.
  • Los campos de cargo y empresa son obligatorios si la configuración de la cuenta exigen que formen parte del bloque de firma. Consulte Bloque de firma para obtener información sobre la configuración específica de la cuenta.

Los campos obligatorios se marcan con un asterisco (*) prefijado al nombre o añadiendo la directiva “required” en la etiqueta de texto.

Por ejemplo:

{{*phone_es_:signer1}}

{{phone_es_:signer1:required}}

{{phone_es_:prefill:required}}

Define un campo de texto obligatorio llamado “phone” (teléfono) que rellenará el firmante o que se cumplimentará durante el proceso de prerrellenado.

{{address_es_:signer1}}

Define un campo opcional llamado “address” (dirección) que rellenará el destinatario identificado como “signer1”.

Los campos obligatorios se identifican con el asterisco rojo que se muestra en la parte izquierda del campo.

Borde de campos obligatorios


Campos editables y de solo lectura

De forma predeterminada, todos los campos que no son de solo lectura se pueden editar. Entre las excepciones se incluyen algunos campos especiales de firmante (correo electrónico, nombre del firmante y fecha de firma) que, de forma predeterminada, son de solo lectura. Consulte Campos especiales de solo lectura para obtener más información.

Los campos de solo lectura son útiles cuando se combinan datos automáticamente en un documento de mediante la API de Adobe Sign o con la función de combinación de datos MegaSign. Estos campos evitan que el firmante cambie los datos combinados al firmar.

Añadir un signo de exclamación (!) como prefijo al nombre del campo o utilizar la directiva “readonly” marca un campo como de solo lectura.

Por ejemplo:

{{!price}}

{{price_es_:readonly}}

Define un campo de texto de solo lectura que se debe rellenar combinando datos antes de enviar el documento para su firma.

Procesamiento avanzado de documentos con etiquetas de texto

Tipos de campos adicionales


Casillas de verificación

Puede crear una casilla de verificación con etiquetas de texto colocando la etiqueta “checkbox” en el documento o utilizando la directiva “checkbox”.

{{[]}}{{CB_es_:checkbox}}

Coloca una casilla de verificación sin nombre dentro de un documento.

{{[x]}}{{CB1_es_:checkbox(checked)}}

Coloca una casilla de verificación sin nombre que está marcada de forma predeterminada en un documento.

{{[]Comm_es_:signer1}}{{Comm_es_:checkbox:signer1}}

Coloca una casilla de verificación llamada “Comm” asignada al destinatario identificado como “signer1”.

{{[]*}}{{CB2_es_:required:checkbox}}

Una casilla de verificación obligatoria sin nombre que el destinatario identificado como “signer1” debe rellenar. Consulte Definición de campos obligatorios u opcionales para obtener más información sobre cómo definir los campos obligatorios.

{{[]!}}{{CB3_es_:readonly:checkbox}}

Una casilla de verificación sin nombre de solo lectura. Consulte Definición de campos obligatorios u opcionales para obtener más información sobre cómo definir los campos obligatorios.

{{CB4_es_:checkbox:label("Acepto.")}}

Define una casilla de verificación con una etiqueta que contiene una descripción sencilla de la casilla de verificación. La etiqueta la ve el firmante durante la firma. En este caso, sería: “Acepto”.


Botones de opción

Las etiquetas de texto se pueden utilizar para definir y colocar botones de opción dentro de un documento. Los botones de opción deben tener por lo menos dos opciones (elecciones) dentro de un grupo de botones de este tipo, que se identifica con el mismo nombre de campo en el documento. Cada opción (elección) del botón de opción debe tener un valor de selección diferente. Los botones de opción se pueden definir con la siguiente sintaxis.

{{(option_value)fieldname_es_}}

Coloca un botón de opción en un documento.

{{(Red)Color_es_:signer1}}

{{(Blue)Color_es_:signer1}}

{{(Green)Color_es_:signer1}}

Define tres botones de opción que pertenecen al mismo grupo denominado “Color” y asignado al destinatario “signer1”. Las opciones tienen los valores “Red” (rojo), “Blue” (azul) y “Green” (verde).

{{Color_es_:signer1:radio(Red)}}

{{Color_es_:signer1:radio(Blue)}}

{{Color_es_:signer1:radio(Green)}}

Otra forma de definir el grupo de botones de opción “Color” usando la directiva “radio”.

{{(Red)Color_es_:signer1:label(“Red”)}}

{{(Blue)Color_es_:signer1:label(“Blue”)}}

{{(Green)Color_es_:signer1:label(“Green”)}}

Define un grupo de botones de opción y le pone a cada botón una etiqueta simple. La etiqueta la ve el firmante durante la firma.

 
Especificación del estilo del botón de opción

Adobe Sign permite crear botones de opción con diferentes estilos. El estilo especificado para el botón de opción se muestra en el PDF. No obstante, durante la firma las opciones de los botones de opción siempre aparecen como círculos.

Estilos de botón de opción


Campos de imagen (en línea)

Los campos de imagen se utilizan para capturar un archivo de imagen, como una fotografía, o bien un documento escaneado (p. ej.: un permiso de conducir). Estas imágenes se pueden extraer del documento firmado. La directiva :inlineimage requiere agregar un parámetro adicional que define la altura del campo. La altura del campo se establece en el tamaño de fuente de la etiqueta y se mide en líneas del valor de dicha fuente.

{{inlineImageEx_es_:signer1:inlineimage(20)}}
Define un campo de imagen con 20 líneas de altura.


Campos de texto de varias líneas

Las etiquetas de texto se pueden utilizar para definir campos de texto que pueden abarcar varias líneas. Estos campos se pueden utilizar en los documentos para recopilar varias líneas de datos durante la firma.

{{largeField_es_:signer1:multiline}}

Define un campo asignado al destinatario identificado como “signer1” y denominado “largeField” que permite al firmante introducir varias líneas de datos en el campo durante la firma.

{{largeField2_es_:signer1:multiline(4)}}

Define un campo asignado al destinatario identificado como “signer1” y denominado “largeField2” que permite al firmante introducir cuatro líneas de datos durante la firma. Si falta el parámetro del número de líneas, el campo permite escribir dos líneas de datos.

Las etiquetas de texto se pueden utilizar para definir y colocar listas desplegables dentro de un documento. Las listas desplegables pueden contener varias opciones. El usuario puede elegir una de estas opciones al firmar el documento. Una definición de lista desplegable consta de dos componentes: un conjunto único de opciones de las cuales el destinatario puede elegir una y, opcionalmente, un conjunto de valores que se devuelven al exportar los datos del acuerdo.

Las opciones desplegables deben ser únicas, aunque no es necesario que los valores correspondientes lo sean también (es decir, se puede exportar el mismo valor desde varias opciones desplegables). Los valores desplegables son opcionales. Si no se define ningún valor desplegable, se devolverán las opciones desplegables cuando se exporten los datos del acuerdo.

Al definir valores desplegables, el número de valores definidos debe coincidir con el número de opciones. Si el número de opciones y valores especificados no coincide, aparece un error y el campo no se trata como lista desplegable.

Al definir una selección predeterminada para una lista desplegable o las condiciones de otro campo según la opción que el destinatario haya seleccionado en la lista desplegable, se deben usar los valores de exportación (no las opciones). Si no hay definido ningún valor de exportación, utilice las opciones desplegables.

{{*Color_es_:signer1:dropdown(options="Red,Green, Blue”)}}

Coloca una lista desplegable obligatoria dentro de un documento. Durante la firma, la lista permite al destinatario identificado como “signer1” seleccionar una de las tres opciones disponibles. Esta lista desplegable no especifica ningún valor de exportación, por lo que la opción seleccionada se exporta desde la página “Gestionar”, a través de la API o desde la página “Informes”.

{{Color_es_:signer1:dropdown(options="Red,Green,Blue”, values=”R,G,B”)}}

Coloca una lista desplegable dentro de un documento. Durante la firma, la lista permite al destinatario identificado como “signer1” seleccionar una de las tres opciones disponibles. En este caso, la lista desplegable también especifica los valores de exportación posibles (R,G,B). Según la opción que haya seleccionado el destinatario durante la firma, el valor correspondiente se exporta desde la página “Gestionar”, a través de la API o desde la página “Informes”. Por ejemplo, si el destinatario selecciona “Red” (rojo), el valor exportado es “R”.

{{Color_es_:signer1:dropdown(options="Red,Green,Blue”, values=”R,,B”)}}

En este ejemplo, las opciones de la lista desplegable son las mismas que las del ejemplo anterior, pero uno de los valores está vacío. Si el destinatario identificado como “signer1” selecciona “Green” (verde) en la lista durante la firma, no se exporta ningún valor para este campo.

{{Color_es_:signer1:dropdown(options="Red,,Blue”, values=”R,G,B”)}}

En este ejemplo, la lista presenta tres opciones al destinatario identificado como “signer1” durante la firma, pero la segunda está en blanco. Si el destinatario selecciona la opción en blanco, el valor exportado es “G”.

Si es necesario, se pueden añadir directivas adicionales a la definición de los campos desplegables, por ejemplo, marcando una lista desplegable como obligatoria, aplicando lógica condicional a dichas listas o especificando que la opción que seleccione el destinatario deba estar enmascarada en el PDF.


Documentos complementarios (archivos adjuntos)

Adobe Sign permite recopilar documentos complementarios de los firmantes durante la firma. Durante la experiencia de firma, Adobe Sign convierte la etiqueta de texto en un campo que el firmante puede seleccionar para cargar un archivo. Los documentos cargados se incorporan al documento firmado, se convierten a PDF y se adjuntan al final del acuerdo firmado después del proceso de firma. Los campos de formulario que recopilan archivos del firmante se definen con la directiva “attachment”.

{{*DriversLicense_es_:signer1:attachment}}

Define un campo obligatorio llamado “DriversLicense” asignado al destinatario identificado como “signer1”. El destinatario debe utilizar este campo para cargar un archivo durante la firma.

{{photo_es_:signer1:attachment:label("Photo")}}

Define un campo opcional llamado “photo” (foto) y asignado al destinatario identificado como “signer1”. El destinatario puede utilizar este campo para cargar una imagen durante la firma. Con la directiva “label”, se puede especificar una descripción sencilla para el campo. La etiqueta la ve el firmante durante la firma.

Definición de un campo de archivo adjunto:

Etiqueta de texto explícita para archivos adjuntos

Campo de archivo adjunto que se ve durante la firma:

Campo de archivo adjunto de ejemplo

Adobe Sign se puede utilizar para especificar hipervínculos en documentos. Los hipervínculos son elementos en los que se puede hacer clic durante la firma y que llevan al destinatario a una ubicación dentro del documento o a una URL externa. También se pueden especificar etiquetas para los hipervínculos de modo que el documento muestre la etiqueta de texto en lugar de la URL directa.

{{companywebsite_es_:link(http://www.adobe.com):label(Adobe)}}

Define un hipervínculo que vincula a una URL externa. Incluye la etiqueta “Adobe”, que se muestra al destinatario durante la firma.

{{doclink_es_:link:page(10):label(Ver esta sección)}}

Define un hipervínculo que vincula a la página 10 del documento actual. Incluye la etiqueta “Ver esta sección”, que ve el destinatario durante la firma.


Sellos de participante e identificadores de transacción (Business y Enterprise)

En los PDF firmados, se pueden añadir sellos de participante e identificadores de transacción para los firmantes. El sello del participante específico aparece una vez que la persona ha firmado o aprobado el documento. Este sello recoge el nombre del participante, la hora del evento de firma/aprobación y el correo electrónico. Los identificadores de transacción y los sellos aparecen en el PDF firmado final.

{{userstamp1_es_:signer1:stamp}}

Define un sello de participante para el destinatario identificado como “signer1”. Este sello aparece en el PDF firmado final.

{{userstamp2_es_:signer2:stamp}}

Define un sello de participante para el destinatario identificado como “signer2”. Este sello aparece en el PDF firmado final.

{{transstamp2_es_:transactionid}}

Define un sello de identificador de la transacción que aparece en el PDF firmado final.

{{userstamp_es_:signer1:stamp:repeat}}

{{transstamp1_es_:transactionid:repeat}}

Define un sello que aparece en la misma ubicación en todas las páginas del PDF firmado final.


Firmas digitales (Enterprise)

En los documentos se pueden añadir firmas digitales. Solo puede haber una firma digital por firmante en cada documento. Si añade más de una firma digital por firmante (por ejemplo, {{digsig1_:signer1: digitalsignature}} y {{digsig2_:signer1: digitalsignature}}), solo se conserva la primera. Las demás se eliminan de forma automática cuando se envía el documento para su firma a menos que se quiten manualmente, antes de enviarlo, en el entorno de vista previa y creación.

{{digsig1_es_:signer1:digitalsignature}}

Define una firma digital para el destinatario identificado como “signer1”.


Firmas con sello

Los sellos son un tipo de campo con una doble finalidad: pueden reemplazar un campo de firma, en el caso de las organizaciones que prefieren firmar con un sello de empresa, o complementar una firma tradicional, de forma parecida a un sello Hanko. Igual que los campos de firma digital, solo se puede definir un campo de sello por destinatario. Los campos de sello son opcionales de forma predeterminada, a menos que estén marcados como obligatorios o que no haya más campos de firma para el firmante.

La altura de los campos de sello se indica con un un parámetro adicional que se debe incluir en la directiva :stampimage y se mide en número de líneas, en función del tamaño de fuente de la etiqueta de texto.

{{Stamp1_es_:signer1:stampimage(28)}}

Define un campo de sello con 28 líneas de altura para el destinatario identificado como “signer1”.


Especificación de valores predeterminados

Adobe Sign permite especificar el valor predeterminado de un campo mediante etiquetas de texto. El valor predeterminado especificado se muestra a los participantes durante la firma.

Directiva de etiqueta de texto

Ejemplo

:default

:default("Valor predeterminado especificado entre comillas dobles")

:default('Valor predeterminado especificado entre comillas simples')

Si el valor predeterminado contiene una comilla simple o apóstrofo, el valor predeterminado se debe escribir entre comillas dobles. Por ejemplo: {{location_es_:signer1:default("Empresa del firmante")}}. Si las comillas dobles son obligatorias en el valor predeterminado, este debe ir entre comillas simples.

Especificación de elementos de información

Las etiquetas de texto también permiten especificar elementos de información en los campos de formulario de Adobe Sign. Los elementos de información se muestran al destinatario durante la firma.

Directiva de etiqueta de texto

Ejemplo

:tooltip

:tooltip("Proporcione una copia de su permiso de conducir")

:tooltip('Elija un color')


Especificación del aspecto de la fuente

Las etiquetas de texto se pueden utilizar para cambiar el aspecto de la fuente utilizada en el campo de modo que se sobrescriban el nombre, el color y el tamaño de la fuente que se utilizan en la etiqueta de texto. Para especificar un nombre de fuente, utilice el nombre de cualquier fuente en el documento existente o de alguna de las siguientes: Lato, Roboto, Slabo 13px, Source Serif Pro, Source Sans Pro o Source Code Pro. Para especificar el color, utilice el valor hexadecimal RGB o cualquiera de los siguientes valores de color válidos: blanco, gris claro, gris oscuro, negro, rojo, rosa, naranja, amarillo, verde, magenta, cian o azul. De forma predeterminada, el nombre y el tamaño de la fuente son los de la primera llave “{” que hay al principio de la etiqueta de texto.

Directiva de etiqueta de texto

Ejemplo

:font

:font(name=Lato, color=#FF0000, size=12) establece que el campo tendrá la fuente Lato en color rojo y un tamaño de texto de 12 puntos.

 

:font(name=Source Code Pro, color=green, size=14) establece que el campo tendrá la fuente Source Code Pro en color verde y un tamaño de texto de 14 puntos.


Especificación de la alineación de los campos

Las etiquetas de texto permiten alinear los valores introducidos en los campos de formulario. De forma predeterminada, los valores de los campos de formulario se alinean a la izquierda. Sin embargo, usando directivas en las etiquetas de texto, los campos de formulario se pueden alinear en el centro o a la derecha.

Directiva de etiqueta de texto

Ejemplo

:align(alignment)

:align(left): alinea el texto del campo a la izquierda. Este es el comportamiento predeterminado para los campos de formulario. No es necesario aplicar la directiva.

:align(right): alinea los datos del campo a la derecha.

:align(center): centra los datos introducidos en el campo de formulario.


Especificación de campos repetidos

Las etiquetas de texto permiten repetir los mismos campos en todas las páginas del documento sin tener que copiar la etiqueta de texto en cada una de las páginas. Esto puede resultar muy útil, por ejemplo, para los campos de firma o los sellos de participante en documentos muy largos.

Directiva de etiqueta de texto

Ejemplo

:repeat

:stamp:repeat: copia el sello de participante en la misma ubicación en todas las demás páginas del documento. Es necesario definir una función de firmante para el sello (por ejemplo, “signer1” o “signer2”).

:signature:repeat: copia el campo de firma en la misma ubicación en todas las demás páginas del documento. Es necesario definir una función de firmante para el sello (por ejemplo, “signer1” o “signer2”).

:repeat(even): copia el campo en la misma ubicación en las páginas pares del documento.

:repeat(odd): copia el campo en la misma ubicación en las páginas impares del documento.

:repeat(after): copia el campo en la misma ubicación en todas las páginas posteriores a aquella en la que se añade el campo.

:repeat(before): copia el campo en la misma ubicación en todas las páginas anteriores a aquella en la que se añade el campo.

:repeat(2,10), :repeat(6-9) y :repeat(2,6-9): copia el campo en la misma ubicación en la página o los intervalos de páginas especificados del documento.


Especificación de reglas de validación de datos

Adobe Sign admite distintos tipos de validación de campo especificados mediante directivas adicionales de etiquetas de texto. Las reglas de validación de datos que se especifican se aplican cuando el firmante rellena los datos durante la firma. Adobe Sign no permite que el destinatario complete el proceso de firma si los datos introducidos no cumplen la regla de validación especificada.

Por ejemplo:

 

{{*Mobile_es_:signer1:phone}}

Define un campo obligatorio llamado “Mobile” (móvil) asignado al destinatario identificado como “signer1”. El destinatario debe escribir un número de teléfono válido en este campo durante la firma.

 

{{Birthday_es_:signer2:isdate}}

Define un campo denominado “Birthday” (fecha de nacimiento) asignado al destinatario identificado como “signer2”. El destinatario debe introducir un valor de fecha durante la firma.

 

Algunos tipos de validación de campo pueden tener parámetros extra que restrinjan los valores permitidos en el campo.

 

{{duration_es_:signer1:num(>=0,<=60)}}

Define un campo opcional llamado “duration” (duración) cuyo valor debe estar entre 0 y 60.

 

{{tenNum_es_:signer1:string(char=num,maxlen=10)}}

Define un campo opcional denominado “tenNum” (diez números) que permite introducir un máximo de 10 dígitos.


Reglas admitidas para la validación de campos

Tipo de validación

Directiva de etiqueta de texto

Parámetros y valores
opcionales
Muestras

Cadena

:string

char

alpha: solo letras

:string
:string(char=alpha)

:string(char=num)


:string(char=alphanum)


:string(maxlen=10)
:string(char=alpha,maxlen=10)

 

num: solo números

 

alphanum: letras y números

maxlen

Longitud máxima determinada

Número

:num

>=

Mayor que o igual a

:num

:num(<=1000)

:num(>=50,<=500)

<=

Menos que o igual a

Moneda

:curr

country

:curr

:curr(country=us)

:curr(country=uk)

:curr(<=500)

:curr(country=us,<=100)

>=

<=

Porcentaje

:pct

>=

Mayor que o igual a

:pct

:pct(>=50)

:pct(>=0,<=100)

<=

Menos que o igual a

Fecha

:isdate

format

mm/dd/yy (predeterminado)

:isdate

:isdate(format=dd/mm/yy)

mm/dd/yyyy

dd/mm/yy

dd/mm/yyyy

mm/yy

Tiempo

:time

  :time

Correo electrónico

:isemail

  :isemail

Código postal

:zip

country

us: formato de código postal predeterminado de EE. UU.

:zip

:zip(country=uk)

uk: formato de código postal del Reino Unido

Código postal extendido (ZIP + 4)

:zip4

  :zip4

Teléfono

:phone

country

us: formato predeterminado de números de teléfono de EE. UU.

:phone

:phone(country=uk)

uk: formato de número de teléfono del Reino Unido

Número de la Seguridad Social

:ssn

  :ssn

Uso de una expresión regular para validar datos en una etiqueta de texto

:custom

regexp

Expresión regular presentada en forma de cadena. Consulte la nota que aparece abajo.

:custom(regexp="^5[1-5][0-
9]{14}$")



msg

Mensaje que ve el destinatario cuando los datos no coinciden con la expresión especificada.

:custom(regexp="^.{3}$",msg="Hay tres caracteres seguidos que no coinciden.")

Nota:

En esta sintaxis, el carácter de barra invertida que forma parte de las estructuras regexp, como “\w”, se debe escapar siempre con otra barra igual, es decir, “\\w”. Para buscar una barra invertida, hay que usar \\\\. Los caracteres de inicio y fin de la cadena son las comillas dobles ("). Cuando se prevea la aparición de comillas en los datos que escribirá el destinatario, para proporcionar una cadena de validación de regexp que coincida con las comillas, estas se deben escapar anteponiéndoles una barra invertida (\") en la expresión. Aquí puede consultar una buena referencia sobre la sintaxis de las expresiones regulares que emplea Adobe Sign.

Un campo solo puede incluir una directiva para la validación. Si se incluyen varias reglas de validación en una misma etiqueta de texto, solo se aplica la primera de ellas. Todas las reglas de validación siguientes se omiten.

Enmascaramiento de datos confidenciales

Adobe Sign permite enmascarar los datos confidenciales que se recopilan durante la firma añadiendo una directiva determinada en la etiqueta de texto. Durante la firma, los datos que el firmante introduce en un campo de este tipo se convierten en asteriscos (*) o en el carácter de enmascaramiento que haya definido el usuario en cuanto el firmante sale del campo. Los datos que introduce el firmante tampoco se muestran a las siguientes personas que firman ni aparecen en el PDF cumplimentado. Los datos que el firmante ha introducido se pueden exportar desde Adobe Sign o a través de la API de Adobe Sign.

Definición de etiqueta de texto:

Etiqueta de enmascaramiento de ejemplo

 

Durante la firma:

Campo enmascarado de ejemplo

 

En el PDF final:

Resultado del enmascarado en el documento final

{{*CC_es_:signer1:mask}}

Define un campo obligatorio llamado “CC” y asignado al destinatario “signer1”, que se enmascara durante la firma.

{{*CC_es_:signer1:mask(char=-)}}

Define un campo obligatorio llamado “CC” asignado al destinatario identificado como “signer1”, que se enmascara durante la firma con el signo “-”. Si no se especifica ningún carácter en la etiqueta de texto, se usa el asterisco (*) como carácter predeterminado de enmascaramiento.


Especificación de reglas condicionales para los campos

Adobe Sign permite aplicar reglas condicionales a los campos de un documento. Las reglas condicionales se pueden utilizar para definir cuándo mostrar u ocultar al firmante un campo concreto de un documento durante la firma.

Las condiciones aplicadas a un campo determinado se basan en los valores de uno o varios campos del documento. Las reglas condicionales aplicadas a un campo concreto también pueden especificar que este se muestre o se oculte cuando se cumplan todas o cualquiera de las condiciones definidas para dicho campo.

{{_es_:signer1:showif(condition)}}

{{_es_:signer1:showifany(condition)}}

Mostrar el campo al destinatario identificado como “signer1” si se cumple cualquiera de las condiciones definidas.

{{_es_:signer1:showifall(condition)}}

Mostrar el campo al destinatario identificado como “signer1” únicamente si se cumplen todas las condiciones definidas.

{{_es_:signer1:hideif(condition)}}

{{_es_:signer1:hideifany(condition)}}

Ocultar el campo al destinatario identificado como “signer1” si se cumple cualquiera de las condiciones definidas.

{{_es_:signer1:hideifall(condition)}}

Ocultar el campo al destinatario identificado como “signer1” únicamente si se cumplen todas las condiciones definidas.

{{_es_:signer1:enableif(condition)}}

{{_es_:signer1:enableifany(condition)}}

Activar el campo para el destinatario identificado como “signer1” si se cumple cualquiera de las condiciones definidas. Esta se parece a la condición “showif” con la diferencia de que, si la condición no se cumple, el aspecto del campo durante la firma es visible, pero está atenuado y no se puede editar. El campo atenuado muestra el valor predeterminado del campo (si procede). El valor también aparece en el PDF firmado.

{{_es_:signer1:enableifall(condition)}}

Activar el campo para el destinatario identificado como “signer1” únicamente si se cumplen todas las condiciones definidas.

{{_es_:signer1:disableif(condition)}}

{{_es_:signer1:disableifany(condition)}}

Desactivar el campo para el destinatario identificado como “signer1” si se cumple cualquiera de las condiciones definidas. El campo desactivado aparece atenuado durante la firma. Si hay un valor de campo predeterminado, el valor de un campo desactivado sigue apareciendo en el PDF firmado.

{{_es_:signer1:disableifall(condition)}}

Desactivar el campo para el destinatario identificado como “signer1” únicamente si se cumplen todas las condiciones definidas.

Una condición se define con el formato valor del operador de nombreDeCampo, donde nombreDeCampo es el nombre del campo de formulario que hay en el documento en el que se basa la condición. En las tablas siguientes, se recogen los operadores admitidos y los valores válidos para los diferentes campos de formulario que se admiten.

Operadores de campo condicionales

Operador

Significado

Valor

Ejemplo

=, ==, eq

Igual a

Valor único

myCheck=checked

!=, <>, neq

No es igual a

Valor único

signature!=signed

<, lt

Menor que

Un solo valor numérico

myNumber < 10

>, gt

Mayor que

Un solo valor numérico

myNumber > 40

<=, lte

Menos que o igual a

Un solo valor numérico

myNumber <= 15

>=, gte

Mayor que o igual a

Un solo valor numérico

myNumber >= 0

?=, in

En

Lista delimitada por comas que debe ir entre comillas o paréntesis

option ?="1,2,3"

?!=,!in, not in, notin

No está en

Lista delimitada por comas que debe ir entre comillas o paréntesis

option ?!= "1,2,3"

~=, contains

Contiene

Valor único

Title ~= Manager

~!=, !contains, not contains, notcontains

No contiene

Valor único

Title ~!= Junior

Si un campo tiene varias condiciones, estas se pueden separar con una coma. Por ejemplo:

{{notRed_es_:showifall(checkbox=checked,Color!=Red)}} define un campo denominado “notRed” (no rojo) que ve el firmante cuando se cumplen las dos condiciones.

 

Valor de campo condicional para los campos admitidos de etiqueta de texto

Tipo de campo

Valores válidos

Ejemplo

Firma

signed, unsigned

signHere=signed

Iniciales

signed, unsigned

initHere!=signed

Casilla de verificación

checked, unchecked

myCheck=checked

Botón de opción

Valor de las opciones de los botones de opción

Color=Red

Campos de texto

Valor del campo de texto

Title!=Senior Title~=Chief Price>100

Las condiciones se pueden asignar a cualquier campo, incluidos los campos obligatorios, como los de iniciales, de firma y los bloques de firma. Cuando se define una condición en un campo obligatorio, este solo se considera obligatorio si la condición hace que el campo sea visible para el firmante durante la firma. Es decir, si un campo de firma tiene una condición que lo oculta, el firmante no lo puede ver y, por lo tanto, no es necesario que proporcione su firma en este campo concreto. El recuento de “campos obligatorios” que hay al final de la página de firma se actualiza de forma dinámica en función de las condiciones definidas para reflejar exactamente el número de campos que el firmante debe cumplimentar antes de terminar de firmar el documento.

Cada firmante debe contar con un campo de firma que no tenga ninguna condición asignada. Debido a esto, si todos los campos de firma de un firmante determinado tienen una condición, se añada un bloque de firma nuevo para ese firmante al final del documento.


Especificación de las fórmulas de cálculo para los campos

Adobe Sign permite rellenar de forma dinámica valores de campo en un documento durante la firma partiendo de otros valores de campo o de las elecciones que haya hecho el cliente durante la firma. Estos tipos de campos se denominan campos calculados.

Las fórmulas de cálculo se pueden definir como se hace con otros campos del documento utilizando etiquetas de texto o el entorno de creación de Adobe Sign que permite arrastrar y colocar. Una fórmula de cálculo puede hacer referencia a uno o varios campos ya existentes en el documento y también se puede basar en otro campo calculado que haya en el documento. Los cálculos se pueden aplicar a campos numéricos, de fecha y de texto.

Además de calcular el valor de un campo en el documento, los campos calculados pueden incluir información de formato para lograr que el valor calculado tenga un diseño adecuado en el documento. También se pueden aplicar reglas adicionales como las condicionales y el enmascaramiento de campos, entre otras, a los campos calculados mediante las etiquetas de texto.

 

f1_es_:signer1:calc(formula)

Un campo calculado asignado al destinatario identificado como “signer1”. Su valor se calcula automáticamente con la fórmula definida.

 

f2_es_:signer1:calc(formula):format(formatType, format)

Un campo calculado asignado al destinatario identificado como “signer1”. El valor se calcula a partir de la fórmula definida. El valor de salida resultante es de un tipo concreto y se le aplica el formato especificado.

Ejemplo: un campo calculado se puede utilizar para calcular, de forma dinámica, la cuantía total de los impuestos adeudados en un pedido.

{{Tax_es_:signer1:calc([subtotal] * [taxrate]):format(number, "$,.00")}}

El cálculo de los impuestos se basa en el coste total de los artículos que ha pedido el cliente y en la tasa impositiva correspondiente al estado de residencia del firmante. El valor impositivo que resulta del cálculo está precedido por el símbolo del dólar ($) e incluye dos decimales. Por ejemplo, si el subtotal es 1250 y la tasa impositiva es del 6,25 %, el valor calculado resultante que aparece en el campo “Tax” (impuestos) del documento es $1328,13.

Para obtener más información sobre los campos calculados y cómo utilizarlos en los documentos, consulte la guía de referencia Campos calculados.


Acortamiento de etiquetas de texto

Las etiquetas de texto constituyen un método muy práctico para definir distintos tipos de campos dentro de un documento, asignarlos a firmantes concretos, especificar reglas de validación en los campos o aplicarles reglas condicionales. Si aplicamos todo esto a un mismo campo de formulario, podemos acabar con una definición de campo muy larga que podría modificar la estructura del documento. Además, como cada definición de campo debe caber en una línea, el uso de varias directivas complejas puede dificultar mucho el diseño del documento. Para garantizar la coherencia en la estructura del documento, Adobe Sign cuenta con un mecanismo para definir etiquetas de texto acortadas dentro del documento. Una etiqueta de texto acortada consta de dos partes:

  • Etiqueta de referencia: una definición de la etiqueta acortada que se coloca en la ubicación correcta dentro del documento. La etiqueta de referencia controla el tamaño y la ubicación del campo de formulario en el documento. Una etiqueta de referencia tiene la siguiente sintaxis: {{$shortened_name}}. Por ejemplo, {{$r}} define una etiqueta de referencia donde “r” es el nombre corto de la etiqueta. El tamaño del campo puede ajustarse colocando espacios en blanco inmediatamente después de la última llave de apertura o justo antes de la primera llave de cierre.
  • Etiqueta de definición: hace referencia a la definición completa de una etiqueta determinada y se puede definir en cualquier parte del documento. El tamaño y la ubicación de la etiqueta de definición no determinan el tamaño y la ubicación del campo de formulario en el documento. Una etiqueta de definición tiene la siguiente sintaxis:

{{#shortened_name=Standard Tag Syntax}}. Por ejemplo, {{#r=[]ReceiveCommunication_es_:signer1}} contiene una definición de etiqueta completa para la etiqueta de referencia denominada “r”. En este ejemplo, la etiqueta define una casilla de verificación asignada al destinatario identificado como “signer1”.

 

En el ejemplo siguiente, vemos dos etiquetas de referencia colocadas dentro de un documento.

Etiqueta acortada simple

 

La definición completa de las dos etiquetas de referencia se establece en otra parte del documento, como vemos en la imagen siguiente.

Ejemplo de referencias de etiquetas acortadas

La definición completa de las etiquetas de texto es muy larga. Sin la posibilidad de definir etiquetas acortadas en la ubicación correcta dentro del documento, no habría sido posible mantener la estructura del documento original.


Eliminación de páginas del documento final

Al separar las ubicaciones de campo de formulario de la definición del campo, es posible que todas las definiciones de las etiquetas que haya en un documento se coloquen al final de este o en una página independiente dentro de él. Cuando el documento se envía a través de Adobe Sign, se procesan todas las etiquetas de texto y aparece un cuadro blanco encima de la definición de la etiqueta de texto, de forma que el firmante ya no ve el texto. Esto puede hacer que haya páginas en blanco en el documento después del procesamiento en Adobe Sign. Son páginas que solo contienen etiquetas de texto. Para evitar que en el documento haya páginas en blanco extra que no sirven, Adobe Sign permite usar una definición de etiqueta de texto especial para quitar una página determinada del documento procesado final que genera Adobe Sign antes de enviarlo para firmar.

{{#REMOVE_PAGE_FROM_OUTPUT}}

Directiva especial que da la orden a Adobe Sign de eliminar la página en la que aparece esta directiva del documento procesado final. La etiqueta puede aparecer en cualquier parte de la página. Un documento que se envía a Adobe Sign debe contener por lo menos una página. Si esta directiva aparece en todas las páginas de un documento enviado a Adobe Sign, la primera página no se elimina.

Ejemplos avanzados de las etiquetas de texto

A continuación, se muestran varios ejemplos de etiquetas de texto con la descripción de cada etiqueta.

Casillas de verificación

{{[]_es_:signer1}}

Una casilla de verificación asignada al destinatario identificado como “signer1”.

{{[]*}}

Una casilla de verificación obligatoria.

{{[]!}}

Una casilla de verificación de solo lectura.


Botones de opción

{{(Daily)Rate_es_:signer1}}

Un botón de opción asignado a “signer1” con el valor “Daily” (diario).


Lista desplegable

{{*Color_es_:signer1:dropdown(options= "Red,Green,Blue”)}}

Una lista desplegable obligatoria con tres posibles opciones. La lista se asigna al destinatario identificado como “signer1”.

{{Color_es_:signer1:dropdown(options= "Red,Green,Blue”):default(“Red”)}}

Una lista desplegable con tres posibles opciones donde la opción “Red” (rojo) está seleccionada de forma predeterminada. La lista se asigna al destinatario identificado como “signer1”. Si el valor se especifica en la definición de la lista desplegable, aquel debe usarse para especificar el valor predeterminado; si no, se usa la opción.

{{Color_es_:dropdown(options=Red,Green,Blue”

,

values=”R,G,B”):default(“R”):mask}}

Una lista desplegable no asignada a ningún destinatario con tres posibles opciones que se corresponden con tres valores de exportación.

El valor “R” correspondiente a la opción que ha elegido el destinatario, “Red”, está seleccionado de forma predeterminada y la opción seleccionada resultante se enmascara (aparece como “*”) en el PDF.

{{Color_es_:dropdown(options= "Red,Green,Blue”):showif(Rate=”Daily”)}}

Una lista desplegable no asignada a ningún destinatario con tres posibles opciones. La lista desplegable solo se muestra si es el valor del botón de opción llamado “Rate” (tasa) es igual a “Daily” (diaria).


Validación de campos

{{Birthday_es_:signer2:isdate}}

Un campo de fecha opcional para que el destinatario identificado como “signer2” escriba las fechas en el formato de fecha de EE. UU.

{{*Zip2_es_:signer2:zip}}

Un campo obligatorio para que el destinatario identificado como “signer2” escriba un código postal válido. El campo valida el valor que ha introducido el destinatario.


Acortamiento de etiquetas de texto

 

{{$r}}

Una etiqueta de referencia que especifica la ubicación de un campo.

 

{{#r=[]Spouse_es_:prefill}}

Una definición de una casilla de verificación que el remitente debe prerrellenar.

El acortamiento de etiquetas de texto también puede utilizarse como funciones, no solo para reemplazar un campo entero.

Por ejemplo, vamos a usar la etiqueta siguiente:

{{field1_es_:signer1:showif(fieldA=‘Yes)}}

La etiqueta anterior se puede acortar del modo siguiente:

{{field_es_:$A:$B}}

#A=signer

#B=showif(fieldA=‘Yes’)

El acortamiento de etiquetas de texto también puede comportarse como métodos para cálculos. Por ejemplo, vamos a usar la etiqueta siguiente:

{{field1_es_:calc(a * b / c)}}

La etiqueta anterior se puede acortar del modo siguiente:

Field1_es_:$1(a,b,c)

#1(option1, option2, option3) = calc([option1] * [option2] / [option3])


Reglas condicionales

{{f_es_:hideifall(sig=unsigned,initials=unsigned}}

Un campo que solo se muestra si tanto “sig” como “initials” se han firmado.

{{*emailAddress_es_:signer1:isemail:showif (TypeOfComm="receiveEmail")}}

Un campo obligatorio para que el destinatario identificado como “signer1” escriba una dirección de correo electrónico válida. El campo solo se muestra si otro campo denominado “TypeOfComm” tiene el valor “receiveEmail”. El campo valida el valor que ha introducido el destinatario.

{{f_es_:hideifany(Color=”Red”,Color=”Green”}}

Un campo que se oculta si el destinatario elige las opciones de color “Red” (rojo) o “Green” (verde) en la lista desplegable llamada “Color”.


Campos calculados

{{shipState_es_:signer1:calc([billingState])

:showif(sameAs=unchecked)}}

Un campo del documento asignado al primer firmante que solo se muestra cuando otro campo (una casilla de verificación) denominado “sameAs” está sin marcar (“unchecked”). El valor de este campo se rellena automáticamente con el del campo “billingState” que el firmante ha introducido en el documento.

{{total_es_:signer1:calc(q1*pr1)

:format(Number,”$,0.00”):align(right)}}

Un campo del documento asignado al destinatario identificado como “signer1”. El valor se calcula automáticamente como el producto de los valores que hay en los campos “q1” y “pr1”. El valor resultante, que tiene formato de moneda, está precedido por el símbolo del dólar ($) y tiene dos decimales. Además, está alineado a la derecha dentro del campo.

{{price_es_:signer1:calc(if(pn1=”W1”,9.99, if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}}

Un campo del documento denominado “price” (precio) que se calcula a partir del valor que ha seleccionado el firmante en otros campos “pn1” en el documento. En este ejemplo, si el campo “pn1” es igual a W1, el valor mostrado en el campo “price” (precio) es 9.99; si el campo “pn1” es igual a W2, el valor mostrado en el campo “price” es 5.99, y así sucesivamente. Si ninguno de los valores coincide con el valor del campo “pn1”, el valor mostrado en “price” es 0. Con este método, los campos calculados se pueden utilizar para rellenar automáticamente el precio de un elemento según lo que haya seleccionado un usuario durante la firma.

Para obtener más información sobre los campos calculados, consulte la guía de referencia Campos calculados.


Versión descargable de esta guía

Descargar

Esta obra está autorizada con arreglo a la licencia de Reconocimiento-NoComercial-CompartirIgual 3.0 Unported de Creative Commons.  Los términos de Creative Commons no cubren las publicaciones en Twitter™ y Facebook.

Avisos legales   |   Política de privacidad en línea