Activation des composants principaux de Forms adaptatif sur AEM Forms 6.5

S’applique à : ✅ Composants principaux de formulaire adaptatif ❎ Composants de base de formulaire adaptatif.

L’activation des composants principaux de Forms adaptatif vous permet de commencer à créer, publier et diffuser des Forms adaptatif basé sur les composants principaux et Forms adaptatif sans affichage de votre environnement Forms 6.5 AEM.

Pour activer les composants principaux Forms adaptatifs sur votre environnement Forms 6.5 AEM, configurez et déployez une AEM Archetype 41 ou version ultérieure basé sur un projet (avec les options de formulaire activées) sur toutes vos instances d’auteur et de publication.

Cet article fournit des instructions détaillées sur la configuration et le déploiement d’AEM archetype 41 ou version ultérieure sur votre environnement Forms AEM 6.5 pour activer les composants principaux Forms adaptatif. Reportez-vous à la liste ci-dessous pour AEM 6.5 versions compatibles pour activer les composants principaux Forms :

Conditions préalables requises

Avant d’activer les composants principaux de Forms adaptatif dans un environnement Forms 6.5 AEM :

• Effectuez une mise à niveau vers le Pack de services 16 (6.5.16.0) ou version ultérieure pour AEM 6.5 Forms.

• Installez la dernière version d’Apache Maven.

• Installez un éditeur de texte brut. Par exemple, Microsoft Visual Studio Code.

Créer et déployer le dernier projet d’archétype AEM

Pour créer un projet d’archétype AEM 41 ou version ultérieure et le déployer sur toutes vos instances de création et de publication, procédez comme suit :

1. Connectez-vous à votre ordinateur, en tant qu’administrateur, en hébergeant et en exécutant votre instance Forms AEM 6.5.

2. Ouvrez l’invite de commande ou le terminal et exécutez la commande suivante pour créer AEM projet Archetype (avec les options de formulaire activées) :

   • Microsoft Windows

      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 ou Apple macOS

      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"
   

   Lorsque vous exécutez la commande ci-dessus, tenez compte des points suivants :

   • Ne modifiez pas la valeur de la variable aemVersion de 6.5.15.0 à tout autre chose.

   • Définissez la variable archetypeVersion de 41 ou plus tard. Pour obtenir la dernière version, reportez-vous à la section Configuration requise dans AEM Archétype de projet la documentation.

   • Mettez à jour la commande afin de refléter les valeurs spécifiques de votre environnement, y compris le appTitle, appId, et groupId. Définissez également la valeur de la variable includeFormsenrollment de y. Si vous utilisez le portail Formulaires, définissez l’option includeExamples=y de façon à inclure les composants principaux du portail Formulaires dans votre projet.

3. (Uniquement pour les projets basés sur l’archétype 41) Une fois le projet d’archétype AEM créé, activez les thèmes des formulaires adaptatifs basés sur les composants principaux. Pour activer les thèmes, procédez comme suit :

   1. Ouvrez le [Dossier du projet d’archétype AEM]/ui.apps/src/main/content/jcr_root/apps/appId/components/adaptiveForm/page/customheaderlibs.html pour modification :

   2. Ajoutez le code suivant à la ligne 21 :

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

      

   3. Enregistrez et fermez le fichier.

4. Mettez à jour le projet pour inclure la dernière version des composants principaux des formulaires :

   1. Ouvrez le [Dossier du projet d’archétype AEM]/pom.xml pour modification.

   2. Définir la version de core.forms.components.version et core.forms.components.af.version to derniers composants principaux Forms et assurez-vous que les deux ont la même version que Composants principaux de Forms mentionné dans le tableau et définissez la version de core.wcm.components.version comme indiqué dans Composants principaux WCM.

      AVERTISSEMENT

      • Lors de la création d’un projet Archetype avec version 45, la variable [AEM archetype Project Folder]/pom.xml définit initialement la version des composants principaux de formulaires sur 1.1.28. Avant de créer ou de déployer le projet Archetype, mettez à jour la version des composants principaux de formulaires en 1.1.26.
      REMARQUE

      • Si vous configurez une autre topologie, veillez à ajouter les URL d’envoi, de préremplissage et autres à la liste autorisée au niveau de la couche de Dispatcher.

   3. Enregistrez et fermez le fichier.

5. Une fois le projet d’archétype AEM créé, créez le package de déploiement pour votre environnement. Pour créer le package, procédez comme suit :

   1. Accédez au répertoire racine de votre projet d’archétype AEM.

   2. Exécutez la commande suivante pour créer le projet d’archétype AEM pour votre environnement :

      mvn clean install
      

      

   Une fois le projet d’archétype AEM créé, un package AEM est généré. Vous trouverez le package dans le [Dossier du projet d’archétype AEM]\all\target[appid].all-[version].zip

6. Utilisez le Gestionnaire de modules pour déployer le package [Dossier du projet d’archétype AEM]\all\target[appid].all-[version].zip sur toutes les instances de création et de publication.

Les composants principaux sont activés pour votre environnement. Un modèle vierge de formulaire adaptatif basé sur des composants principaux et un thème Canvas 3.0 sont déployés sur votre environnement. Vous pouvez maintenant créer un formulaire adaptatif basé sur les composants principaux.

Questions fréquentes

Que sont les composants principaux ?

Les composants principaux sont un ensemble de composants WCM (Web Content Management, 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 les fonctionnalités des composants principaux ?

Lorsque les composants principaux des formulaires adaptatifs sont activés pour votre environnement, un modèle vierge de formulaire adaptatif basé sur les composants principaux 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 :

• Créer un formulaire adaptatif basé sur des composants principaux.
• Créer des modèles de formulaires adaptatifs basés sur des composants principaux.
• Créer des thèmes personnalisés pour les modèles de formulaires adaptatifs basés sur les composants principaux.
• Diffuser les représentations JSON des formulaires adaptatifs basés sur les composants principaux à divers canaux tels que les applications mobiles, web et natives, ainsi que les services qui nécessitent une représentation découplée d’un formulaire.

Prochaines étapes

• Création d’un formulaire adaptatif basé sur des composants principaux
• Création ou ajout d’un formulaire adaptatif à une page AEM Sites ou à un fragment d’expérience
• Création de thèmes pour le Forms adaptatif basé sur les composants principaux
• Création d’un modèle pour le Forms adaptatif basé sur les composants principaux