La gestion des documents XML dans Xdepo

1) Présentation

Xdepo permet de stocker des documents XML dans une base de données qui les organise à l'aide de dossiers. Une fois les documents créés et stockés, il est possible d'effectuer différentes opérations sur ces documents, comme les supprimer, les déplacer, etc. Plusieurs de ces opérations sont également disponibles sur des dossiers. Dans ce cas elles concernent à la fois le dossier et son contenu, documents et sous-dossiers, et ce, de manière complètement récursive.

Certaines opérations peuvent s'effectuer sur plusieurs dossiers ou plusieurs documents. Pour les effectuer, on procède toujours de la même façon : on sélectionne les documents ou dossiers concernés en cochant la case à leur gauche, puis on clique sur l'icône correspondant à l'opération souhaitée. L'illustration suivante montre une opération de suppression de deux documents sélectionnés :

Pour ces opérations sur plusieurs dossiers ou plusieurs documents, l'icône à cliquer se situe toujours à droite de la mention Opération sur les documents sélectionnés ou Opération sur les dossiers sélectionnés .

Les autres opérations s'effectuent sur un seul dossier ou un seul document. Pour celles-ci, il faut cliquer sur une icône située à gauche du dossier ou de la collection.

A noter qu'aucune opération ne concerne à la fois des dossiers et des documents.

2) Suppression, corbeille

Les opérations de suppression s'effectuent toujours sur des dossiers ou documents préalablement sélectionnés. L'opération de mise à la corbeille s'effectue toujours sur des documents sélectionnés.

La suppression est définitive ; lors que vous supprimez un document ou un dossier, vous ne pourrez pas le récupérer par la suite. De plus, si vous supprimez un dossier, vous supprimez également tout son contenu, documents et sous-dossiers. Pour supprimer des dossiers ou des documents, vous les sélectionnez puis vous cliquez sur l'icône de suppression :

La mise à la corbeille d'un document est moins draconienne, puisque vous aurez l'occasion de récupérer le document ultérieurement, tant que vous n'aurez pas vidé votre corbeille. Pour mettre à la corbeille un ou des documents, vous devez d'abord les sélectionner puis cliquer sur l'icône de corbeille :

Une fois cette opération effectuée, les documents ne seront plus visibles dans le fenêtre de navigation.

Pour vider la corbeille ou restaurer des documents qu'on y trouve, vous devez naviguer jusqu'à cette corbeille. Celle-ci est toujours située à la racine, donc vous pouvez depuis n'importe quelle page cliquer sur Racine dans la zone de contexte puis ensuite sur le dossier Corbeille.

Le dossier Corbeille est très semblable aux autres dossiers. On y trouve seulement une opération supplémentaire concernant les documents sélectionnés : la restauration, comme on peut le voir dans l'illustration suivante :

On y voit le contenu de la corbeille alors que le document Yahoo!, qui était préalablement dans un autre dossier, a été mis à la corbeille. Pour restaurer ce document, il suffit de le sélectionner et de cliquer sur l'icône de restauration :

Une fois restauré, le document se retrouve dans le même dossier que lors de sa suppression.

3) Consultation

En plus de pouvoir créer, déplacer, supprimer, etc. des documents, il est bien entendu possible de consulter ces documents. Cette consultation peut se faire de deux façons, soit en visualisant la version XML brute du document, soit en consultant une version HTML.

Pour consulter la source XML du document, il suffit de cliquer sur l'icône de téléchargement située à gauche du document à consulter :

Cette opération ouvre une nouvelle fenêtre du navigateur et affiche la source XML du document. Selon le navigateur Web utilisé, il est possible que l'affichage diffère légèrement, voire que le XML ne soit pas supporté, et dans ce cas il vous sera probablement demandé de sauvegarder le fichier que vous pourrez consulter avec un autre outil.

Pour consulter le document en format HTML, dans le navigateur, il suffit de cliquer sur le lien hypertexte du titre du document, comme dans l'exemple ci-dessous :

La présentation du document en format HTML dépend en général du paramétrage effectué sur Xdepo pour le type de document dont il s'agit.

4) Modification d'un document

Un document XML dans Xdepo peut également être modifié lorsqu'il doit être mis à jour, corrigé, etc. Pour effectuer cette opération, qui ne concerne bien sûr qu'un seul document à la fois, il suffit de cliquer sur l'icône de modification ou d'édition, à gauche du document en question :

