Workflow-Datei aufrufen (Invoke Workflow File)

UiPath.Core.Activities.InvokeWorkflowFile

Beschreibung

Ruft einen festgelegten Workflow synchron auf und übergibt ihm optional eine Liste von Eingabeargumenten. Mit dieser Aktivität können Argumente über die Schaltfläche Argumente importieren im Textkörper der Aktivität aus einem angegebenen Workflow importiert werden.

Hinweis:

• Wenn Argumente aus einem Workflow importiert werden, werden sie automatisch mit vorhandenen Variablen abgeglichen, wenn sie den gleichen Namen und Datentyp haben.
• Nicht serialisierbare Datentypen können nicht zwischen isolierten Workflows übergeben werden (z. B. UIBrowser, UIElement usw.).
• Virenschutzrichtlinien, die den PowerShell-Zugriff einschränken, können die Verwendung von PowerShell-bezogenen Aktivitäten verhindern. Zum Beispiel können Sie Invoke Workflow File und Invoke Power Shell nicht verwenden, wenn die Regel-ID 6151 in McAfee Endpoint Security aktiviert ist.
• Nach dem Ausführen eines aufgerufenen Workflows, der benutzerdefinierte Protokollfelder hinzufügt, werden die Protokollfelder in der Konfiguration des übergeordneten Workflows wiederhergestellt.

Wichtig:

• Die Übergabe von IN-Argumenten an eine nicht isolierte Invoke Workflow File-Aktivität verhält sich so, als ob eine Referenz übergeben wird, was bedeutet, dass Änderungen am Objekt im aufgerufenen Workflow das Objekt im Hauptworkflow ändern.
• Variablen und Argumente werden für Workflow-Dateinamen in Windows- und plattformübergreifenden Projekten nicht unterstützt. Dadurch wird eine Fehlermeldung „Ausdrücke werden derzeit nicht unterstützt“ ausgelöst.
• Stellen Sie beim Aufrufen eines Workflows sicher, dass er keine Persistenzaktivitäten enthält. Diese dürfen nur im Hauptworkflow verwendet werden.

Der Workflow, auf den in der Eigenschaft NameDerWorkflowDatei verwiesen wird, kann im aktuellen Projekt mit der Schaltfläche Workflow öffnen im Textkörper der Aktivität geöffnet werden.

Hinweis: Für jede aufgerufene .xaml-Datei, deren Titel einen Punkt (.) enthält, wird der gesamte Text vor dem Punkt (inklusive Punkt) durch einen Unterstrich (_) ersetzt.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Windows, plattformübergreifende Konfiguration

• Name der Workflow-Datei – Der Dateipfad der .xaml-Datei aufzurufende Datei. Der Dateipfad ist relativ zum aktuellen Projektordner. Dieses Feld unterstützt nur Strings oder Stringvariablen. Stringvariablen werden in Windows- und plattformübergreifenden Projekten nicht unterstützt. Alle Zeichenfolgen müssen in Anführungsstriche gesetzt werden.

• Argumente – Standardoption. Öffnet das Argumente-Wörterbuch, in dem Sie die Argumente des aufgerufenen Workflows sehen können. Sie können auch eine Variable definieren, die ein Wörterbuch von Argumenten enthält, indem Sie rechts neben dem Feld die Option Ausdruck verwenden auswählen. Dadurch wird das Feld Argumente in eine Variable Argumente konvertiert .

• Argumente-Variable – Aktiviert durch die Option Ausdruck verwenden im Feld Argumente . Sie können eine vordefinierte Variable verwenden oder eine neue erstellen, indem Sie VB-Ausdrücke verwenden oder den Autopilot auffordern, eine für Sie zu generieren. Verwenden Sie diese Variable, um das Wörterbuch der Argumente für den aufgerufenen Workflow zu speichern. Wechseln Sie zurück zur Option Argumente , indem Sie rechts neben dem Feld Statische Namen verwenden auswählen.

Hinweis:

• Wenn der Wert der Argumente- Variable zur Laufzeit NULL ist, fällt die Aktivität auf die Argumente-Eigenschaft zurück.

• Das Wechseln zwischen den Variableneigenschaften Argumente und Argumente zeigt den vorherigen Wert an.

• Der Wert der Argumente-Variable geht beim Schließen des Ausdrucks-Editors verloren.

• Import Arguments – Wenn der aufgerufene Workflow Argumente hat, werden sie beim Auswählen dieser Schaltfläche automatisch ins Wörterbuch importiert. Um die importierten Argumente anzuzeigen, klicken Sie im Feld Argumente auf.

  Die Schaltfläche muss deaktiviert sein, wenn:

  • Sie haben eine Argument-Variable für die Argumentsammlung verwendet

  • Der Wert für die Eigenschaft Name der Workflow-Datei ist null oder eine Variable

• Workflow öffnen – Öffnet den aufgerufenen Workflow auf einer anderen Registerkarte desselben Projekts.

  Die Schaltfläche muss deaktiviert sein, wenn der Wert für die Eigenschaft Name der Workflow-Datei NULL oder eine Variable ist.

