Rendering di Forms basato su frammenti

Rendering di Forms basato su frammenti

Il servizio Forms può eseguire il rendering dei moduli basati sui frammenti creati con Designer. A frammento è una parte riutilizzabile di un modulo e viene salvata come file XDP separato che può essere inserito in più strutture del modulo. Ad esempio, un frammento può includere un blocco indirizzo o testo legale.

L’utilizzo dei frammenti semplifica e velocizza la creazione e la manutenzione di un numero elevato di moduli. Durante la creazione di un nuovo modulo, è possibile inserire un riferimento al frammento desiderato e il frammento viene visualizzato nel modulo. Il riferimento al frammento contiene un sottomodulo che punta al file XDP fisico. Per informazioni sulla creazione di strutture del modulo basate sui frammenti, vedere Forms Designer

Un frammento può includere diversi sottomoduli racchiusi in un set sottomodulo selezionato. I set sottomodulo selezionati controllano la visualizzazione dei sottomoduli in base al flusso di dati da una connessione dati. È possibile utilizzare le istruzioni condizionali per determinare quale sottomodulo all’interno del set viene visualizzato nel modulo consegnato. Ad esempio, ogni sottomodulo di un set può includere informazioni relative a una particolare posizione geografica; il sottomodulo visualizzato può essere determinato in base alla posizione dell’utente.

A frammento di script contiene funzioni JavaScript riutilizzabili o valori memorizzati separatamente da qualsiasi oggetto specifico, ad esempio analisi delle date o chiamata a un servizio Web. Questi frammenti includono un singolo oggetto script visualizzato come elemento secondario delle variabili nella palette Gerarchia. I frammenti non possono essere creati da script che sono proprietà di altri oggetti, ad esempio script di evento che eseguono operazioni di convalida, calcolo o inizializzazione.

Di seguito sono riportati i vantaggi dell’utilizzo dei frammenti:

• Riutilizzo dei contenuti: È possibile utilizzare i frammenti per riutilizzare il contenuto in più strutture del modulo. Se è necessario utilizzare parte dello stesso contenuto in più moduli, l’utilizzo di un frammento è più rapido e semplice rispetto alla copia o alla ricreazione del contenuto. L’uso dei frammenti assicura inoltre che le parti utilizzate di frequente in una struttura del modulo abbiano contenuto e aspetto uniformi in tutti i moduli di riferimento.
• Aggiornamenti globali: È possibile utilizzare i frammenti per apportare modifiche globali a più moduli una sola volta, in un unico file. È possibile modificare il contenuto, gli oggetti script, i binding dei dati, il layout o gli stili di un frammento, mentre tutti i moduli XDP che fanno riferimento al frammento rifletteranno le modifiche apportate.
• Ad esempio, un elemento comune in molti moduli potrebbe essere un blocco indirizzo che include un oggetto elenco a discesa per il paese. Se è necessario aggiornare i valori dell’oggetto elenco a discesa, è necessario aprire molti moduli per apportare le modifiche. Se si include il blocco indirizzo in un frammento, per apportare le modifiche è necessario aprire un solo file di frammento.
• Per aggiornare un frammento in un modulo PDF, è necessario salvare nuovamente il modulo in Designer.
• Creazione di moduli condivisi: È possibile utilizzare i frammenti per condividere la creazione di moduli tra diverse risorse. Gli sviluppatori di moduli che dispongono di conoscenze specifiche in materia di script o di altre funzioni avanzate di Designer possono sviluppare e condividere frammenti che sfruttano le proprietà dinamiche e di script. I progettisti di moduli possono utilizzare tali frammenti per configurare le strutture del modulo e per garantire che tutte le parti di un modulo abbiano aspetto e funzionalità uniformi in più moduli progettati da più persone.

Assemblaggio di una struttura del modulo assemblata utilizzando i frammenti

