(Update with the copy of version: 8.5.2Draft)
 
m (1 révision importée)
 
(5 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
−
=CSV File=
+
=Fichier CSV=
−
__TOC__
+
{{#anc:CSV File}}
  
−
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==
 +
{{NoteFormat|Bien qu’ils semblent similaires, le fichier CSV du module Agents et celui de Configuration Manager ne sont pas compatibles. Ne les utilisez pas de manière interchangeable.}}
  
−
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.
+
Le fichier source est un fichier texte au format CSV (valeurs séparées par des virgules).
  
−
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
+
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 source file contains the following properties for each user/agent:
+
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.
−
<toggledisplay linkstyle font-size:larger showtext="[+] Show properties" hidetext="[-] Hide properties">
+
 
 +
Le fichier source contient les propriétés suivantes pour chaque utilisateur/agent :
 +
<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).
 +
 
 +
Cette colonne est ajoutée automatiquement par GAX lorsqu’un fichier est exporté, avec une valeur UPDATE pour tous les enregistrements qu’il contient. Si vous créez le fichier source de toutes pièces, vous devez ajouter cette colonne manuellement. Dans les deux cas, ce champ est obligatoire et vous devez indiquer une valeur pour chaque enregistrement.
 
|-
 
|-
−
| First Name
+
| Prénom
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The first name of the User/Agent
+
| Prénom de l'utilisateur/agent
 
|-
 
|-
−
| Last Name
+
| Nom
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The last name of the User/Agent
+
| Nom de l'utilisateur/agent
 
|-
 
|-
−
| Employee Id
+
| ID employé
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The employee identifier of the User/Agent
+
| Identifiant employé de l’utilisateur/agent
 
|-
 
|-
−
| Username
+
| Nom d'utilisateur
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The username of the User/Agent
+
| Nom d’utilisateur de l'utilisateur/agent
 
|-
 
|-
−
| Password
+
| Mot de passe
−
| String
+
| Chaîne
−
| No
+
| Non
−
| The password to be used with Username
+
| Mot de passe à utiliser avec le nom d’utilisateur
 
|-
 
|-
−
| Password change
+
| Modification du mot de passe
−
| Boolean (<tt>Y</tt> or <tt>N</tt>)
+
| Booléen (<tt>O</tt> ou <tt>N</tt>)
−
| No
+
| Non
−
| Does the User/Agent need to update his or her password when he or she next logs on?
+
| L’utilisateur/agent doit-il mettre à jour son mot de passe lors de la prochaine connexion ?
 
|-  
 
|-  
−
| Is Agent
+
| Agent
−
| Boolean
+
| Booléen
−
| Yes
+
| Oui
−
| Determines if the record represents a user or an agent; script functionality differs between them.
+
| Détermine si l'enregistrement représente un utilisateur ou un agent ; la fonction de script les différencie.
 
|-
 
|-
−
| 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===
+
{{#anc: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.
+
===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.
  
−
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.
+
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
+
| Autocommutateur
−
| Switch:<switch name>
+
| Autocommutateur :<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
+
| <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
 
|-
 
|-
−
| Agent Group
+
| Groupe d'agents
−
| AgentG:<agent group name>
+
| GAgents :<agent group 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> – 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
 
|-
 
|-
−
| Access Group
+
| Groupe d'accès
−
| AccessG:<access group name>
+
| GAccès :<access 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 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|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.}}
+
{{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.}}
 
|-
 
|-
−
| Skill
+
| Compétence
−
| Skill:<skill name>
+
| Compétence :<skill 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><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: 
+
{{AnchorDiv|eg}}
−
* <tt>ADD</tt> - The Agent is added.
 
−
* <tt>UPDATE</tt> - The existing Agent is modified according to modified properties or relations in the file.
 
  
−
===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
+
! Action
−
! Last Name
+
! Prénom
−
! Employee Id
+
! Nom
−
! Username
+
! ID employé
−
! Is Agent
+
! Nom d'utilisateur
−
! External Id
+
! Agent
 +
! 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
+
! Dossier
−
! Folder
 
 
|-
 
|-
 +
| AJOUT
 
| Sarah
 
| Sarah
 
| Lee
 
| Lee
Ligne 151 : Ligne 157 :
 
|
 
|
 
|
 
|
−
| Y
+
| O
−
| ADD
+
| Acme/Succursale/Equipe 1
−
| Acme/Branch/Team 1
 
 
|-
 
|-
 +
| AJOUT
 
| 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
+
| Acme/Succursale/Equipe 2
−
| Acme/Branch/Team 2
 
 
|-
 
|-
 +
| AJOUT
 
| Robert
 
| Robert
 
| Cook
 
| Cook
 
| 244456
 
| 244456
 
| bobc@acme.com
 
| bobc@acme.com
−
| Y  
+
| O  
 
|  
 
|  
 
| 2356
 
| 2356
 
| 5
 
| 5
−
| Y
+
| O
 
|
 
|
−
| Y
+
| O
 
|
 
|
−
| ADD
+
| Acme/Succursale/Equipe 3
−
| Acme/Branch/Team 3
 
 
|}
 
|}
 
</toggledisplay>
 
</toggledisplay>
  
−
<div id="csv"></div>
+
{{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
+
ADD,Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,Y,Acme/Branch/Team 1
−
John,Doyle,223465,johnd@acme.com,Y,,2233,1,Y,N,Y,,ADD,Acme/Branch/Team 2
+
ADD,John,Doyle,223465,johnd@acme.com,Y,,2233,1,Y,N,Y,,Acme/Branch/Team 2
−
Robert,Cook,244456,bobc@acme.com,Y,,2356,5,Y,,Y,,ADD,Acme/Branch/Team 3
+
ADD,Robert,Cook,244456,bobc@acme.com,Y,,2356,5,Y,,Y,,Acme/Branch/Team 3
 
</source>
 
</source>
  
 
[[Category:V:GA:DRAFT]]
 
[[Category:V:GA:DRAFT]]

Version actuelle datée du novembre 16, 2017 à 00: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

Important
Bien qu’ils semblent similaires, le fichier CSV du module Agents et celui de Configuration Manager ne sont pas compatibles. Ne les utilisez pas de manière interchangeable.

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

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 : 

ADD,Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,Y,Acme/Branch/Team 1
ADD,John,Doyle,223465,johnd@acme.com,Y,,2233,1,Y,N,Y,,Acme/Branch/Team 2
ADD,Robert,Cook,244456,bobc@acme.com,Y,,2356,5,Y,,Y,,Acme/Branch/Team 3
La dernière modification de cette page a été faite le novembre 16, 2017 à 00:00.
Comments or questions about this documentation? Contact us for support!