Uso dei moduli con codice a barre working-with-barcoded-forms
Informazioni sul servizio moduli con codice a barre about-the-barcoded-forms-service
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 unidimensionali 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, consulta Riferimento servizi per AEM Forms.
Decodifica dei dati dei moduli codificati a barre decoding-barcoded-form-data
È possibile utilizzare l’API del servizio moduli con codice a barre per decodificare i dati da un modulo PDF o da un’immagine che contiene 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 (o immagine) di PDF, è necessario che l’utente compili il modulo con i dati.
Riepilogo dei passaggi summary-of-steps
Per decodificare i dati da un modulo PDF, procedere come segue:
- Includi file di progetto.
- Creare un oggetto API client formscon codice a barre.
- Ottenere un modulo PDF contenente dati codificati a barre.
- Decodificare i dati dal modulo PDF.
- Convertire i dati in un’origine dati XML.
- Elabora i dati decodificati.
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:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-barcodedforms-client.jar
- adobe-utilities.jar (obbligatorio se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)
- xercesImpl.jar (situato in <install directory="">/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)
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, vedi 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 BarcodedFormsServiceClient
oggetto. Se utilizzi l’API del servizio Web dei moduli con codice a barre, crea 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.
Decodificare i dati dal modulo PDF
Dopo aver ottenuto un modulo (o un’immagine) PDF contenente un codice a barre, è possibile decodificare i dati. Il servizio Forms con codice a barre 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 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 nel tag < 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, consulta 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.
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 dei moduli con codice a barre tramite l’API Java decode-barcoded-form-data-using-the-java-api
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
Crea un
BarcodedFormsServiceClient
utilizzando il relativo costruttore e passando unServiceClientFactory
oggetto contenente le proprietà di connessione. -
Ottenere un modulo PDF contenente dati con codice a barre
- Crea un
java.io.FileInputStream
oggetto 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. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Decodificare i dati dal modulo PDF
Decodificare i dati del modulo richiamando il
BarcodedFormsServiceClient
dell’oggettodecode
e passando i seguenti valori:- La
com.adobe.idp.Document
oggetto contenente il modulo PDF. - A
java.lang.Boolean
oggetto che specifica se decodificare un codice a barre PDF417. - A
java.lang.Boolean
oggetto che specifica se decodificare un codice a barre della matrice dati. - A
java.lang.Boolean
oggetto che specifica se decodificare un codice a barre del codice QR. - A
java.lang.Boolean
oggetto che specifica se decodificare un codice a barre codabar. - A
java.lang.Boolean
oggetto che specifica se decodificare un codice a barre 128. - A
java.lang.Boolean
oggetto che specifica se decodificare un codice a barre 39. - A
java.lang.Boolean
oggetto che specifica se decodificare un codice a barre EAN-13. - A
java.lang.Boolean
oggetto che specifica se decodificare un codice a barre EAN-8. - A
com.adobe.livecycle.barcodedforms.CharSet
valore di enumerazione che specifica il valore di codifica del set di caratteri utilizzato nel codice a barre.
La
decode
restituisce unorg.w3c.dom.Document
oggetto contenente dati del modulo decodificati. - La
-
Convertire i dati in un’origine dati XML
Converti i dati decodificati in dati XDP o XFDF richiamando il
BarcodedFormsServiceClient
dell’oggettoextractToXML
e passando i seguenti valori:- La
org.w3c.dom.Document
oggetto contenente dati decodificati (assicurati di utilizzaredecode
valore restituito dal metodo). - A
com.adobe.livecycle.barcodedforms.Delimiter
valore di enumerazione che specifica il delimitatore di riga. Si consiglia di specificareDelimiter.Carriage_Return
. - A
com.adobe.livecycle.barcodedforms.Delimiter
valore di enumerazione che specifica il delimitatore di campo. Ad esempio, specificaDelimiter.Tab
. - A
com.adobe.livecycle.barcodedforms.XMLFormat
valore di enumerazione che specifica se convertire i dati del codice a barre in dati XML XDP o XFDF. Ad esempio, specificaXMLFormat.XDP
per convertire i dati in dati XDP.
note note NOTE Non specificare gli stessi valori per i parametri del delimitatore di riga e del delimitatore di campo. La
extractToXML
restituisce unjava.util.List
oggetto in cui ogni elemento èorg.w3c.dom.Document
oggetto. È disponibile un elemento separato per ciascun codice a barre posizionato sul modulo. In altre parole, se sul modulo sono presenti quattro codici a barre, i quattro elementi restituiti sonojava.util.List
oggetto. - La
-
Elaborazione dei dati decodificati
- Itera attraverso il
java.util.List
oggetto per ottenereorg.w3c.dom.Document
oggetto che si trova nell'elenco. - Per ogni elemento dell’elenco, convertire il
org.w3c.dom.Document
oggetto a uncom.adobe.idp.Document
oggetto. (La logica dell'applicazione che converte unorg.w3c.dom.Document
oggetto in uncom.adobe.idp.Document
L’oggetto è mostrato nei dati del modulo codificato a barre decodificati utilizzando l’esempio Java API). - Salvare i dati XML come file XML richiamando il
com.adobe.idp.Document
dell’oggettocopyToFile
e passare un oggetto File che rappresenta il file XML.
- Itera attraverso il
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
Decodifica dei dati dei moduli con codice a barre tramite l’API del servizio Web decode-barcoded-form-data-using-the-web-service-api
Decodificare i dati del modulo utilizzando l’API dei moduli a barre (servizio Web):
-
Includi file di progetto
- Creare un assembly client Microsoft .NET che utilizzi il servizio WSDL per moduli con codice a barre. Per informazioni, consulta Richiamo di AEM Forms con codifica Base64.
- Fare riferimento all'assembly client Microsoft .NET. Per informazioni, vedere "Riferimento all'assembly client .NET" in Richiamo di AEM Forms con codifica Base64.
-
Creare un oggetto API client per moduli con codice a barre
Utilizzando l’assembly client Microsoft .NET che utilizza il servizio WSDL per moduli con codice a barre, crea un
BarcodedFormsServiceService
richiamando il relativo costruttore predefinito. -
Ottenere un modulo PDF contenente dati con codice a barre
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare un documento PDF contenente un codice a barre. - Crea un
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. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativobinaryData
con il contenuto dell'array di byte.
- Crea un
-
Decodificare i dati dal modulo PDF
Decodificare i dati del modulo richiamando il
BarcodedFormsServiceService
dell’oggettodecode
e passando i seguenti valori:- La
BLOB
oggetto contenente il modulo PDF. - A
Boolean
oggetto che specifica se decodificare un codice a barre PDF417. - A
Boolean
oggetto che specifica se decodificare un codice a barre della matrice dati. - A
Boolean
oggetto che specifica se decodificare un codice a barre del codice QR. - A
Boolean
oggetto che specifica se decodificare un codice a barre codabar. - A
Boolean
oggetto che specifica se decodificare un codice a barre 128. - A
Bolean
oggetto che specifica se decodificare un codice a barre 39. - A
Boolean
oggetto che specifica se decodificare un codice a barre EAN-13. - A
Boolean
oggetto che specifica se decodificare un codice a barre EAN-8. - A
CharSet
valore di enumerazione che specifica il valore di codifica del set di caratteri utilizzato nel codice a barre.
La
decode
restituisce un valore stringa contenente dati del modulo decodificati. - La
-
Convertire i dati in un’origine dati XML
Converti i dati decodificati in dati XDP o XFDF richiamando il
BarcodedFormsServiceService
dell’oggettoextractToXML
e passando i seguenti valori:- Un valore stringa contenente dati decodificati (assicurati di utilizzare
decode
valore restituito dal metodo). - A
Delimiter
valore di enumerazione che specifica il delimitatore di riga. Si consiglia di specificareDelimiter.Carriage_Return
. - A
Delimiter
valore di enumerazione che specifica il delimitatore di campo. Ad esempio, specificaDelimiter.Tab
. - A
XMLFormat
valore di enumerazione che specifica se convertire i dati del codice a barre in dati XML XDP o XFDF. Ad esempio, specificaXMLFormat.XDP
per convertire i dati in dati XDP.
note note NOTE Non specificare gli stessi valori per i parametri del delimitatore di riga e del delimitatore di campo. La
extractToXML
restituisce unObject
array in cui ogni elemento èBLOB
istanza. È disponibile un elemento separato per ciascun codice a barre posizionato sul modulo. In altre parole, se sul modulo sono presenti quattro codici a barre, i quattro elementi restituiti sonoObject
array. - Un valore stringa contenente dati decodificati (assicurati di utilizzare
-
Elaborazione dei dati decodificati
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento protetto PDF. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto restituito daencryptPDFUsingPassword
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettobinaryData
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms con codifica Base64