Ligne 1 : Ligne 1 :
−
=CSV File=
+
=Fichier CSV=
 +
{{#anc:CSV File}}
 
__TOC__
 
__TOC__
  
−
GAX uses comma-separated value (CSV) files for the import\export of bulk updates to Agents. This section describes the format of the CSV file and provides some examples.
+
GAX utilise des fichiers de valeurs séparées par des virgules (CSV) pour l'importation et l'exportation de mises à jour en masse pour les agents. Cette section décrit le format du fichier CSV et fournit quelques exemples.
  
−
==File Format==
+
{{#anc:File Format}}
−
The source file is a text file in a comma-separated (CSV) format.
+
==Format de fichier==
 +
Le fichier source est un fichier texte au format CSV (valeurs séparées par des virgules).
  
−
In the source file each line represents a single user or agent. The same user or agent can appear in the source file only once. The unique identifier of the user in the scope of the source file is the <tt>Username</tt> field.
+
Dans le fichier source, chaque ligne représente un utilisateur ou un agent unique. Un même utilisateur ou agent ne peut apparaître qu'une seule fois dans le fichier source. L'identificateur unique de l'utilisateur dans le fichier source est le contenu du champ <tt>Nom d'utilisateur</tt>.
  
−
The columns of the file are the properties of a user or an agent. The first row in the file has column names to identify the fields. The order of the columns is not important. A comma is inserted after each column header or value, or if the column does not have a value, immediately after the previous comma. Any non-mandatory column can be omitted from the source file, depending on user preference and/or the purpose of the file
+
Les colonnes du fichier sont les propriétés de l'utilisateur ou de l'agent. La première ligne du fichier comporte des noms de colonne permettant d'identifier les champs. L'ordre des colonnes n'a pas d'importance. Une virgule est insérée après chaque valeur ou en-tête de colonne ou, si la colonne ne comporte pas de valeur, immédiatement après la virgule précédente. En fonction des préférences de l'utilisateur et/ou de l'objectif du fichier, une colonne facultative peut être ignorée dans le fichier source.
  
−
The source file contains the following properties for each user/agent:
+
Le fichier source contient les propriétés suivantes pour chaque utilisateur/agent :
−
<toggledisplay linkstyle font-size:larger showtext="[+] Show properties" hidetext="[-] Hide properties">
+
<toggledisplay linkstyle font-size:larger showtext="[+] Afficher les propriétés" hidetext="[-] Masquer les propriétés">
 
{|
 
{|
−
! '''Name'''
+
! '''Nom'''
−
! '''Type'''
+
! '''Type'''
−
! '''Mandatory?'''
+
! '''Obligatoire ?'''
 
! '''Description'''
 
! '''Description'''
−
|+ '''Structure of the CSV Import File'''
+
|+ '''Structure du fichier d'importation CSV'''
 
|-
 
|-
 
| Action
 
| Action
−
| ADD, UPDATE
+
| AJOUT, MISE A JOUR
−
| Yes
+
| Oui
−
| Specifies the action to be taken with this agent data, either create a new agent (ADD) or modify the existing agent (UPDATE).
+
| Précise l'action à effectuer avec les données de cet agent : la création d'un nouvel agent (AJOUT) ou la modification de l'agent existant (MISE A JOUR).
 +
|-
 +
| Prénom
 +
| Chaîne
 +
| Oui
 +
| Prénom de l'utilisateur/agent
 
|-
 
|-
−
| First Name
+
| Nom
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The first name of the User/Agent
+
| Nom de l'utilisateur/agent
 
|-
 
|-
−
| Last Name
+
| ID employé
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The last name of the User/Agent
+
| Identifiant employé de l’utilisateur/agent
 
|-
 
|-
−
| Employee Id
+
| Nom d'utilisateur
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The employee identifier of the User/Agent
+
| Nom d’utilisateur de l'utilisateur/agent
 
|-
 
|-
−
| Username
+
| Mot de passe
−
| String
+
| Chaîne
−
| Yes
+
| Non
−
| The username of the User/Agent
+
| Mot de passe à utiliser avec le nom d’utilisateur
 
|-
 
|-
−
| Password
+
| Modification du mot de passe
−
| String
+
| Booléen (<tt>O</tt> ou <tt>N</tt>)
−
| No
+
| Non
−
| The password to be used with Username
+
| L’utilisateur/agent doit-il mettre à jour son mot de passe lors de la prochaine connexion ?
 
|-
 
|-
−
| Password change
+
| Agent
−
| Boolean (<tt>Y</tt> or <tt>N</tt>)
+
| Booléen
−
| No
+
| Oui
−
| Does the User/Agent need to update his or her password when he or she next logs on?
+
| Détermine si l'enregistrement représente un utilisateur ou un agent ; la fonction de script les différencie.
−
|-
 
−
| Is Agent
 
−
| Boolean
 
−
| Yes
 
−
| Determines if the record represents a user or an agent; script functionality differs between them.
 
 
|-
 
|-
−
| External Id
+
| Identifiant externe
−
| String
+
| Chaîne
−
| No
+
| Non
−
| An external identifier
+
| Identifiant externe
 
|-
 
|-
−
| Email address
+
| Adresse e-mail
−
| String
+
| Chaîne
−
| No
+
| Non
−
| E-mail address of the User/Agent; normally it is the same as Username.
+
| Adresse e-mail de l’utilisateur/agent ; normalement identique au nom d’utilisateur.
 
|-
 
|-
−
| Extension
+
| Extension
−
| numeric string
+
| chaîne numérique
−
| No
+
| Non
−
| The default extension of the Agent. If an extension is present, default Place creation is triggered.
+
| Extension de l’agent par défaut. En présence d'une extension, la création d'une place par défaut est déclenchée.
 
|-
 
|-
−
| Enabled
+
| Activé
−
| Boolean
+
| Booléen
−
| No
+
| Non
−
| The state of the user&mdash;<tt>Y</tt>=enabled, <tt>N</tt>=disabled
+
| Etat de l’utilisateur&mdash;<tt>O</tt>=activé, <tt>N</tt>=désactivé
 
|-
 
|-
−
| Folder
+
| Dossier
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| Folder and path to the root folder ('''Persons''') where the User/Agent will be created; for example, <tt>Company/Department/Team</tt>
+
| Dossier et chemin d'accès au dossier racine ('''Personnes''') où l'utilisateur/agent sera créé, par exemple, <tt>Société/Service/Equipe</tt>
 
|}
 
|}
−
 
−
===Relational Columns===
 
−
In addition to properties and folders, each row may contain relations between the User/Agent to other configuration objects, in particular '''Switches''', '''Agent Groups''', '''Skills''' and '''Access Groups'''. Every instance of a Switch, Agent Group, Access Group or Skill object will have a separate column in the source file. For example, if there are 10 Agent Groups, 1 Switch, 15 Skills and 4 Access Groups, there will be 30 additional columns in the source file, each one representing each configuration object. All relational columns are optional.
 
  
−
Each header for a relational column consists of the object type and the object name, which will form a unique column name. So, for example, there cannot be two Skills which have the same name, but a Skill object may have the same name as some Switch object.
+
{{#anc:Relational Columns}}
 +
===Colonnes relationnelles===
 +
En plus des propriétés et des dossiers, chaque ligne peut contenir des relations entre l'utilisateur/agent et les autres objets de configuration, en particulier '''Autocommutateurs''', '''Groupes d'agents''', '''Compétences''' et '''Groupes d'accès'''. Chaque instance d'un objet Autocommutateur, Groupe d'agents, Groupe d'accès ou Compétence possède une colonne distincte dans le fichier source. Par exemple, s'il existe 10 groupes d'agents, 1 autocommutateur, 15 compétences et 4 groupes d'accès, le fichier source comportera 30 colonnes supplémentaires, chacune représentant un objet de configuration. Toutes les colonnes relationnelles sont facultatives.
 +
 
 +
L'en-tête de chaque colonne relationnelle comporte le type et le nom de l'objet, ce qui produit un nom de colonne unique. Par exemple, deux compétences ne peuvent pas avoir le même nom, mais un objet Compétence peut avoir le même nom qu'un objet Autocommutateur.
  
−
Naming and value rules of relational columns are given in the following table:
+
Les règles de valeur et de dénomination des colonnes relationnelles sont fournies dans le tableau suivant :
 
{|
 
{|
 
! '''Type'''
 
! '''Type'''
−
! '''Column Name'''
+
! '''Nom colonne'''
−
! '''Valid Values'''
+
! '''Valeurs valides'''
−
|+ '''Relational Columns'''
+
|+ '''Colonnes relationnelles'''
−
|-
 
−
| Switch
 
−
| Switch:<switch name>
 
−
| <tt>Y</tt> – Create an Agent Login for this Agent on this Switch<br><tt>N</tt> – Remove the Agent Login for this Agent from this Switch<br><tt><empty></tt> - No action
 
 
|-
 
|-
−
| Agent Group
+
| Autocommutateur
−
| AgentG:<agent group name>
+
| Autocommutateur :<switch name>
−
| <tt>Y</tt> – Add this Agent to this Agent Group<br><tt>N</tt> – Remove this Agent from this Agent Group<br><tt><empty></tt> - No action
+
| <tt>O</tt> – Créer un nom de connexion pour cet agent sur cet autocommutateur<br><tt>N</tt> – Supprimer le nom de connexion de cet agent sur cet autocommutateur<br><tt><empty></tt> - Pas d'action
 
|-
 
|-
−
| Access Group
+
| Groupe d'agents
−
| AccessG:<access group name>
+
| GAgents :<agent group name>
−
| <tt>Y</tt> – Add this User/Agent to this Access Group<br><tt>N</tt> – Remove this User/Agent from this Access Group<br><tt><empty></tt> - No action
+
| <tt>O</tt> – Ajouter cet agent à ce groupe d'agents<br><tt>N</tt> – Supprimer cet agent de ce groupe d'agents<br><tt><empty></tt> - Pas d'action
−
{{NoteFormat|The [[Preferences#defAcG|Default Access Group]] specified in System Preferences does not apply when using bulk uploads, since the Access Group for the Agent is specified in the CSV file.}}
 
 
|-
 
|-
−
| Skill
+
| Groupe d'accès
−
| Skill:<skill name>
+
| GAccès :<access group name>
−
| <tt><number></tt> - Assign this Skill to this Agent with this Skill Level<br><tt>N</tt> – Remove this Skill from this Agent<br><tt><empty></tt> - No action
+
| <tt>O</tt> – Ajouter cet utilisateur/agent à ce groupe d'accès<br><tt>N</tt> – Supprimer cet utilisateur/agent de ce groupe d'agents<br><tt><empty></tt> - Pas d'action
 +
{{NoteFormat|Le [[Preferences#defAcG|groupe d'accès par défaut]] spécifié dans Préférences système ne s'applique pas lors de l'utilisation des téléchargements en masse, car le groupe d'accès de l'agent est spécifié dans le fichier CSV.}}
 +
|-
 +
| Compétence
 +
| Compétence :<skill name>
 +
| <tt><number></tt> - Attribuer cette compétence à cet agent avec ce niveau de compétence<br><tt>N</tt> – Supprimer cette compétence de cet agent<br><tt><empty></tt> - Pas d'action
 
|}
 
|}
 
</toggledisplay>
 
</toggledisplay>
  
−
When uploading the file, GAX automatically add a new column at the first of every record, and with a column header of Action. For each record, it assigns one of the following values:
+
Lors du téléchargement du fichier, GAX ajoute automatiquement une nouvelle colonne avec l'en-tête Action au début de chaque enregistrement. Pour chaque enregistrement, il attribue l’une des valeurs suivantes :
−
* <tt>ADD</tt> - The Agent is added.
+
* <tt>AJOUT</tt> - L'agent est ajouté.
−
* <tt>UPDATE</tt> - The existing Agent is modified according to modified properties or relations in the file.
+
* <tt>MISE A JOUR</tt> - L'agent existant est modifié en fonction des relations ou des propriétés modifiées dans le fichier.
  
 
{{AnchorDiv|eg}}
 
{{AnchorDiv|eg}}
−
==Example==
+
{{#anc:Example}}
−
The following data is to be uploaded to GAX to create three Agents:
+
==Exemple==
−
<toggledisplay linkstyle font-size:larger showtext="[+] Show data" hidetext="[-] Hide data">
+
Les données suivantes doivent être téléchargées dans GAX pour créer trois agents :
 +
<toggledisplay linkstyle font-size:larger showtext="[+] Afficher les données" hidetext="[-] Masquer les données">
 
{|
 
{|
−
! First Name
+
! Prénom
−
! Last Name
+
! Nom
−
! Employee Id
+
! ID employé
−
! Username
+
! Nom d'utilisateur
−
! Is Agent
+
! Agent
−
! External Id
+
! Identifiant externe
−
! Extension
+
! Extension
−
! Skill:English
+
! Compétence : Anglais
−
! Switch: San Fran
+
! Autocommutateur : San Francisco
−
! Switch: London
+
! Autocommutateur : Londres
−
! AgentG:Good
+
! GAgents : Bien
−
! AccessG: Super
+
! GAccès : Super
−
! Action
+
! Action
−
! Folder
+
! Dossier
 
|-
 
|-
−
| Sarah
+
| Sarah
−
| Lee
+
| Lee
−
| 223344
+
| 223344
−
| sarahl@acme.com
+
| sarahl@acme.com
 
| N
 
| N
 
|
 
|
Ligne 152 : Ligne 156 :
 
|
 
|
 
|
 
|
−
| Y
+
| O
−
| ADD
+
| AJOUT
−
| Acme/Branch/Team 1
+
| Acme/Succursale/Equipe 1
 
|-
 
|-
−
| John
+
| John
−
| Doyle
+
| Doyle
−
| 223465
+
| 223465
−
| johnd@acme.com
+
| johnd@acme.com
−
| Y
+
| O
 
|
 
|
−
| 2233
+
| 2233
−
| 1
+
| 1
−
| Y
+
| O
−
| N
+
| N
−
| Y
+
| O
 
|
 
|
−
| ADD
+
| AJOUT
−
| Acme/Branch/Team 2
+
| Acme/Succursale/Equipe 2
 
|-
 
|-
 
| Robert
 
| Robert
 
| Cook
 
| Cook
 
| 244456
 
| 244456
−
| bobc@acme.com
+
| bobc@acme.com
−
| Y
+
| O
−
|  
+
|
−
| 2356
+
| 2356
−
| 5
+
| 5
−
| Y
+
| O
 +
|
 +
| O
 
|
 
|
−
| Y
+
| AJOUT
−
|
+
| Acme/Succursale/Equipe 3
−
| ADD
 
−
| Acme/Branch/Team 3
 
 
|}
 
|}
 
</toggledisplay>
 
</toggledisplay>
  
 
{{AnchorDiv|csv}}
 
{{AnchorDiv|csv}}
−
The contents of the CSV file for this data looks like this:
+
Le contenu du fichier CSV pour ces données ressemble à ceci :
 
<source lang="text">
 
<source lang="text">
 
Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,Y,ADD,Acme/Branch/Team 1
 
Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,Y,ADD,Acme/Branch/Team 1

Version du mai 24, 2017 à 12:00

Fichier CSV

GAX utilise des fichiers de valeurs séparées par des virgules (CSV) pour l'importation et l'exportation de mises à jour en masse pour les agents. Cette section décrit le format du fichier CSV et fournit quelques exemples.

Format de fichier

Le fichier source est un fichier texte au format CSV (valeurs séparées par des virgules).

Dans le fichier source, chaque ligne représente un utilisateur ou un agent unique. Un même utilisateur ou agent ne peut apparaître qu'une seule fois dans le fichier source. L'identificateur unique de l'utilisateur dans le fichier source est le contenu du champ Nom d'utilisateur.

Les colonnes du fichier sont les propriétés de l'utilisateur ou de l'agent. La première ligne du fichier comporte des noms de colonne permettant d'identifier les champs. L'ordre des colonnes n'a pas d'importance. Une virgule est insérée après chaque valeur ou en-tête de colonne ou, si la colonne ne comporte pas de valeur, immédiatement après la virgule précédente. En fonction des préférences de l'utilisateur et/ou de l'objectif du fichier, une colonne facultative peut être ignorée dans le fichier source.

Le fichier source contient les propriétés suivantes pour chaque utilisateur/agent :

[+] Afficher les propriétés

Lors du téléchargement du fichier, GAX ajoute automatiquement une nouvelle colonne avec l'en-tête Action au début de chaque enregistrement. Pour chaque enregistrement, il attribue l’une des valeurs suivantes :

  • AJOUT - L'agent est ajouté.
  • MISE A JOUR - L'agent existant est modifié en fonction des relations ou des propriétés modifiées dans le fichier.

Exemple

Les données suivantes doivent être téléchargées dans GAX pour créer trois agents :

[+] Afficher les données

Le contenu du fichier CSV pour ces données ressemble à ceci : 

Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,Y,ADD,Acme/Branch/Team 1
John,Doyle,223465,johnd@acme.com,Y,,2233,1,Y,N,Y,,ADD,Acme/Branch/Team 2
Robert,Cook,244456,bobc@acme.com,Y,,2356,5,Y,,Y,,ADD,Acme/Branch/Team 3
Comments or questions about this documentation? Contact us for support!