Anchor
_indledning _indledning

1. Indledning

...

Dokumentation af GCTP kommunikationsformatet kan findes i bilag - GCTP standard 2.0, til anvendelse i integration med CPR-systemets services.

...

Anchor
_læsevejledning _læsevejledning

2. Læsevejledning

...

CPR skelner mellem to overordnede typer af services: søge-services og ajourførings-services. Ved hjælp af disse services er det muligt at søge Resten af dette dokument giver en oversigt af de to overordnede kategorier af CPR-services: søge-services og ajourførings-services. Hvert afsnit beskriver de typer af data der kan frem-søges og behandles, samt hvilke overordnet principper der gør sig gældende for deres anvendelse.

Til sidst gives en kort gennemgang af sikkerhedsperspektiver ved anvendelse af CPR-services.

Anchor
_cpr_services_oversigt _cpr_services_oversigt

3. CPR-services oversigt

Anchor
_servicekategorisering _servicekategorisering

3.1. Servicekategorisering

CPR skelner mellem to overordnede typer af services: søge-services og ajourførings-services. Ved hjælp af disse services er det muligt at søge efter oplysninger i CPR-systemet, og det er muligt at ajourføre data i CPR. De enkelte CPR-services indeholder al behandling af data, inklusive validering af indsendt redigerbare data.

...

Der er 2 forskellige former for søge-services, der kan bruges alt efter, hvilke behov myndigheden har: opslag med specifikke nøgler, eller søgninger med kriterier.

Søge-services anvendes i GCTP som et <System r="CprSoeg"> element.

...

Efterfølgende er listet de typer af opslags-services, CPR kan levere, grupperet efter overordnet domæne oplysningerne vedrører.

...

• Vejsøgning
  Her findes vejoplysninger ud fra kriterier om kommune, sognedistrikt, postdistrikt eller bynavn., eventuelt kombineret med et vejinterval og/eller et specifikt distrikt.
• Myndighedssøgning
  Her findes myndigheder ud fra myndighedsnavnetmyndighedstype og navn, eller en del heraf.

Anchor
_hjælpesøgninger_

...

øvrige_søgninger _hjælpesøgninger_

...

øvrige_søgninger

Hjælpesøgninger / Øvrige søgninger

Disse søgninger bruges som hjælpesøgninger:

...

Der er 2 forskellige typer af Ajourføringsajourførings-services

...

: indberetning af hændelser

...

, og vedligeholdelse af data (både aktuelt og historisk).

Hændelser er de aktuelle begivenheder i samfundet der resulterer i, at der skal registreres oplysninger, f.eks. en flytning, en vielse eller et dødsfald. Der findes én CPR-service til hver type hændelse. Når hændelsen er registreret betragtes oplysningerne som data, der kan vedligeholdes enkeltvis.

For at fremskaffe de præcise nøgler til vedligeholdelse af data, kan det være nødvendigt først at kalde en søge-service. Den Denne vil returnere de oplysninger, der er nødvendige for at danne nøglen (f.eks. personnummer). Dette gælder er specielt fremtrædende ved vedligeholdelse af tidligere historiske oplysninger, hvor der først skal vælges den rette forekomst af oplysningerne, ved hjælp af specifikke nøgler der findes via søge-services, inden selve ajourføringen kan foretages.

Ajourførings-services anvendes i GCTP som et <System r="CprAjour"> element.

Anchor
_

...

indberetning_af_hændelser _

...

indberetning_af_hændelser

3.3.1.

...

Indberetning af hændelser

Ved indberetning af hændelser er der altid tale om aktuelle oplysninger, der skal registreres i forbindelse med hændelsen.

Efterfølgende er listet de forskellige typer af hændelser CPR indeholder:

Personhændelser

• Adoption
• Adresseringsnavn
• Beskyttelse
• Delt bopæl – registrering, ophør
• Dødsfald
• Enkestand
• EU-valgadresse
• Faderskab
• Flytning
• Flyttepåbud
• Folkekirke
• Forsvinding
• Forældremyndighed
• Genfinding
• Genindrejse
• Genaktivering af annullerede PNR.
• Indrejse med og uden personnummer
• Kommunale forhold
• Kommunale notater
• Kontaktadresse
• Navngivelse, navneændring
• Registreret partnerskab – indgåelse, omstødelse, ophævelse
• Separation – indgåelse, ophævelse
• Skilsmisse
• Statsborgerret
• Stilling
• Supplerende adresse
• Tildeling af personnummer - fødsel
• Tildeling af personnummer – skatte personnummer
• Tildeling af personnummer – ATP personnummer
• Tildeling af administrativt personnummer
• Udlændingenummer
• Udrejse
• Under værgemål/værge
• Valgret
• Vielse – indgåelse, omstødelse
• Værge

Vejhændelser

• Vejoplysninger - opret, ændring, ophør
• Vejnotater
• Vejdistrikter
• Tekniske ændringer
• Postnummer

Myndighedshændelser

• Myndighedoplysninger - opret, ret
• Byret relationer
• Kommunale relationer

Hvilke konkrete ajourførings-services, der vil være mulighed for at få adgang til, fremgår af bilag - liste over ajourførings-services.

Anchor
_

...

vedligeholdelse_af_cpr_data

...

_vedligeholdelse_af_cpr_data

3.3.2.

...

Vedligeholdelse af CPR data

Disse services bruges til at vedligeholde data i systemet. Her tales der ikke om hændelser, men om data, der skal vedligeholdesregistreringer på data/oplysninger.

For at en ajourførings-service kan finde den ønskede registrering med data, som en myndighed ønsker behandlet, skal de unikke nøgler angives, når ajourførings-servicen startes/initieres. Myndigheden kan være nødsaget til at bruge en søge-service for at fremskaffe de nødvendige nøgler (f.eks. personnummer eller vejkode).

...

Vedligeholdelsen af data kan ske på følgende måder:

...

Denne type af service bruges ved rettelse af fejlbehæftede data. Data bliver ret-markeret, således at det efterfølgende kan dokumenteres, at der har været en fejlagtig registrering.

Fortryd oplysninger

Disse services Denne type af service bruges til at fortryde oplysninger, der fejlagtigt er registreret på en given person. Ved fortryd sker der ingen sletning, men data bliver fortrudt-markeret, således at det efterfølgende kan dokumenteres, at der har været en fejlagtig registrering.

Indberet historiske oplysninger

Oplysninger kan være blevet registreret ”tidligere” end på indberetningstidspunktet, fordi der inden indberetningen, er registreret nye forekomster af samme type oplysningerSlet oplysninger

Denne type af service bruges til at slette oplysninger der har en ret-/fortryd-markering. Disse services er ofte kun tilgængelig for CPR kontoret.

Indberet historiske oplysninger

Denne type af service bruges til at registrere oplysninger der ikke er aktuelle. Sådanne oplysninger indberettes ikke som hændelser, men som data.

Som eksempel kan nævnes, at en nuværende adresseændring benævnes som en flytning, men en historisk adresseændring benævnes som historisk adressedata indberetning.

...

Multiservice

Visse services kan foretage både indberetning af hændelser, samt rette og slette disse aktuelle data, i samme service. Denne type service kaldes multiservice. Måden hvorpå man opnår de forskellige funktionaliteter, fremgår af dokumentationen på hver af disse services.

...

Efterfølgende er listet de typer af data, der kan vedligeholdes i CPR:

PersonoplysningerPersondata

• Adressedata
• Civilstandsdata
• Delt bopæls data
• Folkekirkedata
• Forsvindings-/genfindingsdata
• Fødselsregistreringssted
• Kommunaledata
• Navnedata
• Personnummerdata
• Personoplysninger i øvrigt
• Separationsdata
• Slægtsskabsdata
• Statsborgerretsdata
• Udrejse-/indrejsedata

Vejdata

• Vejdata

Hvilke ajourførings-services der vil være mulighed for at få adgang til, fremgår af bilag - liste over ajourførings-services.

...

En ajourførings-service afvikles i en serie af stadier der aktiveres af aktioner på servicen. Anvendelsen af en serie af disse stadier udgør servicens livscyklus på en enkelt hændelse eller data vedligeholdelse.

Anvendelsen af Som standard anvendes en service sker altid ved at starte med en aktion kaldt initiering. Derefter sker der enten en validering, eller data gemmes. Dertil kommer, at visse services også tillader at gemme data i vent.

...

Anvendelsen af en ajourførings-service starter altid med en initiering. Dette sker ved at kalde serviceintegrationen med de nøglefelter, der identificerer det generelle domæne objekt hændelsen eller datavedligeholdelsen omhandler, f.eks. personnummer hvis der skal indberetning af indberettes en flytning.

Nøgleregler

