Über Eingabe- und Ausgabeargumente

Übersicht über Eingabe- und Ausgabeargumente für die Übergabe von Daten an und aus Automatisierungsprozessen über den Orchestrator.

We have exposed the In and Out arguments, you are already used to in Studio, as a way to seamlessly integrate the tools you use, such as various DCMs or BPMs. This means that any process you create can now receive input arguments through the Orchestrator API or interface, as well as return output to all of the aforementioned.

Last but not least, this is a stepping stone in linking processes together. This extensibility helps you better integrate UiPath® in your company’s ecosystem.

Hinweis:

Nur die Eingabe-, Ausgabe- und In/Out-Argumente der .xaml, die in Studio als Main gekennzeichnet sind, werden für andere Apps verfügbar gemacht. Die Argumente werden im project.json des Projekts gespeichert.

At design time, in Studio, the way you configure your project to accept In or Out arguments, with or without default values, enables you to use them in other third-party apps or Orchestrator. You can only make use of input and output arguments in Orchestrator and other third-party apps if you had added the corresponding arguments in your Studio project beforehand.

If no arguments have been added in Studio, the following message is displayed: "Input arguments are not defined for this version.".

Die In-, Out- oder In/Out-Argumente eines Projekts werden beim Veröffentlichen im Orchestrator zu Eingabe- und Ausgabeargumenten. Bitte beachten Sie, dass für In/Out-Argumente zwei verschiedene Argumente im Orchestrator erstellt und angezeigt werden, nämlich ein Eingabe- und ein Ausgabeargument, mit dem gleichen Namen.

Bereitstellen von Argumentwerten

Werte können nur folgendermaßen für Eingabeargumente bereitgestellt werden, entweder mit Studio, dem Orchestrator oder der Orchestrator-API:

Studio

Als Standardwerte beim Erstellen der Argumente. Ein kurzes Beispiel finden Sie hier. Eine Standardwert für ein Argument in Studio kann in Orchestrator sowohl auf Prozess- als auch auf Job-Ebene überschrieben werden.

Hinweis:

Standardwerte für Eingabeargumente in Studio werden auf keiner Ebene in Orchestrator angezeigt.

Orchestrator

• Auf Prozessebene – Auf der Registerkarte Argumente im Fenster Prozess anzeigen, wie hier erläutert.
• Auf Auftragsebene – Auf der Registerkarte Argumente im Fenster Auftrag starten, wie hier erläutert.
• Auf Triggerebene – Auf der Registerkarte Argumente im Fenster Trigger hinzufügen, wie hier erläutert.
  Hinweis:

  Ein Wert, der für ein Eingabeargument auf Prozessebene im Orchestrator bereitgestellt wird, wird beibehalten, wenn Sie das Paket aktualisieren, solange die neue Paketversion keine Auswirkungen auf die Definition von Argumenten hat. Das Speicherlimit für Ein-/Ausgabeargumente beträgt 1 MB.

Wenn Sie im Orchestrator Werte für Eingabeargumente angeben, beachten Sie bitte, dass diese im JSON-Format anzugeben sind. Beispiele dafür, wie dies möglich ist, finden Sie hier:

• Zeichenfolge - der Wert muss ohne Anführungsstriche angegeben werden, zum Beispiel string;
• Int32 - Geben Sie diesen Wert wie einen Integer-Wert an, 11;
• Boole‘scher Wert - Radio-Buttons helfen Ihnen, true oder false auszuwählen;
• Doppel - Geben Sie diesen Wert wie einen Floating Point-Wert an, zum Beispiel 3.5;
• Datum/Uhrzeit - Geben Sie diesen Wert als einen gültigen JSON-Wert an, zum Beispiel "2012-04-23T18:25:43.511Z";
• Array - Geben Sie diesen Wert als einen gültigen JSON-Wert an, zum Beispiel [1, 1, 2, 3, 5, 8] oder ["firstString", "secondString"];
  Hinweis:

  Jeder Argumenttyp kann verwendet werden, aber berücksichtigen Sie bitte, dass nur Elementarwerte von Orchestrator validiert werden können. Wenn Aufzählungstypen (Enums) in JSON konvertiert werden, wird jedes Aufzählungselement durch einen Integerwert und nicht durch seinen Namen dargestellt. Das bedeutet, dass die JSON-Darstellung einer Aufzählung der numerische Wert jedes Elements ist, das in der ursprünglichen Aufzählung enthalten ist.

Orchestrator-API

• Auf Paketebene – an den Endpunkt /odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key');
• Auf Prozessebene – Als PATCH-Anforderung zum Endpunkt /odata/Releases(Id);
• Auf Auftragsebene – Als POST-Anforderung an den Endpunkt /odata/Jobs/UiPath.Server.Configuration.OData.StartJobs;
• Auf Zeitplan-Ebene – Als POST-Anforderung zum Endpunkt /odata/ProcessSchedules.
  Hinweis:

  Bei API-Aufrufen werden maximal 10.000 Zeichen für die Gesamtlänge der JSON-Darstellung der Eingabeargumente, einschließlich der Argumentnamen, aller Escape-Zeichen, Leerzeichen, Klammern und Argumentwerte, akzeptiert.

Anzeigen von Argumentwerten

Der Wert eines Eingabearguments wird folgendermaßen markiert:

• Kein Wert – Für das Argument wurde auf Prozess-, Auftrags-, Zeitplan- oder Paketebene kein Wert (in Studio) festgelegt.
• Aus Paket übernommen (Inherited from package) - Der Wert wurde in Studio per Standard festgelegt. Diese Meldung wird im Fenster Argumente (Arguments) eines bestimmten Pakets sowie in den Fenstern Prozess anzeigen (View Process), Job starten (Start Job), und Zeitplan hinzufügen (Add Schedule) angezeigt.
• Aus Prozess geerbt – Wenn der Wert auf Prozessebene bereitgestellt wurde (im Fenster Prozess anzeigen). Diese Meldung wird im Fenster Auftrag starten und Zeitplan hinzufügen angezeigt. Im Fenster Prozess anzeigen wird der Wert selbst angezeigt.

Abbildung 1. Argumentwerte

Sind Eingabe- oder Ausgabeargumentwerte vorhanden, werden diese im Fenster Auftragsdetails angezeigt. Die folgenden Eingabewerte werden in folgenden Fällen im zuvor genannten Fenster angezeigt:

• Sie wurden auf Prozessebene hinzugefügt;
• Sie wurden auf Auftragsebene hinzugefügt.

Sie können Eingabe- und Ausgabeargumente auch auf Paketebene im Fenster Paketversionen anzeigen. Weitere Informationen finden Sie unter Verwalten von Paketen.

Hinweis:

Workflows, die vor Version v2018.3 im Orchestrator erstellt und veröffentlicht wurden, müssen mit einer v2018.3- Roboter-Version (oder höher) neu hochgeladen werden, um die Eingabe- und Ausgabeargumente der Datei Main.xaml anzeigen zu können.

Argumentberechtigungen

Die folgenden Berechtigungen sind für Eingabe- und Ausgabeargumente im Orchestrator erforderlich:

• Auf Paketebene - Anzeigen (View) für Pakete;
• Auf Prozessebene - Anzeigen (View) und Bearbeiten (Edit) für Prozesse;
• Auf Job-Ebene - Erstellen (Create) für Jobs;
• Auf Zeitplanebene – Erstellen und/oder Bearbeiten für Zeitpläne.

Umgang mit großen Eingabeargumenten (> 10.000 Zeichen)

Wenn die Größe der Eingabeargumente eines Auftrags 10.000 Zeichen überschreitet, wandelt der Aufrufer, der den Auftrag startet, die Nutzlast in eine anhangbasierte Eingabe um.

In diesem Fall werden die Eingabeargumente als Dateianhang in Orchestrator gespeichert und dem Roboter als herunterladbare Nutzlast bereitgestellt, anstatt direkt im Anforderungstext des Auftrags enthalten zu sein.

Kompatibilität der Roboterversion

Diese Funktion wird ab Roboterversion 2025.10 unterstützt.

Wichtig:

Aufträge, die anhangsbasierte Eingabeargumente verwenden, schlagen fehl, wenn sie von Robotern ausgeführt werden, die eine frühere Version verwenden, die dieses Format nicht unterstützt.

Umgang mit großen Eingaben

Wenn dieses Verhalten auftritt, können Sie Folgendes tun:

• Aktualisieren Sie den Roboter auf eine kompatible Version (2025.10 oder höher).
• Reduzieren Sie die Größe der Eingabeargumente, damit sie inline übermittelt werden können.
• Lagern Sie die Nutzlast aus (empfohlen), indem Sie große Datenmengen extern speichern (z. B. in Speicher-Buckets oder externen Speichern) und lediglich einen Verweis darauf übergeben (z. B. einen Dateinamen, eine ID oder eine URL).

Beispiel

1. Laden Sie die große Nutzlast (z. B. eine JSON-Datei) in einen Speicher-Bucket hoch.
2. Übergeben Sie einen Verweis auf die Datei als Eingabeargument:

{
  "inputFileName": "large-payload.json"
}

3. Rufen Sie die Datei im Workflow mit der entsprechenden Aktivität ab (z. B. Download Storage File) und verarbeiten Sie sie.