Get Form Tasks

UiPath.Persistence.Activities.FormTask.GetFormTasks

Beschreibung

Hilft Ihnen, eine einzelne Aktion oder einen Satz von Aktionen abzufragen, die nach bestimmten Kriterien gefiltert sind, nämlich den DTO-Eigenschaften der Aktion:

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

The output object of the Get Form Tasks activity can be used in any other persistence activity, for example Wait For Form Task And Resume, to cover the scenarios that require another workflow to wait on the Actions, different than the workflow that created those Actions (for example, building a recovery workflow in case the current job fails). You can also pass the output object to a different process as input, so that you don't need to wait for all the Actions to be completed until the initial process resumes.

Hinweis:

• Das Filtern und Abfragen der Aktionen verwendet die OData- Syntax basierend auf den Metadaten der Aktion.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Windows, Windows – Legacy-Konfiguration

Designer-Panel

• Task Catalog Name - The action's catalog name that was set using the Create Form Task activity.
• Reference - The Action reference that was set using the Create Form Task activity.
• Filter - The OData filter option, used to filter the retrieved actions by the specified criteria. This field supports only strings and String variables. For example, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Auswählen – Die OData-Option select , mit der eine Teilmenge der Eigenschaften der Aktion abgerufen wird. Sie müssen die ID-Option eingeben. Wenn Sie daher die Aktionskataloge abrufen möchten, sollten Sie die Abfrage "Id, TaskCatalogName" verwenden. Dieses Feld unterstützt nur Strings und String-Variablen.
• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

Eigenschaften-Panel

Allgemein

• 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 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.
• AuszeitMS (TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).

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.
• Reference - The Action's reference that was set using the Create Form Task activity.
• Task Catalog Name - The action's catalog name that was set using the Create Form Task activity.

Sonstiges

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

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

• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

Plattformübergreifende Konfiguration

• Task Catalog Name - The action's catalog name that was set using the Create Form Task activity.
• Reference - The Action reference that was set using the Create Form Task activity.
• Filter - The OData filter option, used to filter the retrieved actions by the specified criteria. This field supports only strings and String variables. For example, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Auswählen – Die OData-Option select , mit der eine Teilmenge der Eigenschaften der Aktion abgerufen wird. Sie müssen die ID-Option eingeben. Wenn Sie daher die Aktionskataloge abrufen möchten, sollten Sie die Abfrage "Id, TaskCatalogName" verwenden. Dieses Feld unterstützt nur Strings und String-Variablen.
• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

Erweiterte Optionen

Allgemein

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

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

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.

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

Verwenden Sie die folgenden Beispiele, um Formularaufgaben zu erhalten, oder um sich für andere Abfragen inspirieren zu lassen:

1. Rufen Sie die IDs der ausstehenden Formularaufgaben mit hoher Priorität ab, geordnet nach ihrem Titel in absteigender Reihenfolge.
   1. Filter: "((Priority eq 'High') and (Status eq 'Pending'))"
   2. Sortieren nach: "Title desc"
   3. Auswählen: "Id"
2. Rufen Sie den Actions ab, in dem alle Formularaufgaben mit nicht zugewiesener Priorität und mittlerer Priorität gespeichert sind, und sortieren Sie sie nach ihrem Titel in aufsteigender Reihenfolge.
   1. Filter: "((Priority eq 'Medium') and (Status eq 'Unassigned'))"
   2. Sortieren nach: "Title asc"
   3. Auswählen: "Id, TaskCatalogName"