Show Menu
THEMEN×

Erstellen eines benutzerdefinierten Profils für HTML5-Formulare

A profile is a resource node 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. A profile node exists in the /content folder in the JCR repository. You can place the node directly under the /content folder or any subfolder of the /content folder.
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-Anforderungen. 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.

Erstellen von benutzerdefinierten Profilen

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

Profilknoten erstellen

  1. Navigate to the CRX DE interface at the URL: https://[server]:[port]/crx/de and log in to the interface with administrator credentials.
  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. In the left pane, navigate to the /apps folder.
  2. Right-click on the /apps folder and choose to create a folder with name hrform .
  3. Insider the hrform folder create a folder named demo .
  4. Klicken Sie auf die Schaltfläche Alle speichern .
  5. Navigate to /libs/xfaforms/profile/html.jsp and copy the node html.jsp .
  6. Paste html.jsp node into the /apps/hrform/demo folder created above with same name html.jsp and click Save .
  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. To verify that th profile is created, open 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.