Tag di testo - Nozioni di base e sintassi

Comprendi la struttura esatta richiesta dai tag di testo affinché i campi vengano riconosciuti correttamente e si comportino come previsto.

I tag di testo ti consentono di creare campi modulo digitando segnaposto strutturati direttamente nel documento. Sono veloci e potenti, ma funzionano solo quando la sintassi è esatta.

Questa pagina spiega la struttura richiesta di un tag di testo, cosa fa ogni parte e le regole che devono essere seguite affinché i tag vengano riconosciuti correttamente.

Racchiusura tag richiesta (parentesi graffe)

Ogni tag di testo deve essere racchiuso in doppie parentesi graffe:

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

Le parentesi graffe sono richieste e servono a due scopi:

• Indicano ad Acrobat Sign dove inizia e finisce il tag di testo.
• Definiscono la larghezza e l'altezza iniziali del campo generato.
  • La dimensione (font) della prima parentesi graffa determina l'altezza del campo. 
    • Una dimensione del font maggiore sulla prima parentesi graffa crea campi più alti.
    • Il resto del tag può avere una dimensione del font diversa, ma deve essere di 2pt o superiore.
  • Lo spazio tra le parentesi graffe (incluse le parentesi graffe stesse) determina la larghezza complessiva del campo. 
    • Una spaziatura più ampia tra le parentesi graffe crea campi più larghi
    • Gli spazi vuoti contano.

Se le parentesi graffe mancano o sono malformate, il testo viene trattato come testo normale, non viene creato alcun campo e vedrai il testo del tag stampato sul modulo dopo il caricamento.

Per un orientamento più ampio sui tag di testo e quando utilizzarli, consulta Panoramica dei tag di testo.

La struttura richiesta di un tag di testo

All'interno delle parentesi graffe, ogni tag di testo deve seguire questa struttura:

nome-campo_es_:mansione-firmatario:tipo-campo:direttiva1:direttiva2

Questa struttura è rigorosa.Riordinare gli elementi o omettere parti richieste può causare errori silenziosi o comportamenti indesiderati.

Elementi richiesti (in ordine)

Nome campo

Il nome del campo identifica il campo del modulo in acrobat sign.

• Deve essere univoco all'interno del documento.
• Non dovrebbe contenere spazi.
• Viene utilizzato per la generazione rapporti e l'estrazione dati.

Identificatore _es_

L'identificatore _es_ comunica ad acrobat sign che il testo rappresenta un tag di testo.

• _es_ è obbligatorio.
• Senza di esso, il tag viene trattato come testo normale.

Mansione del firmatario

La mansione del firmatario definisce a quale destinatario appartiene il campo.

• Includi sempre una mansione del firmatario.
• La mansione del firmatario deve includere un numero per indicare a quale destinatario è destinato il campo. 

Mansioni firmatario supportate

I tag di testo assegnano i campi ai destinatari utilizzando mansioni firmatario posizionali.

Il formato delle mansioni firmatario supportate è:

:signerN

Dove N è un numero che inizia da 1 e corrisponde alla posizione del destinatario nell'ordine di firma.

Esempi:

• :signer1 — primo destinatario
• :signer2 — secondo destinatario
• :signer3 — terzo destinatario

Non esiste un limite massimo imposto dai tag di testo stessi.Una mansione firmatario deve corrispondere a un destinatario effettivo nell'accordo perché il campo venga assegnato.

I tag di testo non supportano mansioni denominate o semantiche.Vengono riconosciute solo le mansioni firmatario posizionali.

L'eccezione alla regola è la mansione :prefill:

• :prefill — Campi assegnati al mittente dell'accordo, che devono essere compilati dopo l'invio dell'accordo, ma prima che il primo firmatario venga notificato.
  • Non viene utilizzato alcun numero perché questa posizione avviene prima del ciclo di firma effettivo.

Tipo di campo

Il tipo di campo determina il tipo di campo modulo che viene creato.

Esempi comuni includono:

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

Vengono riconosciuti solo i tipi di campo supportati.I tipi di campo non supportati vengono ignorati.

Per l'elenco completo e il comportamento specifico dei campi, consulta Tipi di campo supportati dai tag di testo.

Direttive (facoltativo)

Le direttive modificano il comportamento del campo.

Esempi:

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

Le direttive devono apparire dopo il tipo di campo e devono seguire la sintassi corretta.

Per interazioni complesse delle direttive, consulta Comportamenti avanzati dei tag di testo.

Esempio: un tag di testo completo e valido

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

Questo tag:

• Usa le parentesi graffe per definire il limite e la dimensione del campo
• Crea un campo di testo
• Lo assegna al primo firmatario
• Lo rende obbligatorio
• Visualizza una descrizione al firmatario

Per ulteriori esempi semplici e composti, consulta Esempi di tag di testo.

Regole importanti da comprendere fin da subito

I tag di testo sono rigorosi per progettazione.Tieni a mente queste regole:

• I tag vengono elaborati quando il documento viene caricato.
• Non esiste convalida durante l'authoring.
• Gli errori non generano avvisi.
• I tag non validi vengono trattati come testo normale.

Se qualcosa non funziona, considera prima un problema di sintassi e controlla Risoluzione dei problemi dei tag di testo.