Gegevens importeren en exporteren importing-and-exporting-data
de Steekproeven en de voorbeelden in dit document zijn slechts voor AEM Forms op milieu JEE.
Over de service Formuliergegevensintegratie about-the-form-data-integration-service
De dienst van de Integratie van Gegevens van de Vorm kan gegevens in een vorm van PDF invoeren en gegevens van een vorm van PDF uitvoeren. De import- en exportbewerkingen ondersteunen twee typen PDF forms:
- Een Acrobat-formulier (gemaakt in Acrobat) is een PDF-document dat formuliervelden bevat.
- Een Adobe XML-formulier (gemaakt in Designer) is een PDF-document dat voldoet aan de XML Adobe XML Forms Architecture (XFA).
Formuliergegevens kunnen afhankelijk van het type PDF-formulier in een van de volgende indelingen bestaan:
- An XFDF file, which is an XML version of the Acrobat form data format.
- Een XDP-bestand, een XML-bestand dat formuliervelddefinities bevat. Het kan ook formulierveldgegevens en een ingesloten PDF-bestand bevatten. Een XDP-bestand dat door Designer wordt gegenereerd, kan alleen worden gebruikt als het een ingesloten basis-64-gecodeerd PDF-document bevat.
U kunt deze taken uitvoeren met de service Formuliergegevensintegratie:
- Gegevens importeren in PDF forms. Voor informatie, zie het Invoeren van de Gegevens van de Vorm.
- Gegevens exporteren uit PDF forms. Voor informatie, zie het Uitvoeren van de Gegevens van de Vorm.
Formuliergegevens importeren importing-form-data
U kunt formuliergegevens in interactieve PDF forms importeren met de service Formuliergegevensintegratie. Een interactief PDF-formulier is een PDF-document dat een of meer velden bevat voor het verzamelen van informatie van een gebruiker of voor het weergeven van aangepaste informatie. De service Formuliergegevensintegratie ondersteunt geen formulierberekeningen, validatie of scripts.
Als u gegevens wilt importeren in een formulier dat is gemaakt in Designer, moet u verwijzen naar een geldige XML-gegevensbron voor XDP. Neem bijvoorbeeld het volgende voorbeeld van een hypotheekapplicatie.
Als u gegevenswaarden in dit formulier wilt importeren, moet u beschikken over een geldige XML-gegevensbron die overeenkomt met het formulier. U kunt geen willekeurige XML-gegevensbron gebruiken om gegevens in een formulier te importeren met de service Formuliergegevensintegratie. Het verschil tussen een willekeurige XML-gegevensbron en een XDP XML-gegevensbron is dat een XDP-gegevensbron voldoet aan de XML Forms Architecture (XFA). De volgende XML vertegenwoordigt een XDP XML-gegevensbron die overeenkomt met het voorbeeld van een hypotheektoepassing.
<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
- <Layer>
<closeDate>1/26/2007</closeDate>
<lastName>Johnson</lastName>
<firstName>Jerry</firstName>
<mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
<city>New York</city>
<zipCode>00501</zipCode>
<state>NY</state>
<dateBirth>26/08/1973</dateBirth>
<middleInitials>D</middleInitials>
<socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
<phoneNumber>5555550000</phoneNumber>
</Layer>
- <Mortgage>
<mortgageAmount>295000.00</mortgageAmount>
<monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
<purchasePrice>300000</purchasePrice>
<downPayment>5000</downPayment>
<term>25</term>
<interestRate>5.00</interestRate>
</Mortgage>
</data>
</xfa:data>
</xfa:datasets>
Overzicht van de stappen summary-of-steps
Voer de volgende stappen uit om formuliergegevens te importeren in een PDF-formulier:
- Inclusief projectbestanden.
- Creeer een de dienstcliënt van de Integratie van Gegevens van de Vorm.
- Verwijzen naar een PDF-formulier.
- Verwijzen naar een XML-gegevensbron.
- Gegevens importeren in het PDF-formulier.
- Sla het PDF-formulier op als een PDF-bestand.
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-formdataintegration-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)
Voor informatie over de plaats van deze JAR dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.
creeer een de dienstcliënt van de Integratie van Gegevens van de Vorm
Voordat u via programmacode gegevens kunt importeren in een PDF formulier-client-API, moet u een Data Integration-service-client maken. Wanneer u een serviceclient maakt, definieert u verbindingsinstellingen die vereist zijn om een service aan te roepen. Voor informatie, zie Plaatsende verbindingseigenschappen.
Verwijzing a PDF vorm
Als u gegevens wilt importeren in een PDF-formulier, moet u verwijzen naar een XML-formulier dat in Designer is gemaakt of naar een Acrobat-formulier dat in Acrobat is gemaakt.
Verwijzing een gegevensbron van XML
Als u formuliergegevens wilt importeren, moet u naar een geldige gegevensbron verwijzen. Als u gegevens wilt importeren in een XFA XML-formulier dat in Designer is gemaakt, moet u een XDP XML-gegevensbron gebruiken. Als u naar een Acrobat-formulier verwijst, moet u een XFDF-gegevensbron gebruiken. Voor elk veld waarin u gegevens wilt importeren, moet een waarde worden opgegeven. Als een element in de XML-gegevensbron niet overeenkomt met een veld in het formulier, wordt het element genegeerd.
de Gegevens van de Invoer in de vorm van PDF
Nadat u naar een PDF-formulier en een geldige XML-gegevensbron hebt verwezen, kunt u de gegevens in het PDF-formulier importeren.
sparen de vorm van de PDF als dossier van de PDF
Nadat u gegevens in een formulier hebt geïmporteerd, kunt u het formulier opslaan als een PDF-bestand. Wanneer een gebruiker het formulier eenmaal heeft opgeslagen als een PDF-bestand, kan hij het formulier openen in Adobe Reader of Acrobat en het formulier bekijken met de geïmporteerde gegevens.
zie ook
Formuliergegevens importeren met de Java API
Formuliergegevens importeren met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Formuliergegevens importeren met de Java API import-form-data-using-the-java-api
Formuliergegevens importeren met de API voor formuliergegevensintegratie (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-formdataintegration-client.jar, op in het klassenpad van uw Java-project.
-
Creeer een de dienstcliënt van de Integratie van Gegevens van de Vorm.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
FormDataIntegrationClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Verwijzen naar een PDF-formulier.
- Maak een
java.io.FileInputStream
-object met behulp van de constructor. Geef een tekenreekswaarde door die de locatie van het PDF-formulier aangeeft. - Maak een
com.adobe.idp.Document
-object dat het PDF-formulier opslaat met decom.adobe.idp.Document
-constructor. Geef hetjava.io.FileInputStream
-object dat het PDF-formulier bevat door aan de constructor.
- Maak een
-
Verwijzen naar een XML-gegevensbron.
- Maak een
java.io.FileInputStream
-object met behulp van de constructor en geef een tekenreekswaarde door die de locatie aangeeft van het XML-bestand dat de gegevens bevat die in het formulier moeten worden geïmporteerd. - Maak een
com.adobe.idp.Document
-object dat formuliergegevens opslaat met decom.adobe.idp.Document
-constructor. Geef hetjava.io.FileInputStream
-object dat formuliergegevens bevat door aan de constructor.
- Maak een
-
Gegevens importeren in het PDF-formulier.
Importeer gegevens naar een PDF-formulier door de methode
importData
van het objectFormDataIntegrationClient
aan te roepen en de volgende waarden door te geven:- Het
com.adobe.idp.Document
-object dat het PDF-formulier opslaat. - Het
com.adobe.idp.Document
-object dat formuliergegevens opslaat.
De methode
importData
retourneert eencom.adobe.idp.Document
-object dat een PDF-formulier opslaat dat de gegevens in de XML-gegevensbron bevat. - Het
-
Sla het PDF-formulier op als een PDF-bestand.
- Maak een
java.io.File
-object en controleer of de bestandsextensie .PDF is. - Roep de methode
copyToFile
van het objectDocument
aan om de inhoud van het objectDocument
naar het bestand te kopiëren (gebruik het objectDocument
dat door de methodeimportData
is geretourneerd).
- Maak een
zie ook
Snel starten (SOAP modus): formuliergegevens importeren met de Java API
Formuliergegevens importeren met de webservice-API import-form-data-using-the-web-service-api
Formuliergegevens importeren met de API (webservice) voor formuliergegevensintegratie:
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.note note NOTE Vervang localhost
door het IP-adres van de server die als host fungeert voor AEM Forms. -
Creeer een de dienstcliënt van de Integratie van Gegevens van de Vorm.
-
Maak een
FormDataIntegrationClient
-object met de standaardconstructor. -
Maak een
FormDataIntegrationClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/FormDataIntegration?blob=mtom
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef echter?blob=mtom
op om MTOM te gebruiken. -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetFormDataIntegrationClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
FormDataIntegrationClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
FormDataIntegrationClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
-
Verwijzen naar een PDF-formulier.
- Maak een
BLOB
-object met behulp van de constructor. Met ditBLOB
-object wordt het PDF-formulier opgeslagen. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die de locatie van het PDF-formulier aangeeft en de modus waarin het bestand moet worden geopend. - 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. Geef de bytearray, de startpositie en de streamlengte door om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Verwijzen naar een XML-gegevensbron.
- Maak een
BLOB
-object met behulp van de constructor. Met ditBLOB
-object worden de gegevens opgeslagen die in het formulier worden geïmporteerd. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die de locatie aangeeft van het XML-bestand dat de te importeren gegevens bevat en de modus waarin het bestand moet worden geopend. - 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. Geef de bytearray, de startpositie en de streamlengte door om te lezen. - Vul het
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Gegevens importeren in het PDF-formulier.
Importeer gegevens in het PDF-formulier door de methode
importData
van het objectFormDataIntegrationClient
aan te roepen en de volgende waarden door te geven:- Het
BLOB
-object dat het PDF-formulier opslaat. - Het
BLOB
-object dat formuliergegevens opslaat.
De methode
importData
retourneert eenBLOB
-object dat een PDF-formulier opslaat dat de gegevens in de XML-gegevensbron bevat. - Het
-
Sla het PDF-formulier op als een PDF-bestand.
- 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-bestand vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud wordt opgeslagen van het object
BLOB
dat door de methodeimportData
is geretourneerd. Vul de bytearray met de waarde van het veldMTOM
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
Formuliergegevens exporteren exporting-form-data
U kunt formuliergegevens vanuit een interactief PDF-formulier exporteren met de service Formuliergegevensintegratie. De indeling van de geëxporteerde gegevens is afhankelijk van het formuliertype. Als het formuliertype een Acrobat-formulier is dat in Acrobat is gemaakt, zijn de geëxporteerde gegevens XFDF. Als het formuliertype een XML-formulier is dat in Designer is gemaakt, zijn de geëxporteerde gegevens XDP.
Overzicht van de stappen summary_of_steps-1
Voer de volgende stappen uit om formuliergegevens uit een PDF-formulier te exporteren:
- Projectbestanden opnemen
- Creeer een de dienstcliënt van de Integratie van Gegevens van de Vorm.
- Verwijzen naar een PDF-formulier.
- Gegevens exporteren uit het PDF-formulier.
- Sla de geëxporteerde gegevens op als een XML-bestand.
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-formdataintegration-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)
creeer een de dienstcliënt van de Integratie van Gegevens van de Vorm
Voordat u gegevens via programmacode kunt importeren in een PDF formClient-API, moet u een Data Integration-service-client maken. Wanneer u een serviceclient maakt, definieert u verbindingsinstellingen die vereist zijn om een service aan te roepen. Voor informatie, plaatsende verbindingseigenschappen.
Verwijzing a PDF vorm
Als u gegevens wilt exporteren uit een PDF-formulier, moet u verwijzen naar een PDF-formulier dat is gemaakt in Designer of Acrobat en dat formuliergegevens bevat. Als u probeert gegevens te exporteren uit een leeg PDF-formulier, krijgt u een leeg XML-schema.
de gegevens van de Uitvoer van de vorm van PDF
Nadat u naar een PDF-formulier hebt verwezen dat formuliergegevens bevat, kunt u de gegevens uit het formulier exporteren. De gegevens worden geëxporteerd in een XML-schema dat is gebaseerd op het formulier.
sparen de vormgegevens als dossier van XML
Nadat u formuliergegevens hebt geëxporteerd, kunt u de gegevens opslaan als een XML-bestand. Als het XML-bestand eenmaal is opgeslagen, kunt u het XML-bestand openen in een XML-viewer om de formuliergegevens weer te geven.
zie ook
Formuliergegevens exporteren met de Java API
Formuliergegevens exporteren met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Formuliergegevens exporteren met de Java API export-form-data-using-the-java-api
Formuliergegevens exporteren met de API voor formuliergegevensintegratie (Java):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-formdataintegration-client.jar, op in het klassenpad van uw Java-project.
-
Creeer een de dienstcliënt van de Integratie van Gegevens van de Vorm.
- Maak een
ServiceClientFactory
-object dat verbindingseigenschappen bevat. - Maak een
FormDataIntegrationClient
-object door de constructor ervan te gebruiken en hetServiceClientFactory
-object door te geven.
- Maak een
-
Verwijzen naar een PDF-formulier.
- Maak een
java.io.FileInputStream
-object met behulp van de constructor en geef een tekenreekswaarde door die de locatie aangeeft van het PDF-formulier dat de te exporteren gegevens bevat. - Maak een
com.adobe.idp.Document
-object dat het PDF-formulier opslaat met decom.adobe.idp.Document
-constructor. Geef hetjava.io.FileInputStream
-object dat het PDF-formulier bevat door aan de constructor.
- Maak een
-
Gegevens exporteren uit het PDF-formulier.
Exporteer formuliergegevens door de methode
exportData
van het objectFormDataIntegrationClient
aan te roepen en geef het objectcom.adobe.idp.Document
door waarin het PDF-formulier is opgeslagen. Deze methode retourneert eencom.adobe.idp.Document
-object dat formuliergegevens opslaat als een XML-schema. -
Sla het PDF-formulier op als een PDF-bestand.
- Maak een
java.io.File
-object en controleer of de bestandsextensie XML is. - Roep de methode
copyToFile
van het objectDocument
aan om de inhoud van het objectDocument
naar het bestand te kopiëren (gebruik het objectDocument
dat door de methodeexportData
is geretourneerd).
- Maak een
zie ook
Snel starten (SOAP modus): formuliergegevens exporteren met de Java API
Formuliergegevens exporteren met de webservice-API export-form-data-using-the-web-service-api
Formuliergegevens exporteren met de API (webservice) voor formuliergegevensintegratie:
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Gebruik de volgende WSDL-definitie:
http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.- Vervang
localhost
door het IP-adres van de server die als host fungeert voor AEM Forms.
- Vervang
-
Creeer een de dienstcliënt van de Integratie van Gegevens van de Vorm.
-
Maak een
FormDataIntegrationClient
-object met de standaardconstructor. -
Maak een
FormDataIntegrationClient.Endpoint.Address
-object met deSystem.ServiceModel.EndpointAddress
-constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/FormDataIntegration?blob=mtom
.) U hoeft het attribuutlc_version
niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef echter?blob=mtom
op om MTOM te gebruiken. -
Maak een
System.ServiceModel.BasicHttpBinding
-object door de waarde van hetFormDataIntegrationClient.Endpoint.Binding
-veld op te halen. De geretourneerde waarde wordt gecast naarBasicHttpBinding
. -
Stel het veld
MessageEncoding
van hetSystem.ServiceModel.BasicHttpBinding
-object in opWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld
FormDataIntegrationClient.ClientCredentials.UserName.UserName
toe. - Wijs de bijbehorende wachtwoordwaarde toe aan het veld
FormDataIntegrationClient.ClientCredentials.UserName.Password
. - Wijs de constante waarde
HttpClientCredentialType.Basic
toe aan het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Wijs de constante waarde
BasicHttpSecurityMode.TransportCredentialOnly
toe aan het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld
-
-
Verwijzen naar een PDF-formulier.
- Maak een
BLOB
-object met behulp van de constructor. Met ditBLOB
-object wordt het PDF-formulier opgeslagen waaruit gegevens worden geëxporteerd. - Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die de locatie van het PDF-formulier aangeeft en de modus waarin het bestand moet worden geopend. - 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
BLOB
-object door hetMTOM
-veld ervan toe te wijzen met de inhoud van de bytearray.
- Maak een
-
Gegevens exporteren uit het PDF-formulier.
Importeer gegevens in een PDF-formulier door de methode
exportData
van het objectFormDataIntegrationClient
aan te roepen en geef het objectBLOB
door dat het PDF-formulier opslaat. Deze methode retourneert eenBLOB
-object dat formuliergegevens opslaat als een XML-schema. -
Sla het PDF-formulier op als een PDF-bestand.
- Maak een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de locatie van het XML-bestand vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud wordt opgeslagen van het object
BLOB
dat door de methodeexportData
is geretourneerd. Vul de bytearray met de waarde van het veldMTOM
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 XML-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 SwaRef