Show Menu
ARGOMENTI×

Importazione ed esportazione di dati

Informazioni su 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 moduli PDF:
  • Un modulo Acrobat (creato in Acrobat) è un documento PDF che contiene campi modulo.
  • Un modulo Adobe XML (creato in Designer) è un documento PDF conforme allo standard XML Adobe XML Forms Architecture (XFA).
I dati del modulo possono essere presenti in uno dei formati seguenti, a seconda del tipo di modulo PDF:
  • Un file XFDF, che è una versione XML del formato dati del modulo Acrobat.
  • Un file XDP, che è un file XML che contiene 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 le seguenti attività utilizzando il servizio di integrazione dei dati modulo:
Per ulteriori informazioni sul servizio di integrazione dei dati del modulo, consultate Riferimento servizi per AEM Forms .

Importazione di dati modulo

È possibile importare i dati del modulo in moduli PDF 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 calcoli, convalida o script del modulo.
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 del modulo, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per importare i dati del modulo in un modulo PDF, procedere come segue:
  1. Includere i file di progetto.
  2. Creare un client del servizio di integrazione dati modulo.
  3. Fare riferimento a un modulo PDF.
  4. Fare riferimento a un'origine dati XML.
  5. Importare dati nel modulo PDF.
  6. Salvare il modulo PDF come file PDF.
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:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-formdataintegration-client.jar
  • adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss)
  • jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss)
