DocumentazioneAEM 6.5Guida utente

Creazione di un profilo personalizzato per i moduli HTML5 creating-a-custom-profile-for-html-forms

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Amministratore
  • Utente
  • Sviluppatore

Un profilo è un nodo di risorsa in Apache Sling. Rappresenta la versione personalizzata del servizio di rendering di HTML5 forms. È possibile utilizzare il servizio di rendering dei moduli HTML5 per personalizzare l'aspetto, il comportamento e le interazioni dei moduli HTML5. Nella cartella /content dell'archivio JCR esiste un nodo di profilo. È possibile inserire il nodo direttamente nella cartella /content o in una sottocartella della cartella /content.

Il nodo del profilo ha la proprietà sling:resourceSuperType e il valore predefinito è xfaforms/profile. Lo script di rendering per il nodo si trova in /libs/xfaforms/profile.

Gli script Sling sono script JSP. Questi script JSP fungono da contenitori per la creazione del HTML per il modulo richiesto e gli artefatti JS/CSS richiesti. Questi script Sling sono anche denominati script di rendering del profilo. Il modulo di rendering dei profili chiama il servizio Forms OSGi per eseguire il rendering del modulo richiesto.

Lo script di profilo si trova in html.jsp e html.POST.jsp per le richieste GET e POST. Puoi copiare e modificare uno o più file per ignorare e aggiungere le personalizzazioni. Non apportare modifiche sul posto; tali modifiche vengono sovrascritte dall’aggiornamento della patch.

Un profilo contiene vari moduli. I moduli sono formRuntime.jsp, config.jsp, toolbar.jsp, formBody.jsp, nav_footer.jsp e footer.jsp.

formRuntime.jsp formruntime-jsp-br

I moduli formRuntime.jsp contengono riferimenti alle librerie client. Vengono inoltre illustrati i metodi per estrarre le informazioni sulle impostazioni internazionali dalla richiesta e includere i messaggi localizzati nella richiesta. Puoi includere libs o stili JavaScript personalizzati in formRuntime.jsp.

config.jsp config-jsp

Il modulo config.jsp contiene varie configurazioni come la registrazione, i servizi proxy e la versione del comportamento. Puoi aggiungere la tua configurazione e personalizzazione del widget al modulo config.jsp. Puoi anche aggiungere al modulo config.jsp configurazioni quali la registrazione di widget personalizzati.

toolbar.jsp toolbar-jsp

Il file toolbar.jsp contiene codice per creare una barra degli strumenti colorata. Per rimuovere la barra degli strumenti, rimuovere toolbar.jsp da HTML.jsp

formBody.jsp formbody-jsp

Il modulo formBody.jsp serve per la rappresentazione HTML del modulo XFA.

Inizialmente, il modulo HTML5 esegue il rendering solo della prima pagina del modulo. Quando un utente fa scorrere il modulo, viene caricato il resto dei moduli. Rende l’esperienza di caricamento più veloce. Il componente nav_footer.jsp contiene tutti gli stili e gli elementi necessari per facilitare il caricamento delle pagine durante lo scorrimento.

footer.jsp footer-jsp

Il modulo footer.jsp è vuoto. Ti consente di aggiungere script utilizzati solo per l’interazione dell’utente.

Creazione di profili personalizzati creating-custom-profiles

Per creare un profilo personalizzato, effettua le seguenti operazioni:

Crea nodo profilo create-profile-node

  1. Passare all'interfaccia CRX DE all'URL https://'[server]:[port]'/crx/de e accedere all'interfaccia con le credenziali di amministratore.

  2. Nel riquadro sinistro passare alla posizione /content/xfaforms/profiles.

  3. Copia il nodo predefinito e incolla il nodo in una cartella diversa (/content/profiles) con nome hrform.

  4. Seleziona il nuovo nodo, hrform, quindi aggiungi una proprietà stringa: sling:resourceType con valore: hrform/demo.

  5. Fare clic su Salva tutto nel menu della barra degli strumenti per salvare le modifiche.

Creare lo script del renderer del profilo create-the-profile-renderer-script

Dopo aver creato un profilo personalizzato, aggiungi le informazioni di rendering a questo profilo. Quando si riceve una richiesta per il nuovo profilo, CRX verifica l’esistenza della cartella /apps per la pagina JSP di cui eseguire il rendering. Crea la pagina JSP nella cartella /apps.

  1. Nel riquadro sinistro passare alla cartella /apps.

  2. Fare clic con il pulsante destro del mouse sulla cartella /apps e scegliere di creare una cartella denominata hrform.

  3. Nella cartella hrform creare una cartella denominata demo.

  4. Fare clic sul pulsante Salva tutto.

  5. Passare a /libs/xfaforms/profile/html.jsp e copiare il nodo html.jsp.

  6. Incolla il nodo html.jsp nella cartella /apps/hrform/demo creata in precedenza con lo stesso nome html.jsp e fai clic su Salva.

  7. Se hai altri componenti dello script di profilo, segui i passaggi 1-6 per copiare i componenti nella cartella /apps/hrform/demo.

  8. Per verificare che il profilo sia stato creato, aprire l'URL https://'[server]:[port]'/content/xfaforms/profiles/hrform.html

Per verificare i moduli, Importa i moduli dal file system locale in AEM Forms e visualizza l'anteprima del modulo nell'istanza di authoring del server AEM.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2