Appeler service REST

Icône Appel REST

Appeler service REST
Cette tâche de workflow permet aux administrateurs d'appeler un service Web externe depuis une tâche de workflow automatique sans programmation.

Paramètres généraux
Vous trouverez ici des informations complémentaires sur les paramètres de tâche de workflow généraux :
Tâches de workflow

Modifier
Ouvre une boîte de dialogue permettant de configurer les paramètres de l’appel REST.

Icône Description
Icône Nouvelle demande

Ajoute un nouvel appel REST.

Icône Modifier la demande

Modifie une demande REST.

Icône Supprimer la demande

Supprime une demande REST.

Icône En haut

Décale la demande REST vers le haut dans la liste. Les appels sont exécutés de haut en bas par défaut.

Icône En bas

Décale la demande REST vers le bas dans la liste.

Nom :
Ajoutez le nom de l'appel REST.

ID de génération de script
Ajoutez un ID de génération de script pour l'appel REST.

Informations d'identification
Sélectionnez des informations d'identification mémorisées dans le référentiel central pour vous authentifier auprès du fournisseur du point de terminaison utilisé pour l'appel.
Informations d'identification

Verbe
Sélectionnez la méthode de requête HTTP dans le menu déroulant.

Options du menu déroulant

Requête Fonction

GET

Récupère les données d'un serveur dans la ressource indiquée.

POST

Envoie des données au serveur d'API pour créer ou mettre à jour une ressource.

PUT

Envoie des données à l'API pour mettre à jour ou créer une ressource. Ce qui distingue les deux options est que les requêtes PUT produisent toujours le même résultat.

DELETE

Supprime la ressource dans la ressource indiquée.

PATCH

Similaire aux options POST et PUT, mais ne s'applique qu'à des modifications partielles de la ressource.

Champ URL
Espace réservé à l'URL de l'appel de Web Service.

Macros
Ouvre une boîte de dialogue contenant toutes les macros disponibles.

Script
Vous pouvez créer un script d'initialisation qui sera exécuté avant l'exécution des affectations de champs. Vous pouvez également définir ici des variables et fonctions que pourront utiliser les scripts d'affectation.

Tester
Exécute un appel d'API test qui vérifie s'il est possible de communiquer avec Web Service et s'il est possible d'obtenir une réponse. Ouvre une boîte de dialogue pour illustrer le résultat du test.

Paramètres
Indique les paramètres requis pour envoyer et recevoir.

Ajouter
Ajoutez un paramètre.

Supprimer
Supprimez un paramètre.

En-tête
Affiche les en-têtes requis pour envoyer ou recevoir.

Document
Si un document doit être envoyé à un service tiers via l’appel REST, configurez le contenu et la méthode d’envoi.

Corps
Affiche les valeurs et objets JSON.

Insérer
Sélectionnez un objet ou une valeur JSON à afficher.

Supprimer
Supprimez un objet ou une valeur JSON.

Charger la requête JSON
Téléchargez un fichier JSON dans Corps. La valeur JSON peut être extraite d’un fichier sur votre périphérique ou ajoutée directement depuis votre Presse-papiers.

Réponse
Définissez la réponse à recevoir du service tiers.

Codes de réussite
Recense les codes que l'appel d'API doit considérer comme une réussite.

Script
Vous pouvez créer un script d'initialisation qui sera exécuté avant l'exécution des affectations de champs. Vous pouvez également définir ici des variables et fonctions que pourront utiliser les scripts d'affectation.

Charger la réponse JSON
Téléchargez un fichier JSON dans Corps. La réponse JSON peut être chargée à partir d’un fichier sur votre périphérique ou ajoutée directement depuis votre Presse-papiers.

Icône Infos

Remarque :

  • Les appels REST ont pour objet d’effectuer des appels sortants aux applications tierces. Bien qu’il soit possible d’appeler l’API Therefore à l’aide d’appels REST, la fonction répond mal aux besoins avancés, en particulier lorsque vous manipulez des données d’index.

  • Pour que les applications tierces accèdent à Therefore™ sans faire appel à l'authentification à deux facteurs, elles requièrent un compte de service. Pour plus d'informations, reportez-vous à la page de référence ci-dessous :
    Utilisateurs et groupes