Uso dei moduli con codice a barre working-with-barcoded-forms

CAUTION
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.

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.

NOTE
Per ulteriori informazioni sul servizio dei moduli con codice a barre, consulta Riferimento servizi per AEM Forms.

Riepilogo dei passaggi summary-of-steps

Per decodificare i dati da un modulo PDF, procedere come segue:

  1. Includi file di progetto.
  2. Creare un oggetto API client formscon codice a barre.
  3. Ottenere un modulo PDF contenente dati codificati a barre.
  4. Decodificare i dati dal modulo PDF.
  5. Convertire i dati in un’origine dati XML.
  6. 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.

NOTE
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 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):

  1. Includi file di progetto

    Includi file JAR client nel percorso di classe del progetto Java.

  2. 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.

  3. 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 passando java.io.FileInputStream oggetto.
  4. Decodificare i dati dal modulo PDF

    Decodificare i dati del modulo richiamando il BarcodedFormsServiceClient dell’oggetto decode 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 un org.w3c.dom.Document oggetto contenente dati del modulo decodificati.

  5. 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:

    • La org.w3c.dom.Document oggetto contenente dati decodificati (assicurati di utilizzare decode valore restituito dal metodo).
    • A com.adobe.livecycle.barcodedforms.Delimiter valore di enumerazione che specifica il delimitatore di riga. Si consiglia di specificare Delimiter.Carriage_Return.
    • A com.adobe.livecycle.barcodedforms.Delimiter valore di enumerazione che specifica il delimitatore di campo. Ad esempio, specifica Delimiter.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, specifica XMLFormat.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 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.

  6. Elaborazione dei dati decodificati

    • Itera attraverso il java.util.List oggetto per ottenere org.w3c.dom.Document oggetto che si trova nell'elenco.
    • Per ogni elemento dell’elenco, convertire il 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).
    • Salvare i dati XML come file XML richiamando il com.adobe.idp.Document dell’oggetto copyToFilee 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

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):

  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 per moduli con codice a barre, crea un BarcodedFormsServiceService richiamando il relativo costruttore predefinito.

  3. Ottenere un modulo PDF contenente dati con codice a barre

    • Crea un BLOB utilizzando il relativo costruttore. La BLOB 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 il System.IO.FileStream dell’oggetto Length proprietà.
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream dell’oggetto Read e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Popolare BLOB oggetto assegnando il relativo binaryData con il contenuto dell'array di byte.
  4. Decodificare i dati dal modulo PDF

    Decodificare i dati del modulo richiamando il BarcodedFormsServiceService dell’oggetto decode 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.

  5. 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:

    • 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 specificare Delimiter.Carriage_Return.
    • A Delimiter valore di enumerazione che specifica il delimitatore di campo. Ad esempio, specifica Delimiter.Tab.
    • A 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.
    note note
    NOTE
    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.

  6. 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 da encryptPDFUsingPassword metodo . Compilare l’array di byte ottenendo il valore del BLOB dell’oggetto binaryData membro dati.
    • Crea un System.IO.BinaryWriter richiamando il relativo costruttore e passando System.IO.FileStream oggetto.
    • Scrivi il contenuto dell’array di byte in un file PDF richiamando il System.IO.BinaryWriter dell’oggetto Write e passare l'array di byte.

Consulta anche

Richiamo di AEM Forms con codifica Base64

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da