Workflow-Datei aufrufen (Invoke Workflow File)

Invoke Workflow File-Aktivität, die einen angegebenen Workflow synchron aufruft und optional eine Liste von Eingabeargumenten an ihn übergibt.

UiPath.Core.Activities.InvokeWorkflowFile

Beschreibung

Ruft synchron einen angegebenen Workflow auf. Optional kann eine Liste an Eingabeargumenten übergeben 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.
• Stellen Sie beim Aufrufen eines Workflows sicher, dass er keine Persistenzaktivitäten enthält. Diese dürfen nur im Hauptworkflow verwendet werden.
• Das Aufrufen von Trigger-Workflows, d. h. Workflows, die mit einer Triggeraktivität beginnen, kann zu einem unerwarteten automatischen Import von Argumenten führen.

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 Datei .xaml, 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, die aufgerufen werden soll. Der Dateipfad ist relativ zum aktuellen Projektordner. Dieses Feld unterstützt nur Strings oder Stringvariablen. Alle Zeichenfolgen müssen in Anführungsstriche gesetzt werden. Um den Workflow auf einer anderen Registerkarte desselben Projekts zu öffnen, wählen Sie Workflow öffnen auf der rechten Seite des Felds aus.
• Argumente – Standardoption. Öffnet das Argumentwörterbuch, in dem Sie die Argumente des aufgerufenen Workflows sehen können. Sie können auch eine Variable zum Speichern eines Verzeichnisses von Argumenten definieren, indem Sie rechts neben dem Feld Einen Ausdruck verwenden auswählen. Dadurch wird das Feld Argumente in eine Argumentvariable konvertiert. Um die aktuelle Liste der Workflow-Argumente abzurufen, wählen Sie Argumente aktualisieren rechts neben dem Feld aus.
  Wichtig:

  Ein Eingabeargument, das im Argumentwörterbuch leer bleibt, wird je nach Datentyp unterschiedlich übergeben:

  • Referenztypen (z. B. String, DataTable oder eine beliebige Klasse) werden als null übergeben, sodass der aufgerufene Workflow den für dieses Argument deklarierten Standardwert verwendet.
  • Werttypen (z. B. Boolean, Int32, DateTime) können nicht null sein, daher wird ein leerer Wert als Standardtyp übergeben (False, 0, 01/01/0001 00:00:00 usw.). ) anstelle des Standardwerts, der im aufgerufenen Workflow deklariert ist.
  Tipp:

  Um sicherzustellen, dass ein Werttypargument auf den Standardwert des aufgerufenen Workflows zurückgesetzt wird, wenn es leer bleibt, kann es als NULL-Typ (z. B. Nullable(Of Boolean)) im aufgerufenen Workflow deklariert werden.

• Argumentvariable – Aktiviert durch die Option Ausdruck verwenden im Feld Argumente. Sie können eine vordefinierte Variable verwenden oder eine neue erstellen, indem Sie entweder VB-Ausdrücke verwenden oder den Autopiloten zur Generierung einer neuen Variable auffordern. Verwenden Sie diese Variable, um das Verzeichnis der Argumente für den aufgerufenen Workflow zu speichern. Wechseln Sie zurück zur Option Argumente, indem Sie Statische Namen verwenden rechts neben dem Feld auswählen. Um die Liste der Argumente zu öffnen und ihre Attribute zu bearbeiten, wählen Sie das Feld Argumente aus.
  Hinweis:

  • Wenn der Wert der Argumentvariable zur Laufzeit NULL ist, greift die Aktivität auf die Argumente-Eigenschaft zurück.
  • Das Wechseln zwischen den Eigenschaften Argumente und Argumentvariablen zeigt den vorherigen Wert an.
  • Der Wert der Argumentvariablen geht beim Schließen des Ausdrucks-Editors verloren.

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 beendet wird. Dieses Feld unterstützt nur TimeSpan -Variablen. Standardmäßig ist dieses Feld leer.
• 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 Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft Bei Fehler fortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler beim Ausführen des Projekts abgefangen.

Optionen

