Forms con diritti di rendering

Il servizio Forms può eseguire il rendering di moduli a cui sono applicati diritti di utilizzo. I diritti di utilizzo riguardano funzionalità disponibili per impostazione predefinita in Acrobat ma non in Adobe Reader, ad esempio la possibilità di aggiungere commenti a un modulo o di compilare campi modulo e salvare il modulo. I Forms a cui sono applicati diritti di utilizzo sono denominati moduli abilitati per i diritti. L’utente che apre un modulo abilitato ai diritti in Adobe Reader può eseguire operazioni che sono abilitate per tale modulo.

Per applicare i diritti di utilizzo a un modulo, il servizio Acrobat Reader DC extensions deve far parte dell’installazione dei moduli AEM. Inoltre, è necessario disporre di una credenziale valida che consenta di applicare i diritti di utilizzo ai documenti PDF. In altre parole, è necessario configurare correttamente il servizio Estensioni di Acrobat Reader DC prima di poter eseguire il rendering di un modulo abilitato per i diritti. (vedere Informazioni sul servizio estensioni Acrobat Reader DC.)

Riepilogo dei passaggi

Per eseguire il rendering di un modulo abilitato per i diritti, eseguire le operazioni seguenti:

1. Includi file di progetto.
2. Crea un oggetto API client di Forms.
3. Impostare le opzioni di runtime dei diritti di utilizzo.
4. Eseguire il rendering di un modulo abilitato per i diritti.
5. Scrivere il modulo abilitato ai diritti 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.

Impostare le opzioni di runtime dei diritti di utilizzo

Impostare le opzioni di runtime relative ai diritti di utilizzo per eseguire il rendering di un modulo abilitato ai diritti. È inoltre necessario specificare l'alias delle credenziali utilizzato per applicare i diritti di utilizzo a un modulo. Dopo aver specificato il valore dell'alias, specificare ogni diritto di utilizzo da applicare al modulo.

Eseguire il rendering di un modulo abilitato per i diritti

Per eseguire il rendering di un modulo abilitato per i diritti, utilizzare la stessa logica di applicazione utilizzata per il rendering di un modulo senza diritti di utilizzo. L'unica differenza consiste nel fatto che è necessario assicurarsi che le opzioni di runtime dei diritti di utilizzo siano incluse nella logica dell'applicazione.

Scrivere il flusso di dati del modulo nel browser Web client

Quando il servizio Forms esegue il rendering di un modulo abilitato ai diritti, restituisce un flusso di dati del modulo che è necessario scrivere nel browser Web client. Una volta scritto sul browser web client, il modulo è visibile all’utente. Un utente che visualizza il modulo abilitato ai diritti in Adobe Reader è in grado di eseguire operazioni abilitate per tale modulo.

Consulta anche

Eseguire il rendering di moduli abilitati per i diritti tramite l’API Java

Eseguire il rendering di moduli abilitati per i diritti tramite 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

Rendering dei PDF forms interattivi

Creazione di applicazioni Web per il rendering di Forms

Eseguire il rendering di moduli abilitati per i diritti tramite l’API Java

Eseguire il rendering di un modulo abilitato ai diritti tramite l’API Forms (Java):

1. Includi file di progetto

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

2. Creare un oggetto API client di Forms

   • Creare un ServiceClientFactory oggetto che contiene proprietà di connessione.
   • Creare un FormsServiceClient mediante il costruttore e passando il ServiceClientFactory oggetto.

3. Impostare le opzioni di runtime dei diritti di utilizzo

   • Creare un ReaderExtensionSpec mediante il costruttore.
   • Specificare l'alias delle credenziali richiamando ReaderExtensionSpec dell'oggetto setReCredentialAlias e specificare un valore stringa che rappresenti il valore alias.
   • Impostare ogni diritto di utilizzo richiamando il metodo corrispondente che appartiene al ReaderExtensionSpec oggetto. È tuttavia possibile impostare un diritto di utilizzo solo se le credenziali a cui si fa riferimento lo consentono. In altre parole, non è possibile impostare un diritto di utilizzo se le credenziali non consentono di impostarlo. Ad esempio. per impostare il diritto di utilizzo che consente a un utente di compilare i campi del modulo e salvare il modulo, richiamare ReaderExtensionSpec dell'oggetto setReFillIn metodo e passaggio true.
   NOTA

   Non è necessario invocare ReaderExtensionSpec dell'oggetto setReCredentialPassword metodo. Questo metodo non viene utilizzato dal servizio Forms.

