« Résumé Psychiatrique Minimum · startup_guide_fr.doc p.2- Introduction Ce guide a pour but de vous aider à faire vos premiers pas dans la nouvelle version de l'application "Résumé

« Résumé Psychiatrique Minimum »

Guide de Démarrage Version 2.1.03

startup_guide_fr.doc

p.2-

Introduction Ce guide a pour but de vous aider à faire vos premiers pas dans la nouvelle version de l'application "Résumé Psychiatrique Minimum". Il vous guidera jusqu'à l'obtention d'un système opérationnel.

Vous remarquerez que l'on fera souvent référence au produit ATOUM. ATOUM a été développé dans l'optique de faire tourner simultanément plusieurs applications comme le "Résumé Psychiatrique Minimum". Il s'agit en quelque sorte de l'environnement dans lequel le "Résumé Psychiatrique Minimum" fonctionne. Pour l'instant, le "Résumé Psychiatrique Minimum" est la seule application fonctionnant dans cet environnement mais il se pourrait que d'autres applications viennent s'y ajouter par la suite.

Installation des composants Le CD-Rom contient tout ce dont vous avez besoin pour installer l'environnement nécessaire à "ATOUM" et utiliser l'application "Résumé Psychiatrique Minimum" dans votre institution. L'installation démarre automatiquement lorsque vous introduisez le CD-Rom dans votre lecteur. Si ce n'était pas le cas, veuillez simplement exécuter le programme se trouvant dans le répertoire ‘install’ du CD-Rom. Bien que l'installation ne soit pas compliquée, veuillez néanmoins lire attentivement les explications qui vous seront fournies au cours de l’installation. L'installation ne nécessite aucune compétence technique, veuillez simlement réaliser l’installation en laissant toutes les options par défaut. L'application ATOUM est une application de type web. L'installation ne doit donc se faire que sur une seule machine (appelée "Serveur"). Aucune installation ne doit se faire sur les autres machines (appelées "Clientes") qui accèdent à l'application. Un simple browser (tel que Microsoft Internet Explorer) est suffisant pour utiliser l'application. Composants installés :

• Le Java 2 SDK contient les librairies Java nécessaires au fonctionnement du serveur Tomcat.

• Le serveur Tomcat est un serveur pour applications Web écrites en Java..

• L’application Atoum L’installation de ces compasonts n’a aucun impact sur les applications déjà présentes sur le serveur.

Démarrage du serveur Tomcat Vous venez de terminer l'installation. Il est temps de vérifier si votre système fonctionne correctement. L'application ATOUM requiert un serveur pour fonctionner. Ce serveur est le serveur Tomcat que vous venez d'installer. Pour démarrer ce serveur, veuillez exécuter l'option "Start server" dans le menu "ATOUM Web Form Engine" du menu "Démarrer".


p.3-

Menu "ATOUM Web Form Engine"

Lors du démarrage du serveur Tomcat, vous constaterez qu’une fenêtre DOS s’ouvre. Cette fenêtre constitue la console du serveur, console dans laquelle apparaissent toutes les opérations en cours. Veuillez ne pas fermer cette console car cela aurait pour conséquence d’arrêter brutalement le serveur, vous pouvez par contre la minimiser.

La fenêtre DOS de la console Tomcat apparaît également dans la barre des tâches.

Le démarrage du serveur Tomcat peut prendre quelques secondes, tout spécialement lors d’installation ou d’une mise à jour de l’application. L’indication « INFO : Server startup in xxxxx ms » apparaît lorsque le serveur a fini son démarrage et est prêt à répondre aux sollicitations des utilisateurs.

Le serveur Tomcat a fini sa phase démarrage. L’indication « INFO : Server startup in 15563 ms » indique qu’il

est prêt.

Nous allons maintenant vérifier que le serveur fonctionne correctement. Pour ce faire, il suffit d'ouvrir votre explorateur Internet et de demander l'adresse "http://localhost:8080". Vous devriez obtenir la page d'accueil du serveur. Si cela ne fonctionne pas, vous pouvez également essayer l'adresse "http://127.0.0.1:8080". Dans ce cas, veuillez en tenir compte pour la suite de la procédure en remplaçant systématiquement


p.4-

"localhost" par "127.0.0.1".

Page d’accueil du serveur Tomcat

