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 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 : Low or 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. Une colonne de votre fichier CSV nommée reference est mappée à la section Données spécifiques , au lieu de la colonne Référence .

Stratégies de téléchargement

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

• ProcessAllIndependently (ProcessAllIndependently) : traite tous les éléments individuellement et les ajoute à la file d'attente, en cas de succès. 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 rempli avec les mêmes champs que dans le fichier initialement téléchargé.
• 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 entier pour conserver la 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.

1. Sur la page Files d'attente (Queues), cliquez sur le bouton Autres actions correspondant à la file d'attente souhaitée, puis sur Charger les éléments ( Upload Items ) . La fenêtre Télécharger les éléments ( Upload Items ) s'affiche.

Image 1. Télécharger des éléments

2. Sélectionnez Parcourir et sélectionnez le fichier CSV souhaité.
3. Sélectionnez Ouvrir. Si votre fichier est conforme aux règles de formatage prises en charge, l'opération de téléchargement est réussie.
4. Sélectionnez la stratégie de téléchargement:
   • Tout traiter indépendamment : traite tous les éléments individuellement et les ajoute à la file d'attente, en cas de succès. 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 rempli avec les mêmes champs que dans le fichier initialement téléchargé
   • Tout ou rien : ajoute les éléments uniquement s'ils ont tous été traités avec succès. Sinon, aucun n'est ajouté.
5. Cochez la case Saisie dynamique 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.

Figure 2. Saisie dynamique

6. Cliquez sur Télécharger (Upload). Les éléments sont ajoutés à votre file d'attente, selon la stratégie auparavant sélectionnée.
7. Si vous avez utilisé l'option Tout traiter indépendamment et qu'il existe des éléments non traités, le bouton Télécharger ( Upload ) devient Télécharger (Download) et vous permet de télécharger un fichier CSV contenant les éléments non traités.

Exemple

Supposons que vous téléchargez dans une file d'attente le contenu du fichier CSV suivant. Un moyen facile de créer un tel fichier consiste à remplir les données dans un fichier Excel et à l'enregistrer sous forme de 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 trois colonnes prédéfinies, portant le même nom que dans Orchestrator (Référence, Échéance et Priorité, surlignées en vert) et deux colonnes personnalisées (Client et Couleur, surlignées en rouge).

Figure 3. Fichier CSV

1. Cliquez sur Télécharger les éléments ( Upload Items ) pour la file d'attente souhaitée et sélectionnez le fichier CSV. Orchestrator analyse le fichier pour confirmer qu'il respecte les règles de formatage.
2. Sélectionnez les stratégies de téléchargement souhaitées et cliquez sur Télécharger (Upload) pour terminer le processus.
3. 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é depuis votre fichier. Les informations contenues dans les colonnes prédéfinies du fichier sont mappées aux colonnes du même nom dans Orchestrator (Référence, Échéance et Priorité, surlignées en vert).

Figure 4. Page Transactions

Les informations des colonnes personnalisées sont mappées au format JSON à la section Données spécifiques de chaque élément. Sélectionnez Afficher les détails de l'élément souhaité pour vérifier les détails.

Figure 5. Onglet Détails