Uso dei moduli con codice a barre

Informazioni sul servizio moduli codici 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 PDF forms 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, vedere Guida di riferimento dei servizi per AEM Forms.

Decodifica dati modulo codici 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 di dati che si trovano 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.

NOTA

Per ulteriori informazioni sul servizio dei moduli con codice a barre, vedere Guida di riferimento dei 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 (che si trova in <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, sarà necessario sostituire adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazione J2EE in cui AEM Forms è distribuito. Per informazioni sulla posizione di tutti file AEM Forms JAR, vedere Inclusione file 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 oggetto BarcodedFormsServiceClient. Se si utilizza l'API del servizio Web dei moduli con codice a barre, creare 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.

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

NOTA

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

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

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

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 oggetto BarcodedFormsServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

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

    • Creare un oggetto java.io.FileInputStream 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 oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.
  4. Decodifica dei dati dal modulo PDF

    Decodificare i dati del modulo richiamando il metodo decode dell'oggetto BarcodedFormsServiceClient e passando i seguenti valori:

    • L'oggetto com.adobe.idp.Document che contiene il modulo PDF.
    • Un oggetto java.lang.Boolean che specifica se decodificare un codice a barre PDF417.
    • Un oggetto java.lang.Boolean che specifica se decodificare o meno un codice a barre di matrice dati.
    • Un oggetto java.lang.Boolean che specifica se decodificare o meno un codice a barre del codice QR.
    • Un oggetto java.lang.Boolean che specifica se decodificare un codice a barre codabar.
    • Un oggetto java.lang.Boolean che specifica se decodificare un codice a barre 128.
    • Un oggetto java.lang.Boolean che specifica se decodificare un codice a barre 39.
    • Un oggetto java.lang.Boolean che specifica se decodificare un codice a barre EAN-13.
    • Un oggetto java.lang.Boolean che specifica se decodificare un codice a barre EAN-8.
    • Un valore di enumerazione 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.

  5. Conversione dei dati in un'origine dati XML

    Convertire i dati decodificati in dati XDP o XFDF richiamando il metodo BarcodedFormsServiceClient dell'oggetto extractToXML e passando i seguenti valori:

    • L'oggetto org.w3c.dom.Document che contiene dati decodificati (assicurarsi di utilizzare il valore restituito del metodo decode).
    • Un valore di enumerazione com.adobe.livecycle.barcodedforms.Delimiter che specifica il delimitatore di riga. È consigliabile specificare Delimiter.Carriage_Return.
    • Un valore di enumerazione com.adobe.livecycle.barcodedforms.Delimiter che specifica il delimitatore di campo. Ad esempio, specificare Delimiter.Tab.
    • Un valore di enumerazione 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.
    NOTA

    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. Esiste un elemento separato per ciascun codice a barre che si trova sul modulo. Ovvero, se sul modulo sono presenti quattro codici a barre, nell'oggetto java.util.List restituito sono presenti quattro elementi.

  6. Elaborazione dei dati decodificati

    • Iterate l'oggetto java.util.List per ottenere ogni oggetto org.w3c.dom.Document presente nell'elenco.
    • Per ciascun elemento nell'elenco, convertire l'oggetto 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 decodifica utilizzando l'esempio di API Java).
    • Salvare i dati XML come file XML richiamando l'oggetto com.adobe.idp.Document e passando un oggetto File che rappresenta il file XML.copyToFile

Consulta anche

Avvio rapido (modalità SOAP): Decodifica dei dati del modulo con codice a barre tramite l'API Java

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

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 oggetto BarcodedFormsServiceService richiamando il relativo costruttore predefinito.

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

    • Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF contenente un codice a barre.
    • Creare un oggetto 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 dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnandone la proprietà binaryData con il contenuto dell'array di byte.
  4. Decodifica dei dati dal modulo PDF

    Decodificare i dati del modulo richiamando il metodo decode dell'oggetto BarcodedFormsServiceService e passando i seguenti valori:

    • L'oggetto BLOB che contiene il modulo PDF.
    • Un oggetto Boolean che specifica se decodificare un codice a barre PDF417.
    • Un oggetto Boolean che specifica se decodificare o meno un codice a barre di matrice dati.
    • Un oggetto Boolean che specifica se decodificare o meno un codice a barre del codice QR.
    • Un oggetto Boolean che specifica se decodificare un codice a barre codabar.
    • Un oggetto Boolean che specifica se decodificare un codice a barre 128.
    • Un oggetto Bolean che specifica se decodificare un codice a barre 39.
    • Un oggetto Boolean che specifica se decodificare un codice a barre EAN-13.
    • Un oggetto Boolean che specifica se decodificare un codice a barre EAN-8.
    • Un valore di enumerazione CharSet che specifica il valore di codifica del set di caratteri utilizzato nel codice a barre.

    Il metodo decode 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 BarcodedFormsServiceService dell'oggetto extractToXML e passando i seguenti valori:

    • Un valore di stringa che contiene dati decodificati (assicurarsi di utilizzare il valore restituito del metodo decode).
    • Un valore di enumerazione Delimiter che specifica il delimitatore di riga. È consigliabile specificare Delimiter.Carriage_Return.
    • Un valore di enumerazione Delimiter che specifica il delimitatore di campo. Ad esempio, specificare Delimiter.Tab.
    • Un valore di enumerazione 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.
    NOTA

    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. Esiste un elemento separato per ciascun codice a barre che si trova sul modulo. Ovvero, se sul modulo sono presenti quattro codici a barre, nell'array Object restituito sono presenti quattro elementi.

  6. Elaborazione dei dati decodificati

    • Creare un oggetto System.IO.FileStream 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'oggetto BLOB restituito dal metodo encryptPDFUsingPassword. Compilare l'array di byte ottenendo il valore del membro di dati BLOB dell'oggetto binaryData.
    • Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
    • Scrivere il contenuto dell'array di byte in un file PDF richiamando il metodo System.IO.BinaryWriter dell'oggetto Write e passando l'array di byte.

Consulta anche

Richiamo AEM Forms con codifica Base64

In questa pagina