Einrichten einer lokalen Entwicklungsumgebung und eines ersten Entwicklungsprojekts

Wenn Sie eine ​ Adobe Experience Manager Forms-as-a-​ Cloud Service-Umgebung einrichten und konfigurieren, richten Sie Entwicklungs-, Staging- und Produktionsumgebungen in der Cloud ein. Darüber hinaus können Sie auch eine lokale Entwicklungsumgebung einrichten und konfigurieren.

Sie können die lokale Entwicklungsumgebung verwenden, um die folgenden Aktionen durchzuführen, ohne sich bei der Cloud-Entwicklungsumgebung anzumelden:

Nachdem ein adaptives Formular oder zugehörige Elemente in der lokalen Entwicklungsinstanz oder in einem Programm zum Generieren der [Kundenkommunikation] bereit sind, können Sie das Programm mit dem adaptiven Formular oder der Kundenkommunikation aus der lokalen Entwicklungsumgebung in eine Cloud Service-Umgebung exportieren, um weitere Tests durchzuführen oder zu Produktionsumgebungen zu wechseln.

Sie können auch benutzerdefinierten Code wie benutzerdefinierte Komponenten und den Vorbefüllungs-Service in der lokalen Entwicklungsumgebung entwickeln und testen. Wenn der benutzerdefinierte Code getestet und bereit ist, können Sie das Git-Repository Ihrer Cloud Service-Entwicklungsumgebung verwenden, um den benutzerdefinierten Code bereitzustellen.

Um eine neue lokale Entwicklungsumgebung einzurichten und sie zur Entwicklung für Aktivitäten zu nutzen, führen Sie folgende Aktionen in angegebener Reihenfolge durch:

Voraussetzungen

Sie benötigen folgende Software, um eine lokale Entwicklungsumgebung einzurichten. Laden Sie diese herunter, bevor Sie mit der Einrichtung der lokalen Entwicklungsumgebung beginnen:

Software Beschreibung Downloadlinks
Adobe Experience Manager as a Cloud Service SDK SDK enthält Adobe Experience Manager-QuickStart- und -Dispatcher-Tools Laden Sie das neueste SDK von Software Distribution herunter.
Adobe Experience Manager Forms-Funktionsarchiv (AEM Forms-Add-on) Tools zum Erstellen, Gestalten und Optimieren adaptiver Formulare und anderer Adobe Experience Manager Forms-Funktionen Download aus Software Distribution
(Optional) Adobe Experience Manager Forms-Referenzinhalt Tools zum Erstellen, Gestalten und Optimieren adaptiver Formulare und anderer Adobe Experience Manager Forms-Funktionen Download aus Software Distribution
(Optional) Adobe Experience Manager Forms Designer Tools zum Erstellen, Gestalten und Optimieren adaptiver Formulare und anderer Adobe Experience Manager Forms-Funktionen Download aus Software Distribution

Herunterladen der neuesten Software-Version von Software Distribution

Herunterladen der neuesten Version von Adobe Experience Manager as a Cloud Service SDK, Experience Manager Forms-Funktionsarchiv (AEM Forms-Add-on), Forms-Referenzelemente oder Forms Designer von Software Distribution:

  1. Melden Sie sich bei https://experience.adobe.com/#/downloads mit Ihrer Adobe ID an.

    HINWEIS

    Ihre Adobe-Organisation muss für AEM as a Cloud Service bereitgestellt werden, um das AEM as a Cloud Service SDK herunterladen zu können.

  2. Navigieren Sie zur Registerkarte AEM as a Cloud Service.

  3. Sortieren Sie in absteigender Reihenfolge nach dem Veröffentlichungsdatum.

  4. Klicken Sie auf die neueste Version von Adobe Experience Manager as a Cloud Service SDK, Experience Manager Forms-Funktionsarchiv (AEM Forms-Add-on), Forms-Referenz-Assets oder Forms Designer.

  5. Lesen und akzeptieren Sie den Endbenutzer-Lizenzvertrag. Tippen Sie auf die Schaltfläche Herunterladen.

Einrichten von Entwicklungs-Tools für AEM-Projekte

Das Adobe Experience Manager Forms-Projekt ist eine benutzerdefinierte Code-Basis. Diese enthält Code, Konfigurationen und Inhalte, die über Cloud Manager in Adobe Experience Manager as a Cloud Service bereitgestellt werden. Der AEM-Projekt Maven-Archetyp stellt die Grundlinie für das Projekt bereit.

Richten Sie die folgenden Entwicklungs-Tools ein, die für Ihr Adobe Experience Manager-Projekt zur Entwicklung verwendet werden sollen:

Detaillierte Anweisungen zum Einrichten der zuvor erwähnten Entwicklungs-Tools finden Sie unter Einrichten von Entwicklungs-Tools.

Einrichten einer lokalen Experience Manager-Umgebung für die Entwicklung

Das Cloud Service-SDK stellt eine QuickStart-Datei bereit. Es führt eine lokale Version von Experience Manager aus. Sie können entweder die Autoren- oder die Veröffentlichungsinstanz lokal ausführen.

Während QuickStart eine lokale Entwicklungsumgebung bietet, sind hier nicht alle Funktionen vorhanden, die bei Adobe Experience Manager as a Cloud Service verfügbar sind. Testen Sie daher Ihre Funktionen und den Code immer in einer Adobe Experience Manager as a Cloud Service-Entwicklungsumgebung, bevor Sie sie in die Staging- oder Produktionsumgebung verschieben.

Installieren und Konfigurieren einer lokalen Experience Manager-Umgebung:

Hinzufügen eines Forms-Archivs für lokale Autoren- und Veröffentlichungsinstanzen und Konfigurieren Forms-spezifischer Benutzer

Führen Sie folgende Schritte in der aufgeführten Reihenfolge aus, um Forms-Archive zu Experience Manager-Instanzen hinzuzufügen und Forms-spezifische Benutzer zu konfigurieren:

Installieren des neuesten Forms-Add-on-Funktionsarchivs

Das Funktionsarchiv für Adobe Experience Manager Forms as a Cloud Service bietet Tools zum Erstellen, Gestalten und Optimieren von adaptiven Formularen in der lokalen Entwicklungsumgebung. Installieren Sie das Paket, um ein adaptives Formular zu erstellen, und verwenden Sie verschiedene andere Funktionen von AEM Forms. Installieren des Pakets:

  1. Laden Sie das neueste AEM Forms-Archiv für Ihr Betriebssystem aus Software Distribution herunter und extrahieren Sie es.

  2. Navigieren Sie zum Verzeichnis „crx-quickstart/install“. Wenn der Ordner nicht vorhanden ist, erstellen Sie ihn.

  3. Beenden Sie Ihre AEM-Instanz, platzieren Sie das AEM Forms-Add-on-Funktionsarchiv aem-forms-addon-<version>.far im Installationsordner und starten Sie die Instanz neu.

Konfigurieren von Benutzern und Berechtigungen

Erstellen Sie Benutzer wie „Formularentwickler“ oder „Formularpraktiker“ und fügen Sie diese Benutzer vordefinierten Formulargruppen hinzu, um ihnen die erforderlichen Berechtigungen zu gewähren. In folgender Tabelle werden alle Benutzertypen und vordefinierten Gruppen für jeden Formularbenutzertyp aufgeführt:

Benutzertyp AEM-Gruppe
Formularpraktiker/ forms-users (AEM Forms-Benutzer), template-authors, workflow-users, workflow-editors und fdm-authors
Formularentwickler forms-users (AEM Forms-Benutzer), template-authors, workflow-users, workflow-editors und fdm-authors
Customer Experience Lead oder UX-Designer forms-users, template-authors
AEM-Administrator aem-administrators, fd-administrators
Endanwender Fügen Sie Benutzer, die sich anmelden müssen, um ein adaptives Formular anzuzeigen und zu übermitteln, der Gruppe forms-users hinzu.
Wenn für den Zugriff auf adaptive Formulare keine Benutzerauthentifizierung erforderlich ist, weisen Sie diesen Benutzern keine Gruppe zu.

Einrichten einer lokalen Entwicklungsumgebung für das Datensatzdokument (DoR)

