Aktivieren der Kernkomponenten für adaptive Formulare in AEM 6.5 Forms enable-adaptive-forms-core-components
Durch Aktivieren der Kernkomponenten für adaptive Formulare können Sie mit der Erstellung, Veröffentlichung und Bereitstellung von auf Kernkomponenten basierenden adaptiven Formularen und adaptiven Headless-Formularen aus Ihrer AEM 6.5 Forms-Umgebung beginnen.
Um Kernkomponenten für adaptive Formulare in Ihrer AEM 6.5 Forms-Umgebung zu aktivieren, richten Sie ein auf AEM Archetyp 41 oder höher basierendes Projekt ein und stellen Sie es (mit aktivierten Formularoptionen) für all Ihre Autoren- und Veröffentlichungsinstanzen bereit.
Dieser Artikel enthält detaillierte Anweisungen zum Einrichten und Bereitstellen von einem auf AEM Archetyp 41 oder höher basierenden Projekt in der AEM 6.5 Forms-Umgebung, um die Kernkomponenten für adaptive Formulare zu aktivieren. In der nachstehenden Liste finden Sie für AEM 6.5 kompatible Versionen zur Aktivierung der Kernkomponenten für Formulare:
Voraussetzungen prerequisites
Vor der Aktivierung von Kernkomponenten für adaptive Formulare in der AEM 6.5 Forms-Umgebung:
-
Nehmen Sie ein Upgrade auf AEM 6.5 Forms Service Pack 16 (6.5.16.0) oder höher vor.
-
Installieren Sie die neueste Version von Apache Maven.
-
Installieren Sie einen Nur-Text-Editor. Beispielsweise Microsoft Visual Studio Code.
Erstellen Sie ein auf dem neuesten AEM Archetyp basierendes Projekt und stellen Sie es bereit
So erstellen Sie ein auf AEM Archetyp 41 oder höher basierendes Projekt und stellen es für alle Authoring- und Publishing-Instanzen bereit:
-
Melden Sie sich bei Ihrem Computer an, hosten Sie Ihre AEM 6.5 Forms-Instanz und führen Sie sie als Administrator aus.
-
Öffnen Sie die Eingabeaufforderung oder das Terminal und führen Sie den folgenden Befehl aus, um ein AEM Archetyp-Projekt zu erstellen (mit aktivierten Formularoptionen):
- Microsoft Windows
code language-shell mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate ^ -D archetypeGroupId=com.adobe.aem ^ -D archetypeArtifactId=aem-project-archetype ^ -D archetypeVersion=41 ^ -D appTitle="My Form" ^ -D appId="myform" ^ -D groupId="com.myform" ^ -D includeFormsenrollment="y" ^ -D aemVersion="6.5.15"
- Linux oder Apple macOS
code language-shell mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \ -D archetypeGroupId=com.adobe.aem \ -D archetypeArtifactId=aem-project-archetype \ -D archetypeVersion=41 \ -D appTitle="My Form" \ -D appId="myform" \ -D groupId="com.myform" \ -D includeFormsenrollment="y" \ -D aemVersion="6.5.15"
Beachten Sie beim Ausführen des oben genannten Befehls die folgenden Punkte:
-
Ändern Sie nicht den Wert der Eigenschaft
aemVersion
von6.5.15.0
auf einen anderen Wert. -
Legen Sie die Eigenschaft
archetypeVersion
auf41
oder höher fest. Die neueste Version finden Sie im Abschnitt „Systemanforderungen“ in der Dokumentation zum AEM Projektarchetyp. -
Aktualisieren Sie den Befehl, um die spezifischen Werte für Ihre Umgebung widerzuspiegeln, einschließlich
appTitle
,appId
undgroupId
. Legen Sie außerdem den Wert der EigenschaftincludeFormsenrollment
aufy
fest. Wenn Sie Forms Portal verwenden, legen Sie die OptionincludeExamples=y
fest, um die Kernkomponenten von Forms Portal in Ihr Projekt aufzunehmen.
-
(Nur für Projekte, die auf dem Archetyp Version 41 basieren) Nachdem das AEM-Archetyp-Projekt erstellt wurde, aktivieren Sie Designs für auf Kernkomponenten basierende adaptive Formulare. So aktivieren Sie Designs:
-
Öffnen Sie den [AEM-Archetyp-Projektordner]/ui.apps/src/main/content/jcr_root/apps/appId/components/adaptiveForm/page/customheaderlibs.html zur Bearbeitung:
-
Fügen Sie in Zeile 21 den folgenden Code hinzu:
code language-xml <sly data-sly-use.clientlib="core/wcm/components/commons/v1/templates/clientlib.html" data-sly-use.formstructparser="com.adobe.cq.forms.core.components.models.form.FormStructureParser" data-sly-test.themeClientLibRef="${formstructparser.themeClientLibRefFromFormContainer}"> <sly data-sly-test="${themeClientLibRef}" data-sly-call="${clientlib.css @ categories=themeClientLibRef}"/> </sly>
-
Speichern und schließen Sie die Datei.
-
-
Aktualisieren Sie das Projekt, um die neueste Version der Forms-Kernkomponenten einzuschließen:
-
Öffnen Sie den [AEM-Archetyp-Projektordner]/pom.xml zur Bearbeitung.
-
Legen Sie die Version von
core.forms.components.version
undcore.forms.components.af.version
auf die aktuelle Version der Kernkomponenten für Formulare fest und stellen Sie sicher, dass beide dieselbe Version haben wie die in der Tabelle angegebenen Kernkomponenten für Formulare. Legen Sie die Version voncore.wcm.components.version
gemäß der WCM-Kernkomponenten fest.note warning WARNING - Wenn Sie ein Archetyp-Projekt mit Version 45 erstellen, setzt
[AEM Archetype Project Folder]/pom.xml
zunächst die Version der Formular-Kernkomponenten auf 1.1.28. Aktualisieren Sie vor dem Erstellen oder Bereitstellen des Archetyp-Projekts die Version der Formular-Kernkomponenten auf 1.1.26. Die neueste Version finden Sie im Versionsverlauf von AEM 6.5 Forms.
note note NOTE - Wenn Sie eine andere Topologie einrichten, stellen Sie sicher, dass Sie die URLs für Übermitteln, Vorausfüllen und andere Funktionen auf der Dispatcher-Ebene in die Zulassungsliste eintragen.
- Wenn Sie ein Archetyp-Projekt mit Version 45 erstellen, setzt
-
Speichern und schließen Sie die Datei.
-
-
Nachdem das AEM-Archetyp-Projekt erfolgreich erstellt wurde, erstellen Sie das Bereitstellungspaket für Ihre Umgebung. Erstellen des Pakets:
-
Navigieren Sie zum Stammverzeichnis Ihres AEM-Archetyp-Projekts.
-
Führen Sie den folgenden Befehl aus, um das AEM-Archetyp-Projekt für Ihre Umgebung zu erstellen:
code language-shell mvn clean install
Nachdem das AEM-Archetyp-Projekt erfolgreich erstellt wurde, wird ein AEM-Paket generiert. Sie finden das Paket im [AEM-Archetyp-Projektordner]\all\target[appid].all-[version].zip
-
-
Verwenden Sie den Package Manager zur Bereitstellung des Pakets [AEM-Archetyp-Projektordner]\all\target[appid].all-[version].zip auf allen Authoring- und Publishing-Instanzen.
- Falls Sie Schwierigkeiten haben, den Anmeldedialog auf einer Veröffentlichungsinstanz aufzurufen, um das Paket über den Package Manager zu installieren, versuchen Sie, sich über die URL
http://[Publish Server URL]:[PORT]/system/console
anzumelden. Auf diese Weise können Sie auf die Anmeldeseite bei der Veröffentlichungsinstanz zugreifen, sodass Sie mit dem Installationsprozess fortfahren können. - Löschen oder verwerfen Sie das Archetyp-Projekt nicht, nachdem Sie es in Ihrer Umgebung bereitgestellt haben. Das Archetyp-Projekt ist erforderlich, um Ihrer Umgebung benutzerdefinierte und neue Kernkomponenten-Designs für adaptive Formulare hinzuzufügen.
Die Kernkomponenten sind für Ihre Umgebung aktiviert. Eine leere, auf Kernkomponenten basierende Vorlage für ein adaptives Formular und ein Canvas 3.0-Design werden in Ihrer Umgebung bereitgestellt, sodass Sie auf Kernkomponenten basierende adaptive Formulare erstellen können.
Häufig gestellte Fragen
Was sind Kernkomponenten?
Die Kernkomponenten sind eine Reihe standardisierter Web-Content-Management-Komponenten (WCM) für AEM, um die Entwicklungszeit zu verkürzen und die Wartungskosten Ihrer Websites zu senken.
Welche Funktionen werden durch die Aktivierung der Kernkomponenten hinzugefügt?
Wenn die Kernkomponenten für adaptive Formulare für Ihre Umgebung aktiviert sind, werden Ihrer Umgebung eine leere, auf Kernkomponenten basierende Vorlage für adaptive Formulare und ein Canvas 3.0-Design hinzugefügt. Nachdem Sie die Kernkomponenten der adaptiven Formulare für Ihre Umgebung aktiviert haben, können Sie Folgendes tun:
- Erstellen Sie adaptive Formulare auf Grundlage der Kernkomponenten.
- Erstellen Sie Vorlagen für adaptive Formulare auf Grundlage der Kernkomponenten.
- Erstellen Sie benutzerdefinierte Vorlagen-Designs für adaptive Formulare auf Grundlage der Kernkomponenten.
- Stellen Sie JSON-Darstellungen adaptiver Formulare auf Grundlage der Kernkomponenten für Kanäle wie Mobile, Web, native Apps und Dienste bereit, die eine Headless-Darstellung des Formulars erfordern.
Wie geht es weiter
- Erstellen eines auf Kernkomponenten basierenden adaptiven Formulars
- Erstellen oder Hinzufügen eines adaptiven Formulars zu einer AEM Sites-Seite oder einem Experience Fragment
- Erstellen von Designs für auf Kernkomponenten basierende adaptive Formulare
- Erstellen einer Vorlage für auf Kernkomponenten basierende adaptive Formulare