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,

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.

  2. Ouvrez l’invite de commandes ou le terminal.

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

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

  5. 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 core.forms.components.af.version sur la dernière version des composants principaux de Forms.

      Mentionner la dernière version des composants principaux de Forms .

    3. Enregistrez et fermez le fichier.

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

  7. 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 lors de l’installation du package via le gestionnaire de modules, essayez de vous connecter à l’aide de l’URL suivante : http://[URL du serveur de publication]:[PORT]/system/console. Cela vous permet d’accéder à l’instance de publication et de poursuivre le processus d’installation.

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.
recommendation-more-help
ce8b2828-9203-402e-a565-7b758c99b2ba