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.
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 :
| Nom
|
Type
|
Obligatoire
|
Description
|
Structure du fichier d'importation CSV
| 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 :
| Type
|
Nom colonne
|
Valeurs valides
|
Colonnes relationnelles
| 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
|
Les données suivantes doivent être téléchargées dans GAX pour créer trois agents :
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
