AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.
Il servizio Forms esegue il rendering dei PDF forms interattivi su dispositivi client, in genere browser web, per raccogliere informazioni dagli utenti. Una volta eseguito il rendering di un modulo interattivo, l’utente può immettere i dati nei campi del modulo e fare clic su un pulsante di invio situato nel modulo per inviare le informazioni al servizio Forms. Affinché sia visibile un modulo interattivo di PDF, è necessario installare Adobe Reader o Acrobat nel computer che ospita il browser Web client.
Prima di eseguire il rendering di un modulo utilizzando il servizio Forms, creare una struttura del modulo. In genere, una struttura del modulo viene creata in Designer e salvata come file XDP. Per informazioni sulla creazione di una struttura del modulo, vedere Forms Designer.
Domanda di prestito di esempio
Viene introdotta un’applicazione di prestito di esempio per dimostrare come il servizio Forms utilizza moduli interattivi per raccogliere informazioni dagli utenti. Questa applicazione consente a un utente di compilare un modulo con i dati necessari per garantire un prestito e quindi di inviare i dati al servizio Forms. Il diagramma seguente illustra il flusso logico dell'applicazione di prestito.
La tabella seguente descrive i passaggi descritti in questo diagramma.
Passaggio |
Descrizione |
---|---|
1 |
La |
2 |
La |
3 |
Una volta compilato il modulo di prestito e fatto clic sul pulsante di invio, i dati vengono inviati al |
4 |
La |
5 |
Viene eseguito il rendering di un modulo di conferma nel browser web. I dati, come il nome e il cognome dell’utente, vengono uniti al modulo prima di eseguirne il rendering. (Vedi Precompilazione di Forms con layout fluidi.) |
Modulo di prestito
Il presente modulo di prestito interattivo è reso dalla GetLoanForm
Servlet Java.
Modulo di conferma
Questo modulo è reso dalla HandleData
Servlet Java.
La HandleData
Java Servlet precompila questo modulo con il nome e il cognome dell’utente e la quantità. Dopo la precompilazione, il modulo viene inviato al browser Web client. (Vedi Precompilazione di Forms con layout fluidi)
Servlet Java
L'applicazione di prestito di esempio è un esempio di un'applicazione di servizio Forms che esiste come servlet Java. Un servlet Java è un programma Java in esecuzione su un server applicativo J2EE, ad esempio WebSphere, e contiene il codice API client del servizio Forms.
Il codice seguente mostra la sintassi di un servlet Java denominato GetLoanForm:
public class GetLoanForm extends HttpServlet implements Servlet {
public void doGet(HttpServletRequest req, HttpServletResponse resp
throws ServletException, IOException {
}
public void doPost(HttpServletRequest req, HttpServletResponse resp
throws ServletException, IOException {
}
Normalmente, non inserisci il codice API client del servizio Forms all'interno di un server Java doGet
o doPost
metodo . È consigliabile posizionare questo codice all'interno di una classe separata, creare un'istanza della classe all'interno della doPost
metodo (o doGet
e chiamare i metodi appropriati. Tuttavia, per la brevità del codice, gli esempi di codice in questa sezione sono limitati al minimo e gli esempi di codice sono inseriti nella sezione doPost
metodo .
Per ulteriori informazioni sul servizio Forms, vedi Riferimento servizi per AEM Forms.
Riepilogo dei passaggi
Per eseguire il rendering di un modulo PDF interattivo, effettuare le seguenti operazioni:
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 un’operazione API client di Forms Service a livello di programmazione, è necessario creare un oggetto API client Forms. Se utilizzi l’API Java, crea un FormsServiceClient
oggetto. Se utilizzi l’API del servizio Web Forms, crea un FormsService
oggetto.
Specificare i valori URI
È possibile specificare i valori URI richiesti dal servizio Forms per il rendering di un modulo. È possibile fare riferimento a una struttura del modulo salvata come parte di un'applicazione Forms utilizzando il valore URI della directory principale del contenuto repository:///
. Ad esempio, considerare la seguente struttura del modulo denominata Loan.xdp all'interno di un'applicazione Forms denominata FormsApplication:
Per accedere alla struttura del modulo, specificare Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
come nome del modulo (il primo parametro trasmesso al renderPDFForm
e repository:///
come valore URI della directory principale del contenuto.
Per informazioni sulla creazione di un'applicazione Forms tramite Workbench, consulta Guida di Workbench.
Il percorso di una risorsa situata in un'applicazione Forms è:
Applications/Application-name/Application-version/Folder.../Filename
I seguenti valori mostrano alcuni esempi di valori URI:
Quando si esegue il rendering di un modulo interattivo, è possibile definire valori URI, ad esempio l’URL di destinazione in cui vengono inviati i dati del modulo. L’URL di destinazione può essere definito in uno dei seguenti modi:
Se l’URL di destinazione è definito all’interno della struttura del modulo, non sostituirlo con l’API client del servizio Forms. In altre parole, l’impostazione dell’URL di destinazione tramite l’API Forms reimposta l’URL specificato nella struttura del modulo su quello specificato utilizzando l’API. Se si desidera inviare il modulo PDF all’URL di destinazione specificato nella struttura del modulo, impostare programmaticamente l’URL di destinazione su una stringa vuota.
Se si dispone di un modulo che contiene un pulsante di invio e un pulsante di calcolo (con uno script corrispondente eseguito sul server), è possibile definire a livello di programmazione l’URL al quale viene inviato il modulo per eseguire lo script. Utilizzare il pulsante di invio nella struttura del modulo per specificare l’URL a cui vengono inviati i dati del modulo. (Vedi Calcolo dei dati del modulo.)
Invece di specificare un valore URL per fare riferimento a un file XDP, puoi anche passare un com.adobe.idp.Document
al servizio Forms. La com.adobe.idp.Document
l’istanza contiene una struttura del modulo. (Vedi Trasmissione di documenti al servizio Forms.)
Allegare file al modulo
È possibile allegare file a un modulo. Quando si esegue il rendering di un modulo PDF con allegati di file, gli utenti possono recuperare gli allegati di file in Acrobat utilizzando il riquadro allegato. È possibile allegare diversi tipi di file a un modulo, ad esempio un file di testo, o a un file binario come un file JPG.
L’allegato a un modulo di file è facoltativo.
Rendering di un modulo PDF interattivo
Per eseguire il rendering di un modulo, utilizzare una struttura del modulo creata in Designer e salvata come file XDP o PDF. È inoltre possibile eseguire il rendering di un modulo creato con Acrobat e salvato come file PDF. Per eseguire il rendering di un modulo PDF interattivo, richiamare l’ FormsServiceClient
dell’oggetto renderPDFForm
metodo o renderPDFForm2
metodo .
La renderPDFForm
utilizza URLSpec
oggetto. La directory principale del contenuto del file XDP viene passata al servizio Forms utilizzando URLSpec
dell’oggetto setContentRootURI
metodo . Nome della struttura del modulo ( formQuery
) viene passato come valore di parametro separato. I due valori vengono concatenati per ottenere il riferimento assoluto alla struttura del modulo.
La renderPDFForm2
accetta un com.adobe.idp.Document
istanza che contiene il documento XDP o PDF di cui eseguire il rendering.
Impossibile impostare l’opzione di esecuzione di PDF con tag se il documento di input è un documento di PDF. Se il file di input è un file XDP, è possibile impostare l’opzione PDF con tag.
Eseguire il rendering di un modulo PDF interattivo utilizzando l’API Forms (Java):
Includi file di progetto
Includi file JAR client, come adobe-forms-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client Forms
ServiceClientFactory
oggetto contenente le proprietà di connessione.FormsServiceClient
utilizzando il relativo costruttore e passando ServiceClientFactory
oggetto.Specificare i valori URI
URLSpec
oggetto che memorizza i valori URI utilizzando il relativo costruttore.URLSpec
dell’oggetto setApplicationWebRoot
e passare un valore stringa che rappresenta la radice Web dell'applicazione.URLSpec
dell’oggetto setContentRootURI
e passare un valore stringa che specifica il valore URI della directory principale del contenuto. Verificare che la struttura del modulo si trovi nell’URI della directory principale del contenuto. In caso contrario, il servizio Forms genera un'eccezione. Per fare riferimento alla directory archivio, specificare repository:///
.URLSpec
dell’oggetto setTargetURL
e passare un valore stringa che specifica il valore dell'URL di destinazione in cui vengono inviati i dati del modulo. Se si definisce l’URL di destinazione nella struttura del modulo, è possibile passare una stringa vuota. È inoltre possibile specificare l’URL a cui viene inviato un modulo per eseguire i calcoli.Allegare file al modulo
Crea un java.util.HashMap
per memorizzare gli allegati di file utilizzando il relativo costruttore.
Richiama il java.util.HashMap
dell’oggetto put
metodo per ciascun file da allegare al modulo di cui è stato effettuato il rendering. Passa i seguenti valori a questo metodo:
A com.adobe.idp.Document
oggetto contenente l'allegato del file.
Ripetere questo passaggio per ogni file da allegare al modulo. Questo passaggio è facoltativo e può essere superato null
* se non si desidera inviare allegati di file.*
Rendering di un modulo PDF interattivo
Richiama il FormsServiceClient
dell’oggetto renderPDFForm
e passare i seguenti valori:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.com.adobe.idp.Document
oggetto contenente i dati da unire al modulo. Se non si desidera unire i dati, passare un valore vuoto com.adobe.idp.Document
oggetto.PDFFormRenderSpec
oggetto che memorizza le opzioni di esecuzione. Si tratta di un parametro facoltativo ed è possibile specificare null
se non si desidera specificare le opzioni di esecuzione.URLSpec
oggetto che contiene i valori URI richiesti dal servizio Forms.java.util.HashMap
oggetto che memorizza gli allegati di file. Si tratta di un parametro facoltativo ed è possibile specificare null
se non si desidera allegare file al modulo.La renderPDFForm
restituisce un FormsResult
oggetto che contiene un flusso di dati del modulo che deve essere scritto nel browser Web client.
Scrivere il flusso di dati del modulo sul browser Web client
com.adobe.idp.Document
richiamando l'oggetto FormsResult
oggetto ‘s getOutputContent
metodo .com.adobe.idp.Document
richiamandone l'oggetto getContentType
metodo .javax.servlet.http.HttpServletResponse
tipo di contenuto dell’oggetto richiamandone il tipo setContentType
e passare il tipo di contenuto com.adobe.idp.Document
oggetto.javax.servlet.ServletOutputStream
oggetto utilizzato per scrivere il flusso di dati del modulo nel browser Web client richiamando il javax.servlet.http.HttpServletResponse
dell’oggetto getOutputStream
metodo .java.io.InputStream
richiamando l'oggetto com.adobe.idp.Document
dell’oggetto getInputStream
metodo .InputStream
dell’oggetto read
e passare l'array di byte come argomento.javax.servlet.ServletOutputStream
dell’oggetto write
per inviare il flusso di dati del modulo al browser Web client. Passa l'array di byte al write
metodo .Eseguire il rendering di un modulo PDF interattivo utilizzando l’API Forms (servizio Web):
Includi file di progetto
Creare un oggetto API client Forms
Crea un FormsService
e impostare i valori di autenticazione.
Specificare i valori URI
URLSpec
oggetto che memorizza i valori URI utilizzando il relativo costruttore.URLSpec
dell’oggetto setApplicationWebRoot
e passare un valore stringa che rappresenta la radice Web dell'applicazione.URLSpec
dell’oggetto setContentRootURI
e passare un valore stringa che specifica il valore URI della directory principale del contenuto. Verificare che la struttura del modulo si trovi nell’URI della directory principale del contenuto. In caso contrario, il servizio Forms genera un'eccezione. Per fare riferimento alla directory archivio, specificare repository:///
.URLSpec
dell’oggetto setTargetURL
e passare un valore stringa che specifica il valore dell'URL di destinazione in cui vengono inviati i dati del modulo. Se si definisce l’URL di destinazione nella struttura del modulo, è possibile passare una stringa vuota. È inoltre possibile specificare l’URL a cui viene inviato un modulo per eseguire i calcoli.Allegare file al modulo
Crea un java.util.HashMap
per memorizzare gli allegati di file utilizzando il relativo costruttore.
Richiama il java.util.HashMap
dell’oggetto put
metodo per ciascun file da allegare al modulo di cui è stato effettuato il rendering. Passa i seguenti valori a questo metodo:
A BLOB
oggetto contenente l'allegato del file
Ripetere questo passaggio per ogni file da allegare al modulo.
Rendering di un modulo PDF interattivo
Richiama il FormsService
dell’oggetto renderPDFForm
e passare i seguenti valori:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.BLOB
oggetto contenente i dati da unire al modulo. Se non si desidera unire i dati, passare null
.PDFFormRenderSpec
oggetto che memorizza le opzioni di esecuzione. Si tratta di un parametro facoltativo ed è possibile specificare null
se non si desidera specificare le opzioni di esecuzione.URLSpec
oggetto che contiene i valori URI richiesti dal servizio Forms.java.util.HashMap
oggetto che memorizza gli allegati di file. Si tratta di un parametro facoltativo ed è possibile specificare null
se non si desidera allegare file al modulo.com.adobe.idp.services.holders.BLOBHolder
oggetto popolato dal metodo . Viene utilizzato per memorizzare il modulo PDF di cui è stato eseguito il rendering.javax.xml.rpc.holders.LongHolder
oggetto popolato dal metodo . Questo argomento memorizza il numero di pagine nel modulo.javax.xml.rpc.holders.StringHolder
oggetto popolato dal metodo . Questo argomento memorizza il valore delle impostazioni internazionali.com.adobe.idp.services.holders.FormsResultHolder
oggetto che conterrà i risultati dell'operazione.La renderPDFForm
popola il com.adobe.idp.services.holders.FormsResultHolder
oggetto passato come ultimo valore argomento con un flusso di dati del modulo che deve essere scritto nel browser Web client.
Scrivere il flusso di dati del modulo sul browser Web client
FormResult
ottenendo il valore del com.adobe.idp.services.holders.FormsResultHolder
dell’oggetto value
membro dati.BLOB
oggetto che contiene i dati del modulo richiamando il FormsResult
dell’oggetto getOutputContent
metodo .BLOB
richiamandone l'oggetto getContentType
metodo .javax.servlet.http.HttpServletResponse
tipo di contenuto dell’oggetto richiamandone il tipo setContentType
e passare il tipo di contenuto BLOB
oggetto.javax.servlet.ServletOutputStream
oggetto utilizzato per scrivere il flusso di dati del modulo nel browser Web client richiamando il javax.servlet.http.HttpServletResponse
dell’oggetto getOutputStream
metodo .BLOB
dell’oggetto getBinaryData
metodo . Questa attività assegna il contenuto del FormsResult
all'array di byte.javax.servlet.http.HttpServletResponse
dell’oggetto write
per inviare il flusso di dati del modulo al browser Web client. Passa l'array di byte al write
metodo .Scrivere il flusso di dati del modulo sul browser Web client
Quando il servizio Forms esegue il rendering di un modulo, 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.