Flow in VS Code

Installieren und konfigurieren Sie die UiPath für Visual Studio Code-Erweiterung, um Flows aus Ihrem lokalen Arbeitsbereich zu erstellen, zu debuggen und bereitzustellen.

Dieser Leitfaden umfasst Folgendes:

Mit der UiPath für Visual Studio Code- Erweiterung können Sie Flows aus VS-Code erstellen, debuggen und bereitstellen. Es liefert einen visuellen Editor für .flow -Dateien, meldet Sie bei UiPath an und verpackt und veröffentlicht Ihre Arbeit im Orchestrator.

Die Arbeitsfläche, Knoten, Variablen und das Debugging funktionieren genauso wie in Studio Web. Diese Seite behandelt, was für VS Code spezifisch ist: Installieren der Erweiterung, Anmelden und Packen über Ihren lokalen Arbeitsbereich. Informationen zum Erstellen von Flows finden Sie im Rest dieses Handbuchs, beginnend mit Ihr erster Flow.

Bevor Sie beginnen

Sie benötigen:

• VS-Code 1.110.0 oder höher.
• Ein UiPath-Konto.
• Netzwerkzugriff auf Ihre UiPath-Umgebung.
• Node.js und npm, die Tools zum Ausführen und Installieren von Befehlszeilenprogrammen, verfügbar auf Ihrem PATH. Bei der ersten Anmeldung verwendet die Erweiterung npm, um die UiPath CLI uip (npm install -g @uipath/cli) zu installieren.

Wenn Sie in einem Remote-Arbeitsbereich arbeiten, z. B. Windows-Subsystem für Linux (WSL), SSH, Codespaces oder einem Entwicklungscontainer, wird die Erweiterung auf dem Remote-Host ausgeführt. Installieren Sie Node.js und npm dort, nicht auf Ihrer lokalen Maschine, sodass die UiPath CLI auch auf dem Remotehost installiert wird.

Installieren Sie die Erweiterung

1. Installieren Sie UiPath Maestro Orchestrate über den VS Code Marketplace oder die Open VSX Registry.

2. Laden Sie den VS-Code neu, wenn Sie dazu aufgefordert werden.

3. Wählen Sie das UiPath- Symbol in der Aktivitätsleiste aus, um die UiPath-Ansicht zu öffnen.

   

Die UiPath-Ansicht hat drei Abschnitte:

• „Connect“ zeigt Ihren Anmeldestatus, die Umgebung und Ihren Mandanten an.
• Solution Explorer listet die Lösungen, Projekte und Flows in Ihrem Arbeitsbereich auf.
• Ressourcen listet Ordner und Orchestrator-Ressourcen für den ausgewählten Mandanten auf, sobald Sie sich anmelden.

Anmelden

Die Erweiterung meldet Sie im Prozess an und verwendet die gebündelte UiPath-Authentifizierungsbibliothek, um einen OAuth/Proof Key for Code Exchange (PKCE)-Browserflow auszuführen. Die Erweiterung speichert nie Ihre Token.

1. Wählen Sie im Abschnitt Verbinden die Option Anmelden aus.
2. Wenn die CLI noch nicht installiert ist, akzeptieren Sie die Aufforderung, sie zu installieren. Die Erweiterung wird ausgeführt npm install -g @uipath/cli.
3. Ihr Browser wird geöffnet, um die Anmeldung abzuschließen. Die Authentifizierungsbibliothek erhält den Rückruf an localhost Port 8104.
4. Nach der Autorisierung kehren Sie zu VS Code zurück. Ihre Sitzung wird von da an automatisch aktualisiert.

Um sich abzumelden, wählen Sie Abmelden im Abschnitt Verbinden aus. Dadurch werden Sie während des Prozesses abgemeldet und die zwischengespeicherte Sitzung wird gelöscht.

Hinweis:

Die Anmeldung verwendet Port 8104 auf localhost für den OAuth-Rückruf. Wenn die Anmeldung fehlschlägt, hält möglicherweise ein veralteter Prozess den Port zurück. Geben Sie es frei, und versuchen Sie es erneut. Führen Sie unter macOS oder Linux lsof -ti :8104 | xargs kill -9 aus. Führen Sie unter Windows netstat -ano | findstr :8104 aus, um die Prozess-ID zu finden, und dann taskkill /F /PID <id>.