Som led i initiering har hver service forskellige nøgleregler. Disse sikrer, at det er validt at anvende servicen, med det objekt der er identificeret. Hvis nøglefelterne ikke opfylder disse regler, fejler initieringen, og servicen vil svare med en kvittering, der indeholder en fejlbeskrivelse i GCTP-formattet.

Hver service har sin egen dokumentation, der udleveres af CPR kontoret, og som beskriver nøglereglerne og deres fejlbeskrivelser. En service kan også danne generelle fejl, som er beskrevet i bilaget: *Bilag Generelle Fejlkoder* bilag - generelle fejlkoder.

Udover en services egne nøgleregler, er der også en række fælles nøgleregler, som skal opfyldes. Disse regler er beskrevet i bilaget: *Bilag Fælles Nøgleregler* bilag - fælles nøgleregler.

Hvis alle servicens nøgleregler godkender nøglefelterne, starter servicen en ny livscyklus session, og svarer med en præsentation af det stamdata der er relevant for servicen, de GCTP-aktioner der er tilladt, samt data inputfelter der anvendes til at indberette hændelser eller rette vedligeholde data i CPR-systemet.

Sessioner og correlation ID

Svaret på en initiering inkluderer også et ID der identificerer GCTP-sessionen der , som er startet af dette kald, kaldet . Dette ID kaldes et correlation ID. Et hvert efterfølgende kald til servicen skal videregive dette ID, for at fortælle servicen, hvad for livscyklus session de indsendte data tilhører.

IDet findes indgår i alle gctpGCTP-svar som ts attributten på serviceheader CprServiceHeader elementet, og skal ligeledes inkluderes på alle andre GCTP-aktioner til servicen (bortset fra initiering) i samme attribut. Indgår attributten i et kald til initiering, vil det blive ignoreret, og en ny session startes med et nyt ID.

I eksemplet neden for er correlation ID værdien 20220404135422304162.

<?xml version="1.0" encoding="UTF-8"?>
<root xmlns="http://www.cpr.dk">
  <Gctp v="1.0" env="Udvikling">
    <System r="CprAjour">
      <Service r="AUDIND-R">
        <CprServiceHeader r="AUDIND-R" st="P" a="I" ts="20220404135422304162">

// GCTP fortsætter...

Anchor
_validering _validering

Validering

Når en myndighedsbruger har klargjort data, kan det indsendes til valideringer via en GCTP-aktion. Ajourførings-servicen anvender derefter sine dataregler til at evaluere de indsendte data, og hvis de er godkendte, svarer servicen med en ok-kvittering. Hvis data indeholder fejlOk-kvittering (<Kvit r="Ok" v="0"/>). Hvis data indeholder fejl, der bryder med en dataregel, vil servicen i stedet returnere en fejlbesked i kvitteringen.Hver service dokumenterer dens egene dataregler i servicens dokumentation, der udleveres af CPR-kontoret. Endvidere Fejl-kvittering (<Kvit r="Fejl" v="fejlkode-her" t="fejltekst-her"/>) og evt. fejlmarkeringer på de inputfelter, der fejlede en dataregel. Disse fejlmarkering optræder som et e="x" attribut på Field elementet, hvor x er fejlkoden, som også står i kvitteringen.

Hver service dokumenterer dens egene dataregler i servicedokumentation, der udleveres af CPR-kontoret. Endvidere kan der også opstå generelle fejl, som beskrevet i bilaget: *Bilag Generelle Fejloder* bilag - generelle fejlkoder, og der er en række fælles dataregler, der også bliver evalueret mod den indsente data, som beskrevet i bilaget: *Bilag Generelle Dataregler* bilag - generelle dataregler. Endvidere valideres tegnsæt benyttet i tekst felter jvnfrjvnf. bilag: *Bilag Tegnsæt* afsnittet.

Anchor
_gem _gem

Gem

Når data indsendes til at blive gemt (også kaldet persisteret) i CPR-systemet, bliver valideringer automatisk kørt først, for at sikre, at det indsendte data er validt i forhold til servicens dataregler. Hvis disse regler godkender det indsendte data, bliver det indsendte data gemt i systemet, sammen med eventuelle afledte data der skal opdateres som konsekvens af registreringen. F.eks. et dødsfald, hvor afledte registreringer om afdødes relationer opdateres.

Når data er gemt , returneres en afslutAfslut-kvittering , som (<Kvit r="Afslut" v="0">), hvis yderligere data er beskrevet i hver services egen dokumentation. Herefter er livscyklus sessionen afsluttet og correlation IDet er ike længere validt. Forsøg på at lave flere aktioner med IDet vil blive afvist.

