Version Comments
1.2.0 changement de l'URL, plugin_dumpentity_getcsv.php devient getcsv.php

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"https://forge.indepnet.net/projects/show/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.

Réplicat MySQL

Si vous avez configuré le réplicat MySQL dans GLPI, dumpentity se servira de cette base afin de créer les fichiers CSV. S'il n'est pas joignable, alors le plugin ne sera pas en mesure de créer les fichiers correspondants.
Cela se traduit, au niveau du client loadentity par un message "Connexion impossible".

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/getcsv.php''
  • Récupération de la liste d'une table :
    URL : ''http://nomduserveur/glpi/plugins/dumpentity/front/getcsv.php?table=nom''
  • Récupération de la liste d'une table compressée :
    URL : ''http://nomduserveur/glpi/plugins/dumpentity/front/getcsv.php?table=nom&gzip=1''

C'est ces méthodes qui sont utilisée par Loadentity

  • Récupération d'une archive .tar.gz contenant toute les tables
    URL : ''http://nomduserveur/glpi/plugins/dumpentity/front/gettgz.php''
  • Récupération d'une archive .zip contenant toute les tables
    URL : ''http://nomduserveur/glpi/plugins/dumpentity/front/getzip.php''

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).