AEM Forms as a Cloud Service bietet eine Docker-basierte SDK-Umgebung zur einfacheren Entwicklung des Datensatzdokuments und zur Verwendung anderer Microservices. So müssen Sie plattformspezifische Binärdateien und Anpassungen nicht manuell konfigurieren. So richten Sie die Umgebung ein:

  1. Installieren und Konfigurieren von Docker:

    • (Für Microsoft® Windows) Installieren Sie Docker Desktop. Damit werden Docker Engine und docker-compose auf Ihrem Computer konfiguriert.

    • (Apple macOS) Installieren Sie Docker Desktop für Mac. Dazu gehören Docker Engine, Docker-CLI-Client, Docker Compose, Docker Content Trust, Kubernetes und Credential Helper.

    • (Für Linux®) Installieren Sie Docker Engine und Docker Compose auf Ihrem Computer.

    HINWEIS
    • Setzen Sie für Apple macOS Ordner, die lokale AEM-Autoreninstanzen enthalten, auf die Zulassungsliste.

    • Docker Desktop für Windows unterstützt zwei Backends, Hyper-V
      (veraltet) und WSL2 (modern). Die Dateifreigabe wird
      bei Verwendung von WSL2 (modern) von Docker automatisch verwaltet. Bei Verwendung von Hyper-V (alt)
      müssen Sie die Dateifreigabe explizit konfigurieren.

  2. Erstellen Sie parallel zu Ihrer Autoren- und Veröffentlichungsinstanz einen Ordner, z. B. „aem-sdk“. Beispiel: C:\aem-sdk.

  3. Extrahieren Sie die Datei aem-forms-addon-<version>.zip\aem-forms-addon-native-<version>.zip.

    Extrahiertes AEM Forms-Add-on nativ

  4. Erstellen Sie eine Umgebungsvariable AEM_HOME und verweisen Sie auf die lokale AEM-Autoreninstallation. Beispiel: C:\aem\author.

  5. Öffnen Sie „sdk.bat“ oder „sdk.sh“ zur Bearbeitung. Legen Sie AEM_HOME auf die lokale AEM-Autoreninstallation fest. Beispiel: C:\aem\author.

  6. Öffnen Sie die Eingabeaufforderung und navigieren Sie zum Ordner aem-forms-addon-native-<version>.

  7. Stellen Sie sicher, dass Ihre lokale AEM-Autoreninstanz ausgeführt wird. Führen Sie den folgenden Befehl aus, um das SDK zu starten:

    • (Unter Microsoft® Windows) sdk.bat start
    • (Unter Linux® oder Apple macOS) AEM_HOME=[local AEM Author installation] ./sdk.sh start
    HINWEIS

    Wenn Sie die Umgebungsvariable in der Datei sdk.sh definiert haben, ist die Angabe in der Befehlszeile optional. Die Option zum Definieren der Umgebungsvariablen in der Befehlszeile wird bereitgestellt, um den Befehl auszuführen, ohne das Shell-Skript zu aktualisieren.

    start-sdk-command

Sie können jetzt die lokale Entwicklungsumgebung zum Rendern des Datensatzdokuments verwenden. Laden Sie zum Testen eine XDP-Datei in Ihre Umgebung hoch und rendern Sie sie. Beispiel: http://localhost:4502/libs/xfaforms/profiles/default.print.pdf?template=crx:///content/dam/formsanddocuments/cheque-request.xdp konvertiert die XDP-Datei in das PDF-Dokument.

Einrichten eines Entwicklungsprojekts für Forms, basierend auf dem Experience Manager-Archetyp

Verwenden Sie dieses Projekt, um adaptive Formulare zu erstellen, Konfigurationsaktualisierungen und Überlagerungen bereitzustellen, benutzerdefinierte adaptive Formularkomponenten zu erstellen sowie zu testen und benutzerdefinierten Code im lokalen Experience Manager Forms-SDK zu erstellen. Nach dem lokalen Test können Sie das Projekt in Experience Manager Forms as a Cloud Service-Produktions- und -Nichtproduktionsumgebungen bereitstellen. Beim Bereitstellen des Projekts werden auch die folgenden AEM Forms-Assets bereitgestellt:

Designs Vorlagen Formulardatenmodelle
Canvas 3.0 Allgemein Microsoft® Dynamics 365
Tranquil Leer Salesforce
Urbane
Ultramarine
Beryl
HINWEIS

