Show Menu
ARGOMENTI×

Uso dei moduli con codice a barre

Informazioni sul servizio moduli con codice a barre

Il servizio moduli con codice a barre automatizza l'acquisizione dei dati dai moduli di compilazione e stampa e integra le informazioni acquisite nei sistemi IT di base dell'azienda.
Il servizio moduli con codice a barre consente di aggiungere codici a barre monodimensionali e bidimensionali ai moduli PDF interattivi. È quindi possibile pubblicare i moduli codici a barre in un sito Web o distribuirli per e-mail o CD. Quando un utente compila un modulo con codice a barre utilizzando Adobe Reader, Acrobat Professional o Acrobat Standard, i codici a barre vengono aggiornati automaticamente per codificare i dati del modulo forniti dall'utente. L'utente può inviare il modulo elettronicamente oppure stamparlo e inviarlo per posta, fax o a mano. In un secondo momento potete estrarre i dati forniti dall’utente come parte di un flusso di lavoro automatizzato, indirizzandoli tra i processi di approvazione e i sistemi aziendali.
Per ulteriori informazioni sul servizio dei moduli con codice a barre, consultate Guida di riferimento ai servizi per AEM Forms .

Decodifica dei dati del modulo con codice a barre

È possibile utilizzare l'API del servizio moduli codici a barre per decodificare i dati da un modulo PDF o da un'immagine che contiene un codice a barre. Per decodifica dei dati del modulo si intende l'estrazione dei dati contenuti nel codice a barre. Prima che i dati possano essere decodificati da un modulo PDF (o da un'immagine), è necessario compilare il modulo con i dati.
Per ulteriori informazioni sul servizio dei moduli con codice a barre, consultate Guida di riferimento ai servizi per AEM Forms .

Riepilogo dei passaggi

Per decodificare i dati da un modulo PDF, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto API formClient con codice a barre.
  3. Ottenere un modulo PDF contenente dati con codice a barre.
  4. Decodificare i dati dal modulo PDF.
  5. Conversione dei dati in un'origine dati XML.
  6. Elaborare i dati decodificati.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-barcodedforms-client.jar
  • adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss)
  • jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss)
  • xercesImpl.jar (nella directory <directory di installazione>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)
