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 (Orchestrator Folder Path): 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).

  Notez que les barres obliques finales ne sont pas acceptées.

• Nom de la file d'attente (QueueName) - File d'attente à laquelle l'objet QueueItem doit être ajouté. Le nom est insensible à la casse, ce qui signifie que si dans Orchestrator il a été défini sous la forme "MyFirstQueue", cela correspond à "myfirstqueue". Le nombre maximum de caractères est de 50.
  • Si vous cliquez sur le bouton Gérer les files d'attente (Manage queues) en regard de Nom de la file d' attente (Queue Name), vous êtes redirigé vers la section Files d'attente (Queues) dans Orchestrator auquel Studio est connecté.
• InformationsÉlément : 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. Il est recommandé d'utiliser uniquement des valeurs primitives des types suivants : Nombre, Booléen, String et DateHeure. La valeur des arguments String ne peut pas contenir les caractères suivants : [ et " ". Les noms d'arguments ne peuvent pas contenir les caractères suivants : :, ., ,, @, ".

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 1DateTime.Now.AddDays(10). 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.
• CollectionInformationsÉlément : permet d'importer un dictionnaire complet d'informations pour un élément de file d'attente. Ce champ accepte uniquement les variables Dictionary<string, object>.
• 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 1DateTime.Now.AddDays(10). 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 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.

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 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é.
• 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 1DateTime.Now.AddDays(10). 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.
• CollectionInformationsÉlément : permet d'importer un dictionnaire complet d'informations pour un élément de file d'attente. Ce champ accepte uniquement les variables Dictionary<string, object>.
• InformationsÉlément : 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. Il est recommandé d'utiliser uniquement des valeurs primitives des types suivants : Nombre, Booléen, String et DateHeure. La valeur des arguments String ne peut pas contenir les caractères suivants : [ et " ". Les noms d'arguments ne peuvent pas contenir les caractères suivants : :, ., ,, @, ".
• 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 1DateTime.Now.AddDays(10). 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 »).
• Nom de la file d'attente (QueueName) - File d'attente à laquelle l'objet QueueItem doit être ajouté. Le nom est insensible à la casse, ce qui signifie que si dans Orchestrator il a été défini sous la forme "MyFirstQueue", cela correspond à "myfirstqueue". Le nombre maximum de caractères est de 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 (Folder Path) : le chemin du dossier où se trouve l'objet ÉlémentsFileAttente (QueueItems), 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).

  Notez que 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).