Richten Sie ein auf AEM-Archetyp Version 30 oder höher basierendes Projekt ein, um Microsoft® Dynamics 365- und Salesforce-Formulardatenmodelle mit AEM Forms as a Cloud Service abzurufen und zu verwenden.
Richten Sie ein auf AEM-Archetyp Version 32 oder höher basierendes Projekt ein, um Tranquil-, Urbane- und Ultramarine-Designs mit AEM Forms as a Cloud Service abzurufen und zu verwenden.

Einrichten des Projekts:

  1. Klonen Sie das Cloud Manager-Git-Repository in Ihrer lokalen Entwicklungsinstanz: Ihr Cloud Manager-Git-Repository enthält ein AEM-Standardprojekt. Es basiert auf dem AEM-Archetyp. Klonen Sie Ihr Cloud Manager-Git-Repository mithilfe der Self-Service-Git-Kontoverwaltung der Cloud Manager-Benutzeroberfläche, um das Projekt in Ihre lokale Entwicklungsumgebung zu bringen. Weitere Informationen zum Zugriff auf das Repository finden Sie unter Zugriff auf Repositorys.

  2. Erstellen Sie ein Experience Manager Forms als [Cloud Service]-Projekt: Erstellen Sie ein Experience Manager Forms als [Cloud Service]-Projekt, das auf dem neuesten AEM-Archetyp oder höher basiert. Der Archetyp unterstützt Entwickler beim einfachen Einstieg in die Entwicklung für AEM Forms as a Cloud Service. Darin sind auch einige Beispiel-Designs und Vorlagen enthalten, die Ihnen bei den ersten Schritten helfen.

    Öffnen Sie die Eingabeaufforderung und führen Sie den folgenden Befehl aus, um ein Experience Manager Forms as a Cloud Service-Projekt zu erstellen.

    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=mysite -D appId=mysite -D groupId=com.mysite -D includeFormsenrollment="y" -D aemVersion="cloud"
    

    Ändern Sie im obigen Befehl appTitle, appId und groupId, sodass die Werte Ihrer Umgebung entsprechen. Setzen Sie außerdem den Wert für includeFormsenrollment, includeFormSkommunikations und includeFormSheadless je nach Ihrer Lizenz und Ihren Anforderungen auf y oder n. „includeFormSheadless“ ist erforderlich, um adaptive Formulare basierend auf Kernkomponenten zu erstellen.

    • Verwenden Sie die Option includeFormsenrollment=y zum Einschließen von Forms-spezifischen Konfigurationen, Designs, Vorlagen, Kernkomponenten und Abhängigkeiten, die zum Erstellen adaptiver Formulare erforderlich sind. Wenn Sie das Formularportal verwenden, legen Sie die Option includeExamples=y fest. Dadurch werden dem Projekt Kernkomponenten des Formularportals hinzugefügt.

    • Durch Verwenden der Option includeFormscommunications=y werden Formular-Kernkomponenten und -Abhängigkeiten einbezogen, die für die Verwendung der Kundenkommunikations-Funktion erforderlich sind.

  3. Stellen Sie das Projekt in Ihrer lokalen Entwicklungsumgebung bereit. Sie können folgenden Befehl verwenden, um die Bereitstellung für Ihre lokale Entwicklungsumgebung durchzuführen.

    mvn -PautoInstallPackage clean install

    Die vollständige Liste der Befehle finden Sie unter Erstellen und Installieren

  4. Stellen Sie den Code in Ihrer AEM Forms as a Cloud Service-Umgebung bereit.

Einrichten lokaler Dispatcher-Tools

Dispatcher ist ein Apache HTTP-Webservermodul, das eine Sicherheits- und Leistungsebene zwischen der CDN- und der AEM Publish-Ebene bereitstellt. Er ist ein integraler Bestandteil der Gesamtarchitektur von Experience Manager und sollte auch in der lokalen Entwicklungsumgebung vorhanden sein.

Führen Sie folgende Schritte aus, um den lokalen Dispatcher zu konfigurieren und ihm dann Forms-spezifische Regeln hinzuzufügen:

