Prozess abrufen

UiPath.Core.Activities.InvokeProcess

Beschreibung

Führt einen UiPath-Prozess aus, der für die lokale Maschine verfügbar ist. Kann verwendet werden, um lokale Pakete sowie Prozesse in Orchestrator auszuführen, wenn eine Verbindung verfügbar ist.

Weitere Informationen dazu, wie Sie die Liste der verfügbaren Prozesse auf einer Maschine finden, finden Sie hier

Die Invoke Process-Aktivität wird im synchronen Modus ausgeführt, was bedeutet, dass der übergeordnete Prozess auf den Abschluss des untergeordneten Prozesses wartet, bevor er fortgesetzt wird.

Protokolle, die von den untergeordneten Prozessen generiert werden, enthalten nur das Ergebnis der Ausführung und Fehler. Sie werden am gleichen Ort wie die Protokolle vom übergeordneten Prozess geschrieben und können anhand des ProcessName-Felds in den lokalen Protokollen und der Process-Spalte im Orchestrator unterschieden werden.

Wenn Sie die Aktivität Invoke Process verwenden, wird ein einzelner Auftrag zu deren Ausführung erstellt, obwohl das Projekt mehrere Prozesse enthält, im Gegensatz zur Aktivität Run Parallel Process , die separate Aufträge für jeden Prozess im Projekt erstellt.

Wenn mehrere Prozesse hinzugefügt werden, wird die aktive Version im aktuellen Ordner verwendet.

Hinweis:

• Nicht serialisierbare Datentypen können nicht zwischen Workflows übergeben werden (z. B. UIBrowser, UIElement usw.).

Wenn ein untergeordneter Prozess aufgerufen, aber nicht gefunden wird, wird ein Fehler protokolliert, der den Namen des untergeordneten Prozesses, den Pfad, in dem der Roboter nach diesem gesucht hat, und zusätzliche Details wie WindowsIdentity und machineName enthält.

Hinweis: Wenn Sie eine höhere Version von UiPath.System.Activities als v20.4 verwenden, unterstützt Invoke Process mehrere Einstiegspunkte. Wenn ein Workflow mit dieser Version erstellt wird und das UiPath.System.Activities-Paket auf eine ältere Version heruntergestuft wird, die nur einen einzigen Einstiegspunkt unterstützt, weisen die Invoke Process-Aktivitäten im Workflow Validierungsfehler auf und müssen manuell ersetzt werden, um zu funktionieren.

Hinweis: Diese Aktivität ist nur mit Studio v19.6 und höher kompatibel.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Windows, plattformübergreifende Konfiguration

• Ordnerpfad – Der Pfad des Orchestrator-Ordners, in dem sich der angegebene Prozess befindet, falls er sich vom Ordner unterscheidet, in dem der Prozess ausgeführt wird. Dieses Feld unterstützt nur String-Werte mit / als Trennzeichen zur Angabe von Unterordnern. Zum Beispiel: "Finance/Accounts Payable".
  Hinweis: Der Folder Path-Parameter funktioniert nicht für Prozesse, die von Robotern in klassischen Ordnern ausgeführt werden. Nur Roboter in modernen Ordnern können Daten außerhalb ihres Ordners übergeben.
• Prozessname – Der Name des Prozesses, den Sie ausführen möchten. Dieses Feld unterstützt nur Strings und String-Variablen. Der Prozessname sollte den Namen des Pakets enthalten, da dieses vom Roboter verwendet wird.

Erweiterte Optionen

• Fortfahren bei Fehler (Continue On Error) – Gibt an, ob die Automation fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (wahr, falsch). Der Standardwert ist falsch. Als Ergebnis ist das Feld leer und ein Fehler wird ausgegeben; die Ausführung des Projekts wird angehalten. Wenn der Wert auf Wahr gesetzt wird, wird die Ausführung des Projekts unabhängig von Fehlern fortgesetzt.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• Timeout – Gibt (in Millisekunden) an, wie lange die Aktivität ausgeführt werden muss, bevor ein Fehler ausgegeben wird. Wenn Sie diese Eigenschaft leer lassen, wird unendlich lange gewartet, bis eine Ausnahme ausgelöst wird. Standardmäßig ist dieses Eigenschaftsfeld leer.
• Protokolleintrag – Gibt den Informationstyp an, der beim Starten der aufgerufenen Ressource automatisch protokolliert werden soll.
• Protokollbeendigung – Gibt den Informationstyp an, der beim Beenden der aufgerufenen Ressource automatisch protokolliert werden soll.
• Sstufe – Gibt die Protokollierungsstufe an, die auf die Meldungen angewendet wird, die von den Optionen Protokolleintrag und Protokollbeendigung generiert werden.
• Einstiegspunktpfad – Der Pfad der Workflowdatei, die zu Beginn des Prozesses ausgeführt wird, relativ zum Paketstamm. Ohne Angabe ist der standardmäßige Einstiegspunkt Main.xaml. Dieses Feld unterstützt nur Strings und String-Variablen.

