Rendering di HTML Forms tramite file CSS personalizzati rendering-html-forms-using-custom-css-files
Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.
Il servizio Forms esegue il rendering dei moduli HTML in risposta a una richiesta HTTP da un browser web. Durante il rendering di un modulo HTML, il servizio Forms può fare riferimento a un file CSS personalizzato. Puoi creare un file CSS personalizzato per soddisfare i requisiti aziendali e fare riferimento a tale file CSS quando utilizzi il servizio Forms per il rendering dei moduli HTML.
Il servizio Forms analizza automaticamente il file CSS personalizzato. In altre parole, il servizio Forms non segnala gli errori che possono verificarsi se il file CSS personalizzato non è conforme agli standard CSS. In questa situazione, il servizio Forms ignora lo stile e continua con gli stili rimanenti nel file CSS.
L’elenco seguente specifica gli stili supportati in un file CSS personalizzato:
- Coppie di tipo selettore a livello di classe: se presenti in un file CSS personalizzato, vengono utilizzati i selettori utilizzati nel modulo HTML come stili di classe. Gli stili di classe non utilizzati vengono ignorati.
- Coppie stile selettore livello identificatore: vengono utilizzati tutti gli stili di identificatore, se presenti nel modulo HTML.
- Coppie stile selettore livello elemento: vengono utilizzati tutti gli stili di elemento, se presenti nel modulo HTML.
- Priorità stile: la priorità di stile (come importante) è supportata e può essere utilizzata in un file CSS personalizzato.
- Tipo di file multimediale: una o più coppie in stile selettore possono essere racchiuse in @media stile per definire il tipo di file multimediale. Il servizio Forms non verifica se il tipo di supporto specificato è supportato. Il tipo di file multimediale specificato nel file CSS personalizzato viene unito nel modulo HTML.
È possibile recuperare un file CSS di esempio utilizzando l'applicazione FormsIVS. Caricare il modulo, selezionarlo nella pagina Struttura modulo di prova e fare clic su GeneraCSS. Non è necessario impostare il tipo di trasformazione HTML prima di fare clic sul pulsante. Quindi seleziona Salva. Puoi modificare questo file CSS per soddisfare i requisiti aziendali.
Riepilogo dei passaggi summary-of-steps
Per eseguire il rendering di un modulo HTML che utilizza un file CSS, eseguire le operazioni seguenti:
- Includi file di progetto.
- Crea un oggetto API Java di Forms.
- Fai riferimento al file CSS.
- 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 utilizzi i servizi web, accertati di 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.
Fai riferimento al file CSS
Per eseguire il rendering di un modulo HTML che utilizza un file CSS personalizzato, accertati di fare riferimento a un file CSS esistente.
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. Selezionare 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, come i valori URI necessari 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 all'utente.
Consulta anche
Eseguire il rendering di un modulo HTML che utilizza un file CSS utilizzando l’API Java
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 che utilizza un file CSS utilizzando l’API Java render-an-html-form-that-uses-a-css-file-using-the-java-api
Esegui il rendering di un modulo HTML che utilizza un file CSS personalizzato utilizzando 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 Java di Forms
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
FormsServiceClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Fai riferimento al file CSS
- Creare un
HTMLRenderSpec
mediante il costruttore. - Per eseguire il rendering del modulo HTML che utilizza un file CSS personalizzato, richiama
HTMLRenderSpec
dell'oggettosetCustomCSSURI
e passa un valore stringa che specifica la posizione e il nome del file CSS.
- Creare un
-
Rendering di un modulo HTML
Richiama
FormsServiceClient
dell'oggetto(Deprecated) (Deprecated) renderHTMLForm
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
(Deprecated) 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
dell'oggettogetOutputContent
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.h\ttp.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
Rendering di HTML Forms tramite file CSS personalizzati
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Eseguire il rendering di un modulo HTML che utilizza un file CSS utilizzando l’API del servizio web render-an-html-form-that-uses-a-css-file-using-the-web-service-api
Esegui il rendering di un modulo HTML che utilizza un file CSS personalizzato utilizzando l’API 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. -
Fai riferimento al file CSS
- Creare un
HTMLRenderSpec
mediante il costruttore. - Per eseguire il rendering del modulo HTML che utilizza un file CSS personalizzato, richiama
HTMLRenderSpec
dell'oggettosetCustomCSSURI
e passa un valore stringa che specifica la posizione e il nome del file CSS.
- Creare un
-
Rendering di un modulo HTML
Richiama
FormsService
dell'oggetto(Deprecated) renderHTMLForm
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
. (vedere Precompilazione di Forms con layout fluibili.) - 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 è un parametro facoltativo e puoi specificarenull
se non si desidera allegare file al modulo. - Un campo vuoto
com.adobe.idp.services.holders.BLOBHolder
oggetto popolato da(Deprecated) renderHTMLForm
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 da(Deprecated) renderHTMLForm
metodo. Questo parametro memorizza i dati XML di output. - Un campo vuoto
javax.xml.rpc.holders.LongHolder
oggetto popolato da(Deprecated) renderHTMLForm
metodo. Questo argomento memorizza il numero di pagine nel modulo. - Un campo vuoto
javax.xml.rpc.holders.StringHolder
oggetto popolato da(Deprecated) renderHTMLForm
metodo. Questo argomento memorizza il valore locale. - Un campo vuoto
javax.xml.rpc.holders.StringHolder
oggetto popolato da(Deprecated) renderHTMLForm
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
(Deprecated) 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
Rendering di HTML Forms tramite file CSS personalizzati
Richiamare AEM Forms utilizzando la codifica Base64