DPR Register Installations- og driftsvejledning

Transkript

1 Installations- og driftsvejledning CSC Danmark Copyright All Rights Reserved.

2 Side 2 af 31 Indholdsfortegnelse 1. Beskrivelse af løsningen Funktionalitet Installation af DPR Register applikationsserver Systemkrav Operativsystem Hardware Ekstern kommunikation DPR programmer Opret mappestruktur Hentning af filer fra CPR Opsætning af programmet Test af forbindelse Installation af øvrige DPR programmer Placering af programmer Installation af Visual Basic komponenter Opsætning af ODBC datakilde Oprettelse og tilretning af den krypterede DPR.DAT fil Opsætning af DA Opsætning af DA220 og Logdump Opsætning af DA281 udtræk til Care omsorgssystemer Etablering af DPR database DPR Register Database Server Systemkrav Operativsystem Relationsdatabase Hardware Ekstern kommunikation DPR programmer Etablering af dataindhold Indlæsning af etableringsdata i tom DPR database (load) Etablering fra database dump Etablering af adgang fra en ekstern applikation Drift af DPR Register... 20

3 Side 3 af Automatisk driftsafvikling via Windows Task Scheduler Daglig ajourføring Hent ajourførings fil fra CPR Ajourfør DPR databasen Effekt af sætning og sletning af abonnementer med CPR Direkte og CPR Udtræk Hvad sker der, når abonnement sættes og slettes på en person? Periodiske opgaver Indlæsning af distriktsoplysninger Opsætning af FTP-programmet Drift med specialudtræk med kommunens veje Drift med gratis landsdækkende CPR Vejregister Automatisk rekvisition af opdatering på personer Abonnementsætning af personer Hjælpeprogram til dannelse af abonnementsfiler Tømning af brugeranvendelses log Sletning af historik Andre kørsler Indkøring af nye programversioner Kontrol af indstillinger for server programmer Vedligeholdelse af brugeradgang Genetablering med genopfriskningsudtræk fra CPR Vejledning Kontaktpersoner... 31

4 Side 4 af Beskrivelse af løsningen DPR står for Decentralt Person Register. Formålet med DPR er at stille opdaterede CPR-data for relevante personer til rådighed for andre lokale systemer. Figur 1. DPR Register og dets omgivelser. DPR Register består af en database med en række tabeller med persondata og supplerende data om veje og myndigheder fra CPR. DPR omfatter programmer til etablering og ajourføring af databasen fra CPR. De daglige ajourføringsfiler dannes om aftenen af CPR og afspejler dagens ajourføringer i CPR.

5 Side 5 af Funktionalitet Figur 2. DPR Register kan være delt i en databaseserver og en applikationsserver. I denne vejledning omtales DPR Register applikationsserveren og DPR databaseserveren som to forskellige maskiner. Når DPR databasen afvikles på en maskine med et Windows operativsystem, afvikles DPR Register applikationerne dog som regel også på denne maskine. DPR Register applikationsserveren anvendes til via en netværksforbindelse til CPR ved hjælp af FTP at hente ajourføringsfiler fra CPR. DPR Register applikationerne anvendes derefter til at overføre ajourføringerne via en ODBC TCP/IP forbindelse til DPR databasen.

6 Side 6 af Installation af DPR Register applikationsserver Applikationsserveren anvendes både til at hente filer fra CPR og til at ajourføre DPR databasen med de hentede data. Vejledningen er delt op i to dele: Funktionalitet til hentning af filer fra CPR Funktionalitet til indlæsning af filer fra CPR i databasen 2.1 Systemkrav Operativsystem Windows Server 2003 eller nyere. 32 og 64 bit versioner Hardware PC eller server, som kan driftsafvikle det valgte operativsystem Ekstern kommunikation Adgang til internet. Dette anvendes til afhentning af ajourføringsfiler fra CPR med Secure FTP. Netværksforbindelse til DPR Register database server, som kan anvendes til kommunikation ved hjælp af ODBC over TCP/IP. Database brugerkode. Brugerkode og krypteret kendeord til DPR Register databasen lagres i filen DPR.DAT DPR programmer Følgende DPR programmer skal være installeret: DPR Hent filer. Henter og afleverer filer fra/til CPR. DPR3FTP.exe. DPR Ajourføring. Ajourfører DPR Register med ajourføringsfilerne fra CPR. DA205.exe. DPR Indlæs distrikter. DISTLOAD.EXE. DPR Slet historik. Sletter historiske personer og historiske registreringer i DPR Register. DA220.exe. DPR Log dump. Udskriver loggen af brugeranvendelse til en tekst fil og tømmer loggen. Logdump.exe. DPR Administration. Konfigurering af DPR installationens AD-integration. Administration af specielle DPR brugerkoder og redigering af krypteret login-fil. DPRadm32.exe. DPR Administration. Hjælpetekster til DPR Administration. DPRadmin.hlp.

