Überprüfen und Aktivieren von Kernkomponenten für adaptive Formulare enable-headless-adaptive-forms-on-aem-forms-cloud-service
Kernkomponenten für adaptive Formulare und adaptive Headless-Formulare sind für die meisten Kundinnen und Kunden von AEM Forms as a Cloud Service bereits aktiviert. Dadurch können Sie auf Kernkomponenten basierende adaptive Formulare und Headless-Formulare mithilfe Ihrer AEM Forms Cloud Service-Instanzen auf mehreren Kanälen erstellen, veröffentlichen und bereitstellen.
Überprüfen, ob Kernkomponenten für adaptive Formulare aktiviert sind check-if-enabled
Bevor Sie Aktivierungsschritte ausführen, überprüfen Sie, ob Kernkomponenten für adaptive Formulare bereits für Ihre Umgebung aktiviert sind:
Für neue AEM Forms as a Cloud Service-Programme
Wenn Sie ein neues AEM Forms as a Cloud Service-Programm erstellen, sind Kernkomponenten für adaptive Formularen und adaptiven Headless-Formulare bereits für Ihre Umgebung aktiviert.
Für bestehende Cloud Service-Umgebungen
Wenn Ihre bestehende Cloud Service-Umgebung die Option zum Erstellen von auf Kernkomponenten basierenden adaptiven Formularen bereitstellt, sind Kernkomponenten für adaptive Formulare und adaptive Headless-Formulare bereits für Ihre Umgebung aktiviert.
Überprüfen des Repositorys
So finden Sie heraus, ob Kernkomponenten für adaptive Formulare für Ihre Umgebung aktiviert sind:
-
Klonen Sie Ihr AEM Forms as a Cloud Service-Repository.
-
Öffnen Sie die Datei
[AEM Repository Folder]/all/pom.xml
Ihres AEM Forms as a Cloud Service-Git-Repositorys. -
Suchen Sie nach den folgenden Abhängigkeiten:
- core-forms-components-af-core
- core-forms-components-core
- core-forms-components-apps
- core-forms-components-af-apps
- core-forms-components-examples-apps
- core-forms-components-examples-content
Wenn diese Abhängigkeiten vorhanden sind, sind Kernkomponenten für adaptive Formulare für Ihre Umgebung aktiviert.
Wenn eine manuelle Aktivierung erforderlich ist when-manual-enablement-needed
Nur wenn Sie über ein älteres Forms as a Cloud Service-Programm verfügen, in dem Kernkomponenten nicht aktiviert sind (bestätigt durch die obige Überprüfung), müssen Sie Ihrem AEM as a Cloud Service-Repository Abhängigkeiten von Kernkomponenten für adaptive Formulare manuell hinzufügen und das Repository in Ihren Cloud Service-Umgebungen bereitstellen.
note warning |
---|
WARNING |
Führen Sie diese Schritte nur aus, wenn die obige Verifizierungsprüfung bestätigt, dass Kernkomponenten für adaptive Formulare für Ihre Umgebung NICHT aktiviert sind. |
Führen Sie die folgenden Schritte in der angegebenen Reihenfolge aus, um Kernkomponenten für adaptive Formulare und adaptive Headless-Formulare für eine AEM Forms as a Cloud Service-Umgebung zu aktivieren:
1. Klonen Sie Ihr AEM Forms as a Cloud Service-Git-Repository clone-git-repository
-
Melden Sie sich bei Cloud Manager an und wählen Sie Ihre Organisation und Ihr Programm aus.
-
Navigieren Sie von Ihrer Programmübersichtsseite zur Karte Pipelines und klicken Sie auf die Schaltfläche Zugriff auf Repo Info, um auf Ihr Git-Repository zuzugreifen und es zu verwalten. Die Seite enthält die folgenden Informationen:
- Die URL zum Git-Repository von Cloud Manager.
- Anmeldeinformationen des Git-Repositorys (Benutzername und Password), Git-Benutzername.
Klicken Sie auf Kennwort generieren, um das Kennwort anzuzeigen oder zu generieren.
-
Öffnen Sie das Terminal oder eine Eingabeaufforderung auf Ihrem lokalen Computer und führen Sie den folgenden Befehl aus:
code language-shell git clone [Git Repository URL]
Geben Sie bei Aufforderung die Anmeldeinformationen ein. Das Repository wird auf Ihrem lokalen Computer geklont.
2. Hinzufügen von Abhängigkeiten von Kernkomponenten für adaptive Formulare zu Ihrem Git-Repository add-adaptive-forms-core-components-dependencies
-
Öffnen Sie Ihren Git-Repository-Ordner in einem einfachen Texteditor. Beispiel: VS Code.
-
Öffnen Sie die Datei
[AEM Repository Folder]\pom.xml
, um sie zu bearbeiten. -
Ersetzen Sie die Versionen der Komponenten
core.forms.components.version
,core.forms.components.af.version
undcore.wcm.components.version
durch die in der Dokumentation zu Kernkomponenten angegebenen Versionen. Wenn die Komponente nicht vorhanden ist, fügen Sie diese Komponenten hinzu.code language-xml <!-- Replace the version with the latest released version at https://github.com/adobe/aem-core-forms-components/tags --> <properties> <core.wcm.components.version>2.22.10</core.wcm.components.version> <core.forms.components.version>2.0.18</core.forms.components.version> <core.forms.components.af.version>2.0.18</core.forms.components.af.version> </properties>
-
Fügen Sie im Abschnitt „Abhängigkeiten“ der Datei
[AEM Repository Folder]\pom.xml
die folgenden Abhängigkeiten hinzu und speichern Sie die Datei.code language-xml <!-- WCM Core Component Examples Dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <version>${core.wcm.components.version}</version> <type>zip</type> </dependency> <!-- End of WCM Core Component Examples Dependencies --> <!-- Forms Core Component Dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <!-- End of AEM Forms Core Component Dependencies -->
-
Öffnen Sie die Datei
[AEM Repository Folder]/all/pom.xml
, um sie zu bearbeiten. Fügen Sie die folgenden Abhängigkeiten in den Abschnitt<embeddeds>
ein und speichern Sie die Datei.code language-xml <!-- WCM Core Component Examples Dependencies --> <!-- inside plugin config of filevault-package-maven-plugin --> <!-- embed wcm core components examples artifacts --> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <!-- embed forms core components artifacts --> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded>
note note NOTE Ersetzen Sie ${appId}
durch Ihre appId.Um Ihre ${appId}
zu finden, suchen Sie in der Datei[AEM Repository Folder]/all/pom.xml
den Begriff-packages/application/install
. Der Text vor dem Begriff-packages/application/install
ist Ihre${appId}
. Der folgende Codemyheadlessform
ist zum Beispiel${appId}
.code language-none com.myheadlessform myheadlessform.ui.apps zip /apps/myheadlessform-packages/application install
-
Fügen Sie im Abschnitt
<dependencies>
der Datei[AEM Repository Folder]/all/pom.xml
die folgenden Abhängigkeiten hinzu und speichern Sie die Datei:code language-xml <!-- Other existing dependencies --> <!-- wcm core components examples dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> </dependency> <!-- forms core components dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> </dependency>
-
Öffnen Sie
[AEM Repository Folder]/ui.apps/pom.xml
zur Bearbeitung. Fügen Sie die Abhängigkeitaf-core bundle
hinzu und speichern Sie die Datei.code language-xml <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> </dependency>
note note NOTE Achten Sie darauf, dass die folgenden Artefakte der Kernkomponenten von adaptiven Formularen nicht in Ihr Projekt eingeschlossen werden. <dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-apps</artifactId>
</dependency>
und <dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-core</artifactId>
</dependency>
-
Speichern und schließen Sie die Datei.
3. Erstellen und Bereitstellen des aktualisierten Codes
Stellen Sie den aktualisierten Code in Ihren lokalen Entwicklungs- und Cloud Service-Umgebungen bereit, um die Kernkomponenten in beiden Umgebungen zu aktivieren:
Erstellen und Bereitstellen von aktualisiertem Code in einer lokalen Entwicklungsumgebung core-components-on-aem-forms-local-sdk
-
Öffnen Sie die Eingabeaufforderung oder das Terminal.
-
Navigieren Sie zum Stammverzeichnis Ihres Git-Repository-Projekts.
-
Führen Sie den folgenden Befehl aus, um das Paket für Ihre Umgebung zu erstellen:
code language-shell mvn clean install
Nachdem das Paket erfolgreich erstellt wurde, finden Sie es unter [Git-Repository-Ordner]\all\target[appid].all-[version].zip
-
Verwenden Sie den Package Manager, um das Paket [AEM Archetyp-Projektordner]\all\target[appid].all-[version].zip in der lokalen Entwicklungsumgebung bereitzustellen.
Erstellen und Bereitstellen von aktualisiertem Code in einer AEM Forms as a Cloud Service-Umgebung core-components-on-aem-forms-cs
-
Öffnen Sie das Terminal oder die Eingabeaufforderung.
-
Navigieren Sie zu Ihrem
[AEM Repository Folder]
und führen Sie die folgenden Befehle in der angegebenen Reihenfolge auscode language-shell git add pom.xml git add all/pom.xml git add ui.apps/pom.xml git commit -m "Added dependencies for Adaptive Forms Core Components" git push origin
-
Nachdem die Dateien in das Git-Repository übertragen wurden, führen Sie die Pipeline aus.
Nach erfolgreicher Ausführung der Pipeline sind die Kernkomponenten für adaptive Formulare für die entsprechende Umgebung aktiviert. Außerdem werden Ihrer Forms as a Cloud Service-Umgebung eine Vorlage für adaptive Formulare (Kernkomponenten) sowie ein Design für Canvas 3.0 hinzugefügt, was Ihnen Optionen zum Anpassen und Erstellen von Kernkomponenten auf Basis von adaptiven Formularen bietet.
Häufig gestellte Fragen faq
Was sind Kernkomponenten? core-components
Die Kernkomponenten sind eine Reihe standardisierter WCM-Komponenten (Web Content Management) für AEM, mit denen Sie die Entwicklungszeiten verkürzen und die Wartungskosten für Ihre Web-Seiten senken können.
Welche Funktionen werden hinzugefügt, wenn Kernkomponenten aktiviert sind? core-components-capabilities
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 für adaptive Formulare für Ihre Umgebung aktiviert haben, können Sie Folgendes tun:
- Kernkomponenten-basierte adaptive Formulare erstellen.
- Vorlagen für Kernkomponenten-basierte adaptive Formulare erstellen.
- Benutzerdefinierte Designs für Kernkomponenten-basierte adaptive Formulare erstellen.
- JSON-Darstellungen für Kernkomponenten-basierte adaptive Formulare in Kanälen wie Mobilgeräten, Web- und nativen Apps und Diensten bereitstellen, für die die Headless-Darstellung eines Formulars erforderlich ist.
Woher weiß ich, ob ich Kernkomponenten für adaptive Formulare manuell aktivieren muss? manual-enablement-needed-faq
Bei den meisten Kundinnen und Kunden sind Kernkomponenten für adaptive Formulare bereits aktiviert. Sie müssen sie nur manuell aktivieren, wenn:
- Sie über ein Forms as a Cloud Service-Programm verfügen, dass erstellt wurde, bevor Kernkomponenten automatisch einbezogen wurden
- Die Verifizierung im Abschnitt Überprüfen, ob Kernkomponenten für adaptive Formulare aktiviert sind bestätigt, dass die erforderlichen Abhängigkeiten im Repository fehlen
Wenn Sie sich nicht sicher sind, befolgen Sie die Verifizierungsschritte im obigen Abschnitt Überprüfen, ob Kernkomponenten für adaptive Formulare aktiviert sind.
Warum können auf Kernkomponenten basierende Formulare nicht in einem Projekt gerendert werden?
Auf Kernkomponenten basierende Formulare können aufgrund einer Versionsabweichung zwischen dem Paket „Forms-Kernkomponenten“ und der im Projektarchetyp enthaltenen Version nicht gerendert werden. Dieses Problem tritt in der Regel auf, wenn die im Projektarchetyp angegebene Version gleich oder höher als die im Paket „Forms-Kernkomponenten“ enthaltene Version ist. Um dieses Problem zu beheben, führen Sie eine der folgenden Aktionen aus:
- Verwenden Sie eine niedrigere Version des Paket „Forms-Kernkomponenten“ im Projektarchetyp.
- Entfernen Sie die Abhängigkeit „Forms-Kernkomponenten“ aus dem Projektarchetyp, da die erforderliche Version bereits in AEM as a Cloud Service enthalten ist. Das Paket „Forms-Kernkomponenten“ ist ab Version 20133, z. B.
AEM SDK v2025.3.20133.20250325T063357Z-250300
, im Lieferumfang von AEM as a Cloud SDK enthalten.