Activer les composants principaux des formulaires adaptatifs sur AEM Forms 6.5 enable-adaptive-forms-core-components
L’activation des composants principaux des formulaires adaptatifs vous permet de commencer à créer, à publier et à diffuser des formulaires adaptatifs basés sur des composants principaux et des formulaires adaptatifs découplés de votre environnement AEM Forms 6.5.
Pour activer les composants principaux des formulaires adaptatifs sur votre environnement AEM Forms 6.5, configurez et déployez un archétype AEM 41 ou version ultérieure basé sur un projet (avec les options de formulaire activées) sur toutes vos instances de création et de publication.
Cet article fournit des instructions détaillées sur la configuration et le déploiement de l’archétype AEM 41 ou version ultérieure sur votre environnement AEM Forms 6.5 pour activer les composants principaux des formulaires adaptatifs. Vous pouvez vous référer à la liste ci-dessous pour les versions compatibles avec AEM 6.5 pour activer les composants principaux de Forms :
Conditions préalables prerequisites
Avant d’activer les composants principaux des formulaires adaptatifs dans un environnement AEM Forms 6.5 :
-
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 :
-
Connectez-vous à l’ordinateur qui héberge et exécute votre instance AEM 6.5 Forms en tant qu’administrateur ou administratrice.
-
Ouvrez l’invite de commande ou le terminal et exécutez la commande suivante pour créer un projet d’archétype AEM (avec les options de formulaire activées) :
- Microsoft Windows
code language-shell 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
code language-shell 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 propriété
aemVersion
de6.5.15.0
en une autre valeur. -
Définissez la propriété
archetypeVersion
sur41
ou plus. Pour obtenir la dernière version, reportez-vous à la section de configuration requise dans la documentation Archétype de projet AEM. -
Mettez à jour la commande afin de refléter les valeurs spécifiques de votre environnement, y compris pour
appTitle
,appId
etgroupId
. Définissez également la valeur de la propriétéincludeFormsenrollment
sury
. Si vous utilisez le portail Formulaires, définissez l’optionincludeExamples=y
de façon à inclure les composants principaux du portail Formulaires dans votre projet.
-
(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 :
-
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 :
-
Ajoutez le code suivant à la ligne 21 :
code language-xml <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>
-
Enregistrez et fermez le fichier.
-
-
Mettez à jour le projet pour inclure la dernière version des composants principaux des formulaires :
-
Ouvrez le [Dossier du projet d’archétype AEM]/pom.xml pour modification.
-
Définissez la version de
core.forms.components.version
et decore.forms.components.af.version
sur la version des derniers composants principaux de formulaires et assurez-vous que les deux ont la même version que la version des composants principaux de formulaires mentionnée dans le tableau. Définissez la version decore.wcm.components.version
comme indiqué dans les composants principaux WCM.note warning WARNING - Lors de la création d’un projet d’archétype avec la version 45,
[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 d’archétype, mettez à jour la version des composants principaux de formulaires vers la version 1.1.26. Vous trouverez la dernière version dans l’historique des versions d’AEM 6.5 Forms.
note note NOTE - Si vous configurez une autre topologie, assurez-vous de placer les URL d’envoi, de préremplissage et autres sur la liste autorisée au niveau de la couche du Dispatcher.
- Lors de la création d’un projet d’archétype avec la version 45,
-
Enregistrez et fermez le fichier.
-
-
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 :
-
Accédez au répertoire racine de votre projet d’archétype AEM.
-
Exécutez la commande suivante pour créer le projet d’archétype AEM pour votre environnement :
code language-shell 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
-
-
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.
- Si vous rencontrez des difficultés pour accéder à la boîte de dialogue de connexion sur une instance de publication, essayez d’installer le module via le gestionnaire de modules à l’aide de l’URL
http://[Publish Server URL]:[PORT]/system/console
pour vous connecter. Cela vous permet d’accéder à la page de connexion de l’instance de publication et de poursuivre le processus d’installation. - Ne supprimez pas le projet d’archétype après son déploiement dans votre environnement. Le projet d’archétype est nécessaire pour ajouter des thèmes de composants principaux de formulaires adaptatifs nouveaux ou personnalisés à votre environnement.
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éer des thèmes pour formulaires adaptatifs basés sur les composants principaux
- Création d’un modèle pour les formulaires adaptatifs basés sur les composants principaux