Wählen Sie Ihre Umgebung und Ihren Mandanten aus

Wählen Sie nach der Anmeldung aus, wo Sie arbeiten.

1. UiPath ausführen: Wählen Sie Umgebung aus , um Ihre Umgebung zu bestätigen. Der Standardwert ist Cloud.
2. Ausführen von UiPath: Wählen Sie Mandant aus , um Ihren Mandanten oder Ihre Organisation auszuwählen.

Im Abschnitt Ressourcen können Sie dann Ordner und Ressourcen für den ausgewählten Mandanten durchsuchen.

Ergebnis: Der Abschnitt Ressourcen wird mit Ordnern und Orchestrator-Ressourcen für Ihren ausgewählten Mandanten gefüllt.

Erstellen oder öffnen Sie einen Flow

So erstellen Sie ein Projekt:

1. Wählen Sie in der Ansicht UiPath Maestro die Option Neue erstellen aus.

2. Wählen Sie in der Liste Neues Projekt die Option Maestro Orchestrate aus. Die Liste bietet auch Maestro Automate und Data Fabric (Vorschau).

   

Sie können auch über die Befehlspalette und den Explorer arbeiten:

• Führen Sie Flow: Neuer Flow (Ctrl/Cmd+Alt+N) aus, um eine neue .flow -Datei zu erstellen.
• Öffnen Sie eine vorhandene .flow -Datei aus dem Explorer, oder führen Sie Flow: Open Flow (Ctrl/Cmd+Alt+O) aus.
• Wenn eine Lösung geöffnet ist, wählen Sie in der Titelleiste von Solution Explorer die Option Flow hinzufügen , um dem aktiven Projekt einen Flow hinzuzufügen.

Die Datei wird im visuellen Flow-Editor geöffnet. Erstellen, verbinden und konfigurieren Sie Knoten genau wie in Studio Web.

Sie können auch Data Fabric-Entitäten im selben Arbeitsbereich als Vorschaufunktion modellieren. Entitäten in VS Code beschreiben, wie. Entitäten können nur in VS Code erstellt und bearbeitet werden: Studio Web kann eine Lösung öffnen, die ein Entitätsprojekt enthält, aber kann die Entität selbst nicht bearbeiten.

Mit Autopilot erstellen

Autopilot (Vorschau) ist in VS Code als separate Erweiterung verfügbar, UiPath Autopilot, veröffentlicht von UiPath. Um es zu installieren, öffnen Sie die Ansicht der Erweiterungen (Ctrl+Shift+X oder Cmd+Shift+X unter macOS), suchen Sie nach UiPath Autopilot und wählen Sie Installieren aus. Melden Sie sich dann bei UiPath Autopilot an: Anmelden in der Befehlspalette und öffnen Sie dann den Chat mit UiPath Autopilot: Autopilot öffnen. Beschreiben Sie den Prozess und Autopilot erstellt ihn.

Validieren Sie einen Flow

Flow-Validierungsfehler und Warnungen werden während der Bearbeitung im Problembereich von VS Code zusammen mit den anderen Diagnosen Ihres Projekts angezeigt.

Wählen Sie einen beliebigen Eintrag aus, um direkt zum fehlerhaften Knoten auf der Arbeitsfläche zu navigieren, einschließlich Knoten innerhalb von Unterflows. Um bei Bedarf zu validieren, anstatt auf die Aktualisierung des Bereichs zu warten, führen Sie Flow: Validate Flow (Ctrl/Cmd+Shift+V) aus.

Packen und bereitstellen

Sie veröffentlichen über VS Code, indem Sie Ihren Arbeitsbereich als UiPath-Lösung packen und im Orchestrator bereitstellen. Weitere Informationen zu den Funktionen der Bereitstellung finden Sie unter Bereitstellen eines Flows .

