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:

Verwenden Sie in Automation Cloud Dedicated und Test Cloud Dedicated die UiPath-CLI-Version 1.202.0 für die Schritte pack, publish --type Action, deploy und push , bis Ihre dedizierte Produktionsumgebung auf die Apps-Version vom 24. September aktualisiert wird. 2026. Spätere CLI-Versionen enthalten grundlegende Änderungen, die nicht mit der Apps-Version kompatibel sind, die derzeit in dedizierten Umgebungen ausgeführt wird. Nachdem Ihre dedizierte Produktionsumgebung auf die Apps-Version vom 24. September 2026 aktualisiert wurde, können Sie spätere Versionen der UiPath CLI verwenden.

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 .

Action schema property names

Apps checks the property names in the action schema when a Coded Action App is published or installed. Two rules apply:

• A root property name can be used only once across inputs, outputs, inOuts, and outcomes.
• Sub-property names must be unique under the same parent property.

Names are compared only within the same level and parent. For example, cost.entries and turnover.entries can coexist, but status cannot appear in both inputs and outputs.

If a property is both read and written by the task, define it once under inOuts instead of in both inputs and outputs.

Whether a schema with duplicate names is rejected depends on how the app reaches the tenant:

Aktion	Schema with duplicate names
First publish of a Coded Action App with uip codedapp publish	Abgelehnt
Publish of a new version of an existing Coded Action App	Akzeptiert
Republish of a coded web app as a Coded Action App	Abgelehnt
First install of a solution that contains the Coded Action App	Rejected at install
Upgrade of a solution that contains the Coded Action App	Akzeptiert

When a schema is rejected, the error names each duplicate and where it repeats, for example 'status' in inputs and outputs or 'entries' under 'turnover'. For the fix, see the FAQ.

Wichtig:

Renaming a property changes the task data the app reads and writes. Tasks created before the rename still carry the old property names. Update the app code to handle both the old and new names before you publish the renamed schema.

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 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.