Se AEM Forms è distribuito su un server applicazione J2EE supportato che non è JBOSS, dovrai sostituire adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazione J2EE su cui è distribuito AEM Forms. Per informazioni sulla posizione di tutti i file AEM Forms JAR, consultate Inclusione dei file di libreria Java AEM Forms.
Creare un oggetto API client per moduli con codice a barre
Prima di poter eseguire un'operazione del servizio moduli codici a barre a livello di programmazione, è necessario creare un client di servizi Forms con codice a barre. Se utilizzate l'API Java, create un BarcodedFormsServiceClient oggetto. Se si utilizza l'API del servizio Web dei moduli con codice a barre, creare un BarcodedFormsServiceService oggetto.
Ottenere un modulo PDF contenente dati con codice a barre
È necessario ottenere un modulo PDF contenente un codice a barre compilato con i dati utente.
Decodifica dei dati dal modulo PDF
Dopo aver ottenuto un modulo PDF (o un'immagine) contenente un codice a barre, è possibile decodificare i dati. Il servizio Barcoded Forms supporta i seguenti tipi di codici a barre:
  • codici a barre PDF417.
  • Codici a barre della matrice dati.
  • Codici a barre QR.
  • Codici a barre codabar.
  • Codici a barre Codice 128.
  • Codici a barre Codice 39.
  • Codici a barre EAN-13.
  • Codici a barre EAN-8.
L'input del set di caratteri come esadecimale nell'API di decodifica implica che il contenuto del codice a barre è codificato come una stringa esadecimale. Ad esempio, se UTF-8 è specificato come codifica caratteri nel modulo e Hex è specificato nell'operazione di decodifica, il contenuto del codice a barre è codificato come stringa esadecimale nell'elemento < xb:content > nell'output decodificato. Potete convertire questo valore esadecimale per ottenere il contenuto originale creando la logica dell'applicazione nell'applicazione client.
Conversione dei dati in un'origine dati XML
Dopo aver decodificato i dati del modulo, è possibile convertirli in dati XDP o XFDF. Ad esempio, si supponga di voler importare i dati in un altro modulo. Per importare i dati in un modulo XFA, è necessario convertire i dati in dati XDP. Per ulteriori informazioni, vedere Importazione di dati del modulo.
Elaborazione dei dati decodificati
Puoi elaborare i dati convertiti per soddisfare le tue esigenze aziendali. Ad esempio, dopo aver decodificato e convertito i dati, è possibile salvarli in un file, memorizzarli in un database aziendale, compilare un altro modulo e così via. In questa sezione viene illustrato come salvare i dati convertiti come file XML.
Il servizio moduli con codice a barre non è in grado di decodificare i dati del codice a barre se i parametri del delimitatore di riga e del delimitatore di campo hanno lo stesso valore
Consulta anche

Decodifica dei dati del modulo codici a barre tramite l'API Java

Decodificare i dati del modulo utilizzando l'API dei moduli con codice a barre (Java):
  1. Includi file di progetto
    Includete i file JAR client nel percorso di classe del progetto Java.
  2. Creare un oggetto API client per moduli con codice a barre
    Creare un BarcodedFormsServiceClient oggetto utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto che contiene le proprietà di connessione.
  3. Ottenere un modulo PDF contenente dati con codice a barre
    • Creare un java.io.FileInputStream oggetto che rappresenta il modulo PDF contenente dati con codice a barre utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
  4. Decodifica dei dati dal modulo PDF
    Decodificare i dati del modulo richiamando il BarcodedFormsServiceClient metodo dell' decode oggetto e passando i seguenti valori:
    • L' com.adobe.idp.Document oggetto che contiene il modulo PDF.
    • Un java.lang.Boolean oggetto che specifica se decodificare un codice a barre PDF417.
    • Un java.lang.Boolean oggetto che specifica se decodificare o meno un codice a barre matrice dati.
    • Un java.lang.Boolean oggetto che specifica se decodificare o meno un codice a barre del codice QR.
    • Un java.lang.Boolean oggetto che specifica se decodificare un codice a barre codabar.
    • Un java.lang.Boolean oggetto che specifica se decodificare un codice a barre 128.
    • Un java.lang.Boolean oggetto che specifica se decodificare un codice a barre 39.
    • Un java.lang.Boolean oggetto che specifica se decodificare un codice a barre EAN-13.
    • Un java.lang.Boolean oggetto che specifica se decodificare un codice a barre EAN-8.
    • Un valore di com.adobe.livecycle.barcodedforms.CharSet enumerazione che specifica il valore di codifica del set di caratteri utilizzato nel codice a barre.
    Il decode metodo restituisce un org.w3c.dom.Document oggetto contenente dati del modulo decodificati.
  5. Conversione dei dati in un'origine dati XML
    Convertire i dati decodificati in dati XDP o XFDF richiamando il metodo dell' BarcodedFormsServiceClient oggetto extractToXML e passando i seguenti valori:
    • L' org.w3c.dom.Document oggetto che contiene dati decodificati (assicurarsi di utilizzare il valore restituito dal decode metodo).
    • Un valore di com.adobe.livecycle.barcodedforms.Delimiter enumerazione che specifica il delimitatore di riga. È consigliabile specificare Delimiter.Carriage_Return .
    • Un valore di com.adobe.livecycle.barcodedforms.Delimiter enumerazione che specifica il delimitatore di campo. Ad esempio, specificate Delimiter.Tab .
    • Un valore di com.adobe.livecycle.barcodedforms.XMLFormat enumerazione che specifica se convertire i dati del codice a barre in dati XML XDP o XFDF. Ad esempio, specificare XMLFormat.XDP per convertire i dati in dati XDP.
    Non specificare gli stessi valori per i parametri del delimitatore di riga e del delimitatore di campo.
    Il extractToXML metodo restituisce un java.util.List oggetto in cui ogni elemento è un org.w3c.dom.Document oggetto. Esiste un elemento separato per ciascun codice a barre che si trova sul modulo. Se il modulo contiene quattro codici a barre, l' java.util.List oggetto restituito contiene quattro elementi.
  6. Elaborazione dei dati decodificati
    • Scorrere l' java.util.List oggetto per ottenere ogni org.w3c.dom.Document oggetto che si trova nell'elenco.
    • Per ciascun elemento dell'elenco, convertire l' org.w3c.dom.Document oggetto in un com.adobe.idp.Document oggetto. (La logica dell'applicazione che converte un org.w3c.dom.Document 'oggetto in un com.adobe.idp.Document oggetto è mostrata nei dati del modulo con codice a barre decodifica, utilizzando l'esempio di API Java).
    • Salvare i dati XML come file XML richiamando l' com.adobe.idp.Document oggetto copyToFile e passando un oggetto File che rappresenta il file XML.
Consulta anche

Decodifica dei dati del modulo codici a barre tramite l'API del servizio Web

Decodificare i dati del modulo utilizzando l'API dei moduli codici a barre (servizio Web):
  1. Includi file di progetto
  2. Creare un oggetto API client per moduli con codice a barre
    Utilizzando l'assembly client Microsoft .NET che utilizza il servizio WSDL del servizio moduli con codice a barre, creare un BarcodedFormsServiceService oggetto richiamando il relativo costruttore predefinito.
  3. Ottenere un modulo PDF contenente dati con codice a barre
    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento PDF contenente un codice a barre.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream Read metodo dell'oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone binaryData la proprietà con il contenuto dell'array di byte.
  4. Decodifica dei dati dal modulo PDF
    Decodificare i dati del modulo richiamando il BarcodedFormsServiceService metodo dell' decode oggetto e passando i seguenti valori:
    • L' BLOB oggetto che contiene il modulo PDF.
    • Un Boolean oggetto che specifica se decodificare un codice a barre PDF417.
    • Un Boolean oggetto che specifica se decodificare o meno un codice a barre matrice dati.
    • Un Boolean oggetto che specifica se decodificare o meno un codice a barre del codice QR.
    • Un Boolean oggetto che specifica se decodificare un codice a barre codabar.
    • Un Boolean oggetto che specifica se decodificare un codice a barre 128.
    • Un Bolean oggetto che specifica se decodificare un codice a barre 39.
    • Un Boolean oggetto che specifica se decodificare un codice a barre EAN-13.
    • Un Boolean oggetto che specifica se decodificare un codice a barre EAN-8.
    • Un valore di CharSet enumerazione che specifica il valore di codifica del set di caratteri utilizzato nel codice a barre.
    Il decode metodo restituisce un valore di stringa contenente dati del modulo decodificati.
  5. Conversione dei dati in un'origine dati XML
    Convertire i dati decodificati in dati XDP o XFDF richiamando il metodo dell' BarcodedFormsServiceService oggetto extractToXML e passando i seguenti valori:
    • Un valore di stringa che contiene dati decodificati (assicurarsi di utilizzare il valore restituito dal decode metodo).
    • Un valore di Delimiter enumerazione che specifica il delimitatore di riga. È consigliabile specificare Delimiter.Carriage_Return .
    • Un valore di Delimiter enumerazione che specifica il delimitatore di campo. Ad esempio, specificate Delimiter.Tab .
    • Un valore di XMLFormat enumerazione che specifica se convertire i dati del codice a barre in dati XML XDP o XFDF. Ad esempio, specificare XMLFormat.XDP per convertire i dati in dati XDP.
    Non specificare gli stessi valori per i parametri del delimitatore di riga e del delimitatore di campo.
    Il extractToXML metodo restituisce un Object array in cui ogni elemento è un' BLOB istanza. Esiste un elemento separato per ciascun codice a barre che si trova sul modulo. Se il modulo contiene quattro codici a barre, nell' Object array restituito sono presenti quattro elementi.
  6. Elaborazione dei dati decodificati
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto.
    • Creare un array di byte che memorizza il contenuto dei dati dell' BLOB oggetto restituito dal encryptPDFUsingPassword metodo. Compilare l'array di byte ottenendo il valore del membro BLOB dati dell' binaryData oggetto.
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
    • Scrivere il contenuto dell'array di byte in un file PDF richiamando il metodo dell' System.IO.BinaryWriter oggetto Write e passando l'array di byte.
Consulta anche