Ajouter un élément de file d'attente (Add Queue Item)

UiPath.Core.Activities.AddQueueItem

Description

Ajoute un nouvel élément dans une file d'attente Orchestrator. Le statut de l'élément sera « Nouveau ». Un exemple d'utilisation de cette activité est disponible ici.

Remarque :

• Pour que l'activité UiPath.Core.Activities.AddQueueItem fonctionne dans un processus, le Robot doit être connecté à Orchestrator. Cela est nécessaire pour envoyer et récupérer des informations sur les files d'attente, sur les éléments et sur les statuts.
• Les valeurs de définition de schéma ajoutées aux files d'attente dans Orchestrator et marquées comme obligatoires sont automatiquement importées dans le générateur de dictionnaires de l'activité.
• Les valeurs marquées comme non obligatoires peuvent être ajoutées aux éléments de la file d'attente et ne pas être appliquées.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, configuration multiplate-forme

• Chemin du dossier Orchestrator : le chemin du dossier où se trouve la file d'attente spécifiée, s'il est différent du dossier dans lequel le processus est en cours d'exécution. Ce champ prend uniquement en charge les valeurs de chaîne, avec / comme séparateur permettant d'indiquer les sous-dossiers. Par exemple : "Finance/Accounts Payable".

  Remarque :

  Le paramètre Orchestrator folder path ne fonctionne pas pour les processus exécutés par des robots dans des dossiers classiques. Seuls les robots des dossiers modernes ont la capacité de transmettre des données à l'extérieur de leur dossier. Les chemins d’accès relatifs aux dossiers sont pris en charge dans un en-tête X-UIPATH-FolderPath-Encoded comme suit :

  Chemin d'accès commençant par / : commence à partir du dossier root de l'arborescence dont il fait partie.

  Chemin d'accès commençant par . : commence à partir du dossier.

  Chemin commençant par .. : commence un niveau au-dessus dans la hiérarchie du dossier pour chaque .. dans le chemin d'accès (par exemple ../ pour un niveau au-dessus, ../../ pour deux niveaux au-dessus dans la hiérarchie).

  Les barres obliques finales ne sont pas acceptées.

• Queue Name - The queue where the QueueItem object is to be added. The name is case insensitive, meaning that if in Orchestrator it was defined as "MyFirstQueue", it matches "myfirstqueue". The maximum number of characters is 50.

  • Si vous cliquez sur le bouton Gérer les files d'attente à côté de Nom de la file d'attente, vous êtes redirigé vers la section Files d'attente dans l'Orchestrator à laquelle Studio est connecté.

• InformationsÉlément (Item Information) : collection d’informations supplémentaires sur l’objet QueueItem spécifique devant être ajouté. Les informations sont stockées dans l’élément et sont utilisées lors du traitement d’une transaction. Pour récupérer le dernier schéma de file d’attente, sélectionnez Actualiser les arguments (Refresh arguments) à droite du champ. Pour ouvrir la liste d’éléments et modifier leurs attributs, cochez la case Informations sur l’élément (Item Information).

  Important :

  Il est recommandé d'utiliser uniquement des valeurs primitives des types suivants : Nombre, Booléen, String et DateHeure.

  Les valeurs des arguments String ne peuvent pas contenir les caractères suivants : [ et " ".

  Les noms d'arguments ne peuvent pas contenir les caractères suivants : :, ., ,, @, ".

  Les arguments qui ne sont pas définis comme requis dans le schéma ne sont pas téléchargés dans la collection.

¹Pour les projets multiplate-forme créés dans Studio Web dans le cadre d'une solution, le champ Chemin du dossier Orchestrator n'est pas disponible.

²Pour les projets multiplate-forme créés dans Studio Web dans le cadre d'une solution, le champ Nom propose des options pour Définir de nouvelles ressources Orchestrator, telles que des files d'attente, des ressources ou des compartiments de stockage, au moment de la conception, ou pour Ouvrir Orchestrator pour la gestion des ressources.

Options avancées

Entrée

• Échéance : la date avant laquelle l'élément de file d'attente doit être traité. Cette propriété constitue un critère de définition de priorités à affecter aux éléments de file d'attente, tout comme Priorité et Différer. Cette propriété peut être renseignée avec des dates relatives telles que DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) et DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Par ailleurs, vous pouvez utiliser la notation américaine pour ajouter une heure exacte, telle que 12/10/2017 07:40:00. La correction automatique de cette date est disponible. Par exemple, si vous écrivez 8 9 2018 9:0, elle devient automatiquement 08/09/2018 09:00:00.
• Item Collection - Enables importing an entire dictionary of information for a queue item. This field only accepts Dictionary<string, object> variables.
• Différer : la date après laquelle l'élément de file d'attente peut être traité. Cette propriété constitue un critère de définition de priorités à affecter aux éléments de file d'attente, tout comme Priorité et Échéance. Cette propriété peut être renseignée avec des dates relatives telles que DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) et DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Par ailleurs, vous pouvez utiliser la notation américaine pour ajouter une heure exacte, telle que 12/10/2017 07:40:00. La correction automatique de cette date est disponible. Par exemple, si vous écrivez 8 9 2018 9:0, elle devient automatiquement 08/09/2018 09:00:00.
• Priorité : le niveau de priorité de l'élément de file d'attente à ajouter. Cette propriété constitue un critère de définition de priorités à affecter aux éléments de file d'attente (tout comme « Échéance » et « Différer »).
• Référence (Reference) - Référence du QueueItem ajouté. La référence peut être utilisée pour lier vos transactions à d'autres applications utilisées dans un projet d'automatisation. Cette fonctionnalité vous permet également de rechercher certaines transactions dans Orchestrator en fonction de la chaîne fournie.
  Remarque :

  DueDate est un mot clé réservé. Il ne peut être utilisé à l'intérieur d'une propriété lorsque vous configurez cette activité.

Divers

• Timeout (millisecondes) : spécifie le délai d'attente (en millisecondes) pour l'exécution de l'activité avant qu'une erreur soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes).
• Continuer en cas d'erreur (Continue on error) : précise si l’automatisation doit se poursuivre même si l’activité génère une 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 qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.
  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

