Forms con diritti di rendering rendering-rights-enabled-forms

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 oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto FormsServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Impostare le opzioni di runtime dei diritti di utilizzo

• Creare un oggetto ReaderExtensionSpec utilizzando il relativo costruttore.
• Specificare l'alias delle credenziali richiamando il metodo setReCredentialAlias dell'oggetto ReaderExtensionSpec e specificare un valore stringa che rappresenti il valore alias.
• Impostare ogni diritto di utilizzo richiamando il metodo corrispondente che appartiene all'oggetto ReaderExtensionSpec. È 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 il metodo setReFillIn dell'oggetto ReaderExtensionSpec e passare true.

Eseguire il rendering di un modulo abilitato per i diritti

Richiama il metodo renderPDFFormWithUsageRights dell'oggetto FormsServiceClient e passa 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.
• Oggetto com.adobe.idp.Document contenente 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 runtime.
• Oggetto ReaderExtensionSpec che memorizza le opzioni di runtime dei diritti di utilizzo.
• Oggetto URLSpec contenente i valori URI richiesti dal servizio Forms.

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

Scrivere il flusso di dati del modulo nel browser Web client

• Creare un oggetto com.adobe.idp.Document richiamando il metodo getOutputContent dell'oggetto FormsResult.
• Ottenere il tipo di contenuto dell'oggetto com.adobe.idp.Document richiamando il relativo metodo getContentType.
• Impostare il tipo di contenuto dell'oggetto javax.servlet.http.HttpServletResponse richiamando il relativo metodo setContentType e passando il tipo di contenuto dell'oggetto com.adobe.idp.Document.
• Creare un oggetto javax.servlet.ServletOutputStream utilizzato per scrivere il flusso di dati del modulo nel browser Web client richiamando il metodo getOutputStream dell'oggetto javax.servlet.http.HttpServletResponse.
• Creare un oggetto java.io.InputStream richiamando il metodo getInputStream dell'oggetto com.adobe.idp.Document.
• Creare una matrice di byte popolarla con il flusso di dati del modulo richiamando il metodo read dell'oggetto InputStream e passando la matrice di byte come argomento.
• Richiama il metodo write dell'oggetto javax.servlet.ServletOutputStream per inviare il flusso di dati del modulo al browser Web client. Passare la matrice di byte al metodo write.

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 oggetto FormsService e impostare i valori di autenticazione.

Impostare le opzioni di runtime dei diritti di utilizzo

• Creare un oggetto ReaderExtensionSpec utilizzando il relativo costruttore.
• Specificare l'alias delle credenziali richiamando il metodo setReCredentialAlias dell'oggetto ReaderExtensionSpec e specificare un valore stringa che rappresenti il valore alias.
• Impostare ogni diritto di utilizzo richiamando il metodo corrispondente che appartiene all'oggetto ReaderExtensionSpec. È 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 il metodo setReFillIn dell'oggetto ReaderExtensionSpec e passare true.

Eseguire il rendering di un modulo abilitato per i diritti

Richiama il metodo renderPDFFormWithUsageRights dell'oggetto FormsService e passa 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.
• Oggetto BLOB contenente dati da unire al modulo. Se non si desidera unire i dati con il modulo, è necessario passare un oggetto BLOB basato su un'origine dati XML vuota. Impossibile passare un oggetto BLOB null. In caso contrario, viene generata un'eccezione.
• Un oggetto PDFFormRenderSpec che memorizza le opzioni di runtime.
• Oggetto ReaderExtensionSpec che memorizza le opzioni di runtime dei diritti di utilizzo.
• Oggetto URLSpec contenente i valori URI richiesti dal servizio Forms.

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

Scrivere il flusso di dati del modulo nel browser Web client

• Creare un oggetto BLOB contenente dati del modulo richiamando il metodo getOutputContent dell'oggetto FormsResult.
• Ottenere il tipo di contenuto dell'oggetto BLOB richiamando il relativo metodo getContentType.
• Impostare il tipo di contenuto dell'oggetto javax.servlet.http.HttpServletResponse richiamando il relativo metodo setContentType e passando il tipo di contenuto dell'oggetto BLOB.
• Creare un oggetto javax.servlet.ServletOutputStream utilizzato per scrivere il flusso di dati del modulo nel browser Web client richiamando il metodo getOutputStream dell'oggetto javax.servlet.http.HttpServletResponse.
• Creare una matrice di byte e popolarla richiamando il metodo getBinaryData dell'oggetto BLOB. Questa attività assegna il contenuto dell'oggetto FormsResult alla matrice di byte.
• Richiama il metodo write dell'oggetto javax.servlet.http.HttpServletResponse per inviare il flusso di dati del modulo al browser Web client. Passare la matrice di byte al metodo write.