Importation et exportation de contenus avec Xdepo

Xdepo permet la création de documents à l'aide de formulaires Web. Mais il est également possible d'importer des documents produits avec d'autres outils, un à la fois ou par lots. Par ailleurs, des fonctions d'exportation sont possibles, permettant ainsi de récupérer des contenus ou tout simplement effectuer des sauvegardes. A noter également que Xdepo permet de sauvegarde une base de données compète et de la restaurer par la suite.

1) Importation de contenus

Il existe deux méthodes principales d'importation de contenus : par fichier individuel ou par lots. L'importation de fichiers individuels est possible à tout utilisateur qui possède des droits d'écriture dans un dossier Xdepo. L'importation par lots est réservée aux utilisateurs privilégiés.

Pour importer un fichier individuel, vous devez cliquer sur le bouton Importer un fichier qui se situe en début de zone des documents dans la fenêtre de navigation Xdepo :

Vous obtiendrez alors ce formulaire :

Pour importer le fichier, il suffit donc de le choisir en cliquant sur le bouton Parcourir... et en sélectionnant le fichier sur votre poste de travail. Une fois cette sélection faite, cliquer sur le bouton Importer ce fichier pour l'envoyer sur le serveur Xdepo.

En principe, vous pouvez importer ainsi n'importe quel fichier de votre disque dur. Certaines circonstances peuvent toutefois faire en sorte que l'importation ne fonctionne pas :

• Si la taille du fichier dépasse la taille maximale autorisée par le serveur pour de tels transferts. Cette taille maximale dépend de la configuration du serveur mais elle est en général autour de 10Mo.
• S'il s'agit d'un document XML, le document doit être bien formé et s'il est lié à une DTD, celle-ci doit être disponible à l'URL indiquée dans le document ou dans le système de catalogues de l'installation Xdepo. Le responsable de l'installation peut en dire plus sur ces catalogues de DTD.

Nous soulignons qu'il s'agit d'un moyen simple d'inclure des documents non XML dans la base de données Xdepo.

Pour importer un lot de documents, vous pouvez choisir l'une ou l'autre des options Importer (dossier) ou Importer (archive) . Ces options sont accessibles sous la forme de boutons dans la zone d'administration de la fenêtre de navigation :

Si vous choisissez d'importer une archive, vous devez avoir sur votre poste de travail un fichier ZIP (extension .zip ) ou un fichier Tar GZ (extension .gz ) qui contient les documents à importer. Après voir cliqué sur le bouton Importer (archive) , le formulaire suivant sera présenté :

Le bouton Parcourir... vous permet de sélectionner l'archive sur votre poste de travail. Une fois cela fait, cliquer sur le bouton Importer cette archive pour l'envoyer sur le serveur. Si la taille du fichier dépasse la taille maximale autorisée par le serveur pour de tels transferts, l'importation va échouer. Cette taille maximale dépend de la configuration du serveur mais elle est en général autour de 10Mo.

A noter que la structure des dossiers à l'intérieur de l'archive sera conservée telle quelle lors de l'importation des fichiers. Cela vous permet de créer rapidement des dossiers dans Xdepo à partir de fichiers et dossiers de votre disque dur.

Si vous choisissez d'importer un dossier, ce dossier doit être accessible au serveur, et non à votre poste de travail. Après avoir cliqué sur le bouton Importer (dossier) , le formulaire suivant sera présenté :

Dans ce formulaire, vous devez simplement saisir le chemin complet du dossier qui contient le contenu à importer. A noter que la structure des dossiers à l'intérieur de ce dossier importé sera conservée telle quelle lors de l'importation des fichiers. Cela vous permet de créer rapidement des dossiers dans Xdepo à partir de fichiers et dossiers sur le serveur.

2) Exportation de contenus

Les utilisateurs privilégiés peuvent exporter le contenu d'une base de données Xdepo. Le principe est simple : lorsqu'on active la commande d'exportation depuis la fenêtre de navigation Xdepo, le contenu du dossier en cours de consultation est exporté et envoyé au navigateur Web sous la forme d'un fichier Tar GZ. Pour exporter tout le contenu, il suffit de se placer à la racine de la base de données.

A noter que Xdepo n'effectue aucun contrôle pour limiter la taille des exportations. C'est à l'utilisateur d'actionner cette fonctionnalité de façon parcimonieuse pour éviter des transferts de gros volumes. A noter également que l'exportation de contenus volumineux demande des ressources importantes sur le serveur.

Le bouton Exporter situé dans la zone d'administration de la fenêtre de navigation permet de démarrer l'exportation :

Une fois ce bouton cliqué, vous obtiendrez le formulaire suivant :

Le formulaire vous indique d'abord quel dossier sera exporté. Ensuite, vous devez indiquer le nom du fichier que vous souhaitez générer et qui contiendra l'ensemble du contenu du dossier exporté. Pour le nom de fichier, il est inutile d'indiquer une extension car l'extension .tar.gz sera ajoutée automatiquement. Par exemple, si vous saisissez export comme nom de fichier, vous recevrez un fichier export.tar.gz .

L'archive reçue contiendra tous les documents, XML et non XML, du dossier et de ses sous-dossiers.

3) Sauvegarde et restauration de la base de données

La sauvegarde – et la restauration ultérieure – d'une base de données est une fonctionnalité réservée aux utilisateurs privilégiés. Elle permet de rapidement créer une copie de sauvegarde de l'ensemble de la base de données Xdepo.

Pour démarrer une sauvegarde de la base de données, vous devez cliquer sur le bouton Sauvegarder dans la zone d'administration de la fenêtre de navigation Xdepo :

Une fois le bouton cliqué, vous obtiendrez ce formulaire :

Vous devez seulement saisir le chemin complet du dossier accessible au serveur où seront placés les fichiers de sauvegarde. Lorsque la sauvegarde sera complétée, ce dossier contiendra une image de votre base de données, avec des instructions pour la restauration.

Pour restaurer une base de données complète qui aurait été préalablement sauvegardée en utilisant la procédure ci-dessus, vous devez cliquer sur le bouton Restaurer dans la zone d'administration de la fenêtre de navigation Xdepo :

Après avoir cliqué sur ce bouton, vous obtiendrez le formulaire suivant :

Ainsi, dans ce formulaire, vous devez donner le chemin complet du fichier maître à restaurer. Ce fichier se nomme toujours __contents__.xml et il doit avoir été produit par la fonction de sauvegarde de Xdepo ou une procédure similaire. Il doit être accessible sur le serveur.

Pour lancer la restauration, cliquer sur le bouton restauration de la base . Attention, car l'état de la base de données, y compris des utilisateurs, sera tel qu'il était au moment de la sauvegarde.