Obtenir des tâches d’application

UiPath.Persistence.Activities.UserAction.GetAppTasks

Description

Récupère une tâche d'application unique ou un ensemble de tâches d'application, filtrées par des critères spécifiques, à savoir les propriétés DTO de la tâche :

• É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 d'application (Get App Tasks) peut être utilisé dans n'importe quelle autre activité de persistance, par exemple Attendre la tâche d'application et reprendre ( Wait For App Task And Resume), pour couvrir les scénarios qui nécessitent un autre workflow pour attendre les tâches, différent du workflow qui a créé ces tâches ( par exemple, la création d'un workflow de récupération en cas d'échec de la tâche actuelle). Vous pouvez également transmettre l'objet de sortie à un autre processus en tant qu'entrée, de sorte que vous n'avez pas besoin d'attendre que toutes les tâches 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 | Multiplate-forme

Configuration de Windows

Module Designer

• 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

• NomAffichage (DisplayName) - Nom affiché de l'activité.

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 qui a été définie à l'aide de l'activité Créer une tâche d' application (Create App Task) .
• Nom du catalogue de tâches (Task Catalog Name ) : le nom du catalogue d'actions défini à l'aide de l'activité Créer une tâche d' application (Create App Task) .

Divers

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

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

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

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érateurs ET ( AND )/OU (OR) sont é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

• 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.
• 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.
• Nom du catalogue de tâches (Task Catalog Name ) : le nom du catalogue d'actions défini à l'aide de l'activité Créer une tâche d' application (Create App Task) .
• Référence : la référence d'action définie à l'aide de l'activité Créer une tâche d'application .
• 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

Divers

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

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 l'application (Get App Tasks) ou vous inspirer pour d'autres requêtes :

1. Obtenez les ID des tâches d'application de haute priorité qui sont en attente, triées par 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 d'application 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"