Therefore™ Help

Zoom Window Out
↑ Texte | ↓ Texte
Cacher l'en-tête de la page
Developer le texte
Version imprimable
Sauvegarder URL Permalink

Didacticiels > Solution Designer > Workflow

Appel d'un service Web REST depuis un workflow

1.Dans cet exemple, nous allons utiliser la fonction Appel REST pour publier de nouvelles informations issues de Therefore™ dans le service Web. Pour démarrer le processus, créez une tâche de workflow Appeler service REST au sein d'un workflow.

sd_t_workflow_RESTCall_001a

2.Définissez le type de demande (GET, POST, PUT, DELETE ou PATCH, selon l'instruction). Dans cet exemple, nous allons utiliser le type POST.

sd_t_workflow_RESTCall_002a

info

Remarque :

•Dans le champ URL de la ressource, vous pouvez utiliser des macros afin de disposer d'une souplesse accrue pour envoyer des informations au service Web et en recevoir de celui-ci.

sd_t_workflow_RESTCall_003a

•S'il est nécessaire de définir des paramètres dans le cadre de l'appel REST, vous pouvez les configurer sur l'onglet Paramètres de la boîte de dialogue ci-dessus.

•Vous pouvez exécuter plusieurs appels REST à l’aide d’une seule tâche Appeler service REST. Il est ainsi possible de mémoriser des variables et vous n’entrez qu’une seule fois les informations d’identification. Vous trouverez dans Ressources complémentaires un exemple d’utilisation de cette fonctionnalité :https://therefore.net/help/2024/en-us/AR/conn_md365_bc_cpi.html

3.Entrez les informations requises sur l'onglet Autorisation pour autoriser l'application auprès du système externe. Dans cet exemple, nous utilisons « OAuth - Code d'autorisation ».

sd_t_workflow_RESTCall_004a

4.Définissez ensuite tout autre en-tête requis depuis l'appel sur l'onglet En-tête. Cliquez sur le bouton Ajouter... pour définir d'autres en-têtes. Dans cet exemple, nous n'avons besoin que d'un en-tête « Accept » destiné à demander au service Web de renvoyer un fichier json plutôt qu'un fichier xml.

sd_t_workflow_RESTCall_005a

5.Dans la section Corps, vous devez définir une structure sur laquelle sera basé le nouveau document. Dans cet exemple, les champs du document peuvent être renseignés à l'aide de valeurs de données d'index.

sd_t_workflow_RESTCall_006a

6.Dans la section Codes d'état, définissez les codes indiquant que l'opération a réussi. Si l'appel mène à une opération réussie, l'instance du workflow peut être acheminée vers la tâche suivante.

sd_t_workflow_RESTCall_007a

7.Définissez ensuite les informations Gestion des réponses pour configurer la mise à jour des informations en cours en fonction de la réponse de l'appel REST. Dans cet exemple, l'ID de la facture (« Bill Id ») figurant dans le nouveau document sera inclus dans les données d'index de Therefore™ (sous InvoiceId et Invoice No).

sd_t_workflow_RESTCall_008a

info

Remarque :

Avant de traiter un workflow, cliquez sur le bouton Test pour vérifier que la fonction Appel REST peut communiquer avec l'API du service Web pour les actions définies.

sd_t_workflow_RESTCall_009a

8.Une fois toutes les informations requises entrées, cliquez sur OK. Vous pouvez maintenant démarrer l'instance du workflow en tant que telle.

sd_t_workflow_RESTCall_010a

info

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.