Werken met formulieren met streepjescodes working-with-barcoded-forms
de Steekproeven en de voorbeelden in dit document zijn slechts voor AEM Forms op milieu JEE.
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. Vervolgens kunt u de formulieren met streepjescodes publiceren naar een website of deze 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 streepjescoded vormendienst, zie Verwijzing van de Diensten voor 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 houdt in dat gegevens uit de streepjescode worden geëxtraheerd. 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.
omvat projectdossiers
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 (in <install directory>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdParty)
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 plaats van alle dossiers van AEM Forms JAR, zie Inclusief de bibliotheekdossiers van AEM Forms Java.
creeer een streepjescoded voorwerp van de cliënt API van vormen
Voordat u via programmacode een bewerking met een service voor streepjescodes kunt uitvoeren, moet u een Forms-serviceclient met streepjescodes maken. Maak een BarcodedFormsServiceClient
-object als u de Java API gebruikt. Als u de API voor webservices voor streepjescodes gebruikt, maakt u een BarcodedFormsServiceService
-object.
krijg een vorm van PDF die streepjescoded gegevens bevat
Vraag een PDF-formulier aan dat een streepjescode bevat die is gevuld met gebruikersgegevens.
decodeer de gegevens van de vorm van PDF
Nadat u een PDF-formulier (of afbeelding) hebt ontvangen dat een streepjescode bevat, 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 het element < xb:content
> 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.
zet de gegevens in een gegevensbron van XML om
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. Voor informatie, zie het Invoeren van de Gegevens van de Vorm.
Proces de gedecodeerde gegevens
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
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
Maak een
BarcodedFormsServiceClient
-object door de constructor ervan te gebruiken en eenServiceClientFactory
-object door te geven dat verbindingseigenschappen bevat. -
Een PDF-formulier ophalen dat gecodeerde gegevens bevat
- Maak een
java.io.FileInputStream
-object dat het PDF-formulier vertegenwoordigt dat gecodeerde gegevens bevat, door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het PDF-document opgeeft. - Maak een
com.adobe.idp.Document
-object door de constructor ervan te gebruiken en hetjava.io.FileInputStream
-object door te geven.
- Maak een
-
De gegevens decoderen uit het PDF-formulier
Decodeer de formuliergegevens door de methode
decode
van het objectBarcodedFormsServiceClient
aan te roepen en de volgende waarden door te geven:- Het
com.adobe.idp.Document
-object dat het PDF-formulier bevat. - Een
java.lang.Boolean
-object dat opgeeft of een PDF417-streepjescode moet worden gedecodeerd. - Een
java.lang.Boolean
-object dat opgeeft of een streepjescode voor een gegevensmatrix moet worden gedecodeerd. - Een
java.lang.Boolean
-object dat opgeeft of een streepjescode voor QR-code moet worden gedecodeerd. - Een
java.lang.Boolean
-object dat opgeeft of een streepjescode van het type codabar moet worden gedecodeerd. - Een
java.lang.Boolean
-object dat opgeeft of een code 128-streepjescode moet worden gedecodeerd. - Een
java.lang.Boolean
-object dat opgeeft of een code 39-streepjescode moet worden gedecodeerd. - Een
java.lang.Boolean
-object dat opgeeft of een EAN-13-streepjescode moet worden gedecodeerd. - Een
java.lang.Boolean
-object dat opgeeft of een EAN-8-streepjescode moet worden gedecodeerd. - Een opsommingswaarde
com.adobe.livecycle.barcodedforms.CharSet
die de coderingswaarde voor de tekenset opgeeft die in de streepjescode wordt gebruikt.
De methode
decode
retourneert eenorg.w3c.dom.Document
-object dat gedecodeerde formuliergegevens bevat. - Het
-
De gegevens converteren naar een XML-gegevensbron
Zet de gedecodeerde gegevens om in XDP- of XFDF-gegevens door de methode
extractToXML
van het objectBarcodedFormsServiceClient
aan te roepen en de volgende waarden door te geven:- Het
org.w3c.dom.Document
-object dat gedecodeerde gegevens bevat (gebruik de geretourneerde waarde van de methodedecode
). - Een opsommingswaarde
com.adobe.livecycle.barcodedforms.Delimiter
die het regelscheidingsteken opgeeft. Het wordt aanbevolenDelimiter.Carriage_Return
op te geven. - Een opsommingswaarde
com.adobe.livecycle.barcodedforms.Delimiter
die het veldscheidingsteken opgeeft. Geef bijvoorbeeldDelimiter.Tab
op. - Een opsommingswaarde
com.adobe.livecycle.barcodedforms.XMLFormat
die aangeeft of de streepjescodegegevens moeten worden omgezet in XDP- of XFDF XML-gegevens. Geef bijvoorbeeldXMLFormat.XDP
op om de gegevens te converteren naar XDP-gegevens.
note note NOTE Geef niet dezelfde waarden op voor de parameters voor regelscheidingsteken en veldscheidingsteken. De methode
extractToXML
retourneert eenjava.util.List
-object waar elk element eenorg.w3c.dom.Document
-object is. Er is een afzonderlijk element voor elke streepjescode die zich op het formulier bevindt. Als het formulier vier streepjescodes bevat, bevat het geretourneerdejava.util.List
-object vier elementen. - Het
-
De gedecodeerde gegevens verwerken
- Doorloop het
java.util.List
-object om elkorg.w3c.dom.Document
-object in de lijst op te halen. - Zet voor elk element in de lijst het object
org.w3c.dom.Document
om in een objectcom.adobe.idp.Document
. (De toepassingslogica die eenorg.w3c.dom.Document
-object omzet in eencom.adobe.idp.Document
-object, wordt weergegeven in de streepjescode-formuliergegevens decoderen met behulp van het Java API-voorbeeld). - Sla de XML-gegevens op als een XML-bestand door het object
com.adobe.idp.Document
copyToFile
aan te roepen en een object File door te geven dat het XML-bestand vertegenwoordigt.
- Doorloop het
zie ook
Snel starten (SOAP modus): gecodeerde formuliergegevens decoderen met de Java API
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. Voor informatie, zie het Aanhalen van AEM Forms gebruikend het coderen Base64.
- Verwijs naar de Microsoft .NET cliëntassemblage. Voor informatie, zie "Verwijzen van de .NET cliëntassemblage"in het Aanhalen van AEM Forms gebruikend Base64 het coderen.
-
Een gestreepte API-object voor formulieren maken
Gebruikend de de cliëntassemblage van Microsoft .NET die de streepjescoded dienst WSDL gebruikt, creeer een
BarcodedFormsServiceService
voorwerp door zijn standaardaannemer aan te halen. -
Een PDF-formulier ophalen dat gecodeerde gegevens bevat
- Maak een
BLOB
-object met behulp van de constructor. HetBLOB
-object wordt gebruikt om een PDF-document op te slaan dat een streepjescode bevat. - Maak een
System.IO.FileStream
-object door de constructor ervan 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 het object
System.IO.FileStream
wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschapLength
van het objectSystem.IO.FileStream
op te halen. - Vul de bytearray met streamgegevens door de methode
Read
van het objectSystem.IO.FileStream
aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen. - Vul het object
BLOB
door de eigenschapbinaryData
ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
De gegevens decoderen uit het PDF-formulier
Decodeer de formuliergegevens door de methode
decode
van het objectBarcodedFormsServiceService
aan te roepen en de volgende waarden door te geven:- Het
BLOB
-object dat het PDF-formulier bevat. - Een
Boolean
-object dat opgeeft of een PDF417-streepjescode moet worden gedecodeerd. - Een
Boolean
-object dat opgeeft of een streepjescode voor een gegevensmatrix moet worden gedecodeerd. - Een
Boolean
-object dat opgeeft of een streepjescode voor QR-code moet worden gedecodeerd. - Een
Boolean
-object dat opgeeft of een streepjescode van het type codabar moet worden gedecodeerd. - Een
Boolean
-object dat opgeeft of een code 128-streepjescode moet worden gedecodeerd. - Een
Bolean
-object dat opgeeft of een code 39-streepjescode moet worden gedecodeerd. - Een
Boolean
-object dat opgeeft of een EAN-13-streepjescode moet worden gedecodeerd. - Een
Boolean
-object dat opgeeft of een EAN-8-streepjescode moet worden gedecodeerd. - Een opsommingswaarde
CharSet
die de coderingswaarde voor de tekenset opgeeft die in de streepjescode wordt gebruikt.
De methode
decode
retourneert een tekenreekswaarde die gedecodeerde formuliergegevens bevat. - Het
-
De gegevens converteren naar een XML-gegevensbron
Zet de gedecodeerde gegevens om in XDP- of XFDF-gegevens door de methode
extractToXML
van het objectBarcodedFormsServiceService
aan te roepen en de volgende waarden door te geven:- Een tekenreekswaarde die gedecodeerde gegevens bevat (gebruik de geretourneerde waarde van de methode
decode
). - Een opsommingswaarde
Delimiter
die het regelscheidingsteken opgeeft. Het wordt aanbevolenDelimiter.Carriage_Return
op te geven. - Een opsommingswaarde
Delimiter
die het veldscheidingsteken opgeeft. Geef bijvoorbeeldDelimiter.Tab
op. - Een opsommingswaarde
XMLFormat
die aangeeft of de streepjescodegegevens moeten worden omgezet in XDP- of XFDF XML-gegevens. Geef bijvoorbeeldXMLFormat.XDP
op om de gegevens te converteren naar XDP-gegevens.
note note NOTE Geef niet dezelfde waarden op voor de parameters voor regelscheidingsteken en veldscheidingsteken. De methode
extractToXML
retourneert eenObject
-array waarbij elk element eenBLOB
-instantie is. 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 de geretourneerdeObject
-array. - Een tekenreekswaarde die gedecodeerde gegevens bevat (gebruik de geretourneerde waarde van de methode
-
De gedecodeerde gegevens verwerken
- Maak een
System.IO.FileStream
-object 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 wordt opgeslagen van het object
BLOB
dat door de methodeencryptPDFUsingPassword
is geretourneerd. Vul de bytearray met de waarde van het gegevenslidbinaryData
van het objectBLOB
. - Maak een
System.IO.BinaryWriter
-object door de constructor ervan aan te roepen en hetSystem.IO.FileStream
-object door te geven. - Schrijf de inhoud van de bytearray naar een PDF-bestand door de methode
Write
van het objectSystem.IO.BinaryWriter
aan te roepen en de bytearray door te geven.
- Maak een
zie ook
AEM Forms aanroepen met Base64-codering