Premier appel à l'application L'application est disponible à l'adresse :

http://localhost:8080/atoum

ATTENTION, ce premier appel est un moment critique car le système va configurer un certain nombre de choses. Il est donc très important de laisser les opérations se dérouler jusqu'au bout sans les interrompre, même si cela vous semble long ou que vous croyez que le système est bloqué. Le temps nécessaire à ce premier appel est de l'ordre de 10 minutes, mais peut varier fortement d'une machine à l'autre et des tâches à réaliser. Durant ce premier appel, ATOUM devra peut-être charger certains paramètres. Il va aussi attribuer des mots de passe de façon aléatoire aux utilisateurs déjà présents dans le système. Ces mots de passe ne vous seront communiqués qu'une seule fois, veuillez les noter lorsqu'ils s'afficheront.


p.5-

Chargement des paramètres en cours … (Facultatif)

Attribution des mots de passe.


p.6-

Identification Selon votre régime linguistique, veuillez vous connecter en utilisant l'utilisateur ADMINF ou ADMINN avec le mot de passe qui lui a été assigné précédemment. Vous devriez arriver à la page d'accueil de l'application.

Page d’accueil d’ATOUM


p.7-

Création du dossier de votre institution

Dans le menu "Administration", choisissez l'option "Gestion Dossiers".

L'option "Créer un nouveau dossier" située dans la partie inférieure gauche de l'écran vous permettra d'introduire les informations nécessaires. Toutes les données sont obligatoires. Sachez toutefois que le champ identification ne sert qu'à identifier le dossier et n'a aucune influence sur la suite du travail. Vous êtes par conséquent entièrement libre quant au choix de cette identification.

Le régime linguistique indique les langues utilisées dans votre institution. Cela servira par exemple lors de la création des unités de vie pour renseigner le libellé de l'unité de vie dans chacune des langues utilisées. Cette information du régime linguistique pourra être modifiée à tout moment par la suite.

Il vous reste à choisir "Résumé Psychiatrique Minimum" comme application du dossier et à sauvegarder vos informations.


p.8-

Ecran de création du dossier


p.9-

Dans le même écran, veuillez presser le bouton "Activation" dans la partie supérieure. Sélectionnez la valeur "db_data" ou "db_data_fixed" dans la liste des possibilités, activez le dossier à l'aide de la case à cocher et sauvegardez.

Les petites institutions auront tout intérêt a sélectionner la valeur « db_data ». Par contre, pour les moyennes et grosses institutions, il est préférable de sélectionner la valeur « db_data_fixed ». Pour plus d’informations à ce sujet, veuillez vous référer au chapitre relatif aux bases de données du manuel utilisateur.

Ecran d’activation du dossier


p.10-

Choix du dossier de travail L'option "Choix dossier" du menu "Edition" vous permet de choisir votre dossier de travail. Veuillez sélectionner le dossier nouvellement créé. Si ce dernier apparaît grisé, c'est probablement que vous ne l'avez pas activé correctement comme expliqué précédemment.


p.11-

Introduction des données du RPM L'option "Données" du menu "Edition" vous donnera l'interface permettant l'introduction des données. Avant que vous ne puissiez commencer à introduire vos données, vous devez spécifier votre catégorie d'institution car cela a un impact sur les données que vous devrez introduire, ainsi que sur certains paramètres tels que la liste des Index de lits disponibles (services). Pour ce faire, veuillez cliquer sur le crayon à droite de "Institution" dans la partie gauche. Toutes les données présentes sur cet écran pourront être modifiées ultérieurement hormis la catégorie. Une fois la catégorie définie, il n'est plus possible d'en changer. Sauvegardez ces données. Votre dossier est maintenant tout à fait prêt pour l'introduction des données.

Définition de la catégorie de l’institution

Transformation du Numéro de patient en Numéro de traitement médical. Cette transformation se fait automatiquement par l’application suivant les règles établies.

Date de démarrage.

Cette transformation ne doit pas s’appliquer sur les traitements médicaux déjà exportés. On se basera sur la date de début du traitement médical pour déterminer s’il y a lieu ou non d’appliquer une transformation. Il est possible de changer la date de transition mais cette date est fixée par le Service Public Fédéral.

Masque de transformation.


p.12-

