Téléchargement d'éléments en bloc à l'aide d'un fichier CSV

Cette fonctionnalité vous permet de télécharger en bloc des éléments de file d'attente dans une file d'attente spécifique dans Orchestrator à l'aide d'un fichier CSV. Pour ce faire, téléchargez d'abord votre fichier dans votre instance Orchestrator pour une file d'attente spécifique. Une fois le fichier traité avec succès, les éléments contenus sont téléchargés dans la file d'attente en fonction de la stratégie sélectionnée. Veuillez noter que le fichier doit être rempli au préalable à l'aide de formats prédéfinis afin que l'opération de téléchargement réussisse.

Il existe une série d'en-têtes de colonnes prédéfinis que vous pouvez utiliser lors de la création de votre fichier .csv, mais vous pouvez également utiliser d'autres en-têtes personnalisés. Après avoir correctement téléchargé le fichier .csv, les informations contenues dans les colonnes avec des en-têtes prédéfinis sont mappées à des colonnes disponibles dans Orchestrator. Les informations contenues dans les colonnes avec des en-têtes personnalisés sont placées dans la section Données spécifiques (Specific Data) de l'élément correspondant dans Orchestrator. Consultez les informations détaillées sur le mappage de colonne ici et un exemple ici.

Remarque : Le téléchargement est limité à 15 000 éléments par fichier.

Vous pouvez réduire la limite à l’aide du paramètre d’application Upload.Queues.MaxNumberOfItems.

Mappage de colonne

En-tête de colonne de fichier	Champ Orchestrator
Référence (Reference) Obligatoire pour les files d'attente de référence unique. Prend en charge tous les caractères spéciaux, à l'exception des doubles guillemets (`"`).	Référence (Reference) Remarque : les références ne sont pas compatibles avec les versions 2016.2 ou ultérieure d'Orchestrator ou du robot.
Échéance (Deadline) En cas d’utilisation, ces champ doivent être renseignés avec une date dans l’un des formats suivants : JJ-MM-AAAA YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss AAAA MM JJ HH:mm:ss	Échéance (Deadline)
Différer (Postpone) En cas d’utilisation, ces champ doivent être renseignés avec une date dans l’un des formats suivants : JJ-MM-AAAA YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss AAAA MM JJ HH:mm:ss	Différer (Postpone)
Priorité (Priority) En cas d’utilisation, ces champ doivent être renseignés avec une date dans l’un des formats suivants : Basse (Low) ou 1 Normale (Normal) ou 2 Élevée ou 3 Si la priorité n'est pas spécifiée dans le fichier, les éléments sont téléchargés, par défaut, avec une priorité élevée.	Priorité (Priority) Ce champ doit être mappé aux valeurs suivantes, respectivement : Basse Normale Haute
[Custom_Name] Le nom ne peut être composé que de caractères alphanumériques : 0-9, a-z ou des traits de soulignement.	Données spécifiques (Specific Data) Mappé au format JSON. Par exemple : Chèque tiré sur notre banque (On-Us Check) : 5 540

Notez que vous ne pouvez pas avoir d'en-têtes de colonnes vides dans votre fichier.

Remarque : les en-têtes de colonnes prédéfinis sont sensibles à la casse, assurez-vous de suivre les règles de mappage ci-dessus. nommée reference est mappée à la section Données spécifiques (Specific Data), au lieu de la colonne Référence (Reference).

Stratégies de téléchargement

Il existe deux stratégies de gestion du téléchargement :

ProcessAllIndependently : traite tous les éléments individuellement et les ajoute à la file d'attente, en cas de réussite. Sinon, il renvoie une liste de ceux dont le traitement a échoué. Vous avez la possibilité de télécharger la liste dans un fichier CSV contenant les mêmes champs que dans le fichier téléchargé initialement.
AllOrNothing : ajoute les éléments uniquement si tous ont été correctement traités. Sinon, aucun d'entre eux n'est ajouté.

Saisie dynamique

Lors du téléchargement d'éléments de file d'attente vers des files d'attente avec des définitions de schéma, vous avez parfois besoin d'Orchestrator pour interpréter les caractères de chaîne comme des entiers ou des booléens afin de correspondre à la définition de schéma.

