Installatie- en gebruikshandleiding Privacy- en Verzendmodule Verantwoording
PVM – VWD versie 1.0.14 (20080303) ZorgTTP 26 maart 2008
Gepseudonimiseerd aanleveren in drie stappen!
Download uw certificaat
STAP 1
Download en installeer de Privacy Module ZorgTTP
STAP 2
Start de applicatie voor het eerste gebruik!
STAP 3
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 2 van 18
Gepseudonimiseerd aanleveren in drie stappen! V 1.0
Download uw certificaat
STAP 1
Certificaat Voordat u de software die u heeft opgehaald kunt gebruiken dient u te beschikken over een digitaal certificaat. Indien u reeds in het bezit bent van een ZorgTTP certificaat kunt u deze stap overslaan. Een certificaat kan worden aangevraagd via
[email protected] onder vermelding van ‘certificaataanvraag Verantwoording’. Zodra dit is aangemaakt zult U een email ontvangen van Diginotar (de producent van de certificaten). In het bericht wordt aangegeven dat uw certificaat is geproduceerd en dat het kan worden opgehaald via de link: http://webrao.diginator.nl/DownloadZorgTTP. In het bericht staat ook de ophaalcode die noodzakelijk is voor het ‘ophalen’ van het certificaat. Daarnaast stuurt DigiNotar de bij het certificaat horende pincode via de post naar het kantooradres van de aanvrager. Pas nadat deze post ontvangen is kan het certificaat worden geïnstalleerd. Hieronder volgt instructie voor het downloaden van het certificaat. Ga naar http://webrao.diginotar.nl/DownloadZorgTTP. Het volgende scherm verschijnt:
Figuur 1 Type het serienummer en de ophaalcode in; het serienummer staat in de toegestuurde brief, de ophaalcode staat in de toegestuurde email. Klik op ‘Verstuur’.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 3 van 18
Hierop verschijnt de vraag of het betreffende bestand geopend of bewaard moet worden (zie figuur 2).
Figuur 2 Kies voor de optie ‘Opslaan op schijf’ en klik op ‘OK’. De browser Mozilla Firefox zal het bestand direct op uw bureaublad opslaan. Internet Explorer zal vragen waar het bestand geplaatst moet worden, sla het bestand op uw bureaublad of in een daartoe aangemaakte map op.
Figuur 3 Applicatie De applicatie en bijbehorende documentatie kunt u downloaden van de website van ZorgTTP: www.zorgttp.nl. U klikt daarvoor in het menu op ‘Opdrachten’ en vervolgens op ‘Verantwoording’.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 4 van 18
Kopiëren certificaat U kunt het certificaat maar één maal downloaden. Als bijvoorbeeld de computer wordt vervangen dan zal het certificaat op een andere computer moeten worden geïnstalleerd. Daarom wordt u geadviseerd een kopie van het certificaat te maken. Dat doet u door het bestand van uw bureaublad te kopiëren naar de gewenste locatie. Met het gekopieerde bestand kan op een later moment op een andere computer het certificaat wederom geïnstalleerd worden. Voor het transport kunt u gebruik maken van een verwisselbaar medium zoals usb-stick. Vervolgens kunt u het certificaat opnieuw installeren.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 5 van 18
Gepseudonimiseerd aanleveren in drie stappen! V 1.0
Download en installeer de Privacy Module ZorgTTP
STAP 2
Applicatie De applicatie en bijbehorende documentatie kunt u downloaden van de website van ZorgTTP: www.zorgttp.nl. U klikt daarvoor in het menu op ‘Opdrachten’ en vervolgens op ‘Verantwoording’.
Systeemeisen
Voor een correcte werking dient het systeem waarop de applicatie uitgevoerd wordt minimaal aan de volgende eisen te voldoen: 1. Vrije schijfruimte Minimaal 2x de grootte van het te verwerken bestand 2. Java Versie 1.4 of hoger (zie http://java.sun.com ) 3. Besturingssysteem Alle platformen waarvoor Java ondersteuning is worden ondersteund door de applicatie. Sommige platformen stellen beperkingen op de maximale grootte van bestanden (zie limieten bestandssystemen). Bij gebruik van Windows Vista mag de applicatie niet in de Program Files directory geïnstalleerd worden. De applicatie slaat configuratie instellingen op in de installatiemap, wat onder Vista niet toegestaan is. 4. Werkgeheugen 512 Megabyte 5. Processor Over het algemeen geldt dat een pc van maximaal 4 jaar over voldoende processorkracht bezit. Natuurlijk geldt dat hoe sneller de processor, hoe sneller het verwerkingsproces.
Installatie Privacy Module ZorgTTP U start de installatie van de Privacy Module ZorgTTP door tweemaal op het icoontje te klikken. Het startscherm (figuur 1) van de installatiewizard wordt getoond.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 6 van 18
Klik op ‘Verder’. Figuur 1
Figuur 2 In bovenstaand scherm (figuur 2) wordt de installatiemap bepaald. Standaard zal de map ‘Privacy Module ZorgTTP – Verantwoording 2006’ worden aangemaakt. Met behulp van de knop ‘Bladeren’ kunt u een andere map selecteren. Nadat u de installatiemap heeft bepaald klikt u op ‘Verder’. Onderstaand scherm (Figuur 3) verschijnt. © ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 7 van 18
Figuur 3 Bovenstaande pop-up geeft aan in welke map de Privacy Module ZorgTTP zal worden geïnstalleerd. Dat is in dit geval de standaardmap (‘pseudonimiserings en Verzend Module’). Klik nu op ‘Ok’.
Figuur 4 In bovenstaand scherm kunt u aangeven of u snelkoppelingen wil aanmaken. U kunt ervoor kiezen om de snelkoppelingen aan te maken in het Windows Startmenu maar ook kunt u snelkoppelingen op de desktop creëren. Nadat u uw voorkeur heeft aangeven klikt u op ‘Verder’.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 8 van 18
Figuur 5 In bovenstaand scherm wordt de voortgang van de installatie getoond. Door op ‘Verder’ te klikken wordt de installatie afgerond. Onderstaand scherm (figuur 6) wordt getoond.
Figuur 6 De installatie is geslaagd, klik op ‘Gereed’ om het scherm te sluiten.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 9 van 18
Verwijderen Privacy Module ZorgTTP Bij installatie wordt gevraagd in welke map de applicatie geïnstalleerd dient te worden. In deze map is een folder met de naam ‘Uninstall’ aangemaakt. In deze folder staat de zogenaamde ‘Uninstaller’. Door op dit bestand te dubbelklikken wordt de procedure om de applicatie te verwijderen gestart. Onderstaand scherm (figuur 7) wordt getoond.
Figuur 7 Om de applicatie daadwerkelijk te verwijderen wordt een vinkje geplaatst voor ‘Forceer het verwijderen’. Vervolgens klikt u op ‘Deïnstalleer’. Nadat de applicatie volledig verwijderd is, wordt onderstaand scherm (figuur 8) getoond.
Figuur 8 U sluit het scherm door op ‘Afsluiten’ te klikken. De folder waarin u de applicatie heeft geïnstalleerd moet handmatig worden verwijderend.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 10 van 18
Gepseudonimiseerd aanleveren in drie stappen! V 1.0
Start de applicatie voor het eerste gebruik!
STAP 3
Inleiding De Privacy Module ZorgTTP is een instrument dat gebruikt wordt in het proces om gegevens beveiligd door te leveren in het kader van Verantwoording 2006/ 2007. Omdat in dit project geen tot personen herleidbare gegevens mogen worden opgenomen, worden met behulp van de Privacy Module ZorgTTP zogenaamde pseudoniemen geproduceerd. Een pseudoniem is een code die een unieke persoon representeert, maar die niet te herleiden is tot natuurlijke personen. 1. Starten van de applicatie De in deze handleiding beschreven software dient geïnstalleerd te zijn alvorens deze gebruikt kan worden. De instructie voor installatie van de applicatie staat in de stap 4. Tevens dient er een certificaat geïnstalleerd te zijn, hiervoor wordt verwezen naar stappen 1 en 2. Na het opstarten van de applicatie krijgt u volgende scherm (figuur 1) te zien:
Figuur 1.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 11 van 18
U dient allereerst de locatie van het certificaat op te geven. Hiervoor kunt u gebruik maken van de knop ‘Zoeken’. Vervolgens voert u tweemaal het ‘wachtwoord’ behorende bij het certificaat in. Er wordt gecontroleerd of het een juist certificaat betreft en of het wachtwoord behoort bij het certificaat. Het resultaat van deze beoordeling wordt boven in het scherm getoond. Nadat u het certificaat en de wachtwoorden heeft ingevoerd klikt u op ‘Volgende’.
Figuur 2 Met behulp van de knop ‘Zoeken’ selecteert u het bestand dat voor zending naar ZorgTTP in het kader van ‘Verantwoording 2006/ 2007’ is bestemd. Onderstaand zoekscherm wordt geopend.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 12 van 18
Figuur 3 Met behulp van het zoekscherm kunt u de aanlevering voor Verantwoording 2006/ 2007 opzoeken en selecteren. Als input voor de Privacy Module ZorgTTP wordt gebruik gemaakt van een ‘CSV-bestand’. Nadat u het bestand heeft geselecteerd klikt u op ‘Voltooien’. De verwerking wordt gestart, nadat de bewerking is voltooid zal het bestand automatisch worden verzonden.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 13 van 18
2. Resultaten Er wordt een tweetal bewerkingen uitgevoerd op het aangeboden bestand: 1. Het bestand wordt gevalideerd. Er worden een aantal controles uitgevoerd op het bestand, er wordt bijvoorbeeld gecontroleerd of de verplichte velden zijn ingevuld. 2. Het bestand wordt verzonden aan ZorgTTP indien stap 1 met goed gevolg is doorlopen.
Figuur 5 De kwaliteitsrapportage kan worden gevonden door naar de in het scherm aangegeven locatie te gaan. Door op ‘Sluiten’ te klikken wordt de applicatie afgesloten.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 14 van 18
Het verslag bevat de volgende elementen: PVM Versie
1.0.14 (03/03/2008)
Start van programma Mon Mar 17 13:37:32 CET 2008 Locatie bestand
\\PDC-IVZ\ivz\Databeheer\Verantwoording\testbestanden\systematisch\Goed bestand
Naam bestand
002599001200512_gvw.csv
Datum bestand
Wed Mar 05 12:12:28 CET 2008
Datum omzetting
Mon Mar 17 13:40:02 CET 2008
IDZ Code
483d459b5c6d
Inhoud geleiderecord Instellingsnummer
002599
Systeemidentificatie
GVW
Registratiepunt
001
Registratiejaar
2005
Periode maand
12
Aantal records client
1
Aantal records inschrijving
1
Aantal records zorgverlening 2 Naam zorgaanbieder
GGZ Testerij
Software pakket
USETesteR
Versienummer
Tons testfabriek 5003
Geconstateerde fatale fouten Geen fatale fouten. Programma gaat verzending verzorgen.
Samenvatting Recordsoort
Client
Aangeboden 1 Afgekeurd
Inschrijving Prestatie 1
0 0%
0
Goedgekeurd 1 100 % 1
Totaal
2
4
0%
0 0%
0 0%
100 %
2 100 % 4 100 %
Afgekeurde prestaties per CTG-Code CTG-Code Aantal records Totaal aantal eenheden
Aantal prestatiesrecords in Jan Feb Mr Apr Mei Jun Jul Aug Sep Okt Nov Dec 0
0
0
0
2
0
0
0
0
0
0
0
Overzicht geboortedagen 1 0
2 0
3 0
4 0
5 0
6 0
7 0
8 0
9 0
10 11 12 13 14 15 16 0
0
1
0
0
0
0
17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
Overzicht 1e 2 letters van de achternaam ZO 1
Overzicht van het geslacht Man Vrouw
1 100 % 0 0%
Onbekend 0 0 %
Aantal fouten per foutcode Code Veldnaam Foutomschrijving Aantal
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 15 van 18
Onderaan de kwaliteitsrapportage staat een detail foutenlijst (figuur 7).
Figuur 7 Toelichting Detail foutenlijst Kolom 1 Code De betreffende foutcode Kolom 2 Identificatie Gegevens om de betreffende fout op te zoeken Kolom 3 Veldnaam Naam van het veld Kolom 4 Inhoud De daadwerkelijke inhoud van het veld Kolom 5 Foutomschrijving De omschrijving van de fout Kolom 6 Regel Het regelnummer van de regel met de gevonden fout
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 16 van 18
Bijlage 1.
Veelgestelde vragen (FAQ-lijst)
Tijdens de installatie en het gebruik van de PVM-VWD 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. Certificaten Vraag Ik heb een mail ontvangen dat ik mijn certificaat kan ophalen. De brief die per post zou moeten komen is echter nog niet in mijn bezit. Wat moet ik doen? Antwoord Uw brief zou binnen 5 werkdagen na ontvangst van de mail in uw bezit moeten zijn. Neem contact op met de ZorgTTP servicedesk (
[email protected]) indien u de brief niet binnen 5 werkdagen heeft ontvangen. Vraag In de documentatie staat dat het certificaat binnen 6 weken moet worden gedownload Antwoord Deze beperking is inmiddels opgeheven, het certificaat kan ook na 6 weken (opnieuw) worden gedownload. Vraag Het wachtwoord wordt geweigerd. Is het in de brief aangegeven certificaat wachtwoord wel juist? Antwoord Controleer of het serienummer van het certificaat dat u heeft gedownload (begint met [AD06000100…….] overeenkomt met het serienummer dat in de brief (zie bijlage 3 voor een voorbeeld) wordt vermeldt. Indien het de serienummers overeenkomen kunt u er van uit gaan dat het wachtwoord correct is. Let op! Indien het wachtwoord de tekens; l (kleine letter L), l (cijfer één) of I (hoofdletter i), maar ook de '0' (nul) en 'O' (Hoofdletter 'o') bevat, zijn deze zeer moeilijk van elkaar te onderscheiden. U kunt in dit geval proberen om het door u ingevoerde teken te vervangen door een van de alternatieven. In de meeste gevallen kan hierdoor het probleem worden opgelost1.
1
Naar aanleiding van dit probleem zijn door Diginotar inmiddels maatregelen genomen om deze problemen op te lossen.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 17 van 18
PVM-Verantwoording Vraag Het lukt niet om een aanlevering te doen. De applicatie meldt het verzenden is mislukt. Wat is er aan de hand? Antwoord Controleer in uw firewall of de PVM-VWD mag communiceren met www.zorgttp.nl of vraag de afdeling systeembeheer dit voor u te doen. De applicatie verzendt berichten met de extensie ‘.zorgttp’ naar https://www.zorgttp.nl. Vraag Ik gebruik een proxy-server voor internetcommunicatie. Heeft dit gevolgen voor de communicatie tussen de PVM-VWD en de TTP server? Antwoord Het is mogelijk om informatie over uw proxy-server aan de applicatie kenbaar te maken. Alle door de PVM-VWD verzorgde communicatie gaat via poort 443 (dit is de standaard SSL-poort). De applicatie maakt gebruik van de commons-httpclient. De proxy kan daarmee ingesteld worden door de opdrachtregel van de snelkoppeling aan te passen. De volledige opdrachtregel (rechtermuisknop op opstarticoon en dan ‘eigenschappen kiezen’ wordt dan: C:\Windows\system32\javaw.exe -Dhttp.proxyHost=interneproxyserver Dhttp.proxyPort=interneProxyPoort -jar -Dlog4j.configuration=file:configuration/log4j.xml -Dlog4j.debug org.eclipse.osgi_3.3.0.v20070208.jar Bij 'interneproxyserver' moet de interne proxyserver worden ingevoerd en bij 'interneProxyPoort' de interne proxypoort (bijvoorbeeld 8080). Het IP-adres waar verbinding mee gemaakt wordt is= 82.94.216.188. Vraag Hoe verwijder ik de applicatie? Antwoord In de installatiemap (program files > Privacy & Verzend Module Verantwoording) 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! U dient nadat de uninstaller gereed is zelf de map Privacy & Verzend Module Verantwoording nog te verwijderen.
© ZorgTTP Tel +31(0)30 6360649 E-mail
[email protected] Randhoeve 231 3995 GA Houten
Pagina 18 van 18