Configuration d’un formulaire adaptatif pour l’action d’envoi de point d’entrée REST

La possibilité de spécifier le point d’entrée REST à l’aide de la configuration est un programme adopté rapidement qui s’applique uniquement aux composants principaux et à Edge Delivery Services Forms. Vous pouvez écrire à aem-forms-ea@adobe.com à partir de votre ID d’e-mail officiel pour rejoindre le programme des utilisateurs et utilisatrices précoces et demander l’accès à la fonctionnalité.

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.

AEM as a Cloud Service propose différentes actions d’envoi prêtes à l’emploi pour gérer les envois de formulaires. Pour en savoir plus sur ces options, consultez l’article Action d’envoi de formulaire adaptatif.

Avantages

Voici quelques avantages de la configuration de l’action d’envoi Envoyer vers le point d’entrée REST pour le Forms adaptatif :

  • Il permet une intégration transparente des données de formulaire aux systèmes et services externes par le biais d’API RESTful.
  • Il offre une certaine flexibilité pour gérer les envois de données à partir de Forms adaptatif, en prenant en charge les structures de données dynamiques et complexes.
  • Il prend en charge le mappage dynamique des champs de formulaire aux paramètres de l’URL du point d’entrée REST, ce qui permet des envois de données adaptables et personnalisables.

Configuration de l’action d’envoi Envoyer vers le point d’entrée REST steps-to-configure-submit-to-restendpoint-submit-action

Composant de base

Pour configurer l’action d’envoi en fonction de la spécification Swagger Open API pour le formulaire adaptatif basé sur les composants de base, procédez comme suit :

  1. Ouvrez le formulaire adaptatif pour le modifier et accéder à la section Envoi des propriétés du Conteneur de formulaires adaptatifs.

  2. Dans la liste déroulante Action Envoyer, sélectionnez Envoyer vers le point d’entrée REST.

    Configuration de l’action Envoyer vers le point d’entrée Rest

    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.
    Cette option vous permet de saisir directement le point d’entrée REST cible .
    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.
    Mappage pour la transmission des valeurs de champs sous forme de paramètres de page de remerciement

    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 stocke les données XML et att stocke 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 et param2 sont transmis en tant que paramètres avec des valeurs copiées à partir des champs textbox et numericbox pour la prochaine action.

    Configuration de l’action Envoyer vers le point d’entrée REST

    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.

  3. Cliquez sur Terminé.

Composant principal

Pour configurer l’action d’envoi en fonction de la spécification Swagger Open API pour le formulaire adaptatif basé sur les composants principaux, procédez comme suit :

  1. Ouvrez l’explorateur de contenu, puis sélectionnez le composant Conteneur de guide de votre formulaire adaptatif.

  2. Cliquez sur l’icône des propriétés du conteneur de guide Propriétés du guide . La fenêtre du conteneur de formulaires adaptatifs s’ouvre.

  3. Cliquez sur l’onglet Envoi.

  4. Dans la liste déroulante Action Envoyer, sélectionnez Envoyer vers le point d’entrée REST.

    Configuration du point d’entrée Rest

    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.

    Vous disposez de deux options pour spécifier le point d’entrée REST :

    accordion
    URL
    Cette option vous permet de saisir directement le point d’entrée REST cible .

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.

Mappage pour la transmission des valeurs de champs sous forme de paramètres de page de remerciement

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 du champ à 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.

Configuration de l’action Envoyer vers le point d’entrée REST

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.

+++

accordion
Configuration
Cette option vous permet d’ajouter une configuration HTTP prédéfinie gérée via l’explorateur de configurations d’AEM. Vous pouvez sélectionner la configuration créée pour votre type d’authentification de point d’entrée Rest de service et les types de contenu. Pour en savoir plus sur le type d’authentification et les types de contenu, consultez configuration des sources de données
  1. Cliquez sur Terminé.
Éditeur universel

Pour configurer l’action d’envoi en fonction de la spécification de l’API Open Swagger pour le formulaire adaptatif créé dans l’éditeur universel, procédez comme suit :

  1. Ouvrez le formulaire adaptatif pour le modifier.

  2. Cliquez sur l’extension Modifier les propriétés du formulaire dans l’éditeur.
    La boîte de dialogue Propriétés du formulaire s’affiche.

    note note
    NOTE
    • Si l’icône Modifier les propriétés de formulaire ne s’affiche pas dans l’interface de l’éditeur universel, activez l’extension Modifier les propriétés de formulaire dans Extension Manager.
    • Consultez l’article Caractéristiques des fonctionnalités d’Extension Manager pour savoir comment activer ou désactiver les extensions dans l’éditeur universel.

    1. Cliquez sur l’onglet **Envoi** et sélectionnez l’action d’envoi **Envoyer vers le point d’entrée REST**.

    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.

    Vous disposez de deux options pour spécifier le point d’entrée REST :

    accordion
    URL
    Cette option vous permet de saisir directement le point d’entrée REST cible .

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.

Mappage pour la transmission des valeurs de champs sous forme de paramètres de page de remerciement

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 du champ à 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.

Configuration de l’action Envoyer vers le point d’entrée REST

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.

+++

accordion
Configuration
Cette option vous permet d’ajouter une configuration HTTP prédéfinie gérée via l’explorateur de configurations d’AEM. Vous pouvez sélectionner la configuration créée pour votre type d’authentification de point d’entrée Rest de service et les types de contenu. Pour en savoir plus sur le type d’authentification et les types de contenu, consultez configuration des sources de données
  1. Cliquez sur Enregistrer et fermer.

Bonnes pratiques

  • Lors de la publication de données sur un serveur externe, assurez-vous que l’URL est sécurisée et configurez le chemin d’accès pour gérer la requête POST de manière anonyme 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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab