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.

There is a series of predefined column headers that you can use when building your CSV file, but you can also use other custom headers. After successfully uploading the CSV file, information contained in columns with predefined headers is mapped to columns as found in Orchestrator. Information contained in columns with custom headers is placed under the Specific Data section of the corresponding item in Orchestrator.

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

You can lower the limit using the Upload.Queues.MaxNumberOfItems app setting.

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) References are not compatible with v2016.2 or lower versions of Orchestrator or 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 option qui vous permet de contrôler la façon dont Orchestrator analyse la valeur de chaîne à l'intérieur de .csv utilisés pour télécharger les éléments de la 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.

   

2. Cliquez sur Parcourir et sélectionnez le fichier CSV souhaité.

3. Click Open. If your file is compliant with the supported formatting rules, the upload operation is successful.

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. Select the Dynamic typing checkbox if you want Orchestrator to interpret string characters in the CSV files as integer or boolean. This is recommended when uploading queue items to queues with schema definitions when it's required to match the schema definition. Leave it unselected, if you want strings to be interpreted as strings.

   

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

Notice that this file contains 3 predefined columns, having the same name as in Orchestrator (Reference,Deadline, and Priority, highlighted in green) and 2 custom columns (Customer and Color, highlighted in red).

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.

The Transactions page displays each item uploaded from your file. The information contained within the file's predefined columns is mapped to the columns with the same name in Orchestrator (Reference,Deadline, and Priority, highlighted in green):

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 :