Documentation:GA:user:ImpExp:DRAFT

Importation/exportation en masse de données des agents

Pour créer, modifier ou supprimer un grand nombre d’agents, vous devez télécharger un fichier de valeurs séparées par des virgules (CSV) contenant les informations nouvelles et modifiées sur les agents. Entrez ou modifiez les valeurs dans les colonnes appropriées pour l’agent. Lors du téléchargement dans GAX, les agents indiqués dans le fichier sont créés, modifiés ou supprimés, conformément à l’action définie dans la colonne Action.

Le fichier CSV utilisé pour importer/exporter des données de l’agent est identique à celui utilisé pour importer/exporter des personnes (utilisateurs) dans Configuration Manager. Reportez-vous au Fichier CSV pour l’importation et l’exportation pour une description détaillée du fichier CSV.

Important

Les utilisateurs du locataire peuvent mettre à jour des agents uniquement pour le locataire auquel appartient l’utilisateur.

A cette fin, GAX permet de créer des modèles de feuille de calcul. Vous pouvez créer un modèle vide contenant uniquement des en-têtes de colonne, mais aussi exporter les données d’enregistrements d’agents existants. La feuille de calcul exportée peut être modifiée puis réimportée dans GAX en vue de créer, de mettre à jour ou de supprimer les enregistrements d’agents.

Conseil

Il est possible de créer différents modèles en fonction de scénarios spécifiques de vos opérations.

Création d’un modèle vide

Un modèle vide contient toutes les colonnes obligatoires, plus les en-têtes que vous spécifiez. Il n’inclut pas de données—c’est à vous de les ajouter.

1. Pour créer un modèle, cliquez sur Créer une feuille de calcul dans la fenêtre Agents ou Historique. Un sélecteur de colonnes s’ouvre. Utilisez-le pour choisir les colonnes devant figurer dans le modèle.
2. Dans le sélecteur de colonnes, choisissez les champs à intégrer au modèle. Les colonnes sélectionnées apparaissent dans la liste à gauche. Faites glisser le nom des colonnes ou utilisez les flèches pour les agencer dans l’ordre de votre choix. Remarque :
   
   • Les champs obligatoires sont toujours inclus.
   • Le champ Action est toujours ajouté pour former la première colonne.
   • Les objets Compétences, Groupes d’agents, Groupes d’accès et Commutateurs peuvent être sélectionnés en tant que colonnes. L’en-tête de colonne apparaît sous la forme <type>:<name>.
   • Le groupe d’agents virtuel ne peut pas être importé/exporté en masse, et son contenu ne peut pas figurer dans le tableau des groupes d’agents.
3. Une fois que vous avez sélectionné et agencé les colonnes, cliquez sur Créer une feuille de calcul. GAX génère et télécharge le fichier de modèle appelé download.csv.

Exportation de données

GAX permet d’exporter des données à partir d’enregistrements de données existants. Si vous modifiez la feuille de calcul pour l’utiliser comme modèle, sauvegardez-la au format CSV puis téléchargez-la dans GAX.

Exportation des données des agents à partir de GAX dans un fichier CSV

1. Dans la liste Agents, sélectionnez les agents pour lesquels vous souhaitez exporter les données.
2. Cliquez sur Exporter.
3. Le sélecteur de colonnes présélectionne les champs associés à l’agent sélectionné. Par exemple, les groupes d’agents, groupes d’accès, compétences et autocommutateurs correspondant aux Agents que vous avez choisis sont présélectionnés. Sélectionnez autant de champs que nécessaire ou désélectionnez ceux dont l’exportation n’est pas nécessaire.
4. Cliquez sur Exporter. GAX génère et télécharge une feuille de calcul appelée download.csv contenant les données que vous avez sélectionnées pour l’exportation.

Chargement d’un fichier

Avant de télécharger les mises à jour en masse, vous devez entrer les données dans une feuille de calcul et sauvegarder cette dernière au format CSV. Vous pouvez utiliser l’une ou l’autre des méthodes suivantes :