La saisie dynamique est une nouvelle option qui vous permet d'analyser la façon dont Orchestrator interprète les valeurs String dans les fichiers .csv utilisés pour télécharger les éléments de file d'attente.

Remarque : les données numériques doivent être conformes à la définition d'un littéral décimal. Les valeurs numériques supérieures à 2⁵³ ou inférieures à -2⁵³ ne sont pas converties en nombre entier à des fins de précision. Assurez-vous d'utiliser le point comme séparateur décimal et la virgule comme séparateur de milliers.

Téléchargement d'éléments de la file d'attente à l'aide d'un fichier CSV

Cette section concerne l'ajout d'éléments à une file d'attente à l'aide d'un fichier CSV d'Orchestrator.

Sur la page Files d'attente (Queues), cliquez sur le bouton Autres actions (More Actions) correspondant de votre file d'attente souhaitée, puis sur Télécharger des éléments (Upload Items). La fenêtre Télécharger des éléments (Upload Items) est affichée.
Cliquez sur Parcourir (Browse) et sélectionnez le fichier CSV souhaité.
Cliquez sur Ouvrir ( Open). Si votre fichier est conforme aux règles de formatage prises en charge, l'opération de téléchargement est réussie.
Sélectionnez la stratégie de téléchargement :
- ProcessAllIndependently : traite tous les éléments individuellement et les ajoute à la file d'attente, en cas de réussite. Sinon, il renvoie une liste de ceux dont le traitement a échoué. Vous avez la possibilité de télécharger la liste dans un fichier CSV contenant les mêmes champs que dans le fichier téléchargé initialement.
- AllOrNothing : ajoute les éléments uniquement si tous ont été correctement traités. Sinon, aucun d'entre eux n'est ajouté.
Cochez la case Saisie dynamique (Dynamic typing) si vous souhaitez qu'Orchestrator interprète les caractères de chaîne dans les fichiers CSV comme des entiers ou des booléens. Cette action est recommandée lors du téléchargement d'éléments de file d'attente vers des files d'attente avec des définitions de schéma lorsqu'une correspondance avec la définition de schéma est requise. En savoir plus sur la saisie dynamique. Laissez cette case décochée si vous souhaitez que les chaînes soient interprétées comme des chaînes.
Cliquez sur Télécharger (Upload). Les éléments sont ajoutés à votre file d'attente, selon la stratégie auparavant sélectionnée.
Si vous avez utilisé l'option Tous les traiter indépendamment (Process All Independently), et que des éléments ne sont pas traités, le bouton Charger (Upload) devient Télécharger (Download), et il permet de télécharger un fichier CSV contenant les éléments non traités.

Exemple

Supposons que vous chargez dans une file d'attente le contenu du fichier CSV suivant. Un moyen simple de créer un tel fichier consiste à remplir les données dans un fichier Excel et à l'enregistrer en tant que fichier CSV :

Ou vous pouvez télécharger un fichier .csv avec tous les en-têtes de colonne pré-remplis et le personnaliser en fonction de vos besoins.

Notez que ce fichier contient 3 colonnes prédéfinies, portant le même nom que dans Orchestrator (Référence (Reference), Échéance (Deadline) et Priorité (Priority), mises en évidence en vert) et 2 colonnes personnalisées (Client et Couleur (Color), mises en évidence en rouge).

Cliquez sur Télécharger les éléments (Upload Items) correspondant à la file d’attente souhaitée et sélectionnez le fichier Orchestrator analyse le fichier pour confirmer qu'il respecte les règles de formatage.
Sélectionnez les stratégies de téléchargement souhaitées et cliquez sur Télécharger (Upload) pour terminer le processus.
Sélectionnez Autres actions (More Actions) > Afficher les transactions (View Transactions) pour afficher les éléments de la file d’attente téléchargés.

La page Transactions affiche chaque élément téléchargé à partir de votre fichier. Les informations contenues dans les colonnes prédéfinies du fichier sont mappées vers les colonnes du même nom dans Orchestrator (Référence (Reference) Échéance (Deadline) et Priorité (Priority), mises en évidence en vert) :

Les informations contenues dans les colonnes personnalisées sont mappées au format JSON dans la section Données spécifiques (Specific Data) de chaque élément. Cliquez sur Afficher les détails (View Details) de l’élément souhaité pour le voir :