Déplacé vers https://forge.indepnet.net/wiki/dumpentity/Fr_manuel
Présentation de l'extension dumpentity
Cette extension fonctionne à partir de la version 0.70 de GLPI
Cette extension permet d'exporter au format CSV les données d'une entité.
Ces données peuvent être récupérées par un utilisateur (exploitation sous tableur), ou depuis une machine distante utilisant un script, mais elle est plus particulièrement destinée à être utilisée depuis un serveur GLPI local équipé de l'extension loadentity pour récupérer les données du serveur GLPI central.
Installation
Après la décompression de l'archive dans la dossier plugin de glpi connectez-vous sur GLPI en tant qu'administrateur :
Accès : Configuration / Plugins / Export d'entité / Installation
Cette opération permet de créer les tables utilisées par l'extension.
En cas d'installation d'une nouvelle version, l'option “Mise à jour” vous sera proposée. Elle permet d'adapter les tables.
Gestion des droits
Gestion des modèles
Accès : Configuration / Plugins / Export d'entité / Gestion des modèles
Un modèle correspond à une liste de tables pouvant être exportées.
L'extension est livrée avec 2 modèles :
- Export complet : toutes les tables pouvant être exportées par l'extension
- Export minimum pour HelpDesk local : une liste très réduite
Gestion des droits par profil
Accès : Administration / Profils / onglet Export d'entité
Cette option permet de définir si le profil sélectionné peut utiliser l'extension pour exporter les données de la base. On associe un modèle à un profil. L'exportation se fera pour l'entité courante.
A noter : l'exportation manuelle n'est pas la meilleure utilisation de cette extension.
Gestion des droits par ordinateur client
Accès : Configuration / Plugins / Export d'entité / Gestion des droits par ordinateur client
Cette option permet de définir les adresses IP qui pourront accéder au téléchargement des CSV. Dans ce cas il n'y aura pas d'autre authentification que l'adresse.
On associe un modèle et une entité à une adresse.
Utilisation
N'oubliez pas d'activer le plugin avant utilisation
Accès : Configuration / Plugins / Export d'entité / Activation
Récupération interactive
Accès : Plugins / Export d'entité
Depuis l'écran de l'extension, un utilisateur habilité peut télécharger les CSV de l'entité courante.
A noter : l'exportation n'est pas récursive et ne concerne que les éléments de l'entité courante, pas des sous-entités.
En fonction des extensions, l'exportation peut être réalisée aux formats :
- .csv : une seule table
- .csv.gz : une seule table
- .zip : une archive contenant toutes les tables
- .tar.gz : une archive contenant toutes les tables
Dans le cas de la récupération sous forme d'archive, un fichier tables.csv est fournit contenant la liste des tables, leur description et la taille du csv.
Récupération distante
Accès : depuis un poste dont l'adresse IP est autorisée.
- Récupération de la liste des tables :
URL : http://nomduserveur/glpi/plugins/dumpentity/front/plugin_dumpentity.getcsv.php
- Récupération de la liste d'une table :
URL : http://nomduserveur/glpi/plugins/dumpentity/front/plugin_dumpentity.getcsv.php?table=nom
- Récupération de la liste d'une table compressée :
URL : http://nomduserveur/glpi/plugins/dumpentity/front/plugin_dumpentity.getcsv.php?table=nom&gzip=1
Cette méthode ne permet pas la récupération d'une archive.
C'est cette méthode qui est utilisée par l'extension loadentity
Astuces
Evitez que tous les clients viennent chercher en même temps les données, en particulier pendant les heures d'utilisation de GLPI.
Proposez leur de créer une tâche planifiée de récupération en leur fournissant une plage horaire (cela fera d'ailleur l'objet d'une évolution de l'extension).
Problèmes connus
- Export complet au format .zip
Cette option n'est disponible que si vous disposez de l'extension zip pour php. Cette option est inclue en standard avec php 5.2.x ou sous forme d'extension pecl pour les versions précédentes (php-pecl-zip pour Fedora/RHEL/CentOS).
Attention a utiliser la dernière version de l'extension, des problèmes on été rapportés avec les anciennes versions. Elle fonctionne correctement avec php-5.2.4 ou zip-1.8.8 (xampp 1.6.4 sous Windows).
- Export complet au format .tar.gz
Cette option n'est disponible que si vous disposez de l'extension Archive_Tar pour php. Cette option est inclue en standard avec PEAR (php-pear pour Fedora/RHEL/CentOS, xampp 1.6.4 sous Windows).