Il servizio moduli con codice a barre automatizza l’acquisizione di dati dai moduli di compilazione e stampa e integra le informazioni acquisite nei sistemi IT di base di un’organizzazione.
Il servizio moduli con codice a barre consente di aggiungere codici a barre monodimensionali e bidimensionali ai PDF forms interattivi. È quindi possibile pubblicare i moduli con codice 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, il codice a barre viene aggiornato automaticamente per codificare i dati del modulo forniti dall’utente. L’utente può inviare il modulo elettronicamente o stamparlo su carta e inviarlo per posta, fax o a mano. In seguito è possibile 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, vedere Riferimento servizi per AEM Forms.
È possibile utilizzare l’API del servizio moduli con codice a barre per decodificare i dati da un modulo PDF o da un’immagine contenente un codice a barre. Per decodifica dei dati modulo si intende l’estrazione dei dati contenuti nei codici a barre. Prima che i dati possano essere decodificati da un modulo PDF (o da un’immagine), è necessario che l’utente compili il modulo con i dati.
Per ulteriori informazioni sul servizio dei moduli con codice a barre, vedere Riferimento servizi per AEM Forms.
Per decodificare i dati da un modulo PDF, effettuare le seguenti operazioni:
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Se AEM Forms è implementato su un server applicazioni J2EE supportato che non è JBOSS, sarà necessario sostituire adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms. Per informazioni sulla posizione di tutti i file JAR di AEM Forms, consulta Inclusione dei file libreria Java di AEM Forms.
Creare un oggetto API client per moduli con codice a barre
Prima di poter eseguire programmaticamente un’operazione del servizio di moduli con codice a barre, è necessario creare un client di servizio Forms con codice a barre. Se utilizzi l’API Java, crea un oggetto BarcodedFormsServiceClient
. Se utilizzi l’API del servizio Web per moduli con codice a barre, crea un oggetto BarcodedFormsServiceService
.
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.
Decodificare i dati dal modulo PDF
Dopo aver ottenuto un modulo PDF (o un’immagine) contenente un codice a barre, è possibile decodificare i dati. Il servizio Forms con codice a barre supporta i seguenti tipi di codici a barre:
L’input del set di caratteri come esadecimale nell’API di decodifica implica che il contenuto del codice a barre è codificato come stringa esadecimale. Ad esempio, se UTF-8 è specificato come codifica Carattere nel modulo e Hex è specificato nell’operazione di decodifica, il contenuto del codice a barre viene codificato come stringa esadecimale nell’elemento < xb:content
> nell’output decodificato. Puoi convertire questo valore esadecimale per ottenere il contenuto originale creando logica applicativa nella tua applicazione client.
Convertire i 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 convertirli in dati XDP. Per informazioni, consultare Importazione di dati 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, archiviarli in un database aziendale, compilare un altro modulo e così via. Questa sezione illustra 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 quando il delimitatore di riga e i parametri del delimitatore di campo hanno lo stesso valore
Consulta anche
Decodifica dei dati dei moduli con codice a barre tramite l’API Java
Decodifica dei dati dei moduli con codice a barre tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Decodifica dei dati del modulo utilizzando l’API dei moduli a barre (Java):
Includi file di progetto
Includi file JAR client nel percorso di classe del progetto Java.
Creare un oggetto API client per moduli con codice a barre
Creare un oggetto BarcodedFormsServiceClient
utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory
contenente proprietà di connessione.
Ottenere un modulo PDF contenente dati con codice a barre
java.io.FileInputStream
che rappresenta il modulo PDF contenente dati codificati a barre utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.com.adobe.idp.Document
utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream
.Decodificare i dati dal modulo PDF
Decodificare i dati del modulo richiamando il metodo decode
dell’oggetto BarcodedFormsServiceClient
e passando i seguenti valori:
com.adobe.idp.Document
che contiene il modulo PDF.java.lang.Boolean
che specifica se decodificare un codice a barre PDF417.java.lang.Boolean
che specifica se decodificare un codice a barre della matrice di dati.java.lang.Boolean
che specifica se decodificare un codice a barre del codice QR.java.lang.Boolean
che specifica se decodificare un codice a barre codabar.java.lang.Boolean
che specifica se decodificare un codice a barre 128.java.lang.Boolean
che specifica se decodificare un codice a barre 39.java.lang.Boolean
che specifica se decodificare un codice a barre EAN-13.java.lang.Boolean
che specifica se decodificare un codice a barre EAN-8.com.adobe.livecycle.barcodedforms.CharSet
che specifica il valore di codifica del set di caratteri utilizzato nel codice a barre.Il metodo decode
restituisce un oggetto org.w3c.dom.Document
contenente dati del modulo decodificati.
Convertire i dati in un’origine dati XML
Converti i dati decodificati in dati XDP o XFDF richiamando il metodo BarcodedFormsServiceClient
dell’oggetto extractToXML
e passando i seguenti valori:
org.w3c.dom.Document
che contiene dati decodificati (assicurati di utilizzare il valore restituito del metodo decode
).com.adobe.livecycle.barcodedforms.Delimiter
che specifica il delimitatore di riga. È consigliabile specificare Delimiter.Carriage_Return
.com.adobe.livecycle.barcodedforms.Delimiter
che specifica il delimitatore di campo. Ad esempio, specifica Delimiter.Tab
.com.adobe.livecycle.barcodedforms.XMLFormat
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 metodo extractToXML
restituisce un oggetto java.util.List
in cui ogni elemento è un oggetto org.w3c.dom.Document
. È disponibile un elemento separato per ciascun codice a barre posizionato sul modulo. In altre parole, se sul modulo sono presenti quattro codici a barre, l'oggetto java.util.List
restituito contiene quattro elementi.
Elaborazione dei dati decodificati
java.util.List
per ottenere ogni oggetto org.w3c.dom.Document
presente nell'elenco.org.w3c.dom.Document
in un oggetto com.adobe.idp.Document
. (La logica dell'applicazione che converte un oggetto org.w3c.dom.Document
in un oggetto com.adobe.idp.Document
viene mostrata nei dati del modulo con codice a barre Decoding utilizzando l'esempio API Java).copyToFile
dell'oggetto com.adobe.idp.Document
e passando un oggetto File che rappresenta il file XML.Consulta anche
Avvio rapido (modalità SOAP): Decodifica di dati modulo codificati a barre tramite API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Decodificare i dati del modulo utilizzando l’API dei moduli a barre (servizio Web):
Includi file di progetto
Creare un oggetto API client per moduli con codice a barre
Utilizzando l’assembly client Microsoft .NET che utilizza il servizio WSDL per i moduli con codice a barre, creare un oggetto BarcodedFormsServiceService
richiamando il relativo costruttore predefinito.
Ottenere un modulo PDF contenente dati con codice a barre
BLOB
utilizzando il relativo costruttore. L'oggetto BLOB
viene utilizzato per memorizzare un documento PDF contenente un codice a barre.System.IO.FileStream
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.System.IO.FileStream
. È possibile determinare le dimensioni dell'array di byte ottenendo la proprietà Length
dell'oggetto System.IO.FileStream
.Read
dell’oggetto System.IO.FileStream
e passando l’array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando la relativa proprietà binaryData
con il contenuto dell'array di byte.Decodificare i dati dal modulo PDF
Decodificare i dati del modulo richiamando il metodo decode
dell’oggetto BarcodedFormsServiceService
e passando i seguenti valori:
BLOB
che contiene il modulo PDF.Boolean
che specifica se decodificare un codice a barre PDF417.Boolean
che specifica se decodificare un codice a barre della matrice di dati.Boolean
che specifica se decodificare un codice a barre del codice QR.Boolean
che specifica se decodificare un codice a barre codabar.Boolean
che specifica se decodificare un codice a barre 128.Bolean
che specifica se decodificare un codice a barre 39.Boolean
che specifica se decodificare un codice a barre EAN-13.Boolean
che specifica se decodificare un codice a barre EAN-8.CharSet
che specifica il valore di codifica del set di caratteri utilizzato nel codice a barre.Il metodo decode
restituisce un valore stringa contenente dati del modulo decodificati.
Convertire i dati in un’origine dati XML
Converti i dati decodificati in dati XDP o XFDF richiamando il metodo BarcodedFormsServiceService
dell’oggetto extractToXML
e passando i seguenti valori:
decode
).Delimiter
che specifica il delimitatore di riga. È consigliabile specificare Delimiter.Carriage_Return
.Delimiter
che specifica il delimitatore di campo. Ad esempio, specifica Delimiter.Tab
.XMLFormat
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 metodo extractToXML
restituisce un array Object
in cui ogni elemento è un'istanza BLOB
. È disponibile un elemento separato per ciascun codice a barre posizionato sul modulo. In altre parole, se sul modulo sono presenti quattro codici a barre, nella matrice Object
restituita sono presenti quattro elementi.
Elaborazione dei dati decodificati
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto.BLOB
restituito dal metodo encryptPDFUsingPassword
. Compilare l'array di byte ottenendo il valore del membro dati BLOB
dell'oggetto binaryData
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.Write
dell’oggetto System.IO.BinaryWriter
e passando l’array di byte.Consulta anche
Richiamo di AEM Forms con codifica Base64