Erstellen Sie VS-Code

Wie Workflows in Visual Studio Code mit der UiPath-Erweiterung erstellt, debuggt und bereitgestellt werden, von der Installation und Anmeldung bis hin zu Befehlen und Einstellungen.

Die Erweiterung für UiPath für Visual Studio Code fügt die Flow-Arbeitsfläche zu Visual Studio Code (VS Code) hinzu, einem kostenlosen Code-Editor. Es öffnet Workflow-Dateien, die die .flow -Erweiterung haben, in einem visuellen Editor, meldet Sie bei UiPath an und stellt Ihre Arbeit in UiPath Automation Cloud bereit.

Die Arbeitsfläche, Knoten, Variablen und das Debugging sind in jeder Umgebung gleich. Diese Seite behandelt, was für VS Code spezifisch ist: Installieren der Erweiterung, Anmelden und Bereitstellen über einen lokalen Arbeitsbereich. Ihr erster Workflow erstellt einen Workflow von Anfang bis Ende.

Bevor Sie beginnen

Sie benötigen:

• VS-Code 1.110.0 oder höher.
• Ein UiPath-Konto. Bei der Registrierung wird beschrieben, wie Sie einen erstellen.
• Internetzugang auf die UiPath Automation Cloud.
• Node.js und npm, die Tools zum Ausführen und Installieren von Befehlszeilenprogrammen, wurden so installiert, dass sie von einem Terminal gefunden werden. Bei der ersten Anmeldung verwendet die Erweiterung npm, um das UiPath-Befehlszeilentool uip (npm install -g @uipath/cli) zu installieren.

If you work in a remote workspace, such as Windows Subsystem for Linux (WSL), SSH, Codespaces, or a dev container, the extension runs on the remote host. Install Node.js and npm there, not on your local machine, so that the UiPath CLI is installed on the remote host too.

Installieren Sie die Erweiterung

1. Installieren Sie UiPath Maestro über VS Code Marketplace oder 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, um die UiPath Maestro-Ansicht zu öffnen.

Die Ansicht „UiPath Maestro“ hat folgende Abschnitte:

• Verbinden zeigt, wer angemeldet ist, den Verbindungsstatus und die Organisation und den Mandanten, in dem Sie arbeiten.
• Neue erstellen mit den Lösungen, Projekten und Workflows in Ihrem Arbeitsbereich darunter.
• Ressourcen listet auf, was der Mandant bereits hat, z. B. bereitgestellte Prozesse, mit einem Suchfeld.
• Probleme listet die Probleme in Ihren Workflows auf.
• Erstellen und Bereitstellen zeigt den Paketstatus, die Schaltfläche Bereitstellen und den Bereitstellungsverlauf an.

Anmelden

Die Erweiterung meldet Sie über Ihren Webbrowser an. Ihre Token werden nie gespeichert.

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 Erweiterung erhält das Ergebnis auf Port 8104 Ihres eigenen Computers.
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

Nachdem Sie sich angemeldet haben, wählen Sie aus, wo Sie arbeiten. Befehle werden über die Befehlspalette ausgeführt: Drücken Sie Ctrl/Cmd+Shift+P, geben Sie den Befehlsnamen ein und wählen Sie ihn aus.

1. UiPath ausführen: Wählen Sie Umgebung aus , um Ihre Umgebung zu bestätigen. Der Standardwert ist Cloud.
2. UiPath ausführen: Wählen Sie Mandant aus , um Ihren Mandanten auszuwählen. Der Abschnitt Verbinden zeigt die Organisation an, zu der der Mandant gehört.

Um den Mandanten später zu wechseln, wählen Sie die Pfeile neben der Organisation und dem Mandanten im Abschnitt Verbinden aus.

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

Ergebnis: Im Abschnitt Ressourcen werden die Ordner und Ressourcen Ihres ausgewählten Mandanten aufgelistet.

Erstellen oder öffnen Sie einen Workflow

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 Automate aus. Die Liste bietet auch Maestro Orchestrate und Data Fabric (Vorschau).

   

