Activer les composants principaux des formulaires adaptatifs sur AEM Forms 6.5 enable-adaptive-forms-core-components

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

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 :

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 à l’ordinateur qui héberge et exécute votre instance AEM 6.5 Forms en tant qu’administrateur ou administratrice.

  2. 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 de 6.5.15.0 en une autre valeur.

    • Définissez la propriété archetypeVersion sur 41 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 et groupId. Définissez également la valeur de la propriété 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.

  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 :

      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>
      

      Ajouter le code mentionné ci-dessus à la ligne 21

    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éfinissez la version de core.forms.components.version et de core.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 de core.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.
    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 :

      code language-shell
      mvn clean install
      

      archetypebuild-success

    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.

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2