Activer les formulaires adaptatifs découplés sur AEM Forms 6.5 enable-headless-adaptive-forms-on-aem-65-forms
Pour activer les formulaires adaptatifs découplés dans votre environnement AEM 6.5 Forms, configurez un projet basé sur l’archétype AEM 41 ou version ultérieure et déployez-le sur toutes vos instances de création et de publication.
En déployant le projet d’archétype AEM 41 ou version ultérieure sur vos instances AEM 6.5 Forms, vous pouvez créer un formulaire adaptatif basé sur les composants principaux. Ces formulaires sont représentés au format JSON et utilisés comme formulaires adaptatifs couplés et découplés, ce qui offre une plus grande flexibilité et personnalisation sur un large éventail de canaux, y compris les applications mobiles, web et natives.
Conditions préalables requises prerequisites
Pour bénéficier de la fonctionnalité des formulaires adaptatifs découplés dans votre environnement 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 :
-
Connectez-vous à l’ordinateur qui héberge et exécute votre instance AEM 6.5 Forms en tant qu’administrateur.
-
Ouvrez l’invite de commandes ou le terminal.
-
Exécutez la commande suivante pour créer le projet basé sur l’archétype AEM 41 :
- 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 :
-
Mettez à jour la commande afin de refléter les valeurs spécifiques de votre environnement, y compris pour appTitle, appId et groupId. Définissez également les valeurs de « includeFormsenrollment » sur « 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.
-
Ne modifiez pas la valeur de « aemVersion » de 6.5.15.0 à une autre.
-
(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
etcore.forms.components.af.version
sur la dernière version des composants principaux de Forms..
-
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.
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 vers des canaux tels que le mobile, le Web, les applications natives et les services qui requièrent la représentation découplée d’un formulaire.