ServicehÄndbogen
Indholdsfortegnelse
- 1 1. Indledning
- 2 2. LĂŠsevejledning
- 3 3. CPR-services oversigt
- 3.1 3.1. Servicekategorisering
- 3.1.1 3.1.1. Sikkerhed
- 3.1.2 3.1.2. Andre muligheder
- 3.2 3.2. SĂžge-services
- 3.3 3.3. AjourfĂžrings-services
- 3.3.1 3.3.1. Indberetning af hĂŠndelser
- 3.3.2 3.3.2. Vedligeholdelse af CPR data
- 3.3.3 3.3.3. Livscyklus
- 3.3.4 3.3.4. Adgangskontrol
- 3.3.5 3.3.5. TegnsĂŠt
- 3.3.6 3.3.6. Stavefrihed
- 3.1 3.1. Servicekategorisering
- 4 4. Kort om sikkerhed
Bilagsoversigt
Liste over CPR sĂžge-services
Liste over CPR ajourfĂžrings-services
GCTP Standard version 2
Generelle fejlkoder
FĂŠlles nĂžgleregler
Generelle dataregler
IKKE OFFENTLIGT TILGĂNGELIG[Adgangskontrol til GCTP AjourfĂžrende Services]
IKKE OFFENTLIGT TILGĂNGELIG[Adgangskontrol til GCTP Vent]
Samspil mellem en selvbetjeningsserver og CPRs server
Etablering af en CPR SOAP klient (deprecated)
Liste over CPR SOAP services (deprecated)
TegnsĂŠt til ajourfĂžrings-services
1. Indledning
1.1. Brug af services
Med CPR-services tilbyder Indenrigsministeriets CPR-kontor andre myndigheder muligheden for at integrere CPR-Service i myndighedens eget sagsbehandlingssystem.
Det betyder, at myndigheden altid via deres egne systemer, med et minimum af indsats, har adgang til fuldt opdaterede CPR-data.
VilkÄr for brug af CPR-services kan fÄs ved henvendelse til CPR-kontoret.
1.2. Garanteret videreudvikling
Programmeringsindsatsen er minimeret til kommunikation med de CPR-services, CPR-kontoret har fÄet udviklet, og som lÞbende vedligeholdes i takt med videreudvikling af CPR-systemet.
1.3. GrĂŠnseflade
Brugen af services er baseret pÄ det regelsÊt, der er beskrevet i denne hÄndbog. Der benyttes endvidere et kommunikationsformat kaldet GCTP. Dette baserer sig i store trÊk pÄ XML-standarden.
Dokumentation af GCTP kommunikationsformatet kan findes i bilag - GCTP standard 2.0, til anvendelse i integration med CPR-systemets services.
1.4. Brug af CPR-data
Ved at fÞlge hÄndbogen kan myndigheden opbygge systemer med integration af CPR-services og dermed sÞge efter og hente informationer i CPR til brug i sagsbehandlingen.
1.5. AjourfĂžring af CPR-data
Hvis myndigheden i forbindelse med sagsbehandlingen skal ajourfÞre oplysningerne i CPR, kan dette ogsÄ ske direkte med CPR-services.
1.6. Sikring af data
Der er indlagt flere sikkerhedsniveauer i systemet, dels for at sikre at det er godkendte myndigheder og personer, der har adgang til services, dels for at opnÄ at oplysningerne i CPR er korrekte. Dette er gjort for at beskytte borgeren mod misbrug af de registrerede oplysninger og for at stille trovÊrdige oplysninger til rÄdighed for sagsbehandlingen.
1.7. Selvbetjening
Hvis servicen skal benyttes i forbindelse med borger-selvbetjening, gĂŠlder specielle vilkĂ„r. Disse vilkĂ„r kan fĂ„s ved henvendelse til CPR-kontoret. I bilag - samspil mellem selvbetjening og CPR er pĂ„ oversigtsniveau skitseret, hvordan samspillet mellem en selvbetjeningsserver og CPRâs server kan vĂŠre.
1.8. Betaling for adgang til oplysninger
CPR-kontoret har defineret et regelsÊt, som er implementeret pÄ de enkelte services, sÄledes at registreringerne og brugen af oplysningene overholder lovgivningens krav. Myndigheder, der anvender CPR-services, kan derfor basere brugen pÄ, at datakvaliteten lever op til kravene.
NÄr en bruger trÊkker oplysninger i CPR-systemet, betales der for ydelsen. Som udgangspunkt gÊlder samme faktureringsprincipper, uanset om oplysningerne hentes via det online CPR-system, som CPR-kontoret stiller til rÄdighed for brugerne, eller om oplysningerne hentes gennem myndighedens eget system via en CPR-service. Detaljerede oplysninger om vilkÄr for betaling for brug af CPR kan fÄs ved henvendelse til CPR-kontoret.
1.9. Der vil komme ĂŠndringer i services
CPR-kontoret tilpasser lÞbende CPR-services, sÄ de lever op til omverdenens krav. Det betyder, at myndigheden skal vÊre forberedt pÄ, at der kan komme Êndringer i de enkelte services. Disse vil blive annonceret i god tid, sÄ myndighedens system kan blive tilpasset til Êndringen.
For at gÞre det enkelt at indarbejde Êndringer anbefaler CPR- kontoret, at myndigheden konstruerer sit system med en dynamisk kobling til service-ydelserne. Derved kan systemet umiddelbart reagere korrekt pÄ en Êndring, og sÄledes at der skal foretages sÄ fÄ Êndringer i systemet som muligt, nÄr CPR-kontoret Êndrer i en service. Det vil sÄledes vÊre meget uhensigtsmÊssigt, at lave en statisk binding i sit system til datafelternes rÊkkefÞlge, eller til antallet af datafelter i en service. Systemet bÞr konstrueres Êndringsparat og dynamisk
1.10. SOAP services
SOAP lĂžsninger er deprecated og bliver ikke viderudviklet.
CPR-kontoret har udviklet nogle SOAP services, som kommunikerer i OIOXML. Der er tale om en maskine til maskine kommunikation, og der er derfor udelukkende virksomheder tilknyttet. Det er derfor ogsÄ virksomheden der logges. SOAP services anvender OCES-virksomhedscertifikater, der indeholder virksomhedens CVR nummer. En beskrivelse af hvilke krav og anbefalinger der er til udvikling af en SOAP klient, findes i bilag - etablering af en SOAP klient, og en oversigt over CPR-kontorets SOAP services findes i bilag - liste over SOAP services.
2. LĂŠsevejledning
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.
3. CPR-services oversigt
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.
Klienten har adgang til CPR-systemet via sĂžge eller ajourfĂžrings-services
SĂžge-services
SĂžge-services bruges til at hente oplysninger i CPR, som myndigheden har behov for i deres egne systemer.
AjourfĂžrings-services
AjourfÞrings-services anvendes, nÄr en myndighed vil opdatere oplysninger i CPR fra eget sagsbehandlingssystem.
3.1.1. Sikkerhed
Den enkelte myndighed har kun lov til at ajourfĂžre en delmĂŠngde af de oplysninger, der er registreret i CPR.
For bÄde ajourfÞrings- og sÞge-services gÊlder, at de brugere, der skal have adgang til CPR data, skal sikkerhedsgodkendes af CPR-kontoret.
Hvis man ikke har adgang til en service, som man mener, man bÞr have adgang til, skal CPR-kontoret kontaktes. Her kan man enten sÞrge for at brugeren fÄr adgang til sÞge-servicen eller give en forklaring pÄ, hvorfor brugeren ikke har adgang.
3.1.2. Andre muligheder
Hvis myndigheden har andre Þnsker til sÞge- eller ajourfÞrings-services, end dem der fremgÄr af denne hÄndbog, kan de eventuelt udvikles efter nÊrmere aftale med CPR-kontoret.
3.2. SĂžge-services
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.
3.2.1. Opslag med specifik nĂžgle
Denne form for service bruges til at fremskaffe oplysning om et specifikt objekt, f.eks. en person eller en vej, og kaldes ogsÄ for en opslags-service. Servicen kaldes med en nÞgle f.eks. personnummer, hvis der anvendes en service til at fremskaffe personoplysninger, eller myndighedskode og/eller vejkode, hvis der anvendes en service til at fremskaffe vejoplysninger. AfhÊngig af den valgte sÞge-service, returneres felter med de Þnskede oplysninger.
Man skal vÊre opmÊrksom pÄ, at ogsÄ felter uden data ligeledes returneres, hvis objektet har valgfrie felter der ikke er udfyldt i CPR-systemet.
EfterfĂžlgende er listet de typer af opslags-services, CPR kan levere, grupperet efter overordnet domĂŠne oplysningerne vedrĂžrer.
Services markeret med (H) indeholder historik, og behandler derfor bÄde aktuel/nuvÊrende og tidligere/historisk oplysninger. Services uden denne markering behandler kun aktuelle oplysninger.
Personopslag
Adresse (H)
Beskyttelse (H)
BopĂŠlssamling
Civilstand (H)
Delt bopĂŠl oplysninger
Familie, forĂŠldremyndighed, mor-/far-oplysninger
FlyttepÄbud
Folkekirkeforhold (H)
FÞdselsoplysninger, stilling, vÊrgemÄl
FĂždselsregistreringssted (H)
Kommunaleforhold
Kommunale notater
Kontaktadresse
Navne (H)
Oversigtsoplysninger for en person
Stamoplysninger for en person
Stamoplysninger for en person, begrĂŠnsede data
Separationer (H)
Statsborgerret (H)
Supplerende adresse
Tidligere personnumre
Valgoplysninger, valgadresse
Valgret
VĂŠrgeoplysninger
Geografiske opslag
Myndighed
Vej (H), Vejnotater, Distrikter, Vejhenvisningsregister.
Andet
AjourfÞringer som er sket pÄ en person i et givet tids-interval
Tekster pÄ diverse koder
Detaljer for hvilke data de enkelte sÞgeservices leverer fremgÄr af dokumentationen for den enkelte service.
For hver opslags-service myndigheden Ăžnsker at anvende, vil der blive udleveret en specifikation, hvor det vil vĂŠre muligt at se hvilke nĂžgler, der er nĂždvendige, samt se hvorledes sĂžgeresultatet vil blive leveret.
3.2.2. SĂžgning med kriterier
Denne form for service bruges til at fremskaffe nÞgler baseret pÄ generelle sÞgekriterier. Disse nÞgler kan dernÊst anvendes til de mere specifikke opslag, der er beskrevet i forrige sektion.
For hver sĂžge-service myndigheden Ăžnsker at anvende, vil der blive udleveret en specifikation, hvor det vil vĂŠre muligt at se hvilke sĂžgekriterier, der er nĂždvendige, samt se hvorledes sĂžgeresultatet vil blive leveret.
En oversigt over hvilke sÞge-services CPR kan levere, fremgÄr af bilag - liste over sÞge-services, og er specificeret pÄ dataniveau.
PersonsĂžgning
Find personoplysninger vha. sĂžgekriterier som bl.a. adresse, navn, eller fĂždselsdato.
Denne type af sĂžge-services bruges til at fremskaffe de Ăžnskede nĂžgler til identifikation af personoplysninger. Ud fra kendte oplysninger kaldes en valgt sĂžgning, som returnerer en liste af nĂžgler til oplysninger, der opfylder kriterierne.
EfterfĂžlgende er listet de services, CPR kan levere til sĂžgninger i personoplysninger:
AdressesĂžgning
Her findes personer ud fra deres nuvĂŠrende eller tidligere adresse, eventuelt kombineret med nuvĂŠrende navn og/eller kĂžn, samt i hvilken periode personen eventuelt har boet der, hvis det er en tidligere adresse.FĂždselsdatosĂžgning
Her findes personer ud fra fĂždselsdato, eventuelt kombineret med kĂžn, nuvĂŠrende eller tidligere navn, status, statsborgerret og fĂždselsregistreringssted.NavnesĂžgning:
Her findes personer ud fra nuvĂŠrende eller tidligere navn og kĂžn, eventuelt kombineret med alder, status, statsborgerret, bopĂŠlskommune og/eller landsdel.
SÞgekriterierne pÄ navn og adresse kan vÊre hele match (fulde navn, hele adresselinje), eller sÞgninger efter dele af felternes vÊrdi, f.eks. dele af fornavn eller vejnavn.
For alle ovennÊvnte sÞgninger gÊlder, at servicen returnerer en liste over personer, der opfylder de indtastede sÞgekriterier. Foruden personnummer vil listen ogsÄ indeholde navn, oplysning om navne-/adressebeskyttelse og status for de enkelte personer, samt nogle yderligere oplysninger afhÊngig af hvilken sÞgning, der er valgt, og om man har valgt standard oplysninger eller udvidede oplysninger.
Geografiske sĂžgninger
Find oplysninger om veje, distrikter eller myndigheder
Denne type af sĂžge-services bruges til at fremskaffe de Ăžnskede nĂžgler til identifikation af geografiske oplysninger. Ud fra kendte oplysninger kaldes en valgt sĂžgning, som returnerer en liste af nĂžgler til oplysninger, der opfylder kriterierne.
EfterfĂžlgende er listet de services, CPR kan levere til sĂžgninger i personoplysninger:
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 myndighedstype og navn, eller en del heraf.
HjĂŠlpesĂžgninger / Ăvrige sĂžgninger
Disse sĂžgninger bruges som hjĂŠlpesĂžgninger:
Oplysning om vejnavn ud fra kommunekode eller postnr. og vejkode eller del af vejnavn
Oplysning om postnr. og postdistriktnavn udfra postnr. eller del af postdistriktnavn
Oplysning om myndighedskode og myndighedsnavn ud fra myndighedskode eller del af myndighedsnavn
Detaljer for, hvilke data de enkelte lister indeholder, fremgÄr af bilag - liste over sÞge-services.
3.3. AjourfĂžrings-services
Der er 2 forskellige typer af ajourfÞ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. Denne vil returnere de oplysninger, der er nĂždvendige for at danne nĂžglen (f.eks. personnummer). Dette er specielt fremtrĂŠdende ved vedligeholdelse af 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.
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.
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 registreringer 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:
Ret oplysninger
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
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.
Slet 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.
Ret- og fortryd-markeringer dannes kun for datatyper der understÞtter historisk data. Data kan dog stadig rettes og fortrydes pÄ de datatyper der kun understÞtter aktuel data, dog uden disse markeringer bliver dannet.
EfterfĂžlgende er listet de typer af data, der kan vedligeholdes i CPR:
Persondata
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.
3.3.3. Livscyklus
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.
Som standard anvendes en service 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.
Disse stadier beskrives nĂŠrmere i de fĂžlgende underafsnit.
Initiering
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 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 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.
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 vedligeholde data i CPR-systemet.
Sessioner og correlation ID
Svaret pÄ en initiering inkluderer ogsÄ et ID der identificerer GCTP-sessionen, som er startet af dette kald. 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 indgÄr i alle GCTP-svar som ts
attributten pÄ CprServiceHeader
elementet, og skal ligeledes inkluderes pÄ alle 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...
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 (<Kvit r="Ok" v="0"/>
). Hvis data indeholder fejl, der bryder med en dataregel, vil servicen i stedet returnere en 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 fejlkoder, og der er en rÊkke fÊlles dataregler, som beskrevet i bilaget: bilag - generelle dataregler. Endvidere valideres tegnsÊt benyttet i tekst felter jvnf. TegnsÊt afsnittet.
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 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 Afslut-kvittering (<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.
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.
De fremgÄr af en services dokumentation, hvorvidt den understÞtter aktioner til vent eller ej.
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.
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.
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.
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.
4. Kort om sikkerhed
4.1. Kommunikationslinier
Kravene til kommunikationslinier og til beskyttelse af lokalnet fremgÄr af de vilkÄr, der aftales med CPR-kontoret for brug af services.
4.2. Kendeord/adgangskode
Det er myndighedens ansvar, at der anvendes kendeord/adgangskode som betragtes sikkert, og kun vanskeligt kan gĂŠttes af uvedkommende.
4.3. OCES virksomhedscertifikat
Det er myndighedens/virksomhedens ansvar, at spÊrre for deres certifikat sÄfremt denne har en mistanke om, at certifikatet er kommet i uvedkommendes hÊnder.
4.4. Sikkerhedslogning
Alle sÞgninger, opslag og ajourfÞringer registreres i CPR systemet pÄ den enkelte brugers personkode. Denne registrering danner grundlag for udskrift i tilfÊlde, hvor der er mistanke om misbrug af adgangen til CPR.
4.5. Yderligere sikkerhedsvilkÄr
Yderligere information om vilkÄr vedrÞrende sikkerhed ved brug af CPR fÄs ved henvendelse til CPR-kontoret
v1.0.12