Changes between Version 2 and Version 3 of Documentatie/Beheerder


Ignore:
Timestamp:
Nov 6, 2008 12:20:14 PM (17 years ago)
Author:
annius
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentatie/Beheerder

    v2 v3  
    33[[TOC(heading=Inhoudsopgave)]] 
    44  
    5  
    6 = Inrichting en systeembeheer van OpenAC = 
    7  
    8 == VECOZO webservice activeren in OpenAC == 
    9 Onderstaande instructies dienen eenmalig door een OpenAC-beheerder te worden uitgevoerd. Zorg ervoor dat de optie "Verzekeringsrecht controleren bij Vecozo" is aangemerkt als een instelling voor alle gebruikers, zodat de optie niet op elk werkstation afzonderlijk aangezet hoeft te worden. 
     5= Beheershandleiding OpenAC: inrichting en systeembeheer = 
     6 
     7U bent lokaal technisch aanspreekpunt voor OpenAC of op het secretariaat 
     8verantwoordelijk voor de inrichting van OpenAC met betrekking tot 
     9brieven, spreekuurcodes en roosters, dan vindt u hier beknopte 
     10instructies.  Wanneer de hier geboden informatie u niet voldoende verder 
     11helpt, kunt u, zie [wiki:ServiceLevels contact opnemen met Bureau AudCom]. 
     12 
     13 
     14== Sjablonen en correspondentie == 
     15 
     16Het maken van etiketten, brieven in OpenAC en de koppeling met 
     17audiometrie-apparatuur gebeurt via zgn ''bestandskoppelingen''. 
     18 
     19Elk bestand in OpenAC wordt ergens gekoppeld, dwz. is zichtbaar op een 
     20punt in het dossier van een patiënt, relatie of medewerker.  Er zijn 
     21twee kanalen waarlangs een bestand in OpenAC terechtkomt: 
     22 
     23 * Handmatig toevoegen: op diverse plekken in dossiers, relatiescherm 
     24   of medewerkerscherm zitten menu's waarmee je een sjabloon kunt uitkiezen. 
     25   Er wordt dan automatisch een brief gegenereerd.  Veelal krijgt u voor 
     26   het genereren van de brief nog een aantal vragen, zoals de printerkeuze, 
     27   eventuele vragen over ondertekening etc. 
     28  
     29 * Automatisch toevoegen: vanaf OpenAC v1.210 bestaat er in OpenAC de 
     30   'spoolfunctie'.  Er zijn bestandslocaties waar bestanden kunnen worden 
     31   neergezet die zijn ingescand of afgedrukt op PDF.  Aan de hand van de 
     32   bestandsnaam routeert OpenAC de bestanden automatisch naar de juiste 
     33   locatie. 
     34 
     35Bestanden die handmatig worden aangemaakt, worden gemaakt op basis van 
     36een '''sjabloon''', bijvoorbeeld een Word-sjabloon (DOT, DOTX) of een 
     37Excel-sjabloon (XLT, XLTX).  Bijzondere sjabloonkeuzes zijn '''Bijlage" 
     38(een willekeurig document in OpenAC hangen) en de keuzes voor 
     39audiometrie-apparatuur (Eldege, DECOS, AC440). 
     40 
     41 
     42 
     43== Automatisch plannen, maken van een rooster == 
     44 
     45OpenAC ondersteunt handmatig plannen dmv een externe agenda (papieren 
     46agenda of ander programma), maar biedt ook ondersteuning voor 
     47automatisch plannen.  Alleen echte patientcontacttijd kan automatisch 
     48worden gepland: reistijd en schrijftijd dient vast te worden 
     49ingeroosterd. 
     50 
     51Het plannen gebeurt op basis van een rooster.  Hieronder staan de 
     52stappen die dienen te worden genomen om automatisch te plannen: 
     53 
     54 * Neem je medewerkertabel door (knop ''Medewerkers'' in het 
     55   startscherm).  Ken aan elke medewerker een "plangroep" toe als volgt: 
     56   de plangroep bestaat uit een cijfer (de ''hoofdplangroep''), gevolgd 
     57   door 1 letter (de ''subplangroep'') en dan één of meer cijfers.  We 
     58   adviseren: 1A voor de audiologen, 1B voor audiologie-assistenten, 2A 
     59   voor logopedist/linguist, 3A voor psycholoog, 4A voor maatschappelijk 
     60   werk, en 9A voor kamers.  Vervolgens ken je binnen elke groep nummers 
     61   toe, dus 1B3 is audiologie-assistent nummer 3.  Mensen in dezelfde 
     62   hoofdplangroep (eerste cijfer) doen in principe niet samen onderzoeken. 
     63   Bij een aaneenschakeling van meerdere onderzoeken mag uit dezelfde 
     64   subplangroep (bijv. 1A/audioloog of 1B/audiologie-assistent) steeds maar 
     65   1 iemand worden gekozen door OpenAC.  Met andere woorden, er worden 
     66   nooit twee verschillende assistenten na elkaar ingeschakeld, maar de 
     67   patiënt kan wel worden gezien door een assistent, en daarna door de 
     68   audioloog. 
     69 
     70 * Voer eventueel kamers in (knop ''Kamers/apparatuur'').  Als het lukt 
     71   om te werken zonder plannen van vertrekken dan heeft de omwille van de 
     72   eenvoud wel de voorkeur.  Wanneer toch kamers moeten worden gepland, dan 
     73   draait het er meestal op uit dat niet alleen bijzondere vertrekken, 
     74   maar ook de gewone cabines moeten worden gepland.  Elke kamer dient ook 
     75   een plangroep te krijgen.  Wij adviseren om plangroep 9A te gebruiken 
     76   voor cabines en 9B voor een BERA of andere specifieke kamer. 
     77 
     78 * Ga naar ''Codetabellen'' en kies de tabel ''activiteit''.  Hierin 
     79   staan de actitiviteiten die je kunt plannen.  Ken aan deze activiteiten 
     80   een volgnummer toe.  Volg hierbij de volgnummers die standaard in OpenAC 
     81   zitten (vanaf 100 voor clientgebonden activiteiten, vanaf 200 voor 
     82   teamoverleg e.d., vanaf 300 voor ziek, 400 en 500 voor vrij).  Het 
     83   volgnummerbepaalt de volgorde waarin activiteiten worden gepresenteerd 
     84   in menu's, maar ook de volgorde waarin activiteiten elkaar opvolgen bij 
     85   het maken van een combinatie-afspraak. 
     86 
     87 * Maak eventueel in de codetabel ''actiegroep'' groepen aan van 
     88   activiteiten die je rooster-technisch kunt beschouwen als 
     89   "uitwisselbaar".  Voorbeeld: als je twee activiteiten '''gehoor-kort 
     90   (GK)''' en '''gehoor-lang (GL)''' hebt, zul je deze vrijwel altijd op 
     91   dezelfde tijden inroosteren.  Dan is het handig deze samen op te nemen 
     92   in een groep '''alle gehooronderzoeken (G)'''.  Je kunt ze dan bij het 
     93   opstellen van een rooster in één keer invoeren, en ze worden in de 
     94   agenda ook verkort afgebeeld als "G" in plaats van "GK, GL". 
     95 
     96 * Kies de periodes waarmee je gaat plannen.  Standaard zijn er twee 
     97   periodes actief: ''wekelijks'' en ''dagelijks''.  Het is mogelijk hier 
     98   tweewekelijkse of vierwekelijkse periodes aan toe te voegen.  Dit doe je 
     99   door in het scherm '''codetabellen''' te gaan naar de tabel 
     100   '''periode''' en hier de gewenste codes op ''in gebruik = ja'' te 
     101   zetten.  Eventueel kun je ook het weekrooster uitzetten wanneer je 
     102   bijvoorbeeld alleen in even/oneven weken wilt plannen. 
     103 
     104 * Richt tenslotte het rooster in.  Dit doe je vanuit het scherm 
     105   ''Agenda'', knop ''Rooster''.  Voer het rooster in per werkdag, per 
     106   medewerker.  Loop zorgvuldig na wat je invoert; het roosterscherm is een 
     107   scherm "met een handleiding" dat je onder de knie moet krijgen. 
     108 
     109 * Alles behalve het dagrooster (uitzonderingen) noemen we het 
     110   ''basisrooster''.  Dit rooster bepaalt welke (plan)groepen medewerkers 
     111   betrokken zijn bij welke soorten onderzoeken. 
     112 
     113 * TIP: in de codetabel ''activiteit'' wordt per activiteit weergegeven 
     114   welke plangroepen bij de activiteit zijn betrokken volgens het 
     115   ingevoerde rooster (staat hier bijvoorbeeld '1, 3, 9' dan betekent dat 
     116   een spreekuur wordt ingepland met 1 iemand uit de groep audiologie, 1 
     117   uit de groep logopedisten en 1 uit de groep kamers/apparatuur. 
     118 
     119 * Test het automatisch plannen door een aantal testpatienten aan te 
     120   maken, en in het dossierscherm richtafspraken definitief te maken 
     121   middels het linkje ''automatisch inplannen'' 
     122 
     123 * Lever, als het rooster af is, allereerst je lokale OpenAC-wijzigingen 
     124   in.  De tabellen '''activiteit.tsv''' en '''actiegroep.tsv''' zouden 
     125   moeten worden ingeleverd.  Maak daarna een OpenAC-backup.  Als de backup 
     126   klaar is, maak je een nieuwe map.  Hierin stop je de volgende bestanden 
     127   uit de backup: '''medewerker_*.tsv''', '''resource_*.tsv''' en 
     128   '''rooster_item_*.tsv'''. 
     129 
     130 * Na de definitieve import uit je lokale pakket naar OpenAC, kies je 
     131   voor ''backup terugzetten'' en selecteer je het mapje waarin je de 
     132   TSV-bestanden voor medewerkers, resources en rooster-items hebt gezet. 
     133   Vink aan "tabellen eerst leegmaken".  Het rooster wordt nu ingekopieerd 
     134   in je zojuist geimporteerde dataset. 
     135 
     136 * Maak uitzonderingen aan in het roosterscherm en het scherm 
     137   ''kantooragenda''.  Een uitzondering op het rooster kun je maken door 
     138   rooster-items in te voeren die niet per week worden herhaald, maar 
     139   dagelijks.  Deze hebben voorrang op het weekrooster.  Voorts kun je 
     140   dagen blokkeren door niet-patientgebonden afspraken in te voeren in het 
     141   scherm ''kantooragenda''. ''Let op'': voer de uitzonderingen pas in 
     142   nadat je bent overgeschakeld op OpenAC.  Het vergt nogal wat 
     143   data-nabewerking om de kantooragenda-items in te voegen in een bestaande 
     144   database. 
     145 
     146 * In de codetabel '''activiteit''' kun je de ''groepsgrootte'' invoeren. 
     147   Deze geeft aan hoeveel patiënten tegelijk worden gezien.  Zo kan 
     148   bijvoorbeeld een molenspreekuur worden ingevoerd (bijv. 3 medewerkers, 3 
     149   patiënten.  Door een groepsgrootte van '''1/2''' in te voeren, geef je 
     150   andersom aan, dat per patiënt 2 medewerkers uit dezelfde groep (bijv. 2 
     151   audiologie-assistenten) betrokken zijn. 
     152 
     153 
     154== Gebruikers, codetabellen, versiebeheer (beheerschermen) == 
     155 
     156 
     157== Beheer van de database (beheer-menu) == 
     158 
     159=== Backups === 
     160 
     161Er zijn twee mogelijkheden voor periodieke backups van OpenAC. 
     162 
     163 * OpenAC-backups.  De OpenAC-backups bieden meer flexibiliteit met 
     164   betrekking tot terugzetten.  Maak eerst handmatig een backup: log in, 
     165   kies in het menu ''beheer'' de optie ''backup maken...'' en vul de map 
     166   in waar je backups wilt verzamelen.  Breek eventueel het backup-proces 
     167   af, het gaat erom dat je de instellingen goed invoert.  Stel het 
     168   volgende commando in als "taak" onder Windows (laat de taak uitvoeren 
     169   door dezelfde windows-gebruiker die al een keer handmatig een backup 
     170   heeft gemaakt): 
     171 
     172   {{{ 
     173   Beginnen in : C:\Program Files\OpenAC 
     174   Uitvoeren: Python24\python.exe script.py backup 
     175   }}} 
     176 
     177 * Maak een backup met het programma 'mysqldump'.  Deze worden sneller 
     178   gemaakt, waardoor je vaker een backup kunt draaien. 
     179 
     180   {{{ 
     181   mysqldump --opt --user=gebruikersnaam --password=password naam_database > openac_backup.sql 
     182   }}} 
     183 
     184 * kopieer het bestand 'ibdata' in de MySQL-data-dir.  Dit is alleen een 
     185 'last-resort' of extra veiligheid. 
     186 
     187 
     188 
     189== Koppelingen met webdiensten en apparatuur == 
     190 
     191=== VECOZO webservice activeren in OpenAC === 
     192 
     193Onderstaande instructies dienen eenmalig door een OpenAC-beheerder te 
     194worden uitgevoerd. Zorg ervoor dat de optie "Verzekeringsrecht 
     195controleren bij Vecozo" is aangemerkt als een instelling voor alle 
     196gebruikers, zodat de optie niet op elk werkstation afzonderlijk aangezet 
     197hoeft te worden. 
    10198 
    11199 * Vraag een X509 certificaat aan bij [http://www.vecozo.nl VECOZO]. 
     200 
    12201 * Installeer het certificaat in Internet Explorer volgens de instructies van VECOZO. 
    13  * Als u het certificaat installeert door een eigen backup te importeren in Internet Explorer, let er dan op dat de persoonlijke sleutel (private key) als exporteerbaar is aangemerkt. Dit is een optie in de certificaat importeer wizard in Internet Explorer. Deze optie is standaard niet aangevinkt. 
    14  * Activeer de VECOZO webservice door de optie "Verzekeringsrecht controleren bij Vecozo" aan te vinken. Dit kan alleen als het VECOZO-certificaat is geïnstalleerd in OpenAC, voor die tijd is de optie grijs en kan niet worden aangevinkt. 
    15 [[Image(plaatjes:vecozo_activeren1.jpg)]][[BR]] 
    16  * Installeer het certificaat in OpenAC door op de link "certificaat installeren" te klikken. 
    17  * Selecteer het certificaat in het dialoogscherm dat volgt. Klik op de knop "Certificaat weergeven" om de volledige identificatie te kunnen zien. 
    18 [[Image(plaatjes:vecozo_activeren2.jpg)]][[BR]] 
    19  * Als het installeren van het certificaat is gelukt, is de optie "Verzekeringsrecht controleren bij Vecozo" actief geworden. Vink de optie aan en sla de instellingen op. 
    20  * Het certificaat wordt geïnstalleerd in de ''map voor OpenAC-documenten'' en staat daardoor meteen ter beschikking van ''alle aangesloten werkstations'' mits de aangegeven map een network share is.  Je hoeft dus maar één certificaat voor het hele AC aan te vragen. 
     202 
     203 * Als u het certificaat installeert door een eigen backup te importeren 
     204   in Internet Explorer, let er dan op dat de persoonlijke sleutel 
     205   (private key) als exporteerbaar is aangemerkt. Dit is een optie in de 
     206   certificaat importeer wizard in Internet Explorer. Deze optie is 
     207   standaard niet aangevinkt. 
     208 
     209 * Activeer de VECOZO webservice door de optie "Verzekeringsrecht 
     210   controleren bij Vecozo" aan te vinken. Dit kan alleen als het 
     211   VECOZO-certificaat is geïnstalleerd in OpenAC, voor die tijd is de 
     212   optie grijs en kan niet worden aangevinkt. 
     213 
     214   [[Image(plaatjes:vecozo_activeren1.jpg)]][[BR]] 
     215 
     216 * Installeer het certificaat in OpenAC door op de link "certificaat 
     217   installeren" te klikken. 
     218 
     219 * Selecteer het certificaat in het dialoogscherm dat volgt. Klik op de 
     220   knop "Certificaat weergeven" om de volledige identificatie te kunnen 
     221   zien. 
     222 
     223   [[Image(plaatjes:vecozo_activeren2.jpg)]][[BR]] 
     224 
     225 * Als het installeren van het certificaat is gelukt, is de optie 
     226   "Verzekeringsrecht controleren bij Vecozo" actief geworden. Vink de 
     227   optie aan en sla de instellingen op. 
     228 
     229 * Het certificaat wordt geïnstalleerd in de ''map voor 
     230   OpenAC-documenten'' en staat daardoor meteen ter beschikking van ''alle 
     231   aangesloten werkstations'' mits de aangegeven map een network share is. 
     232   Je hoeft dus maar één certificaat voor het hele AC aan te vragen. 
     233 
    21234[[Image(plaatjes:vecizo_activeren3.jpg)]][[BR]] 
    22  * Vind je de instelling "Verzekeringsrecht controleren bij Vecozo" niet in OpenAC, controleer dan dat de module e080_vecozo in OpenAC is geactiveerd. 
    23  
    24 == Decos-koppeling activeren in OpenAC  == 
    25  
    26  * Kopieer DecosOpenAC.dll en DecosOpenAC.ini van OpenAC\kern\f080_decos\DecosOpenAC\DLL naar de HIS-map van Decos, bijvoorbeeld C:\Program Files\Decos Audiology Workstation\HIS 
    27  * Wijzig DecosOpenAC.ini. mysql_openac moet worden vervangen door de naam van de OpenAC ODBC-datasource. 
    28  * Registreer DecosOpenAC.dll in Decos. Start Decos Audiology Workstation en kies Administratieve Tools -> Instellingen -> tabblad ZIS. Vink Opvragen van patiënt gegevens vanuit het ZIS aan en vul DecosOpenAC.Patient in achter ZIS component programma ID. De overige opties leeg laten. 
    29  * Geef in het instellingenscherm van OpenAC aan of in Decos moet worden ingelogd als administrator of als de ingelogde OpenAC gebuiker. Voorwaarde voor inloggen als OpenAC gebruiker is dat de OpenAC gebruikersnaam bekend is in Decos. 
    30  
    31 De Decos-koppeling is nu gereed voor gebruik. De eerste keer dat vanuit OpenAC een Decos meting gedaan wordt zal OpenAC vragen om de locatie van de DAW tools. Dit is de map waar "Daw wizard.exe" te vinden is, bijvoorbeeld C:\Program Files\Decos Audiology Workstation. 
    32  
    33  
    34 == Het aanleggen van een rooster (automatische planning) == 
    35  
    36 OpenAC ondersteunt handmatig plannen dmv een externe agenda (papieren agenda of ander programma), maar biedt ook ondersteuning voor automatisch plannen.  Alleen echte patientcontacttijd kan automatisch worden gepland: reistijd en schrijftijd dient vast te worden ingeroosterd. 
    37  
    38 Het plannen gebeurt op basis van een rooster.  Hieronder staan de stappen die dienen te worden genomen om automatisch te plannen: 
    39  
    40  * Neem je medewerkertabel door (knop ''Medewerkers'' in het startscherm).  Ken aan elke medewerker een "plangroep" toe als volgt: de plangroep bestaat uit een cijfer (de ''hoofdplangroep''), gevolgd door 1 letter (de ''subplangroep'') en dan één of meer cijfers.  We adviseren: 1A voor de audiologen, 1B voor audiologie-assistenten, 2A voor logopedist/linguist, 3A voor psycholoog, 4A voor maatschappelijk werk, en 9A voor kamers.  Vervolgens ken je binnen elke groep nummers toe, dus 1B3 is audiologie-assistent nummer 3.  Mensen in dezelfde hoofdplangroep (eerste cijfer) doen in principe niet samen onderzoeken.  Bij een aaneenschakeling van meerdere onderzoeken mag uit dezelfde subplangroep (bijv. 1A/audioloog of 1B/audiologie-assistent) steeds maar 1 iemand worden gekozen door OpenAC.  Met andere woorden, er worden nooit twee verschillende assistenten na elkaar ingeschakeld, maar de patiënt kan wel worden gezien door een assistent, en daarna door de audioloog. 
    41  
    42  * Voer eventueel kamers in (knop ''Kamers/apparatuur'').  Als het lukt om te werken zonder plannen van vertrekken dan heeft de omwille van de eenvoud wel de voorkeur.  Wanneer toch kamers moeten worden gepland, dan draait het er meestal op uit dat niet alleen bijzondere vertrekken, maar ook de gewone cabines moeten worden gepland.  Elke kamer dient ook een plangroep te krijgen.  Wij adviseren om plangroep 9A te gebruiken voor cabines en 9B voor een BERA of andere specifieke kamer. 
    43  
    44  * Ga naar ''Codetabellen'' en kies de tabel ''activiteit''.  Hierin staan de actitiviteiten die je kunt plannen.  Ken aan deze activiteiten een volgnummer toe.  Volg hierbij de volgnummers die standaard in OpenAC zitten (vanaf 100 voor clientgebonden activiteiten, vanaf 200 voor teamoverleg e.d., vanaf 300 voor ziek, 400 en 500 voor vrij).  Het volgnummerbepaalt de volgorde waarin activiteiten worden gepresenteerd in menu's, maar ook de volgorde waarin activiteiten elkaar opvolgen bij het maken van een combinatie-afspraak. 
    45  
    46  * Maak eventueel in de codetabel ''actiegroep'' groepen aan van activiteiten die je rooster-technisch kunt beschouwen als "uitwisselbaar".  Voorbeeld: als je twee activiteiten '''gehoor-kort (GK)''' en '''gehoor-lang (GL)''' hebt, zul je deze vrijwel altijd op dezelfde tijden inroosteren.  Dan is het handig deze samen op te nemen in een groep '''alle gehooronderzoeken (G)'''.  Je kunt ze dan bij het opstellen van een rooster in één keer invoeren, en ze worden in de agenda ook verkort afgebeeld als "G" in plaats van "GK, GL". 
    47  
    48  * Kies de periodes waarmee je gaat plannen.  Standaard zijn er twee periodes actief: ''wekelijks'' en ''dagelijks''.  Het is mogelijk hier tweewekelijkse of vierwekelijkse periodes aan toe te voegen.  Dit doe je door in het scherm '''codetabellen''' te gaan naar de tabel '''periode''' en hier de gewenste codes op ''in gebruik = ja'' te zetten.  Eventueel kun je ook het weekrooster uitzetten wanneer je bijvoorbeeld alleen in even/oneven weken wilt plannen. 
    49  
    50  * Richt tenslotte het rooster in.  Dit doe je vanuit het scherm ''Agenda'', knop ''Rooster''.  Voer het rooster in per werkdag, per medewerker.  Loop zorgvuldig na wat je invoert; het roosterscherm is een scherm "met een handleiding" dat je onder de knie moet krijgen. 
    51  
    52  * Alles behalve het dagrooster (uitzonderingen) noemen we het ''basisrooster''.  Dit rooster bepaalt welke (plan)groepen medewerkers betrokken zijn bij welke soorten onderzoeken. 
    53  
    54  * TIP: in de codetabel ''activiteit'' wordt per activiteit weergegeven welke plangroepen bij de activiteit zijn betrokken volgens het ingevoerde rooster (staat hier bijvoorbeeld '1, 3, 9' dan betekent dat een spreekuur wordt ingepland met 1 iemand uit de groep audiologie, 1 uit de groep logopedisten en 1 uit de groep kamers/apparatuur. 
    55  
    56  * Test het automatisch plannen door een aantal testpatienten aan te maken, en in het dossierscherm richtafspraken definitief te maken middels het linkje ''automatisch inplannen'' 
    57  
    58  * Lever, als het rooster af is, allereerst je lokale OpenAC-wijzigingen in.  De tabellen '''activiteit.tsv''' en '''actiegroep.tsv''' zouden moeten worden ingeleverd.  Maak daarna een OpenAC-backup.  Als de backup klaar is, maak je een nieuwe map.  Hierin stop je de volgende bestanden uit de backup: '''medewerker_*.tsv''', '''resource_*.tsv''' en '''rooster_item_*.tsv'''. 
    59  
    60  * Na de definitieve import uit je lokale pakket naar OpenAC, kies je voor ''backup terugzetten'' en selecteer je het mapje waarin je de TSV-bestanden voor medewerkers, resources en rooster-items hebt gezet.  Vink aan "tabellen eerst leegmaken".  Het rooster wordt nu ingekopieerd in je zojuist geimporteerde dataset. 
    61  
    62  * Maak uitzonderingen aan in het roosterscherm en het scherm ''kantooragenda''.  Een uitzondering op het rooster kun je maken door rooster-items in te voeren die niet per week worden herhaald, maar dagelijks.  Deze hebben voorrang op het weekrooster.  Voorts kun je dagen blokkeren door niet-patientgebonden afspraken in te voeren in het scherm ''kantooragenda''.  ''Let op'': voer de uitzonderingen pas in nadat je bent overgeschakeld op OpenAC.  Het vergt nogal wat data-nabewerking om de kantooragenda-items in te voegen in een bestaande database. 
    63  
    64  * In de codetabel '''activiteit''' kun je de ''groepsgrootte'' invoeren.  Deze geeft aan hoeveel patiënten tegelijk worden gezien.  Zo kan bijvoorbeeld een molenspreekuur worden ingevoerd (bijv. 3 medewerkers, 3 patiënten.  Door een groepsgrootte van '''1/2''' in te voeren, geef je andersom aan, dat per patiënt 2 medewerkers uit dezelfde groep (bijv. 2 audiologie-assistenten) betrokken zijn. 
    65  
    66  
    67 == Scripts == 
    68  
    69 OpenAC kan worden gescript door gebruik te maken van script.py met als argument het uit te voeren script. Eventuele verdere argumenten zijn argumenten voor het uit te voeren script. 
    70  
    71 Zorg ervoor dat een script altijd wordt uitgevoerd vanuit de map waar OpenAC is geïnstalleerd. Vanuit deze map is de opdrachtregel: python25\python.exe script.py <naam en argumenten uit te voeren script>. 
    72  
    73 Scripts gebruiken dezelfde instellingen als de laatste OpenAC-sessie. Het is dus zaak om OpenAC minimaal één keer op de reguliere manier te starten en te controleren of alle instellingen correct zijn. 
    74  
    75 === Een geplande taak aanmaken in Windows === 
    76  * Open "Geplande taken" vanuit het configuratiescherm. De wizard "Taak plannen" zal worden gestart. 
     235 
     236 * Vind je de instelling "Verzekeringsrecht controleren bij Vecozo" niet 
     237   in OpenAC, controleer dan dat de module e080_vecozo in OpenAC is 
     238   geactiveerd. 
     239 
     240=== Decos-koppeling activeren in OpenAC  === 
     241 
     242 * Kopieer DecosOpenAC.dll en DecosOpenAC.ini van 
     243   OpenAC\kern\f080_decos\DecosOpenAC\DLL naar de HIS-map van Decos, 
     244   bijvoorbeeld C:\Program Files\Decos Audiology Workstation\HIS 
     245 
     246 * Wijzig DecosOpenAC.ini. mysql_openac moet worden vervangen door de 
     247   naam van de OpenAC ODBC-datasource. 
     248 
     249 * Registreer DecosOpenAC.dll in Decos. Start Decos Audiology 
     250   Workstation en kies Administratieve Tools -> Instellingen -> tabblad 
     251   ZIS. Vink Opvragen van patiënt gegevens vanuit het ZIS aan en vul 
     252   DecosOpenAC.Patient in achter ZIS component programma ID. De overige 
     253   opties leeg laten. 
     254 
     255 * Geef in het instellingenscherm van OpenAC aan of in Decos moet worden 
     256   ingelogd als administrator of als de ingelogde OpenAC gebuiker. 
     257   Voorwaarde voor inloggen als OpenAC gebruiker is dat de OpenAC 
     258   gebruikersnaam bekend is in Decos. 
     259 
     260De Decos-koppeling is nu gereed voor gebruik. De eerste keer dat vanuit 
     261OpenAC een Decos meting gedaan wordt zal OpenAC vragen om de locatie van 
     262de DAW tools. Dit is de map waar "Daw wizard.exe" te vinden is, 
     263bijvoorbeeld C:\Program Files\Decos Audiology Workstation. 
     264 
     265 
     266=== Importeren MAC-AC uit MS Access === 
     267 
     268Voor het importeren van MAC-AC registraties moet OpenAC zijn bijgewerkt 
     269naar versie 1.100 revisie 6636. Om de gegevens uit de Microsoft Access 
     270database te importeren in OpenAC, moeten eerst de tabellen "Onderzoek" 
     271en "Patient" te worden geëxporteerd als tabgescheiden tekstbestanden. De 
     272procedure is als volgt (gebaseerd op Microsoft Access 2003, andere 
     273versies kunnen enigszins afwijken): 
     274 
     275 * Open de MAC-AC database in Microsoft Access en klik op de knop 
     276   "Databasevenster" in het menuscherm om de tabellen zichtbaar te maken. 
     277 
     278 * Klik op de tabel "Onderzoek" en kies uit het menu optie Bestand -> 
     279   Exporteren... 
     280 
     281 * Selecteer eerst het bestandstype achter "Opslaan als:". Kies 
     282   Tekstbestanden (*.txt, *.csv, *.tab... 
     283 
     284 * Geef het bestand de naam onderzoek.tab, en klik op "Exporteren" 
     285 
     286 * De Wizard Tekst exporteren wordt gestart. Kies "Met scheidingstekens" 
     287   en klik op "Geavanceerd...". Zie onderstaande schermafdruk. 
     288 
     289   [[Image(macac_export_screenshots:macac_tekst_export1.jpg)]][[BR]] 
     290 
     291 * Zorg dat de ingevulde waarden ingevuld worden als onderstaande 
     292   schermafdruk. Belangrijk zijn bestandsindeling: gescheiden, 
     293   scheidingsteken: {tab}, tekstscheidingsteken: {geen}, datumvolgorde: 
     294   JMD, jaar met vier cijfers, datumscheidingsteken -, voorloopnullen in 
     295   datums. 
     296 
     297   [[Image(macac_export_screenshots:macac_tekst_export_geavanceerd.jpg)]][[BR]] 
     298 
     299 * Klik op "OK", en in het volgende scherm op "Volgende" 
     300 
     301 * Zorg dat "Ook veldnamen in eerste rij" is aangevinkt, en klik op 
     302   "Voltooien". Zie onderstaande schermafdruk. 
     303 
     304   [[Image(macac_export_screenshots:macac_tekst_export2.jpg)]][[BR]] 
     305 
     306 * Herhaal de hele procedure voor de tabel "Patient". Geef het 
     307   exportbestand de naam patient.tab 
     308 
     309 * Hernoemen onderzoek.tab naar macac_onderzoek_export.tsv en patient.tab 
     310   naar macac_patient_export.tsv 
     311 
     312 * In OpenAC, kies in het menu voor Beheer -> Importeren uit... -> 
     313   MAC-AC... 
     314 
     315 * Blader naar de directory waar macac_onderzoek_export.tsv en 
     316   macac_patient_export.tsv staan en klik op "OK". De gegevens worden nu 
     317   geïmporteerd. Het importlog staat in Documents and 
     318   Settings\<gebruiker>\Application Data\OpenAC\macac_import_<datum>.log 
     319 
     320 
     321== Module-parameters == 
     322 
     323 
     324== Scripting == 
     325 
     326OpenAC kan worden gescript door gebruik te maken van script.py met als 
     327argument het uit te voeren script. Eventuele verdere argumenten zijn 
     328argumenten voor het uit te voeren script. 
     329 
     330Zorg ervoor dat een script altijd wordt uitgevoerd vanuit de map waar 
     331OpenAC is geïnstalleerd. Vanuit deze map is de opdrachtregel: 
     332python25\python.exe script.py <naam en argumenten uit te voeren script>. 
     333 
     334Scripts gebruiken dezelfde instellingen als de laatste OpenAC-sessie. 
     335Het is dus zaak om OpenAC minimaal één keer op de reguliere manier te 
     336starten en te controleren of alle instellingen correct zijn. 
     337 
     338==== Een geplande taak aanmaken in Windows ==== 
     339 
     340 * Open "Geplande taken" vanuit het configuratiescherm. De wizard "Taak 
     341   plannen" zal worden gestart. 
     342 
    77343 * Blader naar python.exe in <OpenAC map>\python24. 
     344 
    78345 * Geef de taak een naam. 
     346 
    79347 * Geef aan wanneer de taak moet worden uitgevoerd. 
    80  * Voltooi de wizard. Vink op de laatste pagina moet de optie "Geavanceerde eigenschappen voor deze taak openen wanneer ik op Voltooien klik" aan. Dit is nodig om de argumenten en de werkdirectory in te stellen. 
    81  * Vul de opdrachtregel achter "Uitvoeren" aan met script.py <naam en argumenten uit te voeren script>. Zie voor de naam en argumenten van het script het lijstje scripts hieronder. De volledige opdrachtregel wordt: <OpenAC map>\python24\python.exe script.py <naam en argumenten uit te voeren script>. 
    82  * Het is belangrijk dat achter "Beginnen in" de OpenAC map wordt ingevuld. Dit is de werkdirectory. 
    83  
    84 === Script backup === 
     348 
     349 * Voltooi de wizard. Vink op de laatste pagina moet de optie 
     350   "Geavanceerde eigenschappen voor deze taak openen wanneer ik op 
     351   Voltooien klik" aan. Dit is nodig om de argumenten en de werkdirectory 
     352   in te stellen. 
     353 
     354 * Vul de opdrachtregel achter "Uitvoeren" aan met script.py <naam en 
     355   argumenten uit te voeren script>. Zie voor de naam en argumenten van 
     356   het script het lijstje scripts hieronder. De volledige opdrachtregel 
     357   wordt: <OpenAC map>\python24\python.exe script.py <naam en argumenten 
     358   uit te voeren script>. 
     359 
     360 * Het is belangrijk dat achter "Beginnen in" de OpenAC map wordt 
     361   ingevuld. Dit is de werkdirectory. 
     362 
     363==== Script backup ==== 
     364 
    85365Aanroep vanaf de command line: "'''Python25\python.exe script.py backup'''". 
    86366 
    87367Dit script schrijft een actuele backup naar de verzameldirectory. 
    88368 
    89 === Script svn_cleanup === 
     369 
     370==== Script svn_cleanup ==== 
     371 
    90372Aanroep vanaf de command line: "'''Python25\python.exe script.py svn_cleanup'''". 
    91373 
    92374Dit script kan problemen met het versiebeheer van OpenAC oplossen. 
    93375 
    94 === Script periodieke TOREN-import === 
    95 Aanroep vanaf de command line: "'''Python25\python.exe script.py periodiek_toren_import import'''". 
     376==== Script periodieke TOREN-import ==== 
     377 
     378Aanroep vanaf de command line: "'''Python25\python.exe script.py 
     379periodiek_toren_import import'''". 
    96380 
    97381Het script periodiek_toren_import doet het volgende: 
    98  * Alle bestanden uit de TOREN-importmap met een bepaalde bestandsextensie worden ingelezen. De TOREN-importmap en de bestandextensie kunnen worden ingesteld via '''Beheer->Instellingen''' in OpenAC. 
    99  * Als er een structuurfout zit in het importbestand, of als de import voortijdig wordt afgebroken, dan wordt het importbestand verplaatst naar de map "'''mislukt'''". Het script "periodiek_toren_import" garandeert dat elke verrichting uit een importbestand maar één keer wordt verwerkt, dus een bestand kan zonder gevaar op dubbele verrichtingen meerdere keren worden geïmporteerd. 
    100  * Verrichtingen die niet kunnen worden verwerkt worden weggeschreven als een kommagescheiden bestand in de map "'''fouten'''". 
    101  * Nadat een TOREN-bestand is geïmporteerd wordt het verplaatst naar de map "'''behandeld'''". 
    102  * Bestanden uit de map "mislukt" kunnen worden teruggezet naar de TOREN-importmap met "'''script.py periodiek_toren_import herstel'''". 
    103  
    104 === Script verstuur DBC's === 
     382 
     383 * Alle bestanden uit de TOREN-importmap met een bepaalde 
     384   bestandsextensie worden ingelezen. De TOREN-importmap en de 
     385   bestandextensie kunnen worden ingesteld via '''Beheer->Instellingen''' 
     386   in OpenAC. 
     387 
     388 * Als er een structuurfout zit in het importbestand, of als de import 
     389   voortijdig wordt afgebroken, dan wordt het importbestand verplaatst 
     390   naar de map "'''mislukt'''". Het script "periodiek_toren_import" 
     391   garandeert dat elke verrichting uit een importbestand maar één keer 
     392   wordt verwerkt, dus een bestand kan zonder gevaar op dubbele 
     393   verrichtingen meerdere keren worden geïmporteerd. 
     394 
     395 * Verrichtingen die niet kunnen worden verwerkt worden weggeschreven 
     396   als een kommagescheiden bestand in de map "'''fouten'''". 
     397 
     398 * Nadat een TOREN-bestand is geïmporteerd wordt het verplaatst naar de 
     399   map "'''behandeld'''". 
     400 
     401 * Bestanden uit de map "mislukt" kunnen worden teruggezet naar de 
     402   TOREN-importmap met "'''script.py periodiek_toren_import herstel'''". 
     403 
     404==== Script verstuur DBC's ==== 
    105405Aanroep vanaf de command line: "'''Python25\python.exe script.py verstuur_dbcs'''". 
    106406 
    107407Het script verstuur_dbcs voert de acties uit het scherm DBC's versturen automatisch uit. 
    108408 
    109 == Werking van Word-sjablonen == 
    110  
    111 De OpenAC-sjablonen werken met '''bookmarks''' (bladwijzers) en '''merge-fields''' (samenvoegvelden).  De merge-fields worden alleen toegepast in zogenaamde "meervoudige" sjablonen, zoals facturen of brieven die aan diverse betrokkenen moeten worden geadresseerd.  Veruit de meeste sjablonen worden dan ook gemaakt met bookmarks. 
    112  
    113 == Ik wil dezelfde sjabloon-variabele twee keer opnemen in een sjabloon == 
    114  
    115 Word staat niet toe dat dezelfde bookmark twee keer in een document voorkomt.  Wanneer een variabele twee keer of vaker op een vel moet worden afgedrukt (bijvoorbeeld 2x het adres van de patient op een etikettenvel), dan is het toegestaan om één of meer keer "_" (underscore) achter de naam van de bookmark te zetten.  
    116  
    117 == Gebruik van promptvelden == 
    118  
    119 Geef in OpenAC bij het sjabloon de promptvelden op in uitsluitend kleine letters en uitsluitend gescheiden door een komma. Vervolgens zijn deze in het feitelijk sjabloon op dezelfde wijze toe te voegen en gebruiken als de andere bookmarks. 
    120  
    121 == Wat zijn 'enkelvoudige' , 'meerbladige' en 'meerregelige' sjablonen? == 
    122  
    123 'enkelvoudig' is het meest voorkomende sjabloontype. Hier is geen sprake van informatie die moet worden herhaald. Het onderscheid meerbladig/meerregelig speelt alleen een rol bij de koppeling naar Microsoft Word, en alleen bij sjablonen waarbij informatie moet worden herhaald.  Deze functionaliteit is ontworpen om verzamelnota's te kunnen maken, maar zou ook bij brieven kunnen worden gebruikt. 
    124  
    125  * Stel, je maakt een brief met daarop bookmarks voor de patientgegevens (''adresregel1'' t/m ''adresregel4'') en dan '''binnen een tabel''' nog een keer dezelfde variabelen (''adresregel1'' t/m ''adresregel4''). 
    126  * Bij 'meerbladig' krijg je voor elke betrokkene een aparte pagina met daarop het adres van de patient, en het adres de betrokkene. 
    127  * Bij 'meerregelig' krijg je dan 1 pagina met daarop het adres van de patient, en dan onder elkaar in de tabel de adressen van alle betrokkenen (huisarts, verwijzer, verzekeraar).  Dit werkt ''alleen'' als de merge-velden in een tabel zijn opgenomen, zodat de word-koppeling weet welk gedeelte moet worden herhaald. 
    128  
    129 == COM-error 'kan lid niet vinden' == 
    130 Als OpenAC tijdens het werken met Word- of Excel-documenten een foutmelding geeft met daarin de tekst ''Python: com_error: (-2147352573, 'Kan lid niet vinden.', None, None)'' of iets soortgelijks, dan kan de volgende procedure mogelijk uitkomst bieden: 
    131  * Verwijder alle bestanden uit de map <openac>\python<x>\Lib\site-packages\win32com\gen_py. <openac> is de OpenAC installatiemap, <x> de python-versie (24, 25, ..) 
    132  * Start OpenAC opnieuw op. 
    133  
    134  
    135 == Backups == 
    136  
    137 Er zijn twee mogelijkheden voor periodieke backups van OpenAC. 
    138  
    139  * OpenAC-backups.  De OpenAC-backups bieden meer flexibiliteit met betrekking tot terugzetten.  Maak eerst handmatig een backup: log in, kies in het menu ''beheer'' de optie ''backup maken...'' en vul de map in waar je backups wilt verzamelen.  Breek eventueel het backup-proces af, het gaat erom dat je de instellingen goed invoert.  Stel het volgende commando in als "taak" onder Windows (laat de taak uitvoeren door dezelfde windows-gebruiker die al een keer handmatig een backup heeft gemaakt): 
    140 {{{ 
    141 Beginnen in : C:\Program Files\OpenAC 
    142 Uitvoeren: Python24\python.exe script.py backup 
    143 }}} 
    144  
    145  * Maak een backup met het programma 'mysqldump'.  Deze worden sneller gemaakt, waardoor je vaker een backup kunt draaien. 
    146 {{{ 
    147 mysqldump --opt --user=gebruikersnaam --password=password naam_database > openac_backup.sql 
    148 }}} 
    149  
    150  * kopieer het bestand 'ibdata' in de MySQL-data-dir.  Dit is alleen een 'last-resort' of extra veiligheid. 
    151  
    152 == Importeren MAC-AC uit Access == 
    153  
    154 Voor het importeren van MAC-AC registraties moet OpenAC zijn bijgewerkt naar versie 1.100 revisie 6636. Om de gegevens uit de Microsoft Access database te importeren in OpenAC, moeten eerst de tabellen "Onderzoek" en "Patient" te worden geëxporteerd als tabgescheiden tekstbestanden. De procedure is als volgt (gebaseerd op Microsoft Access 2003, andere versies kunnen enigszins afwijken): 
    155  
    156  * Open de MAC-AC database in Microsoft Access en klik op de knop "Databasevenster" in het menuscherm om de tabellen zichtbaar te maken. 
    157  * Klik op de tabel "Onderzoek" en kies uit het menu optie Bestand -> Exporteren... 
    158  * Selecteer eerst het bestandstype achter "Opslaan als:". Kies Tekstbestanden (*.txt, *.csv, *.tab... 
    159  * Geef het bestand de naam onderzoek.tab, en klik op "Exporteren" 
    160  * De Wizard Tekst exporteren wordt gestart. Kies "Met scheidingstekens" en klik op "Geavanceerd...". Zie onderstaande schermafdruk. 
    161 [[Image(macac_export_screenshots:macac_tekst_export1.jpg)]][[BR]] 
    162  * Zorg dat de ingevulde waarden ingevuld worden als onderstaande schermafdruk. Belangrijk zijn bestandsindeling: gescheiden, scheidingsteken: {tab}, tekstscheidingsteken: {geen}, datumvolgorde: JMD, jaar met vier cijfers, datumscheidingsteken -, voorloopnullen in datums. 
    163 [[Image(macac_export_screenshots:macac_tekst_export_geavanceerd.jpg)]][[BR]] 
    164  * Klik op "OK", en in het volgende scherm op "Volgende" 
    165  * Zorg dat "Ook veldnamen in eerste rij" is aangevinkt, en klik op "Voltooien". Zie onderstaande schermafdruk. 
    166 [[Image(macac_export_screenshots:macac_tekst_export2.jpg)]][[BR]] 
    167  * Herhaal de hele procedure voor de tabel "Patient". Geef het exportbestand de naam patient.tab 
    168  * Hernoemen onderzoek.tab naar macac_onderzoek_export.tsv en patient.tab naar macac_patient_export.tsv 
    169  * In OpenAC, kies in het menu voor Beheer -> Importeren uit... -> MAC-AC... 
    170  * Blader naar de directory waar macac_onderzoek_export.tsv en macac_patient_export.tsv staan en klik op "OK". De gegevens worden nu geïmporteerd. Het importlog staat in Documents and Settings\<gebruiker>\Application Data\OpenAC\macac_import_<datum>.log 
    171  
    172  
     409=== Werking van Word-sjablonen === 
     410 
     411De OpenAC-sjablonen werken met '''bookmarks''' (bladwijzers) en 
     412'''merge-fields''' (samenvoegvelden).  De merge-fields worden alleen 
     413toegepast in zogenaamde "meervoudige" sjablonen, zoals facturen of 
     414brieven die aan diverse betrokkenen moeten worden geadresseerd.  Veruit 
     415de meeste sjablonen worden dan ook gemaakt met bookmarks. 
     416 
     417=== Ik wil dezelfde sjabloon-variabele twee keer opnemen in een sjabloon === 
     418 
     419Word staat niet toe dat dezelfde bookmark twee keer in een document 
     420voorkomt.  Wanneer een variabele twee keer of vaker op een vel moet 
     421worden afgedrukt (bijvoorbeeld 2x het adres van de patient op een 
     422etikettenvel), dan is het toegestaan om één of meer keer "_" 
     423(underscore) achter de naam van de bookmark te zetten. 
     424 
     425=== Gebruik van promptvelden === 
     426 
     427Geef in OpenAC bij het sjabloon de promptvelden op in uitsluitend kleine 
     428letters en uitsluitend gescheiden door een komma. Vervolgens zijn deze 
     429in het feitelijk sjabloon op dezelfde wijze toe te voegen en gebruiken 
     430als de andere bookmarks. 
     431 
     432=== Wat zijn 'enkelvoudige' , 'meerbladige' en 'meerregelige' sjablonen? === 
     433 
     434Het meest voorkomende sjabloontype is 'enkelvoudig'. Hier is geen sprake 
     435van informatie die moet worden herhaald. Het onderscheid 
     436meerbladig/meerregelig speelt alleen een rol bij de koppeling naar 
     437Microsoft Word, en alleen bij sjablonen waarbij informatie moet worden 
     438herhaald.  Deze functionaliteit is ontworpen om verzamelnota's te kunnen 
     439maken, maar zou ook bij brieven kunnen worden gebruikt. 
     440 
     441 
     442 * Stel, je maakt een brief met daarop bookmarks voor de patientgegevens 
     443   (''adresregel1'' t/m ''adresregel4'') en dan '''binnen een tabel''' nog 
     444   een keer dezelfde variabelen (''adresregel1'' t/m ''adresregel4''). 
     445 
     446 * Bij 'meerbladig' krijg je voor elke betrokkene een aparte pagina met 
     447   daarop het adres van de patient, en het adres de betrokkene. 
     448 
     449 * Bij 'meerregelig' krijg je dan 1 pagina met daarop het adres van de 
     450   patient, en dan onder elkaar in de tabel de adressen van alle 
     451   betrokkenen (huisarts, verwijzer, verzekeraar).  Dit werkt ''alleen'' 
     452   als de merge-velden in een tabel zijn opgenomen, zodat de 
     453   word-koppeling weet welk gedeelte moet worden herhaald. 
     454