8.6 Exportation XML des comptes

3.2.21 Les formats d'exportation des comptes suivent les mêmes schémas que ceux de l'importation XML.

Les fichiers produits par l'exportation peuvent être réutilisés pour l'importation. Ils ne contiennent pas de données calculées exploitables par l'importation.

Exemple d'exportation : 1 utilisateur et 2 groupes

<?xml version="1.0" encoding="utf-8"?>
<accounts date="2016-04-14T14:42:15">
  <groups>
    <group id="2">
      <reference>all</reference>
      <displayName>Utilisateurs</displayName>
      <document family="IGROUP"/>
    </group>
    <group id="10">
      <reference>security</reference>
      <displayName>Surveillants</displayName>
      <parentGroups reset="false">
        <parentGroup reference="all"/>
      </parentGroups>
      <document family="IGROUP"/>
    </group>
  </groups>
  <users>
    <user id="15">
      <login>watcher</login>
      <firstname>Robert</firstname>
      <lastname>Dogue</lastname>
      <mail>watcher@example.net</mail>
      <status activated="true"/>
      <password crypted="true">$5$PsPOxUFpfkK25TY4$LjEnQaJw76duTzM9G7dq/XC9zexKgNOnxz.3virIIRD</password>
      <associatedRoles reset="false">
        <associatedRole reference="surveillant"/>
      </associatedRoles>
      <parentGroups reset="false">
        <parentGroup reference="security"/>
      </parentGroups>
      <document family="IUSER"/>
    </user>
  </users>
</accounts>

L'exportation fournie la date d'exportation sur la balise racine (attribut date). Sur chaque compte, l'identifiant numérique interne est indiqué (attribut id). Cet attribut n'est pas utilisé pour l'importation. Il est donné à titre indicatif.

8.6.1 Exportation par l'interface d'administration

L'exportation des comptes peut être réalisée depuis le centre d'administration dans la gestion des utilisateurs.

Figure 75. Options d'exportation de comptes

• Exporter avec les schémas XML (zip format)

  Inclus un répertoire XSD dans lequel tous les schémas XML nécessaires à la validation de fichiers d'importation sont présents

• Exporter les mots de passe cryptés

  Inclus la balise password avec le mot de passe crypté pour les utilisateurs (le mot de passe en clair n'est pas enregistré)

• Exporter les rôles associés

  Inclus la définitions des rôles associés pour les utilisateurs et les groupes

• Exporter les groupes des utilisateurs

  Inclus la définition des groupes d'appartenances (groupes directs et indirects)

• Exporter les données documentaires spécifiques

  Inclus la définition du document associé au compte. Les données redondantes avec les données systèmes inclus dans le document ne sont pas exportés.

L'exportation via l'interface, exporte les comptes affichés au moment de l'exportation.

8.6.2 Exportation de comptes en ligne de commande

L'exportation en ligne de commande est réalisé avec le script "exportAccounts"

./wsh.php --api=exportAccounts --help
 
Export accounts definition
Usage :
    --file=<the output file (use - for stdout)>
   Options:
    --schema-directory=<directory where produce xsd for documents>
    --memberOf=<Restrict to account which are member of this group or role reference>
    --type=<restricted to account type> [user|role|group] 
    --login-filter=<filter login contains>
    --help (Show usage) 
    --crypt-password (add crypt password) 
    --roles (export associated roles) 
    --groups (export parent groups) 
    --document (export specific document information) 

Sans aucun argument autre que le fichier, cette commande exporte l'ensemble des comptes dans le fichier XML défini en sortie.