7 Side 7 af Opret mappestruktur DPR serverprogrammerne kan placeres et vilkårligt sted på DPR Register applikationsserveren. På dette sted skal der oprettes følgende mapper: \DPR \DPR\DOWNLOAD \DPR\DOWNLOAD\BACKUP \DPR\DOWNLOAD\ERROR \DPR\DOWNLOAD\TEMP \DPR\LOG \DPR\PGM \DPR\UPLOAD 2.3 Hentning af filer fra CPR FTP programmet DPR3FTP.exe skal installeres. Det sker ved at køre programmets DPR_FTP_3400.msi står for versionsnummer, og vil gradvist vokse med kommende versioner. Dette program er beregnet til at blive afviklet automatisk fra serverens task-scheduler. I FTP-programmets opsætning kan man vælge, hvilken port programmet skal anvende. Hvis man vælger at køre mod serverens port 321 kører den FTPS med Explicit SSL. FTPS implicit mode: Hostname ftp.cpr.dk port 990. Derudover skal der åbnes for adgang til port til dataoverførsel. Hvis man vælger at køre mod serverens port 990 kører den FTPS med Implicit SSL. FTPS (FTPES) explicit mode: Hostname ftp.cpr.dk port 321. Derudover skal der åbnes for adgang til port til dataoverførsel. DAP URL: Tegnsæt i filerne er ASCII ISO og det bliver nu ikke ødelagt af den filredigering, som programmet foretager, for at sortere eventuelle fejl records type 810 fra sidst i filen Opsætning af programmet Når programmet er installeret, skal der foretages en opsætning af parametre.

8 Side 8 af 31 Figur 3. Opsætning af programmet DPR Hent filer. Udfyldning: CPR FTP-servder er altid: ftp.cpr.dk Port udfyldes med 321 eller 990 alt efter, om I ønsker af køre FTPS med Explicit (321) eller Implicit (990) SSL. FTP user og FTP Password udfyldes med den brugerkode og det tilsvarende kendeord, som I er fået. Udtræksnummer udfyldes med det 4-cifrede CPR kundenummer, som er lig med de første 4 cifre i opgavenummeret. Opgaveløbenummer for person-vej ændringsudtræk Personfil lbnr 2 cifre), for myndighed-post ændringsudtræk Myndfil lbnr 2 cifre), som CPR-kontoret har oplyst. Lokalt DPR arbejdsbibliotek udfyldes med sti til placeringen af DPR biblioteket (Se pkt. 2.2 ovenfor). Når opsætningen er afsluttet, klikkes på Gem og kør, og der fremkommer følgende kvittering, som forklarer, hvor oplysningerne er gemt. Hvis der sættes hak i checkbox for Abonnnementsfejl til DPR DB (Dan temp-fil), så gemmes fejl records med recordnummer 910 i tabellen DTABONNFEJL i DPR-databasen. Hvis modtagne fejl records fra CPR ønskes gemt i databasen, sættes hak ved Abonnementsfejl til DPR DB.

9 Side 9 af Test af forbindelse Når opsætningen er afsluttet, foretages test af forbindelsen ved manuelt at afvikle DPR Hent filer. Start DPR3FTP.exe og vælg Kør nu. Det forventede resultat er, at alle opdateringsfiler fra CPR, som er blevet dannet siden dannelsen af det totale etableringsudtræk, nu vil blive hentet ned og lagret på DPR Register applikationsserveren. Programmet kontrollerer for hver opdateringsfil, om slut-record er modtaget. Programmet henter kun filer, som ikke allerede er hentet og befinder sig i DPR biblioteksstrukturen. DPR Hent filer sletter først filerne på det centrale CPR anlæg, når de er 14 dage gamle. 2.5 Installation af øvrige DPR programmer Placering af programmer Alle de nævnte DPR programmer placeres i mappen PGM Installation af Visual Basic komponenter En del af DPR Register programmerne er udviklet i Visual Basic 6. Afvikling af disse kræver adgang til en række Visual Basic komponenter. Ved afvikling af filen DPR_Komp.msi installeres de nødvendige komponenter på serveren Opsætning af ODBC datakilde Der skal på serveren være en ODBC-datakilde (System DSN), som peger på DPR databasen. Det er navnet på denne ODBC datakilde, der skal angives ved opsætningen af DPR Register programmerne. Den normale ODBC wizard anvendes ved oprettelsen. Denne startes ved at trykke Add i nedenstående billede.

10 Side 10 af 31 Figur 4. Opsætning af ODBC datakilde. For MS SQL Server vælges ODBC-driveren SQL Server. Figur 5. Oprettelse af ny datakilde. For Oracle vælges Oracle ODBC driveren, som sættes til at pege på den rigtige Oracle SQL*net konfiguration.

11 Side 11 af Oprettelse og tilretning af den krypterede DPR.DAT fil Til afvikling af DPR Register serverprogrammerne skal der være adgang til en fil, hvori brugerkode og kendeord til DPR databasen findes i krypteret form. Alle DPR programmer tilgår uden brugerens viden databasen med denne pseudo user. Oplysningerne lagres i filen DPR.DAT, som placeres i mappen PGM. DPR.DAT oprettes og ændres ved hjælp af DPR Administration. Start fra kommandolinjen DPRadm32.exe d (filnavn efterfulgt af mellemrum bindestreg d ). Figur 6. Åbning af DPR Administration (DPRadm32.exe d) Uanset, om en fil skal oprettes eller ændres, vælges først Åbn loginfil. Hvis filen skal oprettes, angives det ønskede navn. Ellers vælges den hidtil anvendte fil. Figur 7. Brugerkode og kendeord registreres. Når loginfilen er valgt, vælges Rediger fil. Man angiver brugerkode (Brugerident) og kendeord til DPR Register databasen. Kendeordet lagres krypteret i den valgte fil Opsætning af DA205 Start DA205.exe fra en stifinder. Hvis programmet ikke er konfigureret med samtlige nødvendige oplysninger, vil programmet automatisk vise skærmbilledet til indtastning af disse. Hvis programmet allerede er opsat, vil det starte normal behandling efter 1 minut. I dette tidsrum kan man vælge opsætningsbilledet ved at trykke Ret opsætning på programmets normale startbillede.

