Rendern einer Formularvorlage für HTML5-Formulare rendering-form-template-for-html-forms
Rendern des Endpunktes render-endpoint
HTML5-Formulare umfassen das Konzept der Profile, die als REST-Endpunkte bereitgestellt werden, um Formularvorlagen auf Mobilgeräten rendern zu können. Diese Profile sind mit einem Profile Renderer verknüpft. Es handelt sich um JSP-Seiten, auf denen Formulare im HTML-Format generiert werden. Dazu werden Forms OSGi-Services aufgerufen. Der JCR-Pfad des Profilknotens bestimmt die URL des Render-Endpunktes. Der Standard-Render-Endpunkt des Formulars, der auf das „Standard“-Profil verweist, sieht wie folgt aus:
https://<Host>:<Port>/content/xfaforms/profiles/default.html?contentRoot=<Pfad des Ordners mit der Formular-XDP>&template=<Name der XDP>
Beispiel: http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=c:/xdps&template=sampleForm.xdp
Bei einem benutzerdefinierten Profil ändert sich der Endpunkt entsprechend. Der Endpunkt für das benutzerdefinierte Profil mit dem Namen „hrforms“ lautet beispielsweise:
http://localhost:4502/content/xfaforms/profiles/hrforms.html?contentRoot=c:/xdps&template=sampleForm.xdp
Wenn sich die Vorlage im AEM-Repository in einer Anwendung namens FormSubmission befindet, lautet die URI:
http://localhost:4502/content/xfaforms/profiles/default.html?
contentRoot=crx:///content/dam/formsanddocuments/FormSubmission/1.0
&template=sampleForm.xdp
Render-Parameter render-parameters
Die beim Rendern des Formulars als HTML unterstützten Anforderungsparameter lauten wie folgt:
Zusammenführen von Daten mit einer Formularvorlage merge-data-with-form-template
Übergabe des Render-Parameters passing-the-render-parameter
HTML5-Formulare unterstützen drei Methoden zum Übergeben der Render-Parameter. Sie können Parameter über URLs, Schlüssel-Wert-Paare und Profilknoten übergeben. Im Render-Parameter hat das Schlüssel-Wert-Paar die höchste Priorität, gefolgt vom Profilknoten. Der URL-Anforderungsparameter erhält die geringste Priorität.
-
URL-Anfrageparameter: Sie können die Render-Parameter in der URL angeben. In den URL-Anfrageparametern sind die Parameter für Endbenutzende sichtbar. Beispielsweise enthält die folgende Sende-URL die Vorlagenparameter in der URL:
http://localhost:4502/content/xfaforms/profiles/default.html?contentRoot=/Applications/FormSubmission/1.0&template=sampleForm.xdp
-
SetAttribute-Anforderungsparameter: Sie können die Render-Parameter als Schlüssel-Wert-Paar angeben. In den SetAttribute-Anforderungsparametern sind die Parameter für Endbenutzende nicht sichtbar. Sie können eine Anforderung von einem beliebigen anderen JSP an den JSP des Profil-Renderers für HTML5-Formulare weiterleiten und als Anforderungsobjekt setAttribute verwenden, um alle Render-Parameter zu übergeben. Diese Methode hat die höchste Priorität.
-
Profilknoten-Anforderungsparameter: Sie können die Render-Parameter als Knoteneigenschaften eines Profilknotens angeben. In den Anforderungsparametern des Profilknotens sind die Parameter für Endbenutzende nicht sichtbar. Der Profilknoten ist der Knoten, an den die Anfrage gesendet wird. Um Parameter als Knoteneigenschaften festzulegen, verwenden Sie CRXDE Lite.
Absenden von Parametern submit-parameters
HTML5-Formulare senden Daten und führen serverseitige Skripte und Webdienste auf AEM-Servern aus. Ausführliche Informationen zu Parametern, die zum Ausführen Server-seitiger Skripts und Web-Dienste auf AEM-Servern verwendet werden, finden Sie unter HTML5-Formular-Service-Proxy.