Installatiehandleiding Vierkleurenpen.

Vierkleurenpen bestaat uit drie hoofdonderdelen:

1. database
2. dataserver
3. client

Installeer de database

Vierkleurenpen werkt met sql server 2008 en ook nog met sqlserver 2005

Installatie van de database op een windows computer

Als sqlserver wordt gebruikt worden er geen speciale eisen aan de installatie van de sqlserver gesteld. Uiteraard moet er wel voldoende capaciteit aanwezig zijn.

Een installatie van sql server express (kosteloze versie van sqlserver2008 R2) kan mooi via de microsoft platform installer (database grootte 10Gb, 1 processor, 1Gb geheugengebruik). Installeer minimaal het standaard pakket (inclusief sql management studio).

Verwerk de volgende sql-files in de aangegeven volgorde op de goede database (als je op de file klikt opent hij in management studio, dan kan je hen ook uitvoeren):

1. sqlservertabledefs.sql
2. vkpcontents.sql

Installeer de Dataserver.

De dataserver werkt het best als hij deel uitmaakt van een active directory waarvan de clients ook deel uitmaken. Dan zijn de toegangsrechten goed te beperken tot bepaalde gebruikers. Andere configuraties zijn niet getest. Bij een open systeem is geen AD nodig en kan de toegang niet gemakkelijk worden beperkt

1. Kopieer de subdirectory \vierkp (met de inhoud) van de naar de dataserver (bijvoorbeeld c:\vierkp).
2. Run Vierkpserver, en stop dit programma weer. Nu is vierkpserver geregistreerd op de dataserver PC.
3. Maak van deze directory een gedeelde map met leestoegang voor de vierkleurenpengebruikers en ook schrijftoegang voor de vierkleurenpenbeheerders (hoeft niet niet voor stand-alone)
4. Dit punt hoeft niet als de dataserver en de pc waarop vierkleurenpen draait dezelfde zijn, dus in een test of demo-opstelling.
   • Maak een domainaccount met beheerdersbevoegdheden op de server, met een niet verlopend wachtwoord.
   • Zorg dat er een gebruikersgroep is waarvan de clientgebruikers lid zijn, bijvoorbeeld vierkp_users. Als je een open systeem wil gebruik dan iedereen/everyone. Verderop wordt de naam vierkp_users voor deze groep gebruikt
   • In XP/2003 kies systeembeheer - Component Services - Computers - Deze computer - DCOM configuratie
   • zoek vierkpremote object, rechts klikken op properties
   • Als vierkpremote object niet in de lijst staat is er iets met de registratie van het programma misgegaan (zie hierboven)
   • Selecteer het tabblad Identity. Kies hier 'This user' in plaats van 'The lauching user'
     Kies via browse het te gebruiken account met lokale beheerdersbevoegdheden op deze computer. Dit moet een domeinaccount zijn als er op een domein wordt gewerkt. Vul hier ook het juiste wachtwoord in.
   • Tab security: aangepast, voeg hier de groep vierkp_users toe, en geef deze alle rechten (lokaal en extern starten, lokaal en extern activeren)
   • Tab access/toegangsmachtigingen: voeg ook hier vierkp_users toe en geef lokaal en extern toegang
   • De rest van dcomcnfg kan default blijven staan. De toegangscontrole gebeurt dus op het nivo van Dcom.
   • In Windows Server 2003 moet ook de externe toegang van COM worden geactiveerd
     1. In component Services klik rechts op Deze computer, kies dan Eigenschappen
     2. Kies tab COM-beveiliging en machtigingen voor toegangsrechten, vervolgens Beperkingen bewerken
     3. Zorg dat hier vierkp_users aanwezig is en rechten heeft om lokaal en extern toegang te krijgen
     4. Doe dit ook voor machtigidbexpngen voor starten en activeren, geef vierkp_users rechten om te starten en te activeren, zowel lokaal als extern.
     5. Om een systeem met open toegang te maken moet 'iedereen/everyone' deze mogelijkheden hebben (zie boven) én het gastaccount moet geactiveerd zijn
   • Herstart de computer om de toegevoegde rechten actief te maken.
   • Als voor de server WinXP sp2 wordt gebruikt moet deze toegang op een andere manier worden aangezet:
     1. Click Start, click Run, type regedit, and then click OK.
     2. Locate and then click the following registry subkey: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\RPC
     3. If this subkey does not exist, follow these steps:
        • a. Locate and then click the following registry subkey: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT
        • On the Edit menu, point to New, and then click Key.
        • Type RPC as the subkey name, and then press ENTER.
        • Right-click RPC, point to New, and then click DWORD Value.
        • Type RestrictRemoteClients as the entry name, and then press ENTER.
        • Right-click the RestrictRemoteClients entry, and then click Modify.
        • In the Value Data box, type 0 (zero), and then click OK.
        • Quit Registry Editor.
        • Restart your computer.

