Rendering di HTML Forms con CustomToolbars rendering-html-forms-with-customtoolbars
Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.
Rendering di HTML Forms con barre degli strumenti personalizzate rendering-html-forms-with-custom-toolbars
Il servizio Forms consente di personalizzare una barra degli strumenti di cui viene eseguito il rendering con un modulo di HTML. È possibile personalizzare una barra degli strumenti per modificarne l’aspetto ignorando gli stili CSS predefiniti e per aggiungere un comportamento dinamico ignorando gli script Java. Una barra degli strumenti viene personalizzata utilizzando un file XML denominato fscmenu.xml. Per impostazione predefinita, il servizio Forms recupera il file da un percorso URI specificato internamente.
È possibile copiare il file fscmenu.xml da questa posizione, modificarlo in base alle proprie esigenze e quindi inserirlo in una posizione URI personalizzata. Quindi, utilizzando l’API del servizio Forms, imposta le opzioni di runtime che fanno sì che il servizio Forms utilizzi il file fscmenu.xml dalla posizione specificata. Il servizio Forms esegue il rendering di un modulo HTML con una barra degli strumenti personalizzata.
Oltre al file fscmenu.xml, è necessario ottenere i seguenti file:
- fscmenu.js
- fscattachments.js
- fscmenu.css
- fscmenu-v.css
- fscmenu-ie.css
- fscdialog.css
fscJS è lo script Java associato a ciascun nodo. È necessario fornirne uno per il div#fscmenu
e facoltativamente per ul#fscmenuItem
nodi. I file JS implementano le funzionalità principali della barra degli strumenti e funzionano i file predefiniti.
fscCSS è un foglio di stile associato a un nodo specifico. Gli stili nei file CSS specificano l'aspetto della barra degli strumenti. fscVCSS è un foglio di stile per una barra degli strumenti verticale, visualizzato a sinistra del modulo di rendering di HTML. fscIECSS è un foglio di stile utilizzato per i moduli di HTML di cui viene eseguito il rendering in Internet Explorer.
Verificare che nel file fscmenu.xml sia presente un riferimento a tutti i file sopra indicati. In altre parole, nel file fscmenu.xml, specificare i percorsi URI per puntare a questi file in modo che il servizio Forms possa individuarli. Per impostazione predefinita, questi file sono disponibili nelle posizioni URI a partire dalle parole chiave interne FSWebRoot
o ApplicationWebRoot
.
Per personalizzare la barra degli strumenti, sostituire le parole chiave utilizzando la parola chiave external FSToolBarURI
. Questa parola chiave rappresenta l’URI passato al servizio Forms in fase di esecuzione (questo approccio viene illustrato più avanti in questa sezione).
Puoi anche specificare le posizioni assolute di questi file JS e CSS, ad esempio https://www.mycompany.com/scripts/misc/fscmenu.js. In questa situazione, non è necessario utilizzare il FSToolBarURI
parola chiave.
FSToolBarURI
parola chiave o posizione assoluta.Per ottenere i file JS e CSS, apri la scheda Adobe-forms-<appserver>file .ear. All’interno di questo file, apri adobe-forms-res.war. Tutti questi file sono nel file WAR. Il modulo Adobe-forms-<appserver>Il file .ear si trova nella cartella di installazione di AEM forms (C:\ è la directory di installazione). È possibile aprire la<appserver>.ear utilizzando uno strumento di estrazione file come WinRAR.
La sintassi XML seguente mostra un esempio di file fscmenu.xml.
<div id="fscmenu" fscJS="FSToolBarURI/scripts/fscmenu.js" fscCSS="FSToolBarURI/fscmenu.css" fscVCSS="FSToolBarURI/fscmenu-v.css" fscIECSS="FSToolBarURI/fscmenu-ie.css">
<ul class="fscmenuItem" id="Home">
<li>
<a href="#" fscTarget="_top" tabindex="1">Home</a>
</li>
</ul>
<ul class="fscmenuItem" id="Upload" fscJS="FSToolBarURI/scripts/fscattachments.js" fscCSS="FSToolBarURI/fscdialog.css">
<li>
<a tabindex="2">Upload Attachments</a>
<ul class="fscmenuPopup" id="fscUploadAttachments">
<li>
<a href="javascript:doUploadDialog();" tabindex="3">Add ...</a>
</li>
<li>
<a href="javascript:doDeleteDialog();" tabindex="4">Delete ...</a>
</li>
</ul>
</li>
</ul>
<ul class="fscmenuItem" id="Download">
<li>
<a tabindex="100">Download Attachments</a>
<ul class="fscmenuPopup">
<li>
<a tabindex="101">None available</a>
</li>
</ul>
</li>
</ul>
</div>
Gli elementi seguenti descrivono come personalizzare una barra degli strumenti:
- Modificare i valori di
fscJS
,fscCSS
,fscVCSS
,fscIECSS
attributi (nel file fscmenu.xml) per riflettere le posizioni personalizzate dei file di riferimento utilizzando uno dei metodi descritti in questa sezione (ad esempio,fscJS="FSToolBarURI/scripts/fscmenu.js"
). - Specificare tutti i file CSS e JS. Se nessuno dei file viene modificato, fornisci quello predefinito nel percorso personalizzato. È possibile ottenere i file predefiniti aprendo vari file come descritto in questa sezione.
- È consentito fornire un riferimento assoluto (ad esempio, https://www.example.com/scripts/custom-vertical-fscmenu.css) per qualsiasi file.
- I file JS e CSS che
div#fscmenu
I requisiti dei nodi sono essenziali per la funzionalità della barra degli strumenti. Individualeul#fscmenuItem
i nodi possono avere o meno file JS o CSS supportati.
Modifica del valore locale
Durante la personalizzazione di una barra degli strumenti, è possibile modificare il valore locale della barra degli strumenti. In altre parole, è possibile visualizzarlo in un'altra lingua. La figura seguente mostra una barra degli strumenti personalizzata visualizzata in francese.
Per modificare il valore locale di una barra degli strumenti, verificare che il file fscmenu.xml contenga la lingua che si desidera visualizzare. La sintassi XML seguente mostra il file fscmenu.xml utilizzato per visualizzare una barra degli strumenti francese.
<div id="fscmenu" fscJS="FSToolBarURI/scripts/fscmenu.js" fscCSS="FSToolBarURI/fscmenu.css" fscVCSS="FSToolBarURI/fscmenu-v.css" fscIECSS="FSToolBarURI/fscmenu-ie.css">
<ul class="fscmenuItem" id="Home">
<li>
<a href="#" fscTarget="_top" tabindex="1">Accueil</a>
</li>
</ul>
<ul class="fscmenuItem" id="Upload" fscJS="FSToolBarURI/scripts/fscattachments.js" fscCSS="FSToolBarURI/fscdialog.css">
<li>
<a tabindex="2">Télécharger les pièces jointes</a>
<ul class="fscmenuPopup" id="fscUploadAttachments">
<li>
<a href="javascript:doUploadDialog();" tabindex="3">Ajouter...</a>
</li>
<li>
<a href="javascript:doDeleteDialog();" tabindex="4">Supprimer...</a>
</li>
</ul>
</li>
</ul>
<ul class="fscmenuItem" id="Download">
<li>
<a tabindex="100">Télécharger les pièces jointes</a>
<ul class="fscmenuPopup">
<li>
<a tabindex="101">Aucune disponible</a>
</li>
</ul>
</li>
</ul>
</div>
Inoltre, specifica un valore valido per le impostazioni locali richiamando HTMLRenderSpec
dell'oggetto setLocale
e passando un valore stringa che specifica il valore locale. Ad esempio, pass fr_FR
per specificare il francese. Il servizio Forms è fornito con barre degli strumenti localizzate.
Per ulteriori informazioni sul servizio Forms, consulta Guida di riferimento dei servizi per AEM Forms.
Riepilogo dei passaggi summary-of-steps
Per eseguire il rendering di un modulo di HTML contenente una barra degli strumenti personalizzata, eseguire le operazioni seguenti:
- Includi file di progetto.
- Crea un oggetto API Java di Forms.
- Fai riferimento a un file XML fscmenu personalizzato.
- Eseguire il rendering di un modulo HTML.
- Scrivere il flusso di dati del modulo 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 si utilizzano servizi Web, includere i file proxy.
Creare un oggetto API Java di Forms
Prima di poter eseguire a livello di programmazione un'operazione supportata dal servizio Forms, è necessario creare un oggetto client Forms.
Riferimento a un file XML fscmenu personalizzato
Per eseguire il rendering di un modulo HTML contenente una barra degli strumenti personalizzata, fare riferimento a un file XML fscmenu che descrive la barra degli strumenti. In questa sezione vengono forniti due esempi di file XML fscmenu. Verificare inoltre che il file fscmenu.xml specifichi correttamente le posizioni di tutti i file di riferimento. Come accennato in precedenza in questa sezione, accertati che in una delle due opzioni sia presente un riferimento a tutti i file FSToolBarURI
parola chiave o le relative posizioni assolute.
Rendering di un modulo HTML
Per eseguire il rendering di un modulo di HTML, specificare una struttura di modulo creata in Designer e salvata come file XDP. Selezionate anche un tipo di trasformazione HTML. È ad esempio possibile specificare il tipo di trasformazione HTML che esegue il rendering di un HTML dinamico per Internet Explorer 5.0 o versione successiva.
Il rendering di un modulo HTML richiede anche valori, ad esempio valori URI per il rendering di altri tipi di modulo.
Scrivere il flusso di dati del modulo nel browser Web client
Quando il servizio Forms esegue il rendering di un modulo HTML, restituisce un flusso di dati del modulo che è necessario scrivere nel browser Web client per rendere il modulo HTML visibile agli utenti.
Consulta anche
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 HTML con una barra degli strumenti personalizzata utilizzando l’API Java render-an-html-form-with-a-custom-toolbar-using-the-java-api
Esegui il rendering di un modulo HTML contenente una barra degli strumenti personalizzata utilizzando l’API dei servizi 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 Java di Forms
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
FormsServiceClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Riferimento a un file XML fscmenu personalizzato
- Creare un
HTMLRenderSpec
mediante il costruttore. - Per eseguire il rendering di un modulo HTML con una barra degli strumenti, richiamare
HTMLRenderSpec
dell'oggettosetHTMLToolbar
e passa unHTMLToolbar
valore enum. Ad esempio, per visualizzare una barra degli strumenti HTML verticale, passareHTMLToolbar.Vertical
. - Specificare la posizione del file XML fscmenu richiamando il
HTMLRenderSpec
dell'oggettosetToolbarURI
e passando un valore stringa che specifica la posizione URI del file XML. - Se applicabile, impostare il valore locale richiamando
HTMLRenderSpec
dell'oggettosetLocale
e passando un valore stringa che specifica il valore locale. Il valore predefinito è Inglese.
note note NOTE La Guida introduttiva associata a questa sezione imposta questo valore su fr_FR
. - Creare un
-
Rendering di un modulo HTML
Richiama
FormsServiceClient
dell'oggettorenderHTMLForm
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
TransformTo
valore enum che specifica il tipo di preferenza HTML. Ad esempio, per eseguire il rendering di un modulo di HTML compatibile con dynamic HTML per Internet Explorer 5.0 o versione successiva, specificareTransformTo.MSDHTML
. - A
com.adobe.idp.Document
oggetto contenente dati da unire con il modulo. Se non desideri unire i dati, passa un campo vuotocom.adobe.idp.Document
oggetto. - Il
HTMLRenderSpec
oggetto che memorizza le opzioni di runtime di HTML. - Un valore stringa che specifica il
HTTP_USER_AGENT
valore dell’intestazione, comeMozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
. - A
URLSpec
oggetto che memorizza i valori URI necessari per il rendering di un modulo HTML. - A
java.util.HashMap
oggetto che memorizza gli allegati. Questo è un parametro facoltativo e puoi specificarenull
se non si desidera allegare file al modulo.
Il
renderHTMLForm
il metodo restituisce unFormsResult
oggetto contenente un flusso di dati modulo che deve essere scritto nel browser web client. - 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
-
Scrivere il flusso di dati del modulo nel browser Web client
- Creare un
com.adobe.idp.Document
oggetto richiamando ilFormsResult
oggetto "sgetOutputContent
metodo. - Ottieni il tipo di contenuto del
com.adobe.idp.Document
oggetto richiamando il relativogetContentType
metodo. - Imposta il
javax.servlet.http.HttpServletResponse
tipo di contenuto dell'oggetto richiamando il relativosetContentType
e passando il tipo di contenuto delcom.adobe.idp.Document
oggetto. - Creare un
javax.servlet.ServletOutputStream
oggetto utilizzato per scrivere il flusso di dati del modulo nel browser web client richiamandojavax.servlet.http.HttpServletResponse
dell'oggettogetOutputStream
metodo. - Creare un
java.io.InputStream
oggetto richiamando ilcom.adobe.idp.Document
dell'oggettogetInputStream
metodo. - Creare una matrice di byte e popolarla con il flusso di dati del modulo richiamando
InputStream
dell'oggettoread
e passando la matrice di byte come argomento. - Richiama
javax.servlet.ServletOutputStream
dell'oggettowrite
metodo per inviare il flusso di dati del modulo al browser web client. Passare la matrice di byte alwrite
metodo.
- Creare un
Consulta anche
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Rendering di un modulo HTML con una barra degli strumenti personalizzata tramite l’API del servizio web rendering-an-html-form-with-a-custom-toolbar-using-the-web-service-api
Esegui il rendering di un modulo di HTML contenente una barra degli strumenti personalizzata utilizzando l’API dei servizi Forms (servizio web):
-
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 Java di Forms
Creare un
FormsService
e impostare i valori di autenticazione. -
Riferimento a un file XML fscmenu personalizzato
- Creare un
HTMLRenderSpec
mediante il costruttore. - Per eseguire il rendering di un modulo HTML con una barra degli strumenti, richiamare
HTMLRenderSpec
dell'oggettosetHTMLToolbar
e passa unHTMLToolbar
valore enum. Ad esempio, per visualizzare una barra degli strumenti HTML verticale, passareHTMLToolbar.Vertical
. - Specificare la posizione del file XML fscmenu richiamando il
HTMLRenderSpec
dell'oggettosetToolbarURI
e passando un valore stringa che specifica la posizione URI del file XML. - Se applicabile, impostare il valore locale richiamando
HTMLRenderSpec
dell'oggettosetLocale
e passando un valore stringa che specifica il valore locale. Il valore predefinito è Inglese.
note note NOTE La Guida introduttiva associata a questa sezione imposta questo valore su fr_FR
. - Creare un
-
Rendering di un modulo HTML
Richiama
FormsService
dell'oggettorenderHTMLForm
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
TransformTo
valore enum che specifica il tipo di preferenza HTML. Ad esempio, per eseguire il rendering di un modulo di HTML compatibile con dynamic HTML per Internet Explorer 5.0 o versione successiva, specificareTransformTo.MSDHTML
. - A
BLOB
oggetto contenente dati da unire con il modulo. Se non si desidera unire i dati, passarenull
. - Il
HTMLRenderSpec
oggetto che memorizza le opzioni di runtime di HTML. - Un valore stringa che specifica il
HTTP_USER_AGENT
valore dell’intestazione, comeMozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322
). Se non si desidera impostare questo valore, è possibile passare una stringa vuota. - A
URLSpec
oggetto che memorizza i valori URI necessari per il rendering di un modulo HTML. - A
java.util.HashMap
oggetto che memorizza gli allegati. Questo parametro è facoltativo ed è possibile specificarenull
se non si desidera allegare file al modulo. - Un campo vuoto
com.adobe.idp.services.holders.BLOBHolder
oggetto popolato darenderHTMLForm
metodo. Questo valore di parametro memorizza il modulo di cui è stato eseguito il rendering. - Un campo vuoto
com.adobe.idp.services.holders.BLOBHolder
oggetto popolato darenderHTMLForm
metodo. Questo parametro memorizza i dati XML di output. - Un campo vuoto
javax.xml.rpc.holders.LongHolder
oggetto popolato darenderHTMLForm
metodo. Questo argomento memorizza il numero di pagine nel modulo. - Un campo vuoto
javax.xml.rpc.holders.StringHolder
oggetto popolato darenderHTMLForm
metodo. Questo argomento memorizza il valore locale. - Un campo vuoto
javax.xml.rpc.holders.StringHolder
oggetto popolato darenderHTMLForm
metodo. Questo argomento memorizza il valore di rendering HTML utilizzato. - Un campo vuoto
com.adobe.idp.services.holders.FormsResultHolder
oggetto che conterrà i risultati dell'operazione.
Il
renderHTMLForm
il metodo compilacom.adobe.idp.services.holders.FormsResultHolder
oggetto passato come ultimo valore di argomento con un flusso di dati del modulo che deve essere scritto nel browser web client. - 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
-
Scrivere il flusso di dati del modulo nel browser Web client
- Creare un
FormResult
dell'oggetto ottenendo il valore delcom.adobe.idp.services.holders.FormsResultHolder
dell'oggettovalue
membro dati. - Creare un
BLOB
oggetto che contiene i dati del modulo richiamandoFormsResult
dell'oggettogetOutputContent
metodo. - Ottieni il tipo di contenuto del
BLOB
oggetto richiamando il relativogetContentType
metodo. - Imposta il
javax.servlet.http.HttpServletResponse
tipo di contenuto dell'oggetto richiamando il relativosetContentType
e passando il tipo di contenuto delBLOB
oggetto. - Creare un
javax.servlet.ServletOutputStream
oggetto utilizzato per scrivere il flusso di dati del modulo nel browser web client richiamandojavax.servlet.http.HttpServletResponse
dell'oggettogetOutputStream
metodo. - Creare una matrice di byte e popolarla richiamando il
BLOB
dell'oggettogetBinaryData
metodo. Questa attività assegna il contenuto delFormsResult
alla matrice di byte. - Richiama
javax.servlet.http.HttpServletResponse
dell'oggettowrite
metodo per inviare il flusso di dati del modulo al browser web client. Passare la matrice di byte alwrite
metodo.
- Creare un
Consulta anche
Richiamare AEM Forms utilizzando la codifica Base64