Si (If)

L'activité Si permet aux branches conditionnelles dans les workflows d'API de créer des chemins d'exécution dynamiques basés sur des conditions centrées sur les données. Utilisez l’activité Si pour les workflows qui nécessitent différentes actions en fonction des réponses d’API en temps réel, des entrées utilisateur ou des états du système.

Utilisation de l'activité If

Voici comment ajouter une activité Si à 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 Si.
3. Dans le panneau Propriétés, écrivez l’expression dans le champ Condition .
4. Ajoutez des activités aux branches Puis et Sinon selon vos besoins.
5. Testez le workflow pour exécuter l'activité et générer des champs de sortie pour une utilisation ultérieure.

Exemple d’activité de type Si

L'exemple suivant garantit qu'un workflow de synchronisation des transactions traite uniquement les clients actifs qui ont effectué au moins une transaction au cours des dernières 24 heures. Si les conditions ne sont pas remplies, le workflow se termine avec une réponse d'échec.

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

{
  "id": 12345,
  "name": "John Doe",
  "isActive": true,
  "balance": 2500.75,
  "createdAt": "2025-03-25T12:00:00Z",
  "tags": [
    "premium",
    "verified",
    "active"
  ],
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.006
    }
  },
  "transactions": [
    {
      "transactionId": "txn_001",
      "amount": 150.5,
      "currency": "USD",
      "timestamp": "2025-03-25T10:30:00Z"
    },
    {
      "transactionId": "txn_002",
      "amount": -75.25,
      "currency": "USD",
      "timestamp": "2025-03-23T08:15:00Z"
    }
  ]
}

1. Sur votre canevas de conception de workflow d'API, ajoutez une activité Si .
2. Sélectionnez le champ Condition dans le panneau Propriétés pour ouvrir l’éditeur d’expression.
3. Utilisez le générateur d’expressions Autopilot pour créer votre condition et invitez-la comme suit :

   « Rédigez une instruction conditionnelle qui vérifie que la demande d’entrée concerne un client actif et qu’au moins un objet de transaction a été créé au cours des dernières 24 heures ».

   La réponse doit ressembler à ceci :

   const now = new Date();
   const twentyFourHoursAgo = new Date(now.getTime() - 24 * 60 * 60 * 1000);
   
   if ($workflow.input.isActive) {
     const recentTransactions = $workflow.input.transactions.filter(transaction => {
       const transactionTimestamp = new Date(transaction.timestamp);
       return transactionTimestamp > twentyFourHoursAgo;
     });
   
     const hasRecentTransactions = recentTransactions.length > 0;
   
     hasRecentTransactions;
   } else {
     false;
   }

4. Vérifiez les panneaux Entrée de test de l’activité et Sortie de l’expression pour vérifier que l’expression génère les résultats attendus.
5. Enregistrez la configuration des conditions .
6. À la branche Puis , ajoutez une activité Réponse .
7. Configurez la réponse comme suit :
   • Type—Échec
   • Détails : ouvrez l’éditeur d’expressions et écrivez ce qui suit :

     {
         message: "Customer is not active or no transaction to process"
     }

   Cette étape ajoute une validation au début du workflow pour confirmer qu'une transaction valide existe avant le traitement.