4. Eseguire il rendering di un modulo abilitato per i diritti

   Richiama FormsServiceClient dell'oggetto renderPDFFormWithUsageRights 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 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.
   • A PDFFormRenderSpec oggetto che memorizza le opzioni di runtime.
   • A ReaderExtensionSpec oggetto che memorizza le opzioni di runtime dei diritti di utilizzo.
   • A URLSpec oggetto contenente valori URI richiesti dal servizio Forms.

   Il renderPDFFormWithUsageRights il metodo restituisce un FormsResult oggetto contenente un flusso di dati modulo che deve essere scritto nel browser web client.

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

   • Creare un com.adobe.idp.Document oggetto richiamando il FormsResult oggetto "s getOutputContent metodo.
   • Ottieni il tipo di contenuto del com.adobe.idp.Document oggetto richiamando il relativo getContentType metodo.
   • Imposta il 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.
   • Creare un 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.
   • Creare un java.io.InputStream oggetto richiamando il com.adobe.idp.Document dell'oggetto getInputStream metodo.
   • Creare una matrice di byte compilarla con il flusso di dati del modulo richiamando InputStream dell'oggetto read e passando la matrice di byte come argomento.
   • Richiama 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): rendering di un modulo abilitato ai diritti tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Eseguire il rendering di moduli abilitati per i diritti tramite l’API del servizio web

Eseguire il rendering di un modulo abilitato ai diritti tramite l’API di Forms (servizio web):

1. Includi file di progetto

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

2. Creare un oggetto API client di Forms

   Creare un FormsService e impostare i valori di autenticazione.

3. Impostare le opzioni di runtime dei diritti di utilizzo

   • Creare un ReaderExtensionSpec mediante il costruttore.
   • Specificare l'alias delle credenziali richiamando ReaderExtensionSpec dell'oggetto setReCredentialAlias e specificare un valore stringa che rappresenti il valore alias.
   • Impostare ogni diritto di utilizzo richiamando il metodo corrispondente che appartiene al ReaderExtensionSpec oggetto. È tuttavia possibile impostare un diritto di utilizzo solo se le credenziali a cui si fa riferimento lo consentono. In altre parole, non è possibile impostare un diritto di utilizzo se le credenziali non consentono di impostarlo. Per impostare il diritto di utilizzo che consente a un utente di compilare i campi del modulo e salvare il modulo, richiamare ReaderExtensionSpec dell'oggetto setReFillIn metodo e passaggio true.

4. Eseguire il rendering di un modulo abilitato per i diritti

   Richiama FormsService dell'oggetto renderPDFFormWithUsageRights 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 con il modulo, è necessario trasmettere un BLOB oggetto basato su un'origine dati XML vuota. Non è possibile trasmettere un BLOB oggetto null; in caso contrario, viene generata un'eccezione.
   • A PDFFormRenderSpec oggetto che memorizza le opzioni di runtime.
   • A ReaderExtensionSpec oggetto che memorizza le opzioni di runtime dei diritti di utilizzo.
   • A URLSpec oggetto contenente valori URI richiesti dal servizio Forms.

   Il renderPDFFormWithUsageRights il metodo restituisce un FormsResult oggetto contenente un flusso di dati modulo che deve essere scritto nel browser web client.

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

   • Creare un BLOB oggetto che contiene i dati del modulo richiamando FormsResult dell'oggetto getOutputContent metodo.
   • Ottieni il tipo di contenuto del BLOB oggetto richiamando il relativo getContentType metodo.
   • Imposta il javax.servlet.http.HttpServletResponse tipo di contenuto dell'oggetto richiamando il relativo setContentType e passando il tipo di contenuto del BLOB oggetto.
   • Creare un 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.
   • Creare una matrice di byte e popolarla richiamando il BLOB dell'oggetto getBinaryData metodo. Questa attività assegna il contenuto del FormsResult alla matrice di byte.
   • Richiama javax.servlet.http.HttpServletResponse 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

Forms con diritti di rendering

Richiamare AEM Forms utilizzando la codifica Base64