Anchor
_vent _vent

Vent

Visse services understøtter at gemme data i vent. Når dette sker, gemmes data i et midlertidigt stadie, og er endnu ikke betegnet som ægte data i CPR-systemet.

Data kan gemmes enten som kladde, eller det kan være godkendt. Når data er godkendt i vent, er det data der venter på at blive overført til CPR-systemet som ægte data, mens kladde blot er data der er under indtastning og venter på at blive behandlet.

...

Adgang til de ajourførende services er kontrolleret af et særskilt reglsæt. Den normale adgangskontrol er beskrevet i bilag - adgangskontrol til ajourførings-services, og adgangskontrollen til data i vent er beskrevet i bilag - adgangskontrol til vent.

...

Ajourførings-services kan indeholde datafelter, hvori der indsendes tekster, f.eks. diverse adressefelter. Disse felter, hvor data typen er en tekststreng, er underlagt et generelt tegnsæt, dvs. et reglsæt der definere, hvilke tegn der må anvendes på feltet.

Reglsættet for tegnsæg er beskrevet i bilaget: bilag - tegnsæt til ajourførings-services.

De fremgår af en services dokumentation, hvorvidt den understøtter aktioner til vent eller ej.

Anchor
_afvigelser_fra_standard_livscyklus _afvigelser_fra_standard_livscyklus

Afvigelser fra standard livscyklus

Nogle få services til ajourføring afviger fra den standard livscyklus, beskrevet i de forrige afsnit. Her er der tale om services der anvender en slet-mange aktion (GCTP aktion S) i stedet for at initiere, validere, eller gemme. Hvis en service afviger fra standard livscyklussen fremgår det af servicens specifikation.

På en sådan service er der ingen session i servicens livscyklus. I stedet foretages kun ét kald, der samtidig udføre valideringer af forretnignsregler, og derefter sletter det data, der er specificeret i kaldes input. Hvis kaldet går godt, returneres en Afslut-kvittering, ligesom ved Gem-aktioner i standard livscyklus, og hvis kaldet fejler, returneres en Fejl-kvittering, ligesom ved Valider-aktioner i standard livscyklus.

Fordi der kun er ét kald, skal kaldet både indeholde nøgle-felter, som specificere de overordnede data der skal vedligeholdes, og input-felter der specificere de konkrete data der skal slettes.

Da en sådan service ikke har en session bærer correlation ID attributten ingen betydning, og et nyt ID vil blive dannet ved hvert kald.

Anchor
_adgangskontrol _adgangskontrol

3.3.4. Adgangskontrol

Adgang til de ajourførende services er kontrolleret af et særskilt regelsæt. Den normale adgangskontrol er beskrevet i bilag - adgangskontrol til ajourførings-services, og adgangskontrollen til data i vent er beskrevet i bilag - adgangskontrol til vent.

Anchor
_tegnsæt _tegnsæt

3.3.5. Tegnsæt

Ajourførings-services kan indeholde datafelter, hvori der indsendes tekster, f.eks. diverse adressefelter. Disse felter, hvor data typen er en tekststreng, er underlagt et generelt tegnsæt, dvs. et regelsæt der definere, hvilke tegn der må anvendes på feltet.

Regelsættet for tegnsæt er beskrevet i bilag - tegnsæt til ajourførings-services, som også indeholder en oversigt af de forskellige tegnsæt.

Anchor
_stavefrihed _stavefrihed

3.3.6. Stavefrihed

Stavefrihed betegner et tekstfelt, hvor systemet ikke skal påtvinge en formatering af store og små bogstaver. Dette ses oftes på felter til adresseringsnavne og adresselinjer, og understøttes ikke af alle tekstfelter.

Stavefrihed aktiveres ved at sætte en a1="SF" attribut på tekst feltet.

Anchor
_kort_om_sikkerhed _kort_om_sikkerhed

4. Kort om sikkerhed

...

Kravene til kommunikationslinier og til beskyttelse af lokalnet fremgår af de vilkår, der aftales med CPR-kontoret for brug af services.

Anchor
_

...

kendeordadgangskode _

...

kendeordadgangskode

4.2. Kendeord/

...

adgangskode

Det er myndighedens ansvar, at der anvendes kendeord/adgangskode som betragtes sikkert, og kun vanskeligt kan gættes af uvedkommende.

...

Yderligere information om vilkår vedrørende sikkerhed ved brug af CPR fås ved henvendelse til CPR-kontoret

v0v1.10.16-SNAPSHOT14