App-Aufgaben abrufen

UiPath.Persistence.Activities.UserAction.GetAppTasks

Beschreibung

Ruft eine einzelne App-Aufgabe oder einen Satz von App-Aufgaben ab, die nach bestimmten Kriterien gefiltert sind, nämlich den DTO-Eigenschaften der Aufgabe:

• Status
• Titel
• ID
• Priorität
• Name des Aufgabenkatalogs
• AssignedToUser
• CreatorUser
• LastModifierUser
• Erstellungszeit
• LastModificationTime
• OrganizationUnitID

Das Ausgabeobjekt der Aktivität Get App Tasks kann in jeder anderen Persistenzaktivität verwendet werden, z. B. Wait For App Task And Resume, um die Szenarien abzudecken, in denen ein anderer Workflow als der Workflow, der diese Aufgaben erstellt hat, auf die Aufgaben wartet ( Zum Beispiel das Erstellen eines Wiederherstellungsworkflows für den Fall, dass der aktuelle Auftrag fehlschlägt). Sie können das Ausgabeobjekt auch als Eingabe an einen anderen Prozess übergeben, sodass Sie nicht auf den Abschluss aller Aufgaben warten müssen, bis der ursprüngliche Prozess fortgesetzt wird.

Hinweis: * Beim Filtern und Abfragen der Aktionen wird die OData -Syntax basierend auf den Metadaten der Aktion verwendet.

Projektkompatibilität

Windows | Plattformübergreifend

Windows-Konfiguration

Designer-Panel

• Aufgabenobjekte (Ausgabe) – Die Liste der Ausgabeobjekte, die den in der Aktivität festgelegten Kriterien entsprechen. Die Ausgabe wird vom Orchestrator als List<FormTaskData> -Objekt zurückgegeben. Verwenden Sie dieses Objekt, um einen Wiederherstellungsworkflow zu erstellen oder ihn als Eingabe an einen anderen Prozess zu übergeben.

Eigenschaften-Panel

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• Orchestrator-Ordnerpfad – Der Pfad zum Orchestrator-Ordner, den Sie mit dieser Aktivität verwenden möchten. Wenn dies leer gelassen wird, wird der aktuelle Orchestrator-Ordner verwendet. Dieses Feld unterstützt nur Strings und String-Variablen.
• Referenz ( Reference ) - Die Referenz der Aktion, die mit der Aktivität App-Aufgabe erstellen ( Create App Task ) festgelegt wurde.
• Aufgabenkatalogname – Der Katalogname der Aktion, der mit der Aktivität Create App Task festgelegt wurde.

Sonstiges

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.

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.

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

• AuszeitMS (TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).

OData-Abfrageoptionen

OData-Abfrageoption	Beschreibung	Felddatentyp	Beispiel
Erweitern	Die Option OData expand , die verwendet wird, um die zugehörigen Entitäten eines Kriteriums anzuzeigen.	String	"AssignedUser"
Filter	Die Option OData filter , die zum Filtern der abgerufenen Aktionen nach den angegebenen Kriterien verwendet wird.	String	Status in ('Pending', 'Unassigned') and Priority eq 'High'
Sortieren nach	Die OData-Option orderby , die verwendet wird, um die abgerufenen Aktionen aufsteigend (asc) oder absteigend (desc) nach einem angegebenen Kriterium zu ordnen.	String	"Title asc" "ID desc"
Auswählen	Die OData-Option select , die zum Abrufen einer Teilmenge der Eigenschaften der Aktion verwendet wird.	String	"ID, Status, TaskCatalogName"
Überspringen	Die OData-Option skip , die verwendet wird, um eine Reihe von Aktionen beim Abrufen zu überspringen.	Int32	2
Oben	Die Option OData top , mit der die Anzahl der abzurufenden Datensätze festgelegt wird, ist auf 1000 Datensätze gleichzeitig begrenzt. Wenn leer gelassen, werden die 100 wichtigsten Datensätze abgerufen.	Int32	20

Hinweis: AND/OR -Operatoren werden ebenfalls unterstützt.

Ausgabe

• Aufgabenobjekte (Ausgabe) – Die Liste der Ausgabeobjekte, die den in der Aktivität festgelegten Kriterien entsprechen. Die Ausgabe wird vom Orchestrator als List<FormTaskData> -Objekt zurückgegeben. Verwenden Sie dieses Objekt, um einen Wiederherstellungsworkflow zu erstellen oder ihn als Eingabe an einen anderen Prozess zu übergeben.

Plattformübergreifende Konfiguration

• Filter – Die Option OData filter , mit der die abgerufenen Aktionen nach den angegebenen Kriterien gefiltert werden. Dieses Feld unterstützt nur Strings und String-Variablen. Beispiel: Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Auswählen – Die OData-Option select , die verwendet wird, um eine Teilmenge der Eigenschaften der Actionsabzurufen. Sie müssen die ID-Option eingeben. Wenn Sie die Actions möchten, wäre die Abfrage daher "Id, TaskCatalogName". Dieses Feld unterstützt nur Strings und String-Variablen.
• Orchestrator-Ordnerpfad – Der Pfad zum Orchestrator-Ordner, den Sie mit dieser Aktivität verwenden möchten. Wenn dies leer gelassen wird, wird der aktuelle Orchestrator-Ordner verwendet. Dieses Feld unterstützt nur Strings und String-Variablen.
• Aufgabenkatalogname – Der Katalogname der Aktion, der mit der Aktivität Create App Task festgelegt wurde.
• Referenz – Die Aktionsreferenz, die mit der Aktivität Create App Task festgelegt wurde.
• Aufgabenobjekte (Ausgabe) – Die Liste der Ausgabeobjekte, die den in der Aktivität festgelegten Kriterien entsprechen. Die Ausgabe wird vom Orchestrator als List<FormTaskData> -Objekt zurückgegeben. Verwenden Sie dieses Objekt, um einen Wiederherstellungsworkflow zu erstellen oder ihn als Eingabe an einen anderen Prozess zu übergeben.

Erweiterte Optionen

Sonstiges

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.

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.

• AuszeitMS (TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).

OData-Abfrageoptionen

OData-Abfrageoption	Beschreibung	Felddatentyp	Beispiel
Erweitern	Die Option OData expand , die verwendet wird, um die zugehörigen Entitäten eines Kriteriums anzuzeigen.	String	"AssignedUser"
Sortieren nach	Die OData-Option orderby , die verwendet wird, um die abgerufenen Aktionen aufsteigend (asc) oder absteigend (desc) nach einem angegebenen Kriterium zu ordnen.	String	"Title asc" "ID desc"
Überspringen	Die OData-Option skip , die verwendet wird, um eine Reihe von Aktionen beim Abrufen zu überspringen.	Int32	2
Oben	Die Option OData top , mit der die Anzahl der abzurufenden Datensätze festgelegt wird, ist auf 1000 Datensätze gleichzeitig begrenzt. Wenn leer gelassen, werden die 100 wichtigsten Datensätze abgerufen.	Int32	20

Beispiele für OData-Abfragen

Nutzen Sie die folgenden Beispiele zum Abrufen von App-Aufgaben oder zur Inspiration für andere Abfragen:

1. Rufen Sie die IDs von „Get App-Aufgaben mit hoher Priorität“ ab, die ausstehend sind, geordnet nach ihrem Titel in absteigender Reihenfolge.
   1. Filtern: "((Priority eq 'High') and (Status eq 'Pending'))"
   2. Sortieren nach: "Title desc"
   3. Auswählen: "Id"
2. Rufen Sie den Aktionskatalog ab, in dem alle Get App-Aufgaben gespeichert sind, die nicht zugewiesen sind und die Priorität Mittel haben, und ordnen Sie sie nach ihrem Titel in aufsteigender Reihenfolge an.
   1. Filtern: "((Priority eq 'Medium') and (Status eq 'Unassigned'))"
   2. Sortieren nach: "Title asc"
   3. Auswählen: "Id, TaskCatalogName"