Wenn (If)

Die Aktivität If ermöglicht bedingte Verzweigungen in API-Workflows, um dynamische Ausführungspfade basierend auf datengesteuerten Bedingungen zu erstellen. Verwenden Sie die Aktivität If für Workflows, die unterschiedliche Aktionen erfordern, abhängig von Echtzeit-API-Antworten, Benutzereingaben oder Systemzuständen.

Verwenden der If-Aktivität

So fügen Sie Ihrem Workflow eine If -Aktivität hinzu:

1. Wählen Sie auf der Arbeitsfläche Ihres API-Workflow-Designers das Pluszeichen (+) aus. Das Menü Aktivität hinzufügen wird angezeigt.
2. Wählen Sie Wenn aus.
3. Schreiben Sie im Eigenschaftenbereich den Ausdruck in das Feld Bedingung .
4. Fügen Sie nach Bedarf Aktivitäten zu den Then- und Else- Verzweigungen hinzu.
5. Testen Sie den Workflow, um die Aktivität auszuführen, und generieren Sie Ausgabefelder für die spätere Verwendung.

Beispiel für If-Aktivität

Das folgende Beispiel stellt sicher, dass ein Transaktionssynchronisierungs-Workflow nur aktive Kunden verarbeitet, die in den letzten 24 Stunden mindestens eine Transaktion durchgeführt haben. Sind die Bedingungen nicht erfüllt, wird der Workflow mit einer Fehlerantwort beendet.

Öffnen Sie das Fenster Konfigurationsfenster debuggen , und fügen Sie dann die folgende JSON-Syntax ein und speichern Sie sie:

{
  "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. Fügen Sie auf der Canvas Ihres API-Workflowdesigners eine If -Aktivität hinzu.
2. Wählen Sie das Feld Bedingung im Eigenschaftenbereich aus, um den Ausdrucks-Editor zu öffnen.
3. Verwenden Sie den Autopilot-Ausdrucksgenerator, um Ihre Bedingung zu erstellen, und führen Sie Folgendes aus:

   „Schreiben Sie eine bedingte Anweisung, die überprüft, ob die Eingabeanforderung für einen aktiven Kunden bestimmt ist und dass mindestens ein Transaktionsobjekt vorhanden ist, das in den letzten 24 Stunden erstellt wurde.“

   Die Antwort sollte folgendermaßen aussehen:

   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. Überprüfen Sie die Panels Aktivitätstesteingabe und Ausdrucksausgabe, um sicherzustellen, dass der Ausdruck die erwarteten Ergebnisse generiert.
5. Speichern Sie die Bedingungskonfiguration .
6. Fügen Sie der Verzweigung Dann eine Aktivität Antwort hinzu.
7. Konfigurieren Sie die Antwort wie folgt:
   • Typ– Fehler
   • Details– Öffnen Sie den Ausdruckseditor und schreiben Sie Folgendes:

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

   Dieser Schritt fügt am Anfang des Workflows eine Validierung hinzu, um zu bestätigen, dass vor der Verarbeitung eine gültige Transaktion vorhanden ist.