Gebruikershandleiding Privacy- en Verzendmodule DIS voor Windows, Mac OS en Linux
Opdrachtgever:
Opdrachtnemer:
Uitgebracht aan: Uitgebracht door: Referentie: Datum: Versie:
Nederlandse Zorgautoriteit ZorgTTP Gebruik PVM_DIS_5.3 17 december 2015 1.0
Inhoudsopgave 1
1.1 2
2.1 2.2 3
3.1 3.2 3.3 3.4 4
4.1 4.2 4.3 4.4 4.5 4.6
INLEIDING ...................................................................................................................................... 3
Opbouw van dit document ..................................................................................... 3 AANLEVEREN AAN DIS - GUI...................................................................................................... 4
Starten van de PVM DIS ........................................................................................ 4 De aanlevering ....................................................................................................... 5 AANLEVEREN AAN DIS – COMMAND LINE ............................................................................. 13
Inleiding ................................................................................................................13 Starten van de PVM DIS via run script (run.bat of run.sh) .....................................13 Starten van de PVM DIS via run4user script (run4user.bat of run4user.sh)...........14 Uitkomsten van de verwerking ..............................................................................15 WIJZIGEN EN AANVULLEN VAN INSTELLINGEN ................................................................... 17
Eerste gebruik van de module...............................................................................17 Koppelen/aanmaken certificaat .............................................................................17 Een nieuw certificaat aanmaken ...........................................................................18 Koppelen van een bestaand certificaat .................................................................19 Het tabblad ‘Proxy’ (optioneel) ..............................................................................20 Het tabblad ‘DIS Gebruikersnaam’ ........................................................................20
BIJLAGE 1. FOUTEN BIJ DE VERWERKING..................................................................................... 21 BIJLAGE 2. VEELGESTELDE VRAGEN (FAQ-LIJST) ...................................................................... 27 BIJLAGE 3. USER.PROPERTIES BESTAND ..................................................................................... 29 BIJLAGE 4 AANPASSEN RAPPORTAGE INSTELLINGEN .............................................................. 30
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 2 van 31
1 Inleiding 1.1 Opbouw van dit document Dit is de handleiding voor het gebruik1 van de Privacy- en Verzend Module DIS (PVM DIS). Met deze software worden persoonsgegevens in DIS aanleveringen gepseudonimiseerd. De PVM DIS is verantwoordelijk voor het maken van pseudoniemen, het verwijderen van de oorspronkelijke persoonsgegevens en het automatisch verzenden van de aanlevering naar DIS via een beveiligde verbinding. Hoe u PVM DIS via een grafische gebruikersinterface bedient staat beschreven in hoofdstuk 2. Het is ook mogelijk de PVM DIS zonder gebruikersinteractie bestanden te laten verzenden, dit wordt toegelicht in hoofdstuk 3. Deze handleiding is gemaakt op basis van een PVM DIS die is geïnstalleerd op een computer met Windows. De handleiding is ook geschikt voor computers werkend onder de besturingssystemen Mac OS en Linux. De afbeeldingen van de schermen verschillen functioneel niet met de schermen onder Mac OS of Linux. Daar waar er wezenlijke verschillen zijn met Windows is dat aangegeven.
1
Als u de PVM nog niet heeft geïnstalleerd, zie dan: ‘Installatiehandleiding Privacy- en Verzendmodule DIS voor Windows, Mac OS en Linux’. Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 3 van 31
2 Aanleveren aan DIS - GUI De algemene werking is als volgt: uitgangspunt is dat de door DIS gevraagde gegevens beschikbaar zijn als bestand op uw computer. U start de PVM DIS en wijst het bestand aan om het te verzenden. 2.1
Starten van de PVM DIS
a. Windows Klik op het icoon om de PVM DIS te starten.
PVM DIS b. Mac OS X Klik op ‘Finder’ en ga naar ‘Programma’s’, ‘ZorgTTP’, ‘DIS’, ‘PVM’. Klik vervolgens op het icoon:
PVM c. Linux Ingeval u een link op de Desktop heeft geplaatst kunt u de PVM DIS starten door te dubbelklikken op icoon:
PVM-linux De PVM-DIS kan ook gestart worden via ‘Locaties - Bestandsbeheer - ZorgTTP – DIS en vervolgens het bovenstaande icoon ‘PVM-linux’ aan te klikken.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 4 van 31
2.2
De aanlevering
1. Start de applicatie. Met behulp van de knop ‘Zoeken’ selecteert u het bestand dat u naar DIS wilt verzenden.
Indien er een ander scherm verschijnt, ga dan eerst naar hoofdstuk 4. 2. Met behulp van het zoekscherm kunt u de DIS aanlevering opzoeken en selecteren. Alleen bestanden die voldoen aan een toegestane standaard voor DIS gegevensaanlevering worden in behandeling genomen.
Nadat u het bestand heeft geselecteerd klikt u op ‘Volgende’. De verwerking wordt gestart en het ‘Voortgangscherm’ verschijnt waarin de voortgang van de verwerking wordt getoond.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 5 van 31
De verwerkingstijd is afhankelijk van de grootte van het aangeboden bestand alsmede de performance van de computer. Doorgaans neemt dit een aantal minuten in beslag.
PVM DIS toont een verslag van de verwerking. Daarbij is een aantal uitkomsten mogelijk.
A. De verwerking is goed gegaan.
Er zijn in dit geval geen fouten geconstateerd. Het bestand is verzonden naar ZorgTTP, waar de gegevens voor een tweede keer worden gepseudonimiseerd. ZorgTTP zal zorgdragen voor verzending aan DIS. De resultaten van de verwerking naar DIS kunt u terugvinden in de disportal. De PVM DIS legt de verwerking van een bestand vast in een verslag. Om dit verslag direct te raadplegen klikt u op ‘Toon rapport’. Het verslag staat ook op uw computer en kan op een later moment nogmaals geopend worden.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 6 van 31
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 7 van 31
B. Het bestand wordt niet verwacht volgens de aanleverplanning Bij raadplegen van de DIS-aanleverplanning is geconstateerd dat het bestand niet wordt verwacht. Verdere controle van het aangeboden bestand wordt niet uitgevoerd. Het bestand wordt niet verzonden.
Via de aanleverplanning op de disportal kunt u nagaan welke aanlevering wordt verwacht. Voor vragen hierover kunt u contact opnemen met het Service en Informatiecentrum DIS.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 8 van 31
C. Het bestand bevat validatiefouten
Tijdens de verwerking worden controles (validaties) uitgevoerd op de aangeboden gegevens. Indien er fatale validatiefouten worden aangetroffen wordt het bestand niet verzonden. De geconstateerde fouten dienen hersteld te worden waarna het bestand opnieuw kan worden aangeboden. Informatie over de aangetroffen fouten staan in de kwaliteitsrapportage. Klik op de knop ‘Toon rapport’ om de rapportage te openen. De rapportage (
_DIS_PVM.HTML) is opgeslagen in de map waar het te verwerken bestand is opgeslagen, zodat u deze achteraf nog kunt raadplegen.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 9 van 31
In het verwerkingsverslag treft u informatie aan over het bestand dat u heeft geselecteerd, de datum waarop de PVM DIS het bestand verwerkte en het resultaat van de verwerking. Als de PVM DIS fouten heeft geconstateerd, dan staat in het rapport een overzicht van de geconstateerde fouten. Per geconstateerde fout wordt aangegeven: De code van de fout; De patiënt waarbij de fout is geconstateerd; De aangetroffen waarde (tenzij het gegeven ontbreekt); De omschrijving van de geconstateerde fout.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 10 van 31
D. De PVM DIS kan geen verbinding maken via internet
De PVM DIS legt via internet contact met het adres https://www.zorgttp.nl. Als u de melding van de afbeelding hierboven te zien krijgt, kan de PVM DIS geen contact maken met ZorgTTP. Dit kan liggen aan de volgende zaken: 1. Er is geen internet verbinding; 2. De firewall blokkeert de toegang; 3. De proxyserver blokkeert de toegang; 4. Antivirussoftware blokkeert de toegang. In alle gevallen dient er toestemming te worden verleend voor het gebruik van de internetverbinding door de PVM DIS. Vraag uw systeembeheerder om de blokkade te verhelpen. Meer informatie hierover kunt u vinden in Bijlage 2: Veelgestelde vragen.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 11 van 31
E. Certificaat melding Drie maanden voor het verlopen van het certificaat zal de PVM dit melden. Voor meer informatie over het vervangen of verlengen ervan kunt u contact opnemen met het Serviceen Informatiecentrum DIS.
F. Overige foutmeldingen Tijdens de verwerking door de PVM-DIS worden de gegevens in de DIS aanlevering gecontroleerd. Bijlage 1: “Fouten bij de verwerking” geeft een overzicht van mogelijke foutmeldingen die betrekking hebben op de gegevens. Technische fouten in de structuur of opbouw van het bestand worden onmiddellijk op het scherm gemeld. Fatale fouten en waarschuwingen over de gegevens worden via de kwaliteitsrapportage teruggekoppeld. Voorbeeld van een technische fout:
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 12 van 31
3 Aanleveren aan DIS – Command line 3.1 Inleiding Nadat de PVM DIS is geïnstalleerd op uw computer en is ingericht, kunt u aan de slag. 3.2 Starten van de PVM DIS via run script (run.bat of run.sh) De verwerking kan gestart worden vanuit het pad van de applicatie middels de bijgeleverde run bestanden (run.bat, run.sh). De argument specificaties voor het starten van de PVM DIS zónder gebruikersinterface zijn: Windows) >PVM [-Coptie]
Linux >./PVM [-Coptie]
Waarbij (de volgorde is niet van belang): - , het absolute/relatieve pad naar het te verwerken bestand Het te verwerken bestand waarbij relatief t.a.v. pvm folder kan worden gerefereerd dan wel een absoluut pad. - [-Coptie], -C Hiermee kan de PVM worden gestart met specifieke gebruikersgegevens . Wanneer ontbreekt wordt de PVM met grafische interface gestart opgestart. Voorbeeld voor twee gebruikers (USER123 en USERxyx). 1. Maak twee directorys aan met daarin een user.properties bestand dat de specifieke gebruikers instellingen bevat, bijvoorbeeld: -CC:\DIS\USER123\user.properties -CC:\DIS\USERxyz\user.properties 2. Start de PVM voor iedere gebruiker als volgt >PVM -CC:\DIS\USER123\user.properties d:\[Naam bestand] >PVM -CC:\DIS\USERxyz\user.properties d:\[Naam bestand] Waarbij geldt dat: 1. [Naam bestand].zip de bestandsnaam is van het te verwerken bestand. 2. De parameter –C wordt niet gevolgd door een spatie. Middels deze optie kan een alternatieve locatie van het pad, waarin het user.properties bestand is opgeslagen, worden aangeroepen. Op die wijze kan voor meerdere zorgaanbieders in een run worden aangeleverd. Hierbij wordt steeds een compleet configuratiebestand per zorgaanbieder aangeroepen. Voor iedere zorgaanbieder dient in de locatie waar naar wordt verwezen het bestand user.properties aanwezig te zijn, met daarin de gebruiker specifieke instellingen. Het user.properties bestand dient altijd user.properties te heten. 3. De opgegeven paden mogen geen spaties bevatten. Zet in geval van spaties ieder argument tussen quotes. 4. De locatie van de alternatieve configuratiefile is vrij, waardoor in de directory naam bijvoorbeeld de AGB-code kan worden opgenomen.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 13 van 31
3.3
Starten van de PVM DIS via run4user script (run4user.bat of run4user.sh)
Indien het de bedoeling is om alleen de DIS gebruikersnaam te variëren dan kan gebruik worden gemaakt van het run4user script. >run4user.bat <argumenten> (Windows) >run4user.sh <argumenten> (Linux/Mac)
Waarbij de <argumenten> zijn: - : de gebruikersnaam voor www.disportal.nl die wordt gebruikt voor het raadplegen van de DIS aanleverplanning. - : het te verwerken bestand waarbij relatief t.a.v. pvm folder kan worden gerefereerd dan wel een absoluut pad.
Voorbeeld: C:\PROGRA~1\ZorgTTP\DIS\pvm>run4user.bat < DISportal gebruikersnaam > .\DIS_SZG_OHW_TEST_010_06010101_00_20111118_02.zip C:\PROGRA~1\ZorgTTP\DIS\pvm>powershell -File pvm.ps1 < DISportal gebruikersnaam> .\DIS_SZG_OHW_TEST_010_06010101_00_20111118_02.zip C:\PROGRA~1\ZorgTTP\DIS\pvm>echo %errorlevel% 0
Dit script maakt binnen Windows gebruik van Windows Powershell. De rechten voor het uitvoeren van scripts zijn daarbij standaard beperkt. Deze kunnen worden aangepast via: C:\PROGRA~1\ZorgTTP\DIS\pvm>powershell Windows PowerShell Copyright (C) 2009 Microsoft Corporation. All rights reserved. PS C:\Program Files\ZorgTTP\DIS\pvm>Set-ExecutionPolicy Unrestricted
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 14 van 31
3.4
Uitkomsten van de verwerking
De activiteiten die de PVM DIS uitvoert zijn de volgende: 1. De aangeboden persoonsgegevens worden gecontroleerd en vervolgens gepseudonimiseerd 2. Het bestand wordt via ZorgTTP verzonden aan DIS. Nadat deze activiteiten zijn uitgevoerd, zal de PVM DIS op twee manieren verslag doen van de verwerking: 1. PVM exit code, waarmee het resultaat van de verwerking wordt weergegeven 2. PVM verwerkingsverslag In het PVM verwerkingsverslag vindt u informatie over het bestand dat u heeft verzonden aan het DIS, de datum waarop dat is uitgevoerd en verdere informatie over de verwerking. De rapportage (_DIS_PVM.HTML) is opgeslagen in de map waar het te verwerken bestand is opgeslagen. Er is een aantal uitkomsten mogelijk: A. De verwerking is goed gegaan. In geval van een probleemloze verwerking is de exit-code 0 (nul) Er zijn in dit geval geen fouten geconstateerd. Het bestand is verzonden naar ZorgTTP, waar de gegevens voor een tweede keer worden gepseudonimiseerd. ZorgTTP zal zorgdragen voor verzending aan DIS. De resultaten van de verwerking in DIS kunt u terugvinden in de disportal.
B. De verwerking is niet goed gegaan. Wanneer de verwerking niet is goed gegaan, zal dit via de exit-code worden gemeld aan de gebruiker. De exit-code geeft informatie over het verloop van de verwerking. Voor het run.bat en run.sh script wordt deze code getoond op de commandline, voor het run4user.bat en run4user.sh script is dat niet het geval (tonen via echo %errorlevel%). Mogelijke waarden van de exit-code: Code 0 1 10 20 30
Melding SUCCESS
40 50
RESTART AANLEVERPLANNING_ERR
100
TECH_ERR
FILENOTFOUND_ERR VALIDATION_ERR UPLOADING_ERR
Toelichting De verwerking is succesvol afgerond De verwerking is afgebroken Het te verwerken bestand is niet gevonden Er zijn validatiefouten opgetreden Het verwerkte bestand kan niet worden verzonden Het aan te leveren bestand wordt niet verwacht door de aanleverplanning Algemene melding voor technische problemen. Zie het log bestand voor meer informatie
Tijdens de verwerking worden controles (validaties) uitgevoerd op de aangeboden gegevens. Indien er validatiefouten worden aangetroffen wordt het bestand niet verzonden. Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 15 van 31
De geconstateerde fouten dienen hersteld te worden waarna het bestand opnieuw kan worden aangeboden. Informatie over de aangetroffen fouten staat in het verwerkingsverslag. De foutinformatie met betrekking tot het selecteren van bestanden en het instellen van gebruikersparameters kan worden gehaald uit het bestand ‘pvm.log’ die zich in de aangewezen werk map na standaard installatie onder [werkfolder]/ZorgTTP/DIS/log bevindt. Foutinformatie met betrekking tot de validaties die worden uitgevoerd op te verwerken bestanden kan worden gehaald uit het verwerkingsverslag; ‘_PVMDIS.HTML’. Dit bestand wordt aangemaakt op de locatie waar de applicatie de te verwerken bestand voor DIS aanlevering heeft opgehaald. De in het verwerkingsverslag gehanteerde foutcodes kunnen worden nagelezen in bijlage 1.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 16 van 31
4 Wijzigen en aanvullen van instellingen 4.1
Eerste gebruik van de module
Voordat u de module kunt gebruiken moet een aantal eigenschappen eenmalig worden ingesteld. Afhankelijk van de omvang van uw organisatie kan het zijn dat deze eigenschappen door de IT afdeling worden ingesteld of dat u deze zelf dient in te stellen. Voor de volledigheid is dit hoofdstuk daarom zowel in de handleiding voor installatie als die voor gebruik opgenomen.
4.2
Koppelen/aanmaken certificaat
Zodra de PVM voor de eerste keer wordt opgestart en er geen bestaand certificaat gekoppeld is, zal automatisch het volgende scherm worden weergegeven:
Er zijn nu twee opties, welke worden toegelicht in de paragrafen: 4.3 Een nieuw certificaat aanmaken 4.4 Koppelen van een bestaand certificaat
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 17 van 31
4.3 Een nieuw certificaat aanmaken U kunt alleen een certificaat aanmaken, als u in het bezit bent van een brief van de Servicedesk van ZorgTTP, met hierin een activatiecode. Vul alle velden in op het tabblad ‘Certificaat aanmaken’. Zolang een invoerveld geen geldige invoer bevat, zal de tekst van dit veld rood gemarkeerd zijn. Boven de knop ‘Creëer certificaat’ wordt er aangegeven wat er niet geldig is aan de invoer. Zie onderstaand scherm voor een voorbeeld:
Klik op de knop ‘Creëer certificaat’ als alle velden volledig zijn ingevuld:
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 18 van 31
Het volgende scherm wordt nu weergegeven:
Het certificaat wordt automatisch gekoppeld, nadat u de DIS gebruikersnaam heeft ingevuld is de PVM DIS gereed voor gebruik. 4.4
Koppelen van een bestaand certificaat
Om gebruik te kunnen maken van een certificaat wat u al eerder gedownload heeft, moet u dit certificaat aan de PVM module bekend maken. Hiervoor heeft u de locatie nodig waar het certificaat op uw computer is opgeslagen en het bijbehorende wachtwoord. Om het certificaat te koppelen aan de PVM, klikt u op het tabblad ‘certificaat’:
Gebruik vervolgens de knop ‘Zoeken’ om te bladeren naar de map waarin uw .p12 certificaat staat en selecteer deze. Vul daarna het wachtwoord van uw certificaat in en klik op ‘Opslaan’. Het certificaat is nu gekoppeld.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 19 van 31
4.5 Het tabblad ‘Proxy’ (optioneel) In onderstaand tabblad kan het gebruik van een proxy server door de PVM DIS applicatie worden ingesteld. Raadpleeg zo mogelijk uw systeembeheerder voor de in te vullen waarden.
Indien gebruik wordt gemaakt van een proxy server met een zogenaamd NTLM authenticatie schema (Windows NT), dan dient een vinkje gezet te worden bij ‘NTLM authenticatie’ en dient het domein waarbinnen de gebruiker actief is te worden opgevoerd. Let op! Wijzigingen worden pas definitief van kracht nadat de applicatie opnieuw is opgestart. Sla wijzigingen eerst op voordat u de applicatie opnieuw opstart. 4.6 Het tabblad ‘DIS Gebruikersnaam’ In onderstaand scherm vult u uw DIS gebruikersnaam in. Dit is de gebruikersnaam die u ook gebruikt om in te loggen op de DIS-portal (https://www.disportal.nl). Uw gebruikersnaam wordt bij het verzenden van de aanlevering gebruikt om te toetsen of het bestand verwacht wordt volgens de DIS aanleverplanning.
Klik op ‘Opslaan’ en start de applicatie opnieuw op. Pas na opnieuw opstarten is de opgegeven DIS gebruikersnaam definitief vastgelegd in de module. Bij volgende verwerkingen hoeft de gebruikersnaam niet opnieuw te worden opgegeven. Op dit punt heeft u alle voorbereidende handelingen verricht. De eerste aanlevering aan DIS kan plaatsvinden. Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 20 van 31
Bijlage 1. Fouten bij de verwerking Onderstaande tabel geeft een overzicht van binnen de PVM DIS gehanteerde foutcodes, een beschrijving van de bijbehorende fout, en de gevolgen voor de verwerking. Voor foutcodes tussen 1000 en 1999 geldt dat de foutcode en de foutmelding steeds zichtbaar worden in de applicatie zodra de fout optreedt. De verwerking kan slechts worden hervat door een aanpassing te doen. Foutcodes tussen 2000 en 2999, evenals waarschuwingscodes 3000 t/m 3003 en 3102 t/m 3140 (de 31xx range wordt alleen gebruikt in de SZ OHW afhandeling) kunnen worden ingezien door de na de verwerking aangemaakte kwaliteitsrapportage in te zien. De applicatie geeft na verwerking aan dat er validatiefouten en/of waarschuwingen zijn opgetreden en dat voor meer informatie de rapportage kan worden geopend met de knop ‘Toon rapport’. In het overzicht wordt per fouttype aangegeven wat de afhandeling door de PVM is. Type Korte omschrijving
Verwerking Verzending Omschrijving input best. DISbestand N N Er is een technische fout opgetreden. De PVM zal het aangeboden bestand niet verwerken (geen inhoudelijke controle en geen verzending van het DIS-bestand).
T
Technische fout
F
Fatale fout
J
N
De PVM heeft het aangeboden bestand inhoudelijk gecontroleerd en fatale fouten gevonden. Er wordt geen output bestand aangemaakt. Er wordt geen DIS-bestand verzonden naar ZorgTTP.
W
Waarschuwing
J
J
De PVM heeft het aangeboden bestand inhoudelijk gecontroleerd. Er zijn , waarschuwingen (niet fatale fouten) gevonden. Er wordt een output bestand wordt aangemaakt, welke wordt verzonden aan ZorgTTP voor een tweede versleuteling.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 21 van 31
Overzicht mogelijke fouten bij het verwerken van bestanden Nr 1002
Melding Het programma kan de opgegeven drive:\werkdirectory niet vinden.
Type T
1007
Het pad bestaat niet. Controleer het pad en probeer het opnieuw.
T
1008
De naam van het aangeboden bestand is verboden.
T
1013
Het aangeboden bestand kan niet uitgepakt worden.
T
1017
De pakbon is leeg.
T
1018
De pakbon bevat meer dan één regel. Het zipbestand bevat niet alle bestanden die door de GA zijn voorgeschreven
T
1022
PATIENT.txt bevat een regel met verkeerde lengte.
T
2001
Naam is niet gevuld
F
2002
Naamcode bevat geen geldige waarde.
F
2003
Naam begint met een spatie.
F
2004
Naam bevat vreemde tekens
F
2005
Voorletters is niet gevuld.
F
1021
T
Beschrijving De opgegeven drive:\werkdirectory kan niet gevonden worden.
Het opgegeven bestand bevindt zich niet in de werkdirectory. De naam van het aangeboden bestand moet legitiem zijn. Het aangeboden bestand moet uitgepakt kunnen worden. (unzippen) Pakbon.txt moet één regel bevatten. Pakbon.txt mag niet meer dan één regel bevatten. De PVM controleert binnen iedere zip of alle voor het type GA verwachte bestanden aanwezig zijn. Er zijn 1 of meerdere regels gevonden waarvan de regellente niet voldoet aan de specificatie (te kort of te lang). Het veld ‘(za)naam_1’ moet gevuld zijn.
Voor de velden ‘(za) naamcode_1’ en ‘(za) naamcode_2’ zijn alleen de waarden “spatie”, “1” of “2” toegestaan. De naam moet links uitgelijnd zijn. De naam moet gevuld zijn met een legitiem teken. De afhandeling van diakritische tekens wordt beschreven in Appendix ‘A’ van het document Specificaties PVM-DIS De eerste positie van het veld ‘(za )voorletters’ moet gevuld zijn.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Gevolg De foutcode en foutmelding blijven in beeld totdat een ander, geldig bestand wordt geselecteerd Idem
Idem
Idem
Idem Idem Idem
Idem
Resultaatscherm meldt validatiefouten. Detailinformatie kan in het rapport worden bekeken. Idem
Idem Idem
Idem
Pagina 22 van 31
Nr 2006
Melding Voorletters begint met een vreemd teken
Type F
2008
Landcode is niet gevuld
F
2009
Postcode voor landcode 'NL' is niet gevuld
F
2010
Postcode bevat geen geldige waarde voor landcode 'NL'
F
2011
Geboortedatum is niet gevuld
F
2012
Geboortedatum bevat geen geldige datum
F
2013
Geboortedatum ligt in de toekomst
F
2014
Geslacht is niet gevuld
F
2015
Geslacht bevat een onbekende code
F
2021
Aantal records in PATIENT.txt is ongelijk aan Aantal patiënt volgens de pakbon
F
2022 2023
BSN bevat geen geldige lengte BSN bevat een niet toegestaan teken
F F
2026
BSN voldoet niet aan de 11-proef
F
2028
Declarerende instelling is niet gevuld
F
2029
Instelling volgnr DIS is niet gevuld
F
2030
Koppelnummer is niet gevuld
F
Beschrijving De eerste positie van het veld ‘(za )voorletters’ moet gevuld zijn met een legitiem teken. De afhandeling van diakritische tekens wordt beschreven in Appendix ‘A’ van het document Specificaties PVM-DIS Het veld ‘(za) landcode’ moet gevuld zijn. Indien ‘(za) landcode’ gevuld is met ‘NL’, moet het veld ‘(za )postcode’ gevuld zijn. Indien ‘(za) landcode’ gevuld is met ‘NL’ moet het veld ‘(za) postcode’ gevuld zijn met een postcode die voldoet aan het formaat ‘NNNNAA’. Het veld ‘(za) geboortedatum’ moet gevuld zijn. Het veld ‘(za) geboortedatum’ moet gevuld zijn met een goede datum. Formaat: EEJJMMDD. Het veld ‘(za) geboortedatum’ moet kleiner of gelijk zijn aan de systeemdatum. Het veld ‘(za) geslacht’ moet gevuld zijn. Het veld ‘(za) geslacht’ moet gevuld zijn met 0, 1, 2 of 9. Het aantal patiënten in pakbon.txt komt niet overeen met het aantal patiënten in patient.txt. Lengte veld is 9 posities Een van de tekens is niet numeriek (0 t/m 9) of bevat minder dan 9 spaties. De aangeleverde cijfer combinatie wordt niet goedgekeurd door de 11proef. Declarerende instelling is een verplicht veld Instelling volgnr DIS is een verplicht veld Koppelnummer is een
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Gevolg Idem
Idem Idem
Idem
Idem
Idem
Idem
Idem Idem
Idem
Idem Idem
Idem
Idem
Idem Idem Pagina 23 van 31
Nr
Melding
2031
Het bestand bevat geanonimiseerde patiëntnamen
F
2032
Het bestand bevat geanonimiseerde voorletters
F
2033
Het bestand bevat geanonimiseerde BSN-waarden
F
2034
Naamcode_2 is niet gevuld terwijl Naam_2 wel is gevuld
F
2035
SKN bevat geen geldige lengte
F
2036
SKN is niet gevuld
F
2037
SKN bevat geen numerieke waarde
F
2038
Het bestand bevat geanonimiseerde SKN waarden
F
2039
BSN is niet gevuld
F
2041
Eerste inschrijving voldoet niet aan patroon YYYYMM of valt buiten bereik 1900 - heden Laatste uitschrijving voldoet niet aan patroon YYYYMM of valt buiten bereik 1900 - heden Opgegeven certificaat '{certificate.input.file.path}' niet gevonden Opgegeven certificaat '{certificate.input.file.path}' kan niet worden gelezen Opgegeven certificaat '{certificate.input.file.path}' kan niet worden gelezen of het opgegeven wachtwoord is niet correct Uw certificaat is verlopen op {certificate.validity.endDate} Uw certificaat is pas geldig vanaf {certificate.validity.startDate}
F
2042
2043
2044
2045
2046 2047
Type
Beschrijving verplicht veld Als in het aangeboden bestand een patiënt voorkomt met een naam die louter bestaat uit 1 of meer X-en, dan is sprake van een geanonimiseerd bestand. (N.B de naam XAB of XYZ is daarmee een toegestane naam). Anoniem aanleveren is voor deze GA niet toegestaan. Anoniem aanleveren is voor deze GA niet toegestaan. Anoniem aanleveren is voor deze GA niet toegestaan. Naamcode_2 moet gevuld zijn indien Naam_2 gevuld is Het veld SK nummer moet 15 posities lang zijn Het veld SK nummer moet gevuld zijn. Leeg 15xspatie is NIET toegestaan. Het veld SK nummer moet gevuld zijn met numerieke waarden Anoniem (15xX of 15x0) of (8x0+7x9) aanleveren is NIET toegestaan. Het veld BSN moet gevuld zijn. Leeg 9xspaties is NIET toegestaan. Eerste inschrijving moet binnen het bereik voor een geldige datum vallen Laatste inschrijving moet binnen het bereik voor een geldige datum vallen Certificaat niet benaderbaar
Gevolg
F
Certificaat niet leesbaar
Idem
F
Certificaat wachtwoord combinatie is niet correct
Idem
F
Certificaat verlopen
Idem
F
Certificaat nog niet geldig
Idem
F
F
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Idem
Idem
Idem
Idem
Idem Idem
Idem
Idem
Idem
Idem
Idem
Idem
Pagina 24 van 31
Nr 3001
Melding Het bestand bevat geanonimiseerde patiëntnamen.
Type W
3002
Het bestand bevat geanonimiseerde voorletters.
W
3003
Het bestand bevat geanonimiseerde BSN waarden.
W
3004
Uw certificaat is nog {certificate.validity.days.remaining} dagen geldig
W
3102*
Naamcode bevat geen geldige waarde
W
3103*
Naam begint met een spatie
W
3104*
Naam bevat vreemde tekens
W
3106*
Voorletters begint met een vreemd teken
W
3110*
Postcode bevat geen geldige waarde voor landcode 'NL'
W
Beschrijving Als in het aangeboden bestand een patiënt voorkomt met een naam die louter bestaat uit 1 of meer X-en, dan is sprake van een geanonimiseerd bestand. (N.B de naam XAB of XYZ is daarmee een toegestane naam) Als in het aangeboden bestand een patiënt voorkomt met een voorletter die louter bestaat uit 4 of meer Xen, dan is sprake van een geanonimiseerd bestand Als in het aangeboden bestand een patiënt voorkomt met een BSN nummer die bestaat uit 9 nullen of 9 spaties, dan is sprake van een geanonimiseerd bestand. Als het certificaat gaat verlopen, dan wordt de gebruiker gewaarschuwd binnen een instelbare termijn in dagen. Voor de velden ‘(za) naamcode_1’ en ‘(za) naamcode_2’ zijn alleen de waarden “spatie”, “1” of “2” toegestaan. De naam moet links uitgelijnd zijn. De naam moet gevuld zijn met een legitiem teken. De afhandeling van diakritische tekens wordt beschreven in Appendix ‘A’ van het document Specificaties PVM-DIS De eerste positie van het veld ‘(za) voorletters’ moet gevuld zijn met een legitiem teken. De afhandeling van diakritische tekens wordt beschreven in Appendix ‘A’ van het document Specificaties PVM-DIS Indien ‘(za) landcode’ gevuld is met ‘NL’ moet het veld ‘(za )postcode’ gevuld zijn met een postcode die voldoet aan het formaat ‘NNNNAA’.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Gevolg Resultaatscherm meldt waarschuwingen. Detailinformatie kan in het verslag worden bekeken.
Idem
Idem
Idem
Idem
Idem Idem
Idem
Idem
Pagina 25 van 31
Nr 3112*
Melding Geboortedatum bevat geen geldige datum
Type W
3113*
Geboortedatum ligt in de toekomst
W
3122* 3123*
BSN bevat geen geldige lengte BSN bevat een niet toegestaan teken
W W
3126*
BSN voldoet niet aan de '11-proef'
W
3131
Het bestand bevat geanonimiseerde patiëntnamen
W
Beschrijving Het veld ‘(za) geboortedatum’ moet gevuld zijn met een goede datum. Formaat: EEJJMMDD. Het veld ‘(za) geboortedatum’ moet kleiner of gelijk zijn aan de systeemdatum. Lengte veld is 9 posities Een van de tekens is niet numeriek (0 t/m 9) of bevat minder dan 9 spaties. De aangeleverde cijfer combinatie wordt niet goedgekeurd door de 11proef. Als in het aangeboden bestand een patiënt voorkomt met een naam die louter bestaat uit 1 of meer X-en, dan is sprake van een geanonimiseerd bestand. (N.B de naam XAB of XYZ is daarmee een toegestane naam)
Gevolg Idem
Idem
Idem Idem
Idem
Idem
*Codes uit de range 31xx zijn steeds de tegenhanger van 20xx. De 31xx range wordt alleen gebruikt in de SZ OHW 2.0 afhandeling.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 26 van 31
Bijlage 2. Veelgestelde vragen (FAQ-lijst) Tijdens de installatie en het gebruik van de PVM DIS kunt u tegen een aantal zaken aanlopen die in deze bijlage zijn beschreven. Daarbij zal steeds een vraag/probleem worden beschreven met een bijbehorend antwoord. Indien u met de oplossingen in deze bijlage het probleem niet kunt verhelpen, kunt u contact opnemen met de Nederlandse Zorgautoriteit: Telefoonnummer : 030-2850811 Emailadres : [email protected] Java versie 32-bits versus 64-bits Vraag Ik heb de meest recente Java versie gedownload, maar bij het opstarten geeft de PVM DIS de volgende foutmelding: “De install4j-Assistent kon op uw systeem geen Java(TM) Runtime Environment vinden. Zoek a.u.b. een geschikte 64-bit JRE. (Minimale versie: 1.6)” Antwoord Als u kiest voor een 64-bits installatie van de PVM DIS, is hierbij ook een 64-bits Java versie noodzakelijk. Zodra u via de internetsite van Java de meest recente versie downloadt, dan wordt over het algemeen echter automatisch de 32-bits versie gedownload. Om toch de 64-bits Java versie te downloaden, dient u naar de internetpagina met ‘handmatige downloads’ van Java te gaan. Hier kunt u kiezen voor de 64-bits Java versie. Quo Vadis Certificaten Vraag Het wachtwoord van mijn certificaat wordt geweigerd. Wat moet ik doen? Antwoord Het wachtwoord heeft u zelf gegenereerd tijdens stap 1 van de aanvraag procedure certificaat QuoVadis. U werd verzocht dit wachtwoord zorgvuldig op te slaan. Bij verlies dient u contact op te nemen met het Service- en Informatiecentrum DIS. Omdat wachtwoorden langer dan 12 tekens ongemerkt zijn afgebroken op lengte 12, loont het de moeite in geval van langere wachtwoorden een poging te doen met de eerste 12 tekens. PVM DIS Vraag Het lukt niet om een aanlevering aan DIS te doen. De applicatie meldt dat het verzenden is mislukt. Wat is er aan de hand? Antwoord Controleer in uw firewall of de PVM DIS mag communiceren met www.zorgttp.nl én www.disportal.nl of vraag de afdeling systeembeheer dit voor u te doen. De applicatie verzendt berichten met de extensie ‘.zorgttp’ naar https://www.zorgttp.nl en raadpleegt tijdens de verwerking de aanleverplanning van DIS via het adres https://www.disportal.nl/aanleverplanning/AanleverplanningServicePVM?WSDL.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 27 van 31
Vraag Ik gebruik een proxy-server voor internetcommunicatie. Heeft dit gevolgen voor de communicatie tussen de PVM DIS en de TTP? Antwoord Het is mogelijk om informatie over uw proxy-server aan de applicatie kenbaar te maken. Alle door de PVM DIS verzorgde communicatie gaat via poort 443 (dit is de standaard SSLpoort). De proxy kan daarmee ingesteld worden.
Start de PVM applicatie; Klik op Instellingen; Ga naar het tabblad ‘Proxy’; Vul hier de gegevens van een eventueel gebruikte proxyserver in; Wanneer proxy wordt gebruikt specificeer dan zowel host als port; Wanneer proxy authenticatie wordt gebruikt, specificeer dan ook user en password; Indien gebruik wordt gemaakt van een proxy server met een zogenaamd NTLM authenticatie schema (Windows NT), dan dient een vinkje gezet te worden bij ‘NTLM authenticatie’ en dient het domein waarbinnen de gebruiker actief is te worden opgevoerd; Proxy settings: Laat ALLE parameters LEEG wanneer er geen proxy wordt gebruikt.
Raadpleeg zo nodig uw systeembeheerder. Vraag Hoe verwijder ik de applicatie? Antwoord In de installatiemap (program files > Privacy & Verzend Module DIS) staat een map ‘Uninstaller’. In deze map is de uninstaller geplaatst. Door te dubbelklikken op de applicatie wordt de Uninstaller gestart. Plaats een vinkje bij 'Forceer verwijderen' en verwijder de applicatie. Let op! Nadat de uninstaller gereed is, moet u zelf de map van de Privacy & Verzend Module DIS verwijderen. In deze map staan eventueel nog uw persoonlijke digitale certificaten.
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 28 van 31
Bijlage 3. User.properties bestand De gebruiker-specifieke eigenschappen die via de GUI kunnen worden ingesteld staan in het bestand user.properties. Dit bestand bevindt zich bij een standaard installatie in de map: C:\Users\user\ZorgTTP\DIS\appdata\ Het is ook mogelijk om de eigenschappen direct in het bestand aan te passen. Dit is met name relevant voor geautomatiseerde aansturing van de module. De volgende eigenschappen kunnen worden ingesteld / gewijzigd: Verplichte eigenschappen: pvg.p12file= pvg.p12password=
dis.aanleverplanning.username= Optionele eigenschappen: http.proxyHost= http.proxyPort= http.proxyUser= http.proxyPassword= proxy.authenticationschema.ntlm=
proxy.domain.ntlm=
Hier wordt het pad van het certificaat opgegeven. Hier wordt het wachtwoord van het certificaat opgegeven. Het wachtwoord wordt geëncrypt opgeslagen in user.properties wanneer deze via de installer of via het tabblad instellingen is opgegeven. Wanneer het wachtwoord direct in het user.properties bestand wordt ingevoerd zal de waarde niet worden versleuteld. Voorbeeld versleutelde waarde: pvg.p12password=encrypted\:ETOhsdfhQamTXQKhyasdfa WY3g4564fh5WNvYjcGasdflBfAcY\= Hier wordt de DIS gebruikersnaam opgegeven.
Het host adres van de proxyserver. Het poortnummer van de proxyserver. VERPLICHT wanneer http.proxyHost ingesteld is. Geeft aan de usernaam wanneer user authenticatie wordt gebruikt. Geeft aan het password wanneer user authenticatie wordt gebruikt. VERPLICHT wanneer http.proxyUser ingesteld is. Indien gebruik wordt gemaakt van een proxy server met een zogenaamd NTLM authenticatie schema (Windows NT), dan dient deze waarde op true gezet te worden Geef hier het domein op waarbinnen de gebruiker actief is
Voorbeeld user.properties #Saved from settings dialog #Tue Jun 03 15:25:53 CEST 2014 pvg.p12file=C\:\\Users\\USER\\ZorgTTP\\DIS\\appdata\\zorgttp_20140530.p12 proxy.authenticationschema.ntlm=false http.proxyHost= dis.aanleverplanning.username=ZORGTTP pvg.p12password=encrypted\:G4drDXLCK8hJKKaZZgdHCnfjjzB882bacxrUKPydg\= http.proxyPassword= http.proxyPort= http.proxyUser= proxy.domain.ntlm=
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 29 van 31
Bijlage 4 Aanpassen rapportage instellingen Na iedere verwerking van DIS aanleveringen door de PVM DIS wordt een rapportage gegenereerd. Deze rapportage wordt default als HTML bestand in de map geplaatst waar het oorspronkelijke te verwerken bestand zich bevindt. Het is mogelijk om naast de HTML een XML rapportage te genereren. In de ../pvm folder bevindt zich het bestand report-template-zis-DISABLED.xml. Indien dit wordt hernoemd naar report-template-zis.xml zal op dezelfde locatie als het HTML bestand een XML verslag worden aangemaakt. De locatie waar het verslag wordt aangemaakt kan desgewenst worden aangepast naar een andere locatie. Dit kan via het bestand translate.properties dat zich in de ../pvm folder bevindt. De volgende property dient aangepast te worden: report.file.path.xml={input.file.path}{input.file.name}_DIS_PVM.XML Indien gekozen wordt voor een XML rapportage dan wordt deze opgebouwd conform onderstaand format. <Error> <Message>
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 30 van 31
Voorbeeld XML rapportage ?xml version="1.0" encoding="cp1252"?> <Application version="4.0.0">PVM DIS <patientCount>2 <Error type="warning" code="3001" line="1" reference="P000004" field="Naam1"> <Message>Het bestand bevat geanonimiseerde patientnamen. xxxx <Error type="warning" code="3001" line="2" reference="P000004" field="Naam1"> <Message>Het bestand bevat geanonimiseerde patientnamen. xxxxxxx <Error type="warning" code="3001" line="2" reference="P000004" field="Naam2"> <Message>Het bestand bevat geanonimiseerde patientnamen. xxxx <Error type="warning" code="3002" line="1" reference="P000004" field="Voorletters"> <Message>Het bestand bevat geanonimiseerde voorletters. xxxx <Error type="warning" code="3002" line="2" reference="P000004" field="Voorletters"> <Message>Het bestand bevat geanonimiseerde voorletters. xxxx <Error type="warning" code="3003" line="1" reference="P000004" field="BSN"> <Message>Het bestand bevat geanonimiseerde BSN waarden. 000000000 <Error type="warning" code="3003" line="2" reference="P000004" field="BSN"> <Message>Het bestand bevat geanonimiseerde BSN waarden. 000000000
Gebruikershandleiding Privacy- en Verzend Module DIS versie 5.3 voor Windows, Mac OS en Linux © ZorgTTP – versie 1.0 – 17-12-2015
Pagina 31 van 31