È possibile assemblare una struttura del modulo da passare al servizio Forms in base a più frammenti. Per assemblare più frammenti, utilizzare il servizio Assembler. Per visualizzare un esempio di utilizzo del servizio Assemble per creare una struttura del modulo utilizzata da un altro servizio Forms (il servizio Output), vedere Creazione di documenti PDF tramite frammenti. Invece di utilizzare il servizio Output, puoi eseguire lo stesso flusso di lavoro utilizzando il servizio Forms.

Quando si utilizza il servizio Assembler, si passa una struttura del modulo assemblata utilizzando i frammenti. La struttura del modulo creata non fa riferimento ad altri frammenti. In questo argomento viene invece discusso il passaggio al servizio Forms di una struttura del modulo che fa riferimento ad altri frammenti. Tuttavia, la struttura del modulo non è stata assemblata da Assembler. È stato creato in Designer.

Riepilogo dei passaggi

Per eseguire il rendering di un modulo basato su frammenti, eseguire le operazioni seguenti:

1. Includi file di progetto.
2. Creare un oggetto API client Forms.
3. Specificare i valori URI.
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.

Specificare i valori URI

Per eseguire correttamente il rendering di un modulo basato su frammenti, è necessario assicurarsi che il servizio Forms sia in grado di individuare sia il modulo che i frammenti (file XDP) a cui fa riferimento la struttura del modulo. Ad esempio, si supponga che il modulo sia denominato PO.xdp e che in questo modulo siano utilizzati due frammenti denominati FooterUS.xdp e FooterCanada.xdp. In questa situazione, il servizio Forms deve essere in grado di individuare tutti e tre i file XDP.

È possibile organizzare un modulo e i relativi frammenti inserendo il modulo in un’unica posizione e i frammenti in un’altra posizione oppure inserendo tutti i file XDP nella stessa posizione. Ai fini di questa sezione, si supponga che tutti i file XDP si trovino nell’archivio AEM Forms. Per informazioni sul posizionamento di file XDP nell’archivio AEM Forms, vedi Scrittura delle risorse.

Quando si esegue il rendering di un modulo basato su frammenti, è necessario fare riferimento solo al modulo stesso e non ai frammenti. Ad esempio, è necessario fare riferimento a PO.xdp e non a FooterUS.xdp o FooterCanada.xdp. Assicurati di posizionare i frammenti in un percorso in cui il servizio Forms possa individuarli.

Rendering del modulo

È possibile eseguire il rendering di un modulo basato su frammenti allo stesso modo dei moduli non frammentati. In altre parole, è possibile eseguire il rendering del modulo come Guida di PDF, HTML o modulo (obsoleto). Nell’esempio riportato in questa sezione viene eseguito il rendering di un modulo basato sui frammenti come modulo interattivo di PDF. (Vedi Rendering di PDF forms interattivi.)

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.

Consulta anche

Rendering di moduli basati su frammenti utilizzando l’API Java

Rendering di moduli basati su frammenti utilizzando l’API del servizio Web

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API di Forms Service

Rendering di PDF forms interattivi

Creazione di applicazioni Web per il rendering di Forms

Rendering di moduli basati su frammenti utilizzando l’API Java

Eseguire il rendering di un modulo basato su frammenti 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

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

3. Specificare i valori URI

   • Crea un URLSpec oggetto che memorizza i valori URI utilizzando il relativo costruttore.
   • Richiama il URLSpec dell’oggetto setApplicationWebRoot e passare un valore stringa che rappresenta la radice Web dell'applicazione.
   • Richiama il 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 e i frammenti si trovino nell’URI della directory principale del contenuto. In caso contrario, il servizio Forms genera un'eccezione. Per fare riferimento alla directory archivio, specificare repository://.
   • Richiama il 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.