Instellen van de server en de client-pc

1. Draai het programma vkpsetup op de client PC. Start dit programma in de server-directory waar ook vierkpserver.exe in staat. Om algemene instellingen te maken moet de user schrijftoegang hebben in deze programmadirectory en rechten om vierkleurenpen te draaien.
2. Kies het tabblad: Alle Clients.
   • Geef bij dataserver aan de naam of het ip-nummer van de dataserverpc. Leeglaten betekent dat de dataserver op de lokale pc draait.
   • Programmanaam: Vierkleurenpen. Je kunt het anders noemen, desnoods NoEpiduralsAtNight, maar liefst Vierkleurenpen.
   • Lengte patiëntnummer: is de lokale lengte van de patientID (hiscom/Isoft en UMCU: 7, Chipsoft 11)
   • Ziekenhuis: voor ziekenhuis-specifieke instellingen (hl7, regionaal oplossingen).
   • Zet Klok Gelijk: zet bij de start de clientklok gelijk met de serverklok. Systeem is gevoelig voor tijdsverschillen, maar een goed windows systeem synchoniseert zelf zijn clients al. Kies een passende instelling
   • Help-nieuw: de mogelijkheid om uitgebreide info te tonen over vernieuwingen
   • Mailen mogelijk: de mogelijkheid om berichtjes tussen werkplekken uit te wisselen. Gebruikers houden daar vaak van
   • Lab van Mirador: regelt o.a. de aanwezigheid het lab-label. De functie is vrij specifiek voor de UMCU-architectuur
   • Webserver geeft aan welke server het ok-overzicht laat zien. De moeite van het installeren waard. orders@vierkleurenpen.com
   • Checklist in beeld: Op het umcu is een web checklist gekoppeld aan de applicatie. Elders nog niet aanvinken
   • Cliëntinstellingen vervolgens opslaan
3. Kies tabblad Gevorderden: Server
   • Naw-server en port: de (tdm)-server voor de hl-7 koppeling en het bijbehorende poortnummer, als gebruik gemaakt wordt van de hl-7 koppeling. Vink 'alle patienten in db' aan als op een produktieserver wordt gewerkt, op een acceptatieserver niet aanvinken. (in dat geval bestaat nl de mogelijkheid dat een patientnummer niet in de schaduwdatabase aanwezig is)
   • Mailserver/afzender mailadres: de naam van de smtpserver invullen (voor umcu:mail.umcutrecht.nl), leeglaten als er geen bruikbare mailserver op het interne netwerk (intranet) is. Vul bij afzender mailadres een geldig mailadres op de mailserver in.
   • De computer\instance waaop de database draait. Voor een lokale PC met sqlexpress is dat dus: localhost\sqlexpress.
   • Database account (OK_RW), database wachtwoord –host en –naam spreken voor zich, als sqlserver-trusted wordt gekozen wordt het de user waaronder vierkpserver draait het database account.
   • Webserver en herinneringmail zijn nodig om de de gebruikers een mail te sturen als deze niet hun NVA-complicatieregistratie invullen. Deze mail verwijst dan naar een link op 'webserver'. (umcu-only)
   • Sla de gegevens op, sluit vkpsetup af en open het opnieuw, ga dan naar tabblad test en controleer of de database wordt gevonden.
