Ligne 1 : Ligne 1 :
=Bulk Import/Export of Agent Data=
+
=Importation/exportation en masse de données des agents=
 +
{{#anc:Bulk Import/Export of Agent Data}}
  
To create or modify large numbers of agents, you upload a [[CSVFile|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, based on the action to be taken as indicated in the Action column.
+
Pour créer ou modifier un grand nombre d'agents, vous devez télécharger un [[CSVFile|fichier de valeurs séparées par des virgules (CSV)]] contenant les informations nouvelles et modifiées sur les agents. Saisissez 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 ou modifiés, conformément à l'action définie dans la colonne Action.
  
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 for creation or update of 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 ou de mettre à jour 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.
  
<toggledisplay linkstyle font-size:larger showtext="[+] Show steps" hidetext="[-] Hide steps">
+
<toggledisplay linkstyle font-size:larger showtext="[+] Afficher les étapes" hidetext="[-] Masquer les étapes">
 
{{Procedure
 
{{Procedure
|Title=Creating a Blank Template for Bulk Agent Updates
+
|Title=Création d'un modèle vierge pour la mise à jour des agents en masse
|Purpose=To create a template with column headers only (no values) that you can use to upload new and modified Agent data in bulk.
+
|Purpose=créer un modèle contenant seulement des en-têtes de colonne (sans valeurs) pour télécharger en masse les données nouvelles et modifiées à propos des agents.
 
|Steps=<ol>
 
|Steps=<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>[[CSVFile#File_Format|<type>:<name>]]</tt>.</li>  
+
<li> Les objets Compétences, Groupes d'agents, Groupes d'accès et Autocommutateurs peuvent être sélectionnés en tant que colonnes. L'en-tête de colonne apparaît sous la forme <tt>[[CSVFile#File_Format|<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 '''<''logged-in user''>_generated_spreadsheet_<''date stamp''>.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é '''<''logged-in user''>feuille_de_calcul_<''date stamp''>.csv'''. </li>
 
</ol>
 
</ol>
 
}}
 
}}
Ligne 30 : Ligne 32 :
  
 
{{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, enregistrez-la au format CSV puis téléchargez-la dans GAX.
  
<toggledisplay linkstyle font-size:larger showtext="[+] Show steps" hidetext="[-] Hide steps">
+
<toggledisplay linkstyle font-size:larger showtext="[+] Afficher les étapes" hidetext="[-] Masquer les étapes">
 
{{Procedure
 
{{Procedure
|Title=Exporting Agent Data From GAX into a CSV File
+
|Title=Exportation des données des agents à partir de GAX dans un fichier CSV
|Purpose=To download data for a selected group of agents from GAX into a CSV file.
+
|Purpose=télécharger dans un fichier CSV les données d'un groupe d'agents sélectionné dans GAX.
 
|Steps=<ol>
 
|Steps=<ol>
<li> In the Agents list, select those Agents for whom you want to export data.</li>
+
<li> Dans la liste Agents, sélectionnez les agents pour lesquels vous souhaitez exporter les données.</li>
<li> Click '''Export'''.  
+
<li> Cliquez sur '''Exporter'''.
<li> 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.</li>  
+
<li> 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.</li>
<li> Click '''Export'''. GAX generates and downloads a spreadsheet called '''<logged-in user>_generated_spreadsheet_<datestamp>.csv''' with the data that you selected for export.</li>
+
<li> Cliquez sur '''Exporter'''. GAX génère et télécharge une feuille de calcul appelée '''<logged-in user>_feuille_de_calcul_<datestamp>.csv''' contenant les données que vous avez sélectionnées pour l'exportation.</li>
 
</ol>
 
</ol>
 
}}
 
}}
Ligne 47 : Ligne 50 :
  
 
{{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:
+
==Télé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 enregistrer 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 [[CSVFile#eg|here]].
+
Un exemple de feuille de calcul préparée et de fichier CSV est fourni [[CSVFile#eg|ici]].
  
Now go ahead and upload the data into GAX.
+
A présent, vous pouvez continuer et télécharger les données dans GAX.
  
<toggledisplay linkstyle font-size:larger showtext="[+] Show steps" hidetext="[-] Hide steps">
+
<toggledisplay linkstyle font-size:larger showtext="[+] Afficher les étapes" hidetext="[-] Masquer les étapes">
 
{{Procedure
 
{{Procedure
|Title=Uploading a CSV File
+
|Title=Téléchargement d’un fichier CSV
|Purpose=To upload a CSV file into GAX and update agent information in bulk.
+
|Purpose=télécharger un fichier CSV dans GAX et mettre à jour en masse les informations sur les agents.
 
|Steps=<ol>
 
|Steps=<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 '''Télé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 télé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> Cliquer 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> Cliquer 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 télé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>
 
}}
 
}}
 
</toggledisplay>
 
</toggledisplay>
  
==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 Autocommutateurs 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é, une place est créée 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 du mai 24, 2017 à 12:00

Importation/exportation en masse de données des agents

Pour créer ou modifier 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. Saisissez 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 ou modifiés, conformément à l'action définie dans la colonne Action.

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 ou de mettre à jour 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.

[+] Afficher les étapes

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, enregistrez-la au format CSV puis téléchargez-la dans GAX.

[+] Afficher les étapes

Télé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 enregistrer 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.

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

[+] Afficher les étapes

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 Autocommutateurs 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é, une place est créée 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.
Comments or questions about this documentation? Contact us for support!