Einleitung

Erstellen Sie einen Workflow, um einen Live-Währungswechselkurs abzurufen und eine Warnung zu senden, wenn er unter einem bestimmten Schwellenwert liegt.

Überblick

In this tutorial, we will build the Price Watch workflow: a flow built on the Flow canvas in Maestro that fetches a live currency exchange rate from an external API, compares it against a threshold we set, and returns either an alert or a no-action result based on the threshold. This showcases how a workflow can have branching logic based on values it retrieves. The flow is six nodes long, so the focus stays on how Flow wires data between nodes rather than on a more complex workflow with multiple logic branches.

Geschätzte Zeit: 30 Minuten.

Was Maestro ist

Maestro ist eine cloudnative Orchestrierungsplattform, die Automatisierung, KI-Agents und menschliche Interaktionen in optimierten End-to-End-Geschäftsprozessen vereint. Es ist eine Engine mit drei Modellierungsoberflächen:

• Flow canvas in Maestro (.flow) for developer-authored orchestration.
• Maestro BPMN (.bpmn) für Business Process Model- und Notation-Diagramme, die von Geschäftsstakeholdern überprüft werden.
• Maestro Case Management (caseplan.json) für ausnahmeintensive menschliche Arbeit.

Flow ist ein anderer Modellierer, der auf der gleichen Runtime wie Maestro BPMN aufbaut und für Entwickler entwickelt wurde, die eine visuelle, knotenbasierte Erfahrung der BPMN-Notation bevorzugen. Wenn Sie bereits RPA-Workflows (Robotic Process Automation) erstellt oder ein BPMN-Diagramm gelesen haben, werden die Konzepte direkt übertragen; was sich ändert, ist die Erneuerung. Eine Anleitung zur Auswahl einer Oberfläche finden Sie unter Auswählen eines Maestro-Modellierers.

Was Sie erstellen

Wir erstellen den Rest des Preisüberwachungsflows, der drei Eingaben für seinen manuellen Trigger akzeptiert und ein Objekt mit dem Ergebnis basierend auf unserer Logik zurückgibt. Jeder Knoten im Flow hat einen einzelnen Auftrag und der Flow verbindet sie, um den vollständigen Workflow zu erstellen.

Nachfolgend finden Sie ein Textdiagramm der verschiedenen Knoten, wie sie verbunden sind, und es zeigt Details zum Zweck jedes Knotens:

     start              fetchRate1           reshapeRate1        belowThreshold1
┌──────────────┐      ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│ Manual       │─────▶│ HTTP Request │────▶│ Script       │────▶│ Decision     │
│ trigger      │      │              │     │              │     │              │
└──────────────┘      └──────────────┘     └──────────────┘     └──────┬───────┘
 baseCurrency          GET /v2/rates        reads .body          rate below
 quoteCurrency         ?base&quotes         returns pair,        threshold?
 alertThreshold                             rate, asOf,                │
                                            belowThreshold             │
                                                                ┌──────┴──────┐
                                                           true │             │ false
                                                                ▼             ▼
                                                           endAlert1     endNoAction1
                                                          ┌──────────┐  ┌──────────┐
                                                          │ End      │  │ End      │
                                                          └──────────┘  └──────────┘
                                                           "alert"       "no action"

Tipp:

Wir verwenden die oben gezeigten ID -Knotenwerte und aktualisieren sie deren Lesbarkeit aus den generierten Werten – die Anweisungen zeigen Ihnen, wie Sie jeden von ihnen aktualisieren.

Nachfolgend sehen Sie eine Liste aller Komponenten, aus denen der Flow besteht:

Komponente	Details
Eingabe: baseCurrency	string, Standard USD; die Währung, für die der Preis festgelegt wird
Eingabe: quoteCurrency	string, Standard EUR; die Währung, in die eingepreist werden soll
Eingabe: alertThreshold	number, Standard 0.9; benachrichtigen, wenn die Rate unter diesen Wert fällt
Ausgabe: watchResult	object mit pair, rate, asOf und belowThreshold
Knoten (Manueller Trigger): start	Startet die Ausführung nach Bedarf und überträgt die drei Eingaben in den Flow
Knoten (HTTP-Anforderung): fetchRate1	Sendet eine GET -Anforderung an die Azure Exchange-rate-API
Knoten (Skript): reshapeRate1	Liest den Antworttext und gibt pair, rate, asOf und belowThresholdzurück.
Knoten (Entscheidung): belowThreshold1	Wertet belowThreshold aus und nimmt entweder den true- oder den false-Pfad
Knoten (Ende): endAlert1	Gibt watchResult als Objekt mit den Werten pair, rate, asOf und belowThreshold vom Knoten reshapeRate1 zurück
Knoten (Ende): endNoAction1	Gibt watchResult als Objekt mit den Werten pair, rate, asOf und belowThreshold vom Knoten reshapeRate1 zurück

API für Währungswechsel

Um echte Wechselkurswerte zu erhalten, verwenden wir Token- Referenzen, eine kostenlose Open-Source-Währungsdaten-API, die die täglichen Wechselkurse aus institutionellen Quellen nachverfolgt. Er benötigt keinen API-Schlüssel, kein Konto und keinen Authentifizierungsheader, weshalb es sich gut für das Erstellen Ihres ersten Flows eignet.