• Créer un modèle vide et renseigner les valeurs appropriées — Il s’agit probablement du moyen à privilégier si la plupart de vos mises à jour ajoutent de nouveaux agents.
• Exporter les données existantes et apporter les ajouts et modifications nécessaires — Il s’agit probablement du moyen à privilégier si vous effectuez surtout des changements dans les données des agents existants. Vous pouvez exporter les informations de ces seuls agents, ce qui vous évite de remplir les données obligatoires les concernant.

Un exemple de feuille de calcul préparée et de fichier CSV est fourni ici.

À présent, vous pouvez continuer et télécharger les données dans GAX.

1. Cliquez sur Importer dans la fenêtre Agents ou Historique.
2. Cliquez sur Sélectionner un fichier et, à l’aide de l’explorateur de fichiers, choisissez votre fichier CSV.
3. Cliquez sur Charger la feuille de calcul. GAX commence à valider le fichier et affiche la progression. Vous pouvez cliquer sur Fermer pour fermer la fenêtre ou la laisser ouverte pour surveiller la progression. Même si la fenêtre est fermée, le traitement continue et peut être observé dans la fenêtre Historique.
   • Si le message Feuille de calcul valide apparaît, cliquez sur Continuer pour lancer le chargement.
   • Si la boîte de dialogue affiche une ou plusieurs erreurs, ouvrez le fichier dans une nouvelle fenêtre et corrigez-les. Ensuite, répétez cette procédure à partir de l’étape 2.
4. GAX commence à traiter les enregistrements et affiche la progression. Si nécessaire, vous pouvez à tout moment :
   • Cliquez sur Fermer la fenêtre. Le traitement continue et peut être observé dans la fenêtre Historique.
   • Cliquez sur Arrêter l’opération, puis sur Oui, arrêter l’opération pour confirmer votre choix. Lorsque le traitement s’arrête, vous revenez à la liste des agents.
5. Si vous n’avez pas arrêté le chargement, GAX affiche Opération terminée après le traitement des enregistrements. Il affiche également un résumé des résultats, en l’occurrence le nombre d’enregistrements créés et/ou mis à jour ainsi que le nombre d’enregistrements qui n’ont pas été créés ou mis à jour à cause d’une erreur. Cliquez sur Fermer la fenêtre pour revenir à la liste des agents.

Actions de script

Pour les nouveaux utilisateurs :

1. Créez une personne avec des propriétés définies dans le dossier spécifié.
2. Associez la nouvelle personne aux groupes d’accès spécifiés.
3. Associez la nouvelle personne aux groupes d’agents spécifiés.
4. Pour les agents, ajoutez les compétences spécifiées.
5. Pour les agents, procédez comme suit :
   • Si le champ Extension n’est pas renseigné, créez et associez les noms de connexion des agents pour tous les commutateurs spécifiés avec le code de connexion équivalant au nom d’utilisateur de l’agent. Les noms de connexion des agents sont créés dans le dossier des Noms de connexion des agents d’autocommutateurs avec la même hiérarchie de dossiers que celle spécifiée pour l’objet Personne dans la propriété Dossier.
   • Si le champ Extension est renseigné, un emplacement est créé avec un nom équivalent au nom d’utilisateur de l’agent. Les DN d’extension sont créés avec le numéro correspondant au champ Extension sur tous les autocommutateurs spécifiés. Les noms de connexion des agents sont créés et associés à tous les autocommutateurs spécifiés possédant un code de connexion équivalent à la valeur du champ Extension. Tous les objets sont créés sous leur dossier racine en utilisant la même hiérarchie de dossiers que celle spécifiée pour l’objet Personne dans la propriété Dossier.

Pour les utilisateurs existant :

1. Les champs Nom d’utilisateur et Agent doivent être renseignés dans le fichier d’entrée identifiant la personne.
2. Les autres champs sont facultatifs.
3. Si un champ facultatif est défini, sa valeur est comparée à la valeur existante et, si elle est différente, le champ est mis à jour pour cette personne.