Documentation:GA:user:CSVFile:8.5.2

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'identifiant 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

Structure du fichier d'importation CSV

Nom	Type	Obligatoire ?	Description
Action	AJOUT, MISE A JOUR	Oui	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
Nom	Chaîne	Oui	Nom de l'utilisateur/agent
ID employé	Chaîne	Oui	Identifiant employé de l'utilisateur/agent
Nom d'utilisateur	Chaîne	Oui	Nom d'utilisateur de l'utilisateur/agent
Mot de passe	Chaîne	Non	Mot de passe à utiliser avec le nom d'utilisateur
Modification du mot de passe	Booléen (O ou N)	Non	L'utilisateur/agent doit-il mettre à jour son mot de passe lors de la prochaine connexion ?
Agent	Booléen	Oui	Détermine si l'enregistrement représente un utilisateur ou un agent ; la fonction de script les différencie.
ID externe	Chaîne	Non	Identifiant externe
Adresse e-mail	Chaîne	Non	Adresse e-mail de l'utilisateur/agent, normalement identique au nom d'utilisateur.
Extension	chaîne numérique	Non	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.
Activé	Booléen	Non	Etat de l'utilisateur — O=activé, N=désactivé
Dossier	Chaîne	Oui	Dossier et chemin d'accès au dossier racine (Personnes) où l'utilisateur/agent sera créé, par exemple, Société/Service/Equipe

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.

Les règles de valeur et de dénomination des colonnes relationnelles sont fournies dans le tableau suivant :

Colonnes relationnelles

Type	Nom de colonne	Valeurs valides
Autocommutateur	Autocommutateur :<switch name>	O – Créer un nom de connexion pour cet agent sur cet autocommutateur N – Supprimer le nom de connexion de cet agent sur cet autocommutateur <empty> - Pas d'action
Groupe d'agents	GAgents :<agent group name>	O – Ajouter cet agent à ce groupe d'agents N – Supprimer cet agent de ce groupe d'agents <empty> - Pas d'action
Groupe d'accès	GAccès :<access group name>	O – Ajouter cet utilisateur/agent à ce groupe d'accès N – Supprimer cet utilisateur/agent de ce groupe d'accès <empty> - Pas d'action Important Le 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>	<number> - Attribuer cette compétence à cet agent avec ce niveau de compétence N – Supprimer cette compétence de cet agent <empty> - Pas d'action

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 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

Prénom	Nom	ID employé	Nom d'utilisateur	Agent	ID externe	Extension	Compétence : Anglais	Autocommutateur : San Francisco	Autocommutateur : Londres	GAgents : Bien	GAccès : Super	Action	Dossier
Sarah	Lee	223344	sarahl@acme.com	N							O	AJOUT	Acme/Succursale/Equipe 1
John	Doyle	223465	johnd@acme.com	O		2233	1	O	N	O		AJOUT	Acme/Succursale/Equipe 2
Robert	Cook	244456	bobc@acme.com	O		2356	5	O		O		AJOUT	Acme/Succursale/Equipe 3

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

Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,O,AJOUT,Acme/Succursale/Equipe 1
John,Doyle,223465,johnd@acme.com,O,,2233,1,O,N,O,,AJOUT,Acme/Succursale/Equipe 2
Robert,Cook,244456,bobc@acme.com,O,,2356,5,O,,O,,AJOUT,Acme/Succursale/Equipe 3