= OpenAC v2.006 release notes =

''Release datum: 26 maart 2014'' [milestone:release-2.006 milestone]

[[TOC(heading=Inhoud)]][[TicketQuery(milestone=release-2.006, format=progress)]]
[[TOC(heading=Releases, sectionindex, compact, Releases/)]]

== Algemeen ==

Na de grote veranderingen in OpenAC v2.004 met groepsafspraken en de agenda, is v2.006 weer een release met heel veel nieuwe features: nieuwe rapportages, knoppen in het dossier, en koppelingen met externe systemen.

 - '''Indicatoren''' In het dossier is een kanarie-geel blok ''Indicatoren'' opgenomen waarin de output- en kwaliteitsindicatoren worden vertoond. Dit zijn alleen de automatisch berekende indicatoren.
 - '''Keuzes naar Klembord''' Veel keuze-balkjes in OpenAC zij nu voorzien van een knopje ''kopieer'' naast de bestaande zoek- en nieuw-invoeren-knopjes. De kopieerknop lijkt op een kleine letter C. Als hierop geklikt wordt, wordt de kaartweergave van de selectie (of dat nou een huisarts [[Image(wiki:WikiStart:callout-1.png)]] is of een dossierlocatie [[Image(wiki:WikiStart:callout-2.png)]]. De OpenAC beheerder moet dit aanzetten, zie hieronder bij ''Beheer''.[[br]]
   [[Image(dropdown.PNG)]]
 - [[Image(adres.PNG, class=inline-right)]]'''Kaarten naar Klembord''' Elke kaart-weergave van gegevens, zoals hiernaast getoond een adres [[Image(wiki:WikiStart:callout-3.png)]], kan via het linkje ''Kopieer naar klembord'' gekopieerd worden. Hierna zijn de gegevens in andere programma's te plakken. De links verschijnen ook bij behandeldagen, patiëntgegevens, metingen, enzovoorts: elk ingeklapt blok heeft zo'n link. De OpenAC beheerder moet deze link aanzetten, zie hieronder bij ''Beheer''.
 - '''Notaspecificatie''' Tijdens het [wiki:Documentatie/Gebruikershandleiding/Factureren#notaspecificatie factureren] kan er een notaspecificatie (per email) aan patiënten worden verstuurd. Dit kan als in het dossier een email-adres is ingevoerd dat geschikt is voor het versturen van (pro forma) nota's.

== Voor het Secretariaat ==

 - '''Acties''' Voorheen werden "afgehandelde" acties altijd uit het dossier verwijderd. Hierdoor is er geen historie van acties. Vanaf OpenAC v2.006 worden acties behouden in het dossier, maar gemarkeerd als afgehandeld. Het is nog steeds mogelijk om acties te verwijderen door op het prullenbakje van de actie te klikken.
 - '''Binnengemelde Afspraken''' [[Image(binnen2.png, class=inline-right)]]worden sinds v2.004 in het rood aangegeven[[Image(wiki:WikiStart:callout-1.png)]]. De markering is iets duidelijker (met een dikker lijntje) geworden[[Image(wiki:WikiStart:callout-2.png)]]. De kleur is vanaf v2.006 instelbaar per adaptatie; het kan ook uitgezet worden.
 - '''Cohorten''' Er is een (optioneel) hoofdscherm ''Cohorten'' bijgekomen, waarmee groepen van patiënten kunnen worden aangemaakt; een groep patiënten (een cohort) kan eenvoudig worden ingepland als groepsafspraak.
 - '''Medewerkerselectie in roosterscherm''' In het roosterscherm kunnen de rooster-items worden gefilterd op medewerker. OpenAC neemt de geselecteerde medewerker over bij het invoeren van een nieuw rooster-item.
 - '''Nota in Dossier''' [[Image(fintraject.PNG, class=inline-right)]]Bij subtrajecten (financiele trajecten) die zijn gefactureerd en waarvan bekend is in welke notabundels ze terecht zijn gekomen, is nu een link in het subtraject opgenomen [[Image(wiki:WikiStart:callout-1.png)]] en [[Image(wiki:WikiStart:callout-2.png)]]. De link opent in het notabeheerscherm de bijbehorende nota. Alleen medewerkers met financieel-gerelateerde gebruikersrechten krijgen zo'n link.

== Voor de Onderzoekers ==

 - '''Controlelijsten''' De nieuwe controlelijst ''Behandeling met een diagnose-mismatch'' helpt bij het opsporen van verschillen tussen de daadwerkelijke behandeling (de verrichtingen) en de geconstateerde zorgvraag. Zie [wiki:Documentatie/Gebruikershandleiding/Controlelijsten#DiagnoseMismatch de gebruikershandleiding] voor details.
 - '''Decursus Rapportage''' De rapportage met decursusnotities van een periode -- een rapportage die vooral voor teambesprekingen gebruikt wordt -- is uitgebreid met een optionele sortering, zodat het ook op patient gesorteerd kan worden. Zie de [wiki:Documentatie/Rapportages/Decursus rapportagehandleiding] voor details.
 - '''Tympanogram''' In het tympanogram kon geen negatieve (onder) druk worden ingevuld. Dat kan nu wel (bijvoorbeeld ''-2'').

== Voor het Management ==

 - '''Controlelijsten''' Er is nu een nieuwe controlelijst voor bestanden met een status kleur in oranje. Deze is hetzelfde als de controlelijst voor bestanden met status kleur rood die in v2.002 is geintroduceerd.
 - '''Controlelijsten''' Er is een nieuwe controlelijst ''Behandeling met een diagnose-mismatch'' die aangeeft wanneer de geregistreerde zorgvraag niet overeenkomt met de door OpenAC afgeleide diagnose. Zie [wiki:Documentatie/Gebruikershandleiding/Controlelijsten#DiagnoseMismatch de gebruikershandleiding] voor details.
 - '''FDSK''' De aanlevering van FDSK-gegevens kon met v2.004 niet. Dat is in v2.006 gerepareerd.
 - '''Rapportage''' De schadelastrapportage kon tot deze versie alleen door gebruiker ''admin'' gemaakt worden. Met ingang van v2.006 kan iedereen met management-toestemming (voor wie de schadelastrapportage als knop in het scherm verschijnt) de rapportage uitdraaien. Ticket #6345 ea.
 - '''Rapportage''' De schadelastrapportage en de rapportage AP productie per verzekeraar konden verschillende uitkomsten geven. Dit wordt door de migratie naar v2.006 opgelost (zie onder bij [#Migratie migratie], voor de beheerder).
 - '''Rapportage''' De werktijden-rapportage (van gewerkte- en rooster-uren van de medewerkers binnen een periode) telde in v2.004 en eerder groepsafspraken dubbel (of drievoudig) en bij lange afspraken die over de lunch vielen, werd ook soms dubbel geteld. Deze problemen zijn gefixt in versie v2.006, maar dat kan betekenen dat de gewerkte uren voor sommige medewerkers flink dalen (omdat er niet meer driedubbel geteld wordt). Voor de medewerkers die meer dan 24 uren op een dag leken te werken is dit een uitkomst.

== Voor het Beheer ==

 - '''Acties''' Acties worden nu bewaard, om historie van acties vast te houden; zie ticket #6009.
 - '''Annuleringen'''  Bij het vastleggen van een annulering vanuit de agenda (een "no-show") is het vanaf v2.006 mogelijk om zelf te bepalen wat voor no-show het is. Voorheen hield OpenAC een vast stramien aan voor het bepalen van de no-show type (in het bijzonder niet-verschenen zonder bericht). De adaptatie kan een lokale model-klasse voor `NoShowType` definieren en daarmee de soort no-show die OpenAC gebruikt, aanpassen. Zie r27012 voor een voorbeeld.
 - '''Cohorten''' Het nieuwe scherm ''cohorten'' kan worden aangezet door de module `s080_cohorten` aan de adaptatie-inite toe te voegen.
 - '''Decursus Rapportage''' De module `s080_decursus` heeft een parameter erbij gekregen om sortering in de decursusrapportage mogelijk te maken. Zie de [wiki:Documentatie/Rapportages/Decursus rapportagehandleiding] voor informatie over de rapportage zelf en de [wiki:Documentatie/Beheershandleiding/Instellingen/Modules#kern.s080_decursus moduledocumentatie] voor informatie over de moduleparameter.
 - '''Documentenscherm''' Vanuit het dossier kan via de knop ''documenten'' het documentenscherm opgeroepen worden. Hier staan tabbladen in met een overzicht van decursus en een overzicht van de correspondentie voor het dossier. In v2.006 is het mogelijk om zelf tabbladen hieraan toe te voegen. Zie daarvoor de technische documentatie van de klasse `ViewBase`.
 - '''Klembord''' Er is een nieuwe switch ''gebruik_klembord''. Als deze aan staat (dat is niet de default) dan krijgt de gebruiker een link om kaarten te kopiëren naar het klembord en kunnen selecties ook worden gekopieerd. Het is aan te bevelen deze switch in de adaptatie-init in te stellen, zodat het consistent is binnen het AC. Dat kan bijvoorbeeld met de regel {{{console.switch("gebruik_klembord", True)}}} in de `finish()` van de adaptatie.
 - '''Mappen''' Als er mappen worden gekoppeld aan OpenAC, wordt nu een ander formaat gebruikt voor de opgeslagen `bestand_filenaam`. Voorheen werd alleen de naam van de map opgeslagen, waardoor het niet mogelijk was om aan twee dossiers dezelfde map te koppelen. Dit is nu aangepast, en mappen worden gekoppeld door in de bestandentabel van OpenAC een unieke bestandsnaam op te nemen (volgens gewoon OpenAC recept), met periode, adaptatie en tijdstip-gegevens erin. Daarna volgt een speciale string `-OACMAP-` gevolgd door de naam van de map. OpenAC codeert en decodeert dit zelf. Als er lokale scripts of queries zijn die iets met de gekoppelde mappen doen, moeten die worden aangepast aan de nieuwe inhoud van het veld.
 - '''Planhorizon''' De instelling van een planhorizon (de datum tot wanneer de roosters worden geprojecteerd) moet af-en-toe bijgewerkt worden, omdat die horizon dichterbij komt. Vanaf v2.006 is er een moduleparameter voor `d030_planning` waarmee automatisch de planhorizon op een bepaalde afstand gehouden kan worden. Een redelijke instelling is dan "planhorizon over 13 maanden". Zie de [wiki:Documentatie/Beheershandleiding/Instellingen/Modules#kern.d030_planning moduledocumentatie] voor details. Ticket #4759.
 - '''Query Parameters''' Bij het schrijven van eigen SQL queries zijn veiliger geworden. Het is mogelijk om een getal of een code uit een tabel te kiezen door een `#` of een `@` voor de parameternaam te zetten. Zie de [Documentatie/Beheershandleiding/Queries beheershandleiding] voor details.
 - '''Regelmatig Anonieme backups''' Het wordt aanbevolen om regelmatig een anonieme backup naar de FENAC te versturen, in het kader van het dataconvenant met de FENAC en om te zorgen dat de OpenAC ontwikkelaars altijd redelijk "verse" gegevens hebben van alle adaptaties om mee te testen. OpenAC waarschuwt als er al lang geen anonieme backup verstuurd is; als er met v2.006 nog geen anonieme backup is gemaakt, zegt het:
 > De laatste anonieme backup die naar de FENAC is verstuurd dateert van voor v2.006; maak binnenkort een nieuwe.

== Lokale Aanpassingen ==

 - '''Hoensbroek''' heeft het rood-markeren van binnengemelde afspraken uitgezet.
 - '''Hoensbroek''' heeft het kopiëren naar het klembord uitgezet.

== Migratie ==

 - '''Database''' De velden ''created'', ''modified'' en ''accessed'', waarmee OpenAC registreert wie er aan een dossier (of sommige andere gegevens) heeft gewerkt, waren traditioneel te klein om alle gegevens te bevatten die er in moeten. In v2.006 zijn de velden daarom opgerekt van 40 van 49 posities. Dit leidt tot heel veel rode meldingen over velden die moeten worden aangepast. Datastructuur bijwerken zal deze keer wellicht langer duren dan anders.
 - '''Database''' De acties hebben twee velden er bij gekregen, ''afgehandeld'' en ''afgehandeld_datum'', voor het opslaan van de gegevens over wanneer een actie is afgehandeld. Dit hangt samen met de configuratie-instelling voor acties (zie hierboven).
 - '''Database''' De kwaliteitsindicatoren en outputindicatoren zijn nu opgenomen als aparte tabel. Deze tabel wordt automatisch aangemaakt bij het opstarten van OpenAC v2.006. Om de tabel te vullen met berekende indicatoren, draai het migratie-script `v2_006`. Zie voor details hieronder.
 - '''Database''' Hoewel de koppeling van mappen aan een dossier nu anders wordt opgeslagen, is er geen migratie (nodig). OpenAC kan zowel de oude koppeling (met alleen de map-naam) en de nieuwe (met extra gegevens en markering `-OACMAP-`) aan. Externe scripts moeten misschien wel aangepast worden.
 - '''Database''' De nieuwe koppeling met de CANG introduceert nieuwe tabellen en nieuwe velden in de patienten-tabel (CANG-ID, om de koppeling met dat externe systeem vast te leggen; dit wordt alleen gevuld voor patienten die volgens het CANG-protocol worden aangemeld) en in de decursus-tabel.
 - '''Grouper Module''' In OpenAC v2.004 wordt de koppeling met de landelijke Grouper in '''alle''' adaptaties geladen; ook bij academische huizen en andere gebruikers die geen gebruik maken van de Grouper. In v2.006 is dit verhuisd naar de adaptatie-init, en is elke adaptatie zelf verantwoordelijk voor het importeren en laden van de Grouper-module. Controleer hiervoor de adaptatie-init. Typisch betekent dit dat er twee regels bij moeten: `from kern import e080_grouper` (bovenaan) en `e080_grouper.start()` (in de `start()` functie van de adaptatie).
 - '''Herinneringen''' Voor het versturen van e-mail herinneringen bij een SMTP server die authenticatie vereist, wordt een wachtwoord opgeslagen in de instellingen van OpenAC. In v2.004 werd dit wachtwoord niet-versleuteld opgeslagen. Vanaf v2.006 wel, maar hierdoor is het wel nodig om (eenmalig) nogmaals het wachtwoord voor de SMTP server in te voeren.

Om de overgang naar v2.006 te versoepelen is er een ''migratie-script''. Dit is het OpenAC script `migratie`, dat als een gewoon OpenAC script te gebruiken is nadat je OpenAC hebt bijgewerkt naar v2.006. Het migratie-script past een ''migratie-module'' toe, `v2_006` in dit geval, die de migratie-stappen voor deze versie uitvoert.

Het migratie-script geef je een of meer parameters. De eerste is de naam van de migratie-module (`v2_006`). Daarna '''moet''' je een of meer opties meegeven die aangeven wat de module moet doen. Met `--all` worden alle migratie-stappen opeenvolgend uitgevoerd, maar het is ook mogelijk om de migratie-stappen een-voor-een uit te voeren.  Gebruik `--help` voor een overzicht van de uit-te-voeren migratiestappen. Gebruik optie `-v` om (nog) meer te loggen dan het anders zou doen. 

Dit commando laat zien welke stappen er zijn:

{{{
Python25\python.exe script.py migratie v2_006 --help
}}}

En dit commando voert alle stappen uit en maakt een (extra) logbestand `migratie.log` ter controle.

{{{
Python25\python.exe script.py migratie v2_006 -v --all
}}}

Deze migratie-module voert de volgende acties uit (gebruik `--help` om de lijst te controleren):
 - Datastructuur bijwerken. Als je dit al hebt gedaan na het schakelen, gebeurt er niks.
 - Inlezen landelijke normtijden. Voorheen werd dit elke keer gedaan als OpenAC opstart, maar de normtijden veranderen nooit, dus dat is overbodig.
 - Inlezen van landelijke verzekeraarskoepels. Hierdoor heeft iedereen dezelfde lijst met koepels en bijbehorende UZOVI-codes.
 - Opruimen van "wees" tijdvakken. In de loop der tijd kunnen er tijdvakken zijn ontstaan de in de database die nergens meer bijhoren; ze hangen niet aan een of andere afspraak. Deze tijdvakken worden opgeruimd. Daarnaast kunnen er tijdvakken zijn die aan meerdere records hangen. Deze tijdvakken worden, zomogelijk, ontward en aan slechts een afspraak of bezoek gehangen. De uitvoer van het migratiescript informeert of er niet-te-fixen tijdvakken zijn.
 - Berekenen van output- en kwaliteitsindicatoren voor alle trajecten met een bezoek vanaf januari 2013.
 - Berekenen van de afgeleide OpenAC-diagnose voor alle subtrajecten vanaf de aanvang van DOT, januari 2012.
 - Invullen van AGB-locatie in trajecten waar dat (nog) niet is gebeurd, volgens het stramien van ticket #6505.

[[NoteBox(warn, De migratie is alleen van v2.004 naar v2.006 getest. Gebruikers van oudere versies van OpenAC wordt aangeraden eerst naar v2.004 te migreren (met alle stappen vandien), en daarna pas naar v2.006 te migreren.)]]