12 Side 12 af 31 Figur 8. Normalt startvindue for DA205. Opsætningsbilledet ser ud som følger: Figur 9. Opsætning af DA205.

13 Side 13 af 31 Udfyld CPR Kundenummer, Person Fil LbNr og Mynd Fil LbNr på samme måde som for FTP-programmet. Udfyld Sti til DPR bibliotek med den aktuelle sti og biblioteksnavn. Checkbox en Spær for samtidig afviking af flere instanser afkrydses, hvis ajourføringsprogrammet ikke må køre flere gange samtidig. Det kan være relevant, hvis der kommer ekstremt store opdateringsfiler fra CPR, så ajourføringen for dag n+1 kan blive sat i gang inden ajourføringen for dag n er afsluttet. Parameteren må endelig ikke afkrydses, hvis flere DPR-databaser skal opdateres på samme server, da samtidig kørsel netop ønskes i denne situation. Udfyld ODBC Data Source navn med det valgte navn på ODBC datakilden. Udfyld Krypteret password-fil (DAT filen) med den aktuelle sti og filnavn. Afkryds checkbox en Udfyld tabellen dtpersajour (til Care, DDElibra m.fl.), hvis der skal køre et eller flere udtræksprogrammer til andre systemer. Indstillingen bevirker, at dagens opdaterede personnumre skrives i tabellen DTPERSAJOUR. Afkryds checkbox en Dan listefil pr. opdateringsfil, hvis en sådan ønskes dannet. (Specialfunktionalitet til Region Hovedstaden.) Udfyld Bibliotek til listefiler med den aktuelle sti og biblioteksnavn. (Specialfunktionalitet til Region Hovedstaden.) Opsætning af DA220 og Logdump Start fra kommandolinjen DA220.exe o (filnavn efterfulgt af mellemrum bindestreg o ). Figur 10. Opsætning af DA220. Udfyld ODBC Data Source Navn med det valgte navn på ODBC datakilden. Udfyld Navn og fuld sti på dat-fil og Fuld sti til DPR bibliotek med de aktuelle navne. Sæt hak i Microsoft SQL Server, selv om der eventuelt anvendes Oracle. På samme måde foretages der opsætning af Logdump.exe Opsætning af DA281 udtræk til Care omsorgssystemer Programmet udtrækker oplysninger om alle personer (totaludtræk) eller opdaterede personer (ændringsudtræk). Start DA281.exe fra en stifinder.

14 Side 14 af 31 Hvis programmet ikke er konfigureret med samtlige nødvendige oplysninger, vil programmet automatisk vise skærmbilledet til indtastning af disse. Hvis programmet allerede er opsat, vil det starte normal behandling efter 1 minut. I dette tidsrum kan man vælge opsætningsbilledet ved at trykke Options på programmets normale startbillede: Figur 11. Normalt start vindue for DA281. Figur 12. Vindue til opsætning af parametre i DA281. Udfyld ODBC Data Source Navn med det valgte navn på ODBC datakilden.

15 Side 15 af 31 Udfyld Navn og fuld sti på dat fil og Fuld sti til DPR bibliotek med de aktuelle navne. Udfyld Fuld sti til, hvor udtræksfil skal skrives med stien til et bibliotek, hvorfra hjemmeplejesystemet kan overtage filerne. Dette kan eventuelt være på en anden server, men husk, at useren, som afvikler programmet, skal have skriverettigheder der. Feltet Microsoft SQL Server skal altid være markeret. Feltet Dan totaludtræk (uden historik) kan markeres eller ej alt efter ønske. Indstillingen gemmes til næste kørsel, så husk at ændre tilbage, hvis man kun en enkelt gang vil køre totaludtræk. Feltet Dan 3 måneders udtrækshistorik på dtpersajourhist kan markeres, hvis man ønsker dette. Feltet Slet styredata i dtpersajour ved afslutning. N.B.: Dette felt er vigtigt og skal ses i sammenhæng med øvrige kørsler, som også skal bruge oversigten over, hvilke personer der er ændret i DPR databasen f.eks. bibliotekssystemer. De schedulerede kørslers tidspunkt på døgnet afgør, hvilket job der skal slette indholdet af dtpersajour. Det job, som afvikles sidst, skal slette tabellen. Felterne Separat udtræk til følgende kommunenumre anvendes, hvor flere kommuner deles om en fælles DPR database. Felterne udfyldes med de relevante kommunenumre, og udtræksfilerne vil blive anbragt i undermapper til det angivne udtræksbibliotek. 3. Etablering af DPR database DPR Register Database Server Data fra CPR, logning af DPR-applikationers søgninger samt nogle supplerende data lagres i en relationsdatabase. På DPR Database serveren skal der oprettes en database med DPR-tabellerne. Der skal etableres ODBC netværksforbindelse til DPR Register applikationsserver. Etableringsudtrækkene fra CPR skal indlæses. Der skal etableres netværksforbindelse til de af myndighedens systemer, som skal kunne slå op i DPR databasen. Indlæsning af CPR etableringsudtræk og ajourføringsfiler i DPR databasen skal testes. På et tidspunkt skal myndigheden selv teste adgangen fra myndighedens øvrige systemer. 3.1 Systemkrav Operativsystem Normalt Windows Server eller UNIX Relationsdatabase MS SQL Server eller Oracle Hardware Tilstrækkelig diskplads til, at DPR kan driftsafvikles. DPR databasen fylder, i hvert fald for MS SQL Server, omkring 150 MB som basis plus plus 3,2 KB pr. person.

