Fonction d'accès aux archives via le web : u_geide

Préambule

Cette fonction est très intégrée et prend en charge un nombre elevé de cas de figures. Son résultat est du code html pouvant être placé directement au sein d'une page du serveur web. Si le résultat produit par cette fonction doit être complété ou personnalisé, il suffit de placer le résultat dans une variable puis d'appliquer des transformations au contenu de cette variable.

Mode d'appel

Syntaxe

u_Geide (sélecteur ; num archive ; "nom archive" ; largeur max ; hauteur max ; "option")

Cette fonction est généralement appelée au sein d'une page web. Comme elle retourne une chaine directement codée en html, on mettra comme code de codage la valeur 3 en fin de l'appel dans une balise !4d=insert;u_geide(1;[Image]Archive);3 !

Paramètre : sélecteur

Identifie le résultat souhaité.

Sélecteur Description

1 Imagette ou icône du fichier

2 Image basse résolution

3 Lien sur le fichier

4 Idem avec highlight

5 Idem mais URL seule (sans le lien)

8 Lien avec jeton

9 Mode intégré : lien + imagette ou icône

Paramètre : num archive

Numéro de l'archive pour laquelle appliquer la fonction (ou -1 pour obtenir la première archive autorisée). La méthode u_RecordInit étant appelé lors de chaque affichage d'un enregistrement et effectuant la sélection des archives attachées, il suffit ensuite de boucler sur la table des archives (22).

Exemple

!4D=begin;22!

!4D=insert;u_Geide (9;[Image]Archive;"";80;80;"Picture.htm:80:120");3!<br>

!4D=end;22!

Paramètre : nom archive

Si un nom d'archive est transmis en paramètre, le logiciel cherche si une archive porte ce nom là (et dans ce cas le numéro d'archive est ignoré). Si oui : ce qui suit sera appliqué à cette archive. Sinon, la fonction renverra une chaîne vide. Les noms peuvent être définis par défaut afin d'obtenir une harmonisation des écritures.

Ceci permet, par exemple, de proposer un accès à un "sommaire" ou à une "couverture" si ces derniers font l'objet de fichiers archivés portant ces noms là.

Paramètres : largeur max et hauteur max

Dans le cas d'une imagette (sélecteur 1) ou d'une image basse résolution, permet d''appliquer un coefficient de réduction.

Paramètre : option

Permet de spécifier, dans le cas d'une archive image, quelle page html doit être appelée dans le lien et de fixer une marge horizontale et une marge verticale qui seront ajoutées aux dimensions de l'image pour déterminer la taille de la fenêtre qui sera créée par le javascript "Newwindow".

​

Exemple

u_Geide (3;[Image]Archive;"";80;80;"Picture.htm:80:120")

​

Gestion de la confidentialité

Cette fonction tient compte des autorisations de l'utilisateur connecté (ou des autorisations affectées à l'utilisateur "GUEST" si l'utilisateur n'est pas identifié). L'autorisation permettant de consulter une archive est celle dont le code est "03080201".

​

Lors de l'activation d'un lien d'accès à une archive, les autorisations de l'utilisateur sont à nouveaux vérifiées. Ainsi, il n'est pas possible de transmettre un lien sur une archive confidentielle.

​

Cependant, dans un certain nombre de cas de figure, ceci est insuffisant. Il est alors nécessaire de créer un script dont le nom doit être obligatoirement : "AScript_Archive_Aut" et qui alimentera la variable de type entier : "eArchiveAut".

Valeur Niveau d'autorisation

0 Accès interdit, la fonction retourne une chaine vide

1 Icône du fichier seulement, pas de lien ni d'image ou imagette

2 Icône ou imagette seulement, pas de lien ni d'image

3 Icône ou imagette ou image basse résulotion, pas de lien

5 Pas de restriction

Exemple

Si ([Image]Commentaire="@*@") &(Non(x_Autorise("030102")))

eArchiveAut :=1

Sinon

eArchiveAut :=5

Fin de si

Si l'utilisateur n'a pas l'autorisation "Modifier un document" et que le commentaire de l'image contient un "*", seule l'icône sera présentée.

Transmettre un lien sur une archive via email

Si une utilisateur a droit d'accéder à une archive, il peut la copier localement puis la transmettre via email. Cette opération relève de sa responsabilité. Afin d'éviter des transferts inutiles sur le réseau, il est possible de générer un jeton d'accès à une archive. Ce jeton comporte, de manière codée, le numéro d'archive, l'identifiant de l'utilisateur connecté au moment de sa génération ainsi que la date d'émission. Lors de l'activation d'un lien avec jeton, le logiciel vérifie si la date de "péremption" n'est pas dépassée et si l'utilisateur qui a provoqué la génération du jeton avait bien accès à l'archive.

