Rendering di Forms nel client rendering-forms-at-the-client
Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.
Rendering di Forms nel client rendering-forms-at-the-client-inner
Puoi ottimizzare la distribuzione dei contenuti PDF e migliorare la capacità del servizio Forms di gestire il carico di rete utilizzando la funzionalità di rendering lato client di Acrobat o Adobe Reader. Questo processo è noto come rendering di un modulo sul client. Per eseguire il rendering di un modulo sul client, il dispositivo client (in genere un browser web) deve utilizzare Acrobat 7.0 o Adobe Reader 7.0 o versione successiva.
Le modifiche a un modulo risultanti dall’esecuzione di script lato server non vengono applicate a un modulo sottoposto a rendering nel client, a meno che il sottomodulo principale non contenga restoreState
attributo impostato su auto
. Per ulteriori informazioni su questo attributo, consulta Forms Designer.
Riepilogo dei passaggi summary-of-steps
Per eseguire il rendering di un modulo sul client, eseguire le operazioni seguenti:
- Includi file di progetto.
- Crea un oggetto API client di Forms.
- Impostare le opzioni di runtime di rendering del client.
- Eseguire il rendering di un modulo nel client.
- Scrivere il modulo nel browser Web client.
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, accertati di includere i file proxy.
Creare un oggetto API client di Forms
Prima di poter eseguire a livello di programmazione un'operazione API client del servizio Forms, è necessario creare un client del servizio Forms. Se utilizzi l’API Java, crea un’ FormsServiceClient
oggetto. Se utilizzi l’API del servizio web Forms, crea un’ FormsService
oggetto.
Impostare le opzioni di runtime di rendering del client
Impostare l'opzione di rendering client in fase di esecuzione per eseguire il rendering di un modulo sul client impostando RenderAtClient
opzione di runtime per true
. In questo modo il modulo viene consegnato al dispositivo client in cui viene eseguito il rendering. Se RenderAtClient
è auto
(valore predefinito), la struttura del modulo determina se il rendering del modulo viene eseguito sul client. La struttura del modulo deve essere una struttura di modulo con un layout scorrevole.
È possibile impostare un'opzione di runtime facoltativa per SeedPDF
opzione. Il SeedPDF
combina il contenitore PDF (documento di seed PDF) con la struttura del modulo e i dati XML. Sia la struttura del modulo che i dati XML vengono inviati ad Acrobat o Adobe Reader, dove viene eseguito il rendering del modulo. Il SeedPDF
L'opzione può essere utilizzata quando il computer client non dispone di tipi di carattere utilizzati nel modulo, ad esempio quando un utente finale non dispone della licenza per utilizzare un tipo di carattere che il proprietario del modulo può utilizzare.
È possibile utilizzare Designer per creare un semplice file di PDF dinamico da utilizzare come file di PDF seed. Per eseguire questa attività sono necessari i seguenti passaggi:
- Determinare se è necessario incorporare i tipi di carattere nel file di PDF seed. Il file di seed PDF deve contenere i font aggiuntivi richiesti dal modulo sottoposto a rendering. Quando si incorporano font nel file di PDF seed, assicurarsi di non violare alcun contratto di licenza per i font. In Designer è possibile determinare se è possibile incorporare legalmente i tipi di carattere. Al momento del salvataggio, se sono presenti tipi di carattere che non è possibile incorporare nel modulo, Designer visualizza un messaggio in cui sono elencati i tipi di carattere che non è possibile incorporare. Questo messaggio non viene visualizzato in Designer per i documenti statici di PDF.
- Se si sta creando il file di PDF seed in Designer, è consigliabile aggiungere almeno un campo di testo contenente un messaggio. Il messaggio deve essere indirizzato agli utenti delle versioni precedenti di Adobe Reader in cui si dichiara che per visualizzare il documento è necessario Acrobat 7.0 o versione successiva oppure Adobe Reader 7.0 o versione successiva.
- Salvare il file di seed PDF come file di dynamic PDF con l'estensione PDF.
Eseguire il rendering di un modulo sul client
Per eseguire il rendering di un modulo sul client, è necessario assicurarsi che le opzioni di runtime di rendering del client siano incluse nella logica dell’applicazione per eseguire il rendering di un modulo.
Scrivere il flusso di dati del modulo nel browser Web client
Il servizio Forms crea un flusso di dati modulo che è necessario scrivere nel browser Web client. Quando viene scritto nel browser web client, il modulo viene renderizzato da Acrobat 7.0 o Adobe Reader 7.0 o versione successiva ed è visibile all’utente.
Consulta anche
Eseguire il rendering di un modulo sul client utilizzando l’API Java
Eseguire il rendering di un modulo sul client utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Guida introduttiva all’API di servizio Forms
Trasmissione di documenti al servizio Forms
Creazione di applicazioni Web per il rendering di Forms
Eseguire il rendering di un modulo sul client utilizzando l’API Java render-a-form-at-the-client-using-the-java-api
Esegui il rendering di un modulo sul client utilizzando l’API Forms (Java):
-
Includi file di progetto
Includi i file JAR client, ad esempio adobe-forms-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto API client di Forms
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
FormsServiceClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Impostare le opzioni di runtime di rendering del client
- Creare un
PDFFormRenderSpec
mediante il costruttore. - Imposta il
RenderAtClient
runtime richiamando l'opzionePDFFormRenderSpec
dell'oggettosetRenderAtClient
e passando il valore enumRenderAtClient.Yes
.
- Creare un
-
Eseguire il rendering di un modulo sul client
Richiama
FormsServiceClient
dell'oggettorenderPDFForm
e trasmettere i seguenti valori:- Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file. Se si fa riferimento a una progettazione di modulo che fa parte di un'applicazione AEM Forms, assicurarsi di specificare il percorso completo, ad esempio
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - A
com.adobe.idp.Document
oggetto contenente dati da unire con il modulo. Se non desideri unire i dati, passa un campo vuotocom.adobe.idp.Document
oggetto. - A
PDFFormRenderSpec
oggetto che memorizza le opzioni di runtime necessarie per eseguire il rendering di un modulo sul client. - A
URLSpec
oggetto contenente valori URI richiesti dal servizio Forms per il rendering di un modulo. - A
java.util.HashMap
oggetto che memorizza gli allegati. Questo è un parametro facoltativo e puoi specificarenull
se non si desidera allegare file al modulo.
Il
renderPDFForm
il metodo restituisce unFormsResult
oggetto contenente un flusso di dati modulo che deve essere scritto nel browser web client. - Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file. Se si fa riferimento a una progettazione di modulo che fa parte di un'applicazione AEM Forms, assicurarsi di specificare il percorso completo, ad esempio
-
Scrivere il flusso di dati del modulo nel browser Web client
- Creare un
com.adobe.idp.Document
oggetto richiamando ilFormsResult
oggetto "sgetOutputContent
metodo. - Ottieni il tipo di contenuto del
com.adobe.idp.Document
oggetto richiamando il relativogetContentType
metodo. - Imposta il
javax.servlet.http.HttpServletResponse
tipo di contenuto dell'oggetto richiamando il relativosetContentType
e passando il tipo di contenuto delcom.adobe.idp.Document
oggetto. - Creare un
javax.servlet.ServletOutputStream
oggetto utilizzato per scrivere il flusso di dati del modulo nel browser web client richiamandojavax.servlet.http.HttpServletResponse
dell'oggettogetOutputStream
metodo. - Creare un
java.io.InputStream
oggetto richiamando ilcom.adobe.idp.Document
dell'oggettogetInputStream
metodo. - Creare una matrice di byte e popolarla con il flusso di dati del modulo richiamando
InputStream
dell'oggettoread
e passando la matrice di byte come argomento. - Richiama
javax.servlet.ServletOutputStream
dell'oggettowrite
metodo per inviare il flusso di dati del modulo al browser web client. Passare la matrice di byte alwrite
metodo.
- Creare un
Consulta anche
Quick Start (modalità SOAP): rendering di un modulo sul client tramite l’API Java
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Eseguire il rendering di un modulo sul client utilizzando l’API del servizio web render-a-form-at-the-client-using-the-web-service-api
Esegui il rendering di un modulo sul client utilizzando l’API Forms (servizio web):
-
Includi file di progetto
- Creare classi proxy Java che utilizzano il servizio Forms WSDL.
- Includi le classi proxy Java nel percorso della classe.
-
Creare un oggetto API client di Forms
Creare un
FormsService
e impostare i valori di autenticazione. -
Impostare le opzioni di runtime di rendering del client
- Creare un
PDFFormRenderSpec
mediante il costruttore. - Imposta il
RenderAtClient
runtime richiamando l'opzionePDFFormRenderSpec
dell'oggettosetRenderAtClient
e passando il valore stringaRenderAtClient.Yes
.
- Creare un
-
Eseguire il rendering di un modulo sul client
Richiama
FormsService
dell'oggettorenderPDFForm
e trasmettere i seguenti valori:- Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file. Se si fa riferimento a una struttura di modulo che fa parte di un'applicazione Forms, assicurarsi di specificare il percorso completo, ad esempio
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. - A
BLOB
oggetto contenente dati da unire con il modulo. Se non si desidera unire i dati, passarenull
. (vedere Precompilazione di Forms con layout fluibili.) - A
PDFFormRenderSpec
oggetto che memorizza le opzioni di runtime necessarie per eseguire il rendering di un modulo sul client. - A
URLSpec
oggetto contenente valori URI richiesti dal servizio Forms. - A
java.util.HashMap
oggetto che memorizza gli allegati. Questo è un parametro facoltativo e puoi specificarenull
se non si desidera allegare file al modulo. - Un campo vuoto
com.adobe.idp.services.holders.BLOBHolder
oggetto popolato dal metodo. Questo parametro viene utilizzato per memorizzare il modulo PDF di cui è stato eseguito il rendering. - Un campo vuoto
javax.xml.rpc.holders.LongHolder
oggetto popolato dal metodo. Questo argomento consente di memorizzare il numero di pagine nel modulo. - Un campo vuoto
javax.xml.rpc.holders.StringHolder
oggetto popolato dal metodo. Questo argomento consente di memorizzare il valore delle impostazioni locali. - Un campo vuoto
com.adobe.idp.services.holders.FormsResultHolder
oggetto che conterrà i risultati dell'operazione.
Il
renderPDFForm
il metodo compilacom.adobe.idp.services.holders.FormsResultHolder
oggetto passato come ultimo valore di argomento con un flusso di dati del modulo che deve essere scritto nel browser web client. - Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file. Se si fa riferimento a una struttura di modulo che fa parte di un'applicazione Forms, assicurarsi di specificare il percorso completo, ad esempio
-
Scrivere il flusso di dati del modulo nel browser Web client
- Creare un
FormResult
dell'oggetto ottenendo il valore delcom.adobe.idp.services.holders.FormsResultHolder
dell'oggettovalue
membro dati. - Creare un
BLOB
oggetto che contiene i dati del modulo richiamandoFormsResult
dell'oggettogetOutputContent
metodo. - Ottieni il tipo di contenuto del
BLOB
oggetto richiamando il relativogetContentType
metodo. - Imposta il
javax.servlet.http.HttpServletResponse
tipo di contenuto dell'oggetto richiamando il relativosetContentType
e passando il tipo di contenuto delBLOB
oggetto. - Creare un
javax.servlet.ServletOutputStream
oggetto utilizzato per scrivere il flusso di dati del modulo nel browser web client richiamandojavax.servlet.http.HttpServletResponse
dell'oggettogetOutputStream
metodo. - Creare una matrice di byte e popolarla richiamando il
BLOB
dell'oggettogetBinaryData
metodo. Questa attività assegna il contenuto delFormsResult
alla matrice di byte. - Richiama
javax.servlet.http.HttpServletResponse
dell'oggettowrite
metodo per inviare il flusso di dati del modulo al browser web client. Passare la matrice di byte alwrite
metodo.
- Creare un
Consulta anche
Richiamare AEM Forms utilizzando la codifica Base64