16 Side 16 af Ekstern kommunikation Netværksforbindelse til DPR Register applikationsserver og øvrige systemer, som skal kunne trække på persondata fra DPR. Databasen skal kunne tilgås ved hjælp af ODBC over TCP/IP. Såfremt myndigheden ønsker det desuden serviceadgangsforbindelse for CSC via Internet ved hjælp af Windows Remote Desktop eller lignende DPR programmer På databaseserveren skal der ikke være installeret specielle DPR programmer, men i relation til databasearbejde bør der på applikationsserveren være installeret programmet DPR_update.EXE Programmet benytter opsætningen fra opdateringsprogrammet DA205.exe for at have tilgang til DPR databasen. Ved hjælp af dette program kan man afvikle SQL-scripts på DPR databasen. Programmet viser en logfil fra afviklingen og gemmer denne i DPR\LOG biblioteket. Når programmet startes, viser det, hvordan det er forbundet til databasen, og straks derefter en standard fil-vælgeboks, hvor man kan udpege det ønskede SQL-script. Figur 13. Vindue, som viser serverens konfiguration for DPR serverprogrammer.

17 Side 17 af 31 Figur 14. Vindue med filvælgeboks. I en tom DPR database bør man benytte dette program til at afvikle et SQL script, som opretter samtlige DPR tabeller (se nedenfor). 3.2 Etablering af dataindhold Det forudsættes, at den ønskede relationsdatabase allerede er installeret på DPR Database serveren. Det forudsættes, at der er oprettet en systembrugerkode til DPR databasen. Det forudsættes desuden, at der er installeret den fornødne ODBC driver på applikationsserveren. For MS SQL Server er det en del af programmet. For Oracle kræves desuden Oracle SQL*net. Opret DPR databasen med passende plads og sørg for, at databasebrugeren, som ligger i den krypterede fil DPR.DAT, har default adgang til denne database og tilstrækkelige rettigheder til at oprette tabeller og skrive og læse i disse. Kør derefter programmet DPR_update.exe på applikationsserveren og vælg følgende script-fil for at få oprettet samtlig DPR tabeller: DPR_tabeller_alle.sql N.B.: Bemærk at dette script først sletter alle tabeller incl dataindhold, som måtte befinde sig i databasen. Hvis man derfor har til opgave at genetablere en eksisterende database, bør man i stedet afvikle script-filen: DPR_tabeller_genetab.sql

18 Side 18 af Indlæsning af etableringsdata i tom DPR database (load). Fra CPR modtages der 2-3 etableringsudtræksfiler: Betegnelse Person-vej-data 99990? Myndigheds-postnr.-data 99990? Evt. Vejdistrikts-data 99990? Opgavenummer I praksis skal der stå jeres 4-cifrede kundenummer i stedet for Filerne bliver hentet fra CPR og siden installeret ved hjælp af DPR Register applikationsserveren, som installerer CPR-data på DPR Database serveren. Etableringsudtræksfilerne placeres i mappen DOWNLOAD på DPR Register applikationsserveren. Kør DPR Ajourføring, DA205.exe, fra en stifinder. Figur 15. Normalt start vindue for DA205. Tryk på knappen Etablering, Figur 16. Vindue til angivelse af filnavne for etablering. Ved at trykke på de to Vælg knapper kan man vælge henholdsvis: - Etableringsfilen med person- og vejdata fra CPR (den store af de to filer)

19 Side 19 af 31 - Etableringsfilen med myndigheds- og postnummerdata fra CPR Filnavnene har formatet Dååmmdd.Lnnnnnn, hvor åå står for år, mm for månedsnummer, dd for dag og nnnnnn for CPR s opgavenummer. Tryk herefter på knappen Kør, og lad programmet indsætte data i den nyoprettede database. Herefter er installationen af DPR Registerdel med CPR produktionsdata afsluttet. Ved hjælp af DPR_update.exe kan man derefter køre SQL scripts, som Oretter en administrationsuser til login i DPR administrationsmodulet Indsætter kommunens navn i DPR systemtabellen Etablering fra database dump Ofte kommer DPR installationskonsulenten fra CSC med et dump fra en allerede etableret DPR database. For en MS SQL Server database foretages i så fald blot import af dumpet ved hjælp af restore kommandoen fra Enterprice Manager. For en Oracle database foretages import af dumpet ved hjælp af imp kommandoen. 4. Etablering af adgang fra en ekstern applikation Der skal etableres netværksforbindelse til de af myndighedens systemer, som skal kunne slå op i DPR databasen. Myndigheden står normalt selv for etableringen af disse adgange.

