Dataflow mellem DFDG og aftagere
2023-06-08: SIDEN SKAL OPDATERES IFM overgang fra WSRM til webservicebeskeder
I følgende afsnit beskrives informationsudvekslingerne mellem Jobcenter, Ydelsescenter og A-Kasse.
Generelt kobles applikationer sammen i "Hub-and-spoke" løsningsmønstret, med DFDG som "Hub".
Generelt løsningsmønster for aftagere af DFDG
DFDG indeholder fælles data i beskæftigelsesindsatsen. Følgende figur viser en overordnet systemoversigt, med de aktører, der anvender de fælles data via de udbudte services. A-kasserne skal anvende en del af de eksisterende services ligesom der løbende udvikles en række nye services..
På figuren nedenfor vises den logiske struktur mellem de enkelte systemer, der udgør IT understøttelsen af ser-viceaftagerne. Systemerne inden for den blå periferi er AMS IT systemer. Kommunikationsformen i DFDG er efter ”hub and spoke” arkitektur mønsteret. Serviceaftagerne kommunikerer alene med DFDG’s servicelag, og er således ikke eksponeret over for de øvrige systemer.
Tegning skal opdateres..
I de følgende afsnit gennemgås de generelle kommunikationsmønstre der anvendes imod DFDG. De emner/mønstre der gennemgås er:
Dataflow mellem serviceudbyder og aftagere
Fra aftager til udbyder
Fra udbyder til aftager
Sikkerhed
Kodelister
Fejlhåndtering
Dataflow mellem serviceudbyder og aftagere
Kommunikationen mellem webservice-aftagerne og DFDG understøtter grundlæggende to dataflow retninger:
Hændelser eller statusændring fra aftager til DFDG via WS
Hændelser eller statusændring fra DFDG til aftager via WSRM
Hændelser eller statusændring fra aftager til DFDG via WS
Det grundlæggende mønster er at aftager registrerer alle relevante hændelser og statusskift online i DFDG så snart de opstår i forbindelse med sagsbehandling eller lignende. Hvis registreringen ikke kan foretages i DFDG bør dette enten meddeles sagsbehandleren og ændringen rulles tilbage i eget system. Alternativt forsøges registreringen gennemført igen senere i DFDG indtil det lykkes.
For hver registrering returneres et ID (en GUID) der identificerer registreringen.
Når en aftager skal sende en meddelelse sker det ved at aftageren kalder en af DFDG’s webservicemetoder, der som input tager en meddelelse i SOAP/XML-format. Webservicen checker, at formatet af meddelelsen er korrekt i forhold til det XML-Schema, der er defineret for meddelelsestypen. Hvis dette check passeres, checkesom dataindholdet i meddelelsen er validt i forhold til den ønskede forretningsoperation. Herefter udføres forretningsoperationen og GUID returneres til kalder.
Hændelser eller statusændring fra DFDG til aftager via WSRM
Når der er registreret en hændelse eller et statusskift i DFDG udsendes en notifikation til relevante aftagere. Hændelser opsamles således ikke pr. dag. Dette betyder derfor også som udgangspunkt at hændelser f.eks. sygdom eller fravær udsendes når det registreres og ikke først når det indtræffer. Aftager skal altså som udgangspunkt selv stå for dette bogholderi.
Notifikationen sendes via webserviceprotokol, der tager afsæt i WSRM – Webservice Reliable Messaging standarden. Køen er implementeret sådan at aftager selv skal tage initiativ til at tømme køen (polle), f.eks. hvert 10. minut. Aftager modtager en liste af webservice endpoints og et operationsnavn, typisk af formen GetXXX, hvor XXX er navnet på en forretningshændelse. Operationen returnerer en liste af hændelsesobjekter af en specifik type. Samlet returneres der pt. højest 500 objekter ad gangen, uagtet hvor mange hændelser, der ligger i køen.
Hvert objekt er forsynet med en EventDate og den modtagne liste af objekter skal sorteres så ældste objekt behandles først. Denne sortering er meget vigtig da der sagtens kan modtages flere hændelser for samme person.
Ovenstående viser sekvensen af operationer, der skal til for at tømme køen. Hændelser i f.eks. Jobnet, Arbejdsmarkedsportalen eller fra en A-kasse, modtages af DFDG og lægges på en kø som en XML besked. Herefter starter ovenstående sekvens.
Når aftageren har hentet alle meddelelser, foretager aftageren derefter et afsluttende kald, som bekræftelse på modtagelse. Hvis DFDG også har registreret alle meddelelser som korrekt afhentet, vil DFDG herefter fjerne de meddelelser, der netop er hentet fra køen.
Hvis der sker fejl under afhentning, kan aftager afbryde under vejs. Hvis der afbrydes under vejs vil beskederne fortsat ligge i køen indtil næste gang aftager forsøger at hente dem.
Hændelsesoversigt
Se de enkelte WSRM hændelser her: