Vai al contenuto principale

Riferimento ai Tag di Testo

I tag di testo sono marcatori formattati in modo speciale posti in un documento Word o PDF. Quando Legalesign elabora il file, questi tag vengono automaticamente convertiti in campi di firma o modulo.

Usa i tag di testo quando vuoi generare campi a partire dal documento sorgente invece di posizionarli manualmente durante la preparazione del modello.

Prima di usare i tag di testo​

Per elaborare i tag di testo al momento del caricamento, vai su Group Settings > Templates, abilita Process text tags on upload, e salva la modifica.

Screenshot della documentazione

Sintassi base​

Un semplice tag di firma appare così:

<<t=signature>>

I marcatori << e >> indicano a Legalesign di interpretare il contenuto come un tag di testo.

Il contenuto all'interno del tag è composto da attributi:

  • forma estesa, ad esempio type=signature
  • forma abbreviata, ad esempio t=signature

Più attributi sono separati da punti e virgola:

<<type=signature;signer=1>>

Versione abbreviata:

<<t=signature;s=1>>

Scorciatoie​

Per i campi comuni puoi saltare la sintassi completa degli attributi e usare un formato più semplice:

  • <<signature>> — aggiunge un campo firma per il firmatario 1
  • <<initials>> — aggiunge un campo iniziali per il firmatario 1
  • <<Full Name>> — aggiunge un campo testo con l'etichetta "Full Name" (può essere qualsiasi etichetta, vedi sotto) da compilare per il firmatario 1

Per assegnare una scorciatoia a un firmatario diverso, aggiungi il numero del firmatario alla fine:

  • <<signature2>> — campo firma per il firmatario 2
  • <<initials3>> — campo iniziali per il firmatario 3
  • <<Full Name2>> — campo testo per il firmatario 2

L'etichetta può contenere lettere, numeri, spazi, trattini e apostrofi. Se l'ultimo carattere è un numero, Legalesign lo interpreta come il numero del firmatario. Se non c'è un numero alla fine, si assume il firmatario 1 come predefinito.

Un caso speciale è la tua firma personale con questo uso:

Per il pieno controllo sul tipo di campo, formattazione, validazione e altre opzioni, usa la sintassi completa degli attributi mostrata di seguito.

Come specificare un firmatario​

Se non specifichi un firmatario, Legalesign assume che il campo sia per il firmatario 1.

I numeri dei partecipanti funzionano così:

  • firmatari: da 1 a 99
  • testimoni: da 101 a 199

Esempi:

  • s=3 significa firmatario 3
  • s=103 significa il testimone associato al firmatario 3

Gli approvatori sono trattati come firmatari senza un campo firma.

Regole comuni​

Dimensione del font​

Se non imposti fontsize o fs, Legalesign cerca di dedurre la dimensione dal documento.

Larghezza del campo​

La larghezza del campo si basa sulla distanza tra il primo < e l'ultimo >. Aggiungi spazi all'interno del tag per aumentare la larghezza. Riduci la larghezza usando attributi abbreviati, testo più piccolo, o una dimensione del font esplicita.

Altezza del campo​

Usa height o h come moltiplicatore dell'altezza della riga corrente:

  • h=2 raddoppia l'altezza
  • h=0.5 dimezza l'altezza

L'attributo h non si applica a firme o iniziali perché utilizzano un rapporto d'aspetto fisso.

Sfondo​

Lo sfondo del campo è sempre bianco.

Obbligatorio o facoltativo​

I campi sono obbligatori per impostazione predefinita. Usa r=0 per rendere un campo facoltativo.

Per le caselle di controllo, imposta r=0 se il firmatario deve poter lasciare la casella deselezionata.

Tipi di campo supportati​

Legalesign supporta quattro tipi principali di campi con tag di testo:

  1. sender: completato durante l'invio
  2. signer: completato da un firmatario
  3. signature: campo firma
  4. initials: campo iniziali