20 Side 20 af Drift af DPR Register 5.1 Automatisk driftsafvikling via Windows Task Scheduler De kørsler, som skal afvikles dagligt eller ugentlig, opsættes i Windows Task Scheduler, således at afviklingen sker på hensigtsmæssige tidspunkter. Når man gennemløber den tilhørende wizard for at opsætte kørsler, bør man huske at sætte den maksimale køretid NED fra de 72 timer, som forslås pr. automatik. Dette kan i værste tilfælde bevirke, at 3-4 udgaver af samme job hænger på serveren, hvis der er noget galt. Som bruger, der skal afvikle kørslerne run as, angiver man system og lader passwordfelterne være blanke. Når man efterfølgende åbner jobbet, vil der stå "NT AUTHORITY\SYSTEM" i run as feltet, hvilket indebærer, at jobbet kører i "local system account". Derved opstår der ikke problemer med ændrede passwords. Hvis et job skal have adgang til en anden server, skal man huske at give afviklingsserverens system-account adgang på den anden server ved hjælp af AD. Man kan give en servers system account NTFS rettigheder på en anden server (i et AD) ved at finde servernavnet i stedet for en gruppe/bruger, der hvor man tildeler rettigheder. Hvis rettighederne skal gælde alle computere/servere i AD et, kan man bruge gruppen "Domain computers", som medfører, at alle computeres system accounts får de angivne rettigheder. Figur 17. Opsætning af Task Scheduler.

21 Side 21 af Daglig ajourføring Hent ajourførings fil fra CPR Dette sker automatisk ved at programmet DPR Hent filer (DPR3FTP.exe) logger på CPR, henter opdateringsfilerne og gemmer dem i \DOWNLOAD mappen. Det sker på det tidspunkt, hvor programmet er sat op til at køre i serverens task scheduler. Hvis der er behov for manuel afhentning af ajourføringsfiler fra CPR, kan det gøres ved at starte programmet DPR Hent filer og klikke på OK (Kør). Når programmet DPR Hent filer køres, så hentes alle filer, som CPR har lagt ud til den pågældende myndighed, og som ikke tidligere er hentet. Filerne placeres i DOWNLOAD undermappen til mappen, som er angivet i Sti til DPRbibliotek. DPR Hent filer gennemlæser filerne for at se, om overførslen er gennemført korrekt. Derefter sletter programmet opdateringsfiler, som er ældre end 14 dage, på den centrale CPRserver hos CSC. Hvis der findes abonnementsfiler i mappen DPR\UPLOAD sendes disse til centralt CPR og slettes lokalt. Logning Logning af aktuel dags aktiviteterne sker i: DPR-sti"\LOG\FTP_ååmm.log hvor åå står for år og mm for månedsnummer. Fejlliste fra det centrale CPR-system Hvis der er foretaget fejlagtige indrapporteringer til CPR, typisk i forbindelse med abonnementssætning af udenbys personer, vil DPR Hent filer programmet danne en fejlliste med fejllinier, som starter med et record nummer 910. Disse fejllinier placeres i fejllisten: DPR-sti"\LOG\CPR_UDTRAEKFEJL_ååmm.LOG Ajourfør DPR databasen Programmet DPR Ajourføring (DA205.exe) sørger for at indlægge ajourføringerne i DPRdatabasen og skrive i logfilerne. Selve ajourføringen af databasen med de afhentede ajourføringsfiler foretages af programmet: DPR-sti"\PGM\DA205.exe Ajourføringsprogrammet udfører sekvenskontrol på filerne fra CPR for at undgå, at der glemmes en ajourføring. Således kan man ikke køre ajourføring fra én dag, hvis ajourføringen fra foregående dag ikke er foretaget.

22 Side 22 af 31 Figur 18. Vindue, som vises mens ajourføring foretages. Når ajourføringen er gået godt, gemmes ajourføringsfilerne i mappen DOWNLOAD\BACKUP. Herfra bør de periodisk slettes manuelt. Hvor længe, man skal gemme filerne, afhænger af, hvor ofte der tages backup af databasen. Hvis ajourføringen af en eller anden grund går galt, gemmes ajourføringsfilerne i mappen DOWNLOAD\ERROR. Disse filer vil automatisk indgå i næste kørsel af programmet, så der ikke er behov for manuel flytning af filer før en eventuel omkørsel. Logning Logning af aktuel dags aktiviteterne sker i: DPR-sti"\LOG\log205_ÅÅMM.log, hvor ÅÅ står for år og MM står for måned.

23 Side 23 af 31 Figur 19. Eksempel på log fil. Kontrol af daglige ajourføringer Det bør dagligt kontrolleres, at ajourføringen er gået godt. Dette gøres ved at se i filen DA205_ÅÅMM.LOG på DPR Register applikationsserveren. Hvis ajourføringen er blevet afbrudt, skal fejlen rettes og ajourføringen skal køre igen. Kontakt CSC, hvis det volder problemer. Se afsnittet Kontaktpersoner.

