Esempi ed esempi in questo documento sono disponibili solo per AEM Forms nell'ambiente JEE.
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:
I dati del modulo possono essere presenti in uno dei formati seguenti, a seconda del tipo di modulo PDF:
È possibile eseguire le seguenti attività utilizzando il servizio di integrazione dei dati modulo:
Per ulteriori informazioni sul servizio di integrazione dei dati modulo, vedere Guida di riferimento dei servizi per AEM Forms.
È 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 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 del modulo, la convalida o gli script.
Per importare dati in un modulo creato in Designer, è necessario fare riferimento a un'origine dati XML XDP valida. Esaminare il seguente modulo di richiesta di ipoteca.
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 dati modulo. La differenza tra un'origine dati XML arbitraria e un'origine dati XML XDP sta nel fatto che un'origine dati XDP è conforme a XML Forms Architecture (XFA). Il codice XML seguente rappresenta un'origine dati XML XDP che corrisponde al modulo di esempio per l'applicazione ipoteca.
<?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>
Per ulteriori informazioni sul servizio di integrazione dei dati modulo, vedere Guida di riferimento dei servizi per AEM Forms.
Per importare i dati del modulo in un modulo PDF, procedere come segue:
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un client del servizio di integrazione dei dati modulo
Prima di poter importare i dati in un modulo PDF API client a livello di programmazione, è necessario creare un client di servizi di integrazione dati. Quando create un client di servizi, definite le impostazioni di connessione necessarie per richiamare un servizio. Per informazioni, vedere Impostazione delle proprietà di connessione.
Riferimento a un modulo PDF
Per importare 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 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 posizionato nell'origine dati XML non corrisponde a un campo del modulo, l'elemento viene ignorato.
Importazione di 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 salvare il modulo come file PDF. Una volta salvato il file come PDF, l'utente può aprire il modulo in Adobe Reader o Acrobat e visualizzarlo insieme ai dati importati.
Consulta anche
Importare i dati del modulo utilizzando l'API Java
Importare i dati del modulo utilizzando l'API del servizio Web
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido dell'API di Form Data Integration Service
Esportazione dei dati del modulo
Importare i dati del modulo utilizzando l'API di integrazione dei dati del modulo (Java):
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-formdataintegration-client.jar, nel percorso di classe del progetto Java.
Creare un client del servizio di integrazione dati modulo.
ServiceClientFactory
che contiene le proprietà di connessione.FormDataIntegrationClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Fare riferimento a un modulo PDF.
java.io.FileInputStream
utilizzando il relativo costruttore. Passa un valore di stringa che specifica la posizione del modulo PDF.com.adobe.idp.Document
che memorizza il modulo PDF utilizzando il costruttore com.adobe.idp.Document
. Trasmettere l'oggetto java.io.FileInputStream
che contiene il modulo PDF al costruttore.Fare riferimento a un'origine dati XML.
java.io.FileInputStream
utilizzando il relativo costruttore e passare un valore di stringa che specifica la posizione del file XML che contiene i dati da importare nel modulo.com.adobe.idp.Document
che memorizza i dati del modulo utilizzando il costruttore com.adobe.idp.Document
. Trasmettere l'oggetto java.io.FileInputStream
che contiene i dati del modulo al costruttore.Importare i dati nel modulo PDF.
Importare dati nel modulo PDF richiamando il metodo importData
dell'oggetto FormDataIntegrationClient
e passando i valori seguenti:
com.adobe.idp.Document
che memorizza il modulo PDF.com.adobe.idp.Document
che memorizza i dati del modulo.Il metodo importData
restituisce un oggetto com.adobe.idp.Document
che memorizza un modulo PDF contenente i dati contenuti nell'origine dati XML.
Salvare il modulo PDF come file PDF.
java.io.File
e assicurarsi che l'estensione del file sia ".PDF".Document
dell'oggetto copyToFile
per copiare nel file il contenuto dell'oggetto Document
(assicurarsi di utilizzare l'oggetto Document
restituito dal metodo importData
).Consulta anche
Avvio rapido (modalità SOAP): Importazione di dati del modulo tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Importare i dati del modulo utilizzando l'API di integrazione dei dati del modulo (servizio Web):
Includere i file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.
Sostituire localhost
con l'indirizzo IP del server che ospita AEM Forms.
Creare un client del servizio di integrazione dati modulo.
Creare un oggetto FormDataIntegrationClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto FormDataIntegrationClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passate un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando create un riferimento a un servizio. Tuttavia, specificate ?blob=mtom
per utilizzare MTOM.
Creare un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo FormDataIntegrationClient.Endpoint.Binding
. Inserite il valore restituito in BasicHttpBinding
.
Impostare il campo System.ServiceModel.BasicHttpBinding
dell'oggetto MessageEncoding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
FormDataIntegrationClient.ClientCredentials.UserName.UserName
.FormDataIntegrationClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Fare riferimento a un modulo PDF.
BLOB
utilizzando il relativo costruttore. Questo oggetto BLOB
viene utilizzato per memorizzare il modulo PDF.System.IO.FileStream
richiamandone il costruttore. Passa un valore di stringa che specifica la posizione del modulo PDF e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream
dell'oggetto Length
.System.IO.FileStream
dell'oggetto Read
. Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il relativo campo MTOM
con il contenuto dell'array di byte.Fare riferimento a un'origine dati XML.
BLOB
utilizzando il relativo costruttore. Questo oggetto BLOB
viene utilizzato per memorizzare i dati importati nel modulo.System.IO.FileStream
richiamandone il costruttore. Passa un valore di stringa che specifica la posizione del file XML contenente i dati da importare e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream
dell'oggetto Length
.System.IO.FileStream
dell'oggetto Read
. Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il relativo campo MTOM
con il contenuto dell'array di byte.Importare i dati nel modulo PDF.
Importare i dati nel modulo PDF richiamando il metodo importData
dell'oggetto FormDataIntegrationClient
e passando i valori seguenti:
BLOB
che memorizza il modulo PDF.BLOB
che memorizza i dati del modulo.Il metodo importData
restituisce un oggetto BLOB
che memorizza un modulo PDF contenente i dati contenuti nell'origine dati XML.
Salvare il modulo PDF come file PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file PDF.BLOB
restituito dal metodo importData
. Compilare l'array di byte ottenendo il valore del campo BLOB
dell'oggetto MTOM
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.System.IO.BinaryWriter
dell'oggetto Write
e passando l'array di byte.Consulta anche
Chiamata AEM Forms tramite MTOM
È possibile esportare i dati del modulo 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.
Per ulteriori informazioni sul servizio di integrazione dei dati modulo, vedere Guida di riferimento dei servizi per AEM Forms.
Per esportare i dati del modulo da un modulo PDF, procedere come segue:
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Creare un client del servizio di integrazione dei dati modulo
Prima di poter importare i dati in un'API formClient PDF a livello di programmazione, è necessario creare un client del servizio di integrazione dati. Quando create un client di servizi, definite 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 i dati da un modulo PDF vuoto, verrà visualizzato uno schema XML vuoto.
Esportazione di 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 il file 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 del modulo utilizzando l'API del servizio Web
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido dell'API di Form Data Integration Service
Esportare i dati del modulo utilizzando l'API di integrazione dei dati del modulo (Java):
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-formdataintegration-client.jar, nel percorso di classe del progetto Java.
Creare un client del servizio di integrazione dati modulo.
ServiceClientFactory
che contiene le proprietà di connessione.FormDataIntegrationClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Fare riferimento a un modulo PDF.
java.io.FileInputStream
utilizzando il relativo costruttore e passare un valore di stringa che specifica la posizione del modulo PDF contenente i dati da esportare.com.adobe.idp.Document
che memorizza il modulo PDF utilizzando il costruttore com.adobe.idp.Document
. Trasmettere l'oggetto java.io.FileInputStream
che contiene il modulo PDF al costruttore.Esportare i dati dal modulo PDF.
Esportare i dati del modulo richiamando il metodo exportData
dell'oggetto com.adobe.idp.Document
e passando l'oggetto FormDataIntegrationClient
che memorizza il modulo PDF. Questo metodo restituisce un oggetto com.adobe.idp.Document
che memorizza i dati del modulo come schema XML.
Salvare il modulo PDF come file PDF.
java.io.File
e assicurarsi che l'estensione del file sia XML.Document
dell'oggetto copyToFile
per copiare nel file il contenuto dell'oggetto Document
(assicurarsi di utilizzare l'oggetto Document
restituito dal metodo exportData
).Consulta anche
Avvio rapido (modalità SOAP): Esportazione dei dati del modulo tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Esportare i dati del modulo utilizzando l'API di integrazione dei dati del modulo (servizio Web):
Includere i file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.
localhost
con l'indirizzo IP del server che ospita AEM Forms.Creare un client del servizio di integrazione dati modulo.
Creare un oggetto FormDataIntegrationClient
utilizzando il relativo costruttore predefinito.
Creare un oggetto FormDataIntegrationClient.Endpoint.Address
utilizzando il costruttore System.ServiceModel.EndpointAddress
. Passate un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
). Non è necessario utilizzare l'attributo lc_version
. Questo attributo viene utilizzato quando create un riferimento a un servizio. Tuttavia, specificate ?blob=mtom
per utilizzare MTOM.
Creare un oggetto System.ServiceModel.BasicHttpBinding
ottenendo il valore del campo FormDataIntegrationClient.Endpoint.Binding
. Inserite il valore restituito in BasicHttpBinding
.
Impostare il campo System.ServiceModel.BasicHttpBinding
dell'oggetto MessageEncoding
su WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
FormDataIntegrationClient.ClientCredentials.UserName.UserName
.FormDataIntegrationClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Fare riferimento a un modulo PDF.
BLOB
utilizzando il relativo costruttore. Questo oggetto BLOB
viene utilizzato per memorizzare il modulo PDF da cui vengono esportati i dati.System.IO.FileStream
richiamandone il costruttore. Passa un valore di stringa che specifica la posizione del modulo PDF e la modalità di apertura del file.System.IO.FileStream
. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream
dell'oggetto Length
.Read
dell'oggetto System.IO.FileStream
e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.BLOB
assegnando il relativo campo MTOM
con il contenuto dell'array di byte.Esportare i dati dal modulo PDF.
Importare dati nel modulo PDF richiamando il metodo exportData
dell'oggetto BLOB
e passando l'oggetto FormDataIntegrationClient
che memorizza il modulo PDF. Questo metodo restituisce un oggetto BLOB
che memorizza i dati del modulo come schema XML.
Salvare il modulo PDF come file PDF.
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file XML.BLOB
restituito dal metodo exportData
. Compilare l'array di byte ottenendo il valore del campo BLOB
dell'oggetto MTOM
.System.IO.BinaryWriter
richiamandone il costruttore e passando l'oggetto System.IO.FileStream
.System.IO.BinaryWriter
dell'oggetto Write
e passando l'array di byte.Consulta anche