Show Menu
THEMEN×

Arbeiten mit Formularen mit Strichcode

Info zum Barcoded Forms-Dienst

Der Barcoded Forms-Dienst automatisiert die Erfassung von Daten aus Ausfüllungs- und Druckformularen und integriert erfasste Informationen in die IT-Kernsysteme eines Unternehmens.
Mit dem Barcoded Forms-Dienst können Sie interaktive PDF-Formulare um eindimensionale und zweidimensionale Barcodes ergänzen. Sie können die mit Strichcode versehenen Formulare dann auf einer Website veröffentlichen oder per E-Mail oder CD verteilen. Wenn ein Benutzer ein mit Strichcode versehenes Formular mit Adobe Reader, Acrobat Professional oder Acrobat Standard ausfüllt, wird der Barcode automatisch aktualisiert, um die vom Benutzer bereitgestellten Formulardaten zu kodieren. Der Benutzer kann das Formular elektronisch einreichen oder auf Papier ausdrucken und per Post, Fax oder Hand senden. Sie können die vom Benutzer bereitgestellten Daten später im Rahmen eines automatisierten Workflows extrahieren und die Daten zwischen Genehmigungsprozessen und Geschäftssystemen weiterleiten.
For more information about the barcoded forms service, see Services Reference for AEM Forms .

Dekodieren von Formulardaten mit Strichcode

Sie können die Barcoded Forms-Dienst-API verwenden, um Daten aus einem PDF-Formular oder einem Bild mit einem Barcode zu dekodieren. Das Dekodieren von Formulardaten bedeutet das Extrahieren von Daten, die sich im Barcode befinden. Bevor Daten aus einem PDF-Formular (oder Bild) dekodiert werden können, muss der Benutzer das Formular mit Daten füllen.
For more information about the barcoded forms service, see Services Reference for AEM Forms .

Zusammenfassung der Schritte

So dekodieren Sie Daten aus einem PDF-Formular:
  1. Schließen Sie Projektdateien ein.
  2. Erstellen Sie ein mit Strichcode versehenes formsClient-API-Objekt.
  3. Rufen Sie ein PDF-Formular ab, das mit Strichcode versehene Daten enthält.
  4. Dekodieren Sie die Daten aus dem PDF-Formular.
  5. Konvertieren Sie die Daten in eine XML-Datenquelle.
  6. Verarbeiten Sie die dekodierten Daten.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem 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 (im Ordner <Installationsordner>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)
Wenn AEM Forms auf einem unterstützten J2EE-Anwendungsserver 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-Anwendungsserver sind, auf dem AEM Forms bereitgestellt wird. For information about the location of all AEM Forms JAR files, see Including AEM Forms Java library files .
Erstellen eines Client-API-Objekts mit Strichcode
Bevor Sie einen Barcoded Forms-Dienstvorgang programmgesteuert durchführen können, müssen Sie einen Barcoded Forms-Dienstclient erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein BarcodedFormsServiceClient Objekt. Wenn Sie die Barcoded Forms-Webdienst-API verwenden, erstellen Sie ein BarcodedFormsServiceService Objekt.
PDF-Formular mit Barcode-Daten abrufen
Sie müssen ein PDF-Formular abrufen, das einen Barcode enthält, der mit Benutzerdaten gefüllt wurde.
Daten aus dem PDF-Formular dekodieren
Nachdem Sie ein PDF-Formular (oder Bild) mit einem Barcode erhalten haben, können Sie Daten dekodieren. Der Barcoded Forms-Dienst unterstützt die folgenden Barcodetypen:
  • PDF417-Barcodes.
  • Datenmatrix-Barcodes.
  • QR-Code-Barcodes.
  • Codabar-Barcodes.
  • Barcodes des Codes 128.
  • Code 39-Barcodes.
  • EAN-13-Barcodes.
  • EAN-8-Barcodes.
Die als Hexadezimal eingegebene Zeichensatzeingabe in der Dekodierungs-API bedeutet, dass der Barcode-Inhalt als Hexadezimalzeichenfolge kodiert ist. Wenn beispielsweise UTF-8 als Zeichenkodierung im Formular angegeben ist und Hex im Dekodierungsvorgang angegeben ist, wird der Inhalt des Barcodes als Hex-Zeichenfolge im < xb:content >-Element in der dekodierten Ausgabe kodiert. Sie können diesen Hex-Wert konvertieren, um den ursprünglichen Inhalt abzurufen, indem Sie die Anwendungslogik in Ihrer Clientanwendung erstellen.
Daten in eine XML-Datenquelle konvertieren
Nachdem Sie Formulardaten dekodiert haben, können Sie sie in XDP- oder XFDF-Daten konvertieren. Nehmen Sie beispielsweise an, 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 Formulardaten importieren.
Die dekodierten Daten verarbeiten
Sie können die konvertierten Daten entsprechend Ihren Geschäftsanforderungen verarbeiten. Nachdem Sie die Daten beispielsweise dekodiert 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.
Der Barcoded Forms-Dienst kann Strichcodedaten nicht dekodieren, wenn die Parameter für Trennzeichen und Feldtrennzeichen denselben Wert haben
Siehe auch

Dekodieren von Formulardaten mit Strichcode mithilfe der Java-API

Dekodieren von Formulardaten mithilfe der Barcoded Forms API (Java):
  1. Projektdateien einschließen
    Schließen Sie JAR-Clientdateien in den Klassenpfad Ihres Java-Projekts ein.
  2. Erstellen eines Client-API-Objekts mit Strichcode
    Erstellen Sie ein BarcodedFormsServiceClient Objekt, indem Sie dessen Konstruktor verwenden und ein ServiceClientFactory Objekt übergeben, das Verbindungseigenschaften enthält.
  3. PDF-Formular mit Barcode-Daten abrufen
    • Erstellen Sie ein java.io.FileInputStream Objekt, das das PDF-Formular darstellt, das mit Strichcode versehene Daten enthält, indem Sie den 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. Daten aus dem PDF-Formular dekodieren
    Dekodieren Sie die Formulardaten, indem Sie die BarcodedFormsServiceClient Methode des decode 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 dekodiert werden soll.
    • Ein java.lang.Boolean Objekt, das angibt, ob ein Datenmatrix-Barcode dekodiert werden soll.
    • Ein java.lang.Boolean Objekt, das angibt, ob ein QR-Code-Barcode dekodiert werden soll.
    • Ein java.lang.Boolean Objekt, das angibt, ob ein Codabar-Barcode dekodiert werden soll.
    • Ein java.lang.Boolean Objekt, das angibt, ob ein Code-128-Barcode dekodiert werden soll.
    • Ein java.lang.Boolean Objekt, das angibt, ob ein Code 39-Barcode dekodiert werden soll.
    • Ein java.lang.Boolean Objekt, das angibt, ob ein EAN-13-Barcode dekodiert werden soll.
    • Ein java.lang.Boolean Objekt, das angibt, ob ein EAN-8-Barcode dekodiert werden soll.
    • A com.adobe.livecycle.barcodedforms.CharSet enumeration value that specifies the character set encoding value used in the barcode. Die decode Methode gibt ein org.w3c.dom.Document Objekt zurück, das dekodierte Formulardaten enthält.
  5. Daten in eine XML-Datenquelle konvertieren
    Konvertieren Sie die dekodierten Daten in XDP- oder XFDF-Daten, indem Sie die BarcodedFormsServiceClient extractToXML Objektmethode aufrufen und die folgenden Werte übergeben:
    • Das org.w3c.dom.Document Objekt, das dekodierte Daten enthält (stellen Sie sicher, dass Sie den Rückgabewert der decode Methode verwenden).
    • Ein com.adobe.livecycle.barcodedforms.Delimiter Aufzählungswert, der das Trennzeichen angibt. Es wird empfohlen, dies anzugeben Delimiter.Carriage_Return .
    • Ein com.adobe.livecycle.barcodedforms.Delimiter Aufzählungswert, der das Feldtrennzeichen angibt. For example, specify Delimiter.Tab .
    • Ein com.adobe.livecycle.barcodedforms.XMLFormat Aufzählungswert, der angibt, ob Barcodedaten in XDP- oder XFDF-XML-Daten konvertiert werden sollen. Geben Sie beispielsweise an, XMLFormat.XDP die Daten in XDP-Daten zu konvertieren.
    Geben Sie nicht dieselben Werte für die Parameter für das Trennzeichen und das Feldtrennzeichen an.
    Die extractToXML Methode gibt ein java.util.List Objekt zurück, bei dem jedes Element ein org.w3c.dom.Document Objekt ist. Es gibt ein separates Element für jeden Barcode, der sich im Formular befindet. Das heißt, wenn sich im Formular vier Barcodes befinden, sind im zurückgegebenen java.util.List Objekt vier Elemente vorhanden.
  6. Die dekodierten Daten verarbeiten
    • Durchsuchen Sie das java.util.List Objekt, um jedes org.w3c.dom.Document Objekt in der Liste abzurufen.
    • 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 konvertiert, wird in den Daten des Dekodierens mit Strichcode unter Verwendung des Java-API-Beispiels angezeigt.)
    • Speichern Sie die XML-Daten als XML-Datei, indem Sie das com.adobe.idp.Document Objekt aufrufen copyToFile und ein File-Objekt übergeben, das die XML-Datei darstellt.