4. Kies tabblad: Deze client. Voor dit tabblad zijn geen schrijfbevoegdheden nodig, wel een werkende dataserver.
   • Oknummer: het nummer van de ok voor registratie (1-100). Een niet-numerieke inhoud (bv een stafkamer) maakt van de VKP een alleen-lezen versie. Als een gebruiker met de naam oknn inlogt, of met anefnn, waarbij nn een getal is, wordt het oknummer gewijzigd in nn.
     als de gebuikersnaam recnn is wordt het oknummer nn+60 (max 100)
     als de gebuikersnaam sehnn is wordt het oknummer nn+50 (max 60)
     als de gebuikersnaam holdnn is wordt het oknummer nn+45 (max 50)
     
   • Kies het juiste monitortype en com-poort voor als de pc op een OK staat.
   • kies eventueel aanvullende monitors en hun compoorten.
   • kies het type OK, wat invloed heeft op de weergave van de events en van de presets bij de inleiding.
   • als computer voor de verkoever is ingesteld vink dan aan of daar automatisch moet worden geprint.
   • Druk op lokale instellingen opslaan
5. Kies 'afsluiten' en klaar
6. In de directory waar vierkleurenpen in staat (het beste dus een gedeelde directory op de server) moeten nu ook de volgende bestanden staan: vkpserversettings.xml en vkpclientsettings.xml.
7. Zet een link naar vierkleurenpen op het bureaublad van de gebruiker, (of liever voor all users)

Vkpersoneel wordt gebruikt om personeel in te voeren

• Verplicht is het veld pasnummer, hier moet een uniek getal staan.
• Anest=anesthesioloog
• Aios=arts in opleiding tot specialist. Hier kan elke arts/niet-anesthesioloog staan
• Anver=anesthesieverpleegkundige/medewerker
• Met oknummer kan een ok waar die persoon niet of nauwelijks werkt uit het rijtje wat je standaard op die OK te zien krijgt worden gehaald.
• Het e-mailadres wordt gebruikt om herinneringen voor de nva-registratie te sturen
• Het seinnummer komt op de postoperatieve lijst.

Bekabeling en interface-instellingen

• Voor een datex monitor moet een female-female 9 pins kruiskabel worden gebruikt. De aansluitingen zijn: 2—3, 3—2, 5—5, 7—8, 8—7.
• Voor een hp-monitor (bijv hp viridia 26/24 server) moet een kabel volgens de hp-specificaties worden gemaakt (zie hier). De rs232 verbinding (achter de bekende geheime instelcode) moet als volgt zijn ingevuld: Poort 1 (als er meer poorten zijn), 38400 baud, Low/High byteorder.
• Voor Intellivue monitor geldt baudrate 115200, fixed, in te stellen in het service menu.
• Voor de Siemens Infinity monitor is gewoonlijk een speciale kabel nodig, baudrate ligt vast op 19200.
• Er kan ook een externe datex capnomac capnograaf (bestaan ze nog?), een externe bis-monitor en/of een sorin hartlongmachine, of een beademingstoestel worden aangesloten. Er moeten dan voldoende rs232-poorten aanwezig zijn, bijvoorbeeld via usb-rs232 converters.
• Een Dräger beademingsapparaat met een Medibus protocol (cicero, Cato, Zeus) kan worden aangesloten via een 3-draads gekruiste (nulmodem) RS232 kabel op een extra poort. De instellingen zijn: 9600 baud, 8 bits, even parity, 1 stopbit.
• Een Dräger Zeus met geintegreerde monitor werkt ook via zo'n poort met dezelfde kabel en instellingen.
• Hartlongmachine: de sorin hartlongmachine moet met een simpele nulmodem (3 draads is voldoende) worden verbonden met de rs232. poortinstellingen Sorin (komen op display als je de witte knop naast de poort indrukt) dbms, baudrate 9600. Via vkpsetup natuurlijk de juiste poort instellen.

Enige uitleg over de (hierarchische) opbouw van de tabel tb_preset_config:

