© J.Adamski 2003-2004 – Licence GPL
Népal (pour Népal Est Pas Lacos) est un logiciel libre. Népal reprend les principes de bases du logiciel Lacos créé par la société Advance-Up http://www.advanceup.com . Je tiens tout d'abord à les remercier pour leur contribution sans laquelle Népal n'aurait jamais vu le jour.
Népal ajoute des fonctionnalités au logiciel Lacos (notion d'utilisateurs référencés, synonymes, commentaires, droits spécifiques pour le DIM, recherche améliorée, ...).
Vous pouvez utiliser Népal gratuitement en réseau ou sur un seul poste.
Népal fonctionne en 3 modes différents: utilisateur anonyme, utilisateur signé, utilisateur DIM.
Népal vous permet d'utiliser l'aide à la codification CCAM soit comme utilisateur non authentifié, soit comme utilisateur authentifié. Chacun des deux modes a une adresse spécifique.
Népal est accessible à partir d'un navigateur Web (Mozilla, Internet Explorer, ...), l'adresse du serveur est spécifique à votre installation. Pour une machine tournant sous Windows (nommée mamachine par exemple) sur laquelle tourne l'archive auto-installable, Népal est accessible par:
http://mamachine/nepal pour la version utilisateur non authentifié
http://mamachine/nepal/signature pour avoir accès au formulaire d'authentification
Si vous êtes authentifié, en fonction de vos droits vous aurez ou non accès au options réservées au DIM.
note: Népal peut aussi être totalement intégré à votre intranet, il utilisera donc la même signature que celle qui vous a été donnée pour votre intranet et sera présent sous forme de lien dans votre intranet habituel.
Pour tout souci d'intégration Népal, vous pouvez me contacter à l'adresse jacques.adamski@free.fr
Si vous choisissez le mode non authentifié, vous aurez, après avoir tapé l'adresse de Népal, un formulaire de recherche simplifié.
Cette image de recherche vous permet très rapidement de faire des recherches multicritères sur les actes de la CCAM. Tous les critères vont s'ajouter. Au plus vous entrerez de critères, au plus vous réduirez la liste des actes correspondant aux critères. Les recherches « libellé » et « commentaire » ont des fonctions évoluées qui seront détaillées plus loin.
Ce menu déroulant vous permettra de réduire la recherche au grand groupe d'actes CCAM choisi.
Ce menu déroulant sera différent en fonction du choix fait dans le menu précédent. Il vous permettra d'affiner votre recherche par sous-groupe.
Ce menu déroulant réduira votre recherche à l'action choisie (appliquer, agrandir, changer, ...)
Ce menu déroulant réduira votre recherche au mode d'accès choisi (abord ouvert, accès transpariétal, ...)
Cette zone vous permet de mettre un critère de recherche sur le libellé (les fonctions spécifiques de recherche texte sont détaillées plus loin).
Cette zone vous permet de mettre un critère de recherche sur les commentaires (les fonctions spécifiques de recherche texte sont détaillées plus loin). Chaque utilisateur authentifié peut ajouter un commentaire sur un acte. Seul le DIM peut supprimer un commentaire.
La recherche se fait par mot, vous pouvez indiquer dans ces zones autant de mots que vous voulez, les mots doivent avoir deux lettres ou plus. Si vous indiquez plusieurs mots, la recherche vous donnera tous les commentaires ou libellés contenant au moins l'un des mots.
Si vous souhaitez n'afficher que les libellés ou commentaires contenant plusieurs mots, indiquez les mots avec un « et » entre les mots. Le « et » sera appliqué sur tous les mots, jusqu'à ce qu'il y ait un « ou ».
Exemple:
« exérèse lésion buccale » rend 623 actes.
« exérèse et lésion buccale » rend 2 actes (peut aussi s'écrire « et exérèse lésion buccale »).
« exérèse et lésion ou buccale » rend 123 actes .
« exérèse et lésion » rend 113 actes.
Si vous remplissez les zones « commentaire » et « libellé » il faudra obligatoirement que les actes correspondent aux deux critères inscrits.
si on ne connait pas l'ortographe exacte d'un mot, on peut avoir recours à des caractères joker. Le caractère ? vous permet de rechercher les mots en remplaçant le ? par n'importe quelle lettre mais la présence d'une lettre à la place du point d'interrogation est obligatoire. exemple:
« ex?rèse » trouvera les libellés contenant « exérèse » et rendra 469 actes
« ex?rèse? » trouvera les libellés contenant « exérèses » et rendra 2 actes.
Le caractère joker * vous permettra de rechercher les mots en remplaçant le * par n'importe quelle suite de caractère (et même aucun caractère). exemple:
« co*oscopie » trouvera les libellés contenant « coelioscopie » mais aussi « coloscopie » et rendra 178 actes. (alors que co?oscopie ne rend que les 18 actes contenant « coloscopie »)
« exérèse* » trouvera les libellés contenant « exérèse » mais aussi « exérèses » et rendra 471 actes.
Bien sûr on peut avoir des caractères joker multiples, du moment que la chaîne reste significative (pour celà la chaine doit comporter soit au moins 2 caractères non joker, soit au moins un caractère non joker en début ou en fin et dans tous les cas le nombre de caractères joker doit être inférieur ou égal au nombre de caractères significatifs).
Les mots comportant des caractères joker peuvent être combinés avec les mot « et » ou « ou ».
La case à cocher « élargir aux synonymes » vous permet d'effectuer les recherches en utilisant la table des synonymes créée par le DIM. Si par exemple le DIM a indiqué que « coronarographie » et « cathéter » étaient synonymes, en tapant « coronarographie » dans la zone libellé et en ayant coché la case, on aura comme résultat l'ensemble des libellés contenant « cathéter ou coronarographie» (soit 60 actes). Si la case n'était pas coché ou si le synonyme n'était pas créé, le résultat serait nul car le mot « coronarographie » n'existe pas dans les actes CCAM.
Cette case permet d'élargir la recherche aux mots proches en utilisant judicieusement et automatiquement le caractère joker ?. Exemple :
« exerese » et « élargir aux mots proches » coché rendra 471 actes, correspondant à « exérèse » et à « exérèses ». En fait, cette case cochée pour « exérèse » est équivalent à indiquer « ex?r?se ex?r?se? » dans le libellé. Cela permet dans la plupart des cas d'avoir une recherche approchée des mots par remplacement des voyelles non significatives et élargissement aux pluriels. Attention cet élargissement doit respecter le nombre de carctères significatif énoncé précédemment.
Nepal fait par défaut des recherches de mots entiers. En cochant cette case, vous rechercherez dans les mots contenant une suite de lettres. Cocher cette case est équivalent à précéder et suivre chaque suite de lettres de caractères Joker « * ». Attention cet élargissement doit respecter le nombre de carctères significatif énoncé précédemment.
Par défaut Népal affichera 20 actes par page, vous pourrez bien sûr, ensuite, demander les 20 actes suivants. Cette case déroulante vous permettra de choisir plutôt 50, 100 ou 200 actes par page.
Ce bouton vous permet d'effectuer votre recherche
Ce bouton vous permet d'effacer tous les critères que vous avez indiqués pour effectuer une nouvelle recherche.
Ce bouton vous permet de lancer votre interrogation.
Quel que soit le nombre d'actes en retour, vous aurez instantanément ce nombre. Népal affiche les actes par pages de 20 actes afin de ne pas donner des temps de réponse trop longs (bien sûr, ce nombre peut être différent si vous avez choisi un autre nombre – 50 , 100, 200 – d'actes à afficher par page)..
Cet affichage paginé permet de ne pas surcharger le serveur, le poste client ou ni le réseau.
Si vous avez plus de 20 actes, vous aurez un lien vers les 20 résultats suivants. De même, si vous n'êtes pas sur la première page, vous aurez un lien vers les 20 résultats précédents (ce nombre peut-être 50,100 ou 200).
Face à chaque acte, vous avez le numéro de l'acte. En cliquant sur ce numéro, vous aurez accès à la page de la documentation officielle CCAM où l'acte est référencé. Vous pourrez ensuite vous déplacer dans ce document.
Note: le temps de chargement de ce document, vu que chaque chapitre est chargé en totalité, est plus long qu'une simple recherche multicritère.
Si vous choisissez le mode authentifié de Népal, vous aurez, après avoir tapé l'adresse de népal, un formulaire de recherche plus complet que dans le mode précédent.
Une première image vous demandera votre code et votre mot de passe (si vous utilisez l'authentification de votre intranet, vous n'aurez pas cette image).
Ensuite vous aurez l'image vous demandant vos critères de recherche. Cette image est identique à celle vue précédemment avec une case à cocher supplémentaire, nommée « Uniquement sur mes codes », vous permettant de n'effectuer une recherche que sur les codes que vous avez classés dans vos favoris.
L'affichage comprend des options supplémentaires par rapport au mode non authentifié:
une case à cocher face à chaque acte, vous permettant de le sélectionner,
une zone de texte vous permettant d'indiquer un commentaire
deux boutons, le premier vous permettant de classer les actes parmi vos favoris, le second vous permettant de commenter vos actes.
Chacun de ces deux boutons s'appliquera à tous les actes sélectionnés dans la page, vous pouvez ainsi sélectionner jusqu'à 20 actes en une fois (ou plus – 50, 100 ou 200 – si vous avez choisi d'afficher plus de 20 actes par page) et les classer dans vos favoris. de même vous pouvez commenter l'ensemble des actes sélectionnés en une seule fois. Le commentaire sera dans ce cas le même pour tous les actes sélectionnés. Les commentaires sont additionnels, si vous commentez un acte qui est déjà commenté, vous aurez une deuxième ligne de commentaires.
Si votre code utilisateur vous donne accès aux fonctions réservées au DIM, vous aurez une première image avec des options supplémentaires.
Deux liens supplémentaires « gestion des synonymes » et « gestions des utilisateurs » vous sont proposés.
Le lien gestion des synonymes vous donnera accès à la création, modification, suppression ou recherche de synonymes.
Le lien gestion des utilisateurs vous permettra de créer des nouveaux utilisateurs ou de changer les mots de passe pour des utilisateurs existants.
L'affichage comprend des options supplémentaires par rapport au mode authentifié. En effet, les utilisateurs DIM ont la possibilité de supprimer des commentaires faits sur les actes et de « supprimer les utilisateurs » d'un ou de plusieurs actes.
Comme précédemment, cette manipulation s'effectue sur tous les actes séléctionnés de la page.
La touche « supprimer utilisateur » va en une fois supprimer l'acte des favoris de tous les utilisateurs qui l'ont classé.
La touche « supprimer commentaire» va en une fois supprimer tous les commentaires des actes sélectionnés..
Note: il est conseillé de faire très attention à l'utilisation de ces boutons de suppression.
Vous pouvez ajouter, modifier ou supprimer autant de ligne synonymes que vous le désirez. Quand une recherche sera effectué sur un mot, elle sera effectuée pour tous ses synonymes.
exemple:
Vous avez une ligne synonyme contenant « cathéter coronarographie » en tapant le mot « coronarographie » dans une des zones de recherche et en cochant la case « élargir aux synonymes », vous aurez la même chose que si vous aviez tapé « cathéter ou coronarographie » dans cette zone.
Dans les synonymes, il vous est tout à fait possible d'utiliser les caractères Joker vu précédemment.
exemple: « coronaro* »
Vous pouvez changer le nombre de lignes de synonymes que vous voulez voir afficher par page (20,50,100,200).
Note: cette option ne doit pas être utilisée si Népal est intégré à votre intranet.
Si Zope vous permet de très simplement créer les utilisateurs, Népal permet aux utilisateurs n'ayant aucune connaissance de Zope de gérer leurs utilisateurs.
Ce mode de création, modification est très simplifié. Pour créer ou modifier un utilisateur, vous indiquez son code, le mot de passe que vous désirez lui affecter et vous cochez la case utilisateur DIM si vous souhaitez lui donner les droits DIM.
Toute la documentation qui suit est très technique, si vous êtes utilisateur Népal, vous n'en aurez pas besoin.
Népal utilise le serveur d'application Zope (serveur gratuit sous licence libre) ce qui permet à Népal d'être utilisable simplement sur la plupart des systèmes d'exploitation. Par ailleurs, les fonctionnalitées avancées de Zope en terme de gestion documentaire permettent à Népal d'être moins lourd et plus performant que les solutions développées autour de systèmes de gestion de base de données. Népal étant sous licence GPL, vous pouvez l'utiliser gratuitement sans aucune réserve, le modifier et l'adapter à vos besoins, le redistribuer. Vous êtes seulement tenu de garder une référence aux auteurs qui ont été à l'origine de Lacos et de Népal.
Népal est diffusé en Package Zope qui peut être très simplement intégré par un simple import à un serveur Zope tournant sous BSD, Linux, MacOSX, Windows. Une version auto-installable pour Windows est aussi disponible, il n'est donc pas nécéssaire d'avoir la moindre connaissance Zope pour installer Népal.
Bénéficier de toutes les fonctionnalités de Nepal à partir de votre application écrite en Python,PHP,Perl, Java ou ASP c'est très facile, grâce à une fonction répondant aux requêtes XML-RPC.
Cette fonction s'appelle tout simplement XMLRPC et permet de passer tous les paramètres nécéssaires à l'interrogation via XMLRPC.
paramètres:
XMLRPC(libelle,utilisateur,commentaire,id4,id3,id)
Chacun des paramètres a les mêmes possibilités que dans Nepal (caractères joker, ...)
La recherche se fait d'office avec l'option synonymes activée
le paramètre id3 correspont à la 3ème lettre du code CCAM (action)
le paramètre id4 correspond à la 4ème lettre du code ccam (accès)
XMLRPC renvoie une ligne de caractère pour chaque code contenant le numéro de code sur 7 caractère, un espace et le libellé de l'acte.
Exemple de sources pour interroger Nepal à distance:
en Python
from xmlrpclib import Server
server = Server("http://medecinelibre.nuxeo.org/nepal")
print server.XMLRPC("eeg")
result = serveur("","jack")
print result
en Perl
Attention: l'extension xml-rpc de Perl doit être installée
use Frontier::Client;
$server_url = 'http://medecinelibre.nuxeo.org/nepal';
$server = Frontier::Client->new(url => $server_url);
print $server->call(XMLRPC,eeg);
$result = $server->call(XMLRPC,'',jack);
print $result;
Attention, l'extension xml-rpc de PHP doit être installée
<?php
$server = new xmlrpc_client('nepal','http://medecinelibre.nuxeo.org', 80);
$message = new xmlrpcmsg('nepal.XMLRPC',new xmlrpcval('eeg', 'string'));
$result = $server->send($message);
if (!$result) {
print "<p>Could not connect to HTTP server.</p>";
} elseif ($result->faultCode()) {
print "<p>XML-RPC Fault #" . $result->faultCode() . ": " .
$result->faultString();
} else {
print $result->value();
print "</p>";
}
?>
Ces petits scripts renvoient d'abord tous les codes contenant « eeg » ou ses synonymes, puis tous les codes classés pour l'utilisateur "jack" (le script PHP ne renvoie que les codes contenant « eeg » ).
Ces scripts doivent être modifié si votre réseau vous oblige à passer par un serveur Proxy.
Copiez le fichier .zexp dans le sous-dossier "import" du dossier ou vous avez installé Zope
Allez en interface de management à partir de votre navigateur sur la racine de zope http://localhost:8080/manage
Cliquez sur le bouton import/export
Indiquez le nom du fichier à importer "nepal.zexp" tout en minuscule puis cliquez sur le bouton import
C'est tout Nepal est installé, il vous faudra créer un utilisateur ayant le rôle « dim » pour pouvoir accéder à toutes les fonctions (dans le "tout-prêt windows" c'est déjà fait). Celà ce fait toujours via l'interface Web : vous devez voir sur la partie gauche un dossier Nepal dans celui-ci vous avez un dossier acl-users et vous pourrez ajouter votre premier utilisateur Dim. Ensuite Nepal intègre la création de nouveaux utilisateurs.
Pour installer Nepal sous Windows:
1) Il faut impérativement que le poste sur lequel on l'installe ait les fonctions réseau IP installées (c'est le cas de tout poste susceptible d'aller sur Internet par exemple).
2) décompresser l'archive Népal windows à la racine du disque c (c:\) en plaçant nepal.exe à la racine de c: et en l'exécutant par double clic
3) un dossier nepal est créé (c:\nepal) ATTENTION laisser ce dossier à cet endroit.
4) dans le dossier nepal exécuter la commande start par double clic
5) ceci démarre votre serveur Zope dans une fenêtre de type Dos - celà prend moins de une minute sur un pentium 133 mhz. Vous avez un certain nombre de message au démarrage - votre serveur est démarré dès que vous avez le message: ... Zserver http server started ... hostname : nom de machine port : 8080
Vous aurez probablement l'erreur "Zserver cannont write PID file" ne pas vous en préoccuper
Si vous aviez une autre erreur me le signaler
6) Votre serveur Web avec Nepal est démarré, vous pouvez y accéder par Internet Explorer à partir du même poste en tapant l'adresse http://localhost:8080/nepal (ne pas oublier le 8080)ou à partir de tout poste du réseau en tapant http://numeroIP:8080/nepalnumeroIP étant l'adresse IP de votre poste
7) pour accéder aux fonctions accessibles aux utilisateurs authentifiés tapez http://localhost:8080/nepal/signature ou bien sûr le numero IP sur un autre poste Il existe 3 codes utilisateurs:
l'administrateur: nom: admin mot de passe: admin
le dim: nom: dim mot de passe: dim
l'utilisateur simple: nom: demo mot de passe: demo
les noms et mot de passe se mettent en minuscule