Documentation:GA:user:CSVFile:DRAFT

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

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). 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.
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.
Identifiant 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 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'agents <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

Exemple

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

[+] Afficher les données

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

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