Action Envoyer pour formulaire adaptatif
| Version | Lien de l’article |
|---|---|
| AEM 6.5 | Cliquez ici |
| AEM as a Cloud Service (composants principaux) | Cliquer ici |
| AEM as a Cloud Service (composants de base) | Cet article |
S’applique à : ✔️ les composants de base de formulaire adaptatif. ❌ Composants principaux de formulaire adaptatif. Adobe recommande d’utiliser les composants principaux pour ajouter un Forms adaptatif à une page AEM Sites ou pour créer un Forms adaptatif autonome.
Une action d’envoi est déclenchée lorsqu’un utilisateur clique sur le bouton Envoyer d’un formulaire adaptatif. Forms as a Cloud Service fournit les actions Envoyer suivantes prêtes à l’emploi.
Vous pouvez également étendre les actions d’envoi par défaut pour créer votre propre action d’envoi.
Vous pouvez configurer une action d’envoi dans la section Envoi des propriétés du conteneur de formulaire adaptatif, dans la barre latérale.
Envoyer vers le point d’entrée REST
Utilisez l’action Envoyer vers le point d’entrée REST pour transmettre les données envoyées à l’URL REST. L’URL peut être celle d’un serveur interne (le serveur sur lequel le formulaire est rendu) ou externe.
Pour publier des données sur un serveur interne, indiquez le chemin de la ressource. Les données sont publiées avec le chemin de la ressource. Par exemple, /content/restEndPoint. Pour ces requêtes de publication, les informations d’authentification de la requête d’envoi sont utilisées.
Pour publier des données sur un serveur externe, indiquez une URL. Le format d’URL est le suivant : https://host:port/path_to_rest_end_point. Assurez-vous de configurer le chemin pour que la requête POST soit traitée anonymement.
Dans l’exemple ci-dessus, les informations saisies par l’utilisateur dans textbox sont capturées au moyen du paramètre param1. La syntaxe permettant de publier les données capturées au moyen de param1 est :
String data=request.getParameter("param1");
De même, les paramètres que vous utilisez pour publier des données XML et des pièces jointes sont dataXml et attachments.
Par exemple, vous utilisez ces deux paramètres dans votre script pour analyser les données à un point d’entrée REST. Vous utilisez la syntaxe suivante pour stocker et analyser les données :
String data=request.getParameter("dataXml");String att=request.getParameter("attachments");
Dans cet exemple, data contient les données XML et att les données des pièces jointes.
L’option d’envoi Envoyer vers le point d’entrée REST transmet les données renseignées dans le formulaire à une page de confirmation configurée dans le cadre de la requête HTTP GET. Vous pouvez ajouter le nom des champs à demander. Le format de la requête est :
{fieldName}={request parameter name}
Comme illustré ci-dessous, param1 et param2 sont transmis en tant que paramètres avec des valeurs copiées à partir des champs textbox et numericbox pour la prochaine action.
Vous pouvez également Activer la requête POST et fournir une URL pour la publication de la requête. Pour envoyer des données au serveur AEM qui héberge le formulaire, utilisez un chemin d’accès relatif correspondant au chemin racine du serveur AEM. Par exemple, /content/forms/af/SampleForm.html. Pour envoyer des données vers un autre serveur, utilisez un chemin d’accès absolu.
REMARQUEEnvoyer un e-mail
Vous pouvez utiliser l’action d’envoi Envoyer un e-mail pour envoyer un e-mail à un ou à plusieurs destinataires lors de l’envoi réussi du formulaire. Le message généré peut contenir des données de formulaire dans un format prédéfini. Par exemple, dans le modèle suivant, le nom du client, l’adresse d’expédition, le nom de l’État et le code postal sont récupérés à partir des données de formulaire envoyées.
"
Hi ${customer_Name},
Les paramètres suivants sont définis comme votre adresse de livraison par défaut :
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}
Regards,
WKND
"
- Tous les champs de formulaire doivent avoir des noms d’élément différents, même si les champs sont placés sur différents panneaux d’un formulaire adaptatif.
- AEM as a Cloud Service exige que le e-mails sortants soient chiffrés. Par défaut, les e-mails sortants sont désactivés. Pour les désactiver, envoyez un ticket d’assistance à Demande d’accès.
Vous pouvez également inclure des pièces jointes et un document d’enregistrement (DE) à l’e-mail. Pour activer l’option Joindre le document d’enregistrement, configurez le formulaire adaptatif pour générer un document d’enregistrement (DE). Vous pouvez activer cette option pour générer un document d’enregistrement à partir des propriétés de formulaire adaptatif.
Envoyer à l’aide du modèle de données de formulaire (FDM)
L’action d’envoi Envoyer à l’aide du modèle de données de formulaire écrit les données de formulaire adaptatif envoyés pour l’objet de modèle de données spécifié dans un modèle de données de formulaire (FDM) dans sa source de données. Lors de la configuration de l’action d’envoi, vous pouvez sélectionner un objet de modèle de données dont vous souhaitez écrire les données envoyées dans sa source de données.
En outre, vous pouvez envoyer une pièce jointe de formulaire à l’aide d’un modèle de données de formulaire (FDM) et d’un document d’enregistrement (DE) à la source de données. Pour plus d’informations sur le modèle de données de formulaire (FDM), voir AEM Forms Intégration de données.
Appeler un processus AEM
L’action d’envoi Appeler un processus AEM associe un formulaire adaptatif à un processus AEM. Lorsqu’un formulaire est envoyé, le processus associé commence automatiquement sur l’instance de création. Vous pouvez enregistrer le fichier de données, les pièces jointes et le document d’enregistrement à l’emplacement de la payload du workflow ou dans une variable. Si le processus est marqué pour le stockage de données externe et configuré pour un stockage de données externe, seule l’option variable est disponible. Vous pouvez choisir dans la liste des variables disponibles pour le modèle de workflow. Si le processus est marqué pour le stockage des données externes à une étape ultérieure et non au moment de la création du processus, assurez-vous que les configurations de variable requises sont en place.
L’action Envoyer place les éléments suivants à l’emplacement de la payload du workflow, ou de la variable si le workflow est marqué pour le stockage de données externe :
-
Fichier de données : Il contient les données envoyées au formulaire adaptatif. Vous pouvez utiliser l’option Chemin d’accès au fichier de données pour spécifier le nom du fichier et le chemin d’accès du fichier par rapport à la charge utile. Par exemple, le chemin d’accès
/addresschange/data.xmlcrée un dossier nomméaddresschangeet le place par rapport à la charge utile. Vous pouvez également spécifier uniquementdata.xmlpour envoyer uniquement les données envoyées sans créer de hiérarchie de dossiers. Si le workflow est marqué pour le stockage de données externe, utilisez l’option variable et sélectionnez la variable dans la liste des variables disponibles pour le modèle de workflow. -
Pièces jointes : vous pouvez utiliser l’option Chemin d’accès aux pièces jointes pour spécifier le nom de dossier dans lequel stocker les pièces jointes chargées dans le formulaire adaptatif. Le dossier est créé par rapport à la payload. Si le workflow est marqué pour le stockage de données externe, utilisez l’option variable et sélectionnez la variable dans la liste des variables disponibles pour le modèle de workflow.
-
Document d’enregistrement : il contient le document d’enregistrement généré pour le formulaire adaptatif. Vous pouvez utiliser l’option Chemin du document d’enregistrement pour spécifier le nom du fichier de document d’enregistrement et le chemin d’accès du fichier par rapport à la charge utile. Par exemple, le chemin d’accès
/addresschange/DoR.pdfcrée un dossier nomméaddresschangerelatif à la charge utile et placeDoR.pdfrelatif à la charge utile. Vous pouvez également spécifier uniquementDoR.pdfpour n’enregistrer que le document d’enregistrement sans créer de hiérarchie de dossiers. Si le workflow est marqué pour le stockage de données externe, utilisez l’option variable et sélectionnez la variable dans la liste des variables disponibles pour le modèle de workflow.
Avant d’utiliser l’action Envoyer Appeler un processus AEM, configurez les éléments suivants pour la configuration du service de paramètres AEM DS :
-
URL du serveur de traitement : le serveur de traitement est le serveur sur lequel le processus Forms ou AEM est déclenché. Il peut s’agir de l’URL de l’instance de création AEM ou d’un autre serveur.
-
Nom d’utilisateur du serveur de traitement : nom d’utilisateur de l’utilisateur ou de l’utilisatrice du workflow
-
Mot de passe du serveur de traitement : mot de passe de l’utilisateur ou de l’utilisatrice du workflow
Envoyer à SharePoint
L’action de soumission Soumettre à SharePoint connecte un formulaire adaptatif à un stockage Microsoft® SharePoint. Vous pouvez envoyer le fichier de données de formulaire, les pièces jointes ou le document d’enregistrement au stockage Microsoft® SharePoint connecté.
À l’aide de l’option Envoyer vers SharePoint, vous pouvez :
Connecter un formulaire adaptatif à la bibliothèque de documents SharePoint
Pour utiliser l’action d’envoi Envoyer à la bibliothèque de documents SharePoint dans un formulaire adaptatif :
- Création d’une configuration de bibliothèque de documents SharePoint : connecte AEM Forms à votre stockage Microsoft® SharePoint.
- Utiliser l’action d’envoi Soumettre à SharePoint dans un formulaire adaptatif : connecte votre formulaire adaptatif au stockage Microsoft® SharePoint configuré.
Création d’une configuration de bibliothèque de documents SharePoint
Pour connecter AEM Forms au stockage de la bibliothèque de documents Microsoft® SharePoint :
-
Accédez à votre instance de création AEM Forms > Outils > Services cloud > Microsoft® SharePoint.
-
Une fois que vous avez sélectionné le stockage Microsoft® SharePoint, l’interface vous redirige vers le navigateur SharePoint.
-
Sélectionnez un conteneur de configuration. La configuration est stockée dans le conteneur de configuration sélectionné.
-
Cliquez sur Créer > Bibliothèque de documents SharePoint dans la liste déroulante. L’assistant de configuration SharePoint s’affiche.
-
Spécifiez le titre, l’ID client, le secret client et l’URL OAuth. Pour savoir comment récupérer l’ID client et le secret client pour l’URL OAuth, consultez la documentation Microsoft®.
- Vous pouvez récupérer l’
Client IDet leClient Secretde votre application sur le portail Microsoft® Azure. - Sur le portail Microsoft® Azure, ajoutez l’URI de redirection en tant que
https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Remplacez[author-instance]par l’URL de votre instance de création. - Ajoutez les autorisations d’API
offline_accessetSites.Manage.Allpour fournir les autorisations de lecture/écriture. - Utilisez l’URL OAuth
https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Remplacez<tenant-id>par letenant-idde votre application depuis le portail Microsoft® Azure.
REMARQUELe champ du secret client est obligatoire ou facultatif selon la configuration de votre application Azure Active Directory. Si votre application est configurée pour utiliser un secret client, vous devez l’indiquer. - Vous pouvez récupérer l’
-
Cliquez sur Connecter. Lors d’une connexion réussie, le message
Connection Successfuls’affiche. -
Maintenant, sélectionnez Site SharePoint > Bibliothèque de documents > Dossier SharePoint, pour enregistrer les données.
REMARQUE- Par défaut,
forms-ootb-storage-adaptive-forms-submissionest présent sur le site SharePoint sélectionné. - Créez un dossier sous la forme
forms-ootb-storage-adaptive-forms-submission, s’il n’est pas déjà présent dans la bibliothèqueDocumentsdu site SharePoint sélectionné en cliquant sur Créer un dossier.
- Par défaut,
Vous pouvez désormais utiliser cette configuration de sites SharePoint pour l’action d’envoi dans un formulaire adaptatif.
Utilisation de la configuration de la bibliothèque de documents SharePoint dans un formulaire adaptatif
Vous pouvez utiliser la configuration de bibliothèque de documents SharePoint créée dans un formulaire adaptatif pour enregistrer des données ou un document d’enregistrement généré dans un dossier SharePoint. Pour utiliser une configuration de stockage de bibliothèque de documents SharePoint dans un formulaire adaptatif, procédez comme suit :
-
Créez un formulaire adaptatif.
REMARQUE- Sélectionnez le même Conteneur de configurations pour le formulaire adaptatif dans lequel vous avez créé le stockage de votre bibliothèque de documents SharePoint.
- Si aucun conteneur de configuration n’est sélectionné, les dossiers de configuration de stockage globaux s’affichent dans la fenêtre des propriétés de l’action d’envoi.
-
Sélectionnez l’action d’envoi Soumettre à SharePoint.
-
Sélectionnez la configuration de stockage où vous souhaitez enregistrer vos données.
-
Cliquez sur Enregistrer pour enregistrer les paramètres d’envoi.
Lorsque vous envoyez le formulaire, les données sont enregistrées dans le stockage de bibliothèque de documents Microsoft® SharePoint spécifié.
La structure du dossier pour l’enregistrement des données est /folder_name/form_name/year/month/date/submission_id/data.
REMARQUE/folder_name/form_name/year/month/date/submission_id/data. Cependant, si vous sélectionnez Enregistrer les pièces jointes avec le nom d’origine, les pièces jointes sont stockées dans le dossier à l’aide de leurs noms de fichier d’origine.