Problemi noti​

L'estrazione della posizione dai PDF è sensibile al layout. Evita:

  • tag che si spezzano su più righe
  • tag che usano un font o un'altezza del testo diversa rispetto al contenuto circostante

Riferimento attributi​

L'unico attributo obbligatorio è type o t.

Screenshot della documentazione

Esempi​

Una firma per un firmatario:

<<t=signature>>

Campo obbligatorio per il mittente con etichetta Our business, valore predefinito My Biz Name e dimensione font 12:

<<t=sender;l=Our business;d=My Biz Name;fs=12>>

Campo obbligatorio per il firmatario 1 che richiede un valore email:

<<t=signer;s=1;f=1>>

Campo a tendina facoltativo per il firmatario 1 con tre valori:

<<t=signer;s=1;r=0;f=20;o=something^or^other>>

Campo obbligatorio per il firmatario 1, allargato e con altezza tripla rispetto alla riga normale:

<<t=signer;s=1;h=3; >>

Codici campo per l'attributo f​

Usa l'attributo field o f per cambiare l'aspetto o la validazione sui campi mittente e firmatario.

  • 1 = Email
  • 2 = aaaa/mm/gg
  • 3 = aa/mm/gg
  • 4 = gg/mm/aaaa
  • 5 = gg/mm/aa
  • 6 = mm/gg/aaaa
  • 7 = mm/gg/aa
  • 8 = aaaa.mm.gg
  • 9 = aa.mm.gg
  • 10 = gg.mm.aaaa
  • 11 = gg.mm.aa
  • 12 = mm.gg.aaaa
  • 13 = mm.gg.aa
  • 14 = aaaa-mm-gg
  • 15 = aa-mm-gg
  • 16 = gg-mm-aaaa
  • 17 = gg-mm-aa
  • 18 = mm-gg-aaaa
  • 19 = mm-gg-aa
  • 20 = Menu a tendina, usando l'attributo options
  • 24 = ✓ / ✗
  • 25 = ✓ / vuoto
  • 26 = ✗ / vuoto
  • 30 = data firma automatica aaaa/mm/gg, solo firmatario
  • 31 = data firma automatica aa/mm/gg, solo firmatario
  • 32 = data firma automatica gg/mm/aaaa, solo firmatario
  • 33 = data firma automatica gg/mm/aa, solo firmatario
  • 34 = data firma automatica mm/gg/aaaa, solo firmatario
  • 35 = data firma automatica mm/gg/aa, solo firmatario
  • 36 = data firma automatica aaaa.mm.gg, solo firmatario
  • 37 = data firma automatica aa.mm.gg, solo firmatario
  • 38 = data firma automatica gg.mm.aaaa, solo firmatario
  • 39 = data firma automatica gg.mm.aa, solo firmatario
  • 40 = data firma automatica mm.gg.aaaa, solo firmatario
  • 41 = data firma automatica mm.gg.aa, solo firmatario
  • 42 = data firma automatica aaaa-mm-gg, solo firmatario
  • 43 = data firma automatica aa-mm-gg, solo firmatario
  • 44 = data firma automatica gg-mm-aaaa, solo firmatario
  • 45 = data firma automatica gg-mm-aa, solo firmatario
  • 46 = data firma automatica mm-gg-aaaa, solo firmatario
  • 47 = data firma automatica mm-gg-aa, solo firmatario
  • 48 = data firma automatica d mmmm aaaa, solo firmatario
  • 50 = Numero intero
  • 51 = Numero
  • 52 = Valuta
  • 53 = 1 cifra
  • 54 = 2 cifre
  • 55 = 3 cifre
  • 56 = 4 cifre
  • 57 = 5 cifre
  • 58 = 6 cifre
  • 59 = 7 cifre
  • 60 = 8 cifre
  • 61 = 9 cifre
  • 62 = 10 cifre