Après le clic, le formulaire associé au document sera ouvert avec les données du document déjà insérées. Vous pourrez alors modifier le document comme lors de sa création. La manipulation du formulaire dépend bien sûr de ses caractéristiques et donc du paramétrage effectué sur Xdepo.

5) Modification des informations système

Il est également possible de renommer un document et de modifier son identifiant et son type de données ou formulaire. Pour effectuer ces opérations, il suffit de cliquer sur l'icône suivante à la gauche du document à modifier :

Ensuite, un formulaire sera présenté vous permettant d'effectuer les changements :

On y voit trois informations systèmes qui peuvent être modifiés :

1. Le nom de la ressource, soit le nom de fichier virtuel utilisé pour stocker le document dans Xdepo. Vous pouvez le modifier, mais vous devez conserver la même extension.
2. L'identifiant Xdepo, qui doit être unique dans toute la base de données.
3. Le formulaire associé au document, qui sera ouvert lorsque l'on clique sur l'icône de modification du document.

Une fois les modifications effectuées, vous devez cliquer sur le bouton Envoyer .

6) Déplacement, copie

Les documents XML déjà dans Xdepo peuvent être déplacés et copiés. Le déplacement supprime le document de l'endroit où il se trouvait à l'origine. La copie le conserve. Dans les deux cas, l'opération peut s'effectuer sur plusieurs documents à la fois, en les sélectionnant d'abord. Pour les dossiers, seul le déplacement est possible, et non la copie.

Pour déplacer des documents ou des dossiers, on doit utiliser l'icône suivante :

Voici un exemple où l'on a sélectionné deux documents et où l'on s'apprête à les déplacer :

Lorsque l'on clique sur l'icône de déplacement, on obtient alors un formulaire permettant de préciser l'endroit où l'on souhaite les déplacer. Cet endroit est bien entendu un dossier existant dans la base de données. Le formulaire présente la liste des dossiers sous la forme d'un menu déroulant. Chaque entrée présente un dossier, celui-est représenté par son code et le code des dossiers parents. Voici un exemple :

Ici, c'est le dossier /docs/drafts/ qui s'apprête à être choisi. Une fois cette sélection effectuée, on valide le déplacement en cliquant sur le bouton Déplacer ou copier ces documents ou dossiers , et le déplacement s'effectuera.

Le déplacement de dossiers s'effectue exactement de la même manière. A noter toutefois que tout le contenu d'un dossier est déplacé, soit les documents et sous-dossiers qu'il contient, de manière récursive. La structure originale est donc conservée dans la nouvelle destination.

La copie de documents s'effectue exactement de la même manière que leur déplacement. On doit d'abord les sélectionner, et ensuite cliquer sur l'icône de copie :

Xdepo proposera ensuite le même formulaire pour sélectionner la destination et effectuera ensuite la copie. A noter que la copie d'un document change nécessairement son identifiant Xdepo, puisque ceux-ci doivent être uniques. Vous pourrez, si vous le souhaitez, modifier les identifiants des documents copiés en utilisant les fonctions destinées à cette opération.

7) Vérification des liens

Dans certains cas, il est intéressant de pouvoir créer des liens entre les documents XML d'une base de données. Le sens précis du lien dépend du projet ou de l'application, mais le concept générique est pertinent et Xdepo propose quelques fonctions permettant de faciliter la gestion de ces liens.

Xdepo distingue les liens qui partent d'un document des liens qui arrivent à un document. Dans le premier cas, on considère le document comme la source des liens, alors que dans le deuxième cas il constitue la cible des liens.

Il est possible de consulter tous les documents cibles des liens que l'on retrouve dans un document particulier. Supposons qu'il existe deux liens qui partent du document A vers les documents B et C. Si on clique sur l'icône des liens sortants à gauche du document A, on pourra retrouver ces deux documents B et C. L'icône des liens sortants est :

Après avoir cliqué sur cette icône, vous obtiendrez une fenêtre standard de résultats de recherche, avec les documents liés affichés, comme dans l'exemple suivant :

Il est également possible de consulter les liens qui arrivent sur un document. Ainsi, si les documents E et F ont des liens qui ont pour cible le document A, vous pouvez retrouver ces deux documents E et F en utilisant l'icône des liens entrants situé à gauche du document A :

