Arbeiten mit Barcode-Formularen

Letzte Aktualisierung: 15. Juli 2024
  • Gilt für:
  • Experience Manager 6.5
  • Themen:

Erstellt für:

  • Entwickler

Die Beispiele in diesem Dokument gelten nur für eine AEM Forms on JEE-Umgebung.

Über den Barcode-Formular-Service

Der Barcode-Formular-Service automatisiert die Erfassung von Daten aus Formularen zum Ausfüllen und Ausdrucken und integriert die erfassten Informationen in die IT-Kernsysteme eines Unternehmens.

Mit dem Barcode-Formular-Service können Sie ein- und zweidimensionale Barcodes zu interaktiven PDF-Formularen hinzufügen. Sie können die Barcode-Formulare dann auf einer Website veröffentlichen oder per E-Mail oder CD verteilen. Wenn ein Benutzer ein Barcode-Formular mit Adobe Reader, Acrobat Professional oder Acrobat Standard ausfüllt, wird der Barcode automatisch aktualisiert, um die vom Benutzer eingegebenen Formulardaten zu codieren. Der Benutzer kann das Formular elektronisch übermitteln oder auf Papier drucken und per Post, Fax oder Hand einreichen. Sie können die vom Benutzer eingegebenen Daten später im Rahmen eines automatisierten Workflows extrahieren und die Daten zwischen Genehmigungsprozessen und Geschäftssystemen weiterleiten.

Weitere Informationen zum Barcode-Formular-Service finden Sie in der Service-Referenz für AEM Forms.

Decodieren der Daten von Barcode-Formularen

Sie können die Barcode-Formular-Service-API verwenden, um Daten aus einem PDF-Formular oder einem Bild mit einem Barcode zu decodieren. Das Decodieren von Formulardaten bedeutet das Extrahieren von Daten, die im Barcode enthalten sind. Bevor Daten aus einem PDF-Formular (oder Bild) decodiert werden können, muss ein Benutzer das Formular mit Daten ausfüllen.

HINWEIS
Weitere Informationen zum Barcode-Formular-Service finden Sie in der Service-Referenz für AEM Forms.

Zusammenfassung der Schritte

Um Daten aus einem PDF-Formular zu decodieren, führen Sie die folgenden Schritte aus:

  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein Client-API-Objekt für Barcode-Formulare.
  3. Rufen Sie ein PDF-Formular ab, das mit Barcodes versehene Daten enthält.
  4. Decodieren Sie die Daten aus dem PDF-Formular.
  5. Konvertieren Sie die Daten in eine XML-Datenquelle.
  6. Verarbeiten Sie die decodierten Daten.

Projektdateien einbeziehen

Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-barcodedforms-client.jar
  • adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
  • jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
  • xercesImpl.jar (unter <Installationsverzeichnis>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)

Wenn AEM Forms auf einem unterstützten J2EE-Anwendungs-Server bereitgestellt wird, der nicht JBOSS ist, müssen Sie „adobe-utilities.jar“ und „jbossall-client.jar“ durch JAR-Dateien ersetzen, die spezifisch für den J2EE-Anwendungs-Server sind, auf dem AEM Forms bereitgestellt wird. Informationen zum Speicherort aller AEM Forms-JAR-Dateien finden Sie unter Einbeziehen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines Client-API-Objekts für Barcode-Formulare

Bevor Sie einen Barcode-Formular-Service-Vorgang programmgesteuert durchführen können, müssen Sie einen Client für den Barcode-Formular-Service erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein BarcodedFormsServiceClient-Objekt. Wenn Sie die Barcode-Formular-Webservice-API verwenden, erstellen Sie ein BarcodedFormsServiceService-Objekt.

Abrufen eines PDF-Formulars, das mit Barcodes versehene Daten enthält

Rufen Sie ein PDF-Formular mit einem Barcode ab, das mit Benutzerdaten ausgefüllt wurde.

Decodieren der Daten aus dem PDF-Formular

Nachdem Sie ein PDF-Formular (oder ein Bild) mit einem Barcode erhalten haben, können Sie Daten decodieren. Der Barcode-Formular-Service unterstützt die folgenden Barcode-Typen:

  • PDF417-Barcodes.
  • Datenmatrix-Barcodes.
  • QR-Code-Barcodes.
  • Codabar-Barcodes.
  • Code 128-Barcodes.
  • Code 39-Barcodes.
  • EAN-13-Barcodes.
  • EAN-8-Barcodes.

Die Eingabe des Zeichensatzes als Hexadezimalwert in der Decodierungs-API bedeutet, dass der Inhalt des Barcodes als hexadezimale Zeichenfolge codiert wird. Wenn beispielsweise UTF-8 als Codierung der Zeichen im Formular und Hex im Decodierungsvorgang angegeben ist, wird der Inhalt des Barcodes als hexadezimale Zeichenfolge im Element <xb:content> in der decodierten Ausgabe codiert. Sie können diesen Hexadezimalwert konvertieren, um den ursprünglichen Inhalt zu erhalten, indem Sie eine Anwendungslogik in Ihrem Client-Programm erstellen.

Konvertieren der Daten in eine XML-Datenquelle

Nachdem Sie Formulardaten decodiert haben, können Sie sie in XDP- oder XFDF-Daten konvertieren. Angenommen, Sie möchten die Daten in ein anderes Formular importieren. Um die Daten in ein XFA-Formular zu importieren, müssen Sie die Daten in XDP-Daten konvertieren. Weitere Informationen finden Sie unter Importieren von Formulardaten.

Verarbeiten der dekodierten Daten