Einrichten des lokalen Dispatchers

Das Experience Manager as a Cloud Service SDK enthält die empfohlene Version der Dispatcher-Tools, die die lokale Konfiguration, Validierung und Simulation von Dispatcher erleichtern. Dispatcher-Tools sind Docker-basiert und bieten Befehlszeilen-Tools, um Apache HTTP-Webserver- und Dispatcher-Konfigurationsdateien in ein kompatibles Format zu übertragen und sie in Dispatcher bereitzustellen, der im Docker-Container ausgeführt wird.

Durch das Caching auf Dispatcher kann AEM Forms adaptive Formulare auf einem Client vorbefüllen. Dadurch wird die Rendering-Geschwindigkeit vorbefüllter Formulare verbessert.

Detaillierte Anweisungen zum Einrichten von Dispatcher finden Sie unter Einrichten lokaler Dispatcher-Tools

Hinzufügen Forms-spezifischer Regeln für Dispatcher

Führen Sie folgende Schritte aus, um den Dispatcher-Cache für Experience Manager Forms as a Cloud Service zu konfigurieren:

  1. Öffnen Sie Ihr AEM-Projekt und navigieren Sie zu \src\conf.dispatcher.d\available_farms

  2. Erstellen Sie eine Kopie der default.farm-Datei. Zum Beispiel forms.farm.

  3. Öffnen Sie die neu erstellte forms.farm-Datei zur Bearbeitung und ersetzen Sie folgenden Code:

    #/ignoreUrlParams {
    #/0001 { /glob "*" /type "deny" }
    #/0002 { /glob "q" /type "allow" }
    #}
    

    durch

    /ignoreUrlParams {
    /0001 { /glob "*" /type "deny" }
    /0002 { /glob "dataRef" /type "allow" }
    }
    
  4. Speichern und schließen Sie die Datei.

  5. Wechseln Sie zu conf.d/enabled_farms und erstellen Sie eine symbolische Verknüpfung zur Datei forms.farm.

  6. Kompilieren Sie das Projekt und stellen Sie es in Ihrer AEM Forms as a Cloud Service-Umgebung bereit.

Überlegungen zum Caching

  • Durch das Caching in Dispatcher kann AEM Forms adaptive Formulare auf einem Client vorbefüllen. Dadurch wird die Rendering-Geschwindigkeit vorbefüllter Formulare verbessert.
  • Das Caching geschützter Inhaltsfunktionen ist standardmäßig deaktiviert. Um die Funktion zu aktivieren, können Sie die Anweisungen ausführen, die im Artikel Caching geschützten Inhalts bereitgestellt werden.
  • Möglicherweise kann der Dispatcher einige adaptiven Formulare und damit verbundene adaptive Formulare nicht ungültig machen. Informationen zum Beheben solcher Probleme finden Sie unter AEM Forms Caching im Abschnitt zur Fehlerbehebung.
  • Caching lokalisierter adaptiver Formulare:
    • Verwenden Sie das URL-Format http://host:port/content/forms/af/<afName>.<locale>.html anstelle von http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>, um die lokalisierte Version eines adaptiven Formulars aufzurufen.
    • Die Option „Browser-Gebietsschema“ ist standardmäßig deaktiviert. Ändern der Einstellung des Browser-Gebietsschemas
  • Wenn Sie das URL-Format http://host:port/content/forms/af/<adaptivefName>.html verwenden und „Browser-Gebietsschema verwenden“ im Konfiguratioins-Manager deaktiviert ist, wird die nicht lokalisierte Version des adaptiven Formulars bereitgestellt. Die nicht lokalisierte Sprache ist die Sprache, die bei der Entwicklung des adaptiven Formulars verwendet wurde. Das für Ihren Browser konfigurierte Gebietsschema (Browser-Gebietsschema) wird nicht berücksichtigt und es wird eine nicht lokalisierte Version des adaptiven Formulars bereitgestellt.
  • Wenn Sie das URL-Format http://host:port/content/forms/af/<adaptivefName>.html verwenden und „Browser-Gebietsschema verwenden“ im Konfigurations-Manager aktiviert ist, wird, sofern verfügbar, eine lokalisierte Version des adaptiven Formulars bereitgestellt. Die Sprache des lokalisierten adaptiven Formulars basiert auf dem für Ihren Browser konfigurierten Gebietsschema (Browser-Gebietsschema). Dies kann dazu führen, dass nur [die erste Instanz eines adaptiven Formulars zwischengespeichert abgelegt wird]. Um zu verhindern, dass das Problem in Ihrer Instanz auftritt, lesen Sie Nur die erste Instanz eines adaptiven Formulars wird zwischengespeichert im Abschnitt zur Fehlerbehebung.

