Composant de conteneur de formulaires

Le composant de conteneur de formulaires des composants principaux permet la création de formulaires d’envoi simples.

Utilisation

Le composant de conteneur de formulaires a permis la création de formulaires et de fonctionnalités d’envoi d’informations simples en prenant en charge les formulaires WCM simples et en utilisant une structure imbriquée pour autoriser des composants de formulaire supplémentaires.

En utilisant la boîte de dialogue de configuration, l’éditeur de contenu peut définir l’action déclenchée par l’envoi du formulaire, l’URL chargé de cet envoi, et si un workflow doit être déclenché. L’auteur du modèle peut utiliser la boîte de dialogue de conception pour définir les composants autorisés et leurs mappages similaires à la boîte de dialogue de conception du conteneur de mises en page standard dans l’éditeur de modèles.

Version et compatibilité

La version actuelle du composant de conteneur de formulaires est v2, qui a été introduite avec la version 2.0.0 des composants principaux en janvier 2018. Elle est décrite dans ce document.

Le tableau ci-après présente en détail toutes les versions prises en charge du composant, les versions AEM avec lesquelles les versions du composant sont compatibles et les liens vers la documentation pour les versions précédentes.

Pour plus d’informations sur les versions et les publications des composants principaux, voir le document sur les versions des composants principaux.

Exemple de sortie de composant

Pour tester le composant de conteneur de formulaires et obtenir des exemples d’options de configuration, ainsi que des sorties HTML et JSON, consultez la bibliothèque de composants.

Détails techniques

La documentation technique la plus récente sur le composant de conteneur de formulaires se trouve sur GitHub.

Vous trouverez plus d’informations sur le développement des composants principaux dans la documentation destinée aux développeurs de composants principaux.

Boîte de dialogue de configuration

La boîte de dialogue de configuration permet à l’auteur de contenu de définir les actions effectuées lors de l’envoi du composant.

Selon le type d’action sélectionné, les options disponibles dans le conteneur changent. Les types d’actions disponibles sont les suivants :

• Publier les données de formulaire (Post Form Data)
• Courrier
• Stocker le contenu

Quel que soit le type, il existe des paramètres généraux qui s’appliquent à chaque action.

Publier les données de formulaire (Post Form Data)

Lorsque le formulaire est envoyé, le type d’action Publier les données de formulaire transmet les données envoyées à un tiers au format JSON pour qu’elles soient traitées.

• Point de terminaison : service HTTPS complet qui traitera les données
• Message d’erreur : message qui s’affiche si l’envoi échoue

Courrier

Lorsque le formulaire est envoyé, le type d’action courrier envoie un e-mail aux destinataires désignés.

• Objet : objet de l’e-mail qui sera envoyé lors de l’envoi du formulaire.
• De : adresse e-mail de l’expéditeur de l’e-mail qui sera envoyé lors de l’envoi du formulaire.
• À : adresse des destinataires qui recevront un e-mail lors de l’envoi du formulaire.
  • Appuyez ou cliquez sur le bouton Ajouter pour ajouter d’autres adresses.
  • Appuyez ou cliquez sur le bouton Supprimer pour supprimer une adresse e-mail.
• Cc : adresses des destinataires qui recevront une copie carbone de l’e-mail envoyé lors de l’envoi du formulaire.
  • Appuyez ou cliquez sur le bouton Ajouter pour ajouter d’autres adresses.
  • Appuyez ou cliquez sur le bouton Supprimer pour supprimer une adresse e-mail.

Stocker le contenu

Lorsque le formulaire est envoyé, le contenu du formulaire est stocké dans un emplacement de référentiel désigné.

• Chemin d’accès au contenu : chemin d’accès au référentiel de contenu où le contenu envoyé est stocké.
• Afficher des données : appuyez ou cliquez sur cette option pour afficher les données envoyées stockées sous la forme JSON.
• Démarrer le processus : configurez cette option pour démarrer un workflow avec le contenu stocké comme charge utile lors de l’envoi du formulaire.

Paramètres généraux

Quel que soit le type d’action sélectionné, une page de remerciement peut toujours être définie.

• Page de remerciement : l’utilisateur est redirigé vers la page spécifiée une fois l’envoi du formulaire terminé.
  • Utilisez la boîte de dialogue de sélection pour sélectionner une ressource dans AEM.
  • Si la page de remerciement ne figure pas dans AEM, indiquez l’URL absolue. Les URL non absolues seront interprétées par rapport à AEM.
  • Laissez vide pour réafficher le formulaire après envoi.
• ID : cette option permet de contrôler l’identifiant unique du composant dans le code HTML ainsi que dans la couche de données.
  • Si rien n’est indiqué, un ID unique est généré automatiquement et peut être trouvé en examinant la page obtenue.
  • Si un ID est spécifié, il incombe à l’auteur de s’assurer qu’il est unique.
  • La modification de l’ID peut avoir un impact sur le suivi CSS, JS et de couche de données.

Boîte de dialogue de conception

La boîte de dialogue de conception permet à l’auteur du modèle de définir les composants autorisés et leurs mappages pour le conteneur similaires à la boîte de dialogue de conception du conteneur de mises en page standard dans l’éditeur de modèles.

Onglet Styles

Le composant Conteneur de formulaire prend en charge le système de style AEM.