Script

L'activité de script utilise JavaScript pour activer la manipulation de données personnalisée dans votre workflow. Il s’intègre aux workflows d’API et vous permet d’effectuer les actions suivantes :

• Extraire, formater et restructurer les réponses de l’API.
• Agréger et consolider les données.
• Effectuez des calculs et des transformations de données.
• Standardisez les formats de données pour les étapes ultérieures.
• Exécutez dans le contexte d'exécution du workflow en accédant uniquement aux données de workflow existantes et aux sorties d'étape.

Utilisez l'activité Script pour affiner les réponses d'API imbriquées ou fragmentées avant de les transmettre aux activités de workflow ultérieures.

Limites connues

• Vous ne pouvez pas effectuer d’appels d’API à l’aide de l’activité Script . Utilisez l’activité Requête HTTP à la place.
• L’exécution du code JavaScript a un délai d’expiration de 30 secondes.

Utilisation de l'activité Script

Pour ajouter une activité de script à votre workflow :

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 Script.
3. Dans le panneau Propriétés , développez l’éditeur d’expression, puis écrivez votre logique JavaScript dans le panneau Code .
4. Déboguez le workflow pour exécuter l'activité et générer des champs de sortie pour une utilisation ultérieure.

Pour une utilisation optimale, suivez les recommandations suivantes :

• Utilisez l'instruction return pour structurer efficacement les sorties JSON.
• Utilisez .map() pour transformer les tableaux en objets structurés.
• Utilisez le générateur d’expressions Autopilot pour générer automatiquement un JavaScript en fonction du contexte du workflow, minimisant le travail de codage manuel. Par exemple : « J’ai récupéré les réponses de 3 appels HTTP, et fusionnez-les dans un objet JavaScript ».

Exemple d'activité de script

L'exemple suivant consolide les données de plusieurs étapes de workflow en un objet JSON structuré à l'aide de l'activité Script . Cette approche est particulièrement utile avec les API Workday, qui nécessitent souvent plusieurs appels de point de terminaison pour récupérer des ensembles de données complets, tels que les coordonnées des employés, les responsables et les rapports directs.

L'image suivante montre le workflow d'origine, qui va être consolidé en un objet JSON avec l'activité Script.

Ouvrez la fenêtre de configuration de débogage , puis collez et enregistrez la syntaxe JSON suivante :

{
  "first_name": "Betty",
  "last_name": "Liu"
}

1. Sur votre canevas de conception de workflow d'API, ajoutez une activité Script .
2. Ouvrez l’ éditeur d’expressions et collez l’implémentation suivante :

   return {
   
       // Details on the worker
       worker: {
           name: $currentItem.descriptor,
           email: $currentItem.person.email
       },
   
       // Details of their manager
       manager: {
           name: $context.outputs.Workers_3.content.descriptor,
           email: $context.outputs.Workers_3.content.person.email
       },
   
           // Details for their direct reports
       reports: $context.outputs.Workday_REST_HTTP_Request_4.content.data.map(report => ({
           name: report.descriptor,
           email: report.primaryWorkEmail
       }))
   }
   

Faites attention aux domaines suivants dans cet exemple :

• Utilisez $context.outputs pour récupérer les données des précédents appels d’API.
• Utilisation de .map()pour transformer les tableaux en listes de rapports structurées.
• Combinaison de plusieurs réponses d'API en un seul objet JSON.