Ihre lokale Entwicklungsumgebung ist bereit.

Aktivieren der Kernkomponenten für adaptive Formulare für ein vorhandenes AEM Archetyp-basiertes Projekt

Wenn Sie ein auf AEM Archetype Version 40 oder höher basierendes Programm für AEM Forms as a Cloud Service verwenden, werden die Kernkomponenten automatisch für Ihre Umgebung aktiviert. Sobald Sie die Kernkomponenten für Ihre Umgebung aktivieren, werden die Vorlage und das Arbeitsflächen-Design für adaptive Formulare (Kernkomponente) zu Ihrer Umgebung hinzugefügt. Wenn Ihre AEM SDK-Version älter als 2023.02.0 ist, stellen Sie sicher, dass das prerelease-Flag in Ihrer Umgebung aktiviert ist, da Kernkomponenten für adaptive Formulare Teil der Vorabversion vor der Version 2023.02.0 waren.

Um Kernkomponenten für adaptive Formulare für Ihre AEM Forms as a Cloud Service-Umgebung auf der Grundlage älterer Archetypversionen zu aktivieren, betten Sie sowohl WCM-Kernkomponenten-Beispielartefakte als auch Forms-Kernkomponenten-Artefakte (einschließlich Beispiele) in Ihr Projekt ein:

  1. Öffnen Sie Ihren AEM Archetype-Projektordner in einem Klartext-Code-Editor. Beispiel: VS Code.

  2. Öffnen der obersten Ebene .pom -Datei (übergeordnetes POM) Ihres AEM-Archetypprojekts in Ihrer lokalen Umgebung hinzufügen, die folgenden Eigenschaften zur Datei hinzufügen und speichern.

    <properties>
        <core.forms.components.version>2.0.4</core.forms.components.version> <!-- Replace the version with the latest released version at https://github.com/adobe/aem-core-forms-components/tags -->
        <core.wcm.components.version>2.21.2</core.wcm.components.version>
    </properties>
    

    Die neueste Version von core.forms.components und core.wcm.components finden Sie in der Dokumentation zu Kernkomponenten.

  3. Im Abschnitt "Abhängigkeiten"der obersten Ebene (übergeordnet) pom.xml -Datei, fügen Sie die folgenden Abhängigkeiten hinzu:

        <!-- 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 -->
    
  4. Öffnen Sie die all/pom.xml und fügen Sie die folgenden Abhängigkeiten in die embedded Abschnitt zum Hinzufügen von Adaptive Forms-Kernkomponenten-Artefakten zu Ihrem AEM Archetypprojekt:

        <!-- 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>
    
    HINWEIS

    Ersetzen Sie ${appId} durch die appId Ihres Archetyps.

  5. Im Abschnitt Abhängigkeiten des all/pom.xml -Datei, fügen Sie die folgenden Abhängigkeiten hinzu:

        <!-- 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>
    
  6. Einschließen af-core bundle Abhängigkeit in der ui.apps/pom.xml

         <dependency>
        <groupId>com.adobe.aem</groupId>
        <artifactId>core-forms-components-af-core</artifactId>
        </dependency>
    
    HINWEIS

    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>

  7. Ausführen der Pipeline. Nach erfolgreicher Pipeline-Ausführung sind die Kernkomponenten von adaptiven Formularen für Ihre Umgebung aktiviert. Außerdem werden die Vorlage Adaptive Forms (Kernkomponenten) und das Arbeitsflächendesign zu Ihrer as a Cloud Service Forms-Umgebung hinzugefügt.

Upgrade Ihrer lokalen Entwicklungsumgebung

Ein Upgrade des SDK auf eine neue Version erfordert das Ersetzen der gesamten lokalen Entwicklungsumgebung, wodurch Code, Konfiguration und Inhalt in den lokalen Repositorys verlorengehen. Stellen Sie sicher, dass alle Codes, Konfigurationen oder Inhalte, die nicht entfernt werden sollen, sicher in Git übertragen oder als CRX-Pakete aus den lokalen Experience Manager-Instanzen exportiert werden.

Vermeiden von Inhaltsverlusten beim Upgrade des SDK

Beim Upgrade des SDK werden ganz neue Autoren- und Veröffentlichungsinstanzen erstellt, einschließlich eines neuen Repositorys (Einrichten eines AEM-Projekts), d. h. alle Änderungen, die an einem früheren SDK-Repository vorgenommen wurden, gehen verloren. Durchführbare Strategien für die Beibehaltung von Inhalten zwischen SDK-Upgrades finden Sie unter Vermeiden von Inhaltsverlusten beim Upgrade des AEM-SDK

Sichern und Importieren Forms-spezifischer Inhalte in eine neue SDK-Umgebung

Sichern von Assets und Verschieben vom vorhandenen SDK in eine neue SDK-Umgebung:

  • Erstellen Sie eine Sicherung Ihres vorhandenen Inhalts.

  • Richten Sie eine neue SDK-Umgebung ein.

  • Importieren Sie die Sicherung in Ihre neue SDK-Umgebung.

Erstellen Sie eine Sicherung Ihres vorhandenen Inhalts

Sichern Sie adaptive Formulare, Vorlagen, Formulardatenmodell, Design, Konfigurationen und benutzerdefinierten Code. Sie können folgende Aktion ausführen, um eine Sicherung zu erstellen:

  1. Adaptive Formulare, Designs und PDF-Formulare herunterladen.

  2. Vorlagen für adaptive Formulare exportieren.

  3. Formulardatenmodelle herunterladen.

  4. Bearbeitbare Vorlagen, Cloud-Konfigurationen und Workflow-Modell exportieren. Um alle zuvor erwähnten Elemente aus Ihrem bestehenden SDK zu exportieren, erstellen Sie ein CRX-Paket mit folgenden Filtern:

    • /conf/ReferenceEditableTemplates
    • /conf/global/settings/cloudconfigs
    • /conf/global/settings/wcm
    • /var/workflow/models
    • /conf/global/settings/workflow
  5. Exportieren Sie E-Mail-Konfigurationen und Code von Übermittlungs- und Vorbefüllungsaktionen aus Ihrer lokalen Entwicklungsumgebung. Um diese Einstellungen und Konfigurationen zu exportieren, erstellen Sie eine Kopie folgender Ordner und Dateien in Ihrer lokalen Entwicklungsumgebung:

    • [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
    • [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
    • [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

Importieren Sie die Sicherung in Ihre neue SDK-Umgebung

Importieren Sie adaptive Formulare, Vorlagen, Formulardatenmodell, Design, Konfigurationen und benutzerdefinierten Code in Ihre neue Umgebung. Sie können zum Importieren der Sicherung folgende Aktion ausführen:

  1. Adaptive Formulare, Designs und PDF-Formulare in die neue SDK-Umgebung importieren.

  2. Adaptive Formularvorlagen in die neue SDK-Umgebung importieren.

  3. Formulardatenmodellen in die neue SDK-Umgebung hochladen.

  4. Bearbeitbare Vorlagen, Cloud-Konfigurationen und Workflow-Modell importieren. Um alle zuvor erwähnten Elemente in Ihre neue SDK-Umgebung zu importieren, importieren Sie das CRX-Paket, das diese Elemente enthält, in Ihre neue SDK-Umgebung.

  5. Importieren Sie E-Mail-Konfigurationen und Code von Übermittlungs- und Vorbefüllungsaktionen aus Ihrer lokalen Entwicklungsumgebung. Um diese Einstellungen und Konfigurationen zu importieren, fügen Sie folgende Dateien aus Ihrem alten in Ihr neues Archetyp-Projekt ein:

    • [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
    • [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
    • [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

Ihre neue Umgebung enthält jetzt Formulare und zugehörige Elemente aus Ihrer alten Umgebung.

Auf dieser Seite