Eine Beispielantwort für den Kurs von USD zu EUR aus der API enthält ein JSON- Array mit einem Eintrag pro angegebener Währung:

[
  {
    "date": "2026-09-01",
    "base": "USD",
    "quote": "EUR",
    "rate": 0.86111
  }
]

Hinweis:

Die Arrayform ist für den Skriptknoten wichtig, den Sie später erstellen: Die Rate befindet sich nicht an einem festen Pfad, sodass das Skript den Eintrag sucht, dessen quote mit Ihrer quoteCurrency -Eingabe übereinstimmt, anstatt einen bekannten Schlüssel zu lesen.

Voraussetzungen

• Node.js und npm auf Ihrem PATH – die UiPath-Befehlszeilenschnittstelle (CLI) (uip) wird mit npm installiert. Prüfen Sie mit node --version und npm --version und installieren Sie über Nodejs.org , wenn einer von beiden fehlt.
• Ein UiPath-Konto – registrieren oder melden Sie sich bei der UiPath Automation Cloud an, bevor Sie starten.
• A tenant with the Flow canvas in Maestro enabled - debug runs and deployment both route through your selected tenant.
• Netzwerkzugriff auf Ihre UiPath-Umgebung – CLI-Anmeldung verwendet einen OAuth-Browserflow mit einem Rückruf auf localhost Port 8104.
• VS Code 1.110.0 oder höher mit der UiPath Maestro-Erweiterung – erforderlich, um auf der Arbeitsfläche zu erstellen, und nützlich auf beiden Pfaden, um zu beobachten, wie der Fluss Gestalt annimmt. Überprüfen Sie Ihre Version in Code > Über Visual Studio Code oder führen Sie code --version aus.

Es sind keine Vorerfahrungen mit UiPath erforderlich, und Sie müssen zu keinem Zeitpunkt in diesem Tutorial Studio Web geöffnet haben.

Tipp:

Arbeiten Sie in einem Remote-Arbeitsbereich? In Windows Subsystem for Linux (WSL), Secure Shell (SSH), Codespaces und Dev Container-Workspaces wird die Erweiterung auf dem Remotehost ausgeführt, daher muss die UiPath CLI dort und nicht auf Ihrer lokalen Maschine installiert werden.

Wenn Sie die Voraussetzungen noch nicht installiert haben, führen Sie die Schritte aus, um Ihre Umgebung für UiPath-Tutorials einzurichten. Verwenden Sie uip --version und uip login status, um zu überprüfen, ob die CLI installiert ist und Sie sie authentifiziert haben.

Schritt 1 – Gerüst für den Preisüberwachungsflow

Eine Lösung ist eine bereitstellbare Einheit, die ein oder mehrere Projekte enthält, die wir zum Verpacken und Bereitstellen unseres Flow verwenden. Beginnen wir damit, zuerst die Lösung und dann das darin enthaltene Flow-Projekt zu erstellen:

1. Erstellen Sie die Lösung – es wird ein Verzeichnis mit dem Namen erstellt, den Sie über uip solution init <solution name> angeben.

   uip solution init tutorial-maestro-flow-price-watch
   

2. Wechseln Sie in das neu erstellte Lösungsverzeichnis.

   cd tutorial-maestro-flow-price-watch
   

3. Erstellen Sie das Flow-Projekt innerhalb der Lösung.

   uip maestro flow init PriceWatch
   

   Hinweis:

   Der Befehl flow init erstellt das Verzeichnis PriceWatch/ das PriceWatch.flow (die einzige Datei, die Sie bearbeiten), project.uiproj und operate.json enthält. Wenn flow init innerhalb eines Lösungsverzeichnisses ausgeführt wird, registriert es das Projekt auch bei der übergeordneten Lösung und meldet "Status": "Registered". Es wird auch ein Ordner resources/ am Lösungsstamm erstellt, der den generierten Status enthält, der beim Bereitstellen jedes Mal neu generiert wird, aber Sie müssen diese Dateien für dieses Tutorial nicht bearbeiten.

4. Bestätigen Sie, dass für den Flow ein Gerüst mit einem einzelnen Triggerknoten erstellt wurde:

   uip maestro flow node list PriceWatch/PriceWatch.flow --output table
   

   Sie sollten nur eine einzelne Zeile für trigger in der Ausgabe sehen – Ihre X und Y -Koordinaten können sich unterscheiden, da sich diese beim Verschieben von Knoten im visuellen Canvas ändern:

   Id              | Type                | Label           | Position                         
   ----------------|---------------------|-----------------|----------------------------------
   start           | core.trigger.manual | Manual trigger  | {"X":-192,"Y":0}
   

5. Öffnen Sie die PriceWatch/PriceWatch.flow -Datei in VS Code. Wenn die UiPath Maestro-Erweiterung installiert ist, wird die Datei auf der visuellen Arbeitsfläche statt als Rohtext geöffnet, sodass Sie die visuelle Darstellung Ihres Workflows sehen können.

   

---

Nächster Schritt

Wir sind jetzt bereit, unseren Flow zu erstellen.