Vous obtiendrez alors une fenêtre de résultats de recherche, exactement comme pour les liens sortants.

8) Modification des propriétaires et des permissions

Xdepo propose un système sophistiqué de gestion des droits sur les dossiers et les permissions. Les concepts liés à cette gestion des droits sont présentés dans un document distinct, nous allons nous concentrer ici sur la présentation des opérations à effectuer pour gérer ces droits.

Nous rappelons les concepts fondamentaux :

• Chaque document et chaque dossier dans une base Xdepo a un utilisateur propriétaire et un groupe propriétaire .
• Chaque document et chaque dossier dans une base Xdepo possède des permissions selon trois axes : lecture , écriture , mise à jour .
• Pour chaque document et chaque dossier dans une base Xdepo, et pour chaque axe de permission pour ce document ou ce dossier, on peut assigner des permissions à l'utilisateur propriétaire , au groupe propriétaire et aux autres .

Ainsi, il y a 11 informations de droits d'utilisation pour chaque document et chaque dossier : trois permissions pour les trois axes, ce qui en fait neuf, ainsi qu'un utilisateur propriétaire et un groupe propriétaire, pour un total de 11 informations.

Toutes ces informations peuvent être modifiées à l'aide d'un seul formulaire. Pour afficher ce formulaire, il suffit de cliquer sur l'icône des permissions située à gauche du document ou du dossier dont les permissions doivent être changées :

Lorsque vous aurez cliqué sur cette icône, vous obtiendrez le formulaire de modification des droits sur un dossier ou un document, tel celui-ci :

On constate que ce formulaire contient deux sections principales, une pour les neuf permissions et l'autre pour les utilisateurs et groupes propriétaires. Plus précisément, les informations contenues dans ce formulaire sont les suivantes :

Information sur l'objet à modifier

Cette première partie affiche le code de l'objet à modifier, soit le code des dossiers parents, du dossier en cours et, le cas échéant, du document.

Permissions accordées

Cette seconde partie indique quelles sont les permissions (et non les restrictions) accordées sur le dossier ou le document. Ainsi, dans l'exemple ci-dessus, l'utilisateur propriétaire a tous les droits (lecture, écriture, mise à jour), les membres du groupe propriétaire ont des droits de lecture et de mise à jour, et les autres utilisateurs ont également des droits de lecture et de mise à jour. Cette partie est complétée par un bouton permettant de modifier uniquement les permissions.

Propriétaires

La troisième partie indique l'utilisateur et le groupe propriétaire, à l'aide d'une liste déroulante contenant l'ensemble des utilisateurs et des groupes définis dans la base de données. Cette partie se termine par un bouton permettant de modifier les propriétaires.

Opérations générales

La dernière partie permet d'effectuer des opérations sur l'ensemble et d'indiquer le mode récursif ou non.

Depuis ce formulaire, on peut donc effectuer trois opérations :

1. Modifier les permissions uniquement, en cochant les cases souhaitées dans la seconde partie du formulaire puis en cliquant sur le bouton Modifier les permissions .
2. Modifier les propriétaires en sélectionnant un utilisateur et un groupe propriétaires dans les listes déroulantes de la troisième partie du formulaire, puis en cliquant sur le bouton Modifier les propriétaires .
3. Modifier à la fois les permissions et les propriétaires , en cochant les permissions souhaitées dans la seconde partie, en sélectionnant l'utilisateur et le groupe propriétaires dans la troisième partie, puis en cliquant sur le bouton Modifier les permissions et les propriétaires tout en bas du formulaire.

Dans tous les cas, il est possible de préciser si l'on souhaite effectuer des modifications sur l'objet en cours uniquement ou sur tout ce qu'il contient, documents et sous-dossiers, de manière récursive, dans le cas où l'on manipule les permissions et propriétaires d'un dossier. Pour préciser l'option de récursivité, cocher ou non la case située dans le bas du formulaire et indiquée par Appliquer les modifications aux sous-dossiers et aux documents . A noter que cette option de récursivité n'apparaît dans le formulaire que si vous modifiez les permissions et propriétaires d'un dossier.

Une fois l'opération effectuée, vous retournerez à une fenêtre de navigation.