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:

• Die ausgewählte Automatisierung muss in Ihrem Orchestrator-Ordner vorhanden sein, bevor diese Aktivität konfiguriert wird. Dies gilt nicht, wenn eine Lösungsressource verwendet wird .
• 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-Ordnerpfad– Der Orchestrator-Ordner, in dem die Automatisierung bereitgestellt wird, die Sie starten möchten. Im Dropdownmenü werden nur die Ordner angezeigt, auf die Sie zugreifen können. Die Verfügbarkeit dieser Eigenschaft hängt vom Kontext ab:
    • Außerhalb einer Lösung– Die Eigenschaft ist immer verfügbar. Wenn Sie keinen Ordner auswählen, wird Ihr Persönlicher Arbeitsbereich verwendet.
    • Innerhalb einer Lösung ist der Prozessname auf eine Lösungsressourcefestgelegt– Die Eigenschaft ist sichtbar, aber schreibgeschützt und wird nicht berücksichtigt.
    • Innerhalb einer Lösung wird der Prozessname auf eine Variable festgelegt– Die Eigenschaft steht Ihnen zur Verfügung, um den Ziel-Orchestrator-Ordner auszuwählen.
  • Prozessname– Wählen Sie den Prozess aus, der der auszuführenden Automatisierung zugeordnet ist. Alle Prozesstypen werden angezeigt: RPA, Agents, Orchestrierung mit Agenten. Wenn der von Ihnen benötigte Prozess nicht aufgeführt ist, wählen Sie Prozesse verwalten aus, die zu Ihrem Ordner im Orchestrator umgeleitet werden sollen, wo Sie den fehlenden Prozess hinzufügen können.
  • Eingabeargumente– Konfigurieren Sie die Argumente, die an den ausgewählten Prozess übergeben werden sollen. Über das Symbol neben der Eigenschaft stehen drei Eingabemodi zur Verfügung:

    • Schema verwenden (Standard) – Importiert automatisch das Prozessargumentschema und generiert einen benutzerdefinierten Datentyp, der mit der Datenzuordnung bearbeitet werden kann. Die Eigenschaft Ausgabeargumente wird separat angezeigt. Um die aktuelle Liste der Prozessargumente abzurufen, wählen Sie Aktualisieren rechts neben der Eigenschaft aus.

      Wichtig:

      Stellen Sie für die optimale Erfahrung sicher, dass Sie die neueste Version von Studio verwenden. Studio-Versionen vor 2025.0.161 verwenden das Ausdrucks-Editor- Fenster. Das folgende Code-Snippet zeigt Ihnen, wie Sie mit VB.NET und C# Werte für Agent-Eingabeargumente bereitstellen können:

      '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"
      }
      

    • Argumente verwenden– Ein Argument-Widget, in dem jeder Eintrag einen Namen, einen Wert und eine Richtung (In/Out) hat. Sowohl Eingabe- als auch Ausgabeargumente werden hier konfiguriert. Die Eigenschaft Ausgabeargumente ist in diesem Modus ausgeblendet – Ausgabewerte werden über Einträge empfangen, bei denen die Richtung auf Out festgelegt ist.

    • Objekt verwenden– Akzeptiert jeden Variablen- oder Objektausdruck als Eingabe, der zur Laufzeit JSON-serialisiert und an den Prozess übergeben wird. JSON-Zeichenfolgen werden so übergeben, wie sie sind. Die Eigenschaft Ausgabeargumente wird weiterhin separat angezeigt.

• 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.
    • Auf Auftragsabschluss warten– Standardoption. Die Aktivität pausiert den Workflow, bis der gestartete Auftrag beendet ist oder das Timeout erreicht wird. Wenn der Auftrag erfolgreich abgeschlossen wurde, gibt die Aktivität die Ausgaben zurück und der Workflow wird fortgesetzt.
      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.

    • Ausführung bis Auftragsabschluss aussetzen– Die Aktivität pausiert den Workflow und wartet mit Persistenz auf die Ausgabe.
  • Timeout– Legt die maximale Zeit fest, die auf den Abschluss des Auftrags gewartet werden soll. Der Standardwert ist 600.000 Millisekunden (10 Minuten).
  • Bei Fehler fortsetzen– Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (true, false). Der Standardwert ist „False“. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf „true“ gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.
  • Fehlschlagen, wenn der Auftrag fehlschlägt– Diese Eigenschaft ist nur verfügbar, wenn der Ausführungsmodus Auf Auftragsabschluss warten oder Ausführung bis Auftragsabschluss aussetzen ist . Gibt an, ob die Aktivität eine Ausnahme auslösen soll, wenn der ausgeführte Orchestrator-Auftrag mit dem Status Fehlerhaft abgeschlossen wird. Der Standardwert ist Aus. Auf Ein festlegen, um eine Ausnahme auszulösen und die Ausführung des Workflows zu beenden, wenn der Orchestrator-Auftrag fehlschlägt.
  • Auftragsdaten– Zeigt das Objekt des gestarteten Auftrags an. Automatisch generiert.
  • Ausgabeargumente– Zeigt die Ausgabeargumente an, die vom Prozess nach Abschluss zurückgegeben werden. Diese Eigenschaft wird nur angezeigt, wenn der Eingabemodus Schema verwenden oder Objekt verwenden verwendet wird . Bei Verwendung des Arguments- Modus werden Ausgabeargumente über Einträge erfasst, bei denen die Richtung im Argument-Widget auf Aus festgelegt ist. Wenn Sie den Prozess aus einer Prozessliste auswählen, enthält das Ausgabeobjekt alle Ausgabeeigenschaften des ausgewählten Prozesses. Wenn Sie den Prozess mithilfe eines Ausdrucks angeben und der Prozess Werte zurückgibt, müssen Sie Eingabe- und Ausgabeargumente mit der Option Argumente verwenden konfigurieren.

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.