Get Form Tasks

UiPath.Persistence.Activities.FormTask.GetFormTasks

Description

Vous aide à interroger une seule action ou un ensemble d'actions filtrées selon des critères spécifiques, à savoir les propriétés DTO de l'action :

• État (Status)
• Titre
• ID
• Priorité (Priority)
• Nom du catalogue de tâches
• AssignedToUser
• CreatorUser
• LastModifierUser
• Heure de création
• LastModificationTime
• OrganizationUnitID

L'objet de sortie de l'activité Obtenir les tâches de formulaire (Get Form Tasks) peut être utilisé dans toute autre activité de persistance, par exemple Attendre une tâche de formulaire et reprendre ( Wait For Form Task And Resume) pour couvrir les scénarios qui nécessitent qu'un autre workflow soit en attente sur les actions, différent du workflow qui a créé ces actions ( par exemple, la création d'un workflow de récupération en cas d'échec de la tâche en cours). Vous pouvez également transmettre l'objet de sortie à un processus différent en tant qu'entrée, afin de ne pas avoir besoin d'attendre que toutes les Actions soient terminées jusqu'à ce que le processus initial reprenne.

Remarque : * Le filtrage et l'interrogation des actions utilisent la syntaxe OData , basée sur les métadonnées de l'action.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, Windows - Configuration héritée

Module Designer

• Nom du catalogue de tâches : le nom du catalogue d' Actionsdéfini à l'aide de l'activité Créer une tâche de formulaire (Create Form Task) .
• Référence : la référence des Actions définie à l'aide de l'activité Créer une tâche de formulaire (Create Form Task) .
• Filtre (Filter) : l'option OData filter , utilisée pour filtrer les actions récupérées en fonction des critères spécifiés. Ce champ ne prend en charge que les chaînes et les variables String. Par exemple, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Sélectionner : l'option OData select , utilisée pour récupérer un sous-ensemble des propriétés de l' Actions. Vous devez saisir l’option ID. Par conséquent, si vous souhaitez récupérer les catalogues d' Actions , la requête à utiliser est "Id, TaskCatalogName". Ce champ ne prend en charge que les chaînes et les variables String.
• Objets de tâche (sortie) : la liste des objets de sortie qui correspondent aux critères définis dans l'activité. La sortie est renvoyée par Orchestrator en tant qu'objet List<FormTaskData> . Utilisez cet objet pour créer un workflow de récupération ou pour le transmettre en tant qu'entrée à un processus différent.

Panneau propriétés

Commun

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.

• NomAffichage (DisplayName) - Nom affiché de l'activité.
• TimeoutMS - Spécifie la durée (en millisecondes) d'attente d'exécution de l'activité avant la génération d'un message d'erreur. La valeur par défaut est 30 000 millisecondes (30 secondes).

Entrée

• Chemin d'accès au dossier Orchestrator : le chemin d'accès au dossier Orchestrator que vous souhaitez utiliser avec cette activité. Si ce champ est laissé vide, le dossier Orchestrator actuel est utilisé. Ce champ ne prend en charge que les chaînes et les variables String.
• Référence (Reference) - Référence de l'action définie à l'aide de l'activité Créer une tâche de formulaire (Create Form Task) .
• Nom du catalogue de tâches : le nom du catalogue d' Actionsdéfini à l'aide de l'activité Créer une tâche de formulaire (Create Form Task) .

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options de requête OData

Option de requête OData	Description	Type de données de champ	Exemple
Développer	L'option ODonnées expand , utilisée pour afficher les entités associées d'un critère.	Chaîne de caractères (string)	"AssignedUser"
Filtrer (Filter)	L'option OData filter , utilisée pour filtrer les actions récupérées en fonction des critères spécifiés.	Chaîne de caractères (string)	Status in ('Pending', 'Unassigned') and Priority eq 'High'
Trier par	L'option OData orderby , utilisée pour trier les actions récupérées par ordre croissant (asc) ou décroissant (desc) selon un critère spécifié.	Chaîne de caractères (string)	"Title asc" "ID desc"
Sélectionner	L'option OData select , utilisée pour récupérer un sous-ensemble des propriétés de l'action.	Chaîne de caractères (string)	"ID, Status, TaskCatalogName"
Ignorer	L'option OData skip , utilisée pour ignorer un certain nombre d'actions de la récupération.	Int32	2
Haut	L'option ODonnées top , utilisée pour définir le nombre d'enregistrements à récupérer, limitée à 1 000 enregistrements à la fois. Si ce champ est laissé vide, les 100 premiers enregistrements sont récupérés.	Int32	20