Le délai de validité d'un jeton est fixé à 7 jours par défaut. Cpendant, ce délai peut être modifié grâce au paramètre W_GT.

Exemple

La fonction suivante insérer dans une ressource web :

!4D=insert;u_geide (8);3!

permettra d'obtenir un lien avec jeton sur l'archive :

http://192.168.0.20/GEIDEFile/ROM02.PCT.jpg? Gtoken =469024481421480305470025480312470016426521431702

A propos des icônes

Par défaut, le logiciel propose des icônes relativement neutres et différenciées par type de fichier.

Pour affecter une icône autre que ces icônes par défaut à certains types de dcouments, il suffit de les créer dans la table des icônes en donnant comme nom :*. suivi du type. Exemple : *.XML pour les documents XML.

Code généré pour chaque syntaxe

Sélecteur : imagette ou icône

!4D=insert;u_Geide (1;[Image]Archive);3!

Archive de type image

<img src="http://192.168.0.20/Image_prev.JPG?Archive=192904691018" height="127" width="169" border="0" alt="IMG_0557.JPG">

Archive de type autre qu'image

<img src="http://192.168.0.20/Ressource.jpg?resnum=1219" border="0" alt="Fiche OAI en xml">

Sélecteur : image basse résolution

!4D=insert;u_Geide (2;[Image]Archive);3!

Archive de type image

<img src="http://192.168.0.20/Image_scre.JPG?Archive=192904691018" height="300" width="400" border="0" alt="IMG_0557.JPG">

Archive de type autre qu'image

(aucun résultat n'est retourné dans ce cas)

Sélecteur : lien

Dans ce cas, il convient de faire figurer, après cet appel, la zone cliquable permettant d'activer le lien. Si cette fonction renvoie un lien, la variable AND contiendra la balise de fin de lien (</a>), sinon, elle contiendra une chaîne vide. Il convient donc d'insérer cette variable à la fin de la zone cliquable, comme illustré ci-dessous.

!4D=insert;u_Geide (3;[Image]Archive);3! cliquez ici !4D=insert;AND ;3!

Archive de type image

<a href="http://192.168.0.20/GEIDEFile/IMG_0557.JPG?Archive=192904691018&File=IMG_0557_JPG" target="new">

Archive de type autre qu'image

<a href="http://192.168.0.20/GEIDEFile/MonFichier.xml?Archive=192905791018&File=Fiche+OAI+en+xml" target="new" title="Fiche OAI en xml">

Sélecteur : mode intégré

!4D=insert;u_Geide (9;[Image]Archive;"";80;80;"Picture.htm:80:120");3!

Archive de type image

<a href='javascript:Newwindow("Picture.htm?Archive=192904691018","1095", "toolbar=no,scrollbars=no,width=480,height=420;");'>

<img src="http://192.168.0.20/Image_prev.JPG?Archive=192904691018" height="60" width="80" border="0" alt="IMG_0557.JPG"></a>

Génère un lien d'ouverture de fenêtre et place ce lien sur une imagette dont les dimensions seront redimensionnées afin de tenir dans un rectangle de dimension maximum de 80 x80.

Archive de type autre qu'image

<a href="http://192.168.0.20/GEIDEFile/MonFichier.xml?Archive=192905791018&File=Fiche+OAI+en+xml" target="new" title="Fiche OAI en xml"><img src="http://192.168.0.20/Ressource.jpg?resnum=1219" border="0" alt="Fiche OAI en xml">

Solution alternative

Dans certains cas bien précis, il peut être nécessaire de faire générer un lien générique sur l'archive.

Générer une playlist xml pour alimenter un player mp3

L'exemple ci-dessous génère directement un fichier xml utilisable dans un player disponible sur le site de Jeroen Wijering.

# CHERCHER PAR TABLEAU([Image]Record_num;LTNumRecList)

# CHERCHER DANS SELECTION([Image];[Image]Doc_Type="mp3")

# EList_NbElements:=500

<playlist version="1" xmlns="http://xspf.org/ns/0/">

<trackList>

​

!4D=begin;22!!4D=exec;Goto_Record ([Image]Record_num)!

<track>

<title>!4D=field;=21/(Documents)Titre;encode=H!</title>

<creator> !4D=field;=151/(Documents)Auteurs;encode=H!</creator>

<location> GEIDEFile/Record_!4D=insert;html_code(Chaine([Image]Record_num));3!_num=!4D=insert;Chaine([Image]Ordre)!.mp3 </location>

</track>

!4D=end;22!

</trackList>

</playlist>

Dans cet exemple, c'est la méthode appelée lorsque l'URL "GEIDEFile/Record..." est demandée qui prendra en charge les autorisations d'accès.

NB : dans l'URL ci-dessus, s'il est précisé num=0 au lieu de num=!4D=insert;Chaine([Image]Ordre)!, c'est la première archive liée à la fiche qui sera proposée.