Auftrag ausführen

UiPath.Activities.System.Jobs.RunJob

Beschreibung

Gehen Sie über die Aktivität Run Job , um andere Automatisierungen wie RPA-Workflows oder Agent-Prozesse einfach zu starten. Diese einzelne Aktivität konsolidiert vorhandene Aktivitäten, die Automatisierungen von Ihrem Workflow starten. Sie können auswählen, welchen Projekttyp Sie starten möchten, und die Aktivität passt ihr Verhalten basierend auf Ihrer Auswahl an.

Wichtig:

• The selected automation must exist in your Orchestrator folder prior to configuring this activity. This does not apply when using a solution resource.
• Stellen Sie nach dem Aktualisieren einer Automatisierung sicher, dass Sie sie erneut veröffentlichen und den entsprechenden Prozess im Orchestrator-Ordner erneut bereitstellen.

Projektkompatibilität

Windows | Plattformübergreifend

Windows, plattformübergreifende Konfiguration

• Texteigenschaften der Aktivität:

  • Orchestrator folder path—The Orchestrator folder where the automation you want to start is deployed. Only the folders you can access are displayed in the dropdown menu. The availability of this property depends on the context:
    • Outside a solution—The property is always available. If you do not select a folder, your Personal Workspace is used.
    • Inside a solution, Process name set to a solution resource—The property is visible but read-only and is not taken into account.
    • Inside a solution, Process name set to a variable—The property is available for you to select the target Orchestrator folder.
  • Process name—Select the process associated with the automation you want to run. All types of processes are displayed: RPA, Agents, Agentic Orchestration. If the process you need is not listed, select Manage processes to be redirected to your folder in Orchestrator, where you can add the missing process.
  • Input arguments—Configure the arguments to pass to the selected process. Three input modes are available via the icon next to the property:

    • Use Schema (default)—Auto-imports the process argument schema and generates a custom data type that is editable with the Data Mapper. The Output arguments property is shown separately. To retrieve the latest list of process arguments, select Refresh at the right side of the property.

      Wichtig:

      For the best experience, make sure you are using the latest Studio version. Studio versions previous to 2025.0.161 use the Expression Editor window. The following code snippet shows you how to provide values to agent input arguments using VB.NET and C#:

      'VB.NET
      New Email_Rewriter_Input() With {
      .feedback = "sample feedback",
      .originalEmail = "sample email content"
      }
      

      //C#
      new Email_Rewriter_Input {
      feedback = "sample feedback",
      originalEmail = "sample email content"
      }
      

    • Use Arguments—An Arguments widget where each entry has a Name, Value, and Direction (In/Out). Both input and output arguments are configured here. The Output arguments property is hidden in this mode — output values are received via entries with Direction set to Out.

    • Use Object—Accepts any variable or object expression as input, which is JSON-serialized at runtime and passed to the process. JSON strings are passed as they are. The Output arguments property is still shown separately.

• Eigenschaftenbereich:

  • Ausführungsmodus– Wählen Sie aus, wie die Aktivität auf den Abschluss des Auftrags wartet. Die folgenden Optionen sind verfügbar:
    • Nicht warten– Die Aktivität startet den Auftrag und lässt den Workflow fortfahren, ohne auf den Abschluss des Auftrags zu warten.
    • Wait for job completion—Default option. The activity pauses the workflow until the started job finishes or the timeout is reached. If the job completion is successful, the activity returns the outputs, and the workflow resumes.
      Hinweis:

      Dieser Ausführungsmodus verwendet die Orchestrator SignalR-Funktion, um den Auftragsabschluss in Echtzeit zu bestätigen. Sie kann in den Orchestrator-Einstellungen auf Mandantenebene aktiviert werden. Wenn SignalR deaktiviert ist, wird dieser Ausführungsmodus standardmäßig auf 30-Sekunden-Abruf festgelegt.

    • Suspend execution until job completion—The activity pauses the workflow and awaits output with persistence.
  • Timeout– Legt die maximale Zeit fest, die auf den Abschluss des Auftrags gewartet werden soll. Der Standardwert ist 600.000 Millisekunden (10 Minuten).
  • Continue on error—Specifies whether the automation should continue even when the activity throws an error. This field only supports Boolean values (true, false). The default value is false. As a result, if the field is not configured and an error is thrown, the execution of the project stops. If the value is set to true, the execution of the project continues regardless of any error.
  • Fail when job fails—This property becomes available only when the execution mode is Wait for job completion or Suspend execution until job completion. Specifies whether the activity should throw an exception when the executed Orchestrator job completes with a Faulted status. The default value is Off. Set to On to throw an exception and stop the execution of the workflow when the Orchestrator job fails.
  • Auftragsdaten– Zeigt das Objekt des gestarteten Auftrags an. Automatisch generiert.
  • Output arguments—Displays the output arguments returned by the process upon completion. This property is only shown when using Use Schema or Use Object input mode. When using Use Arguments mode, output arguments are captured via entries with Direction set to Out in the Arguments widget. If you select the process from a process list, the output object contains all the output properties of the selected process. If you provide the process using an expression and the process returns values, you must configure input and output arguments using the Use Arguments option.

Bekannte Einschränkung

Wenn ein agentischer Prozess eine Ausnahme auslöst, hält Maestro den Auftrag in Orchestrator im Status „Wird ausgeführt “ und erwartet, dass die Ausnahme innerhalb von Maestro behandelt wird.

Ergebnis:

• Die Aktivität Run Job erkennt den Fehler nicht.
• Wenn sie auf Auf Auftragsabschluss warten konfiguriert ist, ermöglicht sie entweder:
  • Zeitüberschreitung oder
  • Hängend im Persistenzmodus auf unbestimmte Zeit, da der Auftrag nie Successful erreicht.

Um dieses Verhalten zu vermeiden, verwenden Sie die folgenden Empfehlungen, die auf dem Ausführungsmodus der Aktivität Run Job basieren:

• Wenden Sie für Auf Auftragsabschluss warten ein Timeout an, das der erwarteten Dauer des agentischen Prozesses entspricht. Ohne sie bleibt der Workflow hängen und wartet auf eine Auftragsstatusänderung, die nie auftritt.
• Verwenden Sie Ausführung bis Auftragsabschluss aussetzen, da dieser Modus am besten funktioniert, wenn Ihr Workflow Ausgaben erhalten muss. Der Prozess wird automatisch fortgesetzt, wenn der agentische Prozess abgeschlossen ist.