Configuration Windows - Héritage

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue On Error) : précise si l’automatisation doit se poursuivre même si l’activité génère une 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 qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.
  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• NomAffichage (DisplayName) - Nom affiché de l'activité.
• Timeout (millisecondes) : spécifie le délai d'attente (en millisecondes) pour l'exécution de l'activité avant qu'une erreur soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes).

Entrée

• Échéance : la date avant laquelle l'élément de file d'attente doit être traité. Cette propriété constitue un critère de définition de priorités à affecter aux éléments de file d'attente, tout comme Priorité et Différer. Cette propriété peut être renseignée avec des dates relatives telles que DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) et DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Par ailleurs, vous pouvez utiliser la notation américaine pour ajouter une heure exacte, telle que 12/10/2017 07:40:00. La correction automatique de cette date est disponible. Par exemple, si vous écrivez 8 9 2018 9:0, elle devient automatiquement 08/09/2018 09:00:00.
• Item Collection - Enables importing an entire dictionary of information for a queue item. This field only accepts Dictionary<string, object> variables.
• Item Information - A collection of additional information about the specific QueueItem that is to be added. The information is stored in the item and is used during a transaction processing. It is recommended to use only primitive values of the following types: Number, Boolean, String and DateTime. The value of string arguments cannot contain the following characters: [ and " ". Argument names cannot contain the following characters: :, ., ,, @, ".
• Différer : la date après laquelle l'élément de file d'attente peut être traité. Cette propriété constitue un critère de définition de priorités à affecter aux éléments de file d'attente, tout comme Priorité et Échéance. Cette propriété peut être renseignée avec des dates relatives telles que DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) et DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Par ailleurs, vous pouvez utiliser la notation américaine pour ajouter une heure exacte, telle que 12/10/2017 07:40:00. La correction automatique de cette date est disponible. Par exemple, si vous écrivez 8 9 2018 9:0, elle devient automatiquement 08/09/2018 09:00:00.
• Priorité : le niveau de priorité de l'élément de file d'attente à ajouter. Cette propriété constitue un critère de définition de priorités à affecter aux éléments de file d'attente (tout comme « Échéance » et « Différer »).
• Queue Name - The queue where the QueueItem object is to be added. The name is case insensitive, meaning that if in Orchestrator it was defined as "MyFirstQueue", it matches "myfirstqueue". The maximum number of characters is 50.
• Référence (Reference) - Référence du QueueItem ajouté. La référence peut être utilisée pour lier vos transactions à d'autres applications utilisées dans un projet d'automatisation. Cette fonctionnalité vous permet également de rechercher certaines transactions dans Orchestrator en fonction de la chaîne fournie.
  Remarque :

  DueDate est un mot clé réservé. Il ne peut être utilisé à l'intérieur d'une propriété lorsque vous configurez cette activité.

Divers

• Chemin du dossier : le chemin du dossier où se trouve l'objet ÉlémentsFileAttente, s'il est différent du dossier dans lequel le processus est en cours d'exécution. Ce champ prend uniquement en charge les valeurs de chaîne, avec / comme séparateur permettant d'indiquer les sous-dossiers. Par exemple : "Finance/Accounts Payable".

  Remarque :

  Le paramètre Folder Path ne fonctionne pas pour les processus exécutés par des robots dans des dossiers classiques. Seuls les robots des dossiers modernes ont la capacité de transmettre des données à l'extérieur de leur dossier. Les chemins d’accès relatifs aux dossiers sont pris en charge dans un en-tête X-UIPATH-FolderPath-Encoded comme suit :

  Chemin d'accès commençant par / : commence à partir du dossier root de l'arborescence dont il fait partie.

  Chemin d'accès commençant par . : commence à partir du dossier.

  Chemin commençant par .. : commence un niveau au-dessus dans la hiérarchie du dossier pour chaque .. dans le chemin d'accès (par exemple ../ pour un niveau au-dessus, ../../ pour deux niveaux au-dessus dans la hiérarchie).

  Les barres obliques finales ne sont pas acceptées.

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