• De veldnamen moeten je al een indicatie geven wat er in moet komen.
• Infuusx-type is de naam van het infuus( bv: 20 G li). Als je exact dezelfde tekst gebruikt als in het inleidingsrijtje staat wordt deze geselecteerd, anders wordt de tekst toegevoegd en geselecteerd.
• Infuusx_fluid is de integer code in tb_infusion_fluid_bags, volume is zakvolume
• Induction_drug, opiaat_drug en relaxant_drug komen binnen de keuzevakjes en zijn bij te regelen. Hier de naam van de drug zoals bekend is in het systeem.
• Fixedmedication is een vaste tekst, bv '1,2 g augmentin', weer in een goed format.
• Pumps is analoog aan infusen.
• Airway_type is de omschrijving van de tube, ook hier wordt eerst met het bestaande rijtje vergeleken, daarna eventueel toegevoegd. Bij vrouwen prevaleert airway_female als dat is ingevuld.

Hoe worden de config_id codes gebruikt:

• Als een config id niet wordt gevonden wordt overgegaan naar de volgende stap
• Als cardio is aangevinkt (via vkpsetup of met de hand) wordt config_id 222 ingelezen
• Anders als obstetrie is aangevinkt dan config_id 223
• Anders als kind is aangevinkt en de patiënt is jonger dan 18 jaar, of als de patiënt jonger is dan 10 jaar, ook zonder dat kind is aangevinkt, wordt config_id 224 ingelezen
• Daarna wordt het record met het oknummer gezocht en ingelezen.
• Daarna wordt de de ok-groep opgezocht en daarbij 230 opgeteld. Dit is de config_id die dan wordt ingelezen
• Daarna wordt config_id 200 ingelezen,
• Daarna wordt de default gebruikt

Tabelstructuur voor aanpassen infuzen, pompen, medicatie, events, werkplektype en parameterkleuren

De opbouw van het bestand tb_drugs_dosing:

• medicijn. De zoveel mogelijk generieke naam van het medicijn dat wordt getoond als het voor de eerste keer bij een casus wordt gegeven. Ook als men erg gewend is aan merknamen went de stofnaam hier heel snel.
• medicijn_afko. Een vaak kortere naam die wordt getoond als het medicijn voor een tweede keer wordt gegeven.
• Unit. eenheid. De µg wordt soms verkeerd weergegeven bij opbouw van de database. Hier kan hij zonodig weer verbeterd worden.
• maxdose. Grens waarboven een waarschuwing wordt gegeven. Ook gebruikt bij convers(ie).
• mindose. Analoog aan maxdose.
• Convers. Als convers <> 0 is wordt eerst gekeken of de opgegeven dosering binnen de range tussen maxdose en mindose valt, zoniet wordt de dosering met convers vermeningvuldigd en wordt opnieuw gekeken of het erbinnen past. Door goede keuze van maxdose, mindose en convers kan een produkt wat in microgrammen en milligrammen wordt genoemd (alfenanil) zo probleemloos ingevuld worden.
• Drugtype: Long : komt op postopuitdraai. Relax: groen, relaxant. Pain: rood, opiaat. Abio: antibiotica, komt ook op postoplijst. Local: LA. Wordt niets mee gedaan.
• De medicijnen paracetamol-iv, paracetamol-po en paracetamol-rect, evenals diclofenac-po, diclofenac-iv en diclofenac-rect moeten aanwezig zijn in verband met speciale behandeling van deze pijnstillers
• Epinefrine moet in microgrammen worden weergegeven

De opbouw van tb_drugs_abbr:

• abbr: Het gewenste synoniem voor het medicament.
• expanded: De naam van medicijn in tb_drugs_dosing.
• Kies de afko zo dat er geen verwarring ontstaat bij op elkaar gelijkende stoffen die beide weleens worden gegeven.
• Er is een zwakte in de tabellen: een medicament wordt alleen weergegeven in vierkleurenpen als hij ook minstens éénmaal in tb_drugs_abbr voorkomt.

De opbouw van de tabel tb_handelingen:

