Integration SF1612 - STAR DFDG - Modtag ledighed og sygemelding status Integrationsbeskrivelse - version 2.0.1 Kommunernes Datafællesskab - KDF
Versionshistorik Relevans Dato Initialer Version Kommentarer 2015-08-31 EHE 2.0.0 Teknisk beskrivelse indarbejdet mht. beskedfordelerspecifikke afsnit. 2016-05-28 JJN 2.0.1 Tilretning vedrørende anvendelse af kommekoder og kaldsmønster. Besked hentes i lister i forhold til type, og ikke enkeltvis fra STAR Sygemelding hentes for alle kommuner på en gang og ledighedstil/afmeldinger hentes for hver kommune for sig. - Let tilretning af beskedkuvert omkring "tilladte modtager" - Tilretning af sequence diagram og persistering i kapitel 4 Indsat UUID værdier i afsnit 3.1.3.1, 3.2.3.1.2, 3.2.3.1.3 og 3.2.3.1.4. Værdiliste til abonnementer på beskeder fra Beskedfordeler er præciseret. Forudsætninger og vilkår ændret: - Kapitel 1.5 - Kapitel 2.1.3 relevant for KSD - Kapitel 2.2.3 relevant for KY - Kapitel 2.3.3 relevant for STAR - Kapitel 4.2.2 Relevant for Serviceplatformen Referencer Ref Titel Kommentarer [SPref] Bilag 7B Ydelser og servicemål for Serviceplatformen [BFref] [Afklaring/KDF indsæt reference dokumentation af servicemål for BF] Endnu ikke udarbejdet [SIKKERHED] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v.0.4.3 [STS-Sikkerhed] [VBF] Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link https://sharekomm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx Se vilkår Underbilag 2N - Vilkår for integration til støttesystemet Beskedfordeler version 2.0 på nedenstående link [SF1460_A] https://share-komm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx Modtag besked. Se integrationsbeskrivelse for SF1460_A, som er tilgængelig her: https://share-komm.kombit.dk/p089/integrationsbeskrivelser/ Beskrivelse for Beskedfordeleren [SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse for Beskedfordeleren KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 46
[SF1460_C] [SF1460_D] [WSDL-EXT] Aflever besked Se integrationsbeskrivelse for SF1460_C, som er tilgængelig her: https://share-komm.kombit.dk/p089/integrationsbeskrivelser/ Modtag besked via pull. Se integrationsbeskrivelse for SF1460_D, som er tilgængelig her: https://share-komm.kombit.dk/p089/integrationsbeskrivelser/ Integrationsbeskrivelsen refererer til SF1612 Bilag 20150901.zip som indeholder WSDL af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link https://share-komm.kombit.dk/p089/integrationsbeskrivelser/ Beskrivelse for Beskedfordeleren Beskrivelse for Beskedfordeleren [GVF] Reference til Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes: Generelle vilkår og forudsætninger KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 46
Indholdsfortegnelse 1 Overordnet beskrivelse... 5 1.2 Overordnet forretningsflow i integrationen... 5 1.3 Servicebetingelser for den samlede integration... 6 1.4 Teststrategi... 8 1.5 Tilslutning til snitfalde... 9 2 Kontekst for integrationsparter... 12 2.1 Kontekst for KSD... 12 2.2 Kontekst for KY... 13 2.3 Kontekst for STAR... 15 3 Specifikation for integrationsparter... 17 3.1 Specifikation af endpoints for KY og KSD... 17 3.2 Specifikation af endpoints for SP som afsendende beskedagent... 20 3.3 Specifikation af endpoints for STAR... 24 4 Beskrivelse for integrationsplatforme... 40 4.1 Oversigt over integrationsflows... 40 4.2 Beskrivelse for Serviceplatformen... 40 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 46
1 Overordnet beskrivelse 1.1 Integrationens formål og beskrivelse Formål Servicen har til formål at levere ændringer af til- og afmeldinger for ledighed samt ændringer i sygefravær for personer til Fagsystemerne Beskrivelse Serviceplatformen henter med korte periodiske intervaller meddelelser fra Det Fælles Datagrundlag DFDG i Styrelsen for Arbejdsmarked og Rekruttering (STAR). Serviceplatformen videreformidler meddelelser borgere, som fagsystemerne har oprettet abonnement på. Følgende meddelelser modtages: - Til- og afmeldinger for ledighed, som STAR modtager fra bl.a. jobcentre og Jobnet. Disse data udstilles til Kommunernes Ydelsessystem (KY) - Sygefraværsændringer for personer, som anvendes af Kommunernes SygeDagpengesystem (KSD), hvor der forudgående har været rapporteret status for en fraværssag For hvert meddelelseskategori læser, persisterer og videresender Serviceplatformen beskeder fra STAR/DFDG til beskedfordeleren. Serviceplatformen lukker efterfølgende transaktionen og kvitterer over for STAR/DFDG når alle hændelser er hentet og videresendt. Fagsystemerne modtager meddelelser for de borger, som der abonneres på. Meddelelser, som der ikke abonneres på af et fagsystem, ignoreres i beskedfordelingen, og ligges på en dead letter queue. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 46
STAR/DFDG Serviceplatformen Beskedfordeler Fagsystem(n) Integrationsbeskrivelse 1.2 Overordnet forretningsflow i integrationen Jf. Modtag sygestatus- og ledighedshændelser Modtag besked Distribuer besked Initier kommunikati on Hent beskeder fra Kø og afsend Afslut kommunikati on Udstil køstatus Udstil beskeder Bekræft afslutning Figur 1 nedenfor indgår følgende forretningsflow i integrationen. En timerstyret proces på serviceplatformen initierer en proces, hvor der for hver kommune oprettes en kommunikationstransaktion med STAR/DFDG til at hente ledighed til og afmelding. Derudover oprettes en kommunikationstransaktion til at hente sygefraværsændringer for alle kommuner på en gang. For hvert hændelsesområde læser, persisterer og videresender Serviceplatformen beskeder fra køerne hos STAR/DFDG til beskedfordeleren. Hændelsesområderne er: o Ændringer i sygefraværsstatus. o Tilmelding af ledighed. o Afmelding af ledighed. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 46
STAR/DFDG Serviceplatformen Beskedfordeler Fagsystem(n) Integrationsbeskrivelse Serviceplatformen lukker transaktionen og kvitterer over for STAR/DFDG når alle hændelser er hentet og videresendt. Fagsystemerne KSD og KY modtager førnævnte beskeder via abonnement på beskedfordeleren. Der skal oprettes abonnement for hver af de tre hændelsesområder. Modtag sygestatus- og ledighedshændelser Modtag besked Distribuer besked Initier kommunikati on Hent beskeder fra Kø og afsend Afslut kommunikati on Udstil køstatus Udstil beskeder Bekræft afslutning Figur 1 - Overordnet forretningsflow 1.3 Servicebetingelser for den samlede integration 1.3.1 Servicemål Parameter Modtag sygestatus og ledighedshændelser KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 46
Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Beskedfordeler driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [BFref]. [Afklaring/KDF: Åbningstid for eksternt system kendes ikke] [Afklaring/KDF: Åbningstid for fagsystem kendes ikke] Svartid Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Svartid for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Svartid for eksternt system kendes ikke] [Afklaring/KDF: Svartid for fagsystem kendes ikke] Tilgængelighed Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Tilgængelighed for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] [Afklaring/KDF: Tilgængelighed for fagsystem kendes ikke] Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Spidsbelastning for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Spidsbelastningsperioder for eksternt system kendes ikke] [Afklaring/KDF: Spidsbelastningsperioder for fagsystem kendes ikke] Servicevinduer Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 46
Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services for Serviceplatformen: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. Servicevinduer for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] [Afklaring/KDF: Servicevinduer for fagsystem kendes ikke] 1.3.2 Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til datafaellesskab@kombit.dk. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: https://share-komm.kombit.dk/p089/ Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere. 1.3.2.1 Incident Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] 1.3.2.2 Problem Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] 1.3.2.3 Change Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] 1.3.3 Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 46
1.4 Teststrategi 1.4.1 Test i forbindelse med udvikling Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.4.1.1 Testfaciliteter og testmiljø Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/STAR: hvilke testfaciliteter kan benyttes] 1.4.1.2 Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/STAR: hvilke testdata kan benyttes] 1.4.2 Test i forbindelse med produktionssætning I forbindelse med produktionssætning er det omfattet af gældende aftale med Systematic, at der gennemføres følgende 3 prøver: Overtagelsesprøve Idriftsættelsesprøve Driftsprøve Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/STAR: Aftale vedr. produktionssætning udestår] 1.5 Tilslutning til snitfalde For at kunne anvende snitfalden er der en række vilkår og forudsætninger, som skal være opfyldt af den integrationspart, der skal tilsluttes. Ved integrationspart skal forstås anvendersystemer, kildesystem osv. Disse vilkår og forudsætninger er opdelt i en generelle vilkår og forudsætninger, som gælder på tværs af snitfladerne og i specifikke vilkår og forudsætninger for tilslutning til selve snitfladen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 46
De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter, der skal udføres som forudsætning for tilslutning af en integrationspart, er beskrevet for hver enkelt integrationspart i kapitel 2 1.5.1 Køreplan for Implementering Nedenstående diagram viser køreplanen for udrulningen, som anvendersystem inden for KOM- BITs rammearkitektur under monopolbrudsprojektet følger. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge den faktiske implementeringsplan. Aktiviteter, som er forudsætninger og betingelser i forbindelse med ibrugtagning af en snitflade, som følge af en udrulning af et anvendersystem, vil referere til den fase, den hensigtsmæssigt kan udføres i. Serviceplatformen: Ved idriftsættelse af en snitflade er alle aktiviteter afsluttet, og snitfladen er klar til anvendelse. Eksternt system: Alle aktiviteter i forhold til serviceplatformen er afsluttet, men der kan være yderligere aktiviteter i forbindelse med tilslutning af et anvendersystem eller en kommune i forhold til kildesystemet. Anvender-/fagsystem og kommune: Ved tilslutning af et anvendersystem og/eller en kommune, er der en række aktiviteter op til idriftsættelse, dels af aftalemæssig karakter, og dels også af konfigurationsmæssig karakter, som skal udføres. Er der aktiviteter, som medfører konfiguration på Serviceplatformen, vil dette ske i forbindelse med leverandørens oprettelse af serviceaftalen for kommunen. 1.5.2 Særlige vilkår [Til brug for servicekataloget på serviceplatformen er der behov for kort at beskrive vilkår der er specifikke for den pågældende integration. Det vil typisk være indgåelse af aftale mellem anvendersystem og kildesystem. Aftale inde for rammearkitekturen skal ikke beskrives. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 46
Er der ingen specifikke vilkår for integrationen anvendes nedenstående tekst. Vilkår for servicen Der er ingen specielle vilkår for brug af nærværende service ud over de generelle vilkår, der er beskrevet under vilkår for hhv. leverandører og kommuner.] 1.5.3 Supplerende information om tilslutning Intet. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 46
2 Kontekst for integrationsparter 2.1 Kontekst for KSD 2.1.1 Lovhjemmel og forvaltningsmæssigt formål [Afklaring/KSD: Lovhjemmel mangler] 2.1.2 Kapacitets- og servicekrav Der forventes månedligt at modtages følgende: - 90.000 sygefraværsstatusmeldinger 2.1.3 Forudsætninger for produktionssætning af integration KSD Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfalden, for at en kommune gennem et anvendersystem kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS101 Aftale STAR Kommune Fase 1 Indgåelse af Dataudvekslingsaftale Serviceplatformen Afhænger af TS201 Det er samme aftale, som indgås i TS101 og TS201 for SF1610, SF1611 og SF1620 TS102 Verifikation Verificer at basisopgaver for beskedfordeler er gennemført Anvendersystem Leverandør af fagsystem Leverandør af fagsystem Fase 2.2 TS103 TS104 Oprettelse af serviceaftale for beskedtype Sygemeldingsstatus Godkendelse af serviceaftale for besked. Konfiguration Administrationsmodul Leverandør af fagsystem Fase 2.2 Leverandør af fagsystem Afhænger af TSP05 Kommune Kommune Fase 2.2 Konfiguration Administrationsmodul Afhænger af TS103 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 46
TS105 Oprettelse af abonnement på Sygemeldingsstatus i beskedfordeler Konfiguration Beskedfordeler Leverandør af fagsystem Fase 2.2 Leverandør af fagsystem Afhænger af TSP05 TS106 Oprettelse af initial værdiliste til beskedfordeler på borgere Migration Beskedfordeler Leverandør af fagsystem Leverandør af fagsystem Fase 2.3 TS105 TS101 - STAR skal indhente og drive godkendelsen af Dataudvekslingsaftal med kommunerne. Kommune skal dog sikre sig at aftalen der er indgået inde tilslutning til STAR DFDG. TS102 - Det er en forudsætning for at kunne anvende beskedfordeler af TBA13 TBA15 i [GVF] er gennemført. Disse aktiviteter indeholder tilslutning til beskedfordeler, overvejelser om abonnements- og serviceaftale-struktur TS103 - Leverandøren af anvendersystemet skal for hver kommune oprette en serviceaftale, som indeholder en dataafgrænsning, der tillader modtagelse af besked med følgende parameter: Beskedtypen: Sygemeldingsstatus Sikkerhedsklassificering: Fortrolige personoplysninger, Retning: Modtag beskeder KLE nr.: Ingen begrænsning TS104 - Kommune skal godkende ovenstående serviceaftale. TS105 - For de enkelte kommuner skal der oprettes abonnementsudtrykket i beskedfordeler, som skal indeholdende Sygemeldingsstatus TS106 - Ved ibrugtagning af KSD, skal værdilisten til beskedfordeler være opdateret med de borgerer, som der skal modtages Sygemeldingsstatus på 2.2 Kontekst for KY 2.2.1 Lovhjemmel og forvaltningsmæssigt formål [Afklaring/KY: Lovhjemmel mangler] 2.2.2 Kapacitets- og servicekrav Der forventes månedligt at modtages følgende: - 70.000 ledighedstilmeldinger KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 46
- 70.000 ledighedsafmeldinger 2.2.3 Forudsætninger for produktionssætning af integration KY Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfalden, for at en kommune gennem et anvendersystem kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS201 Aftale STAR Kommune Fase 1 Indgåelse af Dataudvekslingsaftale Serviceplatformen Afhænger af TS201 Det er samme aftale, som indgås i TS101 og TS201 for SF1610, SF1611 og SF1620 TS202 Verifikation Verificer at basisopgaver for beskedfordeler er gennemført Anvendersystem Leverandør af fagsystem Leverandør af fagsystem Fase 2.2 TS203 TS204 Oprettelse af serviceaftale for beskedtype Ledighedstilmelding og Ledighedsafmelding Godkendelse af serviceaftale for besked. Konfiguration Administrationsmodul Leverandør af fagsystem Fase 2.2 Leverandør af fagsystem Afhænger af TSP05 Kommune Kommune Fase 2.2 Konfiguration Administrationsmodul Afhænger af TS103 TS205 Oprettelse af abonnement på Ledighedstilmelding og Ledighedsafmelding i beskedfordeler Konfiguration Beskedfordeler Leverandør af fagsystem Fase 2.2 Leverandør af fagsystem Afhænger af TSP05 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 46
TS206 Oprettelse af initial værdiliste til beskedfordeler på borgere Migration Beskedfordeler Leverandør af fagsystem Leverandør af fagsystem TS105 TS201 - STAR skal indhente og drive godkendelsen af Dataudvekslingsaftal med kommunerne. Kommune skal dog sikre sig at aftalen der er indgået inde tilslutning til STAR DFDG. TS202 - Det er en forudsætning for at kunne anvende beskedfordeler af TBA13 TBA15 i [GVF] er gennemført. Disse aktiviteter indeholder tilslutning til beskedfordeler, overvejelser om abonnements- og serviceaftale-struktur TS203 - Leverandøren af anvendersystemet skal for hver kommune oprette en serviceaftale, som indeholder en dataafgrænsning, der tillader modtagelse af besked med følgende parameter: Beskedtypen: Ledighedstilmelding og Ledighedsafmelding Sikkerhedsklassificering: Fortrolige personoplysninger, Retning: Modtag beskeder KLE nr.: Ingen begrænsning TS204 - Kommune skal godkende ovenstående serviceaftale. TS205 - For de enkelte kommuner skal der oprettes abonnementsudtrykket i beskedfordeler, som skal indeholdende Ledighedstilmelding og Ledighedsafmelding TS206 - Ved ibrugtagning af KY, skal værdilisten til beskedfordeler være opdateret med de borgerer, som der skal modtages Ledighedstilmelding og Ledighedsafmelding på. 2.3 Kontekst for STAR 2.3.1 Lovhjemmel og forvaltningsmæssigt formål Ikke relevant 2.3.2 Kapacitets- og servicekrav Ikke oplyst. 2.3.3 Forudsætninger for produktionssætning af integration STAR Dette kapitel beskriver de opgaver, som skal gennemføres af STAR i relation til snitfladen, for at en integrationspart kan benytte snitfladen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 46
ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS201 Udarbejdelse af Dataudvekslingsaftale Aftale STAR DFDG STAR STAR Fase 1 Det er samme aftale, som også indgås for SF1610, SF1612 og SF1620 TS202 Registrering af KOMBIT certifikat Konfiguration STAR DFDG STAR STAR FASE 1 Antageligt samme certifikat for SF1610 og SF1611 TS203 Registrering adgang til STAR DFDG for kommunen Konfiguration STAR DFDG STAR STAR Fase 2.2 TS201 - STAR skal udarbejde en dataudvekslingsaftale, som skal indgås mellem STAR og kommunernes. STAR håndterer indgåelsen af aftaler. TS202 - STAR DFDG skal registrerer adgang for kald KOMBITs OCES certifikat med CVR-nr. 19 43 50 75 TS203 - STAR skal registrer/åbne op for de enkelte kommune, som skal have ledighedstilmeldinger og ledighedsafmeldinger, så de får adgang STAR DFDG KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 46
STAR/DFDG Serviceplatformen Beskedfordeler Fagsystem(n) Integrationsbeskrivelse 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY og KSD Integrationen benyttes af KY til at modtage beskeder med til- og afmelding af ledighed og af KSD til at modtage beskeder med Sygefraværsændringer fra Beskedfordeler. Fagsystemet skal vedligeholde en værdiliste ed CPR numre på de borgere, som der ønskes beskeder for. 3.1.1 Overordnet forretningslogik Serviceplatformen henter beskeder vedrørende ledighed fra STAR/DFDG for hver kommune og videresender til beskedfordeleren. Yderligere henter Serviceplatformen beskeder vedrørende Sygefraværsændring for alle kommuner på en gang og videresender disse til via Beskedfordeler. Beskederne vil indeholde information om, hvilken kommune, der må modtage beskeden. KY henter beskeder fra Beskedfordeleren med besked om til- og afmelding af ledighed. KSD henter beskeder fra Beskedfordeleren med statusændringer omkring sygefravær (KSD). Forudsætning for at KY og KSD modtager beskeder for en specifik borger er at denne CPR-nummeret for borgeren er tilføjet til værdiliste for abonnementet. Modsat skal CPR-nummeret slettes fra værdiliste, når beskeder for borgeren ikke længere ønskes. Modtag sygestatus- og ledighedshændelser Modtag besked EP_KSD/EP_KY Distribuer besked Initier kommunikati on Hent beskeder fra Kø og afsend Afslut kommunikati on Udstil køstatus Udstil beskeder Bekræft afslutning 3.1.1 Oversigt over endpoints ID Navn KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 46
EP_FS1 EP_FS2 ModtagBesked [SF1460_A/SF1460_B /SF1460_D] AdministrerVaerdiliste [SF1460_B] 3.1.2 Beskrivelse af endpoint EP_FS1 - ModtagBesked Denne integration er standardintegrationsmønster for afsendelse af hændelsesbesked fra Beskedfordeler til KSD. Beskrivelsen af endpoint findes i Modtag besked [SF1460_A], Modtag besked via pull [SF1460_D] og Vedligehold værdiliste i beskedabonnement [SF1460_B] Beskedfordeler udstiller beskeder fra STAR DFDG. Endpoint benyttes af fagsystemerne i forbindelse med Sygefraværsændringer og til- og afmeldinger til ledighed. 3.1.2.1 Abonnementsvilkår KSD skal oprette abonnement på beskedtypen Sygemeldingsstatus, og KY skal oprette abonnement på ledighedstilmelding og ledighedsafmelding. Nedenfor er det vist det hvordan abonnementsudtrykkende kan se ud: Forretningsobjektets type er Person, der har et UUID ce7fcf97-a8a2-447a-8690-d38aa0f6e23c. Den konkrete person har ID urn:oio:cpr:2204151234 KSD har behov at oprette et abonnementsudtrykket for Sygemeldingsstatus som inkluderer værdilisten Personkreds, og som ligner nedestående udtryk: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ReleteredeObjekt[0].ObjektType = ce7fcf97- a8a2-447a-8690-d38aa0f6e23c ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateredeObjekt[0].ObjektId IN @PersonkredsSygemeldingsstatus)) Af- og tilmeldinger ledighed på en person eller personkreds (værdiliste Personkreds ) KY har behov at oprette abonnementsudtryk for Ledighedstilmelding og ledighedsafmelding som begge inkluderer værdilisten Personkreds, og som ligner nedestående udtryk: Ledighedstilmelding: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektType = ce7fcf97- a8a2-447a-8690-d38aa0f6e23c ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.Objekt- Registrering[0].ObjektId IN @ PersonkredsLedighedsmelding)) Ledighedsafmelding: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektType = 58c4e4cff76e-4fae-838d-bee6ece5071e ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektId IN @PersonkredsLedighedsmelding)) KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 46
3.1.2.2 Dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Se [SF1460_A] for push eller [SF1460_D] for pull. Outputdata Se [SF1460_A] for push eller [SF1460_D] for pull. 3.1.3 Beskrivelse af endpoint EP_FS2 AdministrerVaerdiliste Beskrivelsen af endpoint findes i Vedligehold værdiliste i beskedabonnement [SF1460_B]. Beskedfordeler udstiller administrationsinterface til vedligehold af værdilister i beskedabonnementer. Endpoint kaldes af fagsystemerne i forbindelse med vedligehold af værdilister i beskedabonnement. 3.1.3.1 Værdiliste Fagsystemerne skal vedligeholde værdilister for den personkreds, det ønsker at abonnere på. Værdilisterne skal oprettes med følgende navn: Personkreds per ydelse PersonkredsSygemeldingsstatus for KSD Personkreds per ydelse PersonkredsLedighedsmelding for KY 3.1.4 Service Management Beskrivelsen af Service Management findes i Modtag besked [SF1460_A], Modtag besked via pull [SF1460_D] og Vedligehold værdiliste i beskedabonnement [SF1460_B] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 46
3.2 Specifikation af endpoints for SP som afsendende beskedagent Integrationen benyttes af Serviceplatformen til at sende meddelelser om til- og afmelding af ledighed til KY og til at sende beskeder med Sygefraværsændringer til KSD via Beskedfordeler. Beskederne dannes på baggrund af de meddelelser, som er modtaget fra STAR DFDG. 3.2.1 Overordnet forretningslogik Serviceplatformen sender enkeltvis besked om til- eller afmelding af ledighed eller en sygefraværsændring til Beskedfordeler: Serviceplatformen kalder EP_SP1 Beskedfordeler returnerer et synkront svar til afsender 3.2.2 Oversigt over endpoints ID Navn EP_SP1 AfsendBesked 3.2.3 Beskrivelse af endpoint EP_SP1 AfsendBesked Beskrivelsen af endpoint findes i Aflever besked [SF1460_C]. EP_SP1 sender information om til- eller afmelding af ledighed eller en sygefraværsændring. Endpoint kaldes, når der modtages information om dette fra STAR DFDG. 3.2.3.1 Dataspecifikation En besked består af en kuvert og et beskedindhold. Der afsendes tre beskedtyper: Sygemeldingsstatus Ledighedstilmelding Ledighedsafmelding 3.2.3.1.1 Beskedkuverten dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Se [SF1460_C]. Outputdata Se [SF1460_C]. Hver besked vil indeholde information om sygemelding, raskmelding, sygedomsperiode, årsag mv. Beskedkuverten skal udfyldes, således at det er muligt at abonnere på ændringer. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 46
Værdier angivet med er faste værdier, der skal sættes ind i Beskedkuverten. Andre værdier skal afsendersystemet selv udfylde. [De fleste Id er er baseret på UUID dog med undtagelse af: KLE - urn:oio:kle:nn.nn.nn CPR - urn:oio.cpr:nnnnnnnnnn CVR - urn:oio:cvr:nnnnnnnn PNR urn:oio:pnr:nnnnnnnnnn Fuldtnavn - urn:oio:fuldtnavn:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Adresse - urn:oio:adresse:kkk;vvv;nnn;xx;xx;nn da disse ikke repræsenteret af et UUID og derfor skal benytte urn.] 3.2.3.1.2 Beskedtype Sygemeldingsstatus Til KSD skal der distribueres en beskedtype: Sygemeldingsstatus Element Beskrivelse Værdifelt udfyldelse Filtreringsdata Beskedtype Sygemeldingsstatus 52a7a570-9dbc-4a4c-a9cb-b53b2925f2c6 BeskedAnsvarligAktør STAR-DFDG fb7d1a89-8757-447e-b553-51d341d8266f TilladtModtager Borgerens bopælskommune urn:oio:cvr:nnnnnnnn (hvor nnnnnnnn er et 8-cifret CVR nummer) for kommunen RelateretObjekt(0) ObjektId CPR-nummer på borgeren urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPRnummer uden bindestreg. Hentes fra elementet: cpr:personcivilregistrationidentifier) ObjektType Person ce7fcf97-a8a2-447a-8690-d38aa0f6e23c Objektregistrering ObjektRegistreringId Sygemeldingens ID fra record GUID - MessageIdentifier RegistreringsAktoer Serviceplatformen d92bb9c2-d826-4028-8fb5-d8b88b4377d4 Registreringstidspunkt Tidspunkt for hændelsens udsendelse fra kilden Tidspunktet i DateTime format ObjektAnsvarligMyndighed CVR nr. for STAR urn:oio:cvr:55568510 ObjektId Sagsnummer fra record GUID - NemRefusionIdentifier ObjektType Sag d7f7d673-5001-4f8d-ad92-fd9e5b1d0517 ObjektHandling Ændring i Sygemeldingsstatus f85d4342-1536-49a4-9e65-9f3352b32d69 OpgaveEmne Leveranceinformation N/A KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 af 46
Dannelsestidspunkt Tidspunkt hvor beskeden opstod [SP indsæt tidspunkt for dannelse af beskeden på SP] i DateTime format Sikkerhedsklassificering Følsomme personoplysninger 31c09910-e011-46a5-86fb-254374421fe8 GyldighedFra Tidspunkt hvor hændelsen opstod Tidspunktet modtaget på serviceplatformen i DateTime format Sikkerhedstoken vil indeholde en liste af CVR-numre med den relaterede kommunekode. I hver forekomst af en besked med Sygemeldingsstatus kan kommunekoden findes i elementstrukturen AuthorityCode Herved er det muligt at mappe fra kommunekode til CVR-nr og udfylde TilladtModtager og Objekt- AnsvarligMyndighed. 3.2.3.1.2.1 Beskeddata Beskeddata skal indeholde samme data som beskeden fra STAR, og som er beskrevet i kapitel 3.3.10.2 Dataspecifikation 3.2.3.1.3 Beskedtype Ledighedstilmelding Til KY skal der distribueres følgende beskedtype Ledighedstilmelding Hver Ledighedstilmelding indeholder information om ledighedsdato og ledighedsgrad for en borger. Element Beskrivelse Værdifelt udfyldelse Filtreringsdata Beskedtype Ledighedstilmelding 52f2fd13-f06b-4d28-a554-209bb305cfd8 BeskedAnsvarligAktør STAR-DFDG fb7d1a89-8757-447e-b553-51d341d8266f TilladtModtager Borgerens bopælskommune. urn:oio.cvr-nr:xxxxxxxxxx Mappes fra tabel på serviceplatformen RelateretObjekt ObjektId ObjektType Objektregistrering N/A N/A ObjektRegistreringId TransaktionsID GUID MessageIdentifier RegistreringsAktoer Serviceplatformen d92bb9c2-d826-4028-8fb5-d8b88b4377d4 Registreringstidspunkt ObjektAnsvarligMyndighed Tidspunkt for hændelsens udsendelse fra kilden CVR nr. for styrelsen for arbejdsmarked og rekruttering Tidspunktet i DateTime format urn:oio:cvr:55568510 ObjektId CPR-nummer på borgeren urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPR- KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 af 46
nummer uden bindestreg. Hentes fra elementet: cpr:personcivilregistrationidentifier) ObjektType Person ce7fcf97-a8a2-447a-8690-d38aa0f6e23c ObjektHandling Ændring i Ledighedstilmelding f9e30585-e69f-4b40-9cee-815a46697c83 OpgaveEmne Leveranceinformation N/A Dannelsestidspunkt Tidspunkt hvor beskeden opstod Tidspunktet i DateTime format Sikkerhedsklassificering Følsomme personoplysninger 31c09910-e011-46a5-86fb-254374421fe8 GyldighedFra Tidspunkt hvor hændelsen opstod Tidspunktet modtaget på serviceplatformen i DateTime format Da Ledighedstilmelding hentes per kommune ved at identificere kommune via kommuneid, kendes dette umiddelbart. Sikkerhedstoken vil indeholde en liste af CVR-numre med den relaterede kommunekode. Herved er det muligt at mappe fra kommunekode til CVR-nr og udfylde TilladtModtager og ObjektAnsvarligMyndighed. 3.2.3.1.3.1 Beskeddata Beskeddata for Ledighedstilmelding skal indeholde samme data, som beskeden fra STAR, og som er beskrevet i henholdsvis kapitel 3.3.8.2 Dataspecifikation. 3.2.3.1.4 Beskedtype Ledighedsafmelding Til KY skal der distribueres følgende beskedtype Ledighedsafmelding Hver Ledighedsafmelding indeholder dato for afslutning af ledighed og årsag til dette for en borger. Element Beskrivelse Værdifelt udfyldelse Filtreringsdata Beskedtype Ledighedsafmelding 58c4e4cf-f76e-4fae-838d-bee6ece5071e BeskedAnsvarligAktør STAR-DFDG fb7d1a89-8757-447e-b553-51d341d8266f TilladtModtager Borgerens bopælskommune. urn:oio.cvr-nr:xxxxxxxxxx Mappes gennem sikkerhedstoken fra kommune nr til CVR-nr. RelateretObjekt ObjektId ObjektType Objektregistrering N/A N/A ObjektRegistreringId TransaktionsID GUID MessageIdentifier RegistreringsAktoer Serviceplatformen d92bb9c2-d826-4028-8fb5-d8b88b4377d4 Registreringstidspunkt Tidspunkt for hændelsens udsendelse fra kilden Tidspunktet i DateTime format KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 af 46
ObjektAnsvarligMyndighed CVR nr. for styrelsen for arbejdsmarked og rekruttering urn:oio:cvr:55568510 ObjektId CPR-nummer på borgeren urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPRnummer uden bindestreg. Hentes fra elementet: cpr:personcivilregistrationidentifier) ObjektType Person ce7fcf97-a8a2-447a-8690-d38aa0f6e23c ObjektHandling Ændring i Ledighedstilmelding face6483-dafd-4a95-ad32-de5ef7ea73a5 OpgaveEmne Leveranceinformation N/A Dannelsestidspunkt Tidspunkt hvor beskeden opstod Tidspunktet i DateTime format Sikkerhedsklassificering Følsomme personoplysninger 31c09910-e011-46a5-86fb-254374421fe8 GyldighedFra Tidspunkt hvor hændelsen opstod Tidspunktet modtaget på serviceplatformen i DateTime format Da Ledighedsafmelding hentes per kommune ved at identificere kommune via kommune ID, kendes dette umiddelbart. Sikkerhedstoken vil indeholde en liste af CVR-numre med den relaterede kommunekode. Herved er det muligt at mappe fra kommunekode til CVR-nr og udfylde TilladtModtager og ObjektAnsvarligMyndighed. 3.2.3.1.4.1 Beskeddata Beskeddata for Ledighedsafmelding skal indeholde samme data, som beskeden fra STAR, og som er beskrevet i henholdsvis kapitel 3.3.9.2 Dataspecifikation. 3.2.4 Service Management Beskrivelsen af Service Management findes i Aflever besked [SF1460_C]. 3.3 Specifikation af endpoints for STAR 3.3.1 Overordnet forretningslogik Disse funktioner benyttes til at afhente beskeder omkring ledigheds til- og afmeldinger, samt sygefraværs statusmeldinger udstillet af STAR/DFDG. Funktionerne skal benyttes i en specifik sekvens. Først kaldes EP_STAR1, der igangsætter sekvensen og leverer information om hvilke af de 3 funktioner EP_STAR5-7, der skal kaldes efterfølgende. Til sidst afsluttes med kald til EP_STAR2 og EP_STAR3. EP_STAR4 benyttes kun til at afbryde en igangværende sekvens i tilfælde af opstået fejl. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 25 af 46
STAR/DFDG Serviceplatformen Beskedfordeler Fagsystem(n) Integrationsbeskrivelse Modtag sygestatus- og ledighedshændelser Modtag besked Distribuer besked Initier kommunikati on Hent beskeder fra Kø Afsend beskeder Afslut kommunikati on EP_STAR1 EP_STAR5-7 EP_STAR2-3 Udstil køstatus Udstil beskeder Bekræft afslutning 3.3.2 Oversigt over endpoints ID Navn EP_STAR1 EP_STAR2 EP_STAR3 EP_STAR4 EP_STAR5 EP_STAR6 EP_STAR7 Start ny afhentningssekvens-wsrmservice::createsequence Kvittering for modtagelse af data-wsrmservice::sequenceacknowledgement Normal afslutning på afhentningssekvens-wsrmservice::terminatesequence Unormal afbrydelse af afhentningssekvens-wsrmservice::closesequence Hent ledighedstilmeldinger-wsrmmessageservice::getunemploymentenrollment Hent ledighedsafmeldinger-wsrmmessageservice::getcancelunemploymentenrollment Hent ændringer til sygefravær-wsrmmessageservice::getillnessupdated KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 26 af 46
3.3.3 Generelle egenskaber for alle endpoints 3.3.3.1 Transportspecifikation 3.3.3.1.1 Integrationsmønster Serviceplatformen kalder ekstern part via webservice. 3.3.3.1.2 Serviceudstiller STAR DFDG er serviceudstiller. 3.3.3.1.3 Serviceanvender Serviceplatformen er serviceanvender. 3.3.3.1.4 Teknologisk understøttelse Snitfladen er implementeret som en synkron SOAP webservice. 3.3.3.1.5 Teknisk endpoint Endpoint for EP_STAR1-4 er defineret i wsdl filen wsrmservice.wsdl som findes i [WSDL-EXT] og Endpoint for EP_STAR5-7 er defineret i wsdl filen WsrmMessageservice.wsdl som findes i [WSDL- EXT]. 3.3.3.1.6 Teknisk retning for udveksling Serviceplatformen kalder en service udstillet af STAR/DFDG. 3.3.3.1.7 Dataretning for udveksling STAR/DFDG returnerer en liste af beskedtyper til læsning på køen. 3.3.3.1.8 Service invokation / Triggers Afhentningssekvensen trigges af en timer på serviceplatformen. 3.3.3.2 Dataspecifikation 3.3.3.2.1 Dataspecifikation for Header for alle services For service EP_STAR1-7 vil header indeholde tre informationer: Forespørgende organisation Request identifier Certifikat information Information for Forespørgende organisation (element ActiveOrganisationHeader) indeholder to simple elementer OrganisationTypeIdentifier, som indeholder type af organisation Jobcentre og skal have værdien 7. OrganisationCode skal for ledighedstil/af-meldinger indeholde den aktuelle kommune ID, mens det for sygemeldingsstatus altid skal være 999 Information om certifikat kan findes i kapitel 3.3.3.3 Sikkerhed KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 27 af 46
Identifier indgår i SOAP header for EP_STAR5-7, og i SOAP body EP_STAR1-4, og er yderligere beskrevet i nedenfor 3.3.3.2.2 Generel dataspecifikation EP_STAR5-7 3.3.3.2.2 Generel dataspecifikation EP_STAR5-7 Dataspecifikationen fremgår af de enkelte services, dog er følgende fælles for EP_STAR5-7: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 28 af 46
3.3.3.3 Sikkerhed Generelt baserer datakommunikation, der er sikret med certifikater, sig på, at både afsender og modtager har et certifikat og at hvert certifikat består af en privat og en offentlig del. Den private del udleveres aldrig til andre, den offentlige del udleveres til parter, man ønsker at kommunikere sikkert med. AMS stiller et certifikat til rådighed pr. miljø (udviklingstestmiljø, produktionsmiljø), aftager ønsker at kommunikere sikkert med. Aftager skal tilsvarende anskaffe sig et mindst et OCES-certifikat via DanID (https://www.nets-danid.dk/). I langt de fleste tilfælde vil en aftager have en lokal certifikatadministrator (LRA) som kan udstede certifikater på vegne af DanID. For alle certifikater, uanset typen, gælder at de skal være udstedt under samme CVR-nummer som oplyst i tilslutningsaftalen med AMS. Certifikattypen, der skal bestilles/udstedes er et funktionscertifikat. Til produktion anvendes et KOMBIT funktionscertifikat. Aftager skal bruge: Et funktionscertifikat Arbejdsmarkedsstyrelsens offentlige servercertifikat til det miljø, hvorfra der skal aftages webservices, f.eks. service.bm.dk (AMS1) KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 29 af 46
Aftager skal: Importere/installere (AMS1) i sit lokale Certificate Store, så det kan ses af det system, der skal foretage forespørgslen. Kryptere sin forespørgsel med (AMS1) Signere sin forespørgsel med den private del af (Fx) Afsende sin forespørgsel mod det pågældende miljø og webservice. Aftager vil modtage et svar: Krypteret med (Fx) Signeret med (AMS1) Aftager skal dekryptere svaret med den private del af F1 For yderligere information henvises til: http://starwswiki.amstest.dk/sikkerhed.ashx?hl=sikkerhed 3.3.3.4 Leverancesikkerhed og fejlhåndtering Hvis kaldet til en af funktionerne EP_STAR1-3,5-7 fejler eller timer ud, kaldes annullering (EP_STAR4), problemet logges, og sekvensen startes forfra periodisk med nyt kald af EP_STAR1. Hvis fejlen gentages, skal problemet løses som en driftsopgave af Serviceplatformen. 3.3.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.3.3.5.1 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/STAR] [Afklaring/STAR] [Afklaring/STAR] [Afklaring/STAR] [Afklaring/STAR] 3.3.4 Beskrivelse af endpoint EP_STAR1 Start ny afhentningssekvens Denne funktion kaldes som den første i en afhentningssekvens. 3.3.4.1 Servicenavn og operation WSRMService::CreateSequence KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 30 af 46
3.3.4.2 Dataspecifikation Input: Output: 3.3.5 Beskrivelse af endpoint EP_STAR2 Kvittering for modtagelse af data Denne funktion kaldes når alle data er læst i en afhentningssekvens. Kaldet sletter de læste data. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 31 af 46
3.3.5.1 Servicenavn og operation WSRMService::SequenceAcknowledgement 3.3.5.2 Dataspecifikation Input: Output: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 32 af 46
3.3.6 Beskrivelse af endpoint EP_STAR3 Normal afslutning på afhentningssekvens Denne funktion kaldes som den sidste i en afhentningssekvens. Kaldet afslutter sekvensen 3.3.6.1 Servicenavn og operation WSRMService::TerminateSequence 3.3.6.2 Dataspecifikation Input: Output: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 33 af 46
3.3.7 Beskrivelse af endpoint EP_STAR4 Unormal afbrydelse af afhentningssekvens Denne funktion kaldes for at afbryde en igangværende afhentningssekvens (hvis f.eks. en fejl opstår). Efter dette kald, skal sekvensen startes forfra med kald til EP_STAR1. Kan også kaldes såfremt 3.3.7.1 Servicenavn og operation WSRMService::CloseSequence 3.3.7.2 Dataspecifikation Input: Output: 3.3.8 Beskrivelse af endpoint EP_STAR5 Hent ledighedstilmeldinger Denne funktion kaldes såfremt den liste der returneres fra kald til EP_STAR1 angiver at der er meddelelser defineret for dette servicenavn. Disse meddelelser udgør tilmeldinger til ledighed. 3.3.8.1 Servicenavn og operation WsrmMessageService::GetUnemploymentEnrollment KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 34 af 46
3.3.8.2 Dataspecifikation Udover de generelle headers beskrevet i afsnit 3.2.3.2 Dataspecifikation, er følgende defineret: Input: Intet udover den generelle SequenceRequest Output: Nedenfor angives listen over beskeder for den enkelte kommune: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 35 af 46
3.3.9 Beskrivelse af endpoint EP_STAR6 Hent ledighedsafmeldinger Denne funktion kaldes såfremt den liste der returneres fra kald til EP_STAR1 angiver at der er meddelelser defineret for dette servicenavn. Disse meddelelser udgør afmeldinger fra ledighed. 3.3.9.1 Servicenavn og operation WsrmMessageService::GetCancelUnemploymentEnrollment (Version 4) 3.3.9.2 Dataspecifikation Udover de generelle headers beskrevet i afsnit 3.2.3.2 Dataspecifikation, er følgende defineret: Input: Intet udover den generelle SequenceRequest Output: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 36 af 46
Nedenfor angives listen over beskeder for den enkelte kommune: 3.3.10 Beskrivelse af endpoint EP_STAR7 Hent ændringer til sygefravær Denne funktion kaldes såfremt den liste der returneres fra kald til EP_STAR1 angiver at der er meddelelser defineret for dette servicenavn. Disse meddelelser udgør statusændringer for sygefravær (f.eks. raskmelding). KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 37 af 46
3.3.10.1 Servicenavn og operation WsrmMessageService::GetIllnessUpdated 3.3.10.2 Dataspecifikation Udover de generelle headers beskrevet i afsnit 3.2.3.2 Dataspecifikation, er følgende defineret: Input: Intet udover den generelle SequenceRequest Output: Bemærk at data ovenfor returneres i en liste for samtlige kommuner; feltet AuthorityCode indeholder det aktuelle kommunenummer. AuthorityType indeholder altid Municipality. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 38 af 46
Nedenfor angives listen over beskeder: KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 39 af 46
3.3.11 Service Management 3.3.11.1 Incident Management [Afklaring/STAR: Skal oplyse om deres incident management proces] 3.3.11.2 Problem Management [Afklaring/STAR: Skal oplyse om deres problem management proces] 3.3.11.3 Change Management [Afklaring/STAR: Skal oplyse om deres change management proces] 3.3.12 Testplan 3.3.12.1 Integrationstest [Afklaring/Programmet: Afventer programmets udmelding om teststrategi, programlog-id #1, inden der kan startes dialog med STAR] 3.3.12.2 Produktionssætningstest [Afklaring/Programmet: Afventer programmets udmelding om teststrategi, programlog-id #1, inden der kan startes dialog med STAR] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 40 af 46
STAR/DFDG Serviceplatformen Beskedfordeler Fagsystem(n) Integrationsbeskrivelse 4 Beskrivelse for integrationsplatforme 4.1 Oversigt over integrationsflows ID Navn Anvendte integrationsplatforme IF01 Hent statusmeldinger Serviceplatform og beskedfordeler 4.2 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. Modtag sygestatus- og ledighedshændelser Modtag besked Distribuer besked Initier kommunikati on Hent beskeder fra Kø Afsend beskeder Afslut kommunikati on Udstil køstatus Udstil beskeder Bekræft afslutning KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 41 af 46
Beskedfordeler Integrationsbeskrivelse En integration kan understøttes af flere integrationsflows, som vil være beskrevet hver for sig i nærværende afsnit. I hvert integrationsflow vil der indgå en række endpoints. Hvert endpoint vil være specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående afsnit 3. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen. Serviceplatformen EP_STAR1-7 EP_BF IF01 Hent statusmeldinger STAR/ DFDG 4.2.1 Integrationsflow IF01: Hent statusmeldinger 4.2.1.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_BF Afsend beskeder til beskedfordeler Se [SF1460_A] EP_STAR1 Start ny afhentningssekvens Afsnit 3.3.4 EP_STAR2 Kvittering for modtagelse af data Afsnit 3.3.5 EP_STAR3 Normal afslutning på afhentningssekvens Afsnit 3.3.6 EP_STAR4 Unormal afbrydelse af afhentningssekvens Afsnit 3.3.7 EP_STAR5 Hent ledighedstilmeldinger Afsnit 3.3.8 EP_STAR6 Hent ledighedsafmeldinger Afsnit 3.3.9 EP_STAR7 Hent ændringer til sygefravær Afsnit 3.3.10 4.2.1.2 Integrationstype Integrationen er en orkestreringssintegration, hvor Serviceplatformen scheduleret henter beskeder hos STAR, som videredistribueres via beskedfordeler. 4.2.1.3 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 42 af 46
Timerstyret polling for data Fagsystem Beskedfordeler Serviceplatformen STAR/DFDG Forespørg på data i køen for en kommune (aktuel kommuneid) Læs ledighedstilmeldinger Læs ledighedsafmeldinger Afslut læsning Afslut sekvens med STAR Videresend ledighedstilmeldinger til Beskedfordeler Videresend ledighedstilmeldinger til Beskedfordeler Gentag for hver registreret kommuneid EP_BF1 CreateSequence EP_STAR1 GetUnemploymentEnrollment EP_STAR5 GetCancelUnemploymentEnrollment EP_STAR6 SequenceAcknowledgement EP_STAR2 TerminateSequence EP_STAR3 Gentag for hver besked Gentag for hver besked Forespørg på data i køen for alle kommune (kommuneid =999) Læs sygemeldingsstatus Afslut læsning Afslut sekvens med STAR Videresend ledighedstilmeldinger til Sygemeldingsstatus EP_BF1 Fraværsstatus CreateSequence EP_STAR1 GetIllnessUpdated EP_STAR7 SequenceAcknowledgement EP_STAR2 TerminateSequence EP_STAR3 Gentag for hver besked Fagsystem modtager beskeder Hændelsesbesked 4.2.1.4 Datatransformering De beskeddata der modtages fra de tre STAR funktioner (EP_STAR5-7) skal formateres til brug for beskedfordeling. Dette indebærer bl.a. at Kommunenummer fra de modtagene beskeder skal oversættes til CVR til brug for beskedkuverten. Herudover skal CPR-nummer overføres fra beskeden til kuverten. Beskedkuverten skal have defineret en beskedtype, der er afledt af den funktion der kaldes mod STAR (EP_STAR5-7). Endpoint Beskedtype Beskrivelse AP_STAR5 Ledighedstilmelding Se afsnit 3.2.3.1.3 AP_STAR6 Ledighedsafmelding Se afsnit 3.2.3.1.4 AP_STAR7 Sygemeldingsstatus Se afsnit 3.2.3.1.2 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 43 af 46
4.2.1.5 Datapersistering Det er nødvendigt at registre kommuneid/nummer som der skal hentes ledighedstil/afmeldinger for. Derudover skal der registreres et fiktiv kommuneid/nummer 999 for at hente sygemeldingsstatus. Persistering er nødvendig i forhold til at alle beskeder skal hentes før de sendes videre. 4.2.1.6 Databerigelse For ledighed-til/af-meldinger anvendes det kommune ID, som der forespørges med til at oversættes til det tilhørende CVR nummer for kommunen til brug for videresendes til beskedfordeling. Det modtagne kommunenummer for sygemeldingsstatus oversættes til det tilhørende CVR nummer for kommunen til brug for videresendes til beskedfordeling. 4.2.1.7 Routing Der er ikke routing på Serviceplatformen, da denne opgave varetages af Beskedfordeleren. 4.2.1.8 Orkestrering Der defineres en timerstyret orkestreringsservice, der varetager kommunikationen med STAR. Processen startes periodisk (f.eks. hvert 5. minut) Denne størrelse skal kunne konfigureres af en operatør. Processen vil udføre den sekvens der fremgår af afsnit 4.1.2.3. Hvis et af trinene i sekvensen fejler, kaldes EP_STAR4 (CloseSequence) der afbryder den igangværende sekvens, og sekvensen startes forfra med EP_STAR1. De modtagne data fra hvert af de tre datakald (EP_STAR5,6,7) udgør lister med alle kommuner og for hver kommune med alle de personer der rapporteres for. Disse udpakkes, så der resulterer en besked pr. kommune/ person i de modtagne lister. Disse beskeder persisteres på en intern kø, hvorfra en asynkron proces videresender dem til Beskedfordeleren. 4.2.1.9 Sikkerhed Sikkerheden hos kilde er certifikatbaseret, mens beskedfordeleren anvender rammearkitekturens sikkerhedsmodel. Derfor skal serviceplatformen foretage veksling mellem sikkerhedsmodeller som beskrevet i UC-SEC-06 i [SIKKERHED]. 4.2.1.10 Logning Serviceplatformen logger modtagene data for de enkelte sekvenser udført af timerprocessen, så det er muligt at foretage fejlsøgning på processen. 4.2.1.11 Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 44 af 46