Skriptaufgabe

Execute inline JavaScript in Maestro Orchestrate Script tasks to manipulate data, enrich payloads, apply conditional logic, or transform input before passing it to the next process component.

The Script Task in Maestro Orchestrate allows you to execute inline JavaScript to manipulate data, enrich payloads, apply conditional logic, or transform input before passing it to the next component in the process.

Verwenden Sie Skriptaufgaben, um Daten für Schema-Warteschlangen, API-Aufrufe, Agents oder Speichersysteme vorzubereiten.

Implementierung > Typ: Inline-Skript ausführen.

Wann Sie Skriptaufgaben verwenden sollten

Verwenden Sie eine Skriptaufgabe, wenn:

• Sie eingehende Daten transformieren oder umstrukturieren möchten.

• Sie Felder validieren oder ungültige Eingaben ablehnen möchten.

• Sie mehrere Eingaben in einem einzigen Objekt kombinieren müssen.

• Sie Daten vor der Weiterleitung filtern, bereinigen oder neu formatieren möchten.

  Hinweis:

  Maestro Orchestrate currently supports JavaScript only inside the expression editor.

Setting up a Script task in Maestro Orchestrate

1. Fügen Sie einen Skriptaufgabenknoten aus der Prozesssymbolleiste hinzu (ziehen Sie ihn auf die Arbeitsfläche oder doppelklicken Sie darauf, um ihn in der Mitte einzufügen).
2. Fügen Sie im Bereich Eingaben auf der rechten Seite Eingabeargumente hinzu.

Die Eingabeargumente können Literalwerte, Kontextvariablen oder frühere Knotenausgaben sein (z. B. vars.inArg). 3. Schreiben Sie Ihr Skript im Editor:

• Wählen Sie das Skript-Eingabefeld aus und erweitern Sie dann in die vollständige Editor-Ansicht.
• JavaScript-Ausdrücke müssen ein Objekt oder einen Wert wie im folgenden Beispiel return:

  return {
    param1: inputString,
    param2: "staticValue"
  };
  

4. Map outputs from the return object into Maestro Orchestrate variables using the Outputs section.

Ergebnis

The script task is configured with its inputs, logic, and output mappings. The return object's values are available as Maestro Orchestrate variables for use in subsequent process nodes.

Testen der Skriptlogik

Sie können Ausdrücke inline testen, indem Sie das Symbol fx auswählen, um den Editor für JS-Funktionsausdrücke zu öffnen. Der Editor enthält:

• Einen Testeingabebereich, in den Sie Beispieleingaben einfügen können.
• Einen Bereich mit der Ausdruckausgabe in Echtzeit, um in der Vorschau zu sehen, wie Ihr Rückgabeobjekt aussehen wird.

Runtime / runtime-Fehler (z. B. JSON.parseFehler) werden angezeigt, um Ihnen das Debug zu erleichtern.

Für Skriptaufgaben verfügbare Aktionen

In der Auswahlliste Aktion in einer Skriptaufgabe können Sie den Typ der externen Ausführung definieren, die der Prozess aufrufen soll. Jede Option ist einer bestimmten UiPath-Funktion oder Integrationsmethode zugeordnet. Im Folgenden finden Sie einen kurzen Überblick über die einzelnen Optionen:

• Keine

  Für die Skriptaufgabe ist keine Implementierung konfiguriert.

• Aktions-App-Aufgabe erstellen

  Erstellt eine Aufgabe in einer Aktions-App für eine Benutzerinteraktion, ohne auf den Abschluss der Aufgabe zu warten.

• Starten und auf RPA-Workflow warten

  Startet einen bereitgestellten RPA-Workflow (z. B. UiPath Studio-Projekt) und wartet auf dessen Abschluss, bevor es fortfährt.

• Starten und auf Agent warten

  Startet einen UiPath Agent (einen wiederverwendbaren Logikblock) und wartet, bis die Ausführung abgeschlossen ist.

• Starten und auf externen Agenten warten

  Löst einen Agent aus, der außerhalb von UiPath gehostet wird, z. B. CrewAI, Salesforce oder ServiceNow, und wartet auf das Ergebnis.

• Starten und auf API-Workflow warten

  Führt einen API-basierten Workflow aus und wartet auf eine Antwort.

• Agent-Prozess starten

  Startet einen Prozess auf Basis eines agentischen Designs (modulare Logik), ohne auf dessen Abschluss zu warten.

• Starten und auf Agent-Prozess warten

  Startet einen agentischen Prozess und pausiert, bis die Ausführung abgeschlossen ist.

• Geschäftsregel ausführen [Vorschau]

  Bewertet eine Geschäftsregel und verwendet das Ergebnis im Prozess (aktuell in der Vorschauphase).

• Warteschlangenelement erstellen

  Fügt einer UiPath-Queue für die asynchrone Verarbeitung ein neues Element hinzu, ohne auf ein Ergebnis zu warten.

• Warteschlangenelement erstellen und warten

  Fügt einer Queue ein Element hinzu und wartet, bis dieses verarbeitet wurde, um fortzufahren.

• Bulk add queue items

  Fügt einer Warteschlange bis zu 15.000 Elemente in einem einzelnen Batch hinzu.

• Delete queue items

  Entfernt Elemente mit dem Status Neu aus einer Warteschlange.

• Postpone transaction item

  Verschiebt ein in Bearbeitung befindliches Transaktionsobjekt auf ein späteres Datum und gibt es in den Status Neu zurück.

• Set transaction progress

  Aktualisiert ein Transaktionselement in Bearbeitung mit einer benutzerdefinierten Statuszeichenfolge, die in Orchestrator sichtbar ist.

• Set transaction status

  Setzt den Endstatus der Transaktion auf Erfolgreich oder Fehlgeschlagen.

• Connector-Aktivität ausführen

  Führt eine vorkonfigurierte Aktivität „Integration Service Connector“ (z. B. Salesforce oder Slack) aus.

• Auf Connector-Ereignis warten

  Pausiert den Prozess, bis ein bestimmtes Ereignis von einem Connector empfangen wird (z. B. Formularübermittlung oder externer Trigger).

• Skript ausführen

  Führt während des Prozesses ein kurzes Skript (JavaScript oder ähnlich) für eine einfache Logik oder Transformation aus.

  

Im Dialogfeld Variable hinzufügen können Sie eine neue Variable definieren, indem Sie deren Namen, Typ (z. B. String, Zahl, Boolean usw.) und den optionalen Standardwert angeben. Nach dem Speichern steht die Variable zur Verwendung in Eingaben, Ausgaben oder Ausdrücke innerhalb der Skriptaufgabe zur Verfügung.

Autopilot-Unterstützung für Skriptaufgaben

The JS Function Expression editor includes Autopilot for Maestro Orchestrate assistance that helps you write and refine JavaScript expressions directly in Script tasks. You can describe the logic you need in plain language, and Autopilot generates a function that you can review, edit, and test in place. The editor shows a live preview of the expression output and lets you insert variables from your workflow, so you can build and validate custom logic without leaving the canvas.

Erforderliche Felder und Verhalten jeder Warteschlangenaktion finden Sie unter Warteschlangenaufgabenaktivitäten.

Weitere Informationen zu Aufgaben finden Sie unter Aufgaben in der BPMN-Modellierung.

Hinweis:

Der Zugriff auf Agents und API-Workflows hängt von dem von Ihnen verwendeten Cloud-Angebot ab. Weitere Informationen finden Sie unter Verfügbarkeit der Maestro Orchestrate-Funktion.