Ottimizzazione delle prestazioni del servizio Forms

Esempi ed esempi in questo documento sono solo per AEM Forms in ambiente JEE.

Ottimizzazione delle prestazioni del servizio Forms

Quando si esegue il rendering di un modulo, è possibile impostare opzioni di esecuzione che ottimizzano le prestazioni del servizio Forms. Un'altra attività che è possibile eseguire per migliorare le prestazioni del servizio Forms è quella di memorizzare i file XDP nell'archivio. Tuttavia, questa sezione non descrive come eseguire questa attività. (Vedere Richiamo di un servizio utilizzando una libreria client Java.)

Riepilogo dei passaggi

Per ottimizzare le prestazioni del servizio Forms durante il rendering di un modulo, eseguire le operazioni seguenti:

1. Includi file di progetto.
2. Creare un oggetto API client Forms.
3. Impostare le opzioni di esecuzione delle prestazioni.
4. Eseguire il rendering del modulo.
5. Scrivere il flusso di dati del modulo sul 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, assicurati di includere i file proxy.

Creare un oggetto API client Forms

Prima di poter eseguire programmaticamente un’operazione API client del servizio Forms, è necessario creare un client di servizio Forms. Se utilizzi l’API Java, crea un oggetto FormsServiceClient. Se utilizzi l’API del servizio Web Forms, crea un oggetto FormsService.

Impostare le opzioni di runtime delle prestazioni

Per migliorare le prestazioni del servizio Forms, puoi impostare le seguenti opzioni di esecuzione delle prestazioni:

• Memorizzazione in cache dei moduli: È possibile memorizzare nella cache del server un modulo di cui è stato eseguito il rendering come PDF. Ogni modulo viene memorizzato nella cache dopo essere stato generato per la prima volta. In un rendering successivo, se il modulo memorizzato nella cache è più recente della marca temporale della struttura del modulo, il modulo viene recuperato dalla cache. La memorizzazione nella cache dei moduli consente di migliorare le prestazioni del servizio Forms, in quanto non è necessario recuperare la struttura del modulo da un archivio.
• Il rendering delle guide dei moduli (obsolete) potrebbe richiedere più tempo rispetto ad altri tipi di trasformazione. Per migliorare le prestazioni, è consigliabile memorizzare nella cache le guide dei moduli (obsolete).
• Opzione autonoma: Se non si richiede al servizio Forms di eseguire calcoli lato server, è possibile impostare l’opzione Standalone su true, che consente di eseguire il rendering dei moduli senza informazioni sullo stato. Le informazioni sullo stato sono necessarie se si desidera eseguire il rendering di un modulo interattivo per un utente finale che quindi immette informazioni nel modulo e lo invia nuovamente al servizio Forms. Il servizio Forms esegue quindi un’operazione di calcolo ed esegue il rendering del modulo per l’utente con i risultati visualizzati nel modulo. Se un modulo senza informazioni sullo stato viene inviato nuovamente al servizio Forms, sono disponibili solo i dati XML e i calcoli sul lato server non vengono eseguiti.
• PDF lineare: Viene organizzato un file PDF linearizzato per consentire un accesso incrementale efficiente in un ambiente di rete. Il file PDF è valido sotto tutti gli aspetti ed è compatibile con tutti i visualizzatori esistenti e con altre applicazioni PDF. In altre parole, un PDF linearizzato può essere visualizzato mentre è ancora in corso il download.
• Questa opzione non migliora le prestazioni quando si esegue il rendering di un modulo PDF sul client.
• Opzione GuideRSL: Abilita la generazione della Guida ai moduli (obsoleta) tramite librerie condivise in fase di esecuzione. Ciò significa che la prima richiesta scaricherà un file SWF più piccolo, più librerie condivise più grandi che sono memorizzate nella cache del browser. Per ulteriori informazioni, consulta RSL nella documentazione di Flex.
• È inoltre possibile migliorare le prestazioni del servizio Forms eseguendo il rendering di un modulo sul client. (Vedere Rendering di Forms sul client.)

Rendering del modulo

Per eseguire il rendering del modulo dopo aver impostato le opzioni di prestazioni, utilizzare la stessa logica applicativa del rendering di un modulo senza opzioni di prestazioni.

Scrivere il flusso di dati del modulo sul browser Web client

Dopo il rendering di un modulo da parte del servizio Forms, restituisce un flusso di dati del modulo che è necessario scrivere nel browser Web client. Una volta scritto nel browser Web client, il modulo è visibile all’utente.

Consulta anche

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API di Forms Service

Rendering di PDF forms interattivi

Rendering di Forms come HTML

Creazione di applicazioni Web per il rendering di Forms

Ottimizzare le prestazioni utilizzando l'API Java

Eseguire il rendering di un modulo con prestazioni ottimizzate utilizzando l’API Forms (Java):

1. Includi file di progetto

   Includi file JAR client, come adobe-forms-client.jar, nel percorso di classe del progetto Java.

2. Creare un oggetto API client Forms

   • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
   • Creare un oggetto FormsServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

3. Impostare le opzioni di runtime delle prestazioni

   • Creare un oggetto PDFFormRenderSpec utilizzando il relativo costruttore.
   • Impostare l’opzione per la cache del modulo richiamando il metodo setCacheEnabled dell’oggetto true e passando PDFFormRenderSpec.
   • Imposta l’opzione linearizzata richiamando il metodo PDFFormRenderSpec dell’oggetto setLinearizedPDF e passando true.

