Wenn du einen unbeaufsichtigten Prozess in deinem cloudbasierten UiPath-Orchestrator eingerichtet hast, kann es praktisch sein, dessen Ausführung per Fingertipp vom Smartphone aus zu starten. In diesem Blogbeitrag erkläre ich, wie du eine solche Integration mithilfe eines einfachen Prozessablaufs in Make umsetzen kannst.
Du weisst vielleicht bereits, dass Make drei Module zur Integration mit UiPath anbietet. Diese Module setzen jedoch ein Enterprise-Konto voraus, da Module der Stufe 3 im kostenlosen Tarif nicht aktiv genutzt werden können. Mein Ziel war es, eine einfache Integrationslösung für UiPath zu entwickeln, ohne ein Enterprise-Konto zu benötigen. Ein kostenloses Make-Konto erlaubt zwei aktive Szenarien gleichzeitig – das reicht für diese Umsetzung völlig aus.
1. API-Zugriff im UiPath-Orchestrator konfigurieren
Nachdem du einen unbeaufsichtigten Prozess im UiPath-Orchestrator eingerichtet hast, musst du den API-Zugriff konfigurieren. Geh dazu wie folgt vor:
1. Klicke auf das Menü-Raster und wähle Admin (die letzte Option im Abschnitt «Operate»).
2. Navigiere zu External applications und klicke unter dem Tab «OAuth Apps» auf + Add application.
3. Gebe einen Anwendungsnamen ein und wähle als Typ Confidential application.
4. Klicke auf + Add scopes. Wähle im Dropdown-Menü Resource die Option Orchestrator API access, wechsle zum Tab Application scope(s), aktiviere mindestens folgende Berechtigungen und klicke auf Save:
- OR.Jobs
- OR.Execution.Read
5. (Optional) Gib eine Redirect URL ein (z. B. https://www.make.com ) und klicke auf Add.
6. Kopiere App ID und App Secret – diese benötigst du später zur Einrichtung des API-Zugriffs in Make.
Die ausgewählten Berechtigungen (Scopes) sind entscheidend, um über die API Zugriff auf bestimmte Teile des Orchestrators zu erhalten.
Klicke nun oben rechts auf dein Profil-Icon, gehe zu Settings und wähle unter Privacy & security die Option View API access. Kopiere Organisation ID und Name aus der Tabelle.
Damit ist die Konfiguration im UiPath-Orchestrator abgeschlossen – jetzt geht’s an die Umsetzung in Make.
Swagger für UiPath
Um die verfügbaren API-Aufrufe einzusehen, kannst du die Swagger-Dokumentation der Orchestrator API aufrufen, indem du /swagger/index.html an die Basis-URL deiner UiPath Cloud-Instanz anhängst: https://cloud.uipath.com/{Organization ID}/{Tenant Name}/orchestrator_.
2. Implementierung des Prozesses in Make
Unser Ziel ist es, einen UiPath-Prozess vom Smartphone aus mit nur einem einzigen Fingertipp zu starten. Um eine reibungslose Implementation sicherzustellen, werden wir zuerst jeden Schritt testen, bevor wir den finalen Trigger einbauen.
2.1 Authentifizierung
Melde dich bei Make an, klicke auf Scenarios und erstelle ein neues Szenario. Füge zuerst das Modul HTTP: Make a request hinzu. Klicke auf dieses Modul und konfiguriere es wie folgt:
- URL:
https://cloud.uipath.com/{Organisation ID}/identity_/connect/token - Method:
POST - Body type:
Application/x-www-form-urlencoded
Unter Fields definiere die folgenden vier Elemente (die Reihenfolge spielt keine Rolle):
Setze die Option Parse response auf Yes und klicke auf Save.
Um eine Antwort zu erhalten, klicke auf Run once oder wähle Run this module only im Kontextmenü. Wir benötigen den Wert für access_token für alle folgenden API-Aufrufe.
2.2 Den Release Key abrufen
Um einen UiPath-Job auszuführen, brauchst du den Release Key des relevanten UiPath-Package. Füge dafür ein weiteres Modul HTTP: Make a request hinzu. Im Feld URL, erfasse die Basis-URL ergänzt um /odata/Releases. Dies ist die Grundversion zur Abfrage von Informationen über Releases. Eventuell möchtest du die Abfrage verfeinern, indem du Operatoren wie $filter für spezifischere Resultate hinzufügst. Ein Beispiel: ?$filter=contains(Name,'MyText')&$top=1 (vgl. https://docs.uipath.com/orchestrator/automation-cloud/latest/api-guide/building-api-requests).
Unter Headers sind zwei Elemente zu konfigurieren. Für den Authorization Header, gib den Text Bearer ein und mappe das Feld access_token aus dem Daten-Array, indem du es aus der Antwort des vorhergehenden Moduls hinüberziehst.
Um die X-UIPATH-OrganizationUnitId, die der numerischen ID eines Ordners entspricht (OrganizationUnitId), zu finden, navigiere zu diesem Ordner in deinem UiPath-Orchestrator und entnehme den Wert für die fid aus der URL, z. B. /?tid=12345&fid=1234567.
Setze die Option Parse response auf Yes und klicke auf Save.
2.3 Den Job im UiPath-Orchestrator starten
Jetzt wollen wir unsere zentrale API-Abfrage zum Starten eines Jobs im UiPath-Orchestrator definieren. Wir fügen ein weiteres Modul HTTP: Make a request hinzu. Im Feld URL erfasse die Basis-URL, ergänzt um/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs. Wir verwenden die Methode POST und dieselben beiden Header aus der vorhergehenden Abfrage.
Als Body type wähle Raw und als Content type JSON (application/json). Erfasse im Feld Request content die folgende JSON-Struktur (und mappe den Wert für ReleaseKey aus der vorhergehenden Antwort – vergiss nicht, die Anführungszeichen um den gemappten Wert zu setzen):
Diese temporäre Abfrage kannst du ausführen, indem du die ersten zwei oben definierten Module verwendest, aber mit dieser URL hier im zweiten Modul.
In der JSON-Payload kannst du nach Bedarf mehr Elemente hinzufügen, z. B. "Source": "Manual" oder "InputArguments": "{…}" (Wert im JSON-Format). Zumindest der ReleaseKey ist zwingend.
Setze die Option Parse response auf Yes und klicke auf Save. Unter der technischen Support-Seite https://uipath.my.salesforce-sites.com/CaseView/articles/Knowledge/start-a-job-using-Orchestrator-API findest du weitere Informationen zur Erstellung dieser API-Abfrage.
Nun haben wir das folgende Prozess-Design in Make:
Versuche nun, diesen Make-Prozess auszuführen. Wenn alles richtig eingerichtet ist, wird der UiPath-Prozess sofort gestartet oder gelangt in den Status «Pending».
2.4 Den Automationsprozess triggern
Als letzten Schritt müssen wir eine Funktion integrieren, mit der wir unseren Automatisierungsprozess über das Smartphone starten können. Dafür kannst du das Modul Watch button für Apple iOS oder Android verwenden. Zunächst verbindest du dein Smartphone über die Menüoption More > Devices > Add device, indem du ihm einen Namen gibst und den QR-Code mit der Make-App auf dem Mobilgerät scannst. Danach erstellst du in der Smartphone-App einen Button. Der vergebene Name entspricht der Button-ID, die du zur Konfiguration des Moduls Watch button in Make benötigst.
Alternativ kannst du das Modul Custom webhook wählen. Nachdem du es entsprechend benannt hast, kopiere die spezifische URL und rufe sie einmal in einem Webbrowser auf. Dadurch wird die Datenstruktur im Hintergrund automatisch definiert (in unserem Fall eine leere Struktur). Setze das Trigger-Modul an den Anfang deines Automatisierungsprozesses und verbinde es mit den folgenden Modulen. Du kannst die Auto-Align-Funktionalität verwenden, um das Design deines Moduls ansprechend zu gestalten, wie im folgenden Bild.
Teste den gesamten Prozess, indem du auf Run once klickst – so lauscht der Webhook auf eingehende Daten. Sobald die entsprechende Webhook-URL aufgerufen wird, startet der Prozess. Vergiss zum Schluss nicht, dieses Szenario zu aktivieren. Für einen Webhook-Trigger wählst du in der Regel die bereits voreingestellte Option Immediately. Du kannst diese URL auch als Verknüpfung auf dem Startbildschirm deines Smartphones ablegen, um sie bei Bedarf bequem per Tippen aufzurufen.
2.5 Erweiterung des Szenarios
Aufgrund der Vielzahl möglicher API-Abfragen im UiPath-Orchestrator könntest du dieses Szenario beispielsweise erweitern, indem du nach einer Verzögerung eine Abfrage zum Status eines zuvor gestarteten Jobs einfügst und das Ergebnis an eine E-Mail-Adresse sendest. Denk daran, dass du in API-Anfragen nur solche Scopes verwenden kannst, die du zuvor im UiPath-Orchestrator konfiguriert hast – wie im ersten Abschnitt beschrieben.
3. Alternative Ansätze
Um unser Ziel zu erreichen, haben wir Make verwendet, um den UiPath-Prozess per Smartphone-Button zu starten. Du kannst jedoch dieselben API-Aufrufe auch mit anderen Tools wie PowerShell- oder Bash-Skripts ausführen. Wenn du die App «UiPath Orchestrator» verwenden würdest, könntest du einen Job nicht mit nur einem einzigen Tipp starten.
4. Fazit
In diesem Blogbeitrag haben wir gezeigt, wie sich eine Integration zwischen UiPath-Orchestrator und Make konfigurieren lässt, um unbeaufsichtigte Prozesse aus der Ferne zu starten. Falls du das offizielle UiPath-Modul in Make nicht verwenden kannst, bietet diese alternative Methode eine praktikable Lösung. Durch die Umsetzung der Authentifizierung, das Abrufen des Release Keys und das Starten des Jobs kannst du UiPath-Workflows effizient von deinem Mobilgerät aus mit einem Trigger ausführen.
Wenn du Unterstützung bei der Prozessautomatisierung mit Tools wie Make oder UiPath benötigst, melde dich gerne bei uns. Wir bieten auch die Variante UiPath as a Service an.
