Importazione ed esportazione di dati importing-and-exporting-data
Informazioni sul servizio di integrazione dei dati dei moduli about-the-form-data-integration-service
Il servizio di integrazione dei dati modulo può importare dati in un modulo PDF ed esportare dati da un modulo PDF. Le operazioni di importazione ed esportazione supportano due tipi di PDF forms:
- Un modulo Acrobat (creato in Acrobat) è un documento PDF contenente campi modulo.
- Un modulo XML di Adobe (creato in Designer) è un documento di PDF conforme a XML Adobe XML Forms Architecture (XFA).
I dati modulo possono essere presenti in uno dei seguenti formati a seconda del tipo di modulo PDF:
- Un file XFDF, che è una versione XML del formato dati del modulo Acrobat.
- Un file XDP, file XML contenente le definizioni dei campi del modulo. Può anche contenere dati del campo modulo e un file PDF incorporato. È possibile utilizzare un file XDP generato da Designer solo se contiene un documento PDF incorporato con codifica base 64.
È possibile eseguire queste attività utilizzando il servizio di integrazione dei dati del modulo:
- Importa dati in PDF forms. Per informazioni, consulta Importazione di dati modulo.
- Esporta dati dai PDF forms. Per informazioni, consulta Esportazione dei dati del modulo.
Importazione di dati modulo importing-form-data
È possibile importare i dati del modulo in PDF forms interattivi utilizzando il servizio di integrazione dei dati del modulo. Un modulo PDF interattivo è un documento di PDF contenente uno o più campi per la raccolta di informazioni da parte di un utente o per la visualizzazione di informazioni personalizzate. Il servizio di integrazione dei dati del modulo non supporta i calcoli dei moduli, la convalida o gli script.
Per importare i dati in un modulo creato in Designer, è necessario fare riferimento a un’origine dati XML XDP valida. Considerare l'esempio seguente del modulo di richiesta di mutuo.
Per importare i valori dei dati in questo modulo, è necessario disporre di un’origine dati XML XDP valida che corrisponda al modulo. Non è possibile utilizzare un’origine dati XML arbitraria per importare dati in un modulo utilizzando il servizio di integrazione dei dati del modulo. La differenza tra un'origine dati XML arbitraria e un'origine dati XML XDP è che un'origine dati XDP è conforme a XML Forms Architecture (XFA). Il seguente XML rappresenta un'origine dati XML XDP che corrisponde al modulo di applicazione per ipoteca di esempio.
<?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>
Riepilogo dei passaggi summary-of-steps
Per importare i dati del modulo in un modulo PDF, procedere come segue:
- Includi file di progetto.
- Creare un client del servizio di integrazione dei dati dei moduli.
- Fare riferimento a un modulo PDF.
- Fare riferimento a un'origine dati XML.
- Importare dati nel modulo PDF.
- Salvare il modulo PDF come file PDF.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-formdataintegration-client.jar
- adobe-utilities.jar (obbligatorio se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)
Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.
Creare un client del servizio di integrazione dei dati di un modulo
Prima di poter importare i dati in modo programmatico in un’API client di PDF, è necessario creare un client del servizio di integrazione dei dati. Quando crei un client di servizio, definisci le impostazioni di connessione necessarie per richiamare un servizio. Per informazioni, consulta Impostazione delle proprietà di connessione.
Riferimento a un modulo PDF
Per importare i dati in un modulo PDF, è necessario fare riferimento a un modulo XML creato in Designer o a un modulo Acrobat creato in Acrobat.
Riferimento a un’origine dati XML
Per importare i dati del modulo, è necessario fare riferimento a un’origine dati valida. Per importare i dati in un modulo XML XFA creato in Designer, è necessario utilizzare un’origine dati XML XDP. Se si fa riferimento a un modulo Acrobat, è necessario utilizzare un’origine dati XFDF. Per ogni campo in cui si desidera importare i dati, è necessario specificare un valore. Se un elemento situato nell’origine dati XML non corrisponde a un campo del modulo, l’elemento viene ignorato.
Importare dati nel modulo PDF
Dopo aver fatto riferimento a un modulo PDF e a un’origine dati XML valida, è possibile importare i dati nel modulo PDF.
Salvare il modulo PDF come file PDF
Dopo aver importato i dati in un modulo, è possibile salvarli come file PDF. Una volta salvato come file PDF, l’utente può aprire il modulo in Adobe Reader o Acrobat e visualizzarlo con i dati importati.
Consulta anche
Importare dati modulo utilizzando l’API Java
Importare dati modulo tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido dell'API del servizio di integrazione dei dati per modulo
Esportazione dei dati del modulo
Importare dati modulo utilizzando l’API Java import-form-data-using-the-java-api
Importare i dati del modulo utilizzando l’API di integrazione dei dati del modulo (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-formdataintegration-client.jar, nel percorso classe del progetto Java.
-
Creare un client del servizio di integrazione dei dati dei moduli.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
FormDataIntegrationClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Fare riferimento a un modulo PDF.
- Crea un
java.io.FileInputStream
utilizzando il relativo costruttore. Passa un valore stringa che specifica la posizione del modulo PDF. - Crea un
com.adobe.idp.Document
oggetto che memorizza il modulo PDF utilizzandocom.adobe.idp.Document
costruttore. Passa lajava.io.FileInputStream
oggetto contenente il modulo PDF al costruttore.
- Crea un
-
Fare riferimento a un'origine dati XML.
- Crea un
java.io.FileInputStream
utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file XML contenente i dati da importare nel modulo. - Crea un
com.adobe.idp.Document
oggetto che memorizza i dati del modulo utilizzandocom.adobe.idp.Document
costruttore. Passa lajava.io.FileInputStream
oggetto contenente i dati del modulo al costruttore.
- Crea un
-
Importare dati nel modulo PDF.
Importa dati nel modulo PDF richiamando il
FormDataIntegrationClient
dell’oggettoimportData
e passando i seguenti valori:- La
com.adobe.idp.Document
oggetto che memorizza il modulo PDF. - La
com.adobe.idp.Document
oggetto che memorizza i dati del modulo.
La
importData
restituisce uncom.adobe.idp.Document
oggetto che memorizza un modulo PDF contenente i dati presenti nell'origine dati XML. - La
-
Salvare il modulo PDF come file PDF.
- Crea un
java.io.File
e assicurati che l'estensione del file sia ".PDF". - Richiama il
Document
dell’oggettocopyToFile
per copiare il contenuto delDocument
al file (assicurati di utilizzareDocument
oggetto restituito daimportData
metodo).
- Crea un
Consulta anche
Avvio rapido (modalità SOAP): Importazione di dati del modulo tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Importare dati modulo tramite l’API del servizio Web import-form-data-using-the-web-service-api
Importare i dati del modulo utilizzando l’API di integrazione dei dati del modulo (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Creare un client del servizio di integrazione dei dati dei moduli.
-
Crea un
FormDataIntegrationClient
utilizzando il relativo costruttore predefinito. -
Crea un
FormDataIntegrationClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delFormDataIntegrationClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
FormDataIntegrationClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
FormDataIntegrationClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento a un modulo PDF.
- Crea un
BLOB
utilizzando il relativo costruttore. QuestoBLOB
viene utilizzato per memorizzare il modulo PDF. - Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che specifica la posizione del modulo PDF e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
metodo . Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Fare riferimento a un'origine dati XML.
- Crea un
BLOB
utilizzando il relativo costruttore. QuestoBLOB
viene utilizzato per memorizzare i dati importati nel modulo. - Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che specifica la posizione del file XML contenente i dati da importare e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
metodo . Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Importare dati nel modulo PDF.
Importa i dati nel modulo PDF richiamando il
FormDataIntegrationClient
dell’oggettoimportData
e passando i seguenti valori:- La
BLOB
oggetto che memorizza il modulo PDF. - La
BLOB
oggetto che memorizza i dati del modulo.
La
importData
restituisce unBLOB
oggetto che memorizza un modulo PDF contenente i dati presenti nell'origine dati XML. - La
-
Salvare il modulo PDF come file PDF.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file PDF. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto restituito daimportData
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
campo . - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Esportazione dei dati del modulo exporting-form-data
È possibile esportare i dati dei moduli da un modulo PDF interattivo utilizzando il servizio di integrazione dei dati del modulo. Il formato dei dati esportati dipende dal tipo di modulo. Se il tipo di modulo è un modulo Acrobat creato in Acrobat, i dati esportati sono XFDF. Se il tipo di modulo è un modulo XML creato in Designer, i dati esportati sono XDP.
Riepilogo dei passaggi summary_of_steps-1
Per esportare i dati del modulo da un modulo PDF, eseguire le operazioni seguenti:
- Includi file di progetto
- Creare un client del servizio di integrazione dei dati dei moduli.
- Fare riferimento a un modulo PDF.
- Esporta dati dal modulo PDF.
- Salvare i dati esportati come file XML.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-formdataintegration-client.jar
- adobe-utilities.jar (obbligatorio se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)
Creare un client del servizio di integrazione dei dati di un modulo
Prima di poter importare i dati in modo programmatico in un’API PDF formClient, è necessario creare un client del servizio di integrazione dei dati. Quando crei un client di servizio, definisci le impostazioni di connessione necessarie per richiamare un servizio. Per informazioni, Impostazione delle proprietà di connessione.
Riferimento a un modulo PDF
Per esportare dati da un modulo PDF, è necessario fare riferimento a un modulo PDF creato in Designer o Acrobat e contenente i dati del modulo. Se si tenta di esportare dati da un modulo PDF vuoto, verrà visualizzato uno schema XML vuoto.
Esportare dati dal modulo PDF
Dopo aver fatto riferimento a un modulo PDF contenente dati del modulo, è possibile esportare i dati dal modulo. I dati vengono esportati all’interno di uno schema XML basato sul modulo.
Salvare i dati del modulo come file XML
Dopo aver esportato i dati del modulo, è possibile salvarli come file XML. Una volta salvato come file XML, è possibile aprire il file XML all’interno di un visualizzatore XML per visualizzare i dati del modulo.
Consulta anche
Esportare i dati del modulo utilizzando l’API Java
Esportare i dati dei moduli utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido dell'API del servizio di integrazione dei dati per modulo
Esportare i dati del modulo utilizzando l’API Java export-form-data-using-the-java-api
Esportare i dati dei moduli utilizzando l’API di integrazione dei dati dei moduli (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-formdataintegration-client.jar, nel percorso classe del progetto Java.
-
Creare un client del servizio di integrazione dei dati dei moduli.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
FormDataIntegrationClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Fare riferimento a un modulo PDF.
- Crea un
java.io.FileInputStream
utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del modulo PDF contenente i dati da esportare. - Crea un
com.adobe.idp.Document
oggetto che memorizza il modulo PDF utilizzandocom.adobe.idp.Document
costruttore. Passa lajava.io.FileInputStream
oggetto contenente il modulo PDF al costruttore.
- Crea un
-
Esporta dati dal modulo PDF.
Esporta dati modulo richiamando il
FormDataIntegrationClient
dell’oggettoexportData
e passare ilcom.adobe.idp.Document
oggetto che memorizza il modulo PDF. Questo metodo restituisce uncom.adobe.idp.Document
oggetto che memorizza i dati del modulo come schema XML. -
Salvare il modulo PDF come file PDF.
- Crea un
java.io.File
e assicurati che l'estensione del file sia XML. - Richiama il
Document
dell’oggettocopyToFile
per copiare il contenuto delDocument
al file (assicurati di utilizzareDocument
oggetto restituito daexportData
metodo).
- Crea un
Consulta anche
Avvio rapido (modalità SOAP): Esportazione dei dati modulo tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Esportare i dati dei moduli utilizzando l’API del servizio Web export-form-data-using-the-web-service-api
Esportare i dati del modulo utilizzando l’API di integrazione dei dati del modulo (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.- Sostituisci
localhost
con l’indirizzo IP del server che ospita AEM Forms.
- Sostituisci
-
Creare un client del servizio di integrazione dei dati dei moduli.
-
Crea un
FormDataIntegrationClient
utilizzando il relativo costruttore predefinito. -
Crea un
FormDataIntegrationClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delFormDataIntegrationClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
FormDataIntegrationClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
FormDataIntegrationClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento a un modulo PDF.
- Crea un
BLOB
utilizzando il relativo costruttore. QuestoBLOB
viene utilizzato per memorizzare il modulo PDF da cui vengono esportati i dati. - Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che specifica la posizione del modulo PDF e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Esporta dati dal modulo PDF.
Importa dati nel modulo PDF richiamando il
FormDataIntegrationClient
dell’oggettoexportData
e passare ilBLOB
oggetto che memorizza il modulo PDF. Questo metodo restituisce unBLOB
oggetto che memorizza i dati del modulo come schema XML. -
Salvare il modulo PDF come file PDF.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file XML. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto restituito daexportData
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
campo . - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivere il contenuto dell'array di byte in un file XML richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef