Vérification et activation des composants principaux de Forms adaptatif enable-headless-adaptive-forms-on-aem-forms-cloud-service

Étapes d’activation manuelle

note warning
WARNING
Suivez ces étapes uniquement si la vérification ci-dessus confirme que les composants principaux de Forms adaptatif ne sont PAS activés pour votre environnement.

Pour activer les composants principaux de Forms adaptatif et le Forms adaptatif découplé pour un environnement AEM Forms as a Cloud Service, procédez comme suit, dans l’ordre indiqué :

​1. Cloner votre référentiel Git AEM Forms as a Cloud Service clone-git-repository

1. Connectez-vous à Cloud Manager et sélectionnez votre organisation et votre programme.

2. Accédez à la vignette Pipelines à partir de votre page Aperçu du programme et cliquez sur le bouton Accéder aux informations sur le référentiel pour accéder à votre référentiel Git et le gérer. La page contient les informations suivantes :

   • URL vers le référentiel Git de Cloud Manager.
   • Informations d’identification du nom d’utilisateur du référentiel Git (nom d’utilisateur et mot de passe).

   Cliquez sur Générer un mot de passe pour afficher ou générer le mot de passe.

3. Ouvrez le terminal ou l’invite de commande sur votre ordinateur local et exécutez la commande suivante :

   code language-shell
   git clone [Git Repository URL]

   Lorsque l’on vous y invite, saisissez les informations d’identification. Le référentiel est cloné sur votre ordinateur local.

​2. Ajouter les dépendances des composants principaux des formulaires adaptatifs à votre référentiel Git add-adaptive-forms-core-components-dependencies

1. Ouvrez votre dossier du référentiel Git dans un éditeur de code de texte brut. Par exemple, VS Code.

2. Ouvrez le fichier [AEM Repository Folder]\pom.xml en mode d’édition.

3. Remplacez les versions des composants core.forms.components.version, core.forms.components.af.version et core.wcm.components.version par les versions spécifiées dans la documentation des composants principaux. Si le composant n’existe pas, ajoutez ces composants.

   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>

   

4. Dans la section des dépendances du fichier [AEM Repository Folder]\pom.xml, ajoutez les dépendances suivantes, puis enregistrez le fichier.

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

5. Ouvrez le fichier [AEM Repository Folder]/all/pom.xml en mode d’édition. Ajoutez les dépendances suivantes dans la section <embeddeds> et enregistrez le fichier.

   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
   Remplacez ${appId} par votre appId.
   Pour rechercher votre ${appId}, dans le fichier [AEM Repository Folder]/all/pom.xml, recherchez le terme -packages/application/install. Le texte situé avant le terme -packages/application/install est votre ${appId}. Par exemple, le code suivant, myheadlessform est ${appId}.
   code language-none com.myheadlessform myheadlessform.ui.apps zip /apps/myheadlessform-packages/application install

6. Dans la section <dependencies> du fichier [AEM Repository Folder]/all/pom.xml, ajoutez les dépendances suivantes, puis enregistrez le fichier :

   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>

7. Ouvrez le [AEM Repository Folder]/ui.apps/pom.xml pour édition. Ajoutez la dépendance af-core bundle et enregistrez le fichier.

   code language-xml
   <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> </dependency>

   note note
   NOTE
   Assurez-vous que les artefacts de composants principaux des formulaires adaptatifs suivants ne sont pas inclus dans votre projet.
   <dependency>
   <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-apps</artifactId>
   </dependency>
   et
   <dependency>
   <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-core</artifactId>
   </dependency>

8. Enregistrez et fermez le fichier.

​3. Créer et déployer le code mis à jour

Déployez le code mis à jour dans vos environnements de développement local et de service cloud afin d’activer les composants principaux sur les deux environnements :

• Créer et déployer du code mis à jour dans un environnement de développement local (SDK AEM as a Cloud Service)

• Créer et déployer du code mis à jour dans un environnement AEM Forms as a Cloud Service

Créer et déployer du code mis à jour dans un environnement de développement local core-components-on-aem-forms-local-sdk

1. Ouvrez l’invite de commande ou le terminal.

2. Accédez au répertoire racine de votre projet de référentiel Git.

3. Exécutez la commande suivante pour créer le package de votre environnement :

   code language-shell
   mvn clean install

   Une fois le package créé, vous pouvez le trouver à l’adresse [Dossier du Référentiel Git]\all\target[appid].all-[version].zip.

4. Utilisez le gestionnaire de packages pour déployer le package accessible à [dossier de l’archétype de projet AEM]\all\target[appid].all-[version].zip sur l’environnement de développement local.

Créer et déployer du code mis à jour dans un environnement AEM Forms as a Cloud Service core-components-on-aem-forms-cs

1. Ouvrez le terminal ou l’invite de commande.

2. Accédez à [AEM Repository Folder] et exécutez les commandes suivantes dans l’ordre indiqué

   code 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

3. Une fois les fichiers validés dans le référentiel Git, exécutez le pipeline.

   Une fois l’exécution du pipeline terminée, les composants principaux des formulaires adaptatifs sont activés pour l’environnement correspondant. En outre, un modèle de formulaire adaptatif (composants principaux) et un thème Canvas 3.0 sont ajoutés à votre environnement Forms as a Cloud Service, ce qui vous permet de personnaliser et de créer des composants principaux basés sur les formulaires adaptatifs.