Activer les composants principaux des formulaires adaptatifs enable-headless-adaptive-forms-on-aem-forms-cloud-service

Version
Lien de l’article
AEM 6.5
Cliquez ici
AEM as a Cloud Service
Cet article

L’activation des composants principaux de Forms adaptatif as a Cloud Service AEM Forms vous permet de commencer à créer, publier et diffuser des composants principaux basés sur Forms adaptatif et Forms sans affichage à l’aide de vos instances de Cloud Service AEM Forms sur plusieurs canaux. L’environnement des composants principaux des formulaires adaptatifs doit être activé pour utiliser les formulaires adaptatifs découplés.

Considérations

Activer les composants principaux des formulaires adaptatifs et les formulaires adaptatifs découplés enable-headless-forms

Effectuez les étapes suivantes, dans l’ordre indiqué, pour activer les composants principaux des formulaires adaptatifs et les formulaires adaptatifs découplés pour un environnement AEM Forms as a Cloud Service

Activer les composants principaux et les formulaires adaptatifs sans tête

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>
    

    Mention de la dernière version des composants principaux de Forms

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

Questions fréquentes faq

Que sont les composants principaux ? core-components

Les composants principaux sont un ensemble de composants WCM (Web Content Management, ou gestion de contenu web) normalisés pour AEM, dont l’objectif est d’accélérer le développement et de réduire les coûts de maintenance de vos sites web.

Quelles sont toutes les fonctionnalités ajoutées lors de l’activation des composants principaux ? core-components-capabilities

Lorsque les composants principaux des formulaires adaptatifs sont activés pour votre environnement, un modèle de formulaire adaptatif basé sur les composants principaux vierge et le thème Canvas 3.0 sont ajoutés à votre environnement. Après avoir activé les composants principaux des formulaires adaptatifs pour votre environnement, vous pouvez :

Les composants principaux des formulaires adaptatifs sont-ils activés pour mon environnement ? enable-components

Pour vérifier que les composants principaux des formulaires adaptatifs sont activés pour votre environnement :

  1. Clonez votre référentiel AEM Forms as a Cloud Service.

  2. Ouvrez le fichier [AEM Repository Folder]/all/pom.xml du référentiel Git AEM Forms Cloud Service.

  3. Recherchez les dépendances suivantes :

    • 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

    Localisez l’artefact core-forms-components-af-core dans all/pom.xml .

    Si les dépendances existent, les composants principaux des formulaires adaptatifs sont activés pour votre environnement.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab