Forretningsservices (Webservices)

STAR udstiller services (SOAP og REST webservices) fra en række systemer og dette område indeholder dokumentation af dem. 

Hver service består af:

• En oversigtsside med en liste med hvornår de forskellige versioner er ind - og udfaset og links til alle sider, som nævner denne service
• En forretningsmæssig side i forhold serviceversioner og release, der bl.a. kan beskriver forretningsindhold i service, oversigt over metoder, forretningsbeskrivelse og -regler til metoder, beskrivelse af WSRM  
• En side for hver version af servicen (underordnet siden med beskrivelsen)
  • For SOAP service, omfatter siden indholdet af den konkrete WSDL fil - bemærk at denne side er automatisk genereret ud fra WSDL-filen
  • For REST service, omfatter siden indholdet af den konkrete JSON fil samt link til Swagger for den pågældende service
• En kodeliste service til det pågældende område
  Bemærk, at alle DFDG kodelister ligger under sit eget menupunkt (CodeLists).  

Kataloget over service er opbygget ud fra den kommende struktur, hvor service udstilles i forretningsområder. De kommende forretningsområder kan ses i nedenstående figur 

Den enkelte kataloger er: 

• Activity services (Ikke etableret, se DFDG)
• CompanyActivity services (Ikke etableret, se DFDG og VITAS)
• Engagement services (Ikke etableret, se DFDG)
• JobSearch Services
• PersonCommunication  services(Ikke etableret, se DFDG)
• Taxonomy Services
• Visitation services (Ikke etableret, se DFDG)

Derudover ligger der de eksisterende kataloger 

Webservice kataloger

Webservices fra et system kaldes et Webservice katalog. Et sådant katalog har egen fysisk lokation (URL). Her eksempler på kataloger:

Kontakt SF for at få adgang til de fysiske URL'er på tværs af miljøer.

/wiki/spaces/CITY/pages/75644492  (lukket område, kontakt SF).

Services

Gamle versioner af services bliver flyttet til arkiv her /wiki/spaces/GI/pages/75859158

Swagger

Således aflæses i Swagger om et felt er "nullable": 

Man kan se, at et felt er "nulllable" ved at konstatere, at feltet ikke er påkrævet. Påkrævede felter har en stjerne ud for sig i Swagger-UI. 

Eksempel

forsikringsgrad i DagpengeService.getDagpenge er "nullable", da der ikke er en stjerne ud for "forsikringsgrad" i modsætning til fx stjernen ud for "udbetalingsmaaned":

CPR-skiftere

Nye DFDG forretningsdomæner

For de nye DFDG forretningsdomæner gælder:

• I nye DFDG forretningsdomæner flyttes data (pegepinden til data) til at være borgers aktuelle cpr,nr, når borger skifter cpr.nr
• I nye DFDG forretningsdomæner kan der alene registreres og opdateres data ved kald med borgers aktuelle cpr.nr
• Fra 2023-3:
  • Ved opstart af nye DFDG forretningsdomæner indlæser STAR data fra den ældre del af DFDG i det nye forretningsdomæer uanset borgers CPR-status (bl.a. af hensyn til aflevering af data til Rigsarkivet) og af hensyn til bl.a. jobcentres og a-kassers behov for at kunne læse historiske data om en borger eller et medlem)
  • Serviceaftagere kan hente/læse data i de nye forretningsdomæner uanset om der kaldes med borgers aktuelle eller historisk cpr nr - også hvis borger er død.
  • For de allerede opstartede DFDG forretningsdomæner foretages efterkonvertering / indlæsning af data for de CPR-statusser som i første indlæsning blev udeladt, således at databestanden er komplet.
  • Ved registreringskald til nye DFDG forretningsdomæner med ikke-aktuelt CPR nummer kaster DFDG (ny) fejlkode med oplysning om at borgers aktuelle cpr nr skal anvendes (frem for nuværende brug af fejlkode om at cpr nr ikke findes) - fejlkode 9460 - "Det er ikke tilladt at registrere oplysninger på borgers ikke-aktuelle personnummer"
• Fra 2023-4
  • I servicen Virksomhedsindsats.PersonStatusService (version 1). GetPersonStatus er der fra 2023-4 releasen foretaget ændring i ansvarligJobcenterKode - Feltet vil fremover bestå af myndighedskode og organisationstype.

DFDG (classic)

For den ældre del af DFDG, der ikke er omlagt til nye DFDG forretningsdomæner, gælder:

• I DFDG (classic) forbliver data (som hidtil) på det cpr.nr., hvor registreringen oprindeligt er sket
• Fra DFDG (classic) kan data udlæses på det cpr.nr hvor registreringen oprindeligt er sket
• Det er muligt for aftagerne at opdatere allerede registrerede data i DFDG (classic) ved kald med ikke aktuelt cpr nr fsva data registreret på det pågældende cpr.nr, det gælder fx afslutning af allerede registreret fravær og lukning af borgers kontaktgruppe
• Ved registrering / opdatering af data med brug af ikke aktuelt cpr nr., dannes afledte WSRM'er / webservicebeskeder på dette ikke-aktuelle cpr.nr
• For SOAP services, som stiller igennem til REST services i en overgangsperiode (såkaldte converters), vil det ikke være muligt at opdatere på gammelt personnummer, da data bor i de nye forretningsdomæner, hvor alene aktuelt cpr nr kan anvendes ved registrering / opdatering

Undersider