• UiPath: Das Paket erstellt eine .uipx -Lösung aus dem aktuellen Arbeitsbereich.
• UiPath: Bereitstellen lädt eine verpackte Lösung in Orchestrator hoch.
• „UiPath: Paket bereitstellen“ führt beide Schritte zusammen aus.
• UiPath: Bereitstellungsziel wechseln ändert den Zielordner.

Standardmäßig aktiviert die Erweiterung die Bereitstellung nach einer erfolgreichen Bereitstellung. Für eine Bereitstellung ohne Aktivierung deaktivieren Sie die Einstellung uipath.autoActivateDeployment .

Um dasselbe Paket über die UiPath CLI auszuführen, führen Sie UiPath: Generate .env File aus. Dadurch wird eine .env -Datei geschrieben, die mit uip kompatibel ist.

Debuggen

Das Debuggen in VS Code erfolgt über Ihren ausgewählten Cloud-Mandanten. Führen Sie einen Flow über den Editor aus und behalten Sie die Ausführung in der Live-Debug-Ansicht zu, die ein Workflowdiagramm für dieMeerMe-Ausführung gerendert, das im Verlauf der Ausführung aktualisiert wird. Weitere Informationen zum Lesen einer Ausführung und zum Beheben von Fehlern finden Sie unter Effektive Debugging-Funktionen .

Befehle und Tastenkombinationen

Führen Sie einen beliebigen Befehl über die Befehlspalette (Ctrl/Cmd+Shift+P) aus. Die Verknüpfungen zum Flow-Editor gelten nur, wenn eine .flow -Datei der aktive Editor ist.

Flow-Editor

Befehl	Standardtastenzuordnung
Flow: Neuer Flow	Ctrl/Cmd+Alt+N
Flow: Flow öffnen	Ctrl/Cmd+Alt+O
Flow: Flow speichern	Ctrl/Cmd+S
Flow: Flow speichern als	Ctrl/Cmd+Shift+S
Ablauf: Rückgängig machen	Ctrl/Cmd+Z
Ablauf: Wiederholen	Ctrl+Y / Cmd+Shift+Z
Flow: Zoom In	Ctrl/Cmd+=
Flow: Zoom Verkleinern	Ctrl/Cmd+-
Flow: Zoom zurücksetzen	Ctrl/Cmd+0
Flow: An Bildschirm anpassen	Ctrl/Cmd+Shift+F
Flow: Flow validieren	Ctrl/Cmd+Shift+V
Flow: Export-Flow	Keine

UiPath-Plattform

Befehl	Beschreibung
UiPath: Anmelden	Melden Sie sich bei UiPath an.
UiPath: Abmelden	Abmelden und zwischengespeicherte Sitzung löschen.
UiPath: Wählen Sie Umgebung aus	Wählen Sie die UiPath-Umgebung aus.
UiPath: Wählen Sie Mandant aus	Wählen Sie den Mandanten oder die Organisation aus.
UiPath: Neues Projekt erstellen	Fügen Sie der Lösung ein Projekt hinzu. Wählen Sie Data Fabric , um ein Entitätsprojekt zu erstellen.
UiPath: Neue Datei	Fügen Sie eine Datei zu einem Projekt hinzu. Wählen Sie Entitätsdatei aus, um eine Entität hinzuzufügen.
UiPath: Entitätsdatei hinzufügen	Fügen Sie eine weitere Entität zu einem vorhandenen Entitätsprojekt hinzu. Verfügbar, sobald die Lösung einen hat.
UiPath: Paket	Erstellen Sie eine Lösung .uipx aus dem Arbeitsbereich.
UiPath: Bereitstellen	Eine verpackte Lösung in Orchestrator hochladen.
UiPath: Paket und Bereitstellung	Verpacken und Bereitstellen in einem Schritt.
UiPath: Bereitstellungsziel wechseln	Ändern Sie den Zielordner.
UiPath: Generieren von.env Datei	Schreiben Sie eine CLI-kompatible .env -Datei.
UiPath: Aktualisieren	Aktualisieren Sie die Verbindungsstruktur.
UiPath: Ausgabeprotokoll anzeigen	Öffnen Sie den UiPath-Ausgabekanal.
UiPath: Erste Schritte	Öffnen Sie den Leitfaden „Erste Schritte“.