Das Projekt wird auf der Flow-Arbeitsfläche geöffnet, und die untere Symbolleiste zeigt Maestro Automate an.

Um einen vorhandenen Workflow zu öffnen, wählen Sie dessen .flow -Datei im Explorer aus oder führen Sie Flow: Open Flow (Ctrl/Cmd+Alt+O) aus.

Data Fabric-Entitäten, welche die Daten modellieren, die Workflows lesen und schreiben, können im selben Arbeitsbereich wie eine Vorschau-Funktion erstellt und bearbeitet werden. Entitäten in VS Code beschreiben, wie. Studio Web öffnet Lösungen, die ein Entitätsprojekt enthalten.

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 Workflow, und Autopilot erstellt ihn.

Validieren Sie einen Workflow

Validierungsfehler und Warnungen werden während der Bearbeitung im Abschnitt Probleme der UiPath Maestro-Ansicht und im Problembereich von VS Code 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.

Stellen Sie einen Workflow bereit

Beim Bereitstellen aus VS Code wird der Arbeitsbereich als UiPath-Lösung gepackt und in der UiPath Automation Cloud bereitgestellt. Einen Workflow bereitstellen beschreibt, was die Bereitstellung bewirkt.

Wählen Sie im Abschnitt Erstellen und Bereitstellen der Ansicht UiPath Maestro die Option Bereitstellen. Es verpackt die Lösung und stellt sie in einem Schritt bereit. Der Pfeil neben „Bereitstellen“ bietet jeden Schritt für sich:

• Paket erstellt nur das Paket, ohne es bereitzustellen.
• Die Bereitstellung stellt nur ein Paket bereit, das Sie bereits erstellt haben.

Nach einer Bereitstellung zeigt der Abschnitt Erstellen und Bereitstellen den Status des letzten Pakets und den Verlauf Ihrer Bereitstellungen an.

You can also run these actions from the Command Palette, which opens with Ctrl+Shift+P, or Cmd+Shift+P on macOS. For example, run UiPath: Package & Deploy. VS Code extension lists every command.

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.

Testen Sie einen Workflow

Select Run Debug (▶) in the bottom toolbar of the canvas. A dialog asks for the values of the trigger's inputs, such as productId and customerId. Enter them and start the run. The workflow runs in your selected tenant, and each node shows its status on the canvas as the run progresses.

Die Registerkarte Ausführungen unter der Arbeitsfläche folgt der Ausführung:

• Debugausführungen listet Ihre Testausführungen mit ihrem Status und ihrer Dauer auf.
• Die Ausführungsablaufverfolgung listet jeden ausgeführten Knoten in der Reihenfolge auf, wie lange es gedauert hat. Erweitern Sie einen Agent-Knoten, um dessen Agent-Ausführung und Modellaufrufe anzuzeigen.
• Die Details der Ausführung zeigen ihre Variablen, Vorfälle und Metadaten an.

Die anderen Registerkarten Datasets, Evaluierer und Evaluierungsausführungen enthalten Ihre Evaluierungen. Um einen Testlauf in einen Auswertungsdatenpunkt umzuwandeln, wählen Sie das Robotersymbol, Datenpunkt zum Ausführen einer Auswertung hinzufügen in der unteren Symbolleiste. Evaluierungen beschreiben, wie sie funktionieren.

In den Grundlagen des Debuggens wird beschrieben, wie Sie eine Ausführung lesen und Fehler beheben.

Nächste Schritte

• Ihr erster Workflow: der Workflow zur Auftragseingabe, der Schritt für Schritt in etwa 15 Minuten erstellt wurde.
• VS Code-Erweiterung: Befehle, Tastenkombinationen, Einstellungen und Fehlerbehebung.
• Bereitstellen eines Workflows: Was die Bereitstellung bewirkt.
• Debugging-Grundlagen: So lesen Sie eine Ausführung und beheben Fehler.
• Bewertungen: Prüfen Sie einen Workflow anhand von Beispieleingaben.
• Community: Stellen Sie Fragen und teilen Sie Workflows mit anderen Buildern im UiPath Forum.