Réponse

L’activité Réponse termine un workflow d’API et envoie une réponse structurée au demandeur. La réponse comprend généralement un statut et des données supplémentaires.

Utilisez l’activité Réponse pour :

• Renvoyez toujours les bons détails de statut et de réponse.
• Terminez les workflows avec un résultat clair et structuré.
• Gérez les erreurs correctement, surtout lorsqu’elle est combinée à l’activité Essayer de capturer .

L'activité Réponse doit être la dernière étape d'un workflow pour s'assurer que le processus fournit les informations prévues.

Attention : si vous n'ajoutez pas d'activité Réponse , le workflow renvoie la réponse de la dernière requête exécutée. Si une erreur se produit, le workflow renvoie plutôt les détails de l'erreur.

Utilisation de l'activité Response

Pour ajouter une activité Response à votre flux de travail :

1. Sur votre canevas de conception de workflow d'API, sélectionnez l'icône plus (+). Le menu Ajouter une activité s'affiche.
2. Sélectionnez Réponse.
3. Dans le panneau Propriétés , configurez les champs suivants :
   • Saisie de texte
     • Sélectionnez Réussite lorsque le workflow se termine avec succès et renvoie la réponse attendue.
     • Sélectionnez Échec lorsque le workflow rencontre une erreur ou ne dispose pas des données nécessaires pour obtenir une réponse réussie.
   • Détails : utilisez l’ éditeur d’expressions pour définir un objet JSON contenant les informations de réponse souhaitées.
4. Enregistrez la configuration.

Exemple d’activité de réponse

L'exemple suivant récupère un travailleur à partir de Workday et regroupe les détails sur son responsable et ses rapports directs.

L'image suivante montre l'exemple de workflow :

La réponse d'échec

Le workflow renvoie un statut Échec avec un message d'erreur si une étape de récupération échoue.

Pour ce faire :

• Encapsulez les étapes de récupération dans un bloc Try-Catch .
• Si une erreur se produit, l'étape Réponse d'erreur du flux de capture renvoie une réponse d'échec structurée.

Configurez la réponse avec les détails suivants :

• Type—Échec
• Détails : ouvrez l’éditeur d’expressions et écrivez ce qui suit :

  ({
      "error_message": $context.outputs.Try_Catch_3.error.title,
      "status": $context.outputs.Try_Catch_3.error.status
  })

  Ici, $context.outputs.Try_Catch_3.error fournit une sortie d'erreur structurée de l'activité Essayer de capturer . Lorsque le flux Essayer rencontre une erreur lors de l’exécution, le workflow renvoie la sortie suivante :
  

La réponse de réussite

Le workflow renvoie un statut Réussite avec les informations agrégées sur le travailleur. L'activité Rechercher des travailleurs par nom ou ID renvoie un tableau, même lorsqu'il n'y a qu'une seule correspondance. Là, nous utilisons une activité Pour chaque pour traiter chaque résultat, puis consolidons les données à l’aide d’une activité Script .

Configurez la réponse avec les détails suivants :

• Type—Réussite
• Détails : ouvrez l’éditeur d’expressions et écrivez ce qui suit :

  ({
      "workers": $context.outputs.For_Each_2.results
  })

  Ici, workers contient la sortie agrégée de l'étape Script de la boucle For Each . Le workflow renvoie la sortie suivante :