Die vollständigen Tastenkombinationen für die Arbeitsfläche finden Sie unter Tastenkombinationen.

Einstellungen

Konfigurieren Sie die Erweiterung in den VS-Codeeinstellungen.

uipath.environment

Die bei der Anmeldung verwendete UiPath-Umgebung. Die Standardeinstellung ist cloud. Eine vorhandene CLI-Sitzung hat Vorrang, wenn sie auf eine andere Stelle verweist.

uipath.autoActivateDeployment

Aktiviert eine Lösungsbereitstellung nach einer erfolgreichen Bereitstellung. Die Standardeinstellung ist true.

uipath.cli.path

Ein absoluter Pfad zur UiPath-CLI-Binärdatei (uip). Lassen Sie es leer, um uip in Ihrem PATH zu finden. Legen Sie dies fest, wenn die CLI an einem Speicherort installiert ist, der sich nicht auf Ihrem PATH befindet.

uipath.telemetry.enabled

Sendet anonymisierte Nutzungstelemetrie. Die Standardeinstellung ist true. Die Erweiterung berücksichtigt auch das globale telemetry.telemetryLevel von VS Code. Wenn Sie eine der beiden Einstellungen deaktivieren, wird die Telemetrie deaktiviert.

Fehlersuche und ‑behebung

Anmeldung fehlgeschlagen

Die Anmeldung schlägt fehl, wenn der OAuth-Rückrufport beschäftigt ist oder die CLI ihre Sitzung verloren hat.

• Port wird verwendet. Die CLI verwendet den Port 8104 auf localhost für den Rückruf. Wenn ein veralteter Prozess ihn enthält, geben Sie den Port frei und melden Sie sich erneut an. Führen Sie unter macOS oder Linux lsof -ti :8104 | xargs kill -9 aus. Führen Sie unter Windows netstat -ano | findstr :8104 und dann taskkill /F /PID <id> aus.
• Veraltete Sitzung. Führen Sie UiPath: Abmelden und dann UiPath: Anmelden erneut aus, um eine neue Anmeldung zu erzwingen.
• Lesen Sie das Protokoll. Führen Sie UiPath: Show Output Log aus und überprüfen Sie den UiPath -Ausgabekanal auf Anmeldefehler.

Die CLI wurde nicht gefunden

Die Erweiterung Shells für uip. Wenn die Binärdatei nicht gefunden werden kann, schlagen die Anmeldung und das Packen fehl.

1. Bestätigen Sie, dass die CLI installiert ist, indem Sie uip --version in einem Terminal ausführen.
2. Wenn sich uip nicht auf Ihrem PATH befindet, legen Sie uipath.cli.path auf den absoluten Pfad der Binärdatei fest.
3. Wenn die CLI überhaupt nicht installiert ist, führen Sie UiPath: Anmelden aus und akzeptieren Sie die Installationsaufforderung, oder installieren Sie sie manuell mit npm install -g @uipath/cli. Dies erfordert Node.js und npm auf Ihrer PATH.

Remote-Arbeitsbereiche sehen die CLI nicht

In WSL-, SSH-, Codespaces- und Entwicklungscontainer-Arbeitsbereichen wird die Erweiterung auf dem Remotehost ausgeführt, nicht auf Ihrer lokalen Maschine. Die Binärdatei uip muss auf diesem Host installiert sein. Eine CLI, die auf Ihrer lokalen Windows- oder macOS-Maschine installiert ist, ist für die Erweiterung nicht sichtbar. Installieren Sie die CLI im Remote-Arbeitsbereich und melden Sie sich dann erneut an.

Bereitstellung wird nicht aktiviert

Standardmäßig aktiviert die Erweiterung eine Bereitstellung nach einer erfolgreichen Bereitstellung. Wenn eine Bereitstellung hochgeladen, aber nicht aktiviert wird, bestätigen Sie, dass uipath.autoActivateDeployment aktiviert ist.

Zugehörige Seiten

• Ihr erster Flow
• Entitäten in VS-Code
• Bereitstellen eines Flows
• Effektive Debugging-Funktionen