Erstellen eines benutzerdefinierten Profils für HTML5-Formulare

Ein Profil ist ein Ressourcenknoten in Apache Sling. Es enthält eine benutzerdefinierte Version des HTML5-Formularen-Render-Dienstes. Sie können den HTML5-Formularwiedergabedienst verwenden, um Erscheinungsbild, Verhalten und Interaktionen der HTML5-Formulare anzupassen. Im Ordner /content im JCR-Repository befindet sich ein Profil-Knoten. Sie können den Knoten direkt unter dem Ordner /content oder einem beliebigen Unterordner des Ordners /content platzieren.

Der Profilknoten hat die sling:resourceSuperType-Eigenschaft und der Standardwert ist xfaforms/profile. Das Render-Skript für den Knoten ist unter /libs/xfaforms/profile verfügbar.

Die Sling-Skripte sind JSP-Skripte. Diese JSP-Skripte dienen als Container für den HTML-Code für das angeforderte Formular und die erforderlichen JS-/CSS-Artefakte. Die Sling-Skripte werden auch als Profil-Renderer-Skripte bezeichnet. Der Profil-Renderer ruft den Forms OSGi-Dienst auf, um das angeforderte Formular wiederzugeben.

Das Profil-Skript befindet sich in html.jsp und html.POST.jsp für GET- und POST-Anfragen. Sie können eine oder mehrere Dateien kopieren und verändern, um Ihre Anpassungen zu überschreiben. Nehmen Sie keine ersetzenden Änderungen vor, da diese Änderungen durch das Patch-Update überschrieben werden.

Ein Profil enthält verschiedenen Module. Die Module sind formRuntime.jsp, config.jsp, toolbar.jsp, formBody.jsp, nav_footer.jsp und footer.jsp.

formRuntime.jsp

Die Module formRuntime.jsp enthalten Verweise auf die Clientbibliotheken. Sie stellen außerdem Methoden dar, um Gebietsschema-Informationen von einer Anforderung zu extrahieren und lokalisierte Nachrichten in die Anforderung einzufügen. Sie können eigene benutzerdefinierte JavaScript-Bibliotheken oder -Stile in formRuntime.jsp einschließen.

config.jsp

Das config.jsp-Modul enthält verschiedene Konfigurationen wie Protokollierung, Proxy-Dienste und Verhaltensversion. Sie können Ihre eigene benutzerdefinierte Konfiguration und das benutzerdefinierte Widget zum config.jsp-Modul hinzufügen. Sie können auch Konfigurationen wie benutzerdefinierte Widget-Registrierung zum config.jsp-Modul hinzufügen.

toolbar.jsp

Die toolbar.jsp enthält Code zum Erstellen einer farbigen Symbolleiste. Um die Symbolleiste zu entfernen, müssen Sie toolbar.jsp aus der html.jsp entfernen.

formBody.jsp

Das Modul formBody.jsp dient zur HTML-Darstellung des XFA-Formulars.

Zunächst rendert das HTML5-Formular nur die erste Seite des Formulars. Wenn ein Benutzer das Formular scrollt, wird der Rest des Formulars geladen. Dadurch wird der Ladevorgang verkürzt. Die Komponente „nav_footer.jsp“ enthält alle Stile und erforderlichen Elemente, um das schrittweise Laden der Seiten beim Scrollen zu erleichtern.

Das Modul „footer.jsp“ ist leer. Sie können Skripten hinzufügen, die nur für die Benutzerinteraktion verwendet werden.

Erstellen von benutzerdefinierten Profilen

Um ein benutzerdefiniertes Profil zu erstellen, führen Sie die folgenden Schritte aus:

Profilknoten erstellen

  1. Navigieren Sie zur CRX DE-Schnittstelle unter der URL: https://'[server]:[port]'/crx/de und melden Sie sich mit Administratorberechtigungen bei der Schnittstelle an.

  2. Im linken Fensterbereich navigieren Sie zum Speicherort: /content/xfaforms/profiles.

  3. Kopieren Sie „node default“ und fügen Sie den Knoten in einen anderen Ordner (/content/profiles) mit dem Namen hrform ein.

  4. Wählen Sie den neuen Knoten hrform und fügen Sie eine String-Eigenschaft hinzu: sling:resourceType mit dem Wert: hrform/demo.

  5. Klicken Sie im Symbolleistenmenü auf Alle speichern, um die Änderungen zu speichern.

Das Profil-Renderer-Skript erstellen

Nachdem Sie ein benutzerdefiniertes Profil erstellt haben, fügen Sie Render-Informationen zu diesem Profil hinzu. Nach Erhalt einer Anfrage für das neue Profil prüft CRX das Vorhandensein des Ordners „/apps“, damit die JSP-Seite wiedergegeben werden kann. Erstellen Sie die JSP-Seite im Ordner „/apps“.

  1. Navigieren Sie im linken Bereich zum Ordner /apps.

  2. Klicken Sie mit der rechten Maustaste auf den Ordner /apps und wählen Sie einen Ordner mit dem Namen hrform.

  3. Erstellen Sie im Ordner hrform einen Ordner mit dem Namen demo.

  4. Klicken Sie auf die Schaltfläche Alle speichern.

  5. Navigieren Sie zu /libs/xfaforms/profile/html.jsp und kopieren Sie den Knoten html.jsp.

  6. Fügen Sie den Knoten html.jsp in den Ordner /apps/hrform/demo ein, der oben mit demselben Namen html.jsp erstellt wurde, und klicken Sie auf Speichern.

  7. Wenn Sie andere Profil-Skript-Komponenten haben, führen Sie die Schritte 1-6 aus, um die Komponenten in den Ordner „/apps/hrform/demo“ zu kopieren.

  8. Um zu überprüfen, ob das Profil erstellt wurde, öffnen Sie die URL https://'[server]:[port]'/content/xfaforms/profiles/hrform.html

Um Ihre Formulare zu überprüfen, Importieren Sie Ihre Formulare aus Ihrem lokalen Dateisystem in AEM Forms und zeigen Sie eine Vorschau des Formulars in der Autoreninstanz des AEM-Servers an.

Auf dieser Seite

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now