Remarque : Les opérateursET/OUsont également pris en charge.

Sortie

• Objets de tâche (sortie) : la liste des objets de sortie qui correspondent aux critères définis dans l'activité. La sortie est renvoyée par Orchestrator en tant qu'objet List<FormTaskData> . Utilisez cet objet pour créer un workflow de récupération ou pour le transmettre en tant qu'entrée à un processus différent.

Configuration multiplateforme

• Nom du catalogue de tâches : le nom du catalogue d' Actionsdéfini à l'aide de l'activité Créer une tâche de formulaire (Create Form Task) .
• Référence : la référence des Actions définie à l'aide de l'activité Créer une tâche de formulaire (Create Form Task) .
• Filtre (Filter) : l'option OData filter , utilisée pour filtrer les actions récupérées en fonction des critères spécifiés. Ce champ ne prend en charge que les chaînes et les variables String. Par exemple, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• Sélectionner : l'option OData select , utilisée pour récupérer un sous-ensemble des propriétés de l' Actions. Vous devez saisir l’option ID. Par conséquent, si vous souhaitez récupérer les catalogues d' Actions , la requête à utiliser est "Id, TaskCatalogName". Ce champ ne prend en charge que les chaînes et les variables String.
• Objets de tâche (sortie) : la liste des objets de sortie qui correspondent aux critères définis dans l'activité. La sortie est renvoyée par Orchestrator en tant qu'objet List<FormTaskData> . Utilisez cet objet pour créer un workflow de récupération ou pour le transmettre en tant qu'entrée à un processus différent.

Options avancées

Commun

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.

• TimeoutMS - Spécifie la durée (en millisecondes) d'attente d'exécution de l'activité avant la génération d'un message d'erreur. La valeur par défaut est 30 000 millisecondes (30 secondes).

Entrée

• Chemin d'accès au dossier Orchestrator : le chemin d'accès au dossier Orchestrator que vous souhaitez utiliser avec cette activité. Si ce champ est laissé vide, le dossier Orchestrator actuel est utilisé. Ce champ ne prend en charge que les chaînes et les variables String.

Options de requête OData

Option de requête OData	Description	Type de données de champ	Exemple
Développer	L'option ODonnées expand , utilisée pour afficher les entités associées d'un critère.	Chaîne de caractères (string)	"AssignedUser"
Trier par	L'option OData orderby , utilisée pour trier les actions récupérées par ordre croissant (asc) ou décroissant (desc) selon un critère spécifié.	Chaîne de caractères (string)	"Title asc" "ID desc"
Ignorer	L'option OData skip , utilisée pour ignorer un certain nombre d'actions de la récupération.	Int32	2
Haut	L'option ODonnées top , utilisée pour définir le nombre d'enregistrements à récupérer, limitée à 1 000 enregistrements à la fois. Si ce champ est laissé vide, les 100 premiers enregistrements sont récupérés.	Int32	20

Exemples de requêtes OData

Utilisez les exemples suivants pour obtenir les tâches de formulaire ou comme source d'inspiration pour d'autres requêtes :

1. Obtenez les ID des tâches de formulaire de haute priorité qui sont en attente, triés par leur titre dans l'ordre décroissant.
   1. Filtre: "((Priority eq 'High') and (Status eq 'Pending'))"
   2. Trier par: "Title desc"
   3. Sélectionner: "Id"
2. Obtenez le catalogue d' Actions où toutes les tâches de formulaire non affectées et de priorité moyenne sont stockées, et triez-les par titre dans l'ordre croissant.
   1. Filtre: "((Priority eq 'Medium') and (Status eq 'Unassigned'))"
   2. Trier par: "Title asc"
   3. Sélectionner: "Id, TaskCatalogName"