Werken met formulieren met streepjescodes working-with-barcoded-forms
De service voor streepjescodes about-the-barcoded-forms-service
De service voor streepjescodes automatiseert het vastleggen van gegevens van invulformulieren en integreert vastgelegde informatie in de belangrijkste IT-systemen van een organisatie.
Met de service voor streepjescodes kunt u eendimensionale en tweedimensionale streepjescodes toevoegen aan interactieve PDF forms. U kunt de gecodeerde formulieren vervolgens publiceren naar een website of ze via e-mail of cd verspreiden. Wanneer een gebruiker een formulier met streepjescodes invult in Adobe Reader, Acrobat Professional of Acrobat Standard, wordt de streepjescode automatisch bijgewerkt om de door de gebruiker opgegeven formuliergegevens te coderen. De gebruiker kan het formulier elektronisch verzenden of afdrukken naar papier en het verzenden per post, fax of hand. U kunt de gebruiker-geleverde gegevens als deel van een geautomatiseerde werkschema later halen, verpletterend de gegevens onder goedkeuringsprocessen en bedrijfssystemen.
Voor meer informatie over de service voor streepjescodes raadpleegt u Services Reference for AEM Forms.
Gecodeerde formuliergegevens decoderen decoding-barcoded-form-data
U kunt de API van de service voor gecodeerde formulieren gebruiken om gegevens te decoderen van een PDF-formulier of een afbeelding die een streepjescode bevat. Formuliergegevens decoderen betekent gegevens extraheren die zich in de streepjescode bevinden. Voordat gegevens kunnen worden gedecodeerd vanuit een PDF-formulier (of afbeelding), moet een gebruiker het formulier vullen met gegevens.
Overzicht van de stappen summary-of-steps
Voer de volgende stappen uit om gegevens van een PDF-formulier te decoderen:
- Inclusief projectbestanden.
- Maak een gestreepte formClient API-object.
- Hiermee wordt een PDF-formulier opgehaald dat gecodeerde gegevens bevat.
- De gegevens decoderen uit een PDF-formulier.
- Zet de gegevens om in een XML-gegevensbron.
- De gedecodeerde gegevens verwerken.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-barcodedforms-client.jar
- adobe-utilities.jar (Vereist als AEM Forms wordt geïmplementeerd op JBoss)
- jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)
- xercesImpl.jar (bevindt zich in <install directory="">/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\third)
Als AEM Forms wordt geïmplementeerd op een ondersteunde J2EE-toepassingsserver die geen JBOSS is, moet u adobe-utilities.jar en jbossall-client.jar vervangen door JAR-bestanden die specifiek zijn voor de J2EE-toepassingsserver waarop AEM Forms wordt geïmplementeerd. Voor informatie over de locatie van alle AEM Forms JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.
Een gestreepte API-object voor formulieren maken
Voordat u via programmacode een bewerking met een service voor streepjescodes kunt uitvoeren, moet u een Forms-serviceclient met streepjescodes maken. Als u de Java API gebruikt, maakt u een BarcodedFormsServiceClient
object. Als u de API voor webservices voor streepjescodes gebruikt, maakt u een BarcodedFormsServiceService
object.
Een PDF-formulier ophalen dat gecodeerde gegevens bevat
U moet een PDF-formulier ophalen dat een streepjescode bevat die is gevuld met gebruikersgegevens.
De gegevens decoderen uit het PDF-formulier
Nadat u een PDF-formulier (of afbeelding) met een streepjescode hebt ontvangen, kunt u gegevens decoderen. De service Barcoded Forms ondersteunt de volgende typen streepjescodes:
- PDF417-streepjescodes.
- Streepjescodes gegevensmatrix.
- Streepjescodes van QR-code.
- Codabar-streepjescodes.
- Code 128 streepjescodes.
- Code 39 streepjescodes.
- EAN-13-streepjescodes.
- EAN-8 streepjescodes.
Invoer van tekensets als hexadecimale invoer in de decode-API houdt in dat de inhoud van de streepjescode wordt gecodeerd als een hexadecimale tekenreeks. Als UTF-8 bijvoorbeeld is opgegeven als tekencodering in het formulier en Hex is opgegeven in de decoderingsbewerking, wordt de inhoud van de streepjescode gecodeerd als een hexadecimale tekenreeks in de < xb:content
>-element in de gedecodeerde uitvoer. U kunt deze hexadecimale waarde omzetten om de oorspronkelijke inhoud op te halen door toepassingslogica in uw cliënttoepassing te creëren.
De gegevens converteren naar een XML-gegevensbron
Nadat u formuliergegevens hebt gedecodeerd, kunt u deze converteren naar XDP- of XFDF-gegevens. Stel bijvoorbeeld dat u de gegevens in een ander formulier wilt importeren. Als u de gegevens wilt importeren in een XFA-formulier, moet u de gegevens converteren naar XDP-gegevens. Zie voor meer informatie Formuliergegevens importeren.
De gedecodeerde gegevens verwerken
U kunt de omgezette gegevens verwerken om aan uw bedrijfsvereisten te voldoen. Nadat u de gegevens hebt gedecodeerd en geconverteerd, kunt u deze bijvoorbeeld opslaan in een bestand, opslaan in een ondernemingsdatabase, een ander formulier invullen, enzovoort. In deze sectie wordt besproken hoe de geconverteerde gegevens als een XML-bestand moeten worden opgeslagen.
Zie ook
Gecodeerde formuliergegevens decoderen met de Java API
Gecodeerde formuliergegevens decoderen met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Gecodeerde formuliergegevens decoderen met de Java API decode-barcoded-form-data-using-the-java-api
Formuliergegevens decoderen met de API voor streepjescodes (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden op in het klassenpad van uw Java-project.
-
Een gestreepte API-object voor formulieren maken
Een
BarcodedFormsServiceClient
object door de constructor ervan te gebruiken en een object door te gevenServiceClientFactory
object dat verbindingseigenschappen bevat. -
Een PDF-formulier ophalen dat gecodeerde gegevens bevat
- Een
java.io.FileInputStream
object dat het PDF-formulier vertegenwoordigt dat gecodeerde gegevens met streepjescodes bevat, door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document aangeeft. - Een
com.adobe.idp.Document
object door de constructor ervan te gebruiken en door te gevenjava.io.FileInputStream
object.
- Een
-
De gegevens decoderen uit het PDF-formulier
De formuliergegevens decoderen door de
BarcodedFormsServiceClient
objectdecode
en geeft de volgende waarden door:- De
com.adobe.idp.Document
object dat het PDF-formulier bevat. - A
java.lang.Boolean
object dat aangeeft of een PDF417-streepjescode moet worden gedecodeerd. - A
java.lang.Boolean
object dat aangeeft of een streepjescode voor een gegevensmatrix moet worden gedecodeerd. - A
java.lang.Boolean
object dat aangeeft of een streepjescode voor QR-code moet worden gedecodeerd. - A
java.lang.Boolean
een object dat aangeeft of een streepjescode voor een codabar moet worden gedecodeerd. - A
java.lang.Boolean
object dat aangeeft of een code 128-streepjescode moet worden gedecodeerd. - A
java.lang.Boolean
object dat aangeeft of een code 39-streepjescode moet worden gedecodeerd. - A
java.lang.Boolean
object dat aangeeft of een EAN-13-streepjescode moet worden gedecodeerd. - A
java.lang.Boolean
object dat aangeeft of een EAN-8-streepjescode moet worden gedecodeerd. - A
com.adobe.livecycle.barcodedforms.CharSet
opsommingswaarde die de coderingswaarde van de tekenset opgeeft die in de streepjescode wordt gebruikt.
De
decode
methode retourneert eenorg.w3c.dom.Document
object dat gedecodeerde formuliergegevens bevat. - De
-
De gegevens converteren naar een XML-gegevensbron
De gedecodeerde gegevens converteren naar XDP- of XFDF-gegevens door het
BarcodedFormsServiceClient
objectextractToXML
en geeft de volgende waarden door:- De
org.w3c.dom.Document
object dat gedecodeerde gegevens bevat (gebruik dedecode
retourwaarde van de methode). - A
com.adobe.livecycle.barcodedforms.Delimiter
opsommingswaarde die het regelscheidingsteken aangeeft. U wordt aangeradenDelimiter.Carriage_Return
. - A
com.adobe.livecycle.barcodedforms.Delimiter
opsommingswaarde die het veldscheidingsteken aangeeft. Geef bijvoorbeeldDelimiter.Tab
. - A
com.adobe.livecycle.barcodedforms.XMLFormat
opsommingswaarde die aangeeft of de streepjescodegegevens moeten worden omgezet in XDP- of XFDF XML-gegevens. Geef bijvoorbeeldXMLFormat.XDP
om de gegevens om te zetten in XDP-gegevens.
note note NOTE Geef niet dezelfde waarden op voor de parameters voor regelscheidingsteken en veldscheidingsteken. De
extractToXML
methode retourneert eenjava.util.List
object waarbij elk element eenorg.w3c.dom.Document
object. Er is een afzonderlijk element voor elke streepjescode die zich op het formulier bevindt. Als er vier streepjescodes op het formulier staan, staan er vier elementen in het teruggestuurde formulierjava.util.List
object. - De
-
De gedecodeerde gegevens verwerken
- Doorlopen
java.util.List
object om elk op te halenorg.w3c.dom.Document
object dat zich in de lijst bevindt. - Zet voor elk element in de lijst de
org.w3c.dom.Document
object naar eencom.adobe.idp.Document
object. (De toepassingslogica die eenorg.w3c.dom.Document
in eencom.adobe.idp.Document
-object wordt weergegeven in de formuliergegevens met streepjescode decoderen met behulp van het Java API-voorbeeld). - Sla de XML-gegevens op als een XML-bestand door het
com.adobe.idp.Document
objectcopyToFile
en geeft u een File-object door dat het XML-bestand vertegenwoordigt.
- Doorlopen
Zie ook
Snel starten (SOAP-modus): Gecodeerde formuliergegevens decoderen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Gecodeerde formuliergegevens decoderen met de webservice-API decode-barcoded-form-data-using-the-web-service-api
Formuliergegevens decoderen met de API voor gecodeerde formulieren (webservice):
-
Projectbestanden opnemen
- Creeer een de cliëntassemblage van Microsoft .NET die de streepjescoded dienst WSDL gebruikt. Zie voor meer informatie AEM Forms aanroepen met Base64-codering.
- Verwijs naar de Microsoft .NET cliëntassemblage. Voor informatie, zie "Verwijzen van de .NET cliëntassemblage"in AEM Forms aanroepen met Base64-codering.
-
Een gestreepte API-object voor formulieren maken
Het gebruiken van de de cliëntassemblage van Microsoft .NET die de streepjescoded dienst WSDL gebruikt, creeer een
BarcodedFormsServiceService
object door de standaardconstructor aan te roepen. -
Een PDF-formulier ophalen dat gecodeerde gegevens bevat
- Een
BLOB
object met behulp van de constructor. DeBLOB
wordt gebruikt om een PDF-document op te slaan dat een streepjescode bevat. - Een
System.IO.FileStream
door de constructor aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het PDF-document en de modus waarin het bestand moet worden geopend, vertegenwoordigt. - Maak een bytearray waarin de inhoud van de
System.IO.FileStream
object. U kunt de grootte van de bytearray bepalen door deSystem.IO.FileStream
objectLength
eigenschap. - De bytearray vullen met streamgegevens door de
System.IO.FileStream
objectRead
en geeft u de bytearray, de startpositie en de streamlengte door die u wilt lezen. - Vul de
BLOB
object door het toe te wijzenbinaryData
eigenschap met de inhoud van de bytearray.
- Een
-
De gegevens decoderen uit het PDF-formulier
De formuliergegevens decoderen door de
BarcodedFormsServiceService
objectdecode
en geeft de volgende waarden door:- De
BLOB
object dat het PDF-formulier bevat. - A
Boolean
object dat aangeeft of een PDF417-streepjescode moet worden gedecodeerd. - A
Boolean
object dat aangeeft of een streepjescode voor een gegevensmatrix moet worden gedecodeerd. - A
Boolean
object dat aangeeft of een streepjescode voor QR-code moet worden gedecodeerd. - A
Boolean
een object dat aangeeft of een streepjescode voor een codabar moet worden gedecodeerd. - A
Boolean
object dat aangeeft of een code 128-streepjescode moet worden gedecodeerd. - A
Bolean
object dat aangeeft of een code 39-streepjescode moet worden gedecodeerd. - A
Boolean
object dat aangeeft of een EAN-13-streepjescode moet worden gedecodeerd. - A
Boolean
object dat aangeeft of een EAN-8-streepjescode moet worden gedecodeerd. - A
CharSet
opsommingswaarde die de coderingswaarde van de tekenset opgeeft die in de streepjescode wordt gebruikt.
De
decode
Deze methode retourneert een tekenreekswaarde die gedecodeerde formuliergegevens bevat. - De
-
De gegevens converteren naar een XML-gegevensbron
De gedecodeerde gegevens converteren naar XDP- of XFDF-gegevens door het
BarcodedFormsServiceService
objectextractToXML
en geeft de volgende waarden door:- Een tekenreekswaarde die gedecodeerde gegevens bevat (gebruik de optie
decode
retourwaarde van de methode). - A
Delimiter
opsommingswaarde die het regelscheidingsteken aangeeft. U wordt aangeradenDelimiter.Carriage_Return
. - A
Delimiter
opsommingswaarde die het veldscheidingsteken aangeeft. Geef bijvoorbeeldDelimiter.Tab
. - A
XMLFormat
opsommingswaarde die aangeeft of de streepjescodegegevens moeten worden omgezet in XDP- of XFDF XML-gegevens. Geef bijvoorbeeldXMLFormat.XDP
om de gegevens om te zetten in XDP-gegevens.
note note NOTE Geef niet dezelfde waarden op voor de parameters voor regelscheidingsteken en veldscheidingsteken. De
extractToXML
methode retourneert eenObject
array waarbij elk element eenBLOB
-instantie. Er is een afzonderlijk element voor elke streepjescode die zich op het formulier bevindt. Als er vier streepjescodes op het formulier staan, staan er vier elementen in het teruggestuurde formulierObject
array. - Een tekenreekswaarde die gedecodeerde gegevens bevat (gebruik de optie
-
De gedecodeerde gegevens verwerken
- Een
System.IO.FileStream
door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het beveiligde PDF-document vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud van de
BLOB
object dat is geretourneerd door deencryptPDFUsingPassword
methode. Vul de bytearray met de waarde van deBLOB
objectbinaryData
lid. - Een
System.IO.BinaryWriter
object door de constructor aan te roepen en deSystem.IO.FileStream
object. - Schrijf de inhoud van de bytearray naar een PDF-bestand door het
System.IO.BinaryWriter
objectWrite
en geeft u de bytearray door.
- Een
Zie ook
AEM Forms aanroepen met Base64-codering