Der Forms Data Integration-Dienst kann Daten in ein PDF-Formular importieren und Daten aus einem PDF-Formular exportieren. Die Ein- und Ausfuhrvorgänge unterstützen zwei Arten von PDF forms:
Formulardaten können je nach Typ des PDF-Formulars in einem der folgenden Formate vorhanden sein:
Sie können diese Aufgaben mithilfe des Formulardatenintegrationsdiensts ausführen:
Weitere Informationen zum Formulardatenintegrationsdienst finden Sie unter Dienste-Referenz für AEM Forms.
Sie können Formulardaten mithilfe des Formulardatenintegrationsdiensts in interaktive PDF forms importieren. Ein interaktives PDF-Formular ist ein PDF-Dokument, das ein oder mehrere Felder zum Erfassen von Informationen eines Benutzers oder zum Anzeigen benutzerdefinierter Informationen enthält. Der Formulardatenintegrationsdienst unterstützt keine Formularberechnungen, Überprüfungen oder Skripten.
Um Daten in ein in Designer erstelltes Formular zu importieren, müssen Sie auf eine gültige XDP-XML-Datenquelle verweisen. Betrachten Sie das folgende Beispiel für ein Hypothekenantragsformular.
Um Datenwerte in dieses Formular zu importieren, müssen Sie über eine gültige XDP-XML-Datenquelle verfügen, die dem Formular entspricht. Sie können keine beliebige XML-Datenquelle verwenden, um Daten mit dem Formulardatenintegrationsdienst in ein Formular zu importieren. Der Unterschied zwischen einer beliebigen XML-Datenquelle und einer XDP-XML-Datenquelle besteht darin, dass eine XDP-Datenquelle der XML Forms Architecture (XFA) entspricht. Die folgende XML-Datei stellt eine XDP-XML-Datenquelle dar, die dem Musterhypothekenantragsformular entspricht.
<?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>
Weitere Informationen zum Formulardatenintegrationsdienst finden Sie unter Dienste-Referenz für AEM Forms.
So importieren Sie Formulardaten in ein PDF-Formular:
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:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.
Client des Dienstes "Formulardatenintegration"erstellen
Bevor Sie Daten programmgesteuert in eine PDF-Formular-Client-API importieren können, müssen Sie einen Data Integration-Dienstclient erstellen. Beim Erstellen eines Dienstclients definieren Sie Verbindungseinstellungen, die zum Aufrufen eines Dienstes erforderlich sind. Weitere Informationen finden Sie unter Verbindungseigenschaften festlegen.
Referenzieren eines PDF-Formulars
Um Daten in ein PDF-Formular zu importieren, müssen Sie entweder auf ein in Designer erstelltes XML-Formular oder auf ein in Acrobat erstelltes Acrobat-Formular verweisen.
Referenzieren einer XML-Datenquelle
Um Formulardaten zu importieren, müssen Sie auf eine gültige Datenquelle verweisen. Um Daten in ein XFA-XML-Formular zu importieren, das in Designer erstellt wurde, müssen Sie eine XDP-XML-Datenquelle verwenden. Wenn Sie auf ein Acrobat-Formular verweisen, müssen Sie eine XFDF-Datenquelle verwenden. Für jedes Feld, in das Sie Daten importieren möchten, muss ein Wert angegeben werden. Wenn ein Element in der XML-Datenquelle nicht mit einem Feld im Formular übereinstimmt, wird das Element ignoriert.
Daten in das PDF-Formular importieren
Nachdem Sie auf ein PDF-Formular und eine gültige XML-Datenquelle verwiesen haben, können Sie die Daten in das PDF-Formular importieren.
PDF-Formular als PDF-Datei speichern
Nachdem Sie Daten in ein Formular importiert haben, können Sie das Formular als PDF-Datei speichern. Nach dem Speichern als PDF-Datei kann ein Benutzer das Formular in Adobe Reader oder Acrobat öffnen und das Formular mit den importierten Daten anzeigen.
Siehe auch
Formulardaten mit der Java-API importieren
Formulardaten mit der Webdienst-API importieren
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Forms Data Integration Service API
Importieren Sie Formulardaten mit der Formular-Datenintegration-API (Java):
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-formdataintegration-client.jar"in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie einen Client des Service für die Formulardatenintegration.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.FormDataIntegrationClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Verweisen Sie auf ein PDF-Formular.
java.io.FileInputStream
, indem Sie den Konstruktor verwenden. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Formulars angibt.com.adobe.idp.Document
-Objekt, das das PDF-Formular mit dem Konstruktor com.adobe.idp.Document
speichert. Übergeben Sie das java.io.FileInputStream
-Objekt, das das PDF-Formular enthält, an den Konstruktor.Verweisen Sie auf eine XML-Datenquelle.
java.io.FileInputStream
-Objekt mit dem Konstruktor und übergeben Sie einen Zeichenfolgenwert, der den Speicherort der XML-Datei angibt, die Daten enthält, die in das Formular importiert werden sollen.com.adobe.idp.Document
-Objekt, das mithilfe des Konstruktors com.adobe.idp.Document
Formulardaten speichert. Übergeben Sie das java.io.FileInputStream
-Objekt, das Formulardaten enthält, an den Konstruktor.Daten in das PDF-Formular importieren.
Importieren Sie Daten in das PDF-Formular, indem Sie die importData
-Methode des Objekts aufrufen und die folgenden Werte übergeben:FormDataIntegrationClient
com.adobe.idp.Document
-Objekt, in dem das PDF-Formular gespeichert wird.com.adobe.idp.Document
-Objekt, das Formulardaten speichert.Die importData
-Methode gibt ein com.adobe.idp.Document
-Objekt zurück, das ein PDF-Formular speichert, das die Daten in der XML-Datenquelle enthält.
Speichern Sie das PDF-Formular als PDF-Datei.
java.io.File
-Objekt und stellen Sie sicher, dass die Dateierweiterung ".PDF"ist.copyToFile
-Methode des Objekts auf, um den Inhalt des Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das Document
-Objekt verwenden, das von der importData
-Methode zurückgegeben wurde).Document
Siehe auch
Quick Beginn (SOAP-Modus): Formulardaten mit der Java-API importieren
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Importieren Sie Formulardaten mit der Formulardatenintegration-API (Webdienst):
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.
Ersetzen Sie localhost
durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie einen Client des Service für die Formulardatenintegration.
Erstellen Sie ein FormDataIntegrationClient
-Objekt mit dem Standardkonstruktor.
Erstellen Sie ein FormDataIntegrationClient.Endpoint.Address
-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress
. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
). Sie müssen das Attribut lc_version
nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen. Geben Sie ?blob=mtom
an, um MTOM zu verwenden.
Erstellen Sie ein System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert des Felds FormDataIntegrationClient.Endpoint.Binding
abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding
um.
Setzen Sie das Feld System.ServiceModel.BasicHttpBinding
des Objekts auf MessageEncoding
. WSMessageEncoding.Mtom
Dieser Wert stellt sicher, dass MTOM verwendet wird.
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
FormDataIntegrationClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu.FormDataIntegrationClient.ClientCredentials.UserName.Password
den entsprechenden Kennwortwert zu.BasicHttpBindingSecurity.Transport.ClientCredentialType
den Konstantenwert HttpClientCredentialType.Basic
zu.BasicHttpBindingSecurity.Security.Mode
den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly
zu.Verweisen Sie auf ein PDF-Formular.
BLOB
, indem Sie den Konstruktor verwenden. Dieses BLOB
-Objekt wird zum Speichern des PDF-Formulars verwendet.System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Formulars und den Modus, in dem die Datei geöffnet werden soll, angibt.System.IO.FileStream
speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Eigenschaft des Objekts Length
abrufen.System.IO.FileStream
-Methode des Objekts Read
aufrufen. Übergeben Sie das Bytearray, die Startposition und die zu lesende Stream-Länge.BLOB
-Objekt, indem Sie dessen MTOM
-Feld mit dem Inhalt des Byte-Arrays zuweisen.Verweisen Sie auf eine XML-Datenquelle.
BLOB
, indem Sie den Konstruktor verwenden. Mit diesem BLOB
-Objekt werden die in das Formular importierten Daten gespeichert.System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort der XML-Datei angibt, die zu importierende Daten enthält, und den Modus, in dem die Datei geöffnet werden soll.System.IO.FileStream
speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Eigenschaft des Objekts Length
abrufen.System.IO.FileStream
-Methode des Objekts Read
aufrufen. Übergeben Sie das Bytearray, die Startposition und die zu lesende Stream-Länge.BLOB
-Objekt, indem Sie dessen MTOM
-Feld mit dem Inhalt des Byte-Arrays zuweisen.Daten in das PDF-Formular importieren.
Importieren Sie Daten in das PDF-Formular, indem Sie die FormDataIntegrationClient
-Objektmethode importData
aufrufen und die folgenden Werte übergeben:
BLOB
-Objekt, in dem das PDF-Formular gespeichert wird.BLOB
-Objekt, das Formulardaten speichert.Die importData
-Methode gibt ein BLOB
-Objekt zurück, das ein PDF-Formular speichert, das die Daten in der XML-Datenquelle enthält.
Speichern Sie das PDF-Formular als PDF-Datei.
System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort der PDF-Datei darstellt.BLOB
-Objekts speichert, das von der importData
-Methode zurückgegeben wurde. Füllen Sie das Bytearray, indem Sie den Wert des Felds BLOB
des Objekts MTOM
abrufen.System.IO.BinaryWriter
-Objekt, indem Sie den Konstruktor aufrufen und das System.IO.FileStream
-Objekt übergeben.Write
-Methode des Objekts aufrufen und das Bytearray übergeben.System.IO.BinaryWriter
Siehe auch
Aufrufen von AEM Forms mit MTOM
Sie können Formulardaten aus einem interaktiven PDF-Formular mithilfe des Formulardatenintegrationsdiensts exportieren. Das Format der exportierten Daten hängt vom Formulartypen ab. Wenn der Formulartyp ein in Acrobat erstelltes Acrobat-Formular ist, dann sind die exportierten Daten XFDF. Wenn der Formulartyp ein XML-Formular ist, das in Designer erstellt wurde, sind die exportierten Daten XDP.
Weitere Informationen zum Formulardatenintegrationsdienst finden Sie unter Dienste-Referenz für AEM Forms.
So exportieren Sie Formulardaten aus einem PDF-Formular:
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:
Client des Dienstes "Formulardatenintegration"erstellen
Bevor Sie Daten programmgesteuert in eine PDF formClient-API importieren können, müssen Sie einen Data Integration-Dienstclient erstellen. Beim Erstellen eines Dienstclients definieren Sie Verbindungseinstellungen, die zum Aufrufen eines Dienstes erforderlich sind. Weitere Informationen finden Sie unter Verbindungseigenschaften festlegen.
Referenzieren eines PDF-Formulars
Um Daten aus einem PDF-Formular zu exportieren, müssen Sie auf ein PDF-Formular verweisen, das in Designer oder Acrobat erstellt wurde und Formulardaten enthält. Wenn Sie versuchen, Daten aus einem leeren PDF-Formular zu exportieren, erhalten Sie ein leeres XML-Schema.
Daten aus dem PDF-Formular exportieren
Nachdem Sie auf ein PDF-Formular mit Formulardaten verwiesen haben, können Sie die Daten aus dem Formular exportieren. Die Daten werden in ein XML-Schema exportiert, das auf dem Formular basiert.
Formulardaten als XML-Datei speichern
Nach dem Exportieren der Formulardaten können Sie die Daten als XML-Datei speichern. Nach dem Speichern als XML-Datei können Sie die XML-Datei in einem XML-Viewer öffnen, um die Formulardaten Ansicht.
Siehe auch
Formulardaten mit der Java-API exportieren
Exportieren von Formulardaten mit der Webdienst-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Beginn zur Forms Data Integration Service API
Exportieren Sie Formulardaten mithilfe der Formular-Datenintegration-API (Java):
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-formdataintegration-client.jar"in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie einen Client des Service für die Formulardatenintegration.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.FormDataIntegrationClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Verweisen Sie auf ein PDF-Formular.
java.io.FileInputStream
-Objekt mit dem Konstruktor und übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Formulars angibt, das zu exportierende Daten enthält.com.adobe.idp.Document
-Objekt, das das PDF-Formular mit dem Konstruktor com.adobe.idp.Document
speichert. Übergeben Sie das java.io.FileInputStream
-Objekt, das das PDF-Formular enthält, an den Konstruktor.Exportieren Sie Daten aus dem PDF-Formular.
Exportieren Sie Formulardaten, indem Sie die exportData
-Methode des Objekts aufrufen und das com.adobe.idp.Document
-Objekt übergeben, in dem das PDF-Formular gespeichert wird. FormDataIntegrationClient
Diese Methode gibt ein com.adobe.idp.Document
-Objekt zurück, das Formulardaten als XML-Schema speichert.
Speichern Sie das PDF-Formular als PDF-Datei.
java.io.File
-Objekt und stellen Sie sicher, dass die Dateierweiterung XML ist.copyToFile
-Methode des Objekts auf, um den Inhalt des Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie das Document
-Objekt verwenden, das von der exportData
-Methode zurückgegeben wurde).Document
Siehe auch
Quick Beginn (SOAP-Modus): Exportieren von Formulardaten mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Exportieren Sie Formulardaten mithilfe der Formulardatenintegration-API (Webdienst):
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.
localhost
durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird.Erstellen Sie einen Client des Service für die Formulardatenintegration.
Erstellen Sie ein FormDataIntegrationClient
-Objekt mit dem Standardkonstruktor.
Erstellen Sie ein FormDataIntegrationClient.Endpoint.Address
-Objekt mit dem Konstruktor System.ServiceModel.EndpointAddress
. Übergeben Sie einen Zeichenfolgenwert, der die WSDL an den AEM Forms-Dienst angibt (z. B. http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
). Sie müssen das Attribut lc_version
nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Dienstreferenz erstellen. Geben Sie ?blob=mtom
an, um MTOM zu verwenden.
Erstellen Sie ein System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert des Felds FormDataIntegrationClient.Endpoint.Binding
abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding
um.
Setzen Sie das Feld System.ServiceModel.BasicHttpBinding
des Objekts auf MessageEncoding
. WSMessageEncoding.Mtom
Dieser Wert stellt sicher, dass MTOM verwendet wird.
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Aufgaben ausführen:
FormDataIntegrationClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu.FormDataIntegrationClient.ClientCredentials.UserName.Password
den entsprechenden Kennwortwert zu.BasicHttpBindingSecurity.Transport.ClientCredentialType
den Konstantenwert HttpClientCredentialType.Basic
zu.BasicHttpBindingSecurity.Security.Mode
den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly
zu.Verweisen Sie auf ein PDF-Formular.
BLOB
, indem Sie den Konstruktor verwenden. Dieses BLOB
-Objekt wird zum Speichern des PDF-Formulars verwendet, aus dem Daten exportiert werden.System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Formulars und den Modus, in dem die Datei geöffnet werden soll, angibt.System.IO.FileStream
speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Eigenschaft des Objekts Length
abrufen.Read
-Methode des Objekts aufrufen und das Bytearray, die Startposition und die zu lesende Stream-Länge übergeben.System.IO.FileStream
BLOB
-Objekt, indem Sie dessen MTOM
-Feld mit dem Inhalt des Byte-Arrays zuweisen.Exportieren Sie Daten aus dem PDF-Formular.
Importieren Sie Daten in das PDF-Formular, indem Sie die FormDataIntegrationClient
-Methode des Objekts exportData
aufrufen und das BLOB
-Objekt übergeben, in dem das PDF-Formular gespeichert wird. Diese Methode gibt ein BLOB
-Objekt zurück, das Formulardaten als XML-Schema speichert.
Speichern Sie das PDF-Formular als PDF-Datei.
System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Speicherort der XML-Datei darstellt.BLOB
-Objekts speichert, das von der exportData
-Methode zurückgegeben wurde. Füllen Sie das Bytearray, indem Sie den Wert des Felds BLOB
des Objekts MTOM
abrufen.System.IO.BinaryWriter
-Objekt, indem Sie den Konstruktor aufrufen und das System.IO.FileStream
-Objekt übergeben.Write
-Methode des Objekts aufrufen und das Bytearray übergeben.System.IO.BinaryWriter
Siehe auch
Aufrufen von AEM Forms mit MTOM
Aufrufen von AEM Forms mit SwaRef