"Minimale Psychiatrische Gegevens" Startgids Versie 2.1.03
startup_guide_nl.doc
Inleiding Deze gids heeft tot doel u te helpen bij uw eerste kennismaking met de nieuwe versie van de toepassing "Minimale Psychiatrische Gegevens". Hij zal u begeleiden tot wanneer u een operationeel systeem bekomt.
U zult merken dat er vaak verwezen wordt naar het product ATOUM. ATOUM werd ontwikkeld met als doel verschillende toepassingen tegelijk te laten draaien zoals de "Minimale Psychiatrische Gegevens". Het gaat in zekere zin om de omgeving waarin de toepassing "Minimale Psychiatrische Gegevens" werkt. Momenteel werkt de toepassing "Minimale Psychiatrische Gegevens" als enige in deze omgeving maar het zou kunnen dat er later nog andere toepassingen worden toegevoegd.
Installatie van de componenten De cd-rom bevat alles wat u nodig hebt om de omgeving te installeren die nodig is voor "ATOUM" en de toepassing "Minimale Psychiatrische Gegevens" te gebruiken in uw instelling. De installatie start automatisch wanneer u de cd-rom in uw lezer steekt. Als dit niet het geval zou zijn, voer dan gewoon het programma uit die zich bevindt in de ‘install’ directory van de cd-rom. Hoewel de installatie niet ingewikkeld is, dient u toch aandachtig de bijgeleverde toelichtingen te lezen tijdens de installatie. De installatie vereist geen enkele technische competentie, u moet de installatie uitvoeren door alle opties op de default waarde te laten staan. De toepassing ATOUM is een webtoepassing De installatie moet dus slechts op één enkele machine gebeuren ("Server" genaamd). Geen enkele installatie dient te gebeuren op de andere machines ("Clients" genaamd) die toegang hebben tot de toepassing. Een gewone browser (zoals Microsoft Internet Explorer) volstaat om de toepassing te gebruiken. Geinstalleerd componenten : • De Java 2 SDK bevat de Java-library's die noodzakelijk zijn voor de werking van de server. • De Tomcat server is een server voor webtoepassingen geschreven in Java. • De ATOUM toepassing De installatie van deze componenten heeft geen impact op andere reeds geinstalleerde toepassingen op de server.
De Tomcat-server opstarten U hebt zopas de installatie. Het is tijd om na te gaan of uw systeem correct werkt. De toepassing ATOUM heeft een server nodig om te werken. Deze server is de Tomcat-server die u zopas geïnstalleerd hebt. Om deze server op te starten, dient u de optie "Start server" uit te voeren in het menu "ATOUM Web Form Engine" van het menu "Start".
p.2-
startup_guide_nl.doc
Menu "Atoum Web Form Engine" Bij het opstarten van de server Tomcat, zult u vaststellen dat een DOS venster zich opent. Dit venster vormt de console van de server, de console waarin alle lopende verrichtingen blijken. Gelieve deze console niet te sluiten want dat zou als gevolg hebben dat de server brutaal stopt, u kunt het daarentegen minimaliseren.
Het DOS venster van de console Tomcat komt eveneens in de taakbalk.
Het opstarten van de server Tomcat kan enkele seconden duren, in het bijzonder bij een installatie of een update van de toepassing. De aanwijzing "INFO: Server startup in xxxxx ms "duid aan wanneer de server is opgestart en bereid is om de aanvragen van de gebruikers te beantwoorden.
De server Tomcat heeft is opgestart. De aanwijzing "INFO: Server startup in 15563 ms "deelt mee dat hij klaar is. We gaan nu verifiëren of de server correct werkt. Hiervoor volstaat het dat u uw Internet Explorer opent en het adres "http://localhost:8080" vraagt. U zou de onthaalpagina van de server moeten bekomen. Als dit niet werkt, kunt u ook het adres "http://127.0.0.1:8080" proberen. In dit geval dient u hiermee rekening te houden voor het vervolg van de procedure door "localhost" systematisch te vervangen door "127.0.0.1".
p.3-
startup_guide_nl.doc
Onthaalpagina van de Tomcat-server
De toepassing een eerste keer oproepen De toepassing is beschikbaar op het adres:
http://localhost:8080/atoum AANDACHT: deze eerste keer dat u de toepassing oproept, is een kritiek moment want het systeem gaat een aantal zaken configureren. Het is dus zeer belangrijk dat u de bewerkingen laat doorlopen tot het einde zonder ze te onderbreken, ook al vindt u dat u lang moet wachten of denkt u dat het systeem geblokkeerd is. De tijd die nodig is om de toepassing de eerste keer op te roepen, bedraagt zo’n 10 minuten maar kan sterk variëren van de ene machine tot de andere en is ook afhankelijkheid van de te realiseren taken Tijdens deze eerste oproep gaat ATOUM misschien een aantal parameters opladen. Atoum zal ook willekeurige wachtwoorden toekennen aan de gebruikers die reeds aanwezig zijn in het systeem. Deze wachtwoorden zullen u slechts één keer meegedeeld worden. Neem er dus nota van wanneer ze verschijnen.
p.4-
startup_guide_nl.doc
Oplading van de parameters aan de gang … (Facultatief)
Toekenning van de wachtwoorden.
p.5-
startup_guide_nl.doc
Identificatie Naargelang uw taalrol dient u zich te verbinden aan de hand van de gebruiker ADMINF of ADMINN met het wachtwoord dat hen eerder werd toegekend. U zou op de onthaalpagina van de toepassing moeten terechtkomen.
Onthaalpagina van ATOUM
p.6-
startup_guide_nl.doc
Het dossier van uw instelling aanmaken In het menu "Administratie" kiest u de optie "Beheer dossiers".
Met de optie "Een nieuw dossier creëren" in het onderste deel links van het scherm kunt u de nodige informatie invoeren. Alle gegevens zijn verplicht. Weet echter dat het identificatieveld alleen dient om het dossier te identificeren en geen enkele invloed heeft op het vervolg van het werk. U bent bijgevolg volledig vrij wat de keuze van deze identificatie betreft. De taalrol vermeldt de talen die in uw instelling gebruikt worden. Dit zal bijvoorbeeld nuttig zijn bij de creatie van de leefeenheden om de omschrijving van de leefeenheid mee te delen in alle gebruikte talen. Deze informatie van de taalrol zal achteraf op elk moment gewijzigd kunnen worden. Tot slot dient u nog "Minimale Psychiatrische Gegevens" te kiezen als toepassing van het dossier en uw informatie op te slaan.
p.7-
startup_guide_nl.doc
Scherm voor de creatie van het dossier
p.8-
startup_guide_nl.doc
In hetzelfde scherm dient u te drukken op de knop "Activering" in het bovenste gedeelte. Selecteer de waarde "db_data" of "db_data_fixed" in de lijst van de mogelijkheden, activeer het dossier met behulp van het aankruishokje en sla op. Kleine instellingen selecteren best de waarde "db_data". Middelgrote en grote instellingen selecteren echter beter de waarde "db_data_fixed". Meer informatie hierover vindt u in het hoofdstuk in verband met de databases in de gebruikershandleiding.
Scherm voor de activering van het dossier
p.9-
startup_guide_nl.doc
Het werkdossier kiezen De optie "Dossierkeuze" van het menu "Editeren" biedt u de mogelijkheid om uw werkdossier te kiezen. Selecteer het zopas gecreëerde dossier. Als dit laatste in het grijs wordt weergegeven, dan hebt u het waarschijnlijk niet correct geactiveerd zoals hierboven uitgelegd.
p.10-
startup_guide_nl.doc
De gegevens van de MPG invoeren De optie "Gegevens" van het menu "Editeren" geeft u de interface waarmee u gegevens kunt invoeren. Vooraleer u uw gegevens kunt beginnen in te voeren, moet u uw instellingscategorie specificeren want zij heeft een impact op de gegevens die u zult moeten invoeren, alsook op bepaalde parameters zoals de lijst van de beschikbare Indexen van bedden (diensten). Hiervoor dient u te klikken op het potlood rechts van "Instelling" in het linkerdeel. Alle gegevens op dit scherm zullen later gewijzigd kunnen worden behalve de categorie. Eens de categorie gedefinieerd is, kunt u ze niet meer veranderen. Sla deze gegevens op. Uw dossier is nu helemaal klaar voor de invoering van de gegevens.
De categorie van de instelling definiëren
Omvorming van het Patiëntnummer in Nummer medische behandeling. Deze omvorming wordt automatisch uitgevoerd door de toepassing volgens de opgestelde regels. Startdatum. Deze omvorming moet niet toegepast worden op de reeds geëxporteerde medische behandelingen. Men zal zich baseren op de begindatum van de medische behandeling om te bepalen of er al dan niet een omvorming doorgevoerd moet worden. Het is mogelijk deze datum te veranderen maar deze datum is door het Federal Overheidsdienst vastgelegd.
p.11-
startup_guide_nl.doc
Omvormingsmasker. Het gaat niet om een echte encryptie maar eerder om een willekeurige productie van een Behandelingsnummer. Het is echter mogelijk deze omvorming te beïnvloeden via een masker. Een wijziging van masker heeft alleen effect op de nieuw aangemaakte Behandelingsnummers. Het werkt dus niet retroactief. Dit Behandelingsnummer bestaat net als de referentie van de patiënt uit 13 alfanumerieke tekens. Men kan het type van elke positie van het masker bepalen. Zo kan men kiezen voor dezelfde syntaxis als bij de patiëntreferenties die gebruikt worden door de instelling. Het standaardmasker is “?????????????” (13 volledig toevallige tekens).
a) Toevallige posities. Deze posities worden op een toevallige wijze aangemaakt door de toepassing. Er zijn minstens 8 toevallige tekens nodig opdat het masker geldig zou zijn, de plaatsing heeft geen belang. ? ! #
: om het even welk cijfer of letter : om het even welk letter : om het even welk cijfer
b) Constanten. Men kan eveneens constanten specificeren in het masker. De geldige constanten zijn : A-Z,0-9,-, spatie en / Voorbeeld van maskers : - Men wil dat de Behandelingsnummers beginnen met “PAT” gevolgd door 10 cijfers die willekeurig zijn aangemaakt. PAT########## Voorbeelden : PAT1569874125, PAT8964129658, ... - Men wil slechts 8 posities : ???????? Voorbeelden : A78T7UF7, 25TPW7A8, ... - Men wil de geëncrypteerde referenties onderscheiden via een bijzondere syntaxis bestaande uit 3 cijfers, een -, 3 cijfers, een - en 3 cijfers : ###-###-### Voorbeelden : 492-175-029, 826-746-148, ...
p.12-
startup_guide_nl.doc
Een standaardwaarde is voorzien voor mask id. patiënten en de overgansdatum.
p.13-
startup_guide_nl.doc
Uw huidige gegevens recupereren U hebt de mogelijkheid om de gegevens van de oude DOS-toepassing te recupereren. Indien u gegevens hebt gearchiveerd, gelieve deze terug op te laden alvorens de conversie uit te voeren.
In de loop der jaren kunnen er anomalieën in uw gegevens geslopen zijn. Wij raden u dan ook aan om uw gegevens te verifiëren aan de hand van de utility RMPGCHK.EXE. Het zou namelijk jammer zijn dat er fouten getransfereerd zouden worden naar het nieuwe systeem. U vindt deze utility en handleidingen (chk_v2-3_f.pdf, chk_v2-3_n.pdf) in de directory "c:\atoum\bin". Aangezien dit buiten de context valt, nodigen wij u uit om uw coördinator te contacteren voor bijkomende informatie.
Begin met het lokaliseren van de gegevens van uw instelling. Het zou in de meeste gevallen moeten gaan om een directory die de naam van uw instelling draagt en zich bevindt in de directory "c:\rpm" of "c:\mpg" zoals bijvoorbeeld c:\mpg\mijninstelling.
In meer complexe configuraties (wanneer de database zich in een netwerk bevindt met name) of gewoon om u ervan te vergewissen, kunt u de optie "7 – MPG Verantwoordelijke / 7 – Informatie / 1 – Toepassinginformatie" van de oude toepassing gebruiken om u te helpen bij uw opzoekingen. De informatie "Gegevens" geeft u de locatie van uw databases aan. U zult in deze directory subdirectories vinden die overeenstemmen met elk van uw dossiers.
Het zou bijvoorbeeld kunnen gaan om "i:\applic\clipper\mpg\version4\mijninstelling".
p.14-
startup_guide_nl.doc
Alvorens u de gegevens kunt recupereren in de nieuwe toepassing, moet u een bewerking uitvoeren waardoor ze leesbaar gemaakt worden. Dit gebeurt aan de hand van het volgende DOS commando: c:\atoum\bin\UNCRYPT.EXE gegevens_directory gebruiker [wachtwoord] Voorbeelden: c:\atoum\bin\UNCRYPT.EXE c:\rpm VERA xyz c:\atoum\bin\UNCRYPT.EXE i:\applic\clipper\mpg\version4 VERA xyz Dit commando moet in de DOS omgeving uitgevoerd worden. U zult zeker een shortcut op uw desktop of een optie in uw “Start” menu genaamd “DOS Prompt” vinden om dit omgeving te bereiken. Dit commando zal alle instellingen behandelen die toegankelijk zijn voor de gebruiker en het wachtwoord die opgegeven zijn. Als deze gegevens (gebruiker en/of wachtwoord) verschillend zijn per instelling, zult u dit commando verschillende keren moeten uitvoeren door de gebruiker en het wachtwoord aan te passen teneinde de gegevens van al uw instellingen voor te bereiden. De gegevens van uw instellingen zullen dan voorbereid en gekopieerd worden in de directory "c:\atoum\temp". Dit heeft geen enkel effect op uw originele gegevens. De oude toepassing zal werken zoals vroeger. Eens deze bewerking voltooid is, gaat u in het menu "M.P.G." van de nieuwe toepassing. U kiest het dossier waarin u de gegevens wenst te importeren en vraagt de optie "Conversie". Dit zal echter alleen mogelijk zijn als u nog niet gewerkt hebt in dit dossier (behave de introductie van de technische gegevens van uw instelling). Dit dossier moet helemaal leeg zijn. U moet ook de categorie ervan gespecificeerd hebben. In dit conversiescherm dient u "c:\atoum\temp\inst\adm.dbf" aan te geven in de daartoe voorziene zone en dan drukt u op de knop "Converteren". Een nieuw venster wordt geopend waarin u informatie krijgt over de vordering van de conversie. Let op dat u de Tomcat-server vooral niet stopt alvorens u de bevestiging hebt gekregen dat de conversie beëindigd is.
p.15-
startup_guide_nl.doc
AANDACHT: de recuperatie van de gegevens kan verschillende uren duren. Hou hiermee rekening als u de computer absoluut moet uitschakelen. Om geen vertraging op te lopen in uw werk, kunt u deze bewerking opstarten vooraleer u het werk verlaat zodat de conversie tijdens de nacht kan plaatsvinden. Eens de conversie beëindigd is, mag u niet vergeten de inhoud van de directory c:\atoum\temp te wissen om veiligheidsredenen. Aangezien de conversie vrij lang kan duren en er zich altijd een probleem kan voordoen, bijvoorbeeld een stroompanne, is het voorzien dat een onderbroken conversie voortgezet kan worden. Om een conversie voort te zetten, volstaat het de conversie opnieuw op te starten. Zij zal voortgaan vanaf de plaats waar ze was gestopt. Uw dossier kan verschillende statussen aannemen met betrekking tot de conversie: Om de status van de conversie te kennen, opent u het scherm met de gegevens van de instelling waar u onder andere de categorie van de instelling hebt ingevuld. Dit scherm bevat de begin- en einddatum van de conversie.
Toegang tot de eigenschappen van uw instelling
p.16-
startup_guide_nl.doc
Gegevens van uw instelling 1. Er is nog geen conversie gevraagd (begin- en einddatum zijn leeg): • U kunt beginnen met de invoering van de gegevens • U kunt de conversie aanvragen (als de invoering nog niet begonnen is) 2. Er werd een conversie gevraagd maar ze is nog bezig of ze is mislukt (begindatum is ingevuld, einddatum is leeg): • U kunt niet beginnen met de invoering zolang de conversie niet beëindigd is • U kunt vragen om de onderbroken conversie voort te zetten (het systeem controleert of er nog geen conversie bezig is om geen verschillende conversies tegelijk op te starten) 3. De conversie is beëindigd (begin- en einddatum zijn ingevuld): • U kunt beginnen met de invoering van de gegevens • U kunt geen conversie meer aanvragen Na de conversie zullen de bestanden van de database onnodig groot zijn. Raadpleeg het hoofdstuk “MS-Access-databases comprimeren en herstellen” van de gebruikershandleiding om de grootte van de bestanden te verkleinen.
p.17-
startup_guide_nl.doc
Toegang vanaf andere machines Als u in een netwerk werkt, zal de toepassing gebruikt kunnen worden vanaf alle machines van uw netwerk en dit zonder dat u hierop bijkomende installaties moet doen. Deze gebruikers zullen "localhost" of "127.0.0.1" niet kunnen gebruiken want dit werkt alleen op de machine waarop de Tomcat-server geïnstalleerd is. Zij zullen verplicht zijn om ofwel de naam van de server te gebruiken ofwel zijn IP-adres zoals hieronder aangegeven:
http://naam_van_de_server:8080/atoum/application/login.jsp http://ip_adres_van_de_server:8080/atoum/application/login.jsp Merk op dat deze manier om de toepassing op te roepen ook werkt wanneer men op de server werkt.
De Tomcat-server stopzetten Wanneer u klaar bent met werken, kunt u de Tomcat-server stopzetten om resources vrij te maken. Hiervoor dient u enkel de optie "Stop service" in het menu « ATOUM Web Forms Engine » uit te voeren. Als u in een netwerk werkt, dient u vooraf na te gaan of er geen gebruikers meer aan het werken zijn op de server.
Menu "Atoum Web Form Engine"
p.18-