Siehe auch

Dekodieren von Formulardaten mit Strichcode mithilfe der Webdienst-API

Dekodieren von Formulardaten mithilfe der Barcoded Forms API(Webdienst):
  1. Projektdateien einschließen
  2. Erstellen eines Client-API-Objekts mit Strichcode
    Erstellen Sie mithilfe der Microsoft .NET-Client-Assembly, die die WSDL des Barcoded Forms-Dienstes verwendet, ein BarcodedFormsServiceService Objekt, indem Sie dessen Standardkonstruktor aufrufen.
  3. PDF-Formular mit Barcode-Daten abrufen
    • Erstellen Sie ein Objekt BLOB , indem Sie den Konstruktor verwenden. Das BLOB Objekt dient zum Speichern eines PDF-Dokuments, das einen Barcode enthält.
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
    • Erstellen Sie ein Bytearray, das den Inhalt des System.IO.FileStream Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream Objekteigenschaft Length abrufen.
    • Füllen Sie das Bytearray mit Stream-Daten, indem Sie die System.IO.FileStream Objektmethode aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben Read .
    • Füllen Sie das BLOB Objekt, indem Sie seine binaryData Eigenschaft mit dem Inhalt des Byte-Arrays zuweisen.
  4. Daten aus dem PDF-Formular dekodieren
    Dekodieren Sie die Formulardaten, indem Sie die BarcodedFormsServiceService Methode des decode Objekts aufrufen und die folgenden Werte übergeben:
    • Das BLOB Objekt, das das PDF-Formular enthält.
    • Ein Boolean Objekt, das angibt, ob ein PDF417-Barcode dekodiert werden soll.
    • Ein Boolean Objekt, das angibt, ob ein Datenmatrix-Barcode dekodiert werden soll.
    • Ein Boolean Objekt, das angibt, ob ein QR-Code-Barcode dekodiert werden soll.
    • Ein Boolean Objekt, das angibt, ob ein Codabar-Barcode dekodiert werden soll.
    • Ein Boolean Objekt, das angibt, ob ein Code-128-Barcode dekodiert werden soll.
    • Ein Bolean Objekt, das angibt, ob ein Code 39-Barcode dekodiert werden soll.
    • Ein Boolean Objekt, das angibt, ob ein EAN-13-Barcode dekodiert werden soll.
    • Ein Boolean Objekt, das angibt, ob ein EAN-8-Barcode dekodiert werden soll.
    • A CharSet enumeration value that specifies the character set encoding value used in the barcode. Die decode Methode gibt einen Zeichenfolgenwert zurück, der dekodierte Formulardaten enthält.
  5. Daten in eine XML-Datenquelle konvertieren
    Konvertieren Sie die dekodierten Daten in XDP- oder XFDF-Daten, indem Sie die BarcodedFormsServiceService extractToXML Objektmethode aufrufen und die folgenden Werte übergeben:
    • Ein Zeichenfolgenwert, der dekodierte Daten enthält (stellen Sie sicher, dass Sie den Rückgabewert der decode Methode verwenden).
    • Ein Delimiter Aufzählungswert, der das Trennzeichen angibt. Es wird empfohlen, dies anzugeben Delimiter.Carriage_Return .
    • Ein Delimiter Aufzählungswert, der das Feldtrennzeichen angibt. For example, specify Delimiter.Tab .
    • Ein XMLFormat Aufzählungswert, der angibt, ob Barcodedaten in XDP- oder XFDF-XML-Daten konvertiert werden sollen. Geben Sie beispielsweise an, XMLFormat.XDP die Daten in XDP-Daten zu konvertieren.
    Geben Sie nicht dieselben Werte für die Parameter für das Trennzeichen und das Feldtrennzeichen an.
    Die extractToXML Methode gibt ein Object Array zurück, bei dem jedes Element eine BLOB Instanz ist. Es gibt ein separates Element für jeden Barcode, der sich im Formular befindet. Das heißt, wenn sich im Formular vier Barcodes befinden, sind im zurückgegebenen Object Array vier Elemente vorhanden.
  6. Die dekodierten Daten verarbeiten
    • Erstellen Sie ein System.IO.FileStream Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des geschützten PDF-Dokuments darstellt.
    • Erstellen Sie ein Bytearray, das den Dateninhalt des BLOB Objekts speichert, das von der encryptPDFUsingPassword Methode zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert des BLOB Datenelements des binaryData Objekts abrufen.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
    • Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die System.IO.BinaryWriter Objektmethode aufrufen und das Bytearray Write übergeben.
Siehe auch