m (1 révision importée)
m (1 révision importée)
 
(3 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
=Bulk Import/Export of Agent Data=
+
=Importation/exportation en masse de données des agents=
To create or modify or delete large numbers of agents, you upload a comma-separated value (CSV) file containing new and changed agent information. You enter or modify values in the appropriate columns for the agent. When uploaded to GAX, the agents listed in the file are created or modified or deleted, based on the action to be taken as indicated in the Action column.
+
{{#anc:Bulk Import/Export of Agent Data}}
 +
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.
  
The CSV file used to import/export Agent data is the same as that used to import/export Persons (Users) in Configuration Manager.  Refer to [[CfgPerson#csv|CSV File for Importing and Exporting]] for a detailed description of the CSV file.
+
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 [[CfgPerson#csv|Fichier CSV pour l’importation et l’exportation]] pour une description détaillée du fichier CSV.
  
{{NoteFormat|Tenant users can update Agents in only the Tenant to which the user belongs.}}
+
{{NoteFormat|Les utilisateurs du locataire peuvent mettre à jour des agents uniquement pour le locataire auquel appartient l’utilisateur.}}
  
GAX enables you to create spreadsheet templates for this purpose. You can create an [[ImpExp#Creating_an_Empty_Template|empty template]] containing only column headers, or you can [[ImpExp#Exporting_Data|export data]] from existing agent records. The exported spreadsheet can be modified and then imported into GAX again to create or update or delete agent records.  
+
A cette fin, GAX permet de créer des modèles de feuille de calcul. Vous pouvez créer un [[ImpExp#Creating_an_Empty_Template|modèle vide]] contenant uniquement des en-têtes de colonne, mais aussi [[ImpExp#Exporting_Data|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.  
  
{{NoteFormat|You might want to create various templates that fit scenarios specific to your operations.|2}}
+
{{NoteFormat|Il est possible de créer différents modèles en fonction de scénarios spécifiques de vos opérations.|2}}
  
 
{{AnchorDiv|empty}}
 
{{AnchorDiv|empty}}
==Creating an Empty Template==
+
{{#anc:Creating an Empty Template}}
An empty template contains all of the mandatory columns plus column headers that you specify. It does not include any data—that is for you to fill in.  
+
==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.  
  
 
<ol>
 
<ol>
<li>To create a template, click '''Create Spreadsheet''' in the Agents window or in the History window. This opens a column picker window in which you select the columns that you want to appear in the template.</li>
+
<li>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.</li>
<li>In the column picker window, select the fields that you want included in the template. The selected columns appear in the columns list on the left. Drag the column names or use the arrows to put them in any order that you require. Note the following:<br>
+
<li>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 :<br>
 
<ul>
 
<ul>
<li> The mandatory fields are always included.</li>
+
<li> Les champs obligatoires sont toujours inclus.</li>
<li> The Action field is always added as the first column.</li>
+
<li> Le champ Action est toujours ajouté pour former la première colonne.</li>
<li> For Skills, Agent Groups, Access Groups, and Switches, each object can be selected as a column. The column header appears as <tt><type>:<name></tt>.</li>  
+
<li> 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 <tt><type>:<name></tt>.</li>  
<li> Virtual Agent Group cannot be imported/exported in bulk, so are not listed in the Agent Groups table.</li>
+
<li> 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.</li>
 
</ul></li>
 
</ul></li>
<li> After you have selected and ordered the columns, click '''Create Spreadsheet'''. GAX generates and downloads the template file, called '''download.csv'''.</li>
+
<li> 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'''.</li>
 
</ol>
 
</ol>
  
 
{{AnchorDiv|export}}
 
{{AnchorDiv|export}}
==Exporting Data==
+
{{#anc:Exporting Data}}
GAX allows you to export data from existing data records. If you are modifying the spreadsheet to use as a template, save it as a CSV after making the appropriate changes, and upload it into GAX.
+
==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.
  
===Exporting Agent Data From GAX into a CSV File===
+
{{#anc:Exporting Agent Data From GAX into a CSV File}}
# In the Agents list, select those Agents for whom you want to export data.
+
===Exportation des données des agents à partir de GAX dans un fichier CSV===
# Click '''Export'''.  
+
# Dans la liste Agents, sélectionnez les agents pour lesquels vous souhaitez exporter les données.
# The column picker window has the associated fields pre-selected for the selected agent. For example, the associated Agent Groups, Access Groups, Skills, and Switches, will be pre-selected for those Agents that the user has selected before. Select more fields as required, or clear those fields that you do not want exported.  
+
# Cliquez sur '''Exporter'''.  
# Click '''Export'''. GAX generates and downloads a spreadsheet called '''download.csv''' with the data that you selected for export.
+
# 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.  
 +
# 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.
  
 
{{AnchorDiv|upload}}
 
{{AnchorDiv|upload}}
==Uploading a File==
+
{{#anc:Uploading a File}}
Before uploading the bulk updates, you must enter the data into a spreadsheet and save it as a CSV file. Do this in one of two ways:
+
==Chargement d’un fichier==
* [[ImpExp#Creating_an_Empty_Template|Create an empty template]] and fill in the appropriate values&mdash;This is probably the best way if the majority of your updates are adding new agents.
+
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 :
* [[ImpExp#Exporting_Data|Export existing data]] and make the necessary additions and changes&mdash;This is probably the best way if you are primarily making changes to existing agents. You can export the information for just those agents, saving you from filling in the mandatory information for them.
+
*[[ImpExp#Creating_an_Empty_Template|Créer un modèle vide]] et renseigner les valeurs appropriées &mdash; Il s’agit probablement du moyen à privilégier si la plupart de vos mises à jour ajoutent de nouveaux agents.
 +
*[[ImpExp#Exporting_Data|Exporter les données existantes]] et apporter les ajouts et modifications nécessaires &mdash; 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.
  
See the example of a prepared spreadsheet and CSV file [[CfgPerson#eg|here]].
+
Un exemple de feuille de calcul préparée et de fichier CSV est fourni [[CfgPerson#eg|ici]].
  
Now go ahead and upload the data into GAX.   
+
À présent, vous pouvez continuer et télécharger les données dans GAX.   
  
 
<ol>
 
<ol>
<li> Click '''Import''' in either the Agents window or in the History window.</li>
+
<li> Cliquez sur '''Importer''' dans la fenêtre Agents ou Historique.</li>
<li> {{AnchorDiv|st2up}}Click '''Select File''' and, using the file browser, select your CSV file.</li>
+
<li> {{AnchorDiv|st2up}}Cliquez sur '''Sélectionner un fichier''' et, à l’aide de l’explorateur de fichiers, choisissez votre fichier CSV.</li>
<li> Click '''Upload Spreadsheet'''. GAX starts validating the file, and displays its progress. You can either click '''Close''' to close the window, or you can monitor the progress from here. Even if the window is closed, processing will continue and can be monitored in the [[History|History window]].
+
<li> 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 [[History|fenêtre Historique]].
 
<ul>
 
<ul>
<li> If the '''Spreadsheet is Valid''', click '''Continue''' to start the upload.</li>
+
<li> Si le message '''Feuille de calcul valide''' apparaît, cliquez sur '''Continuer''' pour lancer le chargement.</li>
<li> If the dialog box displays one or more errors, open your file in a new window and fix the errors. Then repeat this process starting at [[ImpExp#st2up|step 2]].</li>
+
<li> 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’[[ImpExp#st2up|étape 2]].</li>
 
</ul></li>
 
</ul></li>
<li>GAX starts processing the records and displays the progress. If necessary, you can do either of the following at any time:  
+
<li>GAX commence à traiter les enregistrements et affiche la progression. Si nécessaire, vous pouvez à tout moment :  
 
<ul>
 
<ul>
<li> Click '''Close Window'''. Processing will continue, and can be monitored in the [[History|History window]].</li>
+
<li> Cliquez sur '''Fermer la fenêtre'''. Le traitement continue et peut être observé dans la [[History|fenêtre Historique]].</li>
<li> Click '''STOP Operation''', then click '''Yes, STOP Operation''' to confirm. When processing stops, you are returned to the Agent List view.</li>  
+
<li> 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.</li>  
 
</ul></li>
 
</ul></li>
<li> If you did not stop the upload, GAX displays '''Operation Completed''' when the processing of records is finished. It also displays a summary of results, namely the number of records that were successfully created and/or updated, and the number of records that were not updated or created because of an error. Click '''Close Window''' to go back to the main Agent list.</li>
+
<li> 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.</li>
 
</ol>
 
</ol>
  
==Script Actions==
+
{{#anc:Script Actions}}
 +
==Actions de script==
  
====For new users:====
+
{{#anc:For new users:}}
 +
====Pour les nouveaux utilisateurs :====
 
<ol>
 
<ol>
<li> Create a new Person with specified properties in the specified Folder.</li>
+
<li> Créez une personne avec des propriétés définies dans le dossier spécifié.</li>
<li> Associate the new Person with the specified Access Groups.</li>
+
<li> Associez la nouvelle personne aux groupes d’accès spécifiés.</li>
<li> Associated the new Person with the specified Agent Groups.</li>
+
<li> Associez la nouvelle personne aux groupes d’agents spécifiés.</li>
<li> For Agents, add the specified Skills.</li>
+
<li> Pour les agents, ajoutez les compétences spécifiées.</li>
<li> For Agents, do the following:
+
<li> Pour les agents, procédez comme suit :
 
<ul>
 
<ul>
<li> If the Extension field is not specified, create and associate Agent Logins on all specified Switches with the Login Code equal to the Username of the Agent. Agent Logins are created in the Switch Agent Logins folder of the same folder hierarchy specified for the Person object in the Folder property.</li>
+
<li> 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.</li>
<li> If the Extension field is specified, a new Place is created with the name equal to the Username of the Agent. Extension DNs are created with the number corresponding to the Extension field on all specified Switches. Agent Logins are created and associated with all specified Switches that have a Login Code equal to the value of the Extension field. All objects are created under their corresponding root folders using the same folder hierarchy as specified for the Person object in the Folder property.</li>
+
<li> 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.</li>
 
</ul></li>
 
</ul></li>
 
</ol>
 
</ol>
  
====For existing users:====
+
{{#anc:For existing users:}}
# Username and Is Agent fields must be populated in the input file identify the Person.
+
====Pour les utilisateurs existant :====
# All other fields are optional.
+
#Les champs Nom d’utilisateur et Agent doivent être renseignés dans le fichier d’entrée identifiant la personne.
# If an optional field is defined, its value is compared to the existing value and, if different, updated for that Person.
+
# Les autres champs sont facultatifs.
 +
# 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.
  
 
[[Category:V:GA:DRAFT]]
 
[[Category:V:GA:DRAFT]]

Version actuelle datée du août 24, 2019 à 00:59

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.
La dernière modification de cette page a été faite le août 24, 2019 à 00:59.
Comments or questions about this documentation? Contact us for support!