{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Introduktion","type":"text"}]},{"type":"paragraph","content":[{"text":"Som led i den løbende modernisering af CPR-systemet konverteres CPR Services til en Java platform, hvilket medfører ","type":"text"},{"text":"mindre","type":"text","marks":[{"type":"underline"}]},{"text":" tilpasninger og ændringer for opslags-, søge- og læseservices. ","type":"text"}]},{"type":"paragraph","content":[{"text":"For CPR’s Ajourføringsservices (indberetning-/skriveservices) henvises specifikt til ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://cprservicedesk.atlassian.net/wiki/spaces/EXMYN"}},{"text":" Adgang til siden gives til eksterne anvendere efter anmodning via CPRs servicedesk ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://cpr.dk/kunder/support/link-til-cpr-servicedesk"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Moderniserede versioner af services vil releases løbende.","type":"text"}]},{"type":"paragraph","content":[{"text":"I en overgangsperiode vil både den “gamle” service og den “nye” service være tilgængelige.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"},"outline":{"value":"true"},"absoluteUrl":{"value":"true"}},"macroMetadata":{"macroId":{"value":"79738669e4bd0f03026d97adcc86f056"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"8748e1a5-aa02-49c5-a334-48024637477b"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Hvad er nyt?","type":"text"}]},{"type":"paragraph","content":[{"text":"De moderniserede opslags-, søge- og læseservices indeholder få mindre ændringer i den overordnede GCTP protokol og i de enkelte services.","type":"text"}]},{"type":"paragraph","content":[{"text":"I hovedsagen ændres følgende i GCTP protokollen:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GCTP behandles som XML, og derfor skal både GCTP requests og responses være velformet XML dokumenter jvf. ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.w3.org/TR/xml/#sec-well-formed"}},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GCTP requests valideres for at sikre, at request indholdet er gyldigt jvf. GCTP XSD skemaet.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Formålet med ændringerne er at sikre, at både CPR's egne systemer samt andre fagsystemer, kan benytte standardiserede XML værktøjer og tredjepartsbiblioteker, når der integreres med CPR Services.","type":"text"}]},{"type":"paragraph","content":[{"text":"Læs eventuelt også afsnittet ","type":"text"},{"text":"Ændringer i version 2.0 services","type":"text","marks":[{"type":"link","attrs":{"href":"#Ændringer-i-version-2.0-services"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Udrulningsplan","type":"text"}]},{"type":"paragraph","content":[{"text":"Datoer for ændringer i de enkelte services fremgår af ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://cprservicedesk.atlassian.net/wiki/spaces/CPR/pages/2201681960"}},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Scope","type":"text"}]},{"type":"paragraph","content":[{"text":"Kun CPR’s opslags-, søge- og læseservices er i scope.","type":"text"}]},{"type":"paragraph","content":[{"text":"For CPR’s Ajourføringsservices (indberetning-/skriveservices) henvises specifikt til ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://cprservicedesk.atlassian.net/wiki/spaces/EXMYN"}},{"text":" . Adgang til siden gives til eksterne anvendere efter anmodning via CPRs servicedesk ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://cpr.dk/kunder/support/link-til-cpr-servicedesk"}},{"text":" .","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Lokale tilpasninger og forberedelse","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Anvendertest og anvenders risikomitigering","type":"text"}]},{"type":"paragraph","content":[{"text":"Anvendere af CPR’s opslags-, søge- og læseservices er ","type":"text"},{"text":"selv ansvarlig for at vurdere risikoen","type":"text","marks":[{"type":"strong"}]},{"text":" for egen myndighed eller virksomhed.","type":"text"}]},{"type":"paragraph","content":[{"text":"CPR’s test og udrulning er baseret på, at services ","type":"text"},{"text":"funktionelt","type":"text","marks":[{"type":"underline"}]},{"text":" releases 1:1 i forhold til “gamle” services.","type":"text"}]},{"type":"paragraph","content":[{"text":"CPR’s vurdering af risikoen for anvenderne er således for nuværende, at risikoen for anvendere er meget lav. Det er imidlertid også baseret på en forventning om, at anvendernes integration til CPR’s services er baseret på tidssvarende rammeværk. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"XML-parser","type":"text"}]},{"type":"paragraph","content":[{"text":"Den klare forventning er, at anvendere, som anvender tidssvarende og standardiserede XML-parsere, ikke vil have behov for at foretage lokale tilpasninger.","type":"text"}]},{"type":"paragraph","content":[{"text":"Anvendere, som anvender en egen udviklet XML-parser, bør foretage en grundig test. Ved modtagelse af ikke valid XML vil GCTP services svar tilbage med følgende struktur i responsen:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Hvilke services anvender I?","type":"text"}]},{"type":"paragraph","content":[{"text":"Anvendere af CPR’s GCTP services bør undersøge præcist, hvilke services som anvendes.","type":"text"}]},{"type":"paragraph","content":[{"text":"Derved kan du som anvender hurtigt identificere, hvornår en service ændres og hvornår ","type":"text"},{"text":"overgangsperioden","type":"text","marks":[{"type":"strong"}]},{"text":" slutter, og således vinduet for lokale test, jf. ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://cprservicedesk.atlassian.net/wiki/spaces/CPR/pages/2201681960"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overgang til moderniserede CPR Services","type":"text"}]},{"type":"paragraph","content":[{"text":"Transitionen til moderniserede services foretages med fokus på ","type":"text"},{"text":"risikomitigering.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Moderniserede services vil benytte en ","type":"text"},{"text":"ny GCTP protokolversion - version 2.0. ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Kald, der i dag modtages med version 1.0 eller uden versionsnummer i ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" tagget, vil fortsat betjenes af den “gamle” service i servicens overgangsperiode.","type":"text"}]},{"type":"paragraph","content":[{"text":"Når overgangsperioden er udløbet, vil den gamle serviceversion blive lukket, og alle kald til den pågældende service vil herefter betjenes af en moderniseret service - uanset versionnummer i ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" tagget.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Default service","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Før overgangsperiode (før release): ","type":"text","marks":[{"type":"underline"}]},{"text":"Default service er ","type":"text"},{"text":"gamle service.","type":"text","marks":[{"type":"underline"}]},{"text":" Det er ","type":"text"},{"text":"ikke","type":"text","marks":[{"type":"underline"}]},{"text":" muligt at benytte version 2.0 service.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Overgangsperioden:","type":"text","marks":[{"type":"underline"}]},{"text":" Default service er ","type":"text"},{"text":"gamle service","type":"text","marks":[{"type":"underline"}]},{"text":". Det er muligt at benytte version 2.0 service.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Udfasningsperiode","type":"text","marks":[{"type":"underline"}]},{"text":": Default service er ","type":"text"},{"text":"ny 2.0 service","type":"text","marks":[{"type":"underline"}]},{"text":". Det er ikke muligt at benytte gamle service. CPR forbeholder sig ret til uden varsel rulle tilbage til “overgangsperioden”, hvor gamle service er default.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Efter udfasningsperioden","type":"text","marks":[{"type":"underline"}]},{"text":": Default service er ny 2.0 service. Det er ","type":"text"},{"text":"ikke","type":"text","marks":[{"type":"underline"}]},{"text":" muligt at benytte gamle service, og der kan ikke rulles tilbage til gamle service.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Bemærk: CPR kan og vil ","type":"text","marks":[{"type":"em"}]},{"text":"efter overgangsfasen","type":"text","marks":[{"type":"underline"},{"type":"em"}]},{"text":" uden varsel og kommunikation ændre på den default service, som betjener servicekald uden versionsnummer i tagget.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Anvenders lokale tilpasninger skal derfor tage højde for, at ","type":"text","marks":[{"type":"em"}]},{"text":"default service kan ændres uden varsel ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"efter overgangsperioden.","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Særlige bemærkninger vedr. flere GCTP services i et request","type":"text"}]},{"type":"paragraph","content":[{"text":"Hvis et ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" request indeholder kald til flere GCTP services skal samtlige services i requestet være tilgængelige som version 2.0 services (jvf. ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://cprservicedesk.atlassian.net/wiki/spaces/CPR/pages/2201681960"}},{"text":") for at version 2.0 services bliver kaldt. Der kaldes aldrig både version 1.0 og 2.0 services for at fuldføre et request. Hvis en service i requestet er kun tilgængelig som version 1.0 service vil samtlige services i requestet blive håndteret af version 1.0 services. Denne regel gælder også selvom overgangsperioden/udfasningsperioden for en eller flere services i requestet er afsluttet.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Anvendertest","type":"text"}]},{"type":"paragraph","content":[{"text":"I overgangsperioden vil anvendere have mulighed for at teste integrationen mod moderniserede services. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CPR’s test","type":"text"}]},{"type":"paragraph","content":[{"text":"Inden en moderniseret service bliver releaset, er der afviklet en maskinel sammenligningstest mellem gamle og moderniserede services, der identificerer eventuelle forskel i responsen.","type":"text"}]},{"type":"paragraph","content":[{"text":"CPR’s klient CPRWeb ændres løbende til at benytte moderniserede services. Hvis der mod forventning er fejl i servicens forretningslogik eller tilsvarende, vil det således med høj sandsynlighed blive konstateret gennem anvendelsen af CPRWeb.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Værktøjer til test af ændringer i CPR Services","type":"text"}]},{"type":"paragraph","content":[{"text":"Følgende værktøjer kan anvendes til at hjælpe med overgangen til moderniserede services (version >= 2.0).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"GCTP 2.0 XSD skema","type":"text"}]},{"type":"paragraph","content":[{"text":"Skemaer for GCTP version 2.0 kan anvendes til at validere GCTP requests. ","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"01d2f042-069b-4e0e-a667-5fa84e1d6740","collection":"contentId-2200829957","type":"file"}},{"type":"media","attrs":{"id":"3ae5a940-6278-4b5a-a426-d04f9518524a","collection":"contentId-2200829957","type":"file"}}]},{"type":"paragraph","content":[{"text":"Filer sidst opdateret 25. januar 2024 kl. 14.48","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request validering i DEMO-miljøet (CPR’s kundevendte testmiljø)","type":"text"}]},{"type":"paragraph","content":[{"text":"Kunder kan med fordel kalde GCTP valideringsendpointet i DEMO miljøet for at teste egen integration med de moderniserede services. URL til endpointet er ","type":"text"},{"text":"https://gctp-demo.cpr.dk/cpr-online-gctp/validate","type":"text","marks":[{"type":"link","attrs":{"href":"https://gctp-demo.cpr.dk/cpr-online-gctp/validate"}}]},{"text":". Endpointet kan kaldes uden session (login).","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Eksempel gyldigt request/respons","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"De fleste værdier i requestet som fx. ","type":"text"},{"text":"System","type":"text","marks":[{"type":"code"}]},{"text":" og ","type":"text"},{"text":"Service","type":"text","marks":[{"type":"code"}]},{"text":" har ingen betydning, hvor det alene angår validering. Requestet skal blot overholde GCTP skemaet.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"curl -i https://gctp-demo.cpr.dk/cpr-online-gctp/validate -d '\n\n\n \n \n \n \n \n \n \n \n \n \n \n\n'","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"GCTP requestet er gyldigt, og der returneres et ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element i svaret:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"HTTP/1.1 200 \nContent-Type: text/xml;charset=ISO-8859-1\nContent-Length: 447\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Eksempel på ugyldig request/respons","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Eksempel hvor requestet ikke overholder XML-standarden: ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" i stedet for ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"curl -i https://gctp-demo.cpr.dk/cpr-online-gctp/validate -d '\n\n\n \n \n \n \n \n \n \n \n \n \n \n\n'","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"GCTP request er ugyldig, og der returneres ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" elementet i response, hvor attributten ","type":"text"},{"text":"v","type":"text","marks":[{"type":"code"}]},{"text":" har værdi ","type":"text"},{"text":"999","type":"text","marks":[{"type":"code"}]},{"text":" og attributten ","type":"text"},{"text":"t","type":"text","marks":[{"type":"code"}]},{"text":" 's værdi er en beskrivelse af valideringsfejlen.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"HTTP/1.1 200 \nContent-Type: text/xml;charset=ISO-8859-1\nContent-Length: 298\n\n\n\n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Ændringer i version 2.0 services","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Opbygning af restart (REST) nøgleværdier og SEARCH_ID feltværdier","type":"text"}]},{"type":"paragraph","content":[{"text":"Restartnøgler benyttes i de søgeservices, der understøtter paginering af responsdata. Restartnøgler bruges i efterfølgende forespørgsler for at hente den næste side data.","type":"text"}]},{"type":"paragraph","content":[{"text":"SEARCH_ID feltværdier benyttes i visse søgeservices for at indikere, at resultatet af en søgning er blevet gemt. Efterfølgende kald til servicen med en restartnøgle, der indeholder SEARCH_ID feltværdien, vil hente data fra den gemte søgning.","type":"text"}]},{"type":"paragraph","content":[{"text":"Opbygning af REST nøgleværdier i de version 2.0 GCTP services, der indeholder SEARCH_ID feltværdier, kan afvige fra opbygningenaf REST nøgleværdier i version 1.0 services.","type":"text"}]},{"type":"paragraph","content":[{"text":"Version 1.0 service eksempel:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n \n \n \n \n \n \n \n

\n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Version 2.0 service eksempel:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n \n \n \n \n \n \n \n

\n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"De CPR Services integrationer, der overfører REST nøgleværdien uændret fra responsdata til et efterfølgende forespørgsler forventes ikke at blive påvirket af denne ændring.","type":"text"}]}],"version":1}

Browser not supported