December 2012 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
Dato Navn Version Beskrivelse 28-01-2013 Søren Korgaard Nielsen 1.1 Ingen ændringer
Indholdsfortegnelse 1. Indledning 4 1.1. Læsevejledning 4 2. XML-skemaer 5 2.1. Overblik over udviklede snitflader 5 2.2. Introduktion til XML-skemaer og webservices 6 2.2.1. XML-skemaets rolle 6 2.2.2. Grundlæggende om webservices 6 2.3. Implementering af DHUV -webservices 7 2.3.1. Bevillinger og posteringer mellem DHUV-systemet og økonomisystemet 7 2.3.2. Bestilling fra DHUV-systemet til leverandørsystemet 8 2.3.3. Opfølgning fra DHUV-systemet til leverandørsystemet samt status fra leverandørsystemet til DHUV -systemet 9 2.3.4. Stam- og grundoplysninger mellem DHUV-systemet og leverandørsystemet 10 Bilag A. Visuelt overblik over snitflader 11 A.1. Bevillinger fra DHUV -systemet til økonomisystemet 12 A.2. Posteringer fra økonomisystemet til DHUV-systemet 13 A.3. Bestilling fra DHUV-systemet til leverandørsystemet 14 A.4. Opfølgning fra DHUV-systemet til leverandørsystemet samt status fra leverandørsystemet til DHUV -systemet 16 A.5. Stam- og grundoplysninger fra DHUV-systemet til leverandørsystemet 17 A.6. Stam- og grundoplysninger fra leverandørsystemet til DHUVsystemet 18 A.7. Datastrukturen AddressPostal 19 Bilag B. XML-skemaer 20
1. Indledning Dette dokument udgør den afsluttende dokumentation af de udviklede XML-skemaer. Dokumentet indeholder forslag til, hvordan XML-skemaer kan bringes i anvendelse ved hjælp af webservices. Herigennem vil det gennemførte standardiseringsarbejde kunne medvirke til at understøtte DHUVarbejdsgangene mellem kommuner og leverandører. Arbejdet med at udvikle XML-skemaer har udgjort fase 3 af DHUVintegrationsstandardiseringsprojektet. Til grund for det gennemførte modelleringsarbejde ligger de forretningshændelser, der blev identificeret, og de databeskrivelser, der blev udarbejdet, for de udvalgte informationsudvekslinger i projektets første og anden fase 1. 1.1. Læsevejledning Dokumentet bygger oven på de tidligere udarbejdede databeskrivelser. I kapitel 2 beskrives detaljer omkring design og anvendelse af de XMLskemaer, der på teknisk niveau anvendes til at standardisere informationsudveksling mellem DHUV-systemer og henholdsvis økonomi- og leverandørsystemer. Bilag A rummer et grafisk overblik over de udviklede XML-skemaer. Bilag B refererer til den tekniske leverance bestående af selve XMLskemaerne. Bilag C indeholder beskrivelser fra projektets fase 1 og 2. I denne leverance fokuseres der på selve XML-skemaerne, der er slutproduktet af fase 3 og i mindre grad på de systemer, der skal kobles. Dette dokument viser, hvordan snitfladerne kan bringes i anvendelse og giver en indledende forklaring af deres kontekst. En egentlig vejledning til standardiseret dannelse af webservices og etablering af testservere til afprøvning og test af snitfladerne er ikke omfattet af denne leverance. Målgruppen for dette dokument er læsere med nogen teknisk forståelse samt indblik i de begreber og termer, der knytter sig til DHUV-projektet. 1 Servicebeskrivelser: Standardisering af snitflader i forbindelse med DHUV-projektet (bilag C) 4 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
2. XML-skemaer I dette afsnit beskrives detaljer omkring design og anvendelsen af de XMLskemaer, der er udgangspunktet for standardiseringen af informationsudvekslingen mellem DHUV-systemer og henholdsvis økonomi- og leverandørsystemer. Kapitlet giver indledningsvist et overblik over de udviklede snitflader. Derefter beskrives, hvordan snitfladerne kan indgå i webservices som kan implementeres hos de forskellige aktører, der indgår i dataudvekslingen. 2.1. Overblik over udviklede snitflader For hver af de seks snitflader er der udviklet et samlende XML-skema (jf. visuelt overblik i bilag A), der afspejler det hierarki af elementer, der fremgår af bilag B. Den følgende liste viser de tekniske betegnelser for de overordnede datastrukturer, der er udviklet for hver snitflade. Desuden angives et nummer for hver snitflade, der benyttes gennemgående i kapitlet. Snitfladenummer Navn på snitflade Navn på XML-skema 1 Bevillinger fra DHUV-systemet til økonomisystemet 2 Posteringer fra økonomisystemet til DHUV-systemet 3 Bestilling fra DHUV-systemet til leverandørsystemet 5 Stam- og grundoplysninger fra DHUV-systemet til leverandørsystemet 6 Stam- og grundoplysninger fra leverandørsystemet til DHUVsystemet Bevillinger_fra_DHUV_til_oekonomisystem Posteringer_fra_oekonomisystem_til_DHUV Bestilling_fra_DHUV_til_leverandoersystem 4 Opfølgning fra DHUV-systemet til leverandørsystemet samt status fra leverandørsystemet til DHUVsystemet Opfoelgning_fra_DHUV_til_leverandoersystem_samt_status _fra_leverandoersystem_til_dhuv Stamdata_fra_DHUV_til_leverandoersystem Stamdata_fra_leverandoersystemet_til_DHUV 5 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
2.2. Introduktion til XML-skemaer og webservices Dette afsnit giver en grundlæggende introduktion af sammenhængen i mellem XML-skemaer og webservices, som er nyttig ved læsning af det efterfølgende afsnit. 2.2.1. XML-skemaets rolle Det er XML-skemaet, der fastlægger alle detaljer om, hvilke datastrukturer og dataelementer der kan passere igennem en snitflade. I XML-skemaet kan der eksempelvis stilles krav om, at data skal være af en bestemt type såsom tekst, tal eller en dato. Desuden kan indholdet begrænses yderligere igennem særlige krav, for eksempel til tekstformat, højeste antal cifre i en prisangivelse eller krav om, at indholdet vælges fra en prædefineret liste. Figuren til venstre er et lille udsnit af XMLskemaet, der definerer snitflade 4. Udsnittet viser en del af den datastruktur, der er benyttet i forbindelse med opfølgning på indsatser (IndsatsOpfoelgningStruktur). Det fremgår af eksemplet, at de to første elementer i denne struktur er en beskrivelse af indsatsen (IndsatsBeskrivelseTekst) og en angivelse af formålet med indsatsen (Indsats- FormaalTekst). Det ses, at elementerne begge har datatypen string altså tekststreng og at de begrænser tekstindholdets maksimale længde til henholdsvis 1.000 og 500 tegn. For hver af de 6 snitflader er der udviklet et XML-skema, der benytter samme metode og syntaks som vist i eksemplet. 2.2.2. Grundlæggende om webservices En udbredt metode til at bringe en standardiseret snitflade i anvendelse er at implementere den ved hjælp af SOAP-webservices. I webservices udveksles strukturerede forretningsdata i XML-format i henhold til nogle retningslinjer, der er kendt på forhånd af begge parter i udvekslingen. Disse retningslinjer er defineret i en servicekontrakt. Det er i denne sammenhæng, XML-skemaer bringes i anvendelse, idet en af hovedbestanddelene i servicekontrakten netop er XML-skemaer. Når XML-skemaerne ligger fast, kan de indgå i en webservice, der udstilles til brug for andre parter, og det sikres således, at dataoverførsel altid sker i henhold til servicekontraktens underliggende XML-skemaer. En webservice kan rumme en eller flere såkaldte webserviceoperationer, der hver svarer til et stykke veldefineret forretningsfunktionalitet. Webserviceoperationen udfy l- der sin rolle ved at håndhæve formatet for indgående og udgående XML- 6 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
data. Derudover er det naturligvis afgørende at parterne, der kommunikerer, har en fælles forståelse af hvilken betydning dataindholdet tillægges. Den aktør, der udstiller en webservice, benævnes ofte udstilleren eller den udstillende part. Tilsvarende benævnes en aktør, der fortager kald til en webservice, den kaldende part. Der kan uden problemer være flere aktører, der har samtidig adgang til at foretage kald til en webservice. Det bemærkes, at det er den kaldende part, der igangsætter kommunikationen, og at udstilleren blot stiller sin service til rådighed for eventuelle kald uden at vide, om eller hvornår de kommer. Det vil således være den aktør, der har behov for at aflevere eller indhente data, der udgør den kaldende part. Hvis brugen af webservices skal understøtte sagsgangen mellem aktørerne på en hensigtsmæssig måde, er det afgørende, at webservicen er udstillet hos den relevante aktør. 2.3. Implementering af DHUVwebservices I det følgende gives en række anvisninger for, hvordan webservices, webserviceoperationer og XML-skemaer tænkes implementeret hos de tre typer aktører, der indgår i dataudvekslinger i DHUV-sammenhæng. Der angives konkrete placeringer af webservices hos de respektive aktører, der muliggør udveksling af data i henhold til de forretningshændelser, der er beskrevet i det tidligere dokument 2. I de beskrevne snitflader indgår nedenstående tre typer aktører: DHUV-systemet. Der er tale om kommunens DHUV-system, og der indgår således kun et enkelt DHUV-system. Økonomisystemet. Dette vedrører kommunens økonomisystem, og der indgår derfor kun et system af denne type i snitfladerne. Leverandørsystemet. Vedrørende DHUV-systemets kommunikation med leverandørsystemer er det væsentligt at bemærke, at hver kommune typisk har flere leverandører. Snitfladerne er beskrevet med udgangspunkt i kommunens kommunikationsbehov med den enkelte leverandør, hvorfor der gennemgående benyttes bestemt ental: Leverandørsystemet. 2.3.1. Bevillinger og posteringer mellem DHUVsystemet og økonomisystemet I dette afsnit beskrives samspillet mellem snitflade 1 og snitflade 2, der vedrører kommunikation af henholdsvis bevillings- og posteringsdata for indsatser. I snitflade 1 kommunikeres bevillingsdata til økonomisystemet, hvorimod 2 Servicebeskrivelser: Standardisering af snitflader i forbindelse med DHUV-projektet 7 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
snitflade 2 tillader kommunikation retur til DHUVsystemet af de faktiske posteringer vedrørende en bevilget indsats. De XML-skemaer, der ligger til grund for de to snitflader, er næsten ens, hvilket skyldes, at det næsten er det samme dataindhold, der tillades i begge retninger. For snitflade 1 vil det være kommunens økonomisystem, der udstiller en webserviceoperation, for eksempel navngivet ModtagIndsatsBevilling. Kommunikationen ved hjælp af snitfladen gennemføres ved, at DHUV-systemet kalder den udstillede webserviceoperation og derved sender XML-data svarende til en ny bevilling til økonomisystemet. Økonomisystemet foretager en registrering af bevillingsdata og svarer kaldet med en status, som indikerer om kaldet er korrekt gennemført 3. Det XML-skema, der er udviklet til at understøtte snitflade 1, hedder Bevillinger_fra_DHUV_til_oekonomisystem. Når posteringsdata skal kommunikeres tilbage til DHUV-systemet, vil det kunne ske ved, at økonomisystemet kalder en webserviceoperation, for eksempel navngivet ModtagIndsatsPosteringer, der er udstillet af DHUV-systemet. Trinene er de samme som tidligere. Først kaldes operationen i DHUVsystemet med de relevante XML-data indeholdende posteringsdata, dernæst registreres data i DHUVsystemet, og endelig afsluttes kaldet med en statusbesked. Det XML-skema, der er udviklet til at understøtte snitflade 2, hedder Posteringer_fra_oekonomisystem_til_DHUV. Bevillinger og posteringer sammenkædes på tværs af systemerne ved hjælp et id kaldet BevillingIdentifikator, der dannes i DHUV-systemet og sendes over snitfladerne hver gang. 2.3.2. Bestilling fra DHUV-systemet til leverandørsystemet Snitflade 3 er beregnet til overførsel af en bestilling til et leverandørsystem hos en specifik leverandør. Da det er DHUV-systemet, der står som afsender af bestillingsdata, vil det være leverandørsystemet, der er udstiller snitfladens webservice. Af dette følger, at alle leverandører skal udstille tilsvarende webservices for at kunne modtage digitale bestillinger fra kommuner. Det XML-skema, der er udviklet til at understøtte snitflade 3, hedder Bestilling_fra_DHUV_til_leverandoersystem. 3 Der er for alle snitflader tale om en teknisk status, der viser om kaldet er korrekt gennemført. 8 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
Som del af de XML-data, der udgør bestillingen, indgår også et id kaldet BestillingIdentifikator, der unikt identificerer bestillingen i forbindelse med den senere opfølgning. 2.3.3. Opfølgning fra DHUV-systemet til leverandørsystemet samt status fra leverandørsystemet til DHUV-systemet Snitflade 4 benyttes i forbindelse med, at en kommune ønsker at rekvirere en status fra en given leverandør vedrørende en indsats, som kommunen har bestilt. Denne snitflade er anderledes end de foregående, idet den er struktureret omkring et stykke manuelt opfølgningsarbejde, der skal udføres hos leverandøren. Som det fremgår af figuren, foregår dataudvekslingen i 7 trin. 1. I det første trin kaldes en webserviceoperation, der er udstillet hos leverandørsystemet, for eksempel ModtagOpfoelgAnmodning. Dette kald benytter en datastruktur bestående af både en borgers cpr-nummer og et DHUVbestillings-id svarende til det, der er beskrevet for snitflade 3. 2. Leverandørsystemet registrerer opfølgningsanmodningen. 3. Leverandørsystemet besvarer servicekaldet med en teknisk statusbesked, der udelukkende fortæller, om anmodningen er modtaget. 4. Det fjerde punkt i udvekslingen består i, at leverandøren som manuel sagsbehandling fremskaffer opfølgningsdata vedrørende bestillingen. Først når det punkt er afsluttet, kan næste trin igangsættes. 5. Efter de relevante opfølgningsdata for bestillingen er indtastet hos leverandøren, skifter rollerne mellem aktørerne. Således er det leverandørsystemet, der nu kalder en webserviceoperation (fx ModtagOpfoelgInformation), som DHUV-systemet udstiller. Det er også en mulighed, at dette kald sker på baggrund af en timer i leverandørsystemet. 6. De rekvirerede informationer registreres i DHUV-systemet. 7. DHUV-systemet kvitterer med en teknisk statusbesked. Det XML-skema, der er udviklet til at understøtte snitflade 4, hedder Opfo elgning_fra_dhuv_til_leverandoersystem_samt_status_fra_leverandoer system_til_dhuv. 9 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
2.3.4. Stam- og grundoplysninger mellem DHUVsystemet og leverandørsystemet Snitflade 5 og 6 anvendes i forbindelse med udveksling af stam- og grunddata mellem DHUV-systemet og et eller flere leverandørsystemer. Det er reelt de samme data, der udveksles i de to snitflader. Derved begrænser forskellen mellem de to sig til den måde, hvorpå de anvendes. Snitflade 5 anvendes i de tilfælde, hvor der foreligger nye stam- eller grunddata for en borger i kommunens DHUV-system. Når dette indtræder, bør DHUV-systemet kontakte alle leverandører, der har behov for kontakt til den pågældende borger. Dette kan ske ved, at DHUV-systemet kalder en webserviceoperation (fx ModtagBorgerStamdata), der udstilles hos hver af de leverandører, der indgår i samarbejdet med kommunen. På baggrund af igangværende og afsluttede indsatser i DHUV-systemet kan kommunen afgøre, hvilke leverandører det er relevant at sende borgerens stam- og grundoplysninger til. Det XML-skema, der er udviklet til at understøtte snitflade 5, hedder Stamdata_fra_DHUV_til_leverandoersystem. Snitflade 6 benyttes til at sende samme type data blot i den modsatte retning. Det er i denne sammenhæng leverandørsystemet, der besidder opdaterede stam- og grundoplysninger for en borger. Leverandørsystemet kalder en webserviceoperation, der er udstillet af DHUVsystemet. Når der ankommer nye data til DHUV-systemet fra et leverandørsystem via snitflade 6, vil det være muligt direkte at benytte snitflade 5 til at udsende disse data til andre leverandører. På denne måde vil DHUV-systemet fra kommunalt hold kunne hjælpe med at holde alle relevante leverandørsystemer ajour med denne type data. Det XML-skema, der er udviklet til at understøtte snitflade 6, hedder Stamdata_fra_leverandoersystemet_til_DHUV. 10 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
Bilag A. Visuelt overblik over snitflader I dette bilag vises et grafisk overblik for hver af de 6 snitflader. Flere snitflader benytter datastrukturen AdressPostal, som vises som overblik sidst i dette bilag. 11 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
A.1. Bevillinger fra DHUV-systemet til økonomisystemet Dette er et grafisk overblik over datastrukturen, der anvendes i snitflade 1: Bevillinger_fra_DHUV_til_oekonomisystem. 12 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
A.2. Posteringer fra økonomisystemet til DHUV-systemet Dette er et grafisk overblik over datastrukturen, der anvendes i snitflade 2: Posteringer_fra_oekonomisystem_til_DHUV. 13 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
A.3. Bestilling fra DHUV-systemet til leverandørsystemet Dette er et grafisk overblik over datastrukturen, der anvendes i snitflade 3: Bestilling_fra_DHUV_til_leverandoersystem. Figuren er af pladshensyn er delt i to, og elementet IndsatsStruktur (se blå markering) findes under det samlede overblik. 14 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
15 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
A.4. Opfølgning fra DHUV-systemet til leverandørsystemet samt status fra leverandørsystemet til DHUV-systemet Dette er et grafisk overblik over datastrukturen, der anvendes i snitflade 4: Opfoelgning_fra_DHUV_til_leverandoersystem_samt_status_fra_ leverandoersystem_til_dhuv. 16 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
A.5. Stam- og grundoplysninger fra DHUV-systemet til leverandørsystemet Dette er et grafisk overblik over datastrukturen, der anvendes i snitflade 5: Stamdata_fra_DHUV_til_leverandoersystem. 17 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
A.6. Stam- og grundoplysninger fra leverandørsystemet til DHUVsystemet Dette er et grafisk overblik over datastrukturen, der anvendes i snitflade 6: Stamdata_fra_leverandoersystemet_til_DHUV. 18 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
A.7. Datastrukturen AddressPostal Dette er et grafisk overblik over datastrukturen AddressPostal, der anvendes i flere snitflader. 19 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
Bilag B. XML-skemaer XML-skemaer svarende til alle 6 snitflader er fremsendt elektronisk i filformatet.xsd til Socialstyrelsen i forbindelse med afslutning af projektets tredje fase. 20 XML-skemaer Standardisering af snitflader i forbindelse med DHUV-projektet
Om Deloitte Deloitte lev erer y delser inden f or rev ision, skat, consulting og f inancial adv isory til både of f entlige og priv ate v irksomheder i en lang række brancher. Vores globale netv ærk med medlemsf irmaer i mere end 150 lande sikrer, at v i kan stille stærke kompetencer til rådighed og y de serv ice af højeste kv alitet, når v i skal hjælpe v ores kunder med at løse deres mest komplekse f orretningsmæssige udf ordringer. Deloittes cirka 182.000 medarbejdere arbejder målrettet ef ter at sætte den højeste standard. Deloitte Touche Tohmatsu Limited Deloitte er en betegnelse f or Deloitte Touche Tohmatsu Limited, der er et britisk selskab med begrænset ansv ar, og dets netv ærk af medlemsf irmaer. Hv ert medlemsfirma udgør en separat og uaf hængig juridisk enhed. Vi henv iser til www.deloitte.com/about f or en udf ørlig beskriv else af den juridiske struktur i Deloitte Touche Tohmatsu Limited og dets medlemsf irmaer. 2012 Deloitte Statsautoriseret Rev isionspartnerselskab. Medlem af Deloitte Touche Tohmatsu Limited