Le gestionnaire de documents

L'application permet le dépot et le retrait de documents sur le disque où se trouve l'application. L'espace de dépot est limité par un répertoire "Racine", défini dans la configuration. Les fichiers dans les répertoires situés plus haut sur le disque ne sont pas visibles . Les répertoires non autorisés (au niveau du gestionnaire de fichiers) en lecture à l'utilisateur du démon HTTP n'apparaissent pas, ceux non autorisé en écriture ne permettent pas de dépot de nouveau documents.

Ce programme est un script CGI écrit en Perl destiné à être installé sur un démon HTTPD quelconque et accessible depuis un browser Netscape 2.02 ou plus . Ce browser, pour permettre toutes les fonctionnalités de l'application, (surtout pour la partie "Déposez un nouveau document", balise "browse")   . Voir la norme RFC1867. (Internet Explorer 3.0, 3.02 ne permet pas d'insérer un fichier dans un formulaire).

• Pour des informations supplémentaires sur l'utilisation du gestionnaire
• Pour des informations sur l'administration

Installation

1. Vérifiez que l'interpréteur Perl est installé et accessible depuis le répertoire CGI.
2. Décompressé gestionnaire.tar.gz dans le répertoire CGI.
3. Déplacez le répertoire html dans l'espace Web en le renommant .
   Ex : /usr/local/apache/html/gestionnaire/ ou c:\Program Files\Apache\html\gestionnaire.
4. Modifier le fichier gestionnaire.txt
5. Modifiez les 3 fichiers .cgi pour donner le chemin de gestionnaire.txt. Si vous êtes sous Unix modifiez les 3 fichiers .cgi afin d'adapter le chemin de l'interpréteur Perl
6. Lancez la page /getsionnaire/index.html depuis le browser, il doit appeler les cgi installés.

Contenu

1 -Les executables:

• gestionnaire.cgi: est le script principal, utilisé par tous.
• /config/config.cgi: Configuration de l'application
• /config/admin.cgi: :Application administrateur permettant de gérer les rubriques de votre gestionnaire.Ce script crée des répertoires les nomme et les supprime.

Vous devez modifier ces fichiers pour indiquer où se trouve le fichier gestionnaire.txt. Si on se trouve sous Unix, chacun de ces fichiers doit être édités pour indiquer le chemin de l'interpéteur Perl. Il s'agit des trois fichiers qui doivent être copié dans le répertoire habituel qui recoit les scripts CGI.. La plupart du temps ce répertoire s'appelle /CGI-BIN/. Ce répertoire doit permettre l'éxecution et la lecture des fichiers à tout le monde (ex unix : chmod 755 cgi-bin) .

Avant de commencer à se servir du gestionnaire à document, vous devez lancez Config.pl le script qui permet de vérifier la configuration saisie comme la place des images sur l'espace WEB, l'adresses des différents fichiers ...

Si, une fois que tout est installé, quelque chose ne fonctionne pas , l'erreur y est surement référencé . Ces renseignements vont être enregistrés dans un fichier . L'adresse de ce fichier doit être définie dans l'en-tête de config.pl Il s'agit de la seule modification à apporter au code .Ouvrez config.pl et saisiser un nom de fichier pour la BD.

2 - Les bibliothèques 

Il s'agit des différents fichiers appelés par l'application.Ils peuvent être copiés dans n'importe quel endroit du disque du moment que le répertoire soit indiqué dans la configuration. Ce répertoire doit être ouvert en lecture à tous, et il est préférable de le mettre en dehors de l'espace du serveur Web.

Problême avec la configuration

Avant toute chose vérifiez que un nom correct du répertoire pour accéder à gestionnaire.txt est rentré dans le source de des fichiers .cgi, et que ce fichier est lisible par tous.

Erreur sur l'existence d'un fichier ou d'un répertoire :

Le script ne trouve pas cet obget .

Vérifiez bien la syntaxe ! Les noms de répertoires doivent être séparés par '/' et non '\' même sous Windows. (ou alors doublez-les) N'oubliez le dernier qui termine le nom du répertoire . Pour les fichiers aidez-vous du nom qui apparait dans le message d'erreur.

Erreur de lecture et d'écriture :

Les droits accordés sont insuffisants.

• Sous Unix : chmod "nom_du_repertoire" | "nom_de_fichier"
• Sous Windows : Sous le gestionnaire de fichiers, clique bouton droit sur l'objet concerné puis "Partager"

Erreur d'execution :

• Sous Unix : Les droits accordés sont insuffisants. chmod "nom_du_repertoire" | "nom_de_fichier
• Sous Windows : J'ai cette erreur sous Windows 95 mais pas de problèmes d'éxecution !

Récapitulatif des droits