Per informazioni sulla posizione di questi file JAR, consultate Inclusione di 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 ulteriori 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 salvarlo 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 di integrazione dei dati del modulo (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-formdataintegration-client.jar, nel percorso di classe del progetto Java.
  2. Creare un client del servizio di integrazione dati modulo.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un FormDataIntegrationClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Fare riferimento a un modulo PDF.
    • Creare un java.io.FileInputStream oggetto utilizzando il relativo costruttore. Passa un valore di stringa che specifica la posizione del modulo PDF.
    • Creare un com.adobe.idp.Document oggetto che memorizza il modulo PDF utilizzando il com.adobe.idp.Document costruttore. Trasmettere al costruttore l'oggetto java.io.FileInputStream che contiene il modulo PDF.
  4. Fare riferimento a un'origine dati XML.
    • Creare un java.io.FileInputStream oggetto utilizzando il relativo costruttore e passare un valore di stringa che specifica la posizione del file XML contenente i dati da importare nel modulo.
    • Creare un com.adobe.idp.Document oggetto che memorizza i dati del modulo utilizzando il com.adobe.idp.Document costruttore. Trasmettere l'oggetto java.io.FileInputStream che contiene i dati del modulo al costruttore.
  5. Importare dati nel modulo PDF.
    Importare dati nel modulo PDF richiamando il metodo dell' FormDataIntegrationClient oggetto importData e passando i valori seguenti:
    • L' com.adobe.idp.Document oggetto che memorizza il modulo PDF.
    • L' com.adobe.idp.Document oggetto che memorizza i dati del modulo. Il importData metodo restituisce un com.adobe.idp.Document oggetto che memorizza un modulo PDF contenente i dati contenuti nell'origine dati XML.
  6. Salvare il modulo PDF come file PDF.
    • Creare un java.io.File oggetto e assicurarsi che l'estensione del file sia ".PDF".
    • Richiamare il metodo dell' Document oggetto copyToFile per copiare il contenuto dell' Document oggetto nel file (assicurarsi di utilizzare l' Document oggetto restituito dal importData metodo).
Consulta anche

Importare i dati del modulo utilizzando l'API del servizio Web

Importare i dati del modulo utilizzando l'API di integrazione dei dati del modulo (servizio Web):
  1. 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 in cui è installato AEM Forms.
  2. Creare un client del servizio di integrazione dati modulo.
    • Creare un FormDataIntegrationClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un FormDataIntegrationClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa 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' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio. Tuttavia, specificate ?blob=mtom per utilizzare MTOM.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del FormDataIntegrationClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo FormDataIntegrationClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo FormDataIntegrationClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
      • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Fare riferimento a un modulo PDF.
    • Creare un BLOB oggetto utilizzando il relativo costruttore. Questo BLOB oggetto viene utilizzato per memorizzare il modulo PDF.
    • Creare un System.IO.FileStream oggetto richiamandone il costruttore. Passa un valore di stringa che specifica la posizione del modulo PDF e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il metodo dell' System.IO.FileStream oggetto Read . Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Fare riferimento a un'origine dati XML.
    • Creare un BLOB oggetto utilizzando il relativo costruttore. Questo BLOB oggetto viene utilizzato per memorizzare i dati importati nel modulo.
    • Creare un System.IO.FileStream oggetto 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.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il metodo dell' System.IO.FileStream oggetto Read . Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  5. Importare dati nel modulo PDF.
    Importare dati nel modulo PDF richiamando il metodo dell' FormDataIntegrationClient oggetto importData e passando i valori seguenti:
    • L' BLOB oggetto che memorizza il modulo PDF.
    • L' BLOB oggetto che memorizza i dati del modulo. Il importData metodo restituisce un BLOB oggetto che memorizza un modulo PDF contenente i dati contenuti nell'origine dati XML.
  6. Salvare il modulo PDF come file PDF.
    • Creare un System.IO.FileStream oggetto 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 dell' BLOB oggetto restituito dal importData metodo. Compilare l'array di byte ottenendo il valore del campo dell' BLOB oggetto MTOM .
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
    • Scrivere il contenuto dell'array di byte in un file PDF richiamando il metodo dell' System.IO.BinaryWriter oggetto Write e passando l'array di byte.
Consulta anche

Esportazione dei dati del modulo

È 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 del modulo, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per esportare i dati del modulo da un modulo PDF, procedere come segue:
  1. Includi file di progetto
  2. Creare un client del servizio di integrazione dati modulo.
  3. Fare riferimento a un modulo PDF.
  4. Esportare i dati dal modulo PDF.
  5. Salvare i dati esportati come file XML.
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:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-formdataintegration-client.jar
  • adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss)
  • jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss)
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, impostare le 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 in 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 di integrazione dei dati del modulo (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-formdataintegration-client.jar, nel percorso di classe del progetto Java.
  2. Creare un client del servizio di integrazione dati modulo.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un FormDataIntegrationClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Fare riferimento a un modulo PDF.
    • Creare un java.io.FileInputStream oggetto utilizzando il relativo costruttore e passare un valore di stringa che specifica la posizione del modulo PDF contenente i dati da esportare.
    • Creare un com.adobe.idp.Document oggetto che memorizza il modulo PDF utilizzando il com.adobe.idp.Document costruttore. Trasmettere al costruttore l'oggetto java.io.FileInputStream che contiene il modulo PDF.
  4. Esportare i dati dal modulo PDF.
    Esportare i dati del modulo richiamando il FormDataIntegrationClient metodo dell' exportData oggetto e passando l' com.adobe.idp.Document oggetto che memorizza il modulo PDF. Questo metodo restituisce un com.adobe.idp.Document oggetto che memorizza i dati del modulo come schema XML.
  5. Salvare il modulo PDF come file PDF.
    • Creare un java.io.File oggetto e assicurarsi che l'estensione del file sia XML.
    • Richiamare il metodo dell' Document oggetto copyToFile per copiare il contenuto dell' Document oggetto nel file (assicurarsi di utilizzare l' Document oggetto restituito dal exportData metodo).
Consulta anche

Esportare i dati del modulo utilizzando l'API del servizio Web

Esportare i dati del modulo utilizzando l'API di integrazione dei dati del modulo (servizio Web):
  1. 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 in cui è installato AEM Forms.
  2. Creare un client del servizio di integrazione dati modulo.
    • Creare un FormDataIntegrationClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un FormDataIntegrationClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa 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' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio. Tuttavia, specificate ?blob=mtom per utilizzare MTOM.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del FormDataIntegrationClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo FormDataIntegrationClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo FormDataIntegrationClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
      • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Fare riferimento a un modulo PDF.
    • Creare un BLOB oggetto utilizzando il relativo costruttore. Questo BLOB oggetto viene utilizzato per memorizzare il modulo PDF da cui vengono esportati i dati.
    • Creare un System.IO.FileStream oggetto richiamandone il costruttore. Passa un valore di stringa che specifica la posizione del modulo PDF e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream Read metodo dell'oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Esportare i dati dal modulo PDF.
    Importare i dati nel modulo PDF richiamando il FormDataIntegrationClient metodo dell' exportData oggetto e passando l' BLOB oggetto che memorizza il modulo PDF. Questo metodo restituisce un BLOB oggetto che memorizza i dati del modulo come schema XML.
  5. Salvare il modulo PDF come file PDF.
    • Creare un System.IO.FileStream oggetto 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 dell' BLOB oggetto restituito dal exportData metodo. Compilare l'array di byte ottenendo il valore del campo dell' BLOB oggetto MTOM .
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
    • Scrivere il contenuto dell'array di byte in un file XML richiamando il metodo dell' System.IO.BinaryWriter oggetto Write e passando l'array di byte.
Consulta anche