= OpenAC v2.100 release notes = ''Release datum: zie '' [milestone:release-2.100 milestone] [[TOC(heading=Inhoud)]] [[TOC(heading=Releases, sectionindex, compact, depth=1, Releases/)]] [[TicketQuery(milestone=release-2.100, format=progress)]] == Algemeen == === NOAH-koppeling === OpenAC v2.100 gaat voornamelijk om de NOAH WSI koppeling. Dat betekent dat metingen, gedaan met NOAH-compatibele software, automatisch in de OpenAC database terecht komen, zonder tussenkomst van OpenAC 2 Desktop. De NOAH koppeling wordt uitvoeriger beschreven in de gebruikers en beheerdersdocumentatie. Zie de [wiki:Documentatie/Beheerder/Modules/NOAH functionele beschrijving van de Noah-koppeling]. === Hoofdbehandelaarschap === In deze versie zijn een aantal nieuwe features toegevoegd met betrekking tot het hoofdbehandelaarschap. De belangrijkste consequentie van hiervan is dat in deze versie initiële subtrajecten waarbij de patiënt niet is gezien door een KFA zullen worden afgekeurd bij de fiatteercontrole. Eventueel kan deze functie worden uitgezet door parameter "afkeuren_als_niet_gezien_door_audioloog" van module d052_notabundel op False te zetten. Om de controle mogelijk te maken heeft het zorgtraject een extra invoerveld gekregen genaamd "Patiënt is gezien door een audioloog". Dit veld wordt automatisch op "ja" gezet als een activiteit wordt ingevoerd in de verdichting clienttijd direct waarbij een audioloog betrokken is. De nieuwe werklijst "Zorgtrajecten waarbij de patiënt niet gezien is door een audioloog" geeft een overzicht van alle patiënten met een niet gefactureerd initieel subtraject waarbij de patiënt niet gezien is door een audioloog. === Overig === Daarnaast worden een paar interne projecten afgerond: - de audit-trail is wat ons betreft voltooid, en voldoet aan de NZa handreiking. De audit trail is met het audit trail scherm in te zien en gemakkelijk opvraagbaar. - OpenAC benchmarking, om snelheid te meten van handelingen in OpenAC. Hiervoor is de tooling nu beschikbaar, en enkele scenario's zijn uitgewerkt. Een vervolg hierop zou meer scenario's uitprogrammeren in de tool zodat er meer data-punten zijn om te vergelijken. - Nadat een doc of docx is aangemaakt, kan uiteindelijk, als het document een definitieve status heeft bereikt, het document omgezet worden naar een pdf bestand. Dit kun je doen door een dossier te openen en daarna het scherm "Documenten" te openen en dan in het tabblad "documenten" het bewuste document (of meerdere documenten) te selecteren en dan vervolgens met de knop "Export naar pdf" het document/de documenten te converteren. De link in de database wordt een corresponderende link naar de pdf bijlage, die te openen is. Het originele doc/docx blijft wel op de bestandslocatie staan mocht men hier toch iets mee willen doen. Mocht er een wachtwoord in het document staan, dan gaat dit helaas verloren na de pdf conversie. We kiezen voor een eenvoudige oplossing voor een pdf zonder wachtwoord, omdat in de toekomst het bestand in de database wordt opgeslagen en door OpenAC beschermt gaat worden. Over het converteren naar een pdf met een wachtwoord, het blijkt dat MS Word hier geen mogelijkheid voor heeft en mocht men dit willen dat alleen derde partij pdf conversie tools dit kunnen, zoals Bullzip. Bullzip kan dit gratis voor 10 windows gebruikers, echter dan is de aansturing en beheer complexer. Daarom hebben we gekozen voor een eenvoudige oplossing. Zoals altijd zijn er tientallen incidentele verbeteringen en uitbreidingen, die hieronder aangestipt worden. == Voor het Secretariaat == - '''Acties''' Bij het selecteren van de medewerkers kan nu ook een gebruikersgroep geselecteerd worden. #10782 - '''Correspondentie''' Het aantal af te beelden correspondentie in het dossier is vanaf deze versie ook afhankelijk van de pager instellingen. Als bijvoorbeeld voor pager-size in de instellingen is 5 ingesteld dan worden per zorgtraject of bezoek vijf correspondenties getoond en een linkje om de rest te laten tonen. Zie de screenshot hieronder.[[br]][[Image(meer.png)]] - '''Dossier''' In een (binnengemeld) bezoek kan de activiteit nog gewijzigd worden. Voorheen veranderde automatisch de duur van het bezoek mee. Dit is niet altijd juist, dus er wordt nu om bevestiging (wel / niet de duur veranderen). #10482 - '''Planlijsten''' In de planlijst openstaande acties is een filter op actie-thema toegevoegd. #10512 - '''Werklijsten''' Er waren nog gevallen waar het opgegeven aantal bij een werklijst (bijvoorbeeld niet-facturabele trajecten) afweek van het aantal dat in de lijst verschijnt. Dat had te maken met verschillende manieren van tellen, en is nu opgelost. #10524 - '''Werklijsten''' er is een nieuwe werklijst 'Geen KFA verwijzing' toegevoegd. Met deze lijst zijn de zorgtrajecten die geen KFA-verwijzing zijn nu zichtbaar. - '''Niet-patiëntgebonden acties''' Het is vanaf deze release mogelijk om niet-patiëntgebonden acties in te voeren. Hiervoor is een nieuw hoofdscherm beschikbaar: "Niet-patiëntgebonden acties". Bij dubbelklikken op een niet-patiëntgebonden actie in de planlijst wordt de actie geopend in dit scherm. - '''Richtafspraken''' Vanaf deze release is optioneel een extra statusveld 'Nieuw' beschikbaar dat wanneer is aangezet de afspraak bovenin planlijst richtafspraken verschijnt. == Voor de Onderzoekers == Er zijn geen aanpassingen in v2.100 speciaal voor onderzoekers. == Voor het Management == - '''Rapportages''' - '''Annuleringen''' De rapportage ''annuleringen'' geeft een overzicht van annuleringen per soort en per activiteit. De [Documentatie/Manager/Rapportages/Monitor/Annuleringen documentatie] is aangepast. De layout van de rapportagepagina's is aangepast om te verduidelijken wat er geteld wordt en op basis waarvan de percentages worden berekend. Merk op dat er op verschillende bladen van de rapportage verschillende dingen (afspraken versus activiteiten; een afspraak kan meerdere activiteiten kennen) worden geteld. #10534 - '''Annuleringen''' De rapportage ''annuleringen'' laat nu ook kolommen zien voor maanden waarin er geen afspraken, bezoeken of annuleringen voorkomen. Dit is vooral handig als de rapportage wordt gebruikt voor het hele lopende kalenderjaar (of een andere periode met maanden in de toekomst). De maanden in de toekomst krijgen dan wel een kolom in de rapportage -- voorheen werden ze gewoon weggelaten. #10695 - '''Kwaliteitsindicatoren''' De doorlooptijden zijn vanaf deze versie gecategoriseerd in leeftijdsgroepen per zorgvraag 'Kind Gehoor (t/m 7jr)', 'Jong Gehoor (8 t/m 17jr)', 'Volwassene Gehoor', 'Kind S/T (t/m 17jr)' en 'Volwassene S/T'. == Lokale Aanpassingen == Er zijn geen bijzondere lokale aanpassingen in v2.100. == Voor het Beheer == - '''Plandagstatus''' Kleur van de verschillende afspraak blokken (richtafspraak, annulering en definitieve afspraak) in het dossier is met deze versie in codetabel 'plandagstatus' instelbaar. - '''Correspondentie''' Het aantal af te beelden correspondentie in het dossier is vanaf deze versie ook afhankelijk van de pager instellingen. - '''Sjablonen''' Realiseren van het veld 'tooltip_gebruik'. Bestandslinks die een externe programma in modal dialoog opstarten tonen de tooltip van het bestand op de voorgrond en dat is voor de gebruiker lastig om met de externe programma te werken. Vooral de gebruikers van Eldege, Decos en Easidata hebben hier last van. Hiermee kun je bij die sjablonen aangeven of de tooltip mag worden getoond. - '''ImageViewer''' Foto bestanden kunnen optioneel via de nieuwe ImageViewer tool van OpenAC getoond worden. Om deze viewer te activeren moet de instelling {{{openac_image_viewer_actief = True}}} onder [kern.f080_bijlage] in modules.ini toegevoegd worden. - '''Scannen''' Scannen naar PDF formaat. Module f080_scan_twain heeft een nieuwe optie: "genereer_pdf". Als deze optie in modules.ini op True wordt gezet dan genereert OpenAC na het scannen behalve het .scan bestand ook automatisch een PDF. #11224. - '''Richtafspraken''' Vanaf deze release is optioneel een extra statusveld 'Nieuw' beschikbaar dat wanneer is aangezet de afspraak bovenin planlijst richtafspraken verschijnt. Om dit nieuwe veld te gebruiken moet je de module parameter richtdag_status_nieuw van d042_dossier aanzetten. - '''Pager''' Entries met een rode signaleringen ook als ze niet recent zijn voor de pager wel tonen. Ticket #10770. - '''SMS''' Een SMS bestand wordt aangemaakt als er succesvol een SMS-aanroep naar de SMS provider is gedaan. Dus het bestaan van het SMS-bestandje is het teken dat OpenAC succesvol de SMS provider opdracht heeft gegeven het SMSje te versturen. Er was een randgeval, opgelost in deze release: als je voor een patiënt een mobiel nummer invoert, dat blanko is, kon het gebeuren dat er nul verzoeken werden gedaan, en toch een SMS bestand aangemaakt. Dat is nu opgelost. Ticket #10703. - '''Gebruikersgroepen''' Bij de gebruikersgroepen kun je aangeven of ze bij de medewerkersselectie van een actie zichtbaar moet zijn door veld 'gebruik_in_selectie' op ja/nee te zetten. Default waarde is leeg wat 'ja' betekent. == NOAH WSI License Installeren == WSI staat voor Web Services Integration en biedt bi-directionele connectiviteit naar andere systemen. Deze software dient geïnstalleerd te worden en zorgt voor de koppeling van Noah met OpenAC. Zie ook [wiki:Documentatie/Beheerder/Modules/NOAH functionele beschrijving van de Noah-koppeling]. Voor dit gedeelte van de installatie heeft u ondersteuning nodig van de FENAC servicedesk. Alleen zij kunnen het zogenaamde licentie programma uitvoeren. De procedure is in grote lijnen als volgt: - Controleer eerst het versienummer van de NOAH-server. Dat moet minimaal 4.4 zijn. - Draai de WSI license executable. Deze wordt op aanvraag van de AC's op afstand door FENAC uitgevoerd. - Draai de WSI components executable. Deze wordt op aanvraag van de AC's op afstand door FENAC uitgevoerd. Elke Noah versie heeft een bijbehorende WSI components executable. Voor Noah 4.8 is dit NoahWSISetup_4.8.exe - Herstart de machine waar NOAH op draait. == Noah WSI configuratie == - Start op de Noah server-computer NOAHBSIntegServerTool.exe in C:/Program Files (x86)/HIMSA/NOAH 4. - Klik op menu 'File -> Enable Web Integration' aan. - Open 'Web Server Settings' via Window -> Configuration - Web Server Settings [[Image(NoahSerrverToegankelijk_OpPoort_EnClientEndpoints.png)]] - Volgende configuratie variabelen instellen: - !BackEndWebServiceName: De (windows)computernaam waar OpenAC 3 op draait. - Name: Vrij te kiezen naam voor WSI-setup. - !NoahSiteIdentification: Vul hier de servernaam waar de Noah-server op is geïnstalleerd. Dit is meestal ook waar de Noah-webservice op draait. - !NoahWebServiceId: Hier staat de servernaam waar de Noah-webservice op draait. Dit is de computer waar eerder de WSI Licentie en WSI component op is geïnstalleerd. - !NoahWebServicePort: poortnummer voor Noah-webservice. - Herstart het systeem (of herstart de Noah windows services). == OpenAC 2 configuratie == OpenAC 2 moet instellingen krijgen waardoor nieuwe en gewijzigde patiëntgegevens doorgegeven worden aan de Noah-server en Noah-database. - Activeren Noah-module in modules.ini van de adaptatie: {{{ kern.s080_noah = True }}} - Instellen van de hostname en het poortnummer waar de Noah-webservice op draait. Dit heb je eerder ingesteld in de Noah WSI-configuratie-tool. Hostname mag een windows computernaam zijn of een IP-adres. [[Image(NoahServerInstelling_OpOpenAC2.png)]] == OpenAC 3 configuratie == OpenAC 3 moet toegankelijk zijn voor Noah zodat de nieuwe en gewijzigde patiëntgegevens, die in Noah ingevoerd zijn, verwerkt kunnen worden in OpenAC. - Wijzig hiervoor het poortnummer in C:/ProgramData/OpenACWeb/hosting.json op 8001. De default instelling bij Noah is 8001 en volgens de Noah forum is dat aan te passen in het config-bestand "!NoahWebIntegration.dll.config" maar het lijkt ons makkelijker het poortnummer in hosting.json aan te passen. OpenAC 3 moet ook de nieuwe en gewijzigde patiëntgegevens door kunnen sturen naar de Noah-webservice zodat deze verwerkt kunnen worden door Noah-server en Noah-database. Wijzig hiervoor de appsettings.json van C:/ProgramData/OpenACWeb/ zoals hieronder aangegeven. - Voeg het veld !NoahServerPoort toe. Vul hier het poortnummer in waar de Noah-webservice op draait. Dit heb je eerder ingesteld met de Noah WSI-configuratie-tool. (De hostname waar de webservice opdraait is reeds ingesteld in OpenAC 2 en daardoor bekend voor OpenAC 3). Zie hieronder een fragment van appsetting.json: {{{ "Agb": { "Serieprefix": { "patient": { "F": "AM3", "U": "AM7", "H": "AM9", "S": "AM0", "A": "AM0", "Q": "H{jaar2}-", "default": "OA" } }, "AgbLocaties": [ { "Code": "19001234", "LocatieNaam": "Utrecht", "LocatieLetter": "U", "Bestandsmap": "C:\\Users\\ugur\\Documents", "NoahServerPoort": "8000", "NoahHost": "localhost" }, { "Code": "94056905", "LocatieNaam": "Amsterdam", "LocatieLetter": "A", "Bestandsmap": "C:\\Users\\ugur\\Documents", "NoahServerPoort": "8000", "NoahHost": "localhost" }, { "Code": "99999999", "LocatieNaam": "Rotterdam", "LocatieLetter": "R", "Bestandsmap": "C:\\Users\\ugur\\Documents", "NoahServerPoort": "8000", "NoahHost": "localhost" } ] }, }}} == Firewall instellen == Er dienen aantal firewallregels ingesteld te worden in Windows zodat de computers toegang hebben tot de eerder genoemde poorten. Op de server-computer waar Noah op geïnstalleerd: - Zet poort 8000 voor binnenkomende verkeer toegankelijk. Geef hier de naam van de spelregel(rule) "Noah binnenkomend". - Optioneel bij verbindingsproblemen, zet poort 8001 voor uitgaande verkeer toegankelijk. Geef hier de naam van de spelregel "Noah uitgaand". Op de server-computer waar OpenAC 3 op is geïnstalleerd: - Zet poort 8001 voor binnenkomende verkeer toegankelijk, geef hier de naam van de spelregel(rule) "Noah binnenkomend". - Optioneel bij verbindingsproblemen, zet poort 8000 voor uitgaande verkeer toegankelijk, geef hier de naam van de spelregel "Noah uitgaand". Vervolgens kun je een deeltest doen. Start OpenAC 3 op. - Open een internet browser(chrome) op de server-computer waar OpenAC 3 op geïnstalleerd is en typ het volledige webadres in van de OpenAC 3 applicatie. Voorbeeld: !http://openac3-server:8001. Dit is om te kijken of het poortnummer, welke eerder ingesteld is, ook werkt. Kijk of de statuspagina van OpenAC 3 te zien is. - Doe het zelfde op de Noah server-computer waar de Noah-webservice (WSI) op geïnstalleerd is. Hiermee test je of OpenAC 3 bereikbaar is voor de Noah-webservice. == Migratie == '''Script''' Ook voor v2.100 is er een migratie-script om database-aanpassingen te doen en nieuwe gegevens in te voeren. Zie voor verdere uitleg over het migratie-script de [wiki:/Documentatie/Beheerder/Scripts#Migratie beheershandleiding]. De migratie-stappen voor v2.100 zijn te vinden door het migratie-script te draaien zonder argumenten. [[NoteBox(warn, '''Let op:''' het is niet mogelijk om in een keer een migratie van versies eerder dan v2.016 te doen. Doe eerst de migratie naar v2.016 en dan die van v2.016 naar v2.100.)]]'''''''''''' '''Migratie NOAH-database:''' De identificatie van de patiënten tussen OpenAC en Noah-server gebeurt via het veld 'BackEndSystemPatientId' dat default niet is ingevuld. Noah WSI module heeft een API om dat veld te initialiseren met de patient_key van het OpenAC dossier. Er zijn twee parameters om die API aan te roepen. Dat zijn 'BackEndSystemPatientId' en 'OldBackEndSystemPatientId'. Omdat dat veld default leeg is hebben we in eerste instantie geen 'OldBackEndSystemPatientId'. We moeten eerst zorgen dat die velden zijn ingevuld. Dat doen we door de volgende stappen te volgen: - Zorg er voor dat medewerkers niet met Noah database bezig zijn (doe dit liever buiten de kantoortijden om geen dataconflicten te krijgen). - Maak een backup van de Noah database voor het geval dat er een dataverlies optreedt. [[Image(noah_nieuwe_database.png)]] - Maak een export van de Noah patiënten voor gebruik in Noah-installatie (exportbestand met .nahx extensie). [[Image(noah_export.png)]] - Verwijder alle patiëntrecords in Noah 4 System GUI. - Importeer het exportbestand dat je eerder in stap 2 hebt aangemaakt. == Matchen Noah patiënten met OpenAC patiënten == Om de patiënten van Noah te matchen met de patiënten van OpenAC en de audiogrammen in OpenAC te updaten moeten de volgende worden uitgevoerd. - Start OpenACWeb op - Type in adresbalk van je webbrowser dezelfde naam voor NoahHost gevolgd door een dubbelepunt en NoahPoort en '/GetNoahPatientData'. Voorbeeld: http://openac3-server:8001/GetNoahPatientData - Druk op [enter]. Dat kan lang duren totdat alle patiëntrecords zijn opgehaald en verwerkt in OpenAC database. Doe dit dus buiten de kantoortijd. == Testplan == Zie ook het algemene [wiki:/Documentatie/Ontwikkelaar/Procedures/TestProtocol OpenAC testplan]. == Benchmark == Voor het eerst zijn er nu ook benchmark-scripts om te testen hoe snel bepaalde handelingen in OpenAC 2 gaan. Zie ook ticket #8500. Er is gekozen voor het tool [http://www.sikulix.com/ Sikuli], met een verzameling [attachment:sikuli.zip Sikuli-scripts]. Zie de README bij de scripts voor meer informatie.