24 Side 24 af Effekt af sætning og sletning af abonnementer med CPR Direkte og CPR Udtræk En del af driften af en DPR-løsning består i at sætte abonnement på det tilhørende CPR Udtræk på personer, som mangler i DPR, eller som af andre grunde ønskes sat i abonnement. Tilsvarende skal abonnementet på personer, som ikke længere har relevans, slettes. Flere fagsystemleverandører har haft behov for at vide, hvordan man kan se på en person i DPR databasen, om der er abonnement på vedkommende, og for andre personer, om data kan være usikre, fordi de ikke opdateres fra CPR. Formålet med dette afsnit er at beskrive, hvad der sker ved abonnementsætning og sletning, og hvordan man bør agere på det Hvad sker der, når abonnement sættes og slettes på en person? Hvad sker der med registreringerne i DPR databasen, når der henholdsvis sættes og slettes abonnement på en person på CPR Ændringsudtrækket? Typisk bruger fagsystemerne DPR Viderestilling og dermed CPR Direkte til at hente data om manglende personer i DPR databasen og til at sætte dem i abonnement på CPR Udtræk. Når DPR Viderestilling kalder CPR Direkte med et personnummer, så hentes data fra CPR og indsættes i DPR databasen. Da få datatyper mangler i CPR Direkte svaret i forhold til i CPR Ændringsudtræk, så sættes der en usikkerhedsmarkering i DPR databasen. Hvis DPR Viderestilling beder om at få sat abonnement på personen i CPR, så modtages samme aften totale data for personen med CPR Ændringsudtræk og DPR Ajourføring indsætter data i DPR databasen. Dermed fjernes usikkerhedsmarkeringen. Hvis der allerede er sat abonnement på en person, bør man ikke hente data om personen igen med DPR Viderestilling, for så sættes en usikkerhedsmarkering i DPR databasen, som ikke siden slettes, da der ikke modtages data om personen i CPR Ændringsudtræk samme aften, da personen allerede er i abonnement. Det skal i så fald ryddes op blandt personer med U og udfyldt kundenummer. Se nedenstående. Det kan oplyses, at CPR i visse tilfælde udfylder feltet DTTOTAL:TFDTOMRK med *. Det gøres, når datoen angivet i feltet DTTOTAL:TILFDTO (Tilflytningsdato) er oplyst som usikker til CPR.

25 Side 25 af 31 Persontype DTTOTAL: TFDTOMRK DTPERS: KUNDENR Bemærkninger Data fra CPR Udtræk indsat med DPR Ajourføring (DA205) Indenbys personer Beboer i kommunen. Null O (tallet nul) Normal beboer i kommunen. Der er ikke abonnement i CPR. Beboer i kommunen. Der er abonnement i CPR. Null Nnnn (4-cifret kundenr.) Der er blevet sat abonnement på personen i CPR. Beboer i kommunen. Der er ikke abonnement i CPR. Udenbys personer Ikke beboer i kommunen. Der er ikke abonnement i CPR. Ikke beboer i kommunen. Der er abonnement i CPR. Beboer fraflyttet kommunen. Der er ikke abonnement i CPR. Ikke beboer i kommunen. Der er ikke abonnement i CPR. Null O (tallet nul) Abonnementet på personen er blevet slettet. Null Nnnn (4-cifret kundenr.) Personen findes ikke i DPR databasen. Der er blevet sat abonnement på personen i CPR. U O (tallet nul) Usikkerhedsmarkering er sat i forbindelse med fraflytning. U O (tallet nul) Abonnementet på personen er blevet slettet. Beboer i eller uden for kommunen. Der var sat abonnement i selve CPR-databasen på det tidspunkt, hvor kaldet blev lavet. U Nnnn (4-cifret kundenr.) Data fra CPR Direkte indsat med DPR Viderestilling Beboer i eller uden for kommunen. Der var ikke sat abonnement i selve CPR-databasen på det tidspunkt, hvor kaldet blev lavet. U Null Personen er hentet og indsat ved hjælp af DPR Viderestilling. Enten er personen ikke sat i abonnement, eller også er personen sat i abonnement, men de data, som er indlæst med DPR Viderestilling er endnu ikke overskrevet af data fra CPR Udtræk indlæst af DPR Ajourføring. Personen er hentet og indsat ved hjælp af DPR Viderestilling. Enten er personen i abonnement, eller også er abonnement på personen slettet, men de data, som er indlæst med DPR Viderestilling er endnu ikke overskrevet af data fra CPR Udtræk indlæst af DPR Ajourføring.

26 Side 26 af Periodiske opgaver Indlæsning af distriktsoplysninger Dette sker ved hjælp af programmet DISTLOAD.EXE. Programmet kan anvende to forskellige typer filer Speciel udtræksfil fra CPR, udelukkende med kommunens distrikter Gratis fil fra CPR med hele landets distrikter Opsætning af FTP-programmet Til specialudtræk med kommunens veje Programmet bruger opsætningen fra FTP-programmet. Hvis Distr.Fil Lbnr er udfyldt med to cifre, vil programmet se efter en fil med et ganske bestemt navn i folderen DPR\DOWNLOAD. Findes denne fil ikke, lukker programmet og skriver dette i loggen: :22:04 Ingen loadfil til denne kørsel. Dette er beregnet til kommuner, som abonnerer på et specielt distriktsudtræk fra CPR. Til gratis landsdækkende CPR Vejregister Hvis Distr fil lbnr derimod ikke er opsat i FTP-programmet, vil DISTLOAD.EXE åbne et vindue, hvor man kan angive eller vælge den gratis landsdækkende distriktsfil hentet fra hjemmesiden Drift med specialudtræk med kommunens veje På de terminsdatoer, som kommunen har aftalt med CPR, danner CPR et vejregister med distrikter for kommunen og lægger dem klar til afhentning med FTP. FTP-programmet henter automatisk vejregisterudtrækket. DISTLOAD.EXE indlæser automatisk den nye vejregisterkopi i DPR. Alt foregår automatisk og kommunens IT-afdeling skal ikke gøre noget Drift med gratis landsdækkende CPR Vejregister Hent CPR Vejregister fra CPR s hjemmeside En af de første dage i hver måned lægger CPR-kontoret en opdateret kopi af CPR Vejregister på CPR-hjemmesiden Vælg Gratis download Vejregister og udtræksbeskrivelse. Vælg Vejregister hele landet pr. ååmmdd.exe, hvor åå er år, mm er måned og dd er dag. Gem filen på jeres lokale disk. Der er tale om en selvudpakkende fil. I skal blot dobbeltklikke på den i stifinderen, så bliver den pakket ud, der, hvor I vælger det. Indlæs CPR Vejregister i DPR Start programmet DISTLOAD.EXE, som er placeret i DPR\PGM folderen. Programmet skal være minimum version

