Configurer les actions Envoyer pour AEM Forms
Configurez la gestion de l’envoi de formulaire pour acheminer les données vers des feuilles de calcul, des e-mails ou des systèmes back-end à l’aide d’AEM Forms avec Edge Delivery Services.
Guide de décision rapide
Choisissez votre méthode d’envoi :
Prérequis
Avant de configurer les actions d’envoi, vérifiez les points suivants :
- Instance AEM Forms as a Cloud Service
- Projet Edge Delivery Services configuré
- Formulaire créé à l’aide de la création de documents ou de l’éditeur universel
- Autorisations requises pour les destinations cibles (feuilles de calcul, systèmes de messagerie ou AEM)
Le service d’envoi de formulaires est un point d’entrée hébergé par Adobe idéal pour les scénarios de capture de données simples.
Destinations prises en charge
- Feuilles de calcul : Google Sheets, Microsoft Excel (OneDrive/SharePoint).
- E-mail : envoyer les données de formulaire aux adresses e-mail spécifiées
Étapes de configuration
-
Configuration de l’accès à la destination
- Pour les feuilles de calcul : octroyez l’autorisation de modification pour
forms@adobe.com
sur une feuille de calcul cible. - Pour les e-mails : vérifiez que les adresses e-mail des personnes destinataires sont accessibles.
- Pour les feuilles de calcul : octroyez l’autorisation de modification pour
-
Configuration de l’envoi de formulaire
- Ouvrez votre formulaire dans l’environnement de création.
- Définissez l’action Envoyer sur « Service d’envoi de formulaires ».
- Indiquez l’URL de la feuille de calcul ou les adresses e-mail cibles.
- Enregistrez et publiez le formulaire.
-
Test de l’envoi
- Envoyez les données de test via le formulaire.
- Vérifiez que les données apparaissent dans la destination cible.
- Consultez les journaux d’erreurs en cas d’échec de l’envoi.
Remarques importantes
- Le compte de service
forms@adobe.com
nécessite un accès en modification aux feuilles de calcul cibles. - Les notifications par e-mail sont envoyées immédiatement après l’envoi du formulaire.
- La validation des données se produit au niveau du service.
Envoyez directement les données de formulaire à votre instance de publication AEM as a Cloud Service pour un traitement complexe.
Quand utiliser la publication AEM
- Workflows AEM personnalisés requis après l’envoi
- Intégration du modèle de données de formulaire (FDM) aux bases de données
- Intégrations de services tiers (Marketo, Power Automate, Workfront Fusion)
- Bibliothèques de données de stockage Azure Blob ou SharePoint
- Logique complexe de validation ou de traitement côté serveur
Actions d’envoi disponibles
- Envoyer au point d’entrée REST
- Envoyer un e-mail via des services de messagerie AEM
- Envoyer à l’aide du modèle de données de formulaire
- Appeler le workflow AEM
- Envoyer à SharePoint
- Envoyer à OneDrive
- Envoyer au stockage Blob Azure
- Envoyer à Microsoft Power Automate
- Envoyer à Adobe Workfront Fusion
- Envoyer à Adobe Marketo Engage
Configuration requise
1. Mettre à jour l’URL de l’instance AEM dans Edge Delivery
Mettez à jour l’URL de l’instance AEM Cloud Service dans le fichier constant.js
du bloc form
sous submitBaseUrl
. Vous pouvez configurer l’URL en fonction de votre environnement :
Pour l’instance Cloud Service
code language-js |
---|
|
Pour le développement local
code language-js |
---|
|
2. Filtre de référent OSGi
Configurez le filtrage des référents pour autoriser vos domaines de site Edge Delivery spécifiques :
-
Créez ou mettez à jour le fichier de configuration OSGi :
org.apache.sling.security.impl.ReferrerFilter.cfg.json
-
Ajoutez la configuration suivante à vos domaines de site spécifiques :
code language-json { "allow.empty": false, "allow.hosts": [ "main--abc--adobe.aem.live", "main--abc1--adobe.aem.live" ], "allow.hosts.regexp": [ "https://.*\\.aem\\.live:443", "https://.*\\.aem\\.page:443", "https://.*\\.hlx\\.page:443", "https://.*\\.hlx\\.live:443" ], "filter.methods": [ "POST", "PUT", "DELETE", "COPY", "MOVE" ], "exclude.agents.regexp": [ "" ] }
-
Déploiement de la configuration via Cloud Manager
Pour obtenir une configuration détaillée du filtre Référent OSGi, reportez-vous au Guide Filtre Référent.
3. Problèmes de partage des ressources entre origines multiples (CORS)
Configurez les paramètres CORS dans AEM pour autoriser les requêtes provenant de vos domaines de site Edge Delivery spécifiques :
Localhost du développeur
code language-apache |
---|
|
Edge Delivery Sites : ajoutez chaque domaine de site individuellement
code language-apache |
---|
|
Domaines Franklin hérités (s’ils sont toujours en cours d’utilisation)
code language-apache |
---|
|
note note |
---|
NOTE |
Remplacez main--abc--adobe.aem.live et main--abc1--adobe.aem.live par vos domaines de site réels. Chaque site hébergé à partir du même référentiel nécessite une entrée de configuration CORS distincte. |
Pour la configuration CORS détaillée, reportez-vous au Guide de configuration CORS.
Pour activer la norme CORS pour votre environnement de développement local, reportez-vous à l’article Présentation du partage de ressources entre origines multiples (CORS).
4. Configuration du formulaire
- Créez un formulaire dans l’éditeur universel.
- Configurez l’action Envoyer pour cibler l’action AEM Forms.
- Indiquez le chemin du point d’entrée d’envoi.
- Publiez le formulaire sur le site Edge Delivery.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
Problème | Solution |
L’envoi du formulaire échoue | Vérifier les erreurs de console, vérifier l’URL du point d’entrée, confirmer les autorisations |
Le formulaire incorporé n’apparaît pas | Configurer des en-têtes CORS sur la source du formulaire, vérifier l’URL du formulaire |
Erreurs 403/401 avec AEM | Mettre à jour le filtre de référent Sling, vérifier les paramètres d’authentification |
Les données n’atteignent pas la feuille de calcul | Vérifier que forms@adobe.com a un accès en modification, vérifier l’URL de la feuille de calcul |
Erreurs CORS | Ajouter les en-têtes Access-Control-Allow-Origin appropriés à la source du formulaire |
Exemples de configurations
- Créer la structure de formulaire dans Google Docs/Sheets
- Configurer le point d’entrée du service d’envoi de formulaires
- Octroyer à
forms@adobe.com
un accès en modification à la feuille de calcul cible - Publier le document sur le site Edge Delivery
- Tester l’envoi du formulaire et le flux de données
- Créer un formulaire dans l’éditeur universel
- Configurer l’action Envoyer sur « Appeler un workflow AEM »
- Configurer Dispatcher et le filtre de référent sur la publication AEM
- Configurer des règles de routage CDN
- Publier le formulaire et tester l’exécution du workflow
Bonnes pratiques
- Utilisez le service d’envoi de formulaire pour les scénarios de capture de données simples.
- Choisissez la publication AEM lorsqu’un traitement ou des intégrations complexes sont requis.
- Testez minutieusement dans l’environnement d’évaluation avant le déploiement en production.
- Surveillez les envois à l’aide des journaux AEM et des erreurs de la console.
- Implémentez une gestion des erreurs appropriée pour les envois ayant échoué.
- Validez les données au niveau du client et du serveur.
- Utilisez HTTPS pour tous les envois de formulaires et la transmission de données.