Erstellen und Bereitstellen von codierten Aktions-Apps

Erstellen und Bereitstellen einer codierten Aktions-App in UiPath: Was Sie benötigen, bevor Sie beginnen, wie die App Daten mit dem Action Center austauscht, wie sie lokal getestet wird und wie sie als Aufgabenschnittstelle bereitgestellt wird.

Eine codierte Aktions-App durchläuft den gleichen Lebenszyklus wie jede codierte App: Sie wird im Code definiert, mit UiPath verbunden, in Orchestrator bereitgestellt und dann als Schnittstelle für eine Action Center-Aufgabe verwendet.

Der Prozess umfasst folgende Phasen:

1. Definieren der Aktions-App-Logik in einer integrierten Entwicklungsumgebung (IDE).
2. Herstellung einer sicheren Verbindung zu UiPath.
3. Bereitstellen der Aktions-App für den Orchestrator.
4. Verwenden der Aktions-App als Benutzeroberfläche für Action Center-Aufgaben. Eine codierte Aktions-App kann als Schnittstelle für Aufgaben dienen, die über alle Oberflächen erstellt wurden, einschließlich Agents, RPA-Prozesse und Maestro-Prozesse.

Bevor Sie beginnen

Wichtig:

In Automation Cloud Dedicated and Test Cloud Dedicated, use UiPath CLI version 1.202.0 for the pack, publish --type Action, deploy, and push steps until your Dedicated production environment is upgraded to the Apps release dated September 24, 2026. Later CLI versions contain breaking changes that are incompatible with the Apps version currently running in Dedicated environments. After your Dedicated production environment is upgraded to the September 24, 2026 Apps release, you can use later versions of the UiPath CLI.

Stellen Sie sicher, dass Folgendes vorhanden ist:

• Eine lokale Entwicklungsumgebung mit Node.js 20.x oder neuer und npm, die zum Erstellen der App und zum Installieren der UiPath-Tools verwendet wird. Laden Sie das Installationsprogramm von Nodejs.org herunter, das npm enthält. Führen Sie node -v und npm -v aus, um zu überprüfen, was bereits installiert ist.
• Die UiPath CLI mit installiertem codedapp -Tool. Installationsanweisungen finden Sie im UiPath CLI -Handbuch.
• Berechtigung zum Veröffentlichen von Paketen und Bereitstellen von Apps in dem Orchestrator-Ordner, den Sie anzielen.

Je nachdem, was sie tut, benötigt eine Aktions-App möglicherweise auch eine externe App-ID:

Wenn Ihre Aktions-App	ID der externen App erforderlich
Liest und schließt die Aufgabe nur ab	Nein
Ruft auch andere UiPath-Dienste auf, wie Orchestrator oder Data Fabric	Ja

Wenn eine externe App-ID erforderlich ist, muss sie aus einer externen Anwendung stammen, die in Ihrer Organisation registriert ist. Eine Aktions-App wird im Browser ausgeführt und kann kein App-Geheimnis speichern. Registrieren Sie sie daher als nicht vertrauliche Anwendung mit Benutzer-Scopes. Informationen zum Registrieren finden Sie unter Hinzufügen einer externen Anwendung im Administratorhandbuch zu Automation Cloud.

Erstellen Sie die Aktions-App

Eine codierte Aktions-App wird in einem Sandbox-Framework ausgeführt, das von Action Center gerendert wird, sodass sie Aufgabendaten nicht direkt lesen oder schreiben kann. Das UiPath Coded Action App SDK schließt diese Lücke und gibt der App vier Möglichkeiten:

• Empfangen Sie die Aufgabe und ihre Daten, wenn die App geladen wird.
• Action Center benachrichtigen, wenn der Benutzer das Formular bearbeitet, damit die Schaltfläche „Speichern“ aktiviert werden kann.
• Schließen Sie die Aufgabe mit der vom Benutzer ausgewählten Aktion und den endgültigen Daten ab.
• Zeigen Sie Nachrichten für den Benutzer im Action Center an.

Über diese vier Elemente hinaus fügt UiPath einem ansonsten gewöhnlichen Webprojekt zwei Teile der einmaligen Einrichtung hinzu:

• Eine Verbindung mit Ihrer Organisation. Eine kleine Konfigurationsdatei im Stammordner des Projekts identifiziert Ihre Organisation, Ihren Mandanten und Ihre externe App-ID, wo eine benötigt wird.
• Ein lokales Entwicklungssetup. Ein UiPath-Plugin für das Build-Tool des Projekts liefert dieselbe Konfiguration, während die App auf der Maschine des Entwicklers ausgeführt wird, sodass die App mit einem echten Mandanten getestet werden kann, bevor sie bereitgestellt wird.

Das vollständige Entwicklersetup, einschließlich der SDK-Methoden, der Konfigurationsdatei, des Buildtool-Plugins und der Anpassungen, die die App benötigt, bevor sie verpackt wird, finden Sie in der Dokumentation zum Coded Action App SDK .

Testen Sie die Aktion-App lokal

Das Action Center bietet eine Aufgabensimulation für codierte Aktions-Apps, die auf localhost ausgeführt werden. Auf UiPath-Seite sind zwei Konfigurationsteile erforderlich, bevor es funktioniert.