Sie können die konvertierten Daten verarbeiten, um Ihre Geschäftsanforderungen zu erfüllen. Nachdem Sie beispielsweise die Daten decodiert und konvertiert haben, können Sie sie in einer Datei speichern, in einer Unternehmensdatenbank speichern, ein anderes Formular ausfüllen usw. In diesem Abschnitt wird beschrieben, wie Sie die konvertierten Daten als XML-Datei speichern.

HINWEIS
Der Barcode-Formular-Service kann Barcode-Daten nicht decodieren, wenn die Parameter der Trennzeichen für Zeilen und Felder denselben Wert haben

Siehe auch

Decodieren von mit Barcode versehenen Formulardaten mit der Java-API

Dekodieren von mit Barcode versehenen Formulardaten mithilfe der Webservice-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Decodieren von mit Barcode versehenen Formulardaten mit der Java-API

So decodieren Sie Formulardaten mithilfe der Barcode-Formulare-API (Java):

  1. Projektdateien einschließen

    Schließen Sie Client-JAR-Dateien in den Klassenpfad Ihres Java-Projekts ein.

  2. Erstellen eines Client-API-Objekts für Barcode-Formulare

    Erstellen Sie ein BarcodedFormsServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und ein ServiceClientFactory-Objekt übergeben, das Verbindungseigenschaften enthält.

  3. Abrufen eines PDF-Formulars mit Barcode-Daten

    • Erstellen Sie ein java.io.FileInputStream-Objekt, das das PDF-Formular darstellt, welches Barcode-Daten enthält, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort des PDF-Dokuments angibt.
    • Erstellen Sie ein com.adobe.idp.Document-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream-Objekt übergeben.

  4. Decodieren der Daten aus dem PDF-Formular

    Decodieren Sie die Formulardaten, indem Sie die Methode decode des BarcodedFormsServiceClient-Objekts aufrufen und die folgenden Werte übergeben:

    • Das com.adobe.idp.Document-Objekt, das das PDF-Formular enthält.
    • Ein java.lang.Boolean-Objekt, das angibt, ob ein PDF417-Barcode decodiert werden soll.
    • Ein java.lang.Boolean-Objekt, das, das angibt, ob ein Datenmatrix-Barcode decodiert werden soll.
    • Ein java.lang.Boolean-Objekt, das angibt, ob ein QR-Code-Barcode decodiert werden soll.
    • Ein java.lang.Boolean-Objekt, das angibt, ob ein Codabar-Barcode decodiert werden soll.
    • Ein java.lang.Boolean-Objekt, das angibt, ob ein Code-128-Barcode decodiert werden soll.
    • Ein java.lang.Boolean-Objekt, das angibt, ob ein Code-39-Barcode decodiert werden soll.
    • Ein java.lang.Boolean-Objekt, das angibt, ob ein EAN-13-Barcode decodiert werden soll.
    • Ein java.lang.Boolean-Objekt, das angibt, ob ein EAN-8-Barcode decodiert werden soll.
    • Ein com.adobe.livecycle.barcodedforms.CharSet-Auflistungswert, der den im Barcode verwendeten Wert für die Codierung des Zeichensatzes angibt.

    Die Methode decode gibt ein org.w3c.dom.Document-Objekt zurück, das decodierte Formulardaten enthält.

  5. Konvertieren der Daten in eine XML-Datenquelle

    Konvertieren Sie die decodierten Daten entweder in XDP- oder in XFDF-Daten, indem Sie die Methode extractToXML des BarcodedFormsServiceClient-Objekts aufrufen und die folgenden Werte übergeben:

    • Das org.w3c.dom.Document-Objekt, das die decodierten Daten enthält (stellen Sie sicher, dass Sie den Rückgabewert der Methode decode verwenden).
    • Ein com.adobe.livecycle.barcodedforms.Delimiter-Auflistungswert, der das Trennzeichen für die Zeile angibt. Es wird empfohlen, Delimiter.Carriage_Return anzugeben.
    • Ein com.adobe.livecycle.barcodedforms.Delimiter-Auflistungswert, der das Feldtrennzeichen angibt. Geben Sie zum Beispiel Delimiter.Tab an.
    • Ein com.adobe.livecycle.barcodedforms.XMLFormat-Auflistungswert, der angibt, ob die Barcode-Daten in XDP- oder XFDF-XML-Daten konvertiert werden sollen. Geben Sie beispielsweise XMLFormat.XDP an, um die Daten in XDP-Daten zu konvertieren.
    HINWEIS
    Geben Sie nicht dieselben Werte für die Parameter „Zeilentrennzeichen“ und „Feldtrennzeichen“ an.

    Die Methode extractToXML gibt ein java.util.List-Objekt zurück, bei dem jedes Element ein org.w3c.dom.Document-Objekt ist. Für jeden Barcode im Formular gibt es ein eigenes Element. Das heißt, wenn das Formular vier Barcodes enthält, gibt es vier Elemente im zurückgegebenen java.util.List-Objekt.

  6. Verarbeiten der decodierten Daten

    • Iterieren Sie durch das java.util.List-Objekt, um jedes org.w3c.dom.Document-Objekt zu erhalten, das sich in der Liste befindet.
    • Konvertieren Sie für jedes Element in der Liste das org.w3c.dom.Document-Objekt in ein com.adobe.idp.Document-Objekt. (Die Anwendungslogik, die ein org.w3c.dom.Document-Objekt in ein com.adobe.idp.Document-Objekt umwandelt, wird im Beispiel zum Dekodieren von Barcode-Formulardaten mithilfe der Java-API gezeigt).
    • Speichern Sie die XML-Daten als XML-Datei, indem Sie die Methode copyToFile des com.adobe.idp.Document-Objekts aufrufen und ein Dateiobjekt übergeben, das die XML-Datei darstellt.

Siehe auch

Schnellstart (SOAP-Modus): Dekodieren von Barcode-Formulardaten mithilfe der Java-API

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen