Uso dei codici a barre moduli carta

Per specificare una didascalia univoca per il codice a barre moduli carta

  1. Nel modulo selezionare i codici a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Campo, deselezionare Genera etichette automaticamente e digitare una didascalia nella casella Etichetta.

Per generare una didascalia per il codice a barre moduli carta

  1. Nel modulo selezionare i codici a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Campo e selezionare Genera etichette automaticamente.

Per specificare la simbologia dei codici a barre moduli carta

  1. Nel modulo selezionare i codici a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Campo e selezionare una delle opzioni seguenti dall'elenco Simbologia:

    • PDF417

    • Codice QR

    • Matrice dati

    Nota: È necessario che gli utenti finali che compilano un modulo contenente un codice a barre di tipo Codice QR o Matrice dispongano di Acrobat 7.0.5 o versioni successive, oppure di Adobe Reader 7.0.5 o versioni successive. La decodifica di codici a barre di tipo QR e DataMatrix è supportata da Adobe® LiveCycle® Barcoded Forms 7.0, ma non da Adobe® LiveCycle® Barcoded Forms 7.0 Standalone (ST).

Per specificare il metodo di scansione del codice a barre moduli carta

  1. Nel modulo selezionare i codici a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Campo e selezionare una delle opzioni seguenti dall'elenco Metodo di scansione:

    • Scanner a mano

    • Server fax

    • Scanner documenti

    • Personalizzata

  3. Se si seleziona Personalizzato, è possibile specificare anche le impostazioni di decodifica personalizzate.

Per specificare le impostazioni di decodifica personalizzate per i codici a barre moduli carta

  1. Nel modulo selezionare i codici a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Campo, quindi nell'elenco Metodo di scansione selezionare Personalizzato.

  3. Per modificare le proprietà di decodifica, selezionare il valore desiderato dall'elenco Valore accanto alla proprietà.

    Nota: Se si intende decodificare il codice a barre con un apposito scanner palmare, è consigliabile non creare codici a barre che superino quattro pollici (circa 10 cm) di larghezza. Codici a barre alti e stretti in genere funzionano meglio con gli scanner palmari.

Per controllare la modalità di codifica dei dati da parte dei codici a barre moduli carta

Quando si utilizza un oggetto codice a barre moduli carta in una struttura del modulo, è necessario specificare il formato da utilizzare per la codifica dei dati e i dati da codificare. Si possono specificare i tipi seguenti di formato dati:

  • XML

  • Delimitato

Ciascuna opzione fornisce uno script per i codici a barre moduli carta in cui si spiega come utilizzare uno specifico tipo di dati durante la codifica dei dati.

È possibile fornire uno script personalizzato per la codifica dei dati. Per ulteriori informazioni, vedere Per creare uno script personalizzato per la codifica dei dati per un codice a barre moduli carta

Per definire il modo in cui l'oggetto codice a barre moduli carta ottiene i dati, utilizzare le opzioni nella scheda Valore della palette Oggetto. È inoltre possibile specificare se i dati devono essere compressi prima della codifica.

Per generare automaticamente uno script per la codifica dei dati del codice a barre

  1. Nel modulo selezionare i codici a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Valore e selezionare Script automatico.

  3. Dall'elenco Formato, selezionare una delle seguenti opzioni:

    • XML

    • Delimitato

  4. (Facoltativo) Selezionare Includi nomi dei campi e Includi etichetta.

  5. Dall'elenco Applica a, selezionare una delle seguenti opzioni:

    • Dati modulo completi

    • Dati raccolta. Selezionare la raccolta dal menu Raccolta.

Per comprimere i dati prima della codifica:

  1. Nel modulo selezionare i codici a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Valore e selezionare Comprimi dati prima della decodifica.

Per creare uno script personalizzato per la codifica dei dati per un codice a barre moduli carta

In situazioni in cui è necessario seguire specifiche governative o di altro genere per la codifica dei dati, le opzioni di decodifica dati preimpostate potrebbero non soddisfare determinati requisiti. Con l'opzione Personalizzato è possibile fornire uno script personalizzato per la codifica dei dati. Lo script può essere abbastanza semplice, come in questo esempio:

this.rawValue=NumericField1.rawValue

In alternativa, è possibile creare uno script più complesso che determini i campi da codificare in base a determinate condizioni.

  1. Sul modulo selezionare l'oggetto codice a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Valore e deselezionare Script automatico.

  3. Nell'Editor di script, è possibile modificare lo script personalizzato di esempio oppure scrivere uno script.

Il seguente codice di esempio illustra lo script JavaScript richiesto per recuperare i valori di un campo del modulo, formattare una stringa che rappresenta un'istanza CSV e aggiornare i codici a barre moduli carta per un modulo PDF interattivo. Il modulo contiene campi denominati accountNum, formerFirstName, formerMiddleInitial, formerLastName, newFirstName, newMiddleInitial e newLastName.

// This function ensures that the barcode will update 
// when a change is made to any field on the form. 
function depends(node) 
{ 
for (var i = 0; i < node.nodes.length; ++i) 
{ 
var child = node.nodes.item(i); 
if (child.isContainer) 
depends(child); 
} 
} 
// Return a field surrounded by quotes and followed with a separator 
function fmtField(fieldName, separator) 
{ 
      var str = "\"" + fieldName.rawValue + "\"" + separator; 
      return str; 
} 
// Force all fields in the form to be updated in the dataset 
depends(xfa.form);  
// Generate the CSV string that will be encoded in the barcode 
var comma = ","; 
var newLine = "\n"; 
var s = fmtField(accountNum, comma); 
s += fmtField(formerFirstName, comma) 
s += fmtField(formerMiddleInitial, comma); 
s += fmtField(formerLastName, comma); 
s += fmtField(newFirstName, comma) 
s += fmtField(newMiddleInitial, comma); 
s += fmtField(newLastName, newLine); 
// Assign the string to the barcode for encoding 
this.rawValue = s;

Per utilizzare un formato di codifica preesistente

Per impostazione predefinita, in Designer i dati codificati XML sono generati tramite un nuovo formato di codifica che utilizza la funzione JavaScript XFA xfa.record.saveXML(). Tuttavia, se si desidera è possibile applicare il formato di codifica preesistente che utilizza la funzione precedente xfa.datasets.saveXML(). Ad esempio, potrebbe essere necessario elaborare moduli con dati di codice a barre mediante l'uso di un'applicazione in grado di analizzare solo il formato XML precedente.

In Designer 7.0 e 8.0, il formato di codifica preesistente (legacy) è utilizzato negli script XML che controllano i codici a barre moduli carta. L'opzione Usa formato legacy è selezionata automaticamente se si apre un modulo contenente il formato di codifica preesistente (legacy).

  1. Sul modulo selezionare l'oggetto codice a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Valore.

  3. Nell'elenco Formato selezionare XML, quindi applicare un segno di spunta alla casella di controllo Usa formato legacy.

Per specificare un carattere di delimitazione

È possibile specificare il carattere di delimitazione utilizzato per separare i dati dei campi, ad esempio nomi e valori dei campi, nonché le etichette dei codici a barre.

Se vengono impostati caratteri di delimitazione diversi da Ritorno a capo, la prima riga inizia con l'intestazione di etichetta del codice a barre facoltativa seguita dai nomi degli oggetti modulo, e termina con un carattere di delimitazione e un nuovo carattere di riga. La seconda riga inizia con l'etichetta del codice a barre, che per impostazione predefinita corrisponde ad un GUID (identificatore univoco globale); è seguita dai dati dell'oggetto modulo, da un carattere di delimitazione e un nuovo carattere di riga.

Se vengono utilizzati i caratteri di delimitazione Ritorno a capo, i nomi dei campi, le etichette di codice a barre e i valori dei campi vengono riportati su più righe si procede come segue: innanzitutto, su righe separate nell'elenco vengono inclusi i nomi dei campi e le etichette di codice a barre; quindi seguono un carattere di delimitazione ritorno a capo, un nuovo carattere di riga, infine su righe separate vengono inclusi i valori dei campi.

Se un nome o un valore di campo nel modulo è vuoto, lo script di codifica del codice a barre inserisce un carattere di delimitazione e procede a codificare il nome o il colore di campo successivo. Nei dati del codice a barre non è consentito inserire caratteri segnaposto per il testo vuoto quali spazi o contrassegni speciali.

Nota: I numerosi tipi di caratteri di delimitazione disponibili consentono di stabilire quali nomi di campo ed etichette di codice a barre includere nel contenuto del codice a barre; per effettuare questa operazione, nella scheda Valore della palette Oggetto selezionare le opzioni Includi nomi dei campi e Includi etichetta.

Quando si sceglie il formato delimitato per un codice a barre moduli carta, verificare che il carattere di delimitazione non sia incluso nel contenuto di testo del modulo per evitare decodifiche erronee. Ovvero, evitare di selezionare un carattere di delimitazione che possa essere contenuto nel valore campo del codice a barre moduli carta. Se ad esempio si sceglie come carattere di delimitazione una tabulazione, una virgola o uno spazio, il contenuto dei campi del modulo da codificare non deve includere tabulazioni, virgole o spazi, poiché ciò creerebbe confusione durante la decodifica.

In caso di modifiche al contenuto del modulo, è sempre possibile selezionare un altro carattere di delimitazione, lasciando che quello selezionato originariamente diventi parte del contenuto medesimo.

Nota: È consigliabile non utilizzare l'opzione Ritorno a capo come carattere di limitazione, dal momento che questo tipo di carattere è già impiegato nei valori di codice a barre moduli carta come delimitatore per la separazione di intestazione e righe di valore.
  1. Sul modulo selezionare l'oggetto codice a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Valore.

  3. Nell'elenco Formato, selezionare Delimitato, quindi scegliere il tipo di carattere di delimitazione da utilizzare nell'elenco corrispondente.

Per specificare la codifica dei caratteri

È possibile selezionare la codifica dei caratteri per il valore codificato in un codice a barre.

  1. Sul modulo selezionare l'oggetto codice a barre moduli carta.

  2. Nella palette Oggetto, fare clic sulla scheda Valore.

  3. Nell'elenco Codifica caratteri, selezionare l'opzione appropriata in base alle esigenze.