4. Rendering del modulo

   Richiama il FormsServiceClient dell’oggetto renderPDFForm e passare 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 del modulo che fa parte di un'applicazione Forms, verificare di specificare il percorso completo, ad esempio Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
   • A 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.
   • A PDFFormRenderSpec oggetto che memorizza le opzioni di esecuzione.
   • A URLSpec oggetto contenente valori URI richiesti dal servizio Forms per il rendering di un modulo basato su frammenti.
   • A 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.

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

   • Crea un com.adobe.idp.Document richiamando l'oggetto FormsResult oggetto ‘s getOutputContent metodo .
   • Ottieni il tipo di contenuto del com.adobe.idp.Document richiamandone l'oggetto getContentType metodo .
   • Imposta la javax.servlet.http.HttpServletResponse tipo di contenuto dell’oggetto richiamandone il tipo setContentType e passare il tipo di contenuto com.adobe.idp.Document oggetto.
   • Crea un 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 .
   • Crea un java.io.InputStream richiamando l'oggetto com.adobe.idp.Document dell’oggetto getInputStream metodo .
   • Creare un array di byte popolarlo con il flusso di dati del modulo richiamando il InputStream dell’oggetto reade passare l'array di byte come argomento.
   • Richiama il 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 .

Consulta anche

Rendering di Forms basato su frammenti

Avvio rapido (modalità SOAP): Rendering di un modulo basato su frammenti utilizzando l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Rendering di moduli basati su frammenti utilizzando l’API del servizio Web

Eseguire il rendering di un modulo basato su frammenti 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

   Crea un FormsService e impostare i valori di autenticazione.

3. Specificare i valori URI

   • Crea un URLSpec oggetto che memorizza i valori URI utilizzando il relativo costruttore.
   • Richiama il URLSpec dell’oggetto setApplicationWebRoot e passare un valore stringa che rappresenta la radice Web dell'applicazione.
   • Richiama il 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://.
   • Richiama il 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.

4. Rendering del modulo

   Richiama il FormsService dell’oggetto renderPDFForm e passare 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 del modulo che fa parte di un'applicazione Forms, verificare di specificare il percorso completo, ad esempio Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
   • A BLOB oggetto contenente i dati da unire al modulo. Se non si desidera unire i dati, passare null.
   • A PDFFormRenderSpec oggetto che memorizza le opzioni di esecuzione. L’opzione PDF con tag non può essere impostata se il documento di input è un documento di PDF. Se il file di input è un file XDP, è possibile impostare l’opzione PDF con tag.
   • A URLSpec oggetto che contiene i valori URI richiesti dal servizio Forms.
   • A 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.
   • Un vuoto com.adobe.idp.services.holders.BLOBHolder oggetto popolato dal metodo . Questo parametro viene utilizzato per memorizzare il modulo di cui è stato effettuato il rendering.
   • Un vuoto javax.xml.rpc.holders.LongHolder oggetto popolato dal metodo . Questo argomento memorizza il numero di pagine nel modulo.
   • Un vuoto javax.xml.rpc.holders.StringHolder oggetto popolato dal metodo . Questo argomento memorizza il valore delle impostazioni internazionali.
   • Un vuoto 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.

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

   • Crea un FormResult ottenendo il valore del com.adobe.idp.services.holders.FormsResultHolder dell’oggetto value membro dati.
   • Crea un BLOB oggetto che contiene i dati del modulo richiamando il FormsResult dell’oggetto getOutputContent metodo .
   • Ottieni il tipo di contenuto del BLOB richiamandone l'oggetto getContentType metodo .
   • Imposta la javax.servlet.http.HttpServletResponse tipo di contenuto dell’oggetto richiamandone il tipo setContentType e passare il tipo di contenuto BLOB oggetto.
   • Crea un 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 .
   • Creare un array di byte e compilarlo richiamando il BLOB dell’oggetto getBinaryData metodo . Questa attività assegna il contenuto del FormsResult all'array di byte.
   • Richiama il 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 .

Consulta anche

Rendering di Forms basato su frammenti

Richiamo di AEM Forms con codifica Base64

Risorse Business.Adobe.com

Personalized Experiences Responsive Forms Document Generation Content Management Headless Cms Digital Signage