Configuration d’un formulaire adaptatif pour une action d’envoi point de fin REST
Utilisez l’action Submit to REST Endpoint pour publier les données envoyées vers une URL REST. L’URL peut être celle d’un serveur interne (le serveur sur lequel le formulaire est rendu) ou externe.
AEM as a Cloud Service propose différentes actions d’envoi prêtes à l’emploi pour gérer les envois de formulaire. Vous pouvez en savoir plus sur ces options dans l’article Action d’envoi de formulaire adaptatif .
Avantages
Voici quelques-uns des avantages de la configuration de l’action d’envoi Envoyer vers le point de terminaison REST pour le Forms adaptatif :
- Il permet une intégration transparente des données de formulaire avec des systèmes et services externes via les API RESTful.
- Il offre une certaine flexibilité pour gérer les envois de données depuis Forms adaptatif, en prenant en charge des structures de données dynamiques et complexes.
- Il prend en charge le mappage dynamique des champs de formulaire aux paramètres dans l’URL du point de terminaison REST, ce qui permet les envois de données adaptables et personnalisables.
Configuration de l’action d’envoi Envoyer vers le point de fin REST steps-to-configure-submit-to-restendpoint-submit-action
Pour configurer l’action d’envoi :
-
Ouvrez l’explorateur de contenu, puis sélectionnez le composant Conteneur de guide de votre formulaire adaptatif.
-
Cliquez sur l’icône des propriétés du conteneur de guide . La fenêtre du conteneur de formulaires adaptatifs s’ouvre.
-
Cliquez sur l’onglet Envoi.
-
Dans la liste déroulante Submit Action , sélectionnez Submit to Rest endpoint.
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ètreparam1
. La syntaxe permettant de publier les données capturées au moyen deparam1
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
etattachments
.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 etatt
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 du champ à demander. Le format de la requête est :
{fieldName}={request parameter name}
Comme illustré ci-dessous,
param1
etparam2
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. -
Cliquez sur Terminé.
Bonnes pratiques
- Lorsque vous publiez des données sur un serveur externe, assurez-vous que l’URL est sécurisée et configurez le chemin pour gérer anonymement la demande du POST afin de protéger les informations sensibles.
- Pour transmettre les champs en tant que paramètres dans une URL REST, tous les champs doivent avoir des noms d’éléments différents, même s’ils sont placés sur différents panneaux.
Articles connexes
- Envoyer un e-mail
- Envoyer à SharePoint
- Envoyer à l’aide du modèle de données de formulaire
- Envoyer au stockage Blob Azure
- Envoyer vers le point d’entrée REST
- Envoyer à OneDrive
- Appeler un workflow AEM
- Envoyer à Power Automate
- Envoyer vers Workfront Fusion
- Connecter un formulaire adaptatif à l’application Salesforce
- Connecter un formulaire adaptatif à Microsoft