Il ne s’agit pas à proprement parlé d’un encryptage, mais plutôt d’une génération aléatoire de Numéro de Traitement. Il est cependant possible d’influencer cette transformation via un masque. Une modification de masque n’a d’effet que sur les nouveaux Numéros de Traitements générés. Ce n’est donc pas rétroactif. Ce numéro de Traitement se compose tout comme la référence du patient de 13 positions alphanumériques. On peut déterminer le type de chaque position du masque. On peut ainsi opter pour la même syntaxe que les références patient utilisée par l’Institution. Le masque par défaut est “?????????????” (13 positions totalement aléatoires). a) Positions aléatoires. Ces positions sont générées de façon aléatoire par l’application. Il faut minimum 8 positions aléatoires pour que le masque soit valide, peu importe l’emplacement. ? : N’importe quel chiffre ou lettre ! : N’importe quelle lettre # : N’importe quel chiffre b) Constantes. On peut également spécifier des constantes dans le masque. Les constantes valides sont : A-Z,0-9,-, l’espace et / Exemple de masques : - On veut que les Numéros de Traitement commencent par “PAT” suivi de 10 chiffres générés de façon aléatoire : PAT########## Exemples : PAT1569874125, PAT8964129658, ... - On désire uniquement 8 positions : ???????? Exemples : A78T7UF7, 25TPW7A8, ... - On veut distinguer les références cryptées via une syntaxe bien particulière composée de 3 chiffres, un -, 3 chiffres, un - et 3 chiffres : ###-###-### Exemples : 492-175-029, 826-746-148, ...


p.13-

Une valeur par défaut est prévue pour le masque et la date de transition.


p.14-

Récupération de vos données actuelles Vous avez la possibilité de récupérer les données de l'ancienne application DOS. Si vous avez des données archivées, veuillez les recharger avant d’éffectuer la conversion. Au fil des années, il est possible que des anomalies se soient glissées dans vos données, nous vous conseillons donc une vérification de vos données grâce à l'utilitaire RMPGCHK.EXE. Il serait en effet dommage de transférer des erreurs vers le nouveau système. Vous trouverez cet utilitaire dans le répertoire ‘c:\atoum\bin’ ainsi que les manuels d’utilisation (chk_v2-3_f.pdf, chk_v2-3_n.pdf). Ceci étant hors contexte, nous vous invitons à prendre contact avec votre coordinateur pour de plus amples informations. Veuillez commencer par localiser les données de votre institution. Il devrait s'agir dans la majorité des cas d'un répertoire portant le nom de votre institution se trouvant dans le répertoire "c:\rpm" ou "c:\mpg" comme par exemple c:\rpm\moninstitution. Dans des configurations plus complexes (lorsque la base de données se trouve en réseau notamment) ou simplement pour vous en assurer, vous pouvez utiliser l’option « 7 – Responsable RPM / 7 – Informations / 1 – Info Application » de l’ancienne application pour vous aider dans vos recherches. L’information « Données » vous indique la localisation de vos bases de données. Vous trouverez dans ce répertoire des sous-répertoires correspondants à chacun de vos dossiers.

Il pourrait s’agir par exemple de « i:\applic\clipper\mpg\version4\moninstitution ».


p.15-

Avant de pouvoir récupérer les données dans la nouvelle application, il est nécessaire de réaliser une opération les rendant lisibles. Cela se fait grâce à la commande DOS ci-dessous : c:\atoum\bin\UNCRYPT.EXE répertoire_raçine_données utilisateur [mot_de_passe] Par exemples : c:\atoum\bin\UNCRYPT.EXE c:\rpm RESP xyz c:\atoum\bin\UNCRYPT.EXE i:\applic\clipper\mpg\version4 RESP xyz Cette opération doit s’exécuter dans l’environnement DOS. Vous trouverez certainement un raccourci sur votre bureau ou une option dans votre menu « Démarrer » dénommée « DOS prompt » ou « Invite DOS » pour permettant d’atteindre cet environnement. Cette commande va traiter toutes les institutions qui sont accessibles avec l’utilisateur et le mot de passe spécifié. Si ces données sont différentes par institution, vous devrez exécuter ces commandes plusieurs fois en adaptant l’utilisateur et le mot de passe afin de préparer les données de toutes vos institutions. Les données de vos institutions seront alors préparées et copiées dans le répertoire « c:\atoum\temp\ ». Cela n'a aucun effet sur vos données originales. L'ancienne application fonctionnera comme auparavant. Une fois cette opération réalisée, allez dans le menu "R.P.M." de la nouvelle application, choisissez le dossier dans lequel vous désirez importer les données et demandez l'option "Conversion". Cela ne sera néanmoins possible que si vous n'avez pas encore travaillé dans ce dossier. Ce dossier doit être entièrement vide (à part les données techniques concernant votre institutions). Vous devez aussi en avoir spécifié la catégorie. Dans cette écran de conversion, veuillez indiquer "c:\atoum\temp\inst\adm.dbf" dans la zone prévue à cet effet et pressez le bouton "Convertir". Une nouvelle fenêtre s'ouvrira vous informant de l’état d'avancement de la conversion. Veillez à ne surtout pas arrêter le serveur Tomcat avant d'avoir obtenu la confirmation que la conversion est terminée.


p.16-

ATTENTION, la récupération des données peut durer plusieurs heures. Veuillez en tenir compte si vous devez absolument éteindre l'ordinateur. Afin de ne pas vous ralentir dans votre travail, vous pouvez lancer cette opération avant de quitter votre travail et laisser la conversion se dérouler durant la nuit. Une fois la conversion terminée, pensez à nettoyer le contenu du répertoire c:\atoum\temp pour des raisons de sécurité. Etant donné que la conversion peut prendre un certain temps et que l’on n’est jamais à l’abri d’un problème, ne fusse que d’une coupure de courant, il est prévu de pouvoir continuer une conversion qui a échoué. Pour continuer une conversion, il suffit de relancer la conversion. Celle-ci reprendra à l’endroit où elle s’était arrêtée. Différents états de votre dossier par rapport à la conversion : Pour connaître l’état de la conversion, veuillez ouvrir l’écran des données de l’institution où vous avez entre autre spécifié la catégorie de l’institution. Cet écran reprend les dates de début et de fin de conversion.

Accès aux caractéristiques de votre institution


p.17-

Données de votre institution

1. Il n’y a pas encore eu de demande de conversion (dates de début et de fin vides) :

• On peut commencer l’encodage

• On peut demander la conversion (si l’on n’a pas encore commencé l’encodage)

2. Une conversion a été demandée, mais est encore en cours ou a échoué (date de début remplie, date de fin vide) :

• On ne peut pas commencer l’encodage tant que la conversion n’est pas terminée

• On peut demander de continuer la conversion interrompue (le système vérifie qu’il n’y a pas déjà une conversion en cours afin de ne pas lancer plusieurs conversions simultanément)

3. La conversion est terminée (dates de début et de fin remplies):

• On peut commencer l’encodage

• On ne peut plus demander de conversion

Après la conversion, les fichiers de la base de données seront inutilement volumineux.

Reportez-vous au chapitre « Compactage et Réparation des bases de données MS-Access » du

manuel utilisateur pour réduire la taille des fichiers.


p.18-

Accès depuis d'autres machines Si vous travaillez en réseau, l'application sera utilisable depuis toutes les machines de votre réseau et cela sans aucune installation supplémentaire sur celles-ci. Ces utilisateurs ne pourront pas utiliser 'localhost' ou '127.0.0.1' car cela ne fonctionne que sur la machine où est installé le serveur Tomcat. Ils seront obligés d'utiliser soit le nom du serveur ou encore son adresse IP comme indiqué ci-dessous :

http://nom_du_serveur:8080/atoum/application/login.jsp http://adresse_ip_du_serveur:8080/atoum/application/login.jsp Notez que cette façon d'appeler l'application fonctionne également lorsqu’on travaille sur le serveur.

Arrêt du serveur Tomcat Lorsque vous avez fini de travailler, vous pouvez arrêter le serveur Tomcat afin de libérer des ressources. Pour ce faire, il suffit d’exécuter l'option "Stop service" dans le menu « ATOUM Web Forms Engine ». Si vous travaillez en réseau, assurez-vous au préalable qu'il n'y a plus d'utilisateurs occupés à travailler sur le serveur.

Menu "ATOUM Web Form Engine"

Documents

« Résumé Psychiatrique Minimum · startup_guide_fr.doc p.2- Introduction Ce guide a pour but de vous aider à faire vos premiers pas dans la nouvelle version de l'application "Résumé