Zusätzliche Eigenschaften

Allgemein

• Timeout – Gibt an, wie lange auf die Ausführung des aufgerufenen Workflows gewartet wird, bevor ein Fehler ausgegeben und der Workflow abgebrochen wird. Dieses Feld unterstützt nur TimeSpan -Variablen. Standardmäßig ist dieses Feld leer.

• BeiFehlerFortsetzen – 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.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft ContinueOnError Trueist, wird bei der Ausführung des Projekts kein Fehler abgefangen.

Optionen

• Zielsitzung (exklusiv für Windows-Projekte) – Gibt die Sitzung an, in welcher der Workflow gestartet wird. Nur isolierte Workflows können in einer anderen Sitzung als der übergeordneten gestartet werden. Stellen Sie daher sicher, dass Sie die Eigenschaft Isoliert auf True festlegen. Sie können eine der folgenden Optionen wählen:

  • Aktuell – Öffnet den untergeordneten Prozess in derselben Sitzung wie den übergeordneten Prozess
  • 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.

• Isoliert – Wählen Sie Wahr aus, um den aufgerufenen Workflow in einem separaten Windows-Prozess auszuführen. Dies hilft bei der Isolation eines fehlerhaften Workflows vom Hauptworkflow. Standardmäßig false .

Protokoll (Log)

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

Windows – Legacy-Konfiguration

Designer-Panel

Sie finden die folgenden Eigenschaften im Textkörper der Aktivität:

• Name der Workflow-Datei – Der Dateipfad der .xaml-Datei aufzurufende Datei. Der Dateipfad ist relativ zum aktuellen Projektordner. Dieses Feld unterstützt nur Strings oder Stringvariablen. Stringvariablen werden unterstützt. Alle Zeichenfolgen müssen in Anführungsstriche gesetzt werden.

• Importieren von Argumenten – Öffnet den Bereich Argumente , der alle Argumente des Workflows enthält, auf den in der Eigenschaft Name der Workflow-Datei verwiesen wird.

  In diesem Bereich können Sie auswählen, welche Argumente Sie aus dem aufgerufenen Workflow importieren möchten, indem Sie die Richtungssteuerelemente oder die Schaltfläche Löschen verwenden, um die Argumente neu anzuordnen. Wenn Sie auf OK klicken, werden die Änderungen gespeichert.

  Hinweis:

  • Wenn Sie Argumente im Bereich erstellen, werden diese verworfen, da sie nicht mit den Daten im aufgerufenen Workflow übereinstimmen.
  • Bei Argumentnamen im Bereich wird zwischen Groß- und Kleinschreibung unterschieden.

  Nachdem der Bereich geschlossen wurde, zeigt ein Zähler neben der Schaltfläche an, wie viele Argumente für den Import ausgewählt wurden. Der Zähler hat die folgende Farbcodierung:
  • Orange – Wenn eine Abweichung zwischen den ausgewählten Argumenten und denen im aufgerufenen Workflow besteht.
  • Grau – Wenn die ausgewählten Argumente im aufgerufenen Workflow gefunden werden.

• Workflow öffnen – Ermöglicht das Öffnen des aufgerufenen Workflows auf einer anderen Registerkarte desselben Projekts.

Eigenschaften-Panel

Allgemein

• Bei Fehler fortfahren – 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.
  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 – Gibt an, wie lange die Aktivität ausgeführt werden muss, bevor ein Fehler ausgegeben wird. Dieses Feld unterstützt nur TimeSpan-Variablen. Standardmäßig ist dieses Feld leer.

Eingabe

• Argumente – Die Parameter, die beim Aufrufen an die Anwendung übergeben werden können.
• ArgumenteVariablen – Die Parameter, die mit einem Wörterbuch dynamisch an den Workflow übergeben werden können.
• Isolated – Wenn dieses Kontrollkästchen ausgewählt ist, wird der aufgerufene Workflow in einem separaten Windows-Prozess ausgeführt. Damit kann ein fehlerhafter Workflow vom Haupt-Workflow isoliert werden.

• Name der Workflow-Datei – Der Dateipfad der .xaml-Datei aufzurufende Datei. Der Dateipfad ist relativ zum aktuellen Projektordner. Dieses Feld unterstützt nur Strings oder Stringvariablen. Stringvariablen werden unterstützt. Alle Zeichenfolgen müssen in Anführungsstriche gesetzt werden.

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

Protokoll (Log)

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

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

• Zielsitzung (exklusiv für Windows-Projekte) – Gibt die Sitzung an, in welcher der Workflow gestartet wird. Nur isolierte Workflows können in einer anderen Sitzung als der übergeordneten gestartet werden. Stellen Sie daher sicher, dass Sie die Eigenschaft Isoliert auf True festlegen. Sie können eine der folgenden Optionen wählen:

  • Aktuell – Öffnet den untergeordneten Prozess in derselben Sitzung wie den übergeordneten Prozess
  • 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.