Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.
Il servizio AEM Forms esegue il rendering dei PDF forms interattivi sui dispositivi client, in genere i browser web, per raccogliere informazioni dagli utenti. Un modulo PDF interattivo si basa su una struttura di modulo che in genere viene salvata come file XDP e creata in Designer. A partire da AEM Forms, puoi trasmettere un com.adobe.idp.Document
oggetto che contiene la struttura del modulo per il servizio Forms. Il servizio Forms esegue quindi il rendering della struttura del modulo che si trova in com.adobe.idp.Document
oggetto.
Il vantaggio di superare un com.adobe.idp.Document
al servizio Forms è che altre operazioni del servizio restituiscono un com.adobe.idp.Document
dell'istanza. In altre parole, puoi ottenere un com.adobe.idp.Document
da un'altra operazione di servizio ed eseguirne il rendering. Ad esempio, si supponga che un file XDP sia memorizzato in un nodo Content Services (obsoleto) denominato /Company Home/Form Designs
, come illustrato nella figura seguente.
Puoi recuperare in modo programmatico Loan.xdp da Content Services (obsoleto) (obsoleto) e passare il file XDP al servizio Forms all’interno di un com.adobe.idp.Document
oggetto.
Per ulteriori informazioni sul servizio Forms, consulta Guida di riferimento dei servizi per AEM Forms.
Per passare un documento ottenuto da Content Services (obsoleto) (obsoleto) al servizio Forms, eseguire le operazioni seguenti:
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 si utilizzano servizi Web, includere i file proxy.
Creare un oggetto Forms e un oggetto API client di Document Management
Prima di poter eseguire un'operazione API del servizio Forms a livello di programmazione, creare un oggetto API del client Forms. Inoltre, poiché questo flusso di lavoro recupera un file XDP da Content Services (obsoleto), crea un oggetto API di gestione dei documenti.
Recuperare la progettazione del modulo da Content Services (obsoleto)
Recupera il file XDP da Content Services (obsoleto) utilizzando l’API Java o del servizio web. Il file XDP viene restituito all’interno di un com.adobe.idp.Document
istanza (o un BLOB
se si utilizzano i servizi web). È quindi possibile trasmettere com.adobe.idp.Document
al servizio Forms.
Rendering di un modulo PDF interattivo
Per riprodurre un modulo interattivo, trasmettere com.adobe.idp.Document
istanza restituita da Content Services (obsoleta) al servizio Forms.
È possibile passare un com.adobe.idp.Document
che contiene la struttura del modulo per il servizio Forms. Due nuovi metodi: renderPDFForm2
e renderHTMLForm2
accetta un com.adobe.idp.Document
oggetto che contiene una struttura di modulo.
Eseguire un'azione con il flusso di dati del modulo
A seconda del tipo di applicazione client, è possibile scrivere il modulo in un browser Web client o salvarlo come file PDF. In genere, un'applicazione basata sul Web scrive il modulo nel browser Web. Tuttavia, un'applicazione desktop in genere salva il modulo come file PDF.
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Guida introduttiva all’API di servizio Forms
Passa un documento ottenuto da Content Services (obsoleto) utilizzando il servizio Forms e l’API Content Services (obsoleto) (Java):
Includi file di progetto
Includi i file JAR client, come adobe-forms-client.jar e adobe-contentservices-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Forms e un oggetto API client di Document Management
ServiceClientFactory
oggetto che contiene proprietà di connessione. (vedere Impostazione delle proprietà di connessione.)FormsServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.DocumentManagementServiceClientImpl
mediante il costruttore e passando il ServiceClientFactory
oggetto.Recuperare la progettazione del modulo da Content Services (obsoleto)
Richiama DocumentManagementServiceClientImpl
dell'oggetto retrieveContent
e trasmettere i seguenti valori:
SpacesStore
. Questo valore è un parametro obbligatorio./Company Home/Form Designs/Loan.xdp
). Questo valore è un parametro obbligatorio.Il retrieveContent
il metodo restituisce un CRCResult
oggetto che contiene il file XDP. Ottenere un com.adobe.idp.Document
richiamando il CRCResult
dell'oggetto getDocument
metodo.
Rendering di un modulo PDF interattivo
Richiama FormsServiceClient
dell'oggetto renderPDFForm2
e trasmettere i seguenti valori:
com.adobe.idp.Document
oggetto che contiene la struttura del modulo recuperata da Content Services (obsoleto).com.adobe.idp.Document
oggetto contenente dati da unire con il modulo. Se non desideri unire i dati, passa un campo vuoto com.adobe.idp.Document
oggetto.PDFFormRenderSpec
oggetto che memorizza le opzioni di runtime. Questo valore è un parametro facoltativo ed è possibile specificare null
se non si desidera specificare le opzioni di runtime.URLSpec
oggetto che contiene valori URI. Questo valore è un parametro facoltativo ed è possibile specificare null
.java.util.HashMap
oggetto che memorizza gli allegati. Questo valore è un parametro facoltativo ed è possibile specificare null
se non si desidera allegare file al modulo.Il renderPDFForm
il metodo restituisce un FormsResult
oggetto contenente un flusso di dati modulo che deve essere scritto nel browser web client.
Eseguire un'azione con il flusso di dati del modulo
com.adobe.idp.Document
oggetto richiamando il FormsResult
oggetto "s getOutputContent
metodo.com.adobe.idp.Document
oggetto richiamando il relativo getContentType
metodo.javax.servlet.http.HttpServletResponse
tipo di contenuto dell'oggetto richiamando il relativo setContentType
e passando il tipo di contenuto del com.adobe.idp.Document
oggetto.javax.servlet.ServletOutputStream
oggetto utilizzato per scrivere il flusso di dati del modulo nel browser web client richiamando javax.servlet.http.HttpServletResponse
dell'oggetto getOutputStream
metodo.java.io.InputStream
oggetto richiamando il com.adobe.idp.Document
dell'oggetto getInputStream
metodo.InputStream
dell'oggetto read
metodo. Passa la matrice di byte come argomento.javax.servlet.ServletOutputStream
dell'oggetto write
metodo per inviare il flusso di dati del modulo al browser web client. Passare la matrice di byte al write
metodo.Consulta anche
Quick Start (modalità SOAP): passaggio di documenti al servizio Forms utilizzando l’API Java
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Passa un documento ottenuto da Content Services (obsoleto) utilizzando il servizio Forms e Content Services (obsoleto) API (servizio web):
Includi file di progetto
Creare un progetto Microsoft .NET che utilizza MTOM. Poiché questa applicazione client richiama due servizi AEM Forms, creare due riferimenti al servizio. Utilizza la seguente definizione WSDL per il riferimento al servizio associato al servizio Forms: http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1
.
Utilizzare la seguente definizione WSDL per il riferimento al servizio associato al servizio Document Management: http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1
.
Perché il BLOB
il tipo di dati è comune a entrambi i riferimenti di servizio, qualifica completa BLOB
tipo di dati quando lo si utilizza. Nel servizio Web corrispondente, tutte le BLOB
le istanze sono completamente qualificate.
Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms.
Creare un oggetto Forms e un oggetto API client di Document Management
Creare un FormsServiceClient
utilizzando il costruttore predefinito.
Creare un FormsServiceClient.Endpoint.Address
oggetto utilizzando System.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/FormsService?WSDL
). Non è necessario utilizzare il lc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)
Creare un System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore del FormsServiceClient.Endpoint.Binding
campo. Invia il valore restituito a BasicHttpBinding
.
Imposta il System.ServiceModel.BasicHttpBinding
dell'oggetto MessageEncoding
campo a WSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM.
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
FormsServiceClient.ClientCredentials.UserName.UserName
.FormsServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.
Ripeti questi passaggi per DocumentManagementServiceClient
client del servizio.
Recuperare la progettazione del modulo da Content Services (obsoleto)
Recupera il contenuto richiamando DocumentManagementServiceClient
dell'oggetto retrieveContent
e fornendo i seguenti valori:
SpacesStore
. Questo valore è un parametro obbligatorio./Company Home/Form Designs/Loan.xdp
). Questo valore è un parametro obbligatorio.BLOB
parametro di output che memorizza il contenuto. Puoi utilizzare questo parametro di output per recuperare il contenuto.ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType
parametro di output che memorizza gli attributi del contenuto.CRCResult
parametro di output. Invece di utilizzare questo oggetto, puoi utilizzare BLOB
parametro di output per ottenere il contenuto.Rendering di un modulo PDF interattivo
Richiama FormsServiceClient
dell'oggetto renderPDFForm2
e trasmettere i seguenti valori:
BLOB
oggetto che contiene la struttura del modulo recuperata da Content Services (obsoleto).BLOB
oggetto contenente dati da unire con il modulo. Se non desideri unire i dati, passa un campo vuoto BLOB
oggetto.PDFFormRenderSpec
oggetto che memorizza le opzioni di runtime. Questo valore è un parametro facoltativo ed è possibile specificare null
se non si desidera specificare le opzioni di runtime.URLSpec
oggetto che contiene valori URI. Questo valore è un parametro facoltativo ed è possibile specificare null
.Map
oggetto che memorizza gli allegati. Questo valore è un parametro facoltativo ed è possibile specificare null
se non si desidera allegare file al modulo.FormsResult
parametro di output utilizzato per memorizzare il modulo di interactrive PDF .
Il renderPDFForm2
il metodo restituisce un FormsResult
oggetto che contiene il modulo PDF interattivo.
Eseguire un'azione con il flusso di dati del modulo
BLOB
oggetto che contiene i dati del modulo ottenendo il valore di FormsResult
dell'oggetto outputContent
campo.System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento interattivo di PDF e la modalità di apertura del file.BLOB
oggetto recuperato da FormsResult
oggetto. Popolare la matrice di byte ottenendo il valore della BLOB
dell'oggetto MTOM
membro dati.System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando il System.IO.FileStream
oggetto.System.IO.BinaryWriter
dell'oggetto Write
e passando la matrice di byte.Consulta anche
Richiamare AEM Forms tramite MTOM