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.
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.
|
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.
•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/Online/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 ».
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.
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.
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.
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).
|
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.
|
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.
|
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.
|
|