• Handel-ident: een uniek zelf te kiezen nummer.
• handeling: de in het rolmenu weergegeven event
• handel_type: groepeert de handelingen alfabetisch binnen een groep. De naam wordt verder niet gebruikt. Door lege velden slim te kiezen worden de groepen visueel van elkaar gescheiden.
• tegenhandeling: Als hier een nummer <> 0 staat wordt een klokje gestart bij het aanvinken die weer stopt bij het aanklikken van de de event met de handel_ident die in tegenhandeling staat.
• cardio.. overig: als hier een getal <> 0 staat wordt de event weergegeven als het ok-type (menuitem) overeenkomt met de kolomnaam. Hierdoor wordt een slimme selectie mogelijk in de eventlijst. 'Overig' wordt gebruikt voor obstetrie. Algemeen komt op alle ok-lijsten voor. Seh en recovery worden weergegeven als het oktype 'seh' of 'rec' is.
• Handelingen die niet meer ingebruik zijn kunnen gewoon worden gewist, de tekst staat toch wel in de database.

De pompen: opbouw van de tabel tb_pump_fluids:

• Infusion_fluid_code: een zelfgekozen uniek nummer
• fluid_name: naam zie in het keuzemenu veschijnt
• fluid_abbr: naam dia op de lijst verschijn en niet t elang mag zijn ivm de beperkte breedte van de eerste kolom
• display_priority: het keuzemenu wordt in volgorde van display_priority getoond. Als hier een negatief getal staat wordt het item niet getoond. Zie verderop.
• display_color de kleur van de lijn in vierkleurenpen.
• fluid_description wordt nietgebruikt.
• epiduraal: als hier <> 0 staat komt het item in de pagina epiduraal, anders op de hoofdpagina.
• Pompen wordt ge-archiveerd onder het nummer van infusion_fluid_code. Als een code eenmaal gebruikt is mag hij daarom niet meer worden verwijderd of veranderd, anders verstoort de weergave van de gearchiveerde lijsten. Daarom is er de er mogelijkheid van niet-weergeven door negatieve display_piority

De infusen: tb_infusion_fluid_types

• 1. fluid_type type vloeistof .
• 2. fluid color_code: kleur van dat type vloeistof
• 3. fluid_color: commentaar voor kleur

tb_infusion_fluid_bags

• 1. infuus_vloeistof : unieke code
• 2. fluid_type: een keuze uit tb_infusion_fluid_types
• 3. fluid_name: in keuzelijst weergegeven naam
• 4. fluid_abbr: 2 letter afkorting op vierkleurenpen
• 5. display_priority: het keuzemenu wordt in volgorde van display_priority getoond. Als hier een negatief getal staat wordt het item niet getoond. Zie bij infuuspompen.
• 6. volume_1, volume_2, volume_3: achtereenvolgens de volumes die in een keuzelijstje komen bij een geselecteerde infuusvloeistof
• als bij infuuspompen kunnen oude codes niet worden verwijderd, maar met display_priority worden ze onzichtbaar gemaakt

De werkplek soorten en aliassen: tb_werkplektype:

• 1. ok_nr (string): hier dienen 100 records aanwezig te zijn met ok_nr van 1 tot 100. de dataserver rekent daarop.
• 2. groep: een integer die de groep ok's aangeeft waarbij deze ok hoort. Recovery's met dit nummer laten bijvoorbeeld de ok's van dezelfde groep(complex).
• 3. functie (string). Moet zijn 'ok', 'rec' (recovery), 'sed' (sedatie), 'seh' (spoedeisende hulp) of 'hold' (holding, blokhut)
• 4. alias: naam waaronder dit bed wordt gepresenteerd (bijv: recov bed 1)

De kleuren van de parameters in Vierkleurenpen: tb_line_colors:

• line_name: naam van de parameter (zie tabel)
• line_color: de rgb-kleur van de parameter
• line_width: voor toekomstig gebruik

Uitbreidingen:

Bijpassend is er nog het ok-overzicht, een 'schipholbord' dat via het intranet het verloop van de ok's laat zien. Dit kan op verzoek ook worden opgestuurd en aangepast aan de situatie in andere ziekenhuizen.