4. Rendering del modulo

   Richiama il metodo renderPDFForm dell'oggetto FormsServiceClient e passa i seguenti valori:

   • Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file.
   • Un oggetto com.adobe.idp.Document contenente i dati da unire al modulo. Se non si desidera unire i dati, passare un oggetto com.adobe.idp.Document vuoto.
   • Un oggetto PDFFormRenderSpec che memorizza le opzioni di esecuzione per migliorare le prestazioni.
   • Un oggetto URLSpec contenente valori URI richiesti dal servizio Forms.
   • Un oggetto java.util.HashMap che memorizza gli allegati di file. Questo è un parametro facoltativo ed è possibile specificare null se non si desidera allegare file al modulo.

   Il metodo renderPDFForm restituisce un oggetto FormsResult contenente un flusso di dati del modulo che deve essere scritto nel browser Web client.

5. Scrivere il flusso di dati del modulo sul browser Web client

   • Creare un oggetto javax.servlet.ServletOutputStream utilizzato per inviare un flusso di dati del modulo al browser Web client.
   • Creare un oggetto com.adobe.idp.Document richiamando il metodo FormsResult object ‘s getOutputContent .
   • Creare un oggetto java.io.InputStream richiamando il metodo com.adobe.idp.Document dell'oggetto getInputStream.
   • Creare una matrice di byte e compilarla con il flusso di dati del modulo richiamando il metodo readdell'oggetto InputStream e passando la matrice di byte come argomento.
   • Richiamare il metodo write dell’oggetto javax.servlet.ServletOutputStream per inviare il flusso di dati del modulo al browser Web client. Passa l'array di byte al metodo write .

Consulta anche

Avvio rapido (modalità SOAP): Ottimizzazione delle prestazioni tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Ottimizzare le prestazioni utilizzando l'API del servizio Web

Eseguire il rendering di un modulo con prestazioni ottimizzate utilizzando l’API Forms (servizio Web):

1. Includi file di progetto

   • Creare classi proxy Java che utilizzano il servizio WSDL di Forms.
   • Includi le classi proxy Java nel percorso della classe.

2. Creare un oggetto API client Forms

   Creare un oggetto FormsService e impostare i valori di autenticazione.

3. Impostare le opzioni di runtime delle prestazioni

   • Creare un oggetto PDFFormRenderSpec utilizzando il relativo costruttore.
   • Impostare l’opzione per la cache del modulo richiamando il metodo setCacheEnabled dell’oggetto PDFFormRenderSpec e passando true.
   • Impostare l’opzione autonoma richiamando il metodo setStandAlone dell’oggetto PDFFormRenderSpec e specificando true.
   • Impostare l’opzione linearizzata richiamando il metodo setLinearizedPDF dell’oggetto PDFFormRenderSpec e passando true.

4. Rendering del modulo

   Richiama il metodo renderPDFForm dell'oggetto FormsService e passa i seguenti valori:

   • Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file.
   • Un oggetto BLOB contenente i dati da unire al modulo. Se non desideri unire i dati, passa null.
   • Un oggetto PDFFormRenderSpecc che memorizza le opzioni di esecuzione.
   • Un oggetto URLSpec contenente valori URI richiesti dal servizio Forms.
   • Un oggetto java.util.HashMap che memorizza gli allegati di file. Questo è un parametro facoltativo ed è possibile specificare null se non si desidera allegare file al modulo.
   • Un oggetto com.adobe.idp.services.holders.BLOBHolder vuoto compilato dal metodo . Viene utilizzato per memorizzare il modulo PDF di cui è stato effettuato il rendering.
   • Un oggetto javax.xml.rpc.holders.LongHolder vuoto compilato dal metodo . Questo argomento memorizza il numero di pagine nel modulo.
   • Un oggetto javax.xml.rpc.holders.StringHolder vuoto compilato dal metodo . (Questo argomento memorizza il valore delle impostazioni internazionali).
   • Un oggetto com.adobe.idp.services.holders.FormsResultHolder vuoto che conterrà i risultati dell'operazione.

   Il metodo renderPDFForm popola l'oggetto com.adobe.idp.services.holders.FormsResultHolder passato come ultimo valore dell'argomento con un flusso di dati del modulo che deve essere scritto nel browser Web client.

5. Scrivere il flusso di dati del modulo sul browser Web client

   • Creare un oggetto FormResult ottenendo il valore del membro dati com.adobe.idp.services.holders.FormsResultHolder dell'oggetto value.
   • Creare un oggetto javax.servlet.ServletOutputStream utilizzato per inviare un flusso di dati del modulo al browser Web client.
   • Creare un oggetto BLOB che contiene dati del modulo richiamando il metodo FormsResult dell'oggetto getOutputContent.
   • Creare una matrice di byte e compilarla richiamando il metodo getBinaryData dell'oggetto BLOB. Questa attività assegna il contenuto dell'oggetto FormsResult all'array di byte.
   • Richiamare il metodo write dell’oggetto javax.servlet.http.HttpServletResponse per inviare il flusso di dati del modulo al browser Web client. Passa l'array di byte al metodo write .

Consulta anche

Richiamo di AEM Forms con codifica Base64