Erstellen Sie den Flow

Erstellen Sie den Preisüberwachungsflow mithilfe von VS Code, indem Sie jeden der sechs Knoten hinzufügen und konfigurieren.

Nachdem wir nun das Gerüst für unser Projekt aus Schritt 1 erstellt haben, werden wir uns mit den grundlegenden Bausteinen befassen und dann die fünf verbleibenden Knoten, die drei Triggereingaben und die eine Ausgabevariable für unseren Flow hinzufügen.

Hinweis:

Wir verwenden die Begriffe „downstream“ und "Upstream"; für den Rest dieses Tutorials und Sie sollten sich damit vertraut machen.

• Upstream: Die Knoten, die sich vor einem bestimmten Knoten im Ausführungspfad des Flows befinden. Die vorgelagerten Knoten eines Knotens sind alles, von denen er abhängt: Ihre Ausgaben fließen in ihn ein, und sie müssen abgeschlossen werden, bevor er ausgeführt werden kann.
• Downstream: Die Knoten, die nach einem bestimmten Knoten im Ausführungspfad des Flows kommen. Die nachgelagerten Knoten eines Knotens sind alles, was von ihm abhängt: Sie verbrauchen seine Ausgaben und sind betroffen, wenn er fehlschlägt, sich ändert oder erneut ausgeführt wird.

So wird eine Knoten-ID umbenannt

In diesem Tutorial werden wir die generierten ID in den meisten Schritten für dieses Tutorial umbenennen, damit sie leichter lesbar sind. Es ist einfacher zu verstehen, was ein Knoten namens fetchRate1 tut als httpRequest1. Ein Knoten besteht aus einem label und einem ID.

Sie können mehrere Knoten mit dem gleichen label haben, aber jeder ID muss eindeutig sein. Beim Hinzufügen eines neuen Knotens wird der Standardwert für ID der Knotentyp mit einer angehängten Zahl, beginnend bei 1. Beispielsweise hat das Hinzufügen des ersten Endknotentyps ein ID von end1 und der zweite end2. Durch Ändern der label eines Knotens wird die IDnicht aktualisiert.

Die Schritte zum Ändern der ID eines Knotens sind:

1. Wählen Sie den Knoten auf der Arbeitsfläche aus, um die Inline-Symbolleiste darüber anzuzeigen.
2. Wählen Sie den Bleistift aus, Bearbeiten.
3. Öffnen Sie die Registerkarte Erweitert , und Sie sehen das Feld ID als schreibgeschütztes Feld mit einer Schaltfläche mit dem Bleistift zum Umbenennen der Knoten-ID daneben.
4. Wählen Sie diesen Bleistift aus, um ein Dialogfeld zum Umbenennen der Knoten-ID mit einer Eingabe für die neue ID zu öffnen.
5. Geben Sie die neue ID ein und wählen Sie Umbenennen aus.

Das Dialogfeld enthält Details zu allen Aktualisierungen, die beim Umbenennen des Felds ID erforderlich sind, z. B. „3 Referenzen werden aktualisiert“, „2 Verbindungen“ und „1 Ausdruck in anderen Knoten“. Die Option Umbenennen bleibt deaktiviert, bis Sie eine Änderung am Wert vornehmen, und aktualisiert dann alle angezeigten Verweise.

Schritt 2 – Erstellen des Flows

Wir erstellen nun unseren Workflow für Pricing Beachten Sie einen Knoten nach dem anderen. Öffnen Sie im VS-Code PriceWatch/PriceWatch.flow – Sie sollten einen manuellen Triggerknoten mit dem Namen start auf der Arbeitsfläche sehen.

Schritt 2.1 – Deklarieren der Triggereingaben

Wir müssen drei Eingaben zum Starttriggerknoten hinzufügen, den wir in unserem Ausgabe-Aufruf verwenden werden. baseCurrency ist derjenige, für den wir den aktuellen Wechselkurs vom quoteCurrency benötigen, und alertThreshold ist der Wert, unter dem wir benachrichtigt werden möchten. Fügen wir diese drei Eingaben hinzu mit:

1. Wählen Sie den Knoten Trigger manuell auf der Arbeitsfläche aus.

2. Öffnen Sie die Eigenschaften des Knotens mit der Aktivität „Bearbeiten“ Taste.

3. Verwenden Sie die Schaltfläche + Add input argument, um baseCurrency mit dem Typ String und dem Standardwert USD hinzuzufügen.

4. Verwenden Sie die Schaltfläche + Add input argument, um quoteCurrency mit dem Typ String und dem Standardwert EUR hinzuzufügen.

5. Verwenden Sie die Schaltfläche + Add input argument, um alertThreshold mit dem Typ Number und dem Standardwert 0.9 hinzuzufügen.

6. Bestätigen Sie, dass Sie alle drei Eingabevariablen hinzugefügt haben, indem Sie sie mit der folgenden Abbildung vergleichen:

Schritt 2.2 – Hinzufügen des HTTP-Anforderungsknotens