27 Side 27 af 31 Figur 20. Vindue til load af gratis landsdækkende CPR Vejregister med distrikter. Angiv først load-filen ved at klikke på Browse-knappen og pege på den udpakkede vejregisterfil og trykke på Åben. Programmet vil automatisk foreslå kun at indlæse distrikter, der hører til i den aktuelle kommune (fundet i tabellen DTAJOUR). Når I ser vinduet, vil der i stedet for 9999 i Indlæs kun distrikter fra 9999 stå den relevante myndighedskode for jeres kommune. Klik på Start-knappen. Programmet gennemlæser først filen og begynder derefter at indlæse data i DPR. Programmet slutter med at anvise logfilen for kørslen. Figur 21 Kontroller den anviste logfil

28 Side 28 af 31 Figur 22 Esempel på logfil fra kommune 999), som ikke har nogen distrikter Automatisk rekvisition af opdatering på personer Hvis kommunen bruger DPR Viderestilling, kan det anbefales at køre programmet AutoRevisition.EXE dagligt. Hvis brugerne foretager et CPR opslag og opdatering på en person, som allerede er fuldt opdateret i DPR databasen, vil personens oplysninger blive forringet, fordi ikke alle oplysninger kommer retur gennem DPR Viderestilling. AutoRekvisition.EXE vil finde sådanne personer og danne en rekvisitions-records i den fil, som ligger i DPR\UPLOAD. Man bør sørge for, at DPR2FTP.EXE kører efter, at filen er dannet, og før klokken 12 middag. Klokken 12 lukker CPR-systemet nemlig for modtagelse af inddata til den pågældende dags udtrækskørsler Abonnementsætning af personer Standardmæssigt indeholder DPR samtlige personer, som bor i en kommune/region. Dette betegnes den geografiske personkreds. Er der behov for oplysninger om personer uden for den geografiske personkreds, kan der i CPR sættes abonnementsmarkering for disse. Det medfører, at der først modtages fuldstændige CPR data for de pågældende personer sammen med den næstfølgende ajourføringsfil. Desuden modtages efterfølgende ajourføringsdata for de abonnementsatte personer. Abonnementssætning kan foretages ved at sende personernes personnumre til CPR i en fil med følgende format: 06NNNN00OPXXXXXXXXXX(efterfulgt af 60 blanke) 06 angiver en inddatatype. NNNN er kundenummeret tildelt af CPR-kontoret. 00 er en konstant. OP står for oprettelse. I XXXXXXXXXX angives personnummeret. For at komme op

29 Side 29 af 31 på en fast record-længde på 80 tegn, afsluttes med 60 blanke. For en mere udførlig beskrivelse henvises til CPR-kontorets beskrivelse af Inddatanøgler i udtræksvejledningen for offentlige brugere. Når der ikke længere er behov for ajourføring for en person, kan abonnementssætningen i CPR tilsvarende fjernes. Dette gøres ved at indsende en fil med samme format bortset fra, at der står SL for slet i steder for OP for opret Hjælpeprogram til dannelse af abonnementsfiler. Hjælpeprogrammet Dan_Abonnement.exe kan danne sådanne filer ud fra en tekstfil med personnumre (med eller uden foranstillet nul og med eller uden bindestreg). Programmet startes og personnummerfilen vælges. Der er helt specielle krav til navngivning af filen. Den dannede fil vil have sit oprindelige navn med det rigtige navn hæftet på (valgt fra opsætningen af DA205.EXE). Fjern den gamle del af navnet og flyt filen til DPR\UPLOAD Kør derefter DPR2FTP.EXE, som vil sende filen ind til CPR. Kontroller FTP logfilen for eventuelle fejl med rettigheder til at aflevere filen. Kontakt CSC i tilfælde af problemer. N.B.: Abonnementsfiler skal indsendes inden kl. 12 middag Tømning af brugeranvendelses log Dette punkt er kun relevant, hvis installationen omfatter et eller flere af DPR klientprogrammerne DPR Søg, DPR Rapport eller DPR Viderestilling. Brugernes anvendelse af DPR databasen ved hjælp af DPR-modulerne DPR Søg, DPR Rapport eller DPR Viderestilling logges i DPR databasen i tabellen DTSYDPRLOG. Ved hjælp af programmet Logdump tømmes logdata ud på en flad fil. Navnet på disse filer er på formen: DPRLÅÅUU. F.eks. navngives logningen for uge 3 i 2007 DPRL0703. Programmet bør ved installationen blive sat op til at blive afviklet én gang pr. uge. Hvis der har været mere end 4 mislykkede adgangsforsøg fra samme brugerkode, udskrives dette på en ALARM fil. Disse log dump filer skal gemmes iht. Datatilsynets krav Sletning af historik Ved hjælp af programmet DPR Slet historik (DA220.exe) slettes forældede data. I DPR er der mange tabeller, fx én med adresser (nuværende og tidligere) og én med navne (nuværende og tidligere). På hver record/række er der et felt med hændelsesslutdato, dvs. den dato, hvor fx det pågældende navn (feltet NVHAENSL på DTNAVNE) ikke var gældende mere. DPR Slet historik programmet sletter de records, hvor hændelsesslutdatoen er ældre end den historikperiode, som er angivet i antal måneder i feltet HISMND i tabellen DTAJOUR. Perioden skal være mellem 3 og 60 måneder. Feltet vedligeholdes ved hjælp af DPR Administration. Ud over at slette gamle records, slettes på samletabellen DTTOTAL personer, som ikke har nogen

