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

Plattformübergreifende Konfiguration

• NameDerWorkflowDatei – Der Dateipfad der .xaml-Datei, die aufgerufen werden soll. 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 Strings müssen in Anführungszeichen gesetzt werden.
• Workflow öffnen – Öffnet den aufgerufenen Workflow auf einer anderen Registerkarte desselben Projekts.

Erweiterte Optionen

Optionen

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

Protokoll (Log)

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

Windows – Legacy, Windows-Konfiguration

Designer-Panel

Die folgenden Optionen finden Sie im Textkörper der Aktivität.

Importieren von Argumenten

Wenn Sie auf die Schaltfläche Argumente importieren im Textkörper der Aktivität klicken, wird der Bereich Argumente geöffnet, der alle Argumente des Workflows enthält, auf den in der Eigenschaft Workflow-Dateipfad 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

Mit der Schaltfläche Workflow öffnen im Textkörper der Aktivität können Sie den aufgerufenen Workflow auf einer anderen Registerkarte desselben Projekts öffnen.

Eigenschaften-Panel

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.
• 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.
• 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.

• NameDerWorkflowDatei – Der Dateipfad der .xaml-Datei, die aufgerufen werden soll. 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 Strings müssen in Anführungszeichen gesetzt werden.

  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.

Protokoll (Log)

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

Sonstiges

• 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 Workflow gestartet wird. Nur isolierte Workflows können in einer anderen Sitzung als der übergeordneten gestartet werden. 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.

    Hinweis: Wenn Isolated für die „Invoke Workflow“-Aktivität konfiguriert wird, muss der Parameter Target Session aktiviert werden.