• Zielsitzung (ausschließlich 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 True 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 .
• Erhöht (unterstützt für Windows- und Windows-Legacy-Projekte) – Wählen Sie True aus, um den isolierten untergeordneten Prozess bei MediumPlus-Integrität auszuführen, ohne den übergeordneten Prozess zu erhöhen. Wird nur wirksam, wenn „Isolated“ auf „True“ festgelegt ist und erfordert, dass der Roboter die Umgebungsvariable UIPATH_MEDIUMPLUS_INVOKE aktiviert; Andernfalls wird die Einstellung ignoriert. 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 Protokolleintrag und Protokollbeendigung generiert werden.
  Wichtig:

  Um Standardwerte für Protokolleintrag und Protokollbeendigung festzulegen, wechseln Sie zu UiPath Studio > Projekteinstellungen > System > Workflowdatei aufrufen. Hier angegebene Werte gelten für Ihr gesamtes Projekt.

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 aufzurufen ist. 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 Workflow-Dateiname 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

• Continue On Error - Specifies if 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 blank 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.
  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.
• Auszeit (Timeout) - Gibt die Wartezeit bis zur Fehlerausgabe der Aktivität an. Das Feld unterstützt nur VariablenTimeSpan. 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.
• Erhöht – Wenn dieses Kontrollkästchen ausgewählt ist, wird der isolierte untergeordnete Prozess mit MediumPlus-Integrität ausgeführt, ohne den übergeordneten Prozess zu erhöhen. Wird nur wirksam, wenn „Isoliert“ ausgewählt ist, und erfordert, dass der Roboter die Umgebungsvariable UIPATH_MEDIUMPLUS_INVOKE aktiviert; Andernfalls wird die Einstellung ignoriert.
• Name der Workflow-Datei – Der Dateipfad der .xaml-Datei aufzurufen ist. 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 2021.10 und älteren Robotern werden Betriebsausnahmen nicht in einem isolierten Workflow 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 Protokolleintrag und Protokollbeendigung generiert werden.

Wichtig:

Um Standardwerte für Protokolleintrag und Protokollbeendigung festzulegen, wechseln Sie zu UiPath Studio > Projekteinstellungen > System > Workflowdatei aufrufen. Hier angegebene Werte gelten für Ihr gesamtes Projekt.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.
• Zielsitzung (ausschließlich 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.

Argumentnachrichten

Die Aktivität meldet den Status ihres Argumentwörterbuchs im Infofeld. Keine dieser Nachrichten entfernt ein von Ihnen konfiguriertes Argument: Argumente aktualisieren importiert entweder die Argumente, die der aufgerufene Workflow deklariert hat, oder lässt das Wörterbuch so, wie es ist, und gibt an, warum.

Der einzige Fall, in dem noch ein unvollständiger Satz geschrieben werden kann, ist das Verhalten bei Studio 25.10 oder älter, das im Hinweis am Ende dieses Abschnitts beschrieben wird.

• „Die Argumente konnten nicht aus dem aufgerufenen Ziel gelesen werden, sodass sie unverändert blieben.“ – Wird angezeigt, wenn Sie Argumente aktualisieren auswählen und die Workflow-Datei fehlt, ihr Pfad außerhalb des Projekts aufgelöst wird, ihrer.xaml-Datei können nicht geparst werden, oder der Lesevorgang schlägt aus einem anderen Grund fehl. Während Sie die Aktivität bearbeiten, meldet dieser Fall nichts.
• „Das aufgerufene Ziel deklariert Argumente, die nicht importiert werden können (z. B. ein fehlender Name oder Typ oder ein doppelter Name), sodass die Argumente unverändert gelassen wurden. Korrigieren Sie die Argumente des Ziels, und aktualisieren Sie sie erneut.“ – Wird angezeigt, wenn Sie Argumente aktualisieren auswählen. Der Import wird insgesamt abgelehnt, anstatt nur die Argumente zu schreiben, die erstellt werden konnten.
• „Die Argumente konnten im Workflow nicht aktualisiert werden, sodass sie unverändert blieben. Weitere Informationen finden Sie in den Protokollen.“ – Wird angezeigt, wenn Sie Argumente aktualisieren auswählen, wenn der aufgerufene Workflow gelesen wurde, das Wörterbuch aber nicht zurückgeschrieben werden konnte. Es geht nichts verloren.
• „Das aufgerufene Ziel deklariert keine Argumente. Aus Sicherheitsgründen wird Folgendes nicht automatisch entfernt:„ gefolgt von den Argumentnamen. – Wird sowohl beim Aktualisieren als auch während der Bearbeitung angezeigt. Die aufgeführten Argumente werden absichtlich beibehalten und Sie können sie manuell entfernen, wenn der aufgerufene Workflow sie nicht mehr verwendet.
• "Die folgenden Argumente fehlen oder sind falsch konfiguriert:" gefolgt von den Argumentnamen. – Wird während der Bearbeitung angezeigt, wenn der aufgerufene Workflow Argumente deklariert, die die Aktivität nicht hat oder die sie mit einem anderen Typ oder einer anderen Richtung hat. Die Auswahl von Argumenten aktualisieren löst dieses Problem.
• "Die folgenden Argumente sind zusätzlich:" gefolgt von den Argumentnamen. – Wird während der Bearbeitung angezeigt, wenn alles, was der aufgerufene Workflow deklariert, bereits konfiguriert ist und die Aktivität weitere Argumente darauf enthält.
• "Die folgenden Argumente fehlen oder sind falsch konfiguriert:" gefolgt von den Argumentnamen, dann "N Argument(e) sind zusätzlich". – Wird während der Bearbeitung angezeigt, wenn die vorherigen beiden Fälle gleichzeitig gelten, was erzeugt, wenn die Aktivität auf einen anderen Workflow verweist. Die fehlenden Argumente werden benannt, die zusätzlichen Argumente werden nur gezählt.

Die Nachrichten, die Argumentnamen auflisten, enthalten höchstens drei, dann fügen Sie „und N weitere(s)“ an.

Hinweis:

Bei Studio 25.10 oder älter ein Workflow, dessen.xaml- kann nicht geparst werden wird nicht immer als Lesefehler gemeldet: Studio verwirft nur die Deklarationen, deren Typen es nicht auflösen konnte, und gibt den Rest zurück.

Wenn jede Deklaration betroffen war, ist der Lesevorgang leer, die Meldung besagt, dass der Workflow keine Argumente deklariert und die konfigurierten Argumente beibehalten werden. Wenn nur einige betroffen waren, sieht der Lesevorgang vollständig aus, Argumente aktualisieren importiert den verkürzten Satz und die betroffenen Argumente werden nicht beibehalten.