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.)
Per eseguire il rendering di un modulo che contiene diritti di utilizzo, è necessario utilizzare un file XDP come input, non un file PDF. Se si utilizza un file PDF come input, il modulo viene comunque sottoposto a rendering, ma non sarà un modulo abilitato per i diritti.
Non è possibile precompilare un modulo con dati XML quando si specificano i seguenti diritti di utilizzo: enableComments
, enableCommentsOnline
, enableEmbeddedFiles
, o enableDigitalSignatures
. (vedere Precompilazione di Forms con layout fluibili.)
Per ulteriori informazioni sul servizio Forms, consulta Guida di riferimento dei servizi per AEM Forms.
Per eseguire il rendering di un modulo abilitato per i diritti, 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 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.
Quando si esegue il rendering di un modulo abilitato ai diritti tramite l’API del servizio Web Forms, non è possibile allegare file al modulo.
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 un modulo abilitato ai diritti tramite 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
ServiceClientFactory
oggetto che contiene proprietà di connessione.FormsServiceClient
mediante il costruttore e passando il ServiceClientFactory
oggetto.Impostare le opzioni di runtime dei diritti di utilizzo
ReaderExtensionSpec
mediante il costruttore.ReaderExtensionSpec
dell'oggetto setReCredentialAlias
e specificare un valore stringa che rappresenti il valore alias.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
.Non è necessario invocare ReaderExtensionSpec
dell'oggetto setReCredentialPassword
metodo. Questo metodo non viene utilizzato dal servizio Forms.
Eseguire il rendering di un modulo abilitato per i diritti
Richiama FormsServiceClient
dell'oggetto renderPDFFormWithUsageRights
e trasmettere i seguenti valori:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.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.ReaderExtensionSpec
oggetto che memorizza le opzioni di runtime dei diritti di utilizzo.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.
Scrivere il flusso di dati del modulo nel browser Web client
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
e passando 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): 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 un modulo abilitato ai diritti tramite l’API di Forms (servizio web):
Includi file di progetto
Creare un oggetto API client di Forms
Creare un FormsService
e impostare i valori di autenticazione.
Impostare le opzioni di runtime dei diritti di utilizzo
ReaderExtensionSpec
mediante il costruttore.ReaderExtensionSpec
dell'oggetto setReCredentialAlias
e specificare un valore stringa che rappresenti il valore alias.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
.Eseguire il rendering di un modulo abilitato per i diritti
Richiama FormsService
dell'oggetto renderPDFFormWithUsageRights
e trasmettere i seguenti valori:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.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.PDFFormRenderSpec
oggetto che memorizza le opzioni di runtime.ReaderExtensionSpec
oggetto che memorizza le opzioni di runtime dei diritti di utilizzo.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.
Scrivere il flusso di dati del modulo nel browser Web client
BLOB
oggetto che contiene i dati del modulo richiamando FormsResult
dell'oggetto getOutputContent
metodo.BLOB
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 BLOB
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.BLOB
dell'oggetto getBinaryData
metodo. Questa attività assegna il contenuto del FormsResult
alla matrice di byte.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