• Zielsitzung – Gibt die Sitzung an, in welcher der untergeordnete Prozess gestartet wird:

  • Aktuell – Öffnet den untergeordneten Prozess in derselben Sitzung wie den übergeordneten Prozess.
  • Prozessstandard – Der untergeordnete Prozess verwendet die Prozesseinstellungen.
  • Haupt – Der untergeordnete Prozess wird in der Hauptsitzung gestartet, unabhängig davon, wo der übergeordnete Prozess ausgeführt wird.
  • Bild in Bild – Der untergeordnete Prozess wird in der Bild-in-Bild-Sitzung gestartet, unabhängig davon, wo der übergeordnete Prozess ausgeführt wird.

Windows – Legacy-Konfiguration

Eigenschaften-Panel

Allgemein

• Fortfahren bei Fehler (Continue On Error) – Gibt an, ob die Automation fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (wahr, falsch). Der Standardwert ist falsch. Als Ergebnis ist das Feld leer und ein Fehler wird ausgegeben; die Ausführung des Projekts wird angehalten. Wenn der Wert auf Wahr gesetzt wird, wird die Ausführung des Projekts unabhängig von Fehlern fortgesetzt.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

• Timeout (Millisekunden) – Gibt an, wie lange (in Millisekunden) die Aktivität laufen muss, bevor ein Fehler ausgegeben wird. Wenn Sie diese Eigenschaft leer lassen, wird unendlich lange gewartet, bis eine Ausnahme ausgelöst wird. Standardmäßig ist dieses Eigenschaftsfeld leer.

  Hinweis: Bei der Verwendung von Robotern der Version 2021.10 und älter werden Geschäftsausnahmen in einem isolierten Workflow nicht unterstützt. Alle Ausnahmen werden als Systemausnahmen zurückgegeben.

Eingabe

• Argumente – Eine Liste von IN-Argumenten, die Sie an den Prozess übergeben können, den Sie vom Orchestrator ausführen möchten. Wenn ein Argument einen unbekannten Typ hat, wird es in JSON konvertiert.
• ArgumentsVariable - Die Argumentvariablen, die an den aufgerufenen Prozess übergeben werden.
• Prozessname – Der Name des Prozesses, den Sie ausführen möchten. Dieses Feld unterstützt nur Strings und String-Variablen. Der Prozessname sollte den Namen des Pakets enthalten, da dieses vom Roboter verwendet wird.

Protokoll (Log)

• Protokolleintrag – Gibt den Informationstyp an, der beim Starten der aufgerufenen Ressource automatisch protokolliert werden soll.
• Protokollbeendigung – Gibt den Informationstyp an, der beim Beenden der aufgerufenen Ressource automatisch protokolliert werden soll.
• Protokollierungsstufe – Gibt die Protokollierungsstufe an, die auf die Meldungen angewendet wird, die von den Optionen Protokolleintrag und Protokollbeendigung generiert werden.

Sonstiges

• Einstiegspunkt – Der Pfad der Workflowdatei, die zu Beginn des Prozesses ausgeführt wird, relativ zum Paketstamm. Ohne Angabe ist der standardmäßige Einstiegspunkt Main.xaml. Dieses Feld unterstützt nur Strings und String-Variablen.
• Ordnerpfad – Der Pfad des Orchestrator-Ordners, in dem sich der angegebene Prozess befindet, falls er sich vom Ordner unterscheidet, in dem der Prozess ausgeführt wird. Dieses Feld unterstützt nur String-Werte mit / als Trennzeichen zur Angabe von Unterordnern. Zum Beispiel: "Finance/Accounts Payable".
  Hinweis: Der Folder Path-Parameter funktioniert nicht für Prozesse, die von Robotern in klassischen Ordnern ausgeführt werden. Nur Roboter in modernen Ordnern können Daten außerhalb ihres Ordners übergeben.
• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

• Zielsitzung – Gibt die Sitzung an, in welcher der untergeordnete Prozess gestartet wird:

  • Aktuell – Öffnet den untergeordneten Prozess in derselben Sitzung wie den übergeordneten Prozess.
  • Prozessstandard – Der untergeordnete Prozess verwendet die Prozesseinstellungen.
  • Haupt – Der untergeordnete Prozess wird in der Hauptsitzung gestartet, unabhängig davon, wo der übergeordnete Prozess ausgeführt wird.
  • Bild in Bild – Der untergeordnete Prozess wird in der Bild-in-Bild-Sitzung gestartet, unabhängig davon, wo der übergeordnete Prozess ausgeführt wird.
• Paket verwenden – Gibt an, ob der Prozess anhand seines Paketnamens (ausgewählt) oder Prozessnamens (nicht ausgewählt) identifiziert werden soll. Standardmäßig ist diese Option nicht ausgewählt.