30 Side 30 af 31 aktuelle records på detail tabellerne. Sletningen berører ikke udenbys personer, hvis de er abonnementsatte. Programmet bør afvikles med jævne mellemrum for at slette data, som er forældede i forhold til historikperioden. Programmet udskriver en kvittering for sletning i filen LOG205.LOG. Det anbefales at gemme denne kvittering på papir Andre kørsler Der skal desuden foretages reorganisering og backup af databasen. Der henvises til databasesoftwarens dokumentation for udførelse af disse kørsler Indkøring af nye programversioner For nye versioner af klient programmerne til DPR Søg eller DPR Rapport kan man som regel nøjes med udskiftning af exe-filen på brugernes pc er. Er der tale om en ren netværksinstallation, kan man nøjes med udskiftning af versionen på serveren. For nye versioner af server programmerne kan man som regel nøjes med at skifte exe-filen på DPR Register applikationsserveren. Hvis der er andre rettelser, vil disse fremgå af det medfølgende leveringsbrev Kontrol af indstillinger for server programmer Det er muligt på en let måde at se og rette, hvilke indstillinger der anvendes for server programmerne med hensyn til ODBC Data Source Name, navn og fuld sti til DAT-fil samt fuld sti til DPR mappen. Det gøres ved at afvikles programmerne med angivelse af -o (bindestreg efterfulgt af bogstavet o), f.eks. DA220.exe o. Gælder kun DA220 og Logdump. Nyere programmer har den adfærd efter start, at de venter et stykke tid før de tager fat på den almindelige behandling. Dette benyttes ved automatisk afvikling. I ventetiden er der for disse programmers vedkommende mulighed for at trykke på en opsætnings-knap, som bringer opsætningsbilledet frem på skærmen Vedligeholdelse af brugeradgang Med hensyn til vedligeholdelse af brugerkoder til DPR klientprogrammerne DPR Søg og DPR Rapport, henvises til brugervejledningerne for de pågældende programmer. Med hensyn til vedligeholdelse af brugerkoderne til systemadministrator og til applikations systembrugerkoder, henvises til systemdokumentationen for den anvendte relationsdatabase. 5.5 Genetablering med genopfriskningsudtræk fra CPR I visse tilfælde kan det være aktuelt at udskifte DPR-databasens indhold med et genopfriskningsudtræk fra CPR. Dette kan fx være tilfældet, når et DPR-system får tilknyttet en ekstra myndighed, fx i forbindelse med administrativt samarbejde med en anden myndighed. I disse tilfælde skal man Tømme de fleste DPR-tabeller for data

31 Side 31 af 31 Køre etablering med de nye data i genopfriskningsudtrækket Det er imidlertid vigtigt i denne situation at man IKKE tømmer følgende tabeller: DTSYBRUGER med brugerkoder mv. for alle de brugere, som har adgang til systemet. DTMYN med myndighedsnumre og navne. Indgår ikke i genopfriskningsudtrækket DTPOSTNR med postnumre og postdistrikter. Indgår ikke i genopfriskningsudtrækket Man skal derfor køre et SQL-script, som kun dropper de relevante DPR-tabeller, og derefter opretter disse igen. Hertil anvendes for MS SQL Server SQL-scriptet DPR_tabeller_genetab.sql, som dropper de gamle tabeller og opretter dem igen. For Oracle anvendes tilsvarende SQLscriptet TABS_crea_ORA.sql. De to tabeller vedrørende myndigheder og postnumre er landsdækkende og behøver derfor ikke blive genetableret. Det er vigtigt, at gøre CPR-kontoret opmærksom på, at genopfriskningsudtrækket ikke skal omfatte myndigheder og postnummer data, da der ellers uden grund betales ekstra for disse Vejledning Kopier etableringsfilen fra CD-ROM eller andet medie til DPR-sti \DOWNLOAD Kør DPR Ajourføring Vælg Etablering og vælg de to etableringsfiler på etableringsbilledet. Når etableringen er færdig, kontrolleres logfilen DA205_ÅÅMM.log. 5.6 Kontaktpersoner DPR For hjælp med hensyn til DPR kan det være relevant at kontakte CSC s DPR-gruppe. De aktuelle kontaktpersoner kan ses på DPR-hjemmesiden under Kontakt os. CPR Henvendelse om CPR dataudtræk m.m. sker til CPR-kontoret til kc@cpr.dk eller på telefon Se desuden CPR-kontorets hjemmeside