(Update with the copy of version: 8.5.2Draft) |
(Update with the copy of version: DRAFT) |
||
Ligne 1 : | Ligne 1 : | ||
− | |||
=Importation/exportation en masse de données des agents= | =Importation/exportation en masse de données des agents= | ||
− | {{#anc: Bulk Import/Export of Agent Data }} | + | {{#anc:Bulk Import/Export of Agent Data}} |
− | |||
− | Pour créer ou modifier un grand nombre d'agents, vous devez télécharger un [[CSVFile|fichier de valeurs séparées par des virgules (CSV)]] contenant les informations nouvelles et modifiées sur les agents. | + | Pour créer ou modifier un grand nombre d'agents, vous devez télécharger un [[CSVFile|fichier de valeurs séparées par des virgules (CSV)]] contenant les informations nouvelles et modifiées sur les agents. Saisissez ou modifiez les valeurs dans les colonnes appropriées pour l'agent. Lors du téléchargement dans GAX, les agents indiqués dans le fichier sont créés ou modifiés, conformément à l'action définie dans la colonne Action. |
− | A cette fin, GAX permet de créer des modèles de feuille de calcul. Vous pouvez créer un [[ImpExp#Creating_an_Empty_Template|modèle vide]] contenant uniquement des en-têtes de colonne, mais aussi [[ImpExp#Exporting_Data|exporter les données]] d'enregistrements d'agents existants. La feuille de calcul exportée peut être modifiée puis réimportée dans GAX en vue de créer ou de mettre à jour les enregistrements d'agents. | + | A cette fin, GAX permet de créer des modèles de feuille de calcul. Vous pouvez créer un [[ImpExp#Creating_an_Empty_Template|modèle vide]] contenant uniquement des en-têtes de colonne, mais aussi [[ImpExp#Exporting_Data|exporter les données]] d'enregistrements d'agents existants. La feuille de calcul exportée peut être modifiée puis réimportée dans GAX en vue de créer ou de mettre à jour les enregistrements d'agents. |
{{NoteFormat|Il est possible de créer différents modèles en fonction de scénarios spécifiques de vos opérations.|2}} | {{NoteFormat|Il est possible de créer différents modèles en fonction de scénarios spécifiques de vos opérations.|2}} | ||
− | + | {{AnchorDiv|empty}} | |
− | {{#anc: Creating an Empty Template }} | + | {{#anc:Creating an Empty Template}} |
− | Un modèle vide contient toutes les colonnes obligatoires, plus les en-têtes que vous spécifiez. Il n'inclut pas de données | + | ==Création d’un modèle vide== |
+ | Un modèle vide contient toutes les colonnes obligatoires, plus les en-têtes que vous spécifiez. Il n'inclut pas de données—c'est à vous de les ajouter. | ||
<toggledisplay linkstyle font-size:larger showtext="[+] Afficher les étapes" hidetext="[-] Masquer les étapes"> | <toggledisplay linkstyle font-size:larger showtext="[+] Afficher les étapes" hidetext="[-] Masquer les étapes"> | ||
{{Procedure | {{Procedure | ||
|Title=Création d'un modèle vierge pour la mise à jour des agents en masse | |Title=Création d'un modèle vierge pour la mise à jour des agents en masse | ||
− | |Purpose= | + | |Purpose=créer un modèle contenant seulement des en-têtes de colonne (sans valeurs) pour télécharger en masse les données nouvelles et modifiées à propos des agents. |
|Steps=<ol> | |Steps=<ol> | ||
<li>Pour créer un modèle, cliquez sur '''Créer une feuille de calcul''' dans la fenêtre Agents ou Historique. Un sélecteur de colonnes s'ouvre. Utilisez-le pour choisir les colonnes devant figurer dans le modèle.</li> | <li>Pour créer un modèle, cliquez sur '''Créer une feuille de calcul''' dans la fenêtre Agents ou Historique. Un sélecteur de colonnes s'ouvre. Utilisez-le pour choisir les colonnes devant figurer dans le modèle.</li> | ||
Ligne 24 : | Ligne 23 : | ||
<li> Les champs obligatoires sont toujours inclus.</li> | <li> Les champs obligatoires sont toujours inclus.</li> | ||
<li> Le champ Action est toujours ajouté pour former la première colonne.</li> | <li> Le champ Action est toujours ajouté pour former la première colonne.</li> | ||
− | <li> Les objets Compétences, Groupes d'agents, Groupes d'accès et Autocommutateurs peuvent être sélectionnés en tant que colonnes. L'en-tête de colonne apparaît sous la forme <tt>[[CSVFile#File_Format|<type>:<name>]]</tt>.</li> | + | <li> Les objets Compétences, Groupes d'agents, Groupes d'accès et Autocommutateurs peuvent être sélectionnés en tant que colonnes. L'en-tête de colonne apparaît sous la forme <tt>[[CSVFile#File_Format|<type>:<name>]]</tt>.</li> |
<li> Le groupe d'agents virtuel ne peut pas être importé/exporté en masse, et son contenu ne peut pas figurer dans le tableau des groupes d'agents.</li> | <li> Le groupe d'agents virtuel ne peut pas être importé/exporté en masse, et son contenu ne peut pas figurer dans le tableau des groupes d'agents.</li> | ||
</ul></li> | </ul></li> | ||
Ligne 32 : | Ligne 31 : | ||
</toggledisplay> | </toggledisplay> | ||
+ | {{AnchorDiv|export}} | ||
+ | {{#anc:Exporting Data}} | ||
==Exportation de données== | ==Exportation de données== | ||
− | |||
GAX permet d'exporter des données à partir d'enregistrements de données existants. Si vous modifiez la feuille de calcul pour l'utiliser comme modèle, enregistrez-la au format CSV puis téléchargez-la dans GAX. | GAX permet d'exporter des données à partir d'enregistrements de données existants. Si vous modifiez la feuille de calcul pour l'utiliser comme modèle, enregistrez-la au format CSV puis téléchargez-la dans GAX. | ||
Ligne 39 : | Ligne 39 : | ||
{{Procedure | {{Procedure | ||
|Title=Exportation des données des agents à partir de GAX dans un fichier CSV | |Title=Exportation des données des agents à partir de GAX dans un fichier CSV | ||
− | |Purpose= | + | |Purpose=télécharger dans un fichier CSV les données d'un groupe d'agents sélectionné dans GAX. |
|Steps=<ol> | |Steps=<ol> | ||
− | <li> Dans la liste | + | <li> Dans la liste Agents, sélectionnez les agents pour lesquels vous souhaitez exporter les données.</li> |
− | <li> Cliquez sur '''Exporter'''. | + | <li> Cliquez sur '''Exporter'''. |
− | <li> Le sélecteur de colonnes présélectionne les champs associés à l'agent sélectionné. Par exemple, les groupes d'agents, groupes d'accès, compétences et autocommutateurs correspondant aux | + | <li> Le sélecteur de colonnes présélectionne les champs associés à l'agent sélectionné. Par exemple, les groupes d'agents, groupes d'accès, compétences et autocommutateurs correspondant aux Agents que vous avez choisis sont présélectionnés. Sélectionnez autant de champs que nécessaire ou désélectionnez ceux dont l'exportation n'est pas nécessaire.</li> |
<li> Cliquez sur '''Exporter'''. GAX génère et télécharge une feuille de calcul appelée '''<logged-in user>_feuille_de_calcul_<datestamp>.csv''' contenant les données que vous avez sélectionnées pour l'exportation.</li> | <li> Cliquez sur '''Exporter'''. GAX génère et télécharge une feuille de calcul appelée '''<logged-in user>_feuille_de_calcul_<datestamp>.csv''' contenant les données que vous avez sélectionnées pour l'exportation.</li> | ||
</ol> | </ol> | ||
Ligne 49 : | Ligne 49 : | ||
</toggledisplay> | </toggledisplay> | ||
− | + | {{AnchorDiv|upload}} | |
− | {{#anc: Uploading a File }} | + | {{#anc:Uploading a File}} |
+ | ==Téléchargement d’un fichier== | ||
Avant de télécharger les mises à jour en masse, vous devez entrer les données dans une feuille de calcul et enregistrer cette dernière au format CSV. Vous pouvez utiliser l'une ou l'autre des méthodes suivantes : | Avant de télécharger les mises à jour en masse, vous devez entrer les données dans une feuille de calcul et enregistrer cette dernière au format CSV. Vous pouvez utiliser l'une ou l'autre des méthodes suivantes : | ||
* [[ImpExp#Creating_an_Empty_Template|Créer un modèle vide]] et renseigner les valeurs appropriées — Il s'agit probablement du moyen à privilégier si la plupart de vos mises à jour ajoutent de nouveaux agents. | * [[ImpExp#Creating_an_Empty_Template|Créer un modèle vide]] et renseigner les valeurs appropriées — Il s'agit probablement du moyen à privilégier si la plupart de vos mises à jour ajoutent de nouveaux agents. | ||
* [[ImpExp#Exporting_Data|Exporter les données existantes]] et apporter les ajouts et modifications nécessaires — Il s'agit probablement du moyen à privilégier si vous effectuez surtout des changements dans les données des agents existants. Vous pouvez exporter les informations de ces seuls agents, ce qui vous évite de remplir les données obligatoires les concernant. | * [[ImpExp#Exporting_Data|Exporter les données existantes]] et apporter les ajouts et modifications nécessaires — Il s'agit probablement du moyen à privilégier si vous effectuez surtout des changements dans les données des agents existants. Vous pouvez exporter les informations de ces seuls agents, ce qui vous évite de remplir les données obligatoires les concernant. | ||
− | Un exemple de feuille de calcul préparée et de fichier CSV est fourni [[CSVFile# | + | Un exemple de feuille de calcul préparée et de fichier CSV est fourni [[CSVFile#eg|ici]]. |
− | A présent, vous pouvez continuer et télécharger les données dans GAX. | + | A présent, vous pouvez continuer et télécharger les données dans GAX. |
<toggledisplay linkstyle font-size:larger showtext="[+] Afficher les étapes" hidetext="[-] Masquer les étapes"> | <toggledisplay linkstyle font-size:larger showtext="[+] Afficher les étapes" hidetext="[-] Masquer les étapes"> | ||
{{Procedure | {{Procedure | ||
− | |Title=Téléchargement | + | |Title=Téléchargement d’un fichier CSV |
− | |Purpose= | + | |Purpose=télécharger un fichier CSV dans GAX et mettre à jour en masse les informations sur les agents. |
|Steps=<ol> | |Steps=<ol> | ||
<li> Cliquez sur '''Importer''' dans la fenêtre Agents ou Historique.</li> | <li> Cliquez sur '''Importer''' dans la fenêtre Agents ou Historique.</li> | ||
− | <li> | + | <li> {{AnchorDiv|st2up}}Cliquez sur '''Sélectionner un fichier''' et, à l'aide de l'explorateur de fichiers, choisissez votre fichier CSV.</li> |
<li> Cliquez sur '''Télécharger la feuille de calcul'''. GAX commence à valider le fichier et affiche la progression. Vous pouvez cliquer sur '''Fermer''' pour fermer la fenêtre ou la laisser ouverte pour surveiller la progression. Même si la fenêtre est fermée, le traitement continue et peut être observé dans la [[History|fenêtre Historique]]. | <li> Cliquez sur '''Télécharger la feuille de calcul'''. GAX commence à valider le fichier et affiche la progression. Vous pouvez cliquer sur '''Fermer''' pour fermer la fenêtre ou la laisser ouverte pour surveiller la progression. Même si la fenêtre est fermée, le traitement continue et peut être observé dans la [[History|fenêtre Historique]]. | ||
<ul> | <ul> | ||
<li> Si le message '''Feuille de calcul valide''' apparaît, cliquez sur '''Continuer''' pour lancer le téléchargement.</li> | <li> Si le message '''Feuille de calcul valide''' apparaît, cliquez sur '''Continuer''' pour lancer le téléchargement.</li> | ||
− | <li> Si la boîte de dialogue affiche une ou plusieurs erreurs, ouvrez le fichier dans une nouvelle fenêtre et corrigez-les. Ensuite, répétez cette procédure à partir de l'[[ | + | <li> Si la boîte de dialogue affiche une ou plusieurs erreurs, ouvrez le fichier dans une nouvelle fenêtre et corrigez-les. Ensuite, répétez cette procédure à partir de l'[[ImpExp#st2up|étape 2]].</li> |
</ul></li> | </ul></li> | ||
− | <li>GAX commence à traiter les enregistrements et affiche la progression. Si nécessaire, vous pouvez à tout moment : | + | <li>GAX commence à traiter les enregistrements et affiche la progression. Si nécessaire, vous pouvez à tout moment : |
<ul> | <ul> | ||
<li> Cliquer sur '''Fermer la fenêtre'''. Le traitement continue et peut être observé dans la [[History|fenêtre Historique]].</li> | <li> Cliquer sur '''Fermer la fenêtre'''. Le traitement continue et peut être observé dans la [[History|fenêtre Historique]].</li> | ||
− | <li> Cliquer sur '''Arrêter l'opération''', puis sur '''Oui, arrêter l'opération''' pour confirmer. Lorsque le traitement s'arrête, vous revenez à la liste des agents.</li> | + | <li> Cliquer sur '''Arrêter l'opération''', puis sur '''Oui, arrêter l'opération''' pour confirmer votre choix. Lorsque le traitement s'arrête, vous revenez à la liste des agents.</li> |
</ul></li> | </ul></li> | ||
<li> Si vous n'avez pas arrêté le téléchargement, GAX affiche '''Opération terminée''' après le traitement des enregistrements. Il affiche également un résumé des résultats, en l'occurrence le nombre d'enregistrements créés et/ou mis à jour ainsi que le nombre d'enregistrements qui n'ont pas été créés ou mis à jour à cause d'une erreur. Cliquez sur '''Fermer la fenêtre''' pour revenir à la liste des agents.</li> | <li> Si vous n'avez pas arrêté le téléchargement, GAX affiche '''Opération terminée''' après le traitement des enregistrements. Il affiche également un résumé des résultats, en l'occurrence le nombre d'enregistrements créés et/ou mis à jour ainsi que le nombre d'enregistrements qui n'ont pas été créés ou mis à jour à cause d'une erreur. Cliquez sur '''Fermer la fenêtre''' pour revenir à la liste des agents.</li> | ||
Ligne 81 : | Ligne 82 : | ||
</toggledisplay> | </toggledisplay> | ||
+ | {{#anc:Script Actions}} | ||
==Actions de script== | ==Actions de script== | ||
− | |||
+ | {{#anc:For new users:}} | ||
====Pour les nouveaux utilisateurs :==== | ====Pour les nouveaux utilisateurs :==== | ||
− | |||
<ol> | <ol> | ||
− | <li> Créez une | + | <li> Créez une personne avec des propriétés définies dans le dossier spécifié.</li> |
<li> Associez la nouvelle personne aux groupes d'accès spécifiés.</li> | <li> Associez la nouvelle personne aux groupes d'accès spécifiés.</li> | ||
<li> Associez la nouvelle personne aux groupes d'agents spécifiés.</li> | <li> Associez la nouvelle personne aux groupes d'agents spécifiés.</li> | ||
Ligne 93 : | Ligne 94 : | ||
<li> Pour les agents, procédez comme suit : | <li> Pour les agents, procédez comme suit : | ||
<ul> | <ul> | ||
− | <li> Si le champ Extension n'est pas renseigné, créez et associez les | + | <li> Si le champ Extension n'est pas renseigné, créez et associez les Noms de connexion des agents pour tous les Autocommutateurs spécifiés avec le Code de connexion équivalant au Nom d'utilisateur de l'Agent. Les noms de connexion des agents sont créés dans le dossier des Noms de connexion des agents d'autocommutateurs avec la même hiérarchie de dossiers que celle spécifiée pour l'objet Personne dans la propriété Dossier.</li> |
− | <li> Si le champ Extension est renseigné, une | + | <li> Si le champ Extension est renseigné, une place est créée avec un nom équivalent au nom d'utilisateur de l'agent. Les DN d'extension sont créés avec le numéro correspondant au champ Extension sur tous les autocommutateurs spécifiés. Les noms de connexion des agents sont créés et associés à tous les autocommutateurs spécifiés possédant un code de connexion équivalent à la valeur du champ Extension. Tous les objets sont créés sous leur dossier racine en utilisant la même hiérarchie de dossiers que celle spécifiée pour l'objet Personne dans la propriété Dossier.</li> |
</ul></li> | </ul></li> | ||
</ol> | </ol> | ||
+ | {{#anc:For existing users:}} | ||
====Pour les utilisateurs existant :==== | ====Pour les utilisateurs existant :==== | ||
− | |||
# Les champs Nom d'utilisateur et Agent doivent être renseignés dans le fichier d'entrée identifiant la personne. | # Les champs Nom d'utilisateur et Agent doivent être renseignés dans le fichier d'entrée identifiant la personne. | ||
# Les autres champs sont facultatifs. | # Les autres champs sont facultatifs. |
Version du mai 25, 2017 à 22:16
Sommaire
Importation/exportation en masse de données des agents
Pour créer ou modifier un grand nombre d'agents, vous devez télécharger un fichier de valeurs séparées par des virgules (CSV) contenant les informations nouvelles et modifiées sur les agents. Saisissez ou modifiez les valeurs dans les colonnes appropriées pour l'agent. Lors du téléchargement dans GAX, les agents indiqués dans le fichier sont créés ou modifiés, conformément à l'action définie dans la colonne Action.
A cette fin, GAX permet de créer des modèles de feuille de calcul. Vous pouvez créer un modèle vide contenant uniquement des en-têtes de colonne, mais aussi exporter les données d'enregistrements d'agents existants. La feuille de calcul exportée peut être modifiée puis réimportée dans GAX en vue de créer ou de mettre à jour les enregistrements d'agents.
Création d’un modèle vide
Un modèle vide contient toutes les colonnes obligatoires, plus les en-têtes que vous spécifiez. Il n'inclut pas de données—c'est à vous de les ajouter.
Exportation de données
GAX permet d'exporter des données à partir d'enregistrements de données existants. Si vous modifiez la feuille de calcul pour l'utiliser comme modèle, enregistrez-la au format CSV puis téléchargez-la dans GAX.
Téléchargement d’un fichier
Avant de télécharger les mises à jour en masse, vous devez entrer les données dans une feuille de calcul et enregistrer cette dernière au format CSV. Vous pouvez utiliser l'une ou l'autre des méthodes suivantes :
- Créer un modèle vide et renseigner les valeurs appropriées — Il s'agit probablement du moyen à privilégier si la plupart de vos mises à jour ajoutent de nouveaux agents.
- Exporter les données existantes et apporter les ajouts et modifications nécessaires — Il s'agit probablement du moyen à privilégier si vous effectuez surtout des changements dans les données des agents existants. Vous pouvez exporter les informations de ces seuls agents, ce qui vous évite de remplir les données obligatoires les concernant.
Un exemple de feuille de calcul préparée et de fichier CSV est fourni ici.
A présent, vous pouvez continuer et télécharger les données dans GAX.
Actions de script
Pour les nouveaux utilisateurs :
- Créez une personne avec des propriétés définies dans le dossier spécifié.
- Associez la nouvelle personne aux groupes d'accès spécifiés.
- Associez la nouvelle personne aux groupes d'agents spécifiés.
- Pour les agents, ajoutez les compétences spécifiées.
- Pour les agents, procédez comme suit :
- Si le champ Extension n'est pas renseigné, créez et associez les Noms de connexion des agents pour tous les Autocommutateurs spécifiés avec le Code de connexion équivalant au Nom d'utilisateur de l'Agent. Les noms de connexion des agents sont créés dans le dossier des Noms de connexion des agents d'autocommutateurs avec la même hiérarchie de dossiers que celle spécifiée pour l'objet Personne dans la propriété Dossier.
- Si le champ Extension est renseigné, une place est créée avec un nom équivalent au nom d'utilisateur de l'agent. Les DN d'extension sont créés avec le numéro correspondant au champ Extension sur tous les autocommutateurs spécifiés. Les noms de connexion des agents sont créés et associés à tous les autocommutateurs spécifiés possédant un code de connexion équivalent à la valeur du champ Extension. Tous les objets sont créés sous leur dossier racine en utilisant la même hiérarchie de dossiers que celle spécifiée pour l'objet Personne dans la propriété Dossier.
Pour les utilisateurs existant :
- Les champs Nom d'utilisateur et Agent doivent être renseignés dans le fichier d'entrée identifiant la personne.
- Les autres champs sont facultatifs.
- Si un champ facultatif est défini, sa valeur est comparée à la valeur existante et, si elle est différente, le champ est mis à jour pour cette personne.