Der HTTP-Knotentyp wird verwendet, um die Transaktion mit der Standard-API aufzurufen, um die Wechselkursdaten mithilfe unserer 3 Trigger-Eingabevariablen abzurufen. Erstellen Sie sie mit den folgenden Schritten:

1. Wählen Sie die + am ausgehenden Handle des manuellen Triggerknotens aus.

2. Suchen Sie in der Knotenpalette nach „HTTP Request“ und wählen Sie diese aus.

3. Öffnen Sie die Eigenschaften des neuen Knotens mit der Designtaste „Bearbeiten“ Taste.

4. Legen Sie die Knoten -Beschriftung auf Fetch rate fest.

5. Benennen Sie das Feld ID von httpRequest1 in fetchRate1.

6. Lassen Sie im Eigenschaftenbereich die Authentifizierung auf Manuelle Authentifizierung eingestellt.

7. Legen Sie die HTTP-Methode auf GET fest.

8. Legen Sie die URL auf https://api.frankfurter.dev/v2/rates fest.

9. Verwenden Sie im Abschnitt Abfrageparameter zweimal + Add pair , um zwei leere Schlüssel/Wertpaare hinzuzufügen.

10. Legen Sie für das erste Paar den Schlüssel auf base und den Wert auf $vars.start.output.baseCurrency fest.

11. Legen Sie für das zweite Paar den Schlüssel auf quotes und den Wert auf $vars.start.output.quoteCurrency fest.

Bestätigen Sie, dass der Knoten ID im Eigenschaftenbereich fetchRate1 unter der Registerkarte Advanced liest und dass beide Abfrageparameter gespeichert werden. Zur Laufzeit fordert der Knoten https://api.frankfurter.dev/v2/rates?base=USD&quotes=EUR an und macht genau drei Schlüssel verfügbar:

• $vars.fetchRate1.output.body – der analysierte Antworttext
• $vars.fetchRate1.output.code – Der HTTP-Antwortstatuscode
• $vars.fetchRate1.output.headers – Die HTTP-Antwortheader

Im Wesentlichen benötigt jeder HTTP-Anforderungsknoten einen Integration Service , um einen API-Aufruf auszuführen. Dies erfordert normalerweise zuerst einen erstellen und dann über den HTTP-Anforderungsknoten darauf verweisen. Da die One-Message-API keine Authentifizierung erfordert, wird beim Festlegen der Authentifizierungsmethode auf Manual authentication eine implizite Verbindung mithilfe der von uns bereitgestellten Konfiguration erstellt, anstatt zu erfordern, dass wir zuerst die Verbindung erstellen und dann aus dem Dropdownmenü auswählen.

Schritt 2.3 – Gestalten der Antwort mit einem Skriptknoten

Wir verwenden einen Skriptknoten , um den aktuellen Wechselkurs zu extrahieren und vergleichen ihn mit unserem Warnungsschwellenwert. Die Daten aus dem Textkörper der Antwort-JSON der Transaktion mit der Dokumente sind ein Array , da Sie den Wechselkurs für mehrere Währungen mit einem einzigen API-Aufruf anfordern können. Das Array hat einen Eintrag pro angegebener Währung – wir schließen nur 1 quoteCurrency -Wert ein, sodass das Array immer nur 1 Ergebnis enthält:

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

Führen Sie die folgenden Schritte aus, um den Skriptknoten zu erstellen:

1. Wählen Sie + am ausgehenden Handle des Knotens Abrufrate aus.

2. Suchen Sie in der Knotenpalette nach Script und wählen Sie es aus.

3. Öffnen Sie die Eigenschaften des neuen Skriptknotens mit der Designtaste „Bearbeiten“ Taste.

4. Legen Sie die Beschriftung des Knotens auf Reshape rate fest.

5. Benennen Sie ID in script1 in reshapeRate1.

6. Geben Sie im Skripteditor Folgendes ein:

   const rates = $vars.fetchRate1.output.body;
   const quote = $vars.start.output.quoteCurrency;
   const match = rates.find(function (entry) { return entry.quote === quote; });
   const rate = match.rate;
   
   return {
     pair: match.base + "/" + quote,
     rate: rate,
     asOf: match.date,
     belowThreshold: rate < $vars.start.output.alertThreshold
   };
   

Obwohl wir wissen, dass es nur ein einziges Ergebnis in der API gibt, sollte das Skript nicht davon ausgehen, dass der gewünschte Wert der erste Eintrag ist. Anstatt eine Indexortreferenz mit rates[0] zu verwenden oder nach einem Eintrag mit "EUR" zu suchen, finden wir den Eintrag, bei dem quote mit dem quoteCurrency -Wert übereinstimmt, der von der Eingabevariablen des Triggers bereitgestellt wird. Das Skript vergleicht dann die aktuelle Rate mit dem Schwellenwert und fügt das Ergebnis in das Ausgabeobjekt des Knotens ein, wobei die Vergleichslogik neben dem Code bleibt, der die API-Daten verbraucht, anstatt sie im Entscheidungsknoten zu wiederholen.

Warnung:

