SPOR 5: BESKEDFORDELER OG FORDELINGSKOMPONENT v. Jens Jørn Nielsen Data- og infrastrukturdage 16. og 19. september 2019
Serviceejer for dataområder Beskedfordeler Fordelingskomponent Personskat eindkomst R75 Årsopgørelse Brev og NemSMS eboks Fjernprintleverandører NemSMS IT-Arkitekt Jens Jørn Nielsen SFTP
Forventninger I får indblik i funktion, teknik og forretning for Beskedfordeler og Fordelingskomponent. Forstår hvad Beskedfordeler og Fordelingskomponent er for en størrelse, og hvornår de kan anvendes. Forstår hvordan Beskedfordeler og Fordelingskomponent virker og kan anvendes. Bliver inspireret til nye anvendelsesmuligheder.
KOMBITs løsninger og fælleskommunal infrastruktur Kommunale fagområder Arbejdsmarked og erhverv Social og sundhed Børn og læring Mit sygefravær Miljø, teknik og forsyning Byg og Miljø NemRefusion Fælleskommunal virksomhedskontaktdatabase Print Ejendomsskat og Ejendomsbidrag SAPA Kommunernes Sygedagpengesystem Kommunernes Ydelsessystem Praksys DUBU DHUV Administration og organisation Socialt Frikort Social pension Ydelsesrefusion På tværs af fagområder Fælleskommunal infrastruktur CPRreplika Fordelingskomponent Adgangsstyring Beskedfordeler Klassifikation Organisation FLIS Fælles Bibliotekssystem Aula Demokrati og involvering Økonomi Valg Serviceplatformen Køreprøvebooking Sag/Dokumentog Ydelsesindeks
Beskedfordeler, Fordelingskomponent eller SFTP? Afsender Beskedfordeler Modtager1 En afsender til mange modtagere Ingen forretningskvittering Advisering/notifikationer: Mange små Modtager2 Beskedfordeler Fordeling mellem myndigheder Dele af den fælleskommunale infrastruktur Afsender En afsender til én modtager Forretningskvittering Overdragelse af dokumenter Fordelingskomponent Modtager3 Fordelingskomponent Fuld sikkerhed Afsender En afsender til én modtager Ingen forretningskvittering Flytning af filer: Færre store SFTP Modtager4 Serviceplatformen / SFTP
BESKEDFORDELER
Beskedfordeleren: Forretningsmæssig behov Formål: At fordele beskeder om en virksomhed, borger mv. til en eller flere abonnenter. Afsender 1 Modtager 1 Afsendere og modtagere er identificere ved Myndighed (CVR-nr) og IT-system (Certifikat) Afsender 2 Beskedfordeler Modtager 2 Kalundborg kommunes Sygedagpengesystem Afsender 3 Modtager 3
Hvorfor Beskedfordeleren? Modtager kan opsætte abonnement, således at kun ønskede beskeder modtages. Udjævne spidsbelastning for modtagere Afkoble afsender og modtager kender ikke, der er ingen direkte afhængighed mellem afsender og modtager system. Enkel, standardiseret grænseflade => Enklere at skifte systemer og leverandører med uændret grænseflade
Beskedfordeler egenskaber Ingen kvittering: Fire and forget Token sikkerhed: Certifikater og Serviceaftaler er påkrævet Hændelser er max 1mb Hurtigt svartid og skalering 1000 afsenderdueslag 5000 modtagerdueslag 220 beskeder per sekund i spidsbelastning 790 mill. beskeder per år ~ 25 per sek. Fuld sikkerhed og compliance Tilgængelighed 24/7 oppetid 99.9% med planlagte servicevinduer Driftsovervågning, support, incident og problem management
Interfaces NemID adgang Brugergrænseflade Vedligehold dueslag, abonnement og beskedtyper Beskedfordeler Opret besked på fejlkø Send besked Hent besked Modtag besked Vedligeholde værdiliste
Basisfunktionalitet Beskedfordeler Cpr-nr 2201010123 2608694567 1906067890 Værdiliste (get(beskedkuvert.filtreringsdata.relateretobjekt,0).objekti d.urnidentifikator = "urn:oio:cpr:personhaendelse:020" AND get(beskedkuvert.filtreringsdata.objektregistrering,0).obje ktid.urnidentifikator IN <<vaerdiliste>> ) Abonnementsudtryk Afsendersystem Afsenderdueslag Besked Beskedfordeling Besked Modtagerdueslag Modtager
Basisfunktionalitet i brugergrænseflade Bemærk: Beskeder der ikke abonneres på fordeles til en Deadletter dueslag. Beskeder hvor der er mindst 1 abonnementsudtryk modtages kun af modtagersystemer der abonnere på disse. Beskedfordeler kan ikke genskabe beskeder for et modtagersystem. Flere/mange dueslag kan eksporteres og importeres samtidig, f.eks. fra test til produktion. Der er mulig at få syntaktisk valideret et abonnements-udtryk og afprøve mod en besked i en lokal fil. CPR-020 Myndiggørelse.
Abonnementsudtryk Følgende EBNF notation giver et eksempel på syntaksen for match udtryk: <expr>::=<expr> <opr> <expr> ( <expr> ) NOT <expr> <expr> [ NOT ] IN ( <values> ) <expr> [ NOT ] IN ( <valuelistreference> ) <value> <field> <opr> ::= AND OR = > < <> <= >= LIKE <values> ::= <value> <values>, <value> <value> ::= (konstant værdi, fx teksten Navneændring i almindelighed, eller et naturligt tal) <field> ::= (felt fra beskedkuverten, fx EventInfoStructure.ExtensionStructure.EventType) <valuelistreference> ::= <IDENTIFIER> (værdiliste der anvendes, se bemærkningerne) Bemærkninger: () AND OR NOT LIKE IN Sammenligninger på formen: <expr> [ NOT ] IN ( <values> ) <expr> [ NOT ] IN ( <valuelistreference> ) Udtrykket evaluerer til den booleske værdi sandt, hvis <expr> er lig med mindst en af de specificerede værdier fra værdilisten, og falsk, hvis <expr> er forskellig fra alle de specificerede værdier. Brugen af NOT negerer dette. Ved brug af formen <valuelistreference> refereres ikke til konkrete værdier, men i stedet til indholdet af en værdiliste registreret til abonnementsudtrykket. Et abonnementsudtryk må højst indeholde brug af <valuelistreference> én gang. Sammenligninger på formen: <expr> LIKE <expr> Udtrykket evaluerer til den booleske værdi sandt, hvis første <expr> kan matches af anden <expr>, hvor anden <expr> anvender trunkering (wildcard). For tekststrenge er dette defineret således, at tegnet % (procent) er både trunkeringstegn og maskeringstegn. Udtrykket ABCDEF LIKE AB%EF er dermed sandt, såvel som udtrykket ABCDEF LIKE %CD%.
Mere funktionalitet Beskedfordeler Fejldueslag Besked Besked Kopidueslag Besked Afsendersystem Besked Afsenderdueslag Besked Beskedfordeling Besked Modtagerdueslag Besked Besked Besked Besked Besked Besked Modtager
Sletning af beskeder Modtagersystemer skal hente beskeder løbende. Modtagersystemer skal opsætte opbevaringsperiode på dueslag. Perioden er mellem 1-30 dage, og bestemmes i forhold til overholdelse af GDPR. Perioden sættes individuel for ud, kopi og fejldueslag. Ved driftsproblemer i modtagersystemet kan perioden forlænges med 2 måneder ad gangen op til 1 år.
Serviceaftaler Værdiliste/Fejlkø Modtagers CVR-nr IT-system Aflever Beskedfordeler Beskedtype Afsender IT-system Afsender-Myndighed CVR-nr Modtager-myndigheder CVR-nr Værdiliste Abonnementsudtryk Fejldueslag Kopidueslag Afsendersystem Afsenderdueslag Beskedfordeling Modtagerdueslag Pull Push Modtager Afhent Beskedtype Modtager IT-system Afsender-Myndighed CVR-nr Modtager-myndighed CVR-nr Afleveringsendpoint TLS-Certifikat Endpoint
Serviceaftale på afsend
Serviceaftaler på afhent
Abonnementsudtryk vs. Serviceaftaler Serviceaftale begrænser hvad man har lov til at modtage. Abonnementsudtryk begrænser hvad man ønsker at modtage. Man kan derfor ikke modtage mere end det Serviceaftalen tillader. Anvend abonnementsudtryk til at frasorterer uønskede beskeder. Serviceaftale Abonnements -udtryk Serviceaftale Abonnements -udtryk Abonnementsudtryk Serviceaftale
Teknik Beskedfordeler Værdiliste SOAP SF1460_B Vedligehold værdiliste Fejldueslag Rest Afsendersystem SF1460_C Aflever besked AMQP Afsenderdueslag Abonnementsudtryk Beskedfordeling Kopidueslag Modtagerdueslag SF1460_E Flyt Besked til Fejlkø SF1460_D Afhent besked Pull AMQP SF1460_A Modtag besked Push Rest Modtager Secure Token Service SF1512 - Sikkerhed - Security Token Service SOAP Secure Token Service SOAP SF1512 - Sikkerhed - Security Token Service
Besked, kuvert og indhold Beskedkuvert indeholder information om transport, sikkerhed og selektionsdata, som sætter modtager i stand til at filtrere relevante beskeder til modtagelse. Indeholder kun i begrænset omfang data til behandling i modtagersystemet. BESKEDFORDELER Besked Dataindhold indeholder information/data, som skal behandles i modtagersystemet. Beskedfordeler hverken validerer eller behandler disse data. Dataindhold Ændringer i indkomst Kuvert Standardiseret format alle systemer kan modtage Dataindhold kan i princippet indeholde alle typer formater af data.
Beskedkuvert oversigt Modtagere Myndighed Dataejer/ Myndighed Beskedkuvert BeskedId BeskedVersion Filtreringsdata Beskedtype TilladtModtager RelateretObjekt ObjektType ObjektRegistrering ObjektRegistreringId TvaergaaendeProces ObjektId ObjektAnsvarligMyndighed ObjektType ObjektId Type fra beskedkatalog BeskedAnsvarligAktør ObjektRolle RegistreringAktør ObjektEmne ObjektRolle Struktur Gentaget struktur Felt Vejledning : Værdi fra Organisation Værdi fra Klassifikation Hvem omhandler hændelsen (borgere, virksomheder) STS Klassifikation STS Organisation Følsomhed Leveranceinformation Dannelsestidspunkt Sikkerhedsklassificering GyldigFra GyldigTil Beskeddata Data fra afsender
Sektion i beskedkuverten Feltnavn Eksempelværdi ved modtagelse Specifik anvendelse af feltet for denne beskedtype (Udfyldelsen af de enkelte felter følger forskrifterne i denne kolonne) Haendelsesbesked BeskedId f2d45b2b-dd2a-485c-bcd8-592fb0069362 Følger generel anvendelse. En GUID der er unik for beskeden. Afsender skal generere et ID, helst af typen UUID. Værdien skal indlejres i elementet UUIDIdentifikator. Haendelsesbesked BeskedVersion 1.0 Version af beskedkuverten. Følger generel anvendelse. Filtreringsdata Beskedtype 08872e29-a86d-4cdd-90b1-be589587d706 Beskedtypen "eskattekort" Filtreringsdata <Haendelsesbesked> BeskedAnsvarligAktoer d92bb9c2-d826-4028-8fb5-d8b88b4377d4 Ansvarlig aktør er altid UUID for IT Systemet Serviceplatformen. Værdien skal indlejres i elementet UUIDIdentifikator. Filtreringsdata <Beskedkuvert> TilladtModtager urn:oio.cvr-nr:55568510 CVR nummer for den kommune, der har abonnementet på formen urn:oio.cvr-nr:[cvr-nr] Filtreringsdata. TvaergaaendeProces <udeladt> Benyttes ikke for denne beskedtype. Feltet bør udelades eller være tomt. RelateretObjekt[0]. ObjektId urn:oio.se-nr:12345678 SE nummer for den kommune, der har abonnementet på formen urn:oio.se-nr:[se-nr]. SP indsætter SE-nr. fra MQ feltet. Indberetter_SE- nr" RelateretObjekt[0] ObjektType df0aa789-3fff-4dd4-baa2-d21b216dc861 Forretningsobjektet SE-nr ObjektRegistrering </Beskedkuvert> ObjektRegistreringId urn:oio:kombit:skat:mq:4c9e96e831ad6ae422 MQ correlation ID på formen 9da9aaed1ff607ab517d228262455ea27b26d urn:oio:kombit:skat:mq:48*<hexidecimale cifre> <Beskeddata> 003c3a6fd5ee2162b90bee53e66b3f00aec005 2df ObjektRegistrering<Base64 RegistreringsAktoer file-type=".xml" ee0aec46-902a-49fa-9a5c-46543e5eaac3 content-type="application/xml" RegistreringsAktør er altid encoding="utf-8"> IT systemet SKAT eindkomst for denne beskedtype. Værdien skal indlejres i elementet UUIDIdentifikator. SGVsbG8gV29ybGQ= ObjektRegistrering Registreringstidspunkt 2016-11-08T15:30:00Z Tidspunktet modtaget på serviceplatformen i DateTime format ObjektRegistrering ObjektAnsvarligMyndigh urn:oio:cvr-nr:55568510 CVR nummer for den kommune, der har abonnementet på formen </Base64> ed urn:oio.cvr-nr:[cvr-nr] ObjektRegistrering ObjektId <udeladt> Skal ikke angives, da der ikke forefindes en URN definition, og ikke <Beskeddata> medsendes en ID i UUID fra SKAT, som kan anvendes. I beskeddata kan ID for et given skattekort udledes af elementerne Indkomstaar og </Haendelsesbesked> Eskat_lbnr. ObjektRegistrering ObjektType 85c81f8f-3427-420a-99ce-a29c4f9d5709 UUID for objekttypen Indkomstoplysning ObjektRegistrering ObjektHandling 0571e3d5-8458-4b4f-b726-c38a25024f56 UUID for handlingen Nyt skattekort Beskedkuvert GyldighedFra 2016-11-08T15:30:00Z Tidspunkt hvor hændelsen opstod i DateTime format. SP indsætter tidspunktet for modtaget på ser-viceplatformen. Beskedkuvert GyldighedTil <udeladt> Virkning slut. Benyttes ikke for denne beskedtype Haendelsesbesked Beskeddata <Base64 file-type=".xml" contenttype="application/xml" encoding="utf- 8">SGVsbG8gV29ybGQ=</Base64> Indeholder et xml dokument magen til svaret fra SF1520, serialiseret i base 64. dokumentet indlejres i et <Base64> tag. Eksemplet indeholder ikke CPR data men teksten "Hello World" Base64 encoding
Xml eksempel med beskeddata <?xml version="1.0" encoding="utf-8" standalone="yes"?> <ns2:haendelsesbesked xmlns="urn:oio:sagdok:3.0.0" xmlns:ns2="urn:oio:ns2:kuvert:1.0" xmlns:ns3="http://www.w3.org/2000/09/xmldsig#" xmlns:ns4="urn:oio:sts:1.0.0"> <ns2:beskedid> <!-- Afsenders identifikation af denne besked --> <UUIDIdentifikator>01157488-c45c-4fd2-b076-1de12effbf66 </UUIDIdentifikator> </ns2:beskedid> <ns2:beskedversion>1.0</ns2:beskedversion> <ns2:beskedkuvert> <ns2:filtreringsdata> <ns2:beskedtype> <!-- "Test/TestbeskedType1" --> <UUIDIdentifikator>7654895c-a3f3-4c77-8afd-4c77330f963c </UUIDIdentifikator> </ns2:beskedtype> <ns2:beskedansvarligaktoer> <!-- TestAnvenderSystem --> <UUIDIdentifikator>cf12c051-39ce-4066-ba11-704b46fa23c4 </UUIDIdentifikator> </ns2:beskedansvarligaktoer> <ns2:tilladtmodtager> <!-- Århus Kommunes ID --> <URNIdentifikator>urn:oio:cvr-nr:10000002</URNIdentifikator> </ns2:tilladtmodtager> <ns2:relateretobjekt> <ns2:objektid> <!-- CPR nummer GUID format --> <URNIdentifikator>urn:oio:cpr-nr:3512484916</URNIdentifikator> </ns2:objektid> <ns2:objekttype> <!-- Person forretningobjektet fra klassifikationen "forretningsobjekter" --> <UUIDIdentifikator>ce7fcf97-a8a2-447a-8690-d38aa0f6e23c </UUIDIdentifikator> </ns2:objekttype> </ns2:relateretobjekt> <ns2:objektregistrering> <ns2:objektregistreringid> <!-- UUID for denne hændelse --> <UUIDIdentifikator>aa1b94ce-d182-454f-baa6-b2febb457aa3 </UUIDIdentifikator> </ns2:objektregistreringid> <ns2:registreringsaktoer> <!-- Serviceplatformen --> <UUIDIdentifikator>D92BB9C2-D826-4028-8FB5-D8B88B4377D4 </UUIDIdentifikator> </ns2:registreringsaktoer> <ns2:registreringstidspunkt> <!-- Tidspunkt for hændelsens udsendelse fra kilden --> <TidsstempelDatoTid>2016-03-13T08:00:00</TidsstempelDatoTid> </ns2:registreringstidspunkt> <ns2:objektansvarligmyndighed> <!-- Århus Kommunes ID --> <URNIdentifikator>urn:oio:cvr-nr:10000002</URNIdentifikator> </ns2:objektansvarligmyndighed> <ns2:objektid> <!-- CPR nummer GUID format --> <URNIdentifikator>urn:oio:cpr-nr:3204151234</URNIdentifikator> </ns2:objektid> <ns2:objekttype> <!-- Person forretningobjektet fra klassifikationen "forretningsobjekter" --> <UUIDIdentifikator>ce7fcf97-a8a2-447a-8690-d38aa0f6e23c </UUIDIdentifikator> </ns2:objekttype> <ns2:objekthandling> <!-- Fødsel handlingen fra klassifikationen af "handlinger på forretningsobjekter af typen Person" --> <UUIDIdentifikator>1e5bb089-5445-44f8-9b65-bc854053f423 </UUIDIdentifikator> </ns2:objekthandling> <ns2:opgaveemne> <!-- Fiktivt emne --> <URNIdentifikator>urn:oio:kle:32.01.01</URNIdentifikator> </ns2:opgaveemne> </ns2:objektregistrering> </ns2:filtreringsdata> <ns2:leveranceinformation> <ns2:dannelsestidspunkt> <!-- Tidspunkt for beskedens opståen --> <TidsstempelDatoTid>2016-03-15T08:00:00 </TidsstempelDatoTid> </ns2:dannelsestidspunkt> <ns2:sikkerhedsklassificering> <!-- Fortrolige personoplysninger fra klassifikationen "sikkerhedsklassificeringer" --> <UUIDIdentifikator>44f4108b-26d4-46de-a90f-35e35b55b8d8 </UUIDIdentifikator> </ns2:sikkerhedsklassificering> </ns2:leveranceinformation> <ns2:gyldighedfra> <!-- Tidspunkt hvor hændelsen opstod --> <TidsstempelDatoTid>2016-03-15T08:00:10 </TidsstempelDatoTid> </ns2:gyldighedfra> </ns2:beskedkuvert><ns2:beskeddata> <!-- Eksempel på base64 encoding af beskeddata Hello World --> <Base64 Base64 encoding file-type=".xml" content-type="application/xml encoding="utf-8">sgvsbg8gv29ybgq=</base64> </ns2:beskeddata> </ns2:haendelsesbesked>
Serviceaftale vs. Beskeder
Beskedcentral til fordeling af forretningsmæssige hændelser AFSENDERSYSTEMER BESKEDFORDELER MODTAGERE Forretningsmæssig hændelse SAPA KY KSD STAR Ydelsesindeks Sag og dokumentindeks DUBU OMSORG
Eksisterende beskedtyper Stand alone beskeder CRP (mange- bla. fødsel, død, flytning) Tilmeldingsstatus til Digital Post og NemSMS Digital post NemSMS Sygehusophold Indlæggelse Udskrivelse Sag og Dokument indekset Ny sag Sag afsluttet Ydelsesindekset Ny ydelse Ydelse afsluttet Styrelse for Arbejdsmarked og rekruttering Sygemelding Ledighedstilmelding Ledighedsafmelding Snitfladegenereret beskeder SKAT Indkomstoplysning Skattekort ForsendelsesStatus Digital post Fjernprint NemSMS Arbejdsmarkedets Erhvervssikring Status på arbejdsskadesager Status på speciallægeerklæringer Social pension Helbredsprocent pensionister Mellemskab af privat sygesikring oplyst af pensionist UDK ændring på pensionssag
Sygehusophold (DIS17 og DIS20): As-is Region 1-5 Kommune 1-98 EPJ1 EPJ2 DIS20/17 VANS-net Besked (XDIS20/17) EOJ1 EOJ2 EPJ3 Negativ kvittering (CTL01/02) Positiv kvittering (CTL03) Negativ kvittering (CTL01/02) Positiv kvittering (CTL03) EOJ3 Elektronisk patient journal Elektronisk omsorgsjournal
Sygehusophold via Beskedfordeler v1.0 STS = Security Token Service BF = Beskedfordeler Region 1-5 EPJ1 Træk sikkerhedstoken Fælleskommunal infrastruktur STS Kommune 1-98 EOJ1 SAPA1 EPJ2 EPJ3 DIS20/17 VANS-net DIS20/17 Beskedagent Besked (XDIS20/17) BF EOJ2 SAPA2 Negativ kvittering (CTL02) MultiMed OK KMD SAPA3 Negativ kvittering (CTL02) Positiv kvittering (CTL03) EOJ3
Opgave 10 min Kan I se mulige anvendelser af beskedfordeler i jeres forretning eller organisation, som ikke findes i dag? Nye anvendelser af eksisterende beskeder? Nye beskedtyper, som ikke findes i dag?
Anbefaling omkring serviceaftaler Beskedtyper vs. Objekthandlinger Benyttes objekthandling kan samme Serviceaftale benyttes. Dette letter serviceaftaleadministration, men GDPR skal overholdes. Derfor kan det være nødvendigt med 2 Serviceaftaler, da ikke alle må modtage begge. Beskedtyper Syghusophold Objekthandlinger Indlæggelse, Udskrivelse Versus Beskedtyper SyghusopholdIndlæggelse Beskedtyper Syghusopholdudskrivelse 1 Serviceaftale 2 Serviceaftale
Dueslag for modtagere I nogle tilfælde masse-generes beskeder af batchjobs og dermed kan disse spærre for mere nødvendige beskeder. Derfor opret dueslag til: Straksbeskeder Massebeskeder Opret dueslag per kommune for at sikre sig i forhold til GDPR, og compliance med fremtidig sikkerhedsdesign af Beskedfordeler. Beskedfordeler Beskedfordeling Straksdueslag Massedueslag Modtager Begræns antallet af abonnementsudtryk. Det er reelt og-udtryk, brug faciliteter i kriteriesprog. get(beskedkuvert.filtreringsdata.relateretobjekt,0).objektid.urnidentifikator IN ("urn:oio:cpr:personhaendelse:020", "urn:oio:cpr:personhaendelse:007,.)
Kom godt i gang Læs Vejledning til anvendere af hændelsesbeskeder Sådan kommer du til at anvende hændelsesbeskeder Læs generelle vejledninger til sikkerhed Opret integrationer og serviceaftaler i ekstern test Download Beskedfordeler version 5.4.ZIP Comandline Java klient med sourcekode til afsendelse og modtagelse af beskeder B.01.03 Løsningsbeskrivelse for Beskedfordeler.pdf B.08.08 Underbilag 2N - Vilkår for integration til støttesystemet Beskedfordeler.pdf B.08.09 Underbilag 2O - Beskedkuvert.pdf Beskedfordeler 5.4 Release Note.pdf Beskedfordeler Kodeeksempler.zip D 12.02 - Brugerdokumentation Beskedfordeler.pdf D.09.02 Beskedfordeler-Besked-Aflever-Snitflade.pdf D.09.03 Beskedfordeler-Besked-Afhent-Snitflade.pdf D.09.04 Beskedfordeler-Besked-Afsend-Snitflade.pdf D.09.05 Beskedfordeler-Vaerdiliste-Snitflade.pdf D.09.12 Beskedfordeler-FlytBeskedTilFejlkø-Snitflade.pdf D.10.01 Fællesdokument for snitfladerne i Støttesystemerne.pdf Snitfladespecifikationer for BF.zip RabbitMQ: https://www.rabbitmq.com/#getstarted Java ver. 5.7.0 på JDK 8
Dokumentation Brugergrænseflade Vedligehold dueslag, abonnement og beskedtyper D 12.02 - Brugerdokumentation Beskedfordeler.pdf B.08.09 Underbilag 2O - Beskedkuvert.pdf Beskedfordeler B.01.03 Løsningsbeskrivelse for Beskedfordeler.pdf Opret besked på fejlkø SF1460_E Flyt Besked til Fejlkø D.09.12 Beskedfordeler-FlytBeskedTilFejlkø-Snitflade.pdf Send besked SF1460_C Aflever besked D.09.04 Beskedfordeler-Besked-Afsend-Snitflade.pdf Hent besked SF1460_D Afhent besked (pull) D.09.03 Beskedfordeler-Besked-Afhent-Snitflade.pdf Modtag besked SF1460_A Modtag besked (push) D.09.02 Beskedfordeler-Besked-Aflever-Snitflade.pdf Vedligeholde værdiliste SF1460_B Vedligehold værdiliste D.09.05 Beskedfordeler-Vaerdiliste-Snitflade.pdf
Referencer og kontakter Generelt KDI Vejledning til anvendere af hændelsesbeskeder Beskedfordeler dokumentation og kodeeksempler Beskedtypekatalog Sikkerhedsmodellen Security Token Service Forretningsmæssig support Teknisk og driftsmæssig support https://share-komm.kombit.dk/p133 https://sharekomm.kombit.dk/p133/ibrugtagning%20og%20test/delte%20dokumenter/vejledning%20til%20anvendere%20af%20hændel sesbeskeder.pdf https://share-komm.kombit.dk/p133/referencedokumenter/beskedfordeler%20version%205.1.zip https://share-komm.kombit.dk/p133/katalog%20over%20beskedtyper/default.aspx https://share-komm.kombit.dk/p133/referencedokumenter/sts%20vilkår/bilag%202a%20- Start her %20Beskrivelse%20af%20sikkerhedsmodellen%20i%20Rammearkitekturen%20version%202.2.pdf https://share-komm.kombit.dk/p133/referencedokumenter/securiy%20token%20service%20version%202.0.zip kdi@kombit.dk sts-support@kmd.dk Integration Reference Type Modtag besked (push) SF1460_A REST Vedligehold værdiliste SF1460_B Web Service Aflever besked SF1460_C AMQP Afhent besked (pull) SF1460_D AMQP Flyt Besked til Fejlkø SF1460_E REST
FORDELINGSKOMPONENT
Hvorfor en fordelingskomponent I den Kommunale Rammearkitektur har man ønsket at bevæge sig væk fra: Centrale sagsbærende systemer: EDSH og KMD sag til Sagsbærende fagsystemer: Kommunernes Ydelsessystem (KY), Kommuners Sygedagpenge (KSD), Digitalisering af Udsatte Børn og Unge (DUBU) I denne sammenhæng er fordelingskomponentens opgave at to fagsystemer kan udveksle sagsdokumenter og journalnotater gennem en standardiseret grænseflade. Dermed er det lettere at skifte et enkelt system. Borgerservice SAPA KY Post, e-mail IO manager Fordelings komponent KSD Sagsbærende systemer Førstegangsregistreret ESHD DUBU
Hvad kan Fordelingskomponenten fordele? Fordele journalnotater Fordele sagsdokumenter Fordele blanketter og formularer Til Digital Post
Fordele journalnotat Når der oprettes et journalnotat i et fagsystem, men sagen/sagsområdet bor i et andet fagsystem Dataformatet er OIOstandarden Notat i ren tekst
Fordele sagsdokumenter Når sagsdokumentation oprettes eller findes i et fagsystem, men sagsområdet og/eller sagen bor i et andet fagsystem. Fx fra ESDH til DUBU. Dataformatet følger OIOstandarden for sagsdokumenter Alle typer af sagsdokumenter kan sendes, fx Word, PDF og video
Fordele blanketter og formularer Når afsender og modtager er enige om og fastlægger, hvilke data de gerne vil udveksle Bruges fx af UDK, der sender oplysninger om månedlige pensionsudbetalinger til KY via Fordelingskomponenten Fordelingen af blanketter og formularer kan ske til Digital Post
Hvordan virker Fordelingskomponenten? Serviceplatformen Modtager A Afsender (1) Afsender kender sag/fagsystem Fordelingskomponenten (1) Videresender direkte Modtager B (1) (2) Opmærker med KLE (2) FK finder via fordelingsregler modtagersystem (2) Videresender Modtager C (2) Sags-/dokumentindeks Fordelingsregler Digital Digital Post Post
Eksempel: Fordeling til ny sag Borgerservice Fordelingskomponenten Sygedagpenge Sygemeldt borger SAPA Sender Vælger modtagersyste m Videresender KSD Sagsbehandler Sagsbehandler Opretter journalnotat med KLE: 32.30.04/Udbetaling af Sygedagpenge og handlingsfacet G01/Generelle sager Slår op og finder modtagerløsning Fordelingsregler KLE 32.02.04 => KSD Opretter opgave til videre sagsbehandlin g Tjekker at notatet vedrører sygedagpenge og godkender/afviser modtagelse Foretager nødvendig sagsbehandling Sags-/dokumentindeks
Fordelingsregler i detaljer Eksempel på fordelingsregel Udbetaling af sygedagpenge Generelle sager Fagsystem 32* eller 32.30* eller 32.30.04 G01/Generelle sager 01/01/2018 01/01/2025 KSD Felt Titel Kanaltype Emne Handling Gyldig fra Gyldig til Systemnavn Forklaring Kan svare emnetitel, der er defineret i KLE - evt. suppleret med titlen på handlingsfacetten. Mulige kanaler er Fagsystemer eller Digital Post. Skal udfyldes med et specifikt KLE-nummer eller KLEemnegruppe-nummer, der så inkluderer alle underliggende numre. En fordelingsregel med 32.30.* vil derfor dække de underliggende emner 32.30.04 og 32.30.06. Fordelingskomponenten indeholder ikke en kopi af KLE eller integration til KLE, så Fordelingskomponenten indeholder oprettede fordelingsregler. Korrekt format valideres. Udfyldes med specifik kode for handlingsfacetten. Dato hvorfra fordelingsreglen skal gælde. Dato hvortil fordelingsreglen skal gælde. Her vælges det modtagersystem, der skal modtage dokumenter og journaler for fordelingsreglen. Modtagersystemer, hvor leverandøren har indgået en serviceaftale med kommunen om anvendelse af fordelingskomponenten, vil fremgå af listen.
Eksempel: Fordeling til kendt sag Borgerservice Sygedagpenge Sygemeldt borger Sagsbehandler Ser i SAPA, at der allerede findes en sag i KSD SAPA Sender Videresender direkte til KSD, der er angivet som modtagersyste m Videresender KSD Opretter opgave til videre sagsbehandlin g Sagsbehandler Tjekker at notatet vedrører sygedagpenge og godkender/afviser modtagelse Fordelingsregler KLE 32.02.04 => KSD Foretager nødvendig sagsbehandling Fordelingskomponenten Sags-/dokumentindeks
Fordelingskomponenten, afsender, modtager og Støttesystemerne SAPA Afsendersystemer KMD-SAG Infrastruktur STS-Adgangsstyring KSD Modtagersystemer KY ESDH Kommunesystem x DUBU KMD-SAG Fordelingskomponenten ESDH Kommunesystem Z Digital Post STS Sags-og dokumentindek s
Kaldsmønster for fordelingskomponent Afsender Serviceplatformen Modtager Afsend Anmodning (EP_AS1) FordelingsobjektAfsendRequest (1) FordelingsobjektAfsendResponse (2) Modtag teknisk kvittering (EP_AS2) Modtag anmodning og returnere teknisk kvittering (EP_MS1) FordelingsobjektModtagRequest (3) FordelingsobjektModtagResponse (4) FordelingskvitteringModtagAnvenderRequest (5) FordelingskvitteringModtagAnvenderResponse (6) Samme endepunkt/ operation Afventer genoptagelse af proces Modtag forretningskvittering (EP_AS2) FordelingskvitteringModtagAnvenderRequest (9) Returnere forretningskvittering EP_MS2) FordelingskvitteringModtagRequest (7) FordelingskvitteringModtagAnvenderResponse (8) Denne del flow benyttes ikke ved Digital post som modtager FordelingskvitteringModtagAnvenderResponse (10)
Overordnet XML/XSD opbygning
Kuvert feltbeskrivelse Distributionskontekst (Routing) Niv Feltnavn Kard Værdisæt Betegnelse 1 DistributionContext 1 - Udgør kuvert til styring af routing af objektet og den efterfølgende asynkrone kvittering 2 AnvenderTransaktionsID 1 UUID Unik identifikation på denne specifikke overførsel. Benyttes til at koordinere asynkrone svar i anvendersystemet. 2 DistributionTransaktionsID 0:1 UUID Unik identifikation tildelt af distributionskomponenten. 2 DigitalPostMeddelelsesID 0:1 Tekst(30) Indeholder unik id der anvendes mod Digital post for en afsendelse. 2 AfsendendeMyndighed 1 8 cifret tal CVR-nummer for afsender aktør. 2 RoutingMyndighed 1 8 cifret tal CVR-nummer for modtager aktør. 2 RoutingValg (choice 1) 1-3 RoutingEmneHandling 1-4 RoutingEmneFacet 1 Tekst KLE Emnefacet (nn.nn.nn). 4 RoutingHandlingFacet 0:1 Tekst KLE Handlingsfacet (xn). 2 RoutingValg (choice 2) 1-3 RoutingModtagerAktoer 0:1 UUID IT-System-aktør (Relation til organisation). 2 DokumentFilnavn 0:1 Tekst Udgør navnet på den fil på SFTP-serveren der indeholder den binære information.
Overordnet opbygning af XSD for Formularer
FordelingsobjektAfsendRequest (1)
FK-ansvarlig og FK-administrator Obligatorisk opgave Anne og Benny opretter og vedligeholder kommunens fordelingsregler Jeg har ansvaret for kommunens forretningsmæssige fastlæggelse, brug og vedligeholdelse af fordelingsregler, der skal sikre fordeling af sagsinformation mellem fagsystemer og til andre myndigheder. Jeg sikrer et tværgående perspektiv på fordelingsreglerne. Jeg har indsigt i kommunens anvendelse af KLE og arbejder også med KLE-opmærkning og fordeling af sager i vores ESDH-løsning FK-ansvarlig Anne Hansen FK-administrator Benny Jensen Jeg konfigurerer de fordelingsregler, der er fastlagt. Det gør jeg i den brugergrænseflade, der findes på Serviceplatformen. Jeg er vant til at arbejde i webbaserede skærmbilleder, men ved faktisk ikke så meget om KLE, så jeg har et tæt samarbejde med Anne.
Vedligeholdelse af fordelingsregler Kommunen skal organisere og sikre etablere en proces for og en organisering af den løbende vedligeholdsopgave som afledes af anvendelse af fordelingskomponenten. Vedligeholdsopgaver kan f.eks. være: Der er identificeret en fejl i fordelingsreglen. Der ændres i KLE-klassifikationen udgået og nye KLE-nr. Der kommer en ny leverandør af modtagersystemet Der er ikke en KLIK-opgave for denne opgave ansvaret at sikre at organisering af dette er på plads ligger hos Programleder i samarbejde med fordelingskomponentansvarlig
Jobcenterløsning i Varde GDPR-sikker løsning gør livet nemmere for medarbejdere på jobcenter for 18 30 årige Mobil Server Fordelingskomponent Jobcenter
Opgave 10 min Kan I se mulige anvendelser af fordelingskomponent i jeres forretning eller organisation, som ikke findes i dag? Nye anvendelser af udveksling af journalnotat og sagsdokument? Muligheder ved anvendelse af fomularer?
Referencer og kontakter Generelt KDI Snitfladebeskrivelse Vejledning til Fordelingskomponenten - leverandører Implementerings- og brugervejledning - Fordelingskomponenten - Kommuner Produktblad NOT0601 Bestilling af fordelingsregler. Sikkerhedsmodellen Security Token Service Forretningsmæssig support Teknisk og driftsmæssig support https://share-komm.kombit.dk/p133 https://share-komm.kombit.dk/p133/integrationsbeskrivelser/sf2900%20-%20fordelingskomponent%20v2.4.1.pdf https://share- komm.kombit.dk/p133/ibrugtagning%20og%20test/delte%20dokumenter/vejledning%20til%20fordelingskomponenten%20- %20leverand%C3%B8rer.pdf https://share-komm.kombit.dk/p133/ibrugtagning%20og%20test/delte%20dokumenter/implementerings- %20og%20brugervejledning%20-%20Fordelingskomponenten%20-%20Kommuner.pdf https://share-komm.kombit.dk/p133/ibrugtagning%20og%20test/delte%20dokumenter/produktblad%20- %20Fordelingskomponenten.pdf Fås ved henvendelse til helpdesk@serviceplatformen.dk https://share-komm.kombit.dk/p133/ibrugtagning%20og%20test/delte%20dokumenter/bestilling%20af%20fordelingsregler.xlsx https://share-komm.kombit.dk/p133/referencedokumenter/sts%20vilkår/bilag%202a%20- %20Beskrivelse%20af%20sikkerhedsmodellen%20i%20Rammearkitekturen%20version%202.2.pdf https://share-komm.kombit.dk/p133/referencedokumenter/securiy%20token%20service%20version%202.0.zip kdi@kombit.dk helpdesk@serviceplatformen.dk Start her