Fügen Sie den Action Center-Umleitungs-URI zu Ihrer externen Anwendung hinzu

Fügen Sie den Umleitungs-URI https://<host>/<orgId>/<tenantId>/actions_ zu der externen Anwendung hinzu, die Ihre Aktions-App verwendet, wobei <host> die Umgebung ist, bei der Sie sich anmelden, z. B. cloud.uipath.com.

<orgId> und <tenantId> sind die GUIDs, nicht die Organisations- und Mandantennamen, die in der Adressleiste des Browsers angezeigt werden. Ein fehlender Eintrag oder einer, der Namen anstelle von GUIDs verwendet, schlägt mit invalid_request oder Invalid redirect_uri fehl.

Um beide GUIDs abzurufen, melden Sie sich mit uip login an und führen Sie dann Folgendes aus:

uip login status --output json

Die Antwort gibt sie als OrganizationId und TenantId zurück.

Dieser Eintrag wird normalerweise hinzugefügt, wenn zum ersten Mal eine codierte Aktions-App bereitgestellt wird, die die externe Anwendung verwendet. Um den genauen Wert zu lesen, den Ihre App sendet, öffnen Sie die App und kopieren Sie redirect_uri aus der /identity_/connect/authorize -Anforderung auf die Registerkarte „Netzwerk“ Ihres Browsers.

Öffnen Sie die Action Center-Debugseite

1. Gehen Sie zu https://<host>/<orgName>/<tenantName>/actions_/debug/coded-action-app. Diese Seite adressiert Ihre Organisation und Ihren Mandanten mit dem Namen, im Gegensatz zum Umleitungs-URI.
2. Geben Sie die Details Ihrer App ein und laden Sie sie dann.

Stellen Sie die Aktion-App bereit

Die Bereitstellung erfolgt in zwei Teilen: Der Entwickler verpackt und veröffentlicht die Aktions-App, dann stellen Sie dieses Paket in einem Orchestrator-Ordner bereit.

Verpacken und Veröffentlichen der Aktion-App

Eine codierte Aktions-App wird im Orchestrator als .nupkg -Paket veröffentlicht, dem gleichen Paketformat, das für Automatisierungen verwendet wird. Sie wird mit --type Action veröffentlicht, wodurch sie registriert wird, sodass sie als Benutzeroberfläche für eine Action Center-Aufgabe ausgewählt werden kann.

1. Erstellen Sie die App:

   npm run build
   

2. Verpacken Sie die Buildausgabe:

   uip codedapp pack dist -n <appName> --version 1.0.0
   

3. Melden Sie sich bei Ihrer UiPath-Organisation an:

   uip login
   

4. Veröffentlichen Sie das Paket als Aktions-App, in einem Mandantenfeed oder einem Feed für den persönlichen Arbeitsbereich:

   uip codedapp publish --type Action
   

5. Stellen Sie die App bereit:

   uip codedapp deploy
   

Die vollständige Argumentliste jedes Befehls finden Sie unter uip codedapp im UiPath-CLI-Handbuch.

Stellen Sie die Aktions-App aus dem Orchestrator bereit

Wenn das Paket bereits veröffentlicht wurde oder wenn Sie die Befehlszeile nicht verwenden möchten, stellen Sie stattdessen die Aktions-App über den Orchestrator bereit.

1. Wechseln Sie im Orchestrator zu Mandant > Pakete.
2. Wählen Sie Hochladen aus und laden Sie die von uip codedapp pack erstellte Datei .nupkg hoch. Das detaillierte Verfahren finden Sie unter Verwalten von Paketen.
3. Wechseln Sie zu dem Ordner, in dem Sie die App bereitstellen möchten, und gehen Sie zu Automatisierungen > Apps.
4. Wählen Sie App bereitstellen und dann Ihre App und deren Version. Das detaillierte Verfahren finden Sie unter Verwalten von Apps.

Stellen Sie die Aktions-App aus Studio Web bereit

Wenn die Aktions-App als codiertes App-Projekt innerhalb einer Studio Web-Lösung erstellt wurde, wird sie zusammen mit dieser Lösung gepackt und nicht eigenständig bereitgestellt. Die Version der Aktions-App bleibt im Gleichschritt mit den Workflows, Agents und Ressourcen, von denen sie abhängt.

1. Erstellen Sie die App lokal und pushen Sie sie dann in das Studio Web-Projekt:

   uip codedapp push --project-id <project-id>
   

2. Öffnen Sie in Studio Web die Lösung und wählen Sie Bereitstellen.

3. Legen Sie die Paketversion fest, wählen Sie, ob in Ihrem persönlichen Arbeitsbereich oder in einem freigegebenen Arbeitsbereich gepackt werden soll, benennen Sie die Bereitstellung, wählen Sie einen Ordner aus und wählen Sie Bereitstellen.

Den vollständigen Satz von Optionen im Bereitstellungsbereich finden Sie unter Veröffentlichen und Bereitstellen von Lösungen im Studio Web-Benutzerhandbuch.

Nach der Bereitstellung ist die Aktions-App im Action Center verfügbar und kann als Schnittstelle für eine Aufgabe zugewiesen werden.