Show Menu
SUJETS×

Embed an adaptive form or Interactive Communication in AEM Sites Single Page Application

Présentation

aem forms permet aux développeurs de formulaires d’incorporer aisément des formulaires adaptatifs et des communications interactives dans une application à page unique AEM Sites (SPA). Le formulaire adaptatif incorporé et la communication interactive sont entièrement fonctionnels et les utilisateurs peuvent remplir et envoyer le formulaire sans quitter la page. Il permet à l’utilisateur de rester dans le contexte d’autres éléments de la page Web et d’interagir simultanément avec le formulaire adaptatif ou la communication interactive.
Dans l’application AEM Sites Single Page, vous pouvez ajouter un formulaire adaptatif ou une communication interactive à l’aide du composant Conteneur AEM Forms SPA. Il s’agit d’un composant AEM Forms pour les ZPS AEM Sites que vous pouvez ajouter à votre page Sites.
Pour plus d’informations sur l’incorporation d’un formulaire adaptatif dans une AEM Sites non SPA, voir Incorporation d’un formulaire adaptatif ou communication interactive dans la page AEM Sites.

Conditions préalables

Pour incorporer un formulaire adaptatif ou une communication interactive dans une application d’application d’une seule page à l’aide du composant Conteneur d’application d’une seule page à l’aide de AEM Forms, assurez-vous que vous avez installé les éléments suivants :
  • Java SE Development Kit 8 ou version ultérieure
  • Apache Maven 3.3.1 ou version ultérieure
  • aem instance d’auteur
  • Package de module complémentaire AEM Forms 6.4.2 sur l’instance d’auteur

Installer le composant Conteneur AEM Forms SPA

Exécutez les étapes suivantes pour installer le composant Conteneur AEM Forms SPA :
  1. Installez le composant AEM Forms pour l’application d’une seule page. Les instructions d’installation du composant sont disponibles dans le fichier README.md .
    Le composant comprend un exemple de composant Réagir qui peut être utilisé pour intégrer le composant conteneur SPA à un projet SPA basé sur Réagir.
  2. Intégrez le composant de conteneur d’application d’une seule page à un projet d’application d’une seule page en utilisant les instructions du fichier README.md .
    Après avoir installé le composant Conteneur d’application d’une seule page AEM Forms et intégré le composant à un projet d’application d’une seule page, vous pouvez incorporer des formulaires adaptatifs et des communications interactives dans la page AEM Sites.

Incorporation d’un formulaire adaptatif ou d’une communication interactive

Pour incorporer un formulaire adaptatif ou une communication interactive à l’aide du composant de Conteneur AEM Forms for SPA :
  1. Ouvrez la page de sites AEM, en mode d’édition, dans laquelle vous souhaitez incorporer un formulaire adaptatif ou une communication interactive.
  2. Insérez le composant Formulaire AEM pour l’application d’une seule page à l’aide de l’une des options suivantes :
    • Appuyez sur le conteneur de mise en page de la page Sites, appuyez sur + et sélectionnez le composant Formulaire AEM pour l’application d’une seule page .
    • From the Component browser panel, drag-drop the AEM Form for SPA component on the page.
    • Recherchez un formulaire adaptatif ou une communication interactive dans le navigateur Ressources et faites-le glisser sur la page Sites. Il incorpore le formulaire dans un conteneur de composant AEM Forms for SPA.
    Le rendu de plusieurs composants de Conteneur AEM Forms SPA sur une page n’est pas pris en charge. Vous pouvez avoir plusieurs Conteneurs AEM Forms SPA sur une page, mais un seul composant est rendu à la fois. Assurez-vous qu’un seul composant est visible sur une page pour éviter les incohérences.
  3. Tap the embedded AEM Forms SPA Container component in the sites page, and then tap on the action bar. The Edit AEM Forms SPA Container dialog opens.
  4. In the Edit AEM Forms Container dialog, specify the following:
    • Type d’actif : sélectionnez le type d’actif à incorporer. The options are Adaptive Form and Interactive Communication
    • Chemin d’accès au fichier : Recherchez et sélectionnez le formulaire adaptatif ou la communication interactive à incorporer. Le champ est renseigné automatiquement si un formulaire adaptatif ou une communication interactive est inséré à l’aide de l’explorateur Ressources.
    • Canal (communication interactive uniquement) : Sélectionnez le type de canal interactif à incorporer. Les options sont Canal ​Web et Canal ​Imprimer.
    • Thème : Sélectionnez un thème qui définit la mise en forme des composants de votre formulaire adaptatif ou de votre communication interactive. Style comprend des propriétés d’aspect telles que le style de police, la couleur d’arrière-plan, les dimensions et l’alignement.
  5. Tap to save the settings. Le formulaire adaptatif ou la communication interactive est désormais incorporé à la page.

Publier le formulaire adaptatif incorporé et la communication interactive

Examinez les scénarios suivants pour publier une ressource incorporée (formulaire adaptatif ou communication interactive) sur la page AEM Sites :
  • Si vous publiez la page AEM Sites pour la première fois et qu’elle comprend un formulaire adaptatif incorporé ou une communication interactive, publiez la page Sites et la ressource incorporée.
  • Si vous avez modifié uniquement le formulaire adaptatif incorporé ou la communication interactive dans une page de sites publiée, publiez le fichier d’origine et les modifications sont répercutées dans la page de sites publiée. La page Sites publiée contient une référence à la ressource et ne nécessite pas de republier la page.
  • Si vous avez modifié la page Sites et le formulaire adaptatif incorporé ou la communication interactive, republiez la page Sites et la ressource incorporée.

Modification du formulaire adaptatif incorporé et de la communication interactive

La page AEM sites conserve une référence au formulaire adaptatif et à la communication interactive dans le Conteneur AEM Forms. Par conséquent, toutes les configurations et propriétés, telles que le thème, les styles et l’action d’envoi, configurées dans le formulaire adaptatif d’origine et la communication interactive, sont conservées dans le formulaire adaptatif incorporé et la communication interactive.
Pour modifier toute configuration ou propriété du formulaire adaptatif incorporé et de la communication interactive, effectuez l’une des opérations suivantes.
  • Ouvrez le formulaire d’origine dans les formulaires adaptatifs ou dans la communication interactive dans les éditeurs respectifs et modifiez-le.
  • Tap the adaptive form or Interactive Communication from within the Sites page in edit mode and then tap Edit in a new window . Le formulaire d’origine s’ouvre en mode d’édition.

Eléments à prendre en compte et bonnes pratiques

Gardez les points suivants à l’esprit lorsque vous incorporez des formulaires adaptatifs à des pages de sites AEM :
  • L’en-tête et le pied de page du formulaire d’origine ne sont pas intégrés dans le formulaire incorporé.
  • Les brouillons et les envois de formulaires incorporés sont pris en charge et visibles dans les onglets Brouillons et Formulaires envoyés du portail de formulaires.
  • L’action Envoyer configurée sur le formulaire d’origine est conservée dans le formulaire incorporé.
  • Le ciblage d’expérience et les tests A/B configurés sur le formulaire d’origine ne fonctionnent pas dans le formulaire incorporé. Cependant, vous pouvez utiliser le ciblage d’expérience sur la page Sites pour présenter différents formulaires en fonction des profils d’utilisateur.
  • Si Adobe Analytics est configuré pour le formulaire d’origine, les données d’analyse du formulaire incorporé sont capturées dans Adobe Analytics. En revanche, elles ne seront pas disponibles dans le rapport d’analyse des formulaires.