Fichier CSV

GAX utilise des fichiers de valeurs séparées par des virgules (CSV) pour l’import\export des mises à jour en masse aux Agents. Cette section décrit le format des fichiers CSV et propose quelques exemples :

Format de fichier

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

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

Les colonnes du fichier représentent les propriétés d'un utilisateur ou agent. La première ligne du fichier contient les noms des colonnes, qui permettent d'identifier les champs. L'ordre des colonnes n'a pas d'importance. Une virgule est insérée après chaque colonne ou valeur, ou immédiatement après la virgule précédente si la colonne ne contient pas de valeur. Toute colonne non obligatoire peut être omise dans le fichier source, selon la préférence de l’utilisateur et/ou du but du fichier

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

[+] Afficher les propriétés

Structure du fichier importation CSV

Nom :	Type	Obligatoire?	Description
Action	AJOUT, MISE À JOUR	Oui	Spécifie l’action à prendre avec ces données de l’agent, soit créer un nouvel agent (ADD) ou modifier l’agent existant (mise à jour).
Prénom	Chaîne	Oui	Le prénom de l’utilisateur/agent
Nom	Chaîne	Oui	Le nom de l’utilisateur/agent
ID employé	Chaîne	Oui	L’identificateur d’employé de l’utilisateur/agent
Nom d’utilisateur	Chaîne	Oui	Le nom d’utilisateur de l’utilisateur/agent
Mot de passe	Chaîne	Non	Le mot de passe à utiliser avec le nom d’utilisateur
Changement de mot de passe	Booléen (O ou N)	Non	L’utilisateur ou le mandataire doit-il mettre à jour son mot de passe lorsqu’il ou elle se connecte par la suite ?
Est un agent	Booléen	Oui	Détermine si le dossier représente un utilisateur ou un agent; les fonctionnalités de script diffèrent entre eux.
ID externe	Chaîne	Non	Un identificateur externe
Adresse courriel	Chaîne	Non	Adresse de messagerie de l’utilisateur ou du mandataire ; normalement, c’est la même que le nom d’utilisateur.
Extension	chaîne numérique	Non	L’extension par défaut de l’Agent. S'il y a un poste, la création de places par défaut est enclenchée.
Activé	Booléen	Non	L’état 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, équipe/société/Ministère

Colonnes relationnelles

En plus des propriétés et des dossiers, chaque ligne peut contenir des relations entre l’agent/utilisateur et d’autres objets de configuration, en particulier les autocommutateurs, les groupes d’agents, les compétences et les groupes d’accès. Chaque relation avec un objet Autocommutateur, Groupe d'agents, Groupe d'accès ou Compétence disposera d'une colonne séparée dans le fichier source. S'il y a, par exemple, 10 groupes d'agents, 1 autocommutateur, 15 compétences et 4 groupes d'accès, il y aura 30 colonnes supplémentaires dans le fichier source, chacune représentant un objet de configuration. Toutes les colonnes de relations sont facultatives.

Chaque en-tête de colonne de relations est composé du type d'objet et du nom de l'objet, formant ainsi un nom de colonne unique. Il ne peut donc pas y avoir deux compétences avec le même nom, mais un objet Compétence peut avoir le même nom qu'un objet Autocommutateur.

Les règles d'appellation et de valeurs des colonnes de relations sont énumérées dans le tableau ci-après :

Colonnes relationnelles

Type	Nom de colonne	Valeurs valides
Autocommutateur	Autocommutateur :<switch name>	O – créer un Nom de connexion de l’agent pour cet agent sur cet autocommutateur N – supprimer la connexion de l’agent pour cet agent de cet autocommutateur <empty> - Aucune action
Groupe d'agents	Groupe d’agents :<agent group name>	O – ajouter cet agent à ce groupe d’agents N – supprimer cet agent de ce groupe d’agents <empty> - aucune action
Groupe d'accès	Groupe d’accè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> - aucune action Important Le groupe d’accès par défaut spécifié dans les préférences système ne s’applique pas lors des téléchargements en masse, étant donné que le groupe d’accès pour l’agent est spécifié dans le fichier CSV.
Compétence	Compétence :<skill name>	<number>- Assigner cette Compétence à cet agent avec ce Niveau de compétence N – enlever cette Compétence à cet agent <empty> -aucune action

Lors du téléchargement du fichier, GAX ajouter automatiquement une nouvelle colonne à la première de tous les records et avec un en-tête de colonne d’Action. Pour chaque enregistrement, il attribue l'une des valeurs suivantes :

• AJOUTER – L'agent est ajouté.
• METTRE À JOUR – L'agent existant est modifié en fonction des propriétés ou des relations modifiées dans le fichier.

Exemple

Les données suivantes doivent être transférées à GAX pour créer trois Agents :

[+] Afficher les données

Prénom	Nom	ID employé	Nom d’utilisateur	Est un agent	ID externe	Extension	Compétences : anglais	Autocommutateur : San Francisco	Autocommutateur : Londres	Groupe d’agents : Bon	Groupe d'accès : Super	Action	Dossier
Sarah	Lee	223344	sarahl@acme.com	N							O	AJOUTER	Acme/branche/Équipe 1
John	Doyle	223465	johnd@acme.com	O		2233	1	O	N	O		AJOUTER	Acme/branche/Équipe 2
Robert	Cook	244456	bobc@acme.com	O		2356	5	O		O		AJOUTER	Acme/branche/Équipe 3

Le contenu du fichier CSV pour cette 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