AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.
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.
È 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.
Per ulteriori informazioni sul servizio dei moduli con codice a barre, consulta Riferimento servizi per AEM Forms.
Per decodificare i dati da un modulo PDF, procedere come segue:
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, 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:
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.
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
Crea un BarcodedFormsServiceClient
utilizzando il relativo costruttore e passando un ServiceClientFactory
oggetto contenente le proprietà di connessione.
Ottenere un modulo PDF contenente dati con codice a barre
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.com.adobe.idp.Document
utilizzando il relativo costruttore e passando java.io.FileInputStream
oggetto.Decodificare i dati dal modulo PDF
Decodificare i dati del modulo richiamando il BarcodedFormsServiceClient
dell’oggetto decode
e passando i seguenti valori:
com.adobe.idp.Document
oggetto contenente il modulo PDF.java.lang.Boolean
oggetto che specifica se decodificare un codice a barre PDF417.java.lang.Boolean
oggetto che specifica se decodificare un codice a barre della matrice dati.java.lang.Boolean
oggetto che specifica se decodificare un codice a barre del codice QR.java.lang.Boolean
oggetto che specifica se decodificare un codice a barre codabar.java.lang.Boolean
oggetto che specifica se decodificare un codice a barre 128.java.lang.Boolean
oggetto che specifica se decodificare un codice a barre 39.java.lang.Boolean
oggetto che specifica se decodificare un codice a barre EAN-13.java.lang.Boolean
oggetto che specifica se decodificare un codice a barre EAN-8.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 un org.w3c.dom.Document
oggetto contenente dati del modulo decodificati.
Convertire i dati in un’origine dati XML
Converti i dati decodificati in dati XDP o XFDF richiamando il BarcodedFormsServiceClient
dell’oggetto extractToXML
e passando i seguenti valori:
org.w3c.dom.Document
oggetto contenente dati decodificati (assicurati di utilizzare decode
valore restituito dal metodo).com.adobe.livecycle.barcodedforms.Delimiter
valore di enumerazione che specifica il delimitatore di riga. Si consiglia di specificare Delimiter.Carriage_Return
.com.adobe.livecycle.barcodedforms.Delimiter
valore di enumerazione che specifica il delimitatore di campo. Ad esempio, specifica Delimiter.Tab
.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, specifica 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.
La extractToXML
restituisce un java.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 sono java.util.List
oggetto.
Elaborazione dei dati decodificati
java.util.List
oggetto per ottenere org.w3c.dom.Document
oggetto che si trova nell'elenco.org.w3c.dom.Document
oggetto a un com.adobe.idp.Document
oggetto. (La logica dell'applicazione che converte un org.w3c.dom.Document
oggetto in un com.adobe.idp.Document
L’oggetto è mostrato nei dati del modulo codificato a barre decodificati utilizzando l’esempio Java API).com.adobe.idp.Document
dell’oggetto copyToFile
e passare 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 moduli con codice a barre, crea un BarcodedFormsServiceService
richiamando il relativo costruttore predefinito.
Ottenere un modulo PDF contenente dati con codice a barre
BLOB
utilizzando il relativo costruttore. La 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
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo il System.IO.FileStream
dell’oggetto Length
proprietà.System.IO.FileStream
dell’oggetto Read
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
oggetto assegnando il relativo binaryData
con il contenuto dell'array di byte.Decodificare i dati dal modulo PDF
Decodificare i dati del modulo richiamando il BarcodedFormsServiceService
dell’oggetto decode
e passando i seguenti valori:
BLOB
oggetto contenente il modulo PDF.Boolean
oggetto che specifica se decodificare un codice a barre PDF417.Boolean
oggetto che specifica se decodificare un codice a barre della matrice dati.Boolean
oggetto che specifica se decodificare un codice a barre del codice QR.Boolean
oggetto che specifica se decodificare un codice a barre codabar.Boolean
oggetto che specifica se decodificare un codice a barre 128.Bolean
oggetto che specifica se decodificare un codice a barre 39.Boolean
oggetto che specifica se decodificare un codice a barre EAN-13.Boolean
oggetto che specifica se decodificare un codice a barre EAN-8.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.
Convertire i dati in un’origine dati XML
Converti i dati decodificati in dati XDP o XFDF richiamando il BarcodedFormsServiceService
dell’oggetto extractToXML
e passando i seguenti valori:
decode
valore restituito dal metodo).Delimiter
valore di enumerazione che specifica il delimitatore di riga. Si consiglia di specificare Delimiter.Carriage_Return
.Delimiter
valore di enumerazione che specifica il delimitatore di campo. Ad esempio, specifica Delimiter.Tab
.XMLFormat
valore di enumerazione che specifica se convertire i dati del codice a barre in dati XML XDP o XFDF. Ad esempio, specifica 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.
La extractToXML
restituisce un Object
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 sono Object
array.
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 protetto PDF.BLOB
oggetto restituito da encryptPDFUsingPassword
metodo . Compilare l’array di byte ottenendo il valore del BLOB
dell’oggetto binaryData
membro dati.System.IO.BinaryWriter
richiamando il relativo costruttore e passando System.IO.FileStream
oggetto.System.IO.BinaryWriter
dell’oggetto Write
e passare l'array di byte.Consulta anche
Richiamo di AEM Forms con codifica Base64