Geben Sie den Text genau wie gezeigt ein, ohne function -Wrapper. Ein function main(input) { … } -Wrapper um den Code wird trotzdem erfolgreich ausgeführt, aber er gibt null anstelle des Rückgabeobjekts zurück. Dies verhindert, dass nachgelagerte Knoten die Daten verwenden – dies unterscheidet sich von der codierten UiPath-Funktion, die den Wrapper verwendet.

Downstream-Knoten können jetzt die Ausgabevariablen lesen als:

• $vars.reshapeRate1.output.pair
• $vars.reshapeRate1.output.rate
• $vars.reshapeRate1.output.asOf
• $vars.reshapeRate1.output.belowThreshold

Schritt 2.4 – Route basierend auf dem Ergebnis

Ein Entscheidungsknoten teilt den Fluss basierend auf dem Wert von belowThreshold in zwei Pfade auf – es ist ein boolescher Wert und kann also nur true oder false sein. Für jede dieser Verzweigungen fügen wir einen Endknoten hinzu, um das Ergebnis mithilfe einer Ausgabevariablen zurückzugeben. Wir legen den Wert dieser Ausgabevariablen auf jeder Verzweigung des Entscheidungsknotens fest, aber zuerst müssen wir die Variable erstellen und sie dann beim Hinzufügen unseres Entscheidungsknotens verwenden:

1. Wählen Sie die Registerkarte Variablen im Eigenschaftenbereich ohne ausgewählten Knoten aus.

2. Verwenden Sie die + neben „Ausgaben“; klicken, um das Dialogfeld zum Hinzufügen einer Ausgabevariablen zu öffnen.

3. Erstellen Sie die Variable mit dem Namen watchResult, geben Sie Object und keinen Standardwert ein.

4. Wählen Sie + am ausgehenden Handle des Knotens für die Änderungsrate aus.

5. Suchen Sie in der Knotenpalette nach Entscheidung und wählen Sie diese aus.

6. Öffnen Sie die Eigenschaften des neuen Knotens mit der Designtaste „Bearbeiten“ Taste.

7. Legen Sie die Beschriftung des Knotens auf Below threshold fest.

8. Benennen Sie ID des Knotens von decision1 in belowThreshold1.

9. Bedingung festlegen auf:

   $vars.reshapeRate1.output.belowThreshold === true
   

   Kein Präfix =js: hier, im Gegensatz zu den Abfrageparametern auf dem HTTP-Knoten. Ein Entscheidungsausdruck ist ein natives Flow-Feld, das die Flow-Engine sich selbst auswertet, es ist also bereits JavaScript.

10. Legen Sie die Beschriftung der True-Verzweigung auf Alert fest.

11. Legen Sie die Beschriftung der False-Verzweigung auf No action fest.

    Die Beschriftungen werden auf den beiden Ausgabehandles des Knotens angezeigt, sodass die Arbeitsfläche und die Ausführungsablaufverfolgung sowohl als Geschäftsregeln als auch als true und false gelesen werden.

Schritt 2.5 – Hinzufügen des Warnungsendknotens

Der Entscheidungsknoten hat 2 Verzweigungen, fügen Sie zuerst die der Alert -Verzweigung hinzu mit:

1. Wählen Sie + in der Verzweigung Warnung aus.

2. Suchen Sie in der Knotenpalette nach Ende und wählen Sie diese aus.

3. Öffnen Sie die Eigenschaften des neuen Endknotens mit der Schaltfläche „Bearbeiten“ Taste.

4. Legen Sie auf der Registerkarte Parameter den Ausdruck für watchResult auf fest:

   $vars.reshapeRate1.output
   

5. Legen Sie auf der Registerkarte Erweitert die Beschriftung auf End alert fest.

6. Benennen Sie die ID des Knotens von end1 in endAlert1 um.

Schritt 2.6 – Hinzufügen des Endknotens ohne Aktion

Fügen Sie nun den No action Endknoten für die andere Verzweigung des Entscheidungsknotens hinzu mit:

1. Wählen Sie + im Keine Aktion aus.

2. Suchen Sie in der Knotenpalette nach Ende und wählen Sie diese aus.

3. Öffnen Sie die Eigenschaften des neuen Endknotens mit der Schaltfläche „Bearbeiten“ Taste.

4. Legen Sie auf der Registerkarte Parameter den Ausdruck für watchResult auf fest:

   $vars.reshapeRate1.output
   

5. Legen Sie auf der Registerkarte Erweitert die Beschriftung des Knotens auf End no action fest.

6. Benennen Sie die ID des Knotens von end2 in endNoAction1 um.

Review

Die Arbeitsfläche sollte jetzt sechs verbundene Knoten und fünf Kanten sowie eine einzelne Abzweigung nach dem Entscheidungsknoten anzeigen und beide Endknoten sollten eine Zuordnung für watchResult enthalten. Ihr Flow sollte jetzt wie unten aussehen. Sie können das Besensymbol verwenden, um die Knoten im Flow anzuordnen, und die Schaltfläche Fit to screen, um die Größe der Canvas an Ihren Bildschirm anzupassen.

---

Nächster Schritt

Nachdem er erstellt wurde, überprüfen wir den Flow mithilfe des Befehls uip maestro flow validate .