Etiquetas de texto: conceptos básicos y sintaxis

Comprenda la estructura exacta que requieren las etiquetas de texto para que los campos se reconozcan correctamente y se comporten según lo esperado.

Las etiquetas de texto le permiten crear campos de formulario escribiendo marcadores de posición estructurados directamente en el documento. Son rápidas y potentes, pero solo funcionan cuando la sintaxis es exacta.

Esta Página explica la estructura requerida de una etiqueta de texto, qué hace cada parte y las reglas que deben seguirse para que las etiquetas se reconozcan correctamente.

Delimitador de etiqueta requerido (llaves)

Cada etiqueta de texto debe estar delimitada por llaves dobles:

{field-name_es_:signer-role:field-type:directive1:directive2}}

Las llaves son obligatorias y tienen dos propósitos:

• Le dicen a acrobat sign dónde comienza y termina la etiqueta de texto.
• Definen el ancho y alto inicial del campo generado.
  • El tamaño (fuente) de la primera llave determina la altura del campo. 
    • Un Tamaño de fuente mayor en la primera llave crea campos más altos.
    • El resto de la etiqueta puede tener un Tamaño de fuente diferente, pero debe ser de 2 pt o mayor.
  • El espacio entre las llaves (incluyendo las llaves mismas) determina el ancho total del campo. 
    • Un espaciado más amplio entre llaves crea campos más anchos
    • Los espacios en blanco cuentan.

Si faltan las llaves o están mal formadas, el texto se trata como texto sin formato, no se crea ningún campo y verá el texto de la etiqueta impreso en su formulario después de cargarlo.

Para obtener una orientación más amplia sobre las etiquetas de texto y cuándo usarlas, consulte Información general sobre etiquetas de texto.

La estructura requerida de una etiqueta de texto

Dentro de las llaves, cada etiqueta de texto debe seguir esta estructura:

nombre-campo_es_:función-firmante:tipo-campo:directiva1:directiva2

Esta estructura es estricta.Reordenar elementos u omitir partes requeridas puede resultar en fallas silenciosas o comportamiento no deseado.

Elementos requeridos (en orden)

Nombre del campo

El nombre del campo identifica el campo del formulario en acrobat sign.

• Debe ser único dentro del documento.
• No debe contener espacios.
• Se usa para creación de informes y extracción de datos.

Identificador _es_

El identificador _es_ le dice a acrobat sign que el texto representa una etiqueta de texto.

• _es_ es obligatorio.
• Sin él, la etiqueta se trata como texto sin formato.

Función del firmante

La función del firmante define a qué destinatario pertenece el campo.

• Incluya siempre una función de firmante.
• La función del firmante debe incluir un número para indicar para qué destinatario está destinado el campo. 

Funciones de firmante admitidas

Las etiquetas de texto asignan campos a destinatarios usando funciones de firmante posicionales.

El formato de función de firmante admitido es:

:signerN

Donde N es un número que comienza en 1 y corresponde a la posición del destinatario en el orden de firma.

Ejemplos:

• :signer1 — primer destinatario
• :signer2 — segundo destinatario
• :signer3 — tercer destinatario

Las propias etiquetas de texto no imponen un límite superior.Una función de firmante debe corresponder a un destinatario real en el acuerdo para que el campo se asigne.

Las etiquetas de texto no admiten funciones con nombre o semánticas.Solo se reconocen las funciones de firmante posicionales.

La excepción a la regla es la función :prefill:

• :prefill — Campos que se asignan al remitente del acuerdo y deben rellenarse después de enviar el acuerdo, pero antes de notificar al primer firmante.
  • No se usa ningún número porque esta posición ocurre antes del ciclo de firma real.

Tipo de campo

El tipo de campo determina el tipo de campo de formulario que se crea.

Los ejemplos comunes incluyen:

• :text
• :signature
• :date
• :checkbox

Solo se reconocen los tipos de campo admitidos.Los tipos de campo no admitidos se ignoran.

Para obtener la lista completa y el comportamiento específico del campo, consulte Tipos de campo admitidos de etiquetas de texto.

Directivas (opcional)

Las directivas modifican el comportamiento del campo.

Algunos ejemplos son:

• :required
• :tooltip()
• :readOnly
• :calc()
• :format()

Las directivas deben aparecer después del tipo de campo y deben seguir la sintaxis correcta.

Para interacciones complejas de directivas, consulte Comportamientos avanzados de etiquetas de texto.

Ejemplo: una etiqueta de texto completa y válida

{full_name_es_:signer1:text:required:tooltip(Enter your full legal name)}}

Esta etiqueta:

• Usa llaves para definir el límite y el tamaño del campo
• Crea un campo de texto
• Lo asigna al primer firmante
• Lo hace obligatorio
• Muestra una ayuda contextual al firmante

Para ejemplos simples y compuestos adicionales, consulte Ejemplos de etiquetas de texto.

Reglas importantes que debe entender desde el principio

Las etiquetas de texto son inflexibles por diseño.Tenga en cuenta estas reglas:

• Las etiquetas se procesan cuando se carga el documento.
• No hay validación durante la creación.
• Los errores no generan advertencias.
• Las etiquetas con formato incorrecto se tratan como texto sin formato.

Si algo no funciona, asuma primero un problema de sintaxis y consulte Solución de problemas de etiquetas de texto.