INSTALLATIE EN WERKING DECENTRALE APPLICATIE LANDELIJKE GEGEVENSVERZAMELING FEDERATIE OPVANG

Transcriptie

1 INSTALLATIE EN WERKING DECENTRALE APPLICATIE LANDELIJKE GEGEVENSVERZAMELING FEDERATIE OPVANG Federatie Opvang Amersfoort, 6 november 2012

2 Landelijke Gegevensverzameling FO FO-12-RAP Auteur G. van Dam Aan Leden Federatie Opvang en leveranciers cliëntregistratieystemen voor de Maatschappelijke- en Vrouw enopvang. INSTALLATIE EN WERKING DECENTRALE APPLICATIE LANDELIJKE GEGEVENSVERZAMELING FEDERATIE OPVANG

3 Landelijke Gegevensverzameling FO FO-12-RAP Versiebeheer Versies Datum Versie Door Omschrijving F. van Zuilen Definitief G. van Dam Concept Verspreiding Versie: 2.0 B. Koppenaal (Federatie Opvang) X Leveranciers Leden T. Schuurmans (Federatie Opvang) X Wijzigingen 2.0 t.o.v. 1.0 Wijzigingen Deze versie is geschreven voor DCA versie 2.7 en hoger die het mogelijk maakt de gegevensset versie 1104 te verw erken. 1

4 Landelijke Gegevensverzameling FO FO-12-RAP Inhoudsopgave 1. INLEIDING DOELSTELLING DECENTRALE APPLICATIE (DCA) INSTALLATIE DCA TECHNISCHE SPECIFICATIES INSTALLATIEPROCEDURE Installatie : Stap Installatie : Stap Installatie : Stap Installatie : Stap Installatie : Stap Installatie : Stap RELEVANTE DIRECTORIES ACTIES ACHTERAF FUNCTIONALITEIT DCA HOOFDSCHERM OPTIES-SCHERM STAPSGEWIJZE VERWERKING Openen bestand Checken bestand Bew erken bestand Bew aren bestand Resultaten van de processtappen WIZARD VERWERKING

5 Landelijke Gegevensverzameling FO FO-12-RAP 1. Inleiding Dit document beschrijft de installatie en de globale w erking van de decentrale applicatie (DCA). De DCA is benodigd bij de gegevensuitw isseling tussen de lidinstellingen en de Federatie Opvang. In de volgende hoofdstukken komt achtereenvolgens aan de orde: doelstelling decentrale applicatie (DCA); installatie DCA; functionaliteit DCA. 2. Doelstelling decentrale applicatie (DCA) De decentrale applicatie (DCA) is benodigd bij de gegevensuitw isseling van de gegevens tussen de lidinstellingen en de Federatie Opvang, omdat de aan te leveren gegevens eerst, uit privacyoverw egingen, moeten w orden versleuteld en aangepast voordat zij opgestuurd kunnen w orden naar de Federatie Opvang. Hierbij moet gedacht w orden aan de volgende zaken: Introductie van een Landelijk Uniek (LUN) voor een cliënt op basis van een aantal persoonskenmerken, zodat de cliënt, ongeacht de instelling, uniek identificeerbaar is in de Landelijke Gegevens Verzameling van de Federatie Opvang (LGVFO). Verw ijderen van een aantal privacy-gevoelige persoonskenmerken van een cliënt; Versleutelen van datumvelden, zodat de feitelijke geboortedatum van de cliënt en de overige datums -zoals aanmelddatum, begindatum dienstenaanbod etc.- niet meer te achterhalen zijn. Encrypten van de op te sturen bestanden, na verw erking, zodat de inhoud niet door derde partijen op een eenvoudige w ijze kan w orden achterhaald. Een secundaire doelstelling van de DCA is het voortijdig signaleren van eventuele fouten in de aangeleverde bestanden van de lidinstellingen, zodat de lidinstellingen vroegtijdig in staat w orden gesteld de eventuele fouten te corrigeren. Hierdoor w ordt tevens voorkomen dat de Federatie Opvang onnodig w ordt belast met foutieve aangeleverde bestanden. 3

6 Landelijke Gegevensverzameling FO FO-12-RAP 3. Installatie DCA 3.1 Technische specificaties De computer w aarop de DCA w ordt geïnstalleerd moet minimaal aan de volgende hardw are- en softw are-eisen voldoen: Hardw are: o Processor : Intel Pentium 4 o Intern geheugen : 256 Mb o Voldoende schrijfruimte om de te verw erken bestanden te kunnen bew aren. Dit is per instelling afhankelijk. Softw are: o Besturingssysteem: Window s 2000 of XP o.net Framew ork : versie 2.0 of hoger 3.2 Installatieprocedure Installatie: Stap 1 Start Setup.exe Installatie: Stap 2 Het volgende scherm verschijnt: Klik op Next om verder te gaan, of Klik op Cancel om de installatie te beëindigen Installatie: Stap 3 Het volgende scherm verschijnt: 4

7 Landelijke Gegevensverzameling FO FO-12-RAP Bepaal de directory w aarin de DCA moet w orden geïnstalleerd, in dit geval c:\dca Klik op Next om verder te gaan, of Klik op Back om terug te gaan naar de vorige stap, of Klik op Cancel om de installatie te beëindigen. 5

8 Landelijke Gegevensverzameling FO FO-12-RAP Installatie: Stap 4 Het volgende scherm verschijnt: Klik op Next om de installatie te voltooien, of Klik op Back om terug te gaan naar de vorige stap, of Klik op Cancel om de installatie te beëindigen. 6

9 Landelijke Gegevensverzameling FO FO-12-RAP Installatie: Stap 5 Het volgende scherm verschijnt: de DCA w ordt geïnstalleerd. Klik op Cancel om de installatie af te breken. 7

10 Landelijke Gegevensverzameling FO FO-12-RAP Installatie: Stap 6 Nadat de DCA geïnstalleerd verschijnt het volgende scherm: Klik op Close om het installatieprogramma af te sluiten. 3.3 Relevante directories Standaard kent de DCA de volgende soort directories: bin : bevat de programmatuur van de DCA; etc : bevat o de regels w aaraan de bestanden moeten voldoen (lgvfo.xsd, lgvfo_types.xsd, beheerrules.xml, zorgrules.xml, etc.) o de referentieset (refset.xml) die gebruikt w ordt teneinde onder andere te kunnen controleren of de in de bestanden aanw ezige coderingen geldig zijn. in : de standaard directory die de bestanden bevat die door de DCA moeten w orden verw erkt. log : bevat de logbestanden die w orden aangemaakt tijdens het verw erkingsproces van de DCA. out : bevat de goed verw erkte en ge-encrypte bestanden die aan de Federatie Opvang moeten w orden opgestuurd. De locatie van de directories in, log en out zijn met behulp van de DCA configureerbaar. 8

11 Landelijke Gegevensverzameling FO FO-12-RAP 3.4 Acties achteraf Nadat de DCA is geïnstalleerd moet de referentieset (refset.xml) in de etc -directory w orden geplaatst. Maak een zogenaamde Shortcut aan om de DCA te kunnen opstarten met de volgende eigenschappen: 9

12 Landelijke Gegevensverzameling FO FO-12-RAP 4. Functionaliteit DCA 4.1 Hoofdscherm Nadat de DCA is opgestart verschijnt het volgende scherm: Alvorens de verw erking van de bestanden te behandelen (paragrafen Stapsgew ijze Verw erking en Wizard Verw erking ) w ordt eerst het optiescherm besproken. 10

13 Landelijke Gegevensverzameling FO FO-12-RAP 4.2 Opties-scherm Het Opties-scherm kan w orden benaderd met behulp van de volgende menuopties: Extra\Opties: De volgende zaken zijn configureerbaar: Locatie invoerbestanden: Dit is de locatie ( in -directory) w aar de te verw erken bestanden zijn opgeslagen. Locatie uitvoerbestanden: Dit is de locatie ( out -directory) w aar de goed verw erkte en ge-encrypte bestanden w orden opgeslagen nadat een aangeboden bestand is verw erkt. Tevens w ordt de verw erkingsrapportage hierin opgeslagen. Locatie logbestanden: Dit is de locatie ( log -directory) w aar de logbestanden w orden opgeslagen die tijdens de verw erking w orden aangemaakt. Scherm Log niveau: bepaalt het niveau van (fouten-)rapportage van het verw erkingsproces zoals dat tijdens de verw erking op het scherm w ordt getoond (Tabblad Scherm Log van het hoofdscherm). Hierbij bestaat de keuze uit de volgende opties: o Fout: Alleen de processtappen en de eventuele fouten w orden getoond. o Normaal: Zie vorige punt, plus alle controlestappen tijdens het verw erkingsproces, ook indien een controlestap goed verloopt. o Debug en Alles: zijn opties die moeten w orden toegepast indien een verw erkingsprobleem door Co-maker tot in detail moet w orden geanalyseerd. Bestand Log Niveau: bepaalt het niveau van (fouten-)rapportage van het verw erkingsproces dat in het bijbehorende logbestand zal w orden w eggeschreven. Rapport opties: o Breedte: Bepaalt de lengte van de regel(s) van de verw erkingsrapportage zoals dat op het scherm zal w orden getoond na verw erking (Tabblad Rapport ) en zal w orden aangemaakt in de out -directory. o Rapporteer status Goed: Bepaalt of ook de goed gecontroleerde gegevens moeten w orden getoond/afgedrukt in de verw erkingsrapportage. 11

14 Landelijke Gegevensverzameling FO FO-12-RAP o Rapporteer status Wijzigen: Bepaalt of ook de gegevens die een foutieve codering hebben maar zijn vervangen door een algemene codering moeten w orden getoond/afgedrukt in de verw erkingsrapportage. o Rapporteer status Fout: Bepaalt of ook de foutief verw erkte gegevens moeten w orden getoond/afgedrukt in de verw erkingsrapportage. Maximum aantal fouten: Bepaalt het aantal fouten dat maximaal mag optreden tijdens de verw erking van een bestand alvorens de verw erking af te breken. 4.3 Stapsgewijze verwerking Een bestand w ordt in 4 stappen gecontroleerd, versleuteld en geencrypt: Openen bestand; Checken bestand: het bestand w ordt op basis van een aantal controlestappen op inhoud gecontroleerd; Bew erken bestand: het gecontroleerde bestand w ordt zodanig bew erkt zodat de privacy van de cliëntgegevens is gew aarborgd: o.a. generatie Landelijke Uniek (LUN), verw ijderen van een aantal cliëntkenmerken die gebruikt zijn bij de generatie van de LUN, versleutelen van de datumvelden naar de 1 e dag van de maand, introductie van duren, etc. Bew aren bestand: het bew erkte bestand w ordt ge-encrypt en vervolgens gecomprimeerd, zodat de inhoud niet (eenvoudig) door een derde partij kan w orden achterhaald. 12

15 Landelijke Gegevensverzameling FO FO-12-RAP Openen bestand Het te verw erken bestand kan w orden geopend met behulp van de menuopties: Bestand\Openen. Na selectie van het bestand verschijnt het volgende scherm: Het geselecteerde bestand w ordt getoond: Veld Bestand en in het Scherm Log Door op Check te klikken w ordt het check proces gestart. 13

16 Landelijke Gegevensverzameling FO FO-12-RAP Checken bestand De volgende gegevens van het geselecteerde bestand w orden getoond: Bestand: De naam van het geselecteerde bestand; Bestandstype: Het bestandstype, zorgdocument of beheerdocument Instelling: De code van de instelling w aarvoor gegevens w orden aangeleverd; Registratiepunt: De code van het registratiepunt die de gegevens aanlevert; Registratiejaar: Het registratiejaar w aarop de gegevens betrekking hebben; Registratieperiode: De periode (veelal maand) w aarvoor de gegevens in cumulatieve zin w orden aangeboden; Verzenddatum en Verzendtijd: De datum en tijd w aarop de gegevens zijn aangemaakt door het cliëntregistratiesysteem. Acties: Tijdens het check proces w ordt in het tabblad Scherm Log, overeenkomstig de gekozen opties in het Opties-scherm, de voortgang van het proces getoond. Door op Bew erk te klikken w ordt het bew erk proces gestart. 14

17 Landelijke Gegevensverzameling FO FO-12-RAP Bew erken bestand Tijdens het bew erk proces w ordt in het tabblad Scherm Log, overeenkomstig de gekozen opties in het Opties-scherm, de voortgang van het proces getoond. Door op Bew aar te klikken w ordt het bew aar proces gestart Bew aren bestand Tijdens het bew aar proces w ordt in het tabblad Scherm Log, overeenkomstig de gekozen opties in het Opties-scherm, de voortgang van het proces getoond. Hierna kan een ander bestand w orden verw erkt. 15

18 Landelijke Gegevensverzameling FO FO-12-RAP 16

19 Landelijke Gegevensverzameling FO FO-12-RAP Resultaten van de processtappen Tijdens, en als gevolg van, de verschillende stappen kunnen de volgende soorten bestanden w orden aangemaakt: Logbestand: Bevat de resultaten van de verschillende (sub-)stappen overeenkomstig de gekozen opties in het Opties-scherm (Bestand Log Niveau). Dit bestand is te vinden in de log -directory, en w ordt tevens getoond in het tabblad Bestand Log. Dit bestand kent de volgende naamsconventie: 1. < Registratiepunt> _< Jaar> < Periode> _log_< Bestandstype>.txt 2. Bijvoorbeeld: _200499_log_zorgDocument.txt Rapportagebestand: Bevat de (fouten-)rapportage van het totale verw erkingsproces overeenkomstig de gekozen opties in het Opties-scherm (Rapport Opties). Dit bestand is te vinden in de out -directory, en w ordt tevens getoond in het tabblad Rapport. Dit bestand kent de volgende naamsconventie: 1. < Registratiepunt> _< Jaar> < Periode> _rap_< Bestandstype>.txt 2. Bijvoorbeeld: _200499_rap_zorgDocument.txt Outputbestanden: Wordt pas aangemaakt indien geen fatale fouten zijn geconstateerd. Per aanlevering w orden drie bestanden gemaakt: 1. Het aangepaste inputbestand in XML vorm. 2. De ge-encrypte XML 3. Een rapport in leesbare tekst. Het ge-encrypte bestand moet w orden opgestuurd naar de Federatie Opvang en is te vinden in de out -directory. Dit bestand kent de volgende naamsconventie: 4. < Registratiepunt> _< Jaar> < Periode> _out_< Bestandstype>.xml.gz.enc 5. Bijvoorbeeld: _200499_out_zorgDocument.xml.gz.enc In het rapportagebestand w orden de volgende feiten vermeld: Het feit of al dan niet een outputbestand is aangemaakt; Met w elke versie van de DCA het bestand is gecontroleerd; De gegevens zoals die ook in het hoofdscherm w orden getoond: Bestand, Bestandstype, Instelling, Registratiepunt, Registratiejaar, Registratieperiode, Verzenddatum en Verzendtijd. De samenvattinggegevens zoals gedefinieerd in het bestand (*.xml). Aantal fatale fouten, w aardoor al dan niet een outputbestand kan w orden aangemaakt. Aantal w ijzigingen, zijnde het aantal keer dat een foutieve codering is aangeboden, maar is gew ijzigd in een bepaalde code zodat de verw erking w el kon doorgaan. Per gevonden fout, w ijziging: 1. Gegevenstype: de sectie (tag) in het xml-bestand w aar het feit is opgetreden; 2. Instance: het nummer van de instance; 3. Res(ultaat): F(out), W(ijziging) of G(oed); 4. Code: De code van de rule die is toegepast; 5. Veldw aarde: de w aarde van het veld; 6. Omschrijving: de omschrijving van het geconstateerde feit. 4.4 Wizard verwerking Met behulp van de knop Wizard kan in één keer al de vier de stappen van de Stapsgew ijze verw erking w orden uitgevoerd. 17