Über Eingabe- und Ausgabeargumente

Wir haben die Eingabe- und Ausgabeargumente, die Sie bereits in Studio verwendet haben, herausgestellt, um die Tools, die Sie verwenden, wie DCMs oder BPMs, nahtlos zu integrieren. Dies bedeutet, dass jeglicher von Ihnen erstellte Prozess jetzt Eingabeparameter über die Orchestrator-API oder die Bedienoberfläche erhalten und an alle oben genannten eine Ausgabe zurückgeben kann. Schließlich ist dies ein Meilenstein in der Verknüpfung von Prozessen. Dank dieser Erweiterungsmöglichkeit können Sie UiPath besser in das Ökosystem Ihres Unternehmens integrieren.

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.

Beim Design in Studio ermöglicht Ihnen die Art und Weise, wie Sie Ihr Projekt konfigurieren, um Eingabe- oder Ausgabeargumente mit oder ohne Standardwerte zu akzeptieren, diese in den Apps fremder Entwickler oder Orchestrator zu verwenden. Sie können in Orchestrator und anderen Apps fremder Entwickler nur dann Eingabe- und Ausgabeparameter verwenden, wenn Sie zuvor die entsprechenden Argumente zu Ihrem Studioprojekt hinzugefügt haben. Wenn in Studio keine Argumente definiert wurden, wird folgende Meldung eingeblendet: „Für diese Version sind keine Eingabeparameter definiert.“

Die Eingabe-, Ausgabe oder Eingabe-/Ausgabeargumente eines Projekts werden beim Veröffentlichen in Orchestrator zu Eingabe- und Ausgabeparametern. Bitte beachten Sie, dass für Eingabe-/Ausgabeargumente zwei verschiedene Parameter in Orchestrator erstellt und angezeigt werden, nämlich einer für Eingabe und einer für Ausgabe, mit demselben Namen.

Bereitstellen von „Parameterwerten“

Werte können nur folgendermaßen für Eingabeparameter 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 Parameter (Parameters) im Fenster Prozess anzeigen (View Process), wie hier erläutert.
• Auf Jobebene - auf der Registerkarte Parameter (Parameters) im Fenster Job starten (Start Job), wie hier erläutert.

• auf Zeitplanebene - auf der Registerkarte Parameter (Parameters) im Fenster Zeitplan hinzufügen (Add Schedule), 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.

Wenn Sie in Orchestrator Werte für Eingabeparameter angeben, beachten Sie bitte, dass diese im JSON-Format anzugeben sind. Beispiele davon, 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.

Orchestrator-API

• Auf Paketebene - zum Endpunkt /odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key');
• Auf Prozessebene - als PATCH-Anforderung zum Endpunkt /odata/Releases(Id);
• Auf Job-Ebene - als POST-Anforderung zum 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 Parameterwerten

Der Wert eines Eingabeparameters wird folgendermaßen markiert:

• Kein Wert (No value) - Für den Parameter wurde auf Prozess-, Job-, 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.

  
  

  

  
  

Sind Eingabe - oder Ausgabeparameter angegeben, werden diese im Fenster Job-Details angezeigt. Die Eingabewerte werden in folgenden Fällen im vorgenannten Fenster angezeigt.

• Sie wurden auf Prozessebene hinzugefügt.
• Sie wurden auf Job-Ebene hinzugefügt.

Sie können Eingabe- und Ausgabeparameter auf Paketebene im Fenster Paketversionen (Package Versions) 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.

Berechtigungen

Die folgenden Berechtigungen sind im Hinblick auf Eingabe- und Ausgabeparameter in 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 (Create) und/oder Bearbeiten (Edit) für Zeitpläne.