Tilbudsportalen Servicespecifikation

Størrelse: px
Starte visningen fra side:

Download "Tilbudsportalen Servicespecifikation"

Transkript

1 Socialstyrelsen Tilbudsportalen Servicespecifikation Web-services Version 1 Ole Martin Henriksen, Socialstyrelsen

2 DOKUMENTHISTORIK Navn Dato Ændring Ole Martin Henriksen (Socialstyrelsen) Version 0.9 Ole Martin Henriksen (Socialstyrelsen) Version 1.0 Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 2

3 INDHOLD 1 Indledning Målgruppe Dokumentets disposition Forvaltningsprincipper Integrationsaftale Services udstilles i et servicekatalog Versionering Opbygning af servicekataloget Læsevejledning Formen af beskrivelse af web services og -operationer Roller og ansvar Generelle tekniske forhold REST Sikkerhed Authentication af system-til-system (S2S) bruger HTTP-Headere Konkret overholdelse af standarder Kaldeeffekt-kategorier Tilbudsportalen Tilbud Forretningsmæssigt overblik Strukturen af data til et tilbud Organisation It-bruger Personale Målgruppepakke Indsats IndsatsTakst YdelsesTakst FagligTilgang Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 3

4 Metode Stamoplysninger Barn BrugerBetalingType BrugerBetalingPris BrugerBetaling Pladser Medarbejder Adresse Tilsynsblanket Paabud Audit - Indberetning Forretningsmæssigt overblik Begrebsmodel til Audit Kvalitetsmodel Procesinformation REST Services - Tilbudsportalen Ressourcer Metadata.xml Entity/view.xml Overblik Unik identifikation Use Cases Use case: henttilbudsdetaljer Use case: oprettilbud Tilsynsblanket Use case: indberettilsynsblanket Audit data Use case: indberetauditdata Filer Use case: henttilbudsfil Sikkerhed Definitioner System-til-System autentifikation med Basic Authentication og SSL Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 4

5 5.3 Single-signon X-REST-identity header Fejlhåndtering Overordnet om fejlsituationer Kommunikationsscenarier Fejlhåndtering ved synkron kommunikation Konkrete fejlsituationer Konkrete fejlbeskeder FAQ Spørgsmål: Stamoplysninger vs stamoplysninger_r Spørgsmål: Målgruppekategorier Spørgsmål: Indberetter på et tilbud Spørgsmål: Sygefravær på tilbuddet Spørgsmål: Recursive = Spørgsmål: Faggrupper og timetal Spørgsmål: Arbejdstimer pr. uge for tilbud og afdeling Spørgsmål: Driftsaftaler Spørgsmål: Paragraffer på indsats Spørgsmål: Resultatmetoder Spørgsmål: Felter på tilsynsblanket Spørgsmål: Navne på afdelinger Spørgsmål: Relation mellem organisation og indsatser Spørgsmål: Navgivning af takstniveauer Spørgsmål: kvalitetsmodel Spørgsmål: konklusioner på tilsynsblankt og audit - kvalitetsmodel Entiteter og attributter Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 5

6 Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 6

7 1 Indledning Formålet med denne servicespecifikation er at sikre en formel beskrivelse og en forståelse af de services Tilbudsportalen (TP) udbyder til eksterne aktører. Servicespecifikationen er udarbejdet med fokus på system-til-system snitflader. I figur 1 markeret med rød skravering data ind data ud data ind data ud data ind data ud data ind Figur 1 - Tilbudsportalens grænseflader og snitflader Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 7

8 Figur 2 viser eksempler på system-til-system-integration mellem eksterne aktører og Tilbudsportalen. Figur 2 - Tilbudsportalen og eksterne aktører Bemærk: Det er ikke servicespecifikationens formål at give læseren en dybere forretningsmæssig indsigt i Tilbudsportalen. Det betyder at viden om muligheder og begrænsninger for de enkelte indberetninger skal hentes via andre kilder. En af disse er de informationer Tilbudsportalen stiller til rådighed på deres hjemmeside - Det er ikke servicespecifikationens formål, at beskrive den interne funktionalitet i TP løsningen. Fokus er udelukkende på system-til-system snitflader og den information, der gør det muligt at anvende de udstillede services. Dette dokument er generisk af natur og følger derfor ikke nødvendigvis versioneringen af services. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 8

9 1.1 Målgruppe Målgruppen for dette dokument er: Udviklere, der arbejder med udviklingen af TP-løsningen. System- og forretningsapplikations-udviklere hos de aktører, der ønsker at benytte TP s system-tilsystem-grænseflade. Projektdeltagere hos Socialstyrelsen. Projektdeltagere hos eksterne leverandører for Socialstyrelsen herunder IT Arkitekterne. 1.2 Dokumentets disposition Udover nærværende kapitel, er servicekataloget organiseret i følgende kapitler: Kapitel 1 og 2 beskriver de principper der ligger til grund for web services og web service ressourcer, som er beskrevet i servicespecifikationen. Kapitel 3 og 4 indeholder en tabel oversigt over web services og web service operationer, som TP-løsningen udstiller. Kapitel 5 beskriver den sikkerhed, som TP-løsningen baserer sig på. Kapitel 6 indeholder fejlsituationer, som kan opstå i TP-løsningen. Kapitel 7 indeholder en FAQ oftest stillede spørgsmål. Kapitel 8 indeholder en oversigt over entiteter og deres tilhørende attributter. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 9

10 1.3 Forvaltningsprincipper Principper er generelle regler og vejledninger, som har en blivende værdi og som sjældent ændres. Her informerer principperne om hvordan TP-løsningens services bedst understøtter Socialstyrelsens mission og mål med TP-projektet. De principper der angives her sætter rammen for de services, der udvikles til TP løsningen. Principperne gælder alle services der udstilles i servicekataloget og som anvendes af den interne og eksterne portal samt de professionelle aktører. Der kan f. eks. være principper for navngivning, servicegranularitet osv. Principper kan understøttes af konkrete standarder og uddybende vejledninger Integrationsaftale Inden snitflader kan benyttes skal der indgås en integrationsaftale mellem Socialstyrelsen og den eksterne aktør. Se mere her: Services udstilles i et servicekatalog Services er udstillet i Socialstyrelsens servicespecifikation, forankret i Socialstyrelsens begrebsmodel, med servicekvalitet og vilkår for anvendelse Versionering Versionering af Tilbudsportalen følger versionering af Tilbudsportalens indberetning. Lovgivningsmæssige ændringer kan træde i kraft en given dato. Hvis lovændringen berører systemets snitflader, er der ikke mulighed for at have mere end en version af snitfladen tilgængelig i drift. Der findes derfor altid kun én gældende version af TP services. Ved ændringer i TP services gælder følgende: a) Mindre ændringer er bagud kompatible. Dette er f.eks. tilfældet ved tilføjelse af et optionelt element i en REST service. b) Større ændringer giver migration til ny version (gammel version kan herefter ikke anvendes) Ændringer er altid gældende pr. en given dato. Dette gælder uanset om det er større eller mindre ændringer. Det er aktørernes eget ansvar, at deres systemer er opdateret i forhold til den gældende version. En gældende version vil inkludere: a) Begreber b) Datamodel c) URI er d) Forretningsregler e) Valideringsregler Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 10

11 Der vil dog ikke altid være ændringer til alle dele og eksterne TP service-klienter forventes at kunne køre uændret videre for en række standard ændringsscenarier eksempelvis tilføjelse af en ikke krævet attribut. Mindre versioner ændrer (pr. definition) ikke på eksempelvis gyldigheden af eksisterende indberetninger. De er bagud- og forudkompatible. Større versioner kan kræve omvendt opgradering og migrering. Valideringer i systemet vil altid kun eksistere i aktuel version. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 11

12 2 Opbygning af servicekataloget Dette afsnit beskriver skabeloner for beskrivelser til REST-services som TP-løsningen udstiller. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 12

13 2.1 Læsevejledning Formen af beskrivelse af web services og -operationer Beskrivelsen af hver service og deres operationer følger nedenstående skabelon. Service - ressource Beskrivelse <Beskrivelse i forretningstermer af hvad formålet med servicen er > Roller Responsible: Accountable: Consulted: Informed: Operation - <operationsnavn> Beskrivelse Input <Beskrivelse i forretningstermer af hvad formål med operationen er og hvad den producerer> <parameternavn> <Beskrivelse i forretningsmæssige termer af parameteren og dens betydning> Output <parameternavn> eller N/A hvis operationen ikke har et output. <Beskrivelse i forretningsmæssige termer af parameteren og dens betydning> Hvis der angives et output, er der tale om en synkron operation. Fejlhåndtering Sikkerhed Interaktionsmønster Kaldeeffekt <Angivelse af relevante fejlhåndteringsmønster> <Angivelse af fx: Reliable operation <Angivelse af hvilken type forretningsmæssigt interaktionsmønster operationen indgår i - se afsnit <Angivelse af hvilke kategori operationen tilhører mht. hvad effekten er af Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 13

14 at kalde den - se afsnit POST Eksempel Figur 3: Skabelon for beskrivelsen af web services og web service ressourcer Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 14

15 2.1.2 Roller og ansvar Som en del af beskrivelsen af den enkelte web service, er det angivet hvilken organisatorisk enhed, der varetager givne roller i forhold til den pågældende web service. Rollerne er angivet efter den såkaldte RACImodel, som er en metode til angivelse af roller og ansvar. RACI-modellen opererer med rollerne: Responsible Ansvarlig Accountable Ejer Consulted Afhængig af Informed Interessent Responsible Rollen responsible er ansvarlig for at implementere og vedligeholde servicen. I praksis vil det sige, at rollen er ansvarlig for at etablere de resources, der beskriver service interfacet, for at realisere ("kode" og "deployere") servicen, samt for at gøre den tilgængelig og drifte den. Der er mulighed for at der kan optræde flere, der er responsible. Eksempelvis kan responsible være ansvarlig for at realisere ( kode og deployere ) services, samt gøre dem tilgængelige og sørge for driften af dem. Responsible kan uddelegere ansvaret til andre roller fra RACI-modellen. Accountable Rollen accountable har som den forretningsmæssige ejer af servicen ansvar for: at service-specifikationen dækker de forretningsmæssige behov at service-specifikationen anvender de rigtige forretningsmæssige begreber i de beskeder, som servicen udveksler. Den accountable kan ikke uddelegere ansvaret. Som udgangspunkt vil Socialstyrelsen altid være accountable, da Socialstyrelsen er den naturlige ejer af alle services. Consulted Rollen consulted tildeles/varetages typisk af interessenter, som er afhængige af en given service. Disse parter er berettiget til at skulle høres i forbindelse med enhver ændring af de services, som de er interessenter i. De skal typisk afgive et høringssvar, hvor de giver udtryk for deres syn på den planlagte ændring eller udarbejder et ændringsforslag. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 15

16 Der er en række interessenter som er afhængige af de services TP udstiller. De anvender disse services i samspil med deres egne it-systemer, og baserer en del af deres forretning på TP s services. Informed Rolle informed tildeles/varetages af interessenter som blot skal orienteres om at der foretages ændringer. Det kan fx dreje sig om sektorer, forskellige råd, OIO eller statslige myndigheder. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 16

17 2.2 Generelle tekniske forhold REST Tilbudsportalens snitflader er implementeret som REST-services. Anvendelsen af REST til kommunikation med TP tager udgangspunkt i de regler og anbefalinger som findes i Roy Fieldings beskrivelse af REST (Representational State Transfer). Her under principperne for Identification of resources, Manipulation of resources through these representations, Self-descriptive messages samt Hypermedia as the engine of application state (HATEOAS). Se en detaljeret beskrivelsen af TP s REST-services her: Sikkerhed REST-services som Tilbudsportalen udstiller, baserer sig på simpel REST over https. Services i Tilbudsportalen tilgås via Basic Authentication og tiltænkt til realisering af kritiske web service resourcer, hvor forretningssemantikken fordrer sikker kommunikation med fuld sporbarhed. Yderligere detaljer findes i Basic Authentication dokumentationen hos w3.org (http://www.w3.org/protocols/http/1.0/spec.html#basicaa) Authentication af system-til-system (S2S) bruger Tilbudsportalen anvender en-vejs certifikat authentication i forbindelse med etablering af SSL forbindelse til en web service og anvender VOCES certifikater fra TDC CA (http://www.certifikat.dk/). Figur 4: System-til-system flow viser hvordan flowet er i forbindelse med kald til beskyttet TP service. 3.-Verificerer cer9fikat Relevant-CA CA-=-Cer9ficate-Authority Aktør Server 1.-Aktør-kalder-service 2.-TP-præsenterer SSL-cer9fikat 4.-Aktør-får-adgang 9l-service TP Server TP Keystore (SSL-Servercer9fikat) Figur 4: System-til-system flow HTTP-Headere Alle REST beskeder mellem aktører og TP skal følge http standarden. Ydermere skal der benyttes en proprietær attribut som en del af http-headerne. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 17

18 X-SIV-REST-identity skal indeholde information om brugeren i det kaldende 3. parts system. Følgende viser et eksempel på indholdet af TP http beskeder: GET 01T01:00:00+01:00 HTTP/1.1 Accept-Encoding: gzip,deflate Host: admin.tilbudsportalen.dk Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) Authorization: Basic dxnlcm5hbwu6cgfzc3dvcmq= X-SIV-REST-identity: "name=hans Ernst Lassen; phone= ; token=1087ebd8-aabf-45da-a871-4b08ab0d2853" Konkret overholdelse af standarder Internationale standarder HTTP 1.1 (http://www.w3.org/protocols/rfc2616/rfc2616.html) XML version 1.0 (http://www.w3.org/tr/rec-xml/) XML Schema 1.0 (http://www.w3.org/tr/xmlschema-0/) XML Signature (XML-DSIG) (http://www.w3.org/tr/xmldsig-core/) Tegnsæt Data der udveksles mellem Tilbudsportalen og eksterne systemer skal overholde UTF-8 tegnsæt-encoding Namespaces Ved udarbejdelsen af xml-filer er følgende namespace respekteret: Kaldeeffekt-kategorier Webservice operationer er kendetegnet ved, at de hver især tilhører én af følgende kategorier med hensyn til hvilken effekt kald af dem har Ufarlig operation En operation, som er kendetegnet ved, at den ikke ændrer på betydende dele af TP-systemets tilstand eller data. Alternativt at det af anden grund er uden betydning, om den aktiveres flere gange Idempotent operation En operation, som er kendetegnet ved, at det ikke gør nogen forskel om den aktiveres én eller flere gange, med de samme parametre - resulterende sideeffekter i TP-systemet, samt resultatværdier vil være de samme hver gang. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 18

19 Dubletafvisende operation En operation, der er kendetegnet ved, at den afviser at udføre den tiltænkte funktion, hvis den aktiveres med parameter-værdier, som er eksakt de samme, som den tidligere er blevet aktiveret med. En konsekvens heraf er, at kalderen uden risiko vil kunne gentage aktiveringen af operationen - med givne parameter-værdier - i fald der skulle være tvivl om, hvorvidt en eller flere tidligere aktiveringer er gennemført Sporbar operation En operation, som er kendetegnet ved, at den efterlader et veldefineret spor (fx i form af en specifik sideeffekt) i TP-systemet, respektive aktør-systemet, som det efterfølgende er muligt at verificere er til stede - fx ved forespørgsel via en anden operation Risikabel operation En operation, som er kendetegnet ved, at den ændrer på betydende dele af TP-systemets tilstand eller data, og at den hverken er idempotent, dubletafvisende eller sporbar. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 19

20 2.3 Tilbudsportalen Tilbud Forretningsmæssigt overblik Beskrivelse af services og ressourcer i dette afsnit relaterer sig primært til tilbudsdata. Eksempelvis services der giver mulighed for at indberette blanketter vedrørende tilbud, samt services der bidrager til simpel søgning efter blanketter og tilbudsdata. Servicen understøtter operationer til at læse, skrive og opdatere tilbudsdata Strukturen af data til et tilbud Figur 5: Struktur fra Tilbudsportalen illustrerer den overordnede, generiske struktur for tilbudsdata. Figur 5: Struktur fra Tilbudsportalen Elementerne der indgår i Figur 5: Struktur fra Tilbudsportalen er forklaret i de følgende afsnit. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 20

21 2.3.3 Organisation Generelt opfattes entiteten Organisation som et Tilbud. Organisationen kan have en relation til andre organisationer. Når dette er tilfældet er det et udtryk for et hierarki eks: Figur 6: Hierarki for organisation (tilbud) Figur 6: Hierarki for organisation (tilbud) viser hvordan hierarkiet kan se ud med Socialstyrelsen som organisation i øverste niveau. Niveau 2 indeholder tilsynsmyndighederne og niveau 3 er selve tilbuddene. Hver tilsynsmyndighed fører tilsyn med et tilbud. Fordeling af tilbud pr. tilsynsmyndighed sker efter postnummer på hovedafdelingen på tilbuddet. Bemærk at en tilsynsmyndighed ikke må føre tilsyn med egen kommunes tilbud/fam It-bruger Stamdata for brugere af Tilbudsportalens indberetning Personale Stamdata for personale på et tilbud. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 21

22 2.3.6 Målgruppepakke Sammensatte målgrupper et tilbud understøtter eks. psykisk funktionsnedsættelse, kommunikationsnedsættelse, alkoholmisbrug eller hørenedsættelse, sindslidelse, krigsveteran etc Indsats Stamdata for indsatsområder et tilbud kan tilbyde. eks. støtte til kontakt og samvær, støtte til uddannelse og beskæftigelse etc IndsatsTakst Stamdata for indsatstakster. En indsatstakst indeholder en eller flere ydelsestakster YdelsesTakst Stamdata for en ydelsestakst herunder navn og pris for ydelsen FagligTilgang Stamdata for hvilke faglige tilgange et tilbud har til en bestemt indsats Metode Stamdata for faglige tilgange et tilbud baserer socialfaglige indsatser på Stamoplysninger Stamoplysninger om tilbudet. Eks. juridisk grundlag, ejerform, driftsherre etc Barn Et tilbud kan også være en plejefamilie. I det tilfælde vil der være knyttet et eller flere børn til tilbuddet via stamoplysningerne BrugerBetalingType Stamdata for en type brugerbetaling. Eks navn og beskrivelse BrugerBetalingPris BrugerBetaling Stamdata for pris når en borger benytter et tilbud Pladser Stamdata for pladser på et tilbud. Eks. pladstype, total antal pladser og ledige pladser Medarbejder Stamdata på en medarbejder på et tilbud Adresse Stamdata for en adresse på et tilbud. Et tilbud kan have flere adresser tilknyttet Tilsynsblanket Indeholder informationer om tilsyn hos et tilbud Paabud Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 22

23 2.4 Audit - Indberetning Forretningsmæssigt overblik Services og ressourcer i denne gruppe relaterer sig udelukkende til indberetning af auditdata. Servicen indeholder operationer til at læse, skrive og opdatere der muliggør at aktører indberetter audit data til TP. Bemærk at Auditdata udstilles IKKE på Tilbudsportalen Find Tilbud men kun er tilgængelig Audit-gruppen i Socialstyrelsen Begrebsmodel til Audit Figur 7 Begrebsmodel til Audit data Tilsynsdata består af 2 grupper data - kvalitetsmodel og procesinformation Kvalitetsmodel Kvalitetsmodellen består at en række temaer. Hvert tema består et eller flere kriterier. Hvert kriterium består af en eller flere indikatorer. Tema Kriterium Indikator Uddannelse og beskæftigelse. Tilbuddet støtter borgerne i at udnytte deres fulde potentiale i forhold til uddannelse beskæftigelse. Tilbuddet opstiller i samarbejde med borgerne konkrete mål for borgernes skolegang, uddannelse eller beskæftigelse. Figur 8 - Eksempel på et tema fra kvalitetsmodellen Den fuldstændige kvalitetsmodel og varianter af denne kan findes her: Tilbud: https://www.retsinformation.dk/forms/r0710.aspx?id=160984#bil1 Plejefamilier: https://www.retsinformation.dk/forms/r0710.aspx?id=160984#bil2 Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 23

24 2.4.4 Procesinformation Indeholder stamdata for selve sagsbehandlingen af tilsynet eks relevante skæringsdatoer og baggrund for tilsyn Tilsyn Indeholder stamdata for dato for påbegyndt tilsyn, er tilsynet anmeldt, og om der er foretaget fysiske besøg på afdelingerne Foranledning Indeholder stamdata for hvilken foranledning der har været til tilsynet samt data for foranledningstypen. En foranledning kan indeholde en referense til et andet tilsyn der er førte til et påbud. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 24

25 3 REST Services - Tilbudsportalen Dette afsnit indeholder informationer til den operationelle del af TP-REST-services herunder adgang til REST-services samt overordnet beskrivelse af ressourcer i TP-REST-services. Test - Socialstyrelsen URI REST-beskrivelse Login Metadata Info https://siv.socialstyrelsen.dk/portal-test/rest/v1/ https://siv.socialstyrelsen.dk/portal-test/rest/ Basic Authentication https://siv.socialstyrelsen.dk/portal-test/rest/v1/metadata/ Preprod - Socialstyrelsen URI REST-beskrivelse Login Metadata Info https://siv.socialstyrelsen.dk/portal-preprod/rest/v1/ https://siv.socialstyrelsen.dk/portal- preprod /rest/ Basic Authentication https://siv.socialstyrelsen.dk/portal-preprod/rest/v1/metadata/ Produktionsmiljø - Socialstyrelsen Info URI REST-beskrivelse Login Metadata Basic Authentication 3.1 Ressourcer Ressource Beskrivelse Revision /bruger Stamoplysninger for en bruger indberetningen 1, 2 og dennes relationer til roller og organisation(tilbud) /organisation Stamoplysninger for et Organisation eller Tilbud 1, 2 /rolle Roller til brugere af indberetningen 1, 2 /adresse_r2 Adresseoplysninger på et tilbud 2 /barn_r2 Et tilbud kan også være en plejefamilie. I det 2 Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 25

26 tilfælde vil der være knyttet eller flere børn til tilbuddet via stamoplysningerne. /brugerbetaling_r2 Stamdata for pris når en borger benytter et 2 tilbud. /brugerbetalingdetalje_r2 Stamdata for pris når en borger benytter et 2 tilbud. /brugerbetalingtype_r2 Stamdata for en type brugerbetaling. Eks navn 2 og beskrivelse. /fagligtilgang_r2 Stamdata for hvilke faglige tilgange et tilbud har 2 til en bestemt indsats. /indsats_r2 Indsatspakker 2 /indsatstakst_r2 Pris for indsatspakke 2 /maalgruppepakke_r2 Sammensatte målgruppepakker 2 /medarbejder_r2 Sammensatte målgrupper et tilbud understøtter 2 eks. Personlighedsforstyrrelse og Hjemløshed /metode_r2 Stamdata for faglige tilgange et tilbud baserer 2 socialfaglige indsatser på. /paabud_r2 2 /personale_r2 Stamdata for personale på et tilbud. 2 /pladser_r2 Stamdata for pladser på et tilbud. Eks pladstype, 2 total antal pladser og ledige pladser /stamoplysninger_r2 Stamoplysninger om tilbudet. Eks. juridisk 2 grundlag, ejerform, driftsherre etc. /tilsynsblanket_r2 Indeholder informationer om tilsyn hos et 2 tilbud. /ydelsetakst_r2 Stamdata for en ydelsestakst herunder navn og 2 pris for ydelsen. /kvalitetsmodel_a Stamdata for kvalitetsmodellen Audit /tilsyn_a Stamdata for tilsyn Audit /foranledning_a Stamdata for foranledning til tilsyn Audit I forbindelse med Tilsynsreformens ikrafttrædelse 1. jan 2014 sker der en migrering af data på Tilbudsportalen fra revision 1 af modellen til revision Metadata.xml Metadata.xml Indeholder en beskrivelse af alle entiteter, relationer mellem entiteter, attributter på entiteter og aktiveringsregler(validerings- og visningsregler). Metadata.xml afspejler modellen for Tilbudsportalens indberetning se afsnit og Audits indberetning se afsnit Entity/view.xml For hver entitet er der en view.xml der indeholder en blanketdefinition dvs. en komplet struktur over hvordan hjælpetekster, felter og sektioner er orkestreret. Dette bruges dels til genering af Tilbudsportalens indberetningsblanketter men også som skabelon til hvilke felter der skal post når der eksempelvis oprettes et nyt tilbud via REST-snitfladerne. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 26

27 3.4 Overblik Nedenstående indeholder et overblik over hvordan Tilbudsportalens indberetning fungerer. Indberetning Ud fra Metadata.xml og entity/view.xml genererer SIV-motoren blanketter til webbrugergrænsefladen samt REST-snitfladerne. Dette betyder at når der tilføjes/fjernes et felt i metadata.xml/entity/view.xml slår det igennem i webbrugergrænsefladen og REST-snitfladerne. 3.5 Unik identifikation Alle entiteter på Tilbudsportalen kan identificeres med unik nøgle. Nøglen der benyttes er ISO-standarden UUID ( Universal Unique Identifier). Alt computerudstyr, der er i stand til at kommunikere med andet hardware, har en unik hardwareadresse. En UUID skabes ved en kombination af denne hardwareadresse, det aktuelle klokkeslæt og tilfældighedsprincipper. UUID kan genereres automatisk af computeren. Det betyder, at der ikke skal være en central administrativ enhed, som skal tildele identifikatoren i modsætning til eksempelvis et CPR-nummer, som tildeles via CPR-registret. Alle pc er kan generere UUID er. Desuden findes der UUID-generatorer på internettet. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 27

28 Et eksempel på en UUID kan se således ud: 752C368D-9ED1-397B-57233AAB71E56A2B. Ved oprettelse af en entitet skal UUID tildeles af aktør serveren. Forsøg på oprettelse af en entitet med et UUID der allerede findes på TP vil bliver afvist med en fejlbesked at entiteten allerede eksisterer. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 28

29 Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 29

30 4 Use Cases I dette afsnit beskrives use cases der kan gennemføres ved brug af Tilbudsportalens REST-services. Hver use case er efterfulgt af en specifikation for den/de services der kan benyttes for at udføre use casen Use case: henttilbudsdetaljer En bruger af et eksternt system ønsker at se detaljer for et tilbud fra Tilbudsportalen. System henter oplysninger om alle tilbuddene eller det valgte tilbud. Figur 9: sekvensdiagram for henttilbud Figur 10: sekvensdiagram for henttilbudsdetaljer Use case: oprettilbud En bruger af et eksternt aktør system ønsker at oprette et nyt tilbud i Tilbudsportalen. Systemet opretter et nyt tilbud via Tilbudsportalen REST-services. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 30

31 Figur 11: sekvensdiagram for opretnyttilbud Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 31

32 REST service organisation Beskrivelse Servicen indeholder mulighed for at: Hente en liste over alle tilgængelige Tilbud Hente stamdata for et enkelt Tilbud Oprettelse af et nyt Tilbud Roller Responsible: Socialstyrelsen IT-drift Accountable: Tilbudsportalen Consulted: Informed: Tilsynssystem Eksterne leverandører Operation GET organisation/ Beskrivelse Returnerer en liste over alle tilgængelige Tilbud. Det er kun et begrænset attributter der vises pr. Tilbud Uri /organisation Input Output http-status: 200 XML med en liste indeholdende alle tilbuddene Fejlhåndtering 400 Bad request 401 Unauthorized 404 Not found Sikkerhed Interaktionsmønster Kaldeeffekt Forespørgsel-svar Ufarlig operation Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 32

33 Operation GET organisation/{uuid} Beskrivelse Returnerer stamdata for et enkelt Tilbud. Stamdata består af attributter indeholdende tekstuel beskrivelse af tilbuddet. Endvidere indeholder stamdata også tilbuddets relationer til andre entiteter i Tilbudsportalens objektmodel. Uri Input /organisation/{uuid} UUID eks: 9b300db8-8efd-4acd-8f36-00b4927ae617 Output http-status: 200 XML med Stamdata for det valgte tilbud Fejlhåndtering 400 Bad request 401 Unauthorized 404 Not found Sikkerhed Interaktionsmønster Kaldeeffekt Forespørgsel-svar Ufarlig operation Operation POST organisation Beskrivelse Uri Input Opretter en ny tilbuds-entitet /organisation/{uuid} Myndighed UUID Tilbud UUID Tilbuddets navn Tilbudstype Juridisk grundlag State: create Output http-status: 200 XML: <messages xmlns="http://siv.servicestyrelsen.dk/1.0"> <status>ok</status> <message type="info">set attribute: [attribut]</message> Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 33

34 <operation type="create"> <entities> <entity uuid="63f35d30-2cf5-11e3-a65c c00021" handle="organisation" href="http://thebe.itarkitekterne.dk/portaladmin/rest/v1/organisation/63f35d30-2cf5-11e3-a65c c00021" state="partial"/> </entities> </operation> </messages> Fejlhåndtering 400 Bad request 401 Unauthorized 404 Not found 415 Unsupported media type Sikkerhed Kaldeeffekt Forespørgsel-svar Dubletafvisende operation(uuid), Sporbar operation XML- eksempel på POST Interaktionsmønster <entities xmlns="http://siv.servicestyrelsen.dk/1.0"> <entity handle="organisation" uuid="63f35d30-2cf5-11e3-a65c c00021" state="create"> <attribute handle="navn"> <value>tilbudet Det evige eksempel</value> </attribute> <relation handle="organisation.hierarki" role="underorganisation" href="http://thebe.itarkitekterne.dk/portal-admin/rest/v1/organisation/b78946e d25-83e6-63eca7fbd565/overorganisation" state="full"><entity uuid="79012ac1-4a77-450d- 9b42-a6b00ed48dc9" handle="organisation" role="overorganisation" href="http://thebe.itarkitekterne.dk/portal-admin/rest/v1/organisation/79012ac1-4a77-450d-9b42-a6b00ed48dc9" state="partial"><attribute handle="navn"><value>socialstyrelsen</value></attribute></entity></relation> </entity> </entities> Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 34

35 4.2 Tilsynsblanket Use case: indberettilsynsblanket En bruger af et eksternt system har gennemført et tilsyn på et tilbud. Brugeren ønsker at overføre tilsynsblanketten til Tilbudsportalen. Når tilsynsblanketten er overført til Tilbudsportalen skal brugeren logge ind på Tilbudsportalen og verificere samt godkende informationerne for tilbuddet. Når brugeren har godkendt information bliver tilsynsblanketten tilgængelig på Tilbudsportalen Find Tilbud. Brugeren skal indberette en tilsynblanket pr. tilsyn inden data kan verificeres og godkendes på Tilbudsportalen. Figur 12: sekvensdiagram for indberetning af tilsynsblanket. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 35

36 Web service tilsynsblanket_r2 Beskrivelse Når der er foretaget et tilsyn hos et Tilbud skal informationerne fra tilsynet overføres fra et eksternt system til Tilbudsportalen. Oplysningerne fra tilsynet er ikke synlig på Tilbudsportalen Find Tilbud før alle informationerne er verificeret på Tilbudsportalen og der trykkes godkend. Roller Responsible: Socialstyrelsen IT-drift Accountable: Tilbudsportalen Consulted: Informed: Tilsynssystem Eksterne leverandører Operation POST tilsynsblanket_r2/ Beskrivelse Uri Input Efter endt tilsyn indberettes tilsynsblanketten på det pågældende tilbud. /tilsynsblanket_r2 Tilsynstype (godkendelse af nyt tilbud, godkendelse af eksisterende tilbud) Afgørelse (godkendt, godkendt med vilkår, ikke godkendt) Dato for godkendelse Godkendt med vilkår Indhold i vilkår Dato - frist for opfyldelse af vilkår Ikke godkendt Begrundelse Driftsorienteret tilsyn Status (Fortsat godkendt,fortsat godkendt med påbud, Fortsat godkendt med skærpet tilsyn,ikke godkendt) Dato for seneste anmeldte tilsynsbesøg Dato for seneste uanmeldte tilsynsbesøg Dato for seneste administrative tilsyn Dato for seneste ændring i status for godkendelsen Fortsat godkendelse med påbud og fortsat godkendelse med skærpet tilsyn Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 36

37 Påbuddets indhold Frist for opfyldelse af påbuddet Fortsat godkendelse med skærpet tilsyn Begrundelsen for det skærpede tilsyn Udløbsdato for skærpet tilsyn Ikke godkendt Begrundelse for afgørelse om ophør af godkendelse Dato for ophør Konklusionen for tilsynet på det samlede tilbud Konklusionen Udannelse og beskæftigelse Konklusionen Selvstændighed og sociale relationer Konklusionen Målgruppe, metoder og resultater Konklusionen Organisation og ledelse Konklusionen Kompetencer Konklusionen Økonomi Konklusionen Fysiske rammer State: create Se afsnit 8 Entiteter og attributter for komplet liste af attributter. Output HTTP-status: 200 XML: <messages xmlns="http://siv.servicestyrelsen.dk/1.0"> <status>ok</status> <message type="info">set attribute: [attribut]</message> <operation type="create"> <entities> <entity uuid="63f35d30-2cf5-11e3-a65c c00021" handle="organisation" href="http://thebe.itarkitekterne.dk/portaladmin/rest/v1/organisation/63f35d30-2cf5-11e3-a65c c00021" state="partial"/> </entities> </operation> </messages> Fejlhåndtering 400 Bad request 401 Unauthorized 404 Not found Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 37

38 415 Unsupported media type Sikkerhed Kaldeeffekt Forespørgsel-svar Dubletafvisende operation(uuid), Sporbar operation Operation GET tilsynsblanket_r2/ Beskrivelse Uri Returnerer en liste over alle tilgængelige tilsynsblanketter. /tilsynsblanket_r2 Input Output http-status: 200 XML: Liste over alle indsendte tilsynsblanketter Fejlhåndtering 400 Bad request 401 Unauthorized 404 Not found Sikkerhed Interaktionsmønster Interaktionsmønster Kaldeeffekt Forespørgsel-svar Ufarlig operation Operation GET tilsynsblanket_r2/{uuid} Beskrivelse Returnerer stamdata for en enkelt tilsynsblanket. Stamdata består af attributter indeholdende tekstuel beskrivelse af tilsynsblanketten. Endvidere indeholder stamdata også tilsynsblankettens relationer til andre entiteter i Tilbudsportalens objektmodel. Uri Input /tilsynsblanket_r2/{uuid} UUID Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 38

39 Output http-status: 200 XML: information vedr. den ønskede tilsynsblanket. Fejlhåndtering 400 Bad request 401 Unauthorized 404 Not found Sikkerhed Interaktionsmønster Kaldeeffekt Forespørgsel-svar Ufarlig operation Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 39

40 4.3 Audit data Use case: indberetauditdata En bruger af Tilsynssystemet har gennemført et tilsyn på et tilbud. Brugeren ønsker at overføre auditdata vedr. tilsynet på et tilbud til Tilbudsportalen.Brugeren kan indsende audit data én gang og opdatere data mange gange pr. tilsyn. Bemærk at auditdata efterfølgende ikke er tilgængelig på Tilbudsportalen Find Tilbud. Figur 13: sekvensdiagram for indberetning af auditdata. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 40

41 REST service - auditdata Beskrivelse Når der er foretaget et tilsyn hos et Tilbud skal auditdata(kvalitetsmodel og procesinformation) fra tilsynet overføres til Tilbudsportalen. Auditdata fra tilsynet er IKKE synlig på Tilbudsportalen Find tilbud. Roller Responsible: Socialstyrelsen IT-drift Accountable: Tilbudsportalen Consulted: Tilsynssystem, Socialstyrelsen Databank, Socialstyrelsen - Audit Informed: Operation POST auditdata_r2/ Beskrivelse Uri /kvalitetsmodel_a /tilsyn_a /foranledning_a Input Kvalitetsmodel Processinformation State: create Se afsnit 8 Entiteter og attributter for komplet liste af attributter. Output http-status: 200 XML: <messages xmlns="http://siv.servicestyrelsen.dk/1.0"> <status>ok</status> <message type="info">xyz xyz</message> </messages> Fejlhåndtering 400 Bad request 401 Unauthorized 404 Not found Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 41

42 415 Unsupported media type Sikkerhed Interaktionsmønster Kaldeeffekt Forespørgsel-svar Idempotent operation Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 42

43 4.4 Filer Use case: henttilbudsfil En bruger af Tilsynssystemet ønsker at hente stamdata på et Tilbud fra Tilbudsportalen herunder uploadede filer. Figur 14: sekvensdiagram til hent fil der er uploadet som supplement til stamdata for et tilbud. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 43

44 REST service stamdata Beskrivelse Hvert Tilbud har stamdata tilknyttet. Stamoplysninger er tekstuel beskrivelse af tilbuddet. I indberetningen er det muligt at uploade en fil med supplerende informationer der efterfølgende er tilgængelig som binært data på stamdata. Roller Responsible: Socialstyrelsen IT-drift Accountable: Tilbudsportalen Consulted: Tilsynssystem Informed: Operation GET stamoplysninger/{uuid} Beskrivelse Uri Input Returnerer stamdata for et tilbud. Tekstuelle beskrivelser og evt. referencer til uploadede filer. / stamoplysninger UUID Output http-status: 200 XML en eller flere attribut elementer indeholdende en URI til en uploadet fil. Eks: <attachment name="tilsynsrapport Køge Lænke-ambulatorium - marts 2010.pdf" uuid="d55aabab-dde6-4c1d-8278-e88dc3ce8c5c" size="96786" contenttype="application/pdf" href="http://thebe.itarkitekterne.dk/portal- admin/rest/v1/stamoplysninger/1f38db5c a75- b060a1cfd670/s1155/d55aabab-dde6-4c1d-8278-e88dc3ce8c5c"/> Fejlhåndtering 400 Bad request 401 Unauthorized 404 Not found Sikkerhed Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 44

45 Interaktionsmønster Kaldeeffekt Operation GET stamoplysninger/{uuid}/{bilagstype}/{bilag-uuid} Beskrivelse Uri Input Returnerer stamdata for et tilbud. Tekstuelle beskrivelser og evt. referencer til uploadede filer. stamoplysninger/{uuid}/{bilagstype}/{bilag-uuid} UUID på stamdata Bilagstype: s31 s63 s115 s140 s142 s5533 s1491 s15104 s15105 s15106 s15107 s15109 s1155 Samarbejdsrelationer Vedtægter for bestyrelsen Revisionspåtegning Effektevaluering Brugerevaluering Samarbejdsrelationer Plantegning Procesevaluering Effektevaluering Brugerevalueringer Tilsynsrapport Revisionspåtegning Øvrig dokumentation UUID på bilag Output http-status: 200 Binært data Fejlhåndtering 400 Bad request 401 Unauthorized 500 Internal Server Error <messages xmlns="http://siv.servicestyrelsen.dk/1.0"> <status>error</status> <message type="error">failed to load binary attachment</message></messages> Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 45

46 Sikkerhed Interaktionsmønster Kaldeeffekt Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 46

47 5 Sikkerhed 5.1 Definitioner Autentifikation: brugervalidering og dækker over processen med at logge brugeren ind eller indsamle den information, der skal til for at identificere brugeren entydigt. Autorisation: brugerens rettigheder - hvem har lov til hvad. 5.2 System-til-System autentifikation med Basic Authentication og SSL Kommunikation mellem en Aktør og TP foregår i et trust mellem serverne hos Aktøren og TP. TP autentificeres ved hjælp af et server-side certifikat, som beskrevet ovenfor. Eksterne aktørers servere autentificeres overfor TP ved hjælp af username / password med Basic Authentication. Alle forespørgsler skal derfor have et http header felt på følgende form, hvor brugernavn og adgangskode er base64 encoded: Authorization: Base64Encode(username:password) Ydermere skal der sendes info om den bruger der tilgår data. TP er forpligtiget til at logge al aktivitet i tilbudsdata og henføre denne aktivitet til én specifik bruger. Eksterne aktører skal derfor knytte et unikt brugerid, en adresse samt et brugernavn på den aktive bruger i system det kaldende system. Disse data sendes i http headeren på følgende form: X-SIV-REST-identity: "name=fulde Navn; = Adresse; phone=telefon Nummer; token=uuid Fra Aktør System" 5.3 Single-signon En it-bruger i systemet har et antal organisationstilknytninger (mindst een) og it-brugeren benyttes til at autorisere operationer (ved hjælp af de roller og organisationstilknytninger den har). IT-BRUGER <-> ORGANISATION 1. FInd UID på den ORGANISATION man vil logge brugeren ind med som default (opslag på PNR eller MYNDIGHEDSKODE). 2. Find UID på den BRUGER man vil logge ind som 3. Kald nedenstående ticket service. 4. redirect brugeren til ticket-service URL'en. Eksempel: ORGANISATION=Fåborg-Midtfyn/Tilsynskommune: b78946e d25-83e6-63eca7fbd565 BRUGER=Tilsynssystem/Administrator: 78069e83-b9a6-43c5-8c1a-3a c8 Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 47

48 som returnerer: <status result="ok" expire=" t13:45:45+02:00" href="http://test.siv.socialstyrelsen.dk:80/portaladmin/login?ticket=7rkwlejv8q8isirv0cmj2jfjaqtfibda"> <message> created ticket for 78069e83-b9a6-43c5-8c1a-3a c8, organisation=b78946e d25-83e6-63eca7fbd565 </message> </status> Man sender herefter en redirect attributten. En ticket udløber efter 1 minut. Man kan angive Organisations UUID'ere som it-brugeren er direkte tilknyttet og Underorganisationer til disse X-REST-identity header Det er muligt at FLERE eksterne brugere benytter det samme it-bruger objekt på serveren, understøtter Tilbudsportalen en mekanisme, så kan man i kaldet til ticket servicen (urlen.../ticket) angiver yderligere oplysninger om den specifikke bruger ved at sætte følgende special-header: X-REST-identity: "name=hans Ernst Lassen; phone= ; token=1087ebd8-aabf-45da-a871-4b08ab023453" Informationerne bliver så bundet til ticket'en som en ekstraoplysning der kan tilgår når der redirigeres til selve ticket urlen (fra <status/> resultat xml'en). Navn, og token er mandatory phone er optionelt. Man kan tilføje ekstra felter efter behov (de gemmes som key/value i SIV'en til senere fremsøgning). token skal indeholde en oplysning som gør at man kan genfinde brugeren i det kaldende system (f.eks. et brugerid eller lignende). Hvis der bliver behov for at spore tilbage til hvilken bruger der faktisk har udført en operation er det token vi bruger som nøgle. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 48

49 6 Fejlhåndtering Med begrebet fejlhåndtering menes systemmæssig fejlhåndtering i form af fejlrapportering fra TP til aktørerne og aktørerne til TP. Den driftsmæssige og dermed manuelle aktioner ved håndtering af fejlsituationer er ikke indeholdt i dette dokument Overordnet om fejlsituationer Registrering af information om opståede fejlsituationer Alle eksterne aktører der benytter TP-snitfladerne skal registrere information om de fejlsituationer der måtte opstå. Informationen skal registreres af hensyn til den kortsigtede udredning og udbedring af konkret opståede fejlsituationer, såvel som af hensyn til den eventuelle langsigtede korrektion af de forhold, som får den konkrete type af fejlsituationer til at opstå. Af hensyn til effektiv udredning skal alle parter registrere information, som så vidt muligt indeholder tværgående korrelationsinformation Udveksling af information om fejlsituationer Alle parters it-systemer skal indrettes til, at udveksling af information om fejlsituationer, skal foregå efter de fælles aftalte retningslinjer Kommunikationsscenarier I Tilbudsportalens snitflader understøtter kun synkron kommunikation. Når der opstår en fejl i TP i forbindelse med synkron system-system kald, dannes en HTTP Error besked som resultat til det kaldende system Fejlhåndtering ved synkron kommunikation Opstår der en fejl ved modtagelse eller behandling af forsendelse som kræver et synkront svar, skal fejlen rapporteres af den synkrone svar-kanal. Der benyttes HTTP fejlrapporteringsmodel. Dette er vist på nedenstående figur, hvor en aktør kalder TP og modtager en HTTP Error. Aktør TP WS-operation Figur 15: fejlrapporteringmodel Konkrete fejlsituationer Dette afsnit indeholder en uddybning af den beskrivelse af fejlmuligheder, der er ved modtagelse af anmeldelser i TP. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 49

50 6.1.5 Konkrete fejlbeskeder Generelle fejlbeskeder på tværs af services http status Fejltekst Bemærkning 400 Bad request Indeholder en XML-blok: <messages xmlns ="http://siv.servicestyrelsen.dk/1.0"> <status>error</status> <message type="error">error msg</message> </messages> 401 Unauthorized Indeholder en XML-blok: <data contenttype="application/xml; charset=utf-8" contentlength="39"><![cdata[authentication credentials are required]]></data> 404 Not found Indeholder en XML-blok: <messages xmlns ="http://siv.servicestyrelsen.dk/1.0"> <status>error</status> <message type="error">error msg</message> </messages> 415 Unsupported media type Indeholder en HTML-blok returneres fejlbesked. Eks.: 415 Unsupported Media Type ved POST af ukendt media type Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 50

51 Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 51

52 7 FAQ 7.1 Spørgsmål: Stamoplysninger vs stamoplysninger_r2 Entiteten organisation har en relation til entiteten stamoplysninger og en relation til entiteten stamoplysning_r2. Det lader til at hver organisation har enten en stamoplysninger eller en stamoplysning_r2. Jeg vil gerne vide hvad forskellen er på de to. Hvorfor bruges de begge? Når jeg spørger om forskellen, så mener jeg ikke bare forskellen i hvilke metadata der ligger på den. Det kan jeg slå op i metadata-servicen. Det jeg gerne vil vide er meningen med entiteterne. Hvornår bruges stamoplysninger og hvornår bruges stamoplysning_r2? Svar: Med undtagelse af entiteten "Organisation", så skal du arbejde med entiteter der hedder noget med _r2. I relation til tilsynsreformen ændrer vi datamodellen og i den sammenhæng går vi fra f.eks. stamoplysninger til stamoplysninger_r Spørgsmål: Målgruppekategorier I dokumentationen ses en liste af målgruppekategorier ( demens, hjerneskade, udviklingshæmning mm.). Denne liste er rent visuelt sat op så den ligner en træstruktur fx antydes det at hjerneskade har underkategorierne erhvervet hjerneskade og medfødt hjerneskade. Men når jeg kigger i metadataene for feltet maalgruppe på entiteten maalgruppepakke_r2 kan jeg ikke se nogen træstruktur, kun en flad liste af kategorier. Er den træstruktur som dokumentationen antyder faktisk noget som findes i datamodellen og kan trækkes ud? Og i så fald hvordan? Svar: Målgruppepakker kan findes via to relationer, hhv. på Organisation og på Indsats_r2. De målgrupperpakker der findes på Organisation er bruttolisten af mulgruppepakker der vedrører en Organisation f.eks.: https://siv.socialstyrelsen.dk/portal-test/rest/v1/organisation/8e a0-933abd4754d08c3a/maalgruppepakke_r2 De målgruppepakker der er knyttet til en indsats er en delmængde af de målgruppepakker der er knyttet til Organisation. De enkelte målgrupper kan findes på målgruppepakken under: <attribute handle ="maalgruppe" > <!--personfarlig kriminalitet--> <category handle ="88" /> <!--alkoholmisbrug--> <category handle ="91" /> </attribute > Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 52

53 7.3 Spørgsmål: Indberetter på et tilbud I dokumentationen kan jeg se en sektion med overskriften Skriv navn og mailadresse på den person, der skal indberette for tilbuddet og med fire felter (Fornavn, Mellemnavn, Efternavn, Mailadresse). Disse felter kan jeg ikke finde i metadataene. Svar: Tilbudsportalen gemmer ikke oplysninger om, hvem der har indsendt indberetningsblanketten.. De felter der nævner gemmes i "IT bruger" entiteten. Men som sagt vil du ikke kunne finde den aktuelle indberetter for et tilbud. Du kan kun se potentielle indberettere for et tilbud. 7.4 Spørgsmål: Sygefravær på tilbuddet Vi vil gerne finde et felt Sygefravær på tilbud. I dokumentationen kan man se et felt med titlen Hvad er sygefraværet på tilbuddet. Dette felt kan jeg ikke finde i metadataene? Svar: Dette felt har handle s126 i metadata.xml. 7.5 Spørgsmål: Recursive = 1 Hvis man prøver at kalde Tilbudsportal-webservicen og hente organisation en for Socialstyrelsen (ID: 79012ac1-4a77-450d-9b42-a6b00ed48dc9) med recursive=1, så går webservicen ned. De næste par minutter er webservicen utilgængelig og kaster HTTP 503, antageligt fordi den er overbelastet. Det sker også selv om man prøver at afbryde mit webservicekald. Det er forståeligt hvis webservicen nægter at returnere alle organisationer og deres relationer i ét kald (hvilket er hvad jeg prøver på), men det er ret uheldigt at webservicen går ned når man prøver. Svar: Man må IKKE trække data ud fra rod-organisationen. Test serverne og applikationen er ikke gearet til dette. I skal hente fra et lavere niveau (f.eks. et tilsyn eller et tilbud) med recursive. Socialstyrelsen Tilbudsportalen Servicespecifikation Version 1.0 Side 53

Tilbudsportalen REST testklient

Tilbudsportalen REST testklient Socialstyrelsen Tilbudsportalen REST testklient REST testklienter.net Søren Korgaard Nielsen, Socialstyrelsen 28-01-2014 Indhold 1 Indledning... 3 2 XSD og autogenereret kode... 4 3 Opbygning af blanketter...

Læs mere

Webservice kald. System-til-system integration. Ny Easy. ATP 1. februar 2017

Webservice kald. System-til-system integration. Ny Easy. ATP 1. februar 2017 Webservice kald System-til-system integration Ny Easy ATP 1. februar 2017 Side 1 of 9 Dokumenthistorik Revisionshistorik Dato for denne revision: 01.02.2017 Dato for næste revision ukendt Revisions Revisions

Læs mere

DKAL Snitflader REST HTTP returkoder

DKAL Snitflader REST HTTP returkoder DKAL Snitflader REST HTTP returkoder 1 Indholdsfortegnelse INDHOLDSFORTEGNELSE 2 A5.1 INTRODUKTION 3 A5.2 HTTP RETURKODER 3 A5.3 DKAL FEJLKODER 6 A5.3.1 DKAL XML FEJLFORMAT 7 Bilag A5: REST HTTP returkoder

Læs mere

Digital post Snitflader Bilag A5 - REST HTTP returkoder Version 6.3

Digital post Snitflader Bilag A5 - REST HTTP returkoder Version 6.3 Digital post Snitflader Bilag A5 - REST HTTP returkoder Version 6.3 1 Indholdsfortegnelse INDHOLDSFORTEGNELSE 2 A5.1 INTRODUKTION 4 A5.2 HTTP RETURKODER 4 A5.3 DIGITAL POST FEJLKODER 7 A5.3.1 DIGITAL POST

Læs mere

ecpr erstatnings CPR Design og arkitektur

ecpr erstatnings CPR Design og arkitektur 1 ecpr erstatnings CPR Design og arkitektur Indhold ecpr erstatnings CPR... 1 Indhold... 2 Formål... 3 Overblik... 4 Snitflader... 4 Komponenter... 5 Webservice... 5 Statuskomponent... 5 Forretningslag...

Læs mere

Generelle ændringer i indberetningen til Tilbudsportalen 15. marts 2016

Generelle ændringer i indberetningen til Tilbudsportalen 15. marts 2016 Generelle ændringer i indberetningen til Tilbudsportalen 15. marts 2016 Automatisk godkendelse Automatisk godkendelse af oplysninger Hvad skal tilbuddet Når man tilføjer eller opdaterer oplysninger i indberetningen,

Læs mere

DKAL Snitflader REST Register

DKAL Snitflader REST Register DKAL Snitflader REST Register 1 Indholdsfortegnelse A2.1 INTRODUKTION 3 A2.1.1 HENVISNINGER 3 A2.1.2 LÆSEVEJLEDNING 4 A2.1.2.1 SÅDAN LÆSES EN REST GRAF 4 A2.1.2.2 SÅDAN LÆSES EN RESSOURCE OG EN TYPE 4

Læs mere

0.9 19-09-2012 DAVAR Omdøbt til SagDokumentFormat. Attention er skilt ud i et selvstændigt format, AttentionFormat.

0.9 19-09-2012 DAVAR Omdøbt til SagDokumentFormat. Attention er skilt ud i et selvstændigt format, AttentionFormat. Specifikation 19. september 2012 DAVAR J.nr. 2012-6211-281 Sagdokumentformat Versionshistorik Version Dato Initialer Noter 0.7 15-06-2012 DAVAR Høringsversion. Indsat MeddelelseAttention. 0.9 19-09-2012

Læs mere

Oktober 2013 HLG/XIGA. Opstartsvejledning ATS Engros 1/12

Oktober 2013 HLG/XIGA. Opstartsvejledning ATS Engros 1/12 Oktober 2013 HLG/XIGA Opstartsvejledning ATS Engros 1/12 1. ATS Engros vejledning for aktører Formålet med dette dokument er at beskrive, hvordan du kommer i gang med at anvende ATS til test af certifikat

Læs mere

AuthorizationCodeService

AuthorizationCodeService AuthorizationCodeService Sammenhængende Digital Sundhed i Danmark, version 1.1 W 1 AuthorizationCodeService Sammenhængende Digital Sundhed i Danmark version 1.1 Kåre Kjelstrøm Formål... 3 Introduktion...

Læs mere

STS Designdokument. STS Designdokument

STS Designdokument. STS Designdokument STS Designdokument i STS Designdokument STS Designdokument ii REVISION HISTORY NUMBER DATE DESCRIPTION NAME 0.3 2013-01 N STS Designdokument iii Indhold 1 Introduktion 1 2 Arkitekturoverblik 1 2.1 Eksterne

Læs mere

Digital post Snitflader Bilag A2 - REST Register Version 6.3

Digital post Snitflader Bilag A2 - REST Register Version 6.3 Digital post Snitflader Bilag A2 - REST Register Version 6.3 1 Indholdsfortegnelse A2.1 INTRODUKTION 4 A2.1.1 HENVISNINGER 4 A2.2 OVERSIGT OVER FUNKTIONSOMRÅDE 5 A2.2.1 OPRET / HENT OPLYSNINGER OM SLUTBRUGER

Læs mere

BBR OIOXML. Vejledning til OIOXML-snitflade. InputBox.wsdl

BBR OIOXML. Vejledning til OIOXML-snitflade. InputBox.wsdl OIOXML Vejledning til OIOXML-snitflade En vejledning rettet mod 3. part. Ændringer i forhold til forrige versioner Første version, 19.11.2010 Snitfladebeskrivelser Side 2 af 10 Indholdsfortegnelse 1. Introduktion...

Læs mere

OIO standardservice til Journalnotat. Generel servicevejledning. KMD Sag Version 1.0 01-09-2013. KMD A/S Side 1 af 15. September 2013 Version 1.

OIO standardservice til Journalnotat. Generel servicevejledning. KMD Sag Version 1.0 01-09-2013. KMD A/S Side 1 af 15. September 2013 Version 1. OIO standardservice til Journalnotat Generel servicevejledning KMD Sag Version 1.0 01-09-2013 KMD A/S Side 1 af 15 Generel servicevejledning til OIO Journalnotat Ekstern standardservice Opdateret 01.09.2013

Læs mere

FMK-online's brug af SmartFraming

FMK-online's brug af SmartFraming Side 1 af 9 FMK-online's brug af SmartFraming Version 1.1 2011-11-01 Side 2 af 9 Indholdsfortegnelse Indledning...3 Initialisering og login...3 Kontekst Properties...4 user.id.authorizationid...4 userorganization.id.number...4

Læs mere

XML webservice for pensionsordninger. Version 1.0 Draft A

XML webservice for pensionsordninger. Version 1.0 Draft A XML webservice for pensionsordninger Version 1.0 Draft A Dokumentoplysninger Titel: Projekt: Webservice for pensionsordninger EDI kontorets branchekoordinerede dataudveksling Forfatter: Bidragsydere til

Læs mere

Webservice til upload af produktionstilladelser

Webservice til upload af produktionstilladelser BILAG 1 Webservice til upload af produktionstilladelser Indhold og anvendelse Denne web-service gør det muligt for 3. parts programmer i kommuner og amter at Uploade og registrere kommunale produktionstilladelser

Læs mere

Vejledning til leverandørers brug af Serviceplatformen

Vejledning til leverandørers brug af Serviceplatformen Vejledning til leverandørers brug af Serviceplatformen Udarbejdet for: KOMBIT A/S Halfdansgade 8 2300 København S 1 Indhold 1 Indledning... 3 2 Ordforklaringer... 3 3 Oprettelse... 4 4 Arbejdsgange...

Læs mere

Opstartsvejledning ATS aktørudgave

Opstartsvejledning ATS aktørudgave Opstartsvejledning ATS aktørudgave 7. september 2012 XHLG/NLJ 1/13 1. ATS vejledning for aktører Formålet med dette dokument er at beskrive, hvordan I kommer i gang med at anvende ATS til test af certifikat

Læs mere

Fordeling af journalnotater og dokumenter Udkast til løsningsmodel. Marts 2014

Fordeling af journalnotater og dokumenter Udkast til løsningsmodel. Marts 2014 Fordeling af journalnotater og dokumenter Udkast til løsningsmodel Marts 2014 1 Indledning Denne præsentation beskriver, på et overordnet plan, følgende områder i forhold til en fremtidig fordelingsmekanisme,

Læs mere

Version Dato Beskrivelse 1.0.0 26/11/2012 Initial version 1.2.0 05/03/2013 Tilføjet eksempel med Template Agent, generelt udvidet dokumentet.

Version Dato Beskrivelse 1.0.0 26/11/2012 Initial version 1.2.0 05/03/2013 Tilføjet eksempel med Template Agent, generelt udvidet dokumentet. MOX og APOS2 Forord Dette dokument er en del af APOS version 2 manualerne. APOS version 2 (APOS2 herefter) er et organisation, klassifikation og personale system baseret på Sag & Dokument standarderne.

Læs mere

Affaldsdatasystem Vejledning i system-til-system integration

Affaldsdatasystem Vejledning i system-til-system integration Affaldsdatasystem Vejledning i system-til-system integration Dokument version: 2.0 ADS version: 1.0 Henvendelse vedrørende affald: Miljøstyrelsen Roskilde, Affaldssekretariatet Ny Østergade 7-11 4000 Roskilde

Læs mere

Digital Sundhed. Brugerstyringsattributter - Introduktion. - Specificering af nye og ændrede attributter i id-kortet

Digital Sundhed. Brugerstyringsattributter - Introduktion. - Specificering af nye og ændrede attributter i id-kortet Digital Sundhed Brugerstyringsattributter - Introduktion - Specificering af nye og ændrede attributter i id-kortet Indhold 1. Introduktion... 2 2. Læsevejledning... 2 3. Aktører... 2 4. Autentifikation...

Læs mere

Indholdsfortegnelse. Version 1.4. 1 Serviceplatformen - opsætningsguide (Eksterne testmiljø)... 2 1.1 Indledning... 2

Indholdsfortegnelse. Version 1.4. 1 Serviceplatformen - opsætningsguide (Eksterne testmiljø)... 2 1.1 Indledning... 2 Indholdsfortegnelse 1 Serviceplatformen - opsætningsguide (Eksterne testmiljø)... 2 1.1 Indledning... 2 1.2 Forberedelse til anvendelse Serviceplatformen... 2 1.2.1 Medarbejdercertifikat (MOCES)... 2 1.2.2

Læs mere

SmartFraming Et vindue til nationale sundhedssystemer. Version 3.0

SmartFraming Et vindue til nationale sundhedssystemer. Version 3.0 SmartFraming Et vindue til nationale sundhedssystemer Version 3.0 Infrastruktur i dagens sundheds IT Det sundhedsfaglige personale benytter sig i dag af en række forskellige systemer i forbindelse med

Læs mere

Affaldsdatasystem Vejledning supplement i system-til-system integration for.net brugere

Affaldsdatasystem Vejledning supplement i system-til-system integration for.net brugere Affaldsdatasystem Vejledning supplement i system-til-system integration for.net brugere Dokument version: 2.0 ADS version: 1.0 Henvendelse vedrørende affald: Miljøstyrelsen Roskilde, Affaldssekretariatet

Læs mere

Teknisk Dokumentation

Teknisk Dokumentation Sundhedsstyrelsens E2B Bivirkningswebservice Teknisk Dokumentation Side 1 af 8 Indhold Indledning... 3 Terminologi... 3 Arkitektur... 4 Web Service Snitflade... 4 Valideringsfejl... 5 Success... 5 E2B...

Læs mere

STS Designdokument. STS Designdokument

STS Designdokument. STS Designdokument STS Designdokument i STS Designdokument REVISION HISTORY NUMBER DATE DESCRIPTION NAME 0.3 2013-01 N STS Designdokument iii Contents 1 Introduktion 1 2 Arkitekturoverblik 3 2.1 Eksterne snitflader..................................................

Læs mere

Typografidefinition: Typografi1: Skrifttype: 10 pkt, (intet) DKAL Snitflader REST Afhentningssystem

Typografidefinition: Typografi1: Skrifttype: 10 pkt, (intet) DKAL Snitflader REST Afhentningssystem Typografidefinition: Typografi1: Skrifttype: 10 pkt, (intet) DKAL Snitflader REST Afhentningssystem 1 Indholdsfortegnelse A3.1 INTRODUKTION 3 A3.1.1 HENVISNINGER 3 A3.1.2 LÆSEVEJLEDNING 4 A3.1.2.1 SÅDAN

Læs mere

Indholdsfortegnelse. Systembeskrivelse kapitel 8 Administrationsdatabase

Indholdsfortegnelse. Systembeskrivelse kapitel 8 Administrationsdatabase Indholdsfortegnelse 5. Administrationsdatabase... 2 5.1 Metadata... 2 5.2 Administrationsdata... 3 5.2.1 Indstillingsmuligheder... 3 5.2.2 Webside... 4 5.2.3 Klikafgift (Udgået)... 4 5.2.4 Modtageboks...

Læs mere

Kald af PingService via SOAPUI

Kald af PingService via SOAPUI Kald af PingService via SOAPUI Author: Integration Expert Team (IET) Owner: Integration Expert Team (IET) Page 1 of 24 1. Dokumenthistorik Kald af PingService via SOAPUI Revisioner Dato for denne version:

Læs mere

DataHub Forbrugeradgangsløsning Spørgsmål og svar

DataHub Forbrugeradgangsløsning Spørgsmål og svar 9. Januar 2013 MEH/MHC DataHub Forbrugeradgangsløsning Spørgsmål og svar Dok 75938-12_v2, Sag 10/3365 1/7 1. Generelt 1.1 I hvilket omfang yder Energinet.dk support til elleverandørerne? Forretningskonceptet

Læs mere

Bekendtgørelse om Tilbudsportalen

Bekendtgørelse om Tilbudsportalen BEK nr 1673 af 16/12/2016 (Gældende) Udskriftsdato: 20. februar 2017 Ministerium: Børne- og Socialministeriet Journalnummer: Børne- og Socialmin., j.nr. 2016-6361 Senere ændringer til forskriften Ingen

Læs mere

SAPAs forretningsmæssige behov i relation til Dialogintegration. SAPAs behov for Dialogintegration. Fordele ved brug af dialogintegration i SAPA

SAPAs forretningsmæssige behov i relation til Dialogintegration. SAPAs behov for Dialogintegration. Fordele ved brug af dialogintegration i SAPA 26. marts 2014 NOTAT SAPAs forretningsmæssige behov i relation til Dialogintegration Dette notat beskriver SAPAs specifikke forretningsmæssige behov i forhold til integration med relevante ESDH-/fagsystemer,

Læs mere

Generelle ændringer i indberetningen til Tilbudsportalen 15. marts 2016

Generelle ændringer i indberetningen til Tilbudsportalen 15. marts 2016 Generelle ændringer i indberetningen til Tilbudsportalen 15. marts 2016 Automatisk godkendelse Automatisk godkendelse af oplysninger Hvad skal tilsynskonsulenten gøre? Når man tilføjer eller opdaterer

Læs mere

Dokumentation af optagelse.dk

Dokumentation af optagelse.dk ApplicationService Indhold Versionsstyring Introduktion Navn URL Formål Sikkerhed Operationer echo() findftuapplicationids(...) findftuapplicationbyid(...) findftuapplicationpdfbyid(...) findftuapplicationenclosurezipurlbyid(...)

Læs mere

Vejledning til leverandørers brug af Serviceplatformen

Vejledning til leverandørers brug af Serviceplatformen Vejledning til leverandørers brug af Serviceplatformen Udarbejdet for: KOMBIT A/S Halfdansgade 8 2300 København S 1 Indhold 1 Indledning... 3 2 Ordforklaringer... 3 3 Oprettelse... 4 4 Arbejdsgange...

Læs mere

System til System grænseflader

System til System grænseflader e-tl System til System grænseflader Version Dato Forfatter Kommentarer Distribueret til 0.9 10/10-07 Tommy D. Pedersen Første udkast Test og Teknikgruppen, DSS og Devoteam Indholdsfortegnelse Formål...

Læs mere

Vejledning til KLIAKT for institutionsadministratorer

Vejledning til KLIAKT for institutionsadministratorer Vejledning til KLIAKT for institutionsadministratorer Dette er en vejledning til brug for indberetning af kollektive tjenesteforseelser i kommunerne. Indholdsfortegnelse 1. Indledning... 3 2. Oprettelse

Læs mere

Guide til integration med NemLog-in / Signering

Guide til integration med NemLog-in / Signering Guide til integration med NemLog-in / Signering Side 1 af 6 14. november 2013 TG Denne guide indeholder en kort beskrivelse af, hvorledes man som itsystemudbyder (myndighed eller it-leverandør) kan integrere

Læs mere

SOSIGW. - Administrationskonsol for SOSIGW 1.0.6. Indeks

SOSIGW. - Administrationskonsol for SOSIGW 1.0.6. Indeks SOSIGW - Administrationskonsol for SOSIGW 1.0.6 Indeks Indeks... 1 Revisionshistorik... 2 Introduktion... 2 Administrationskonsollen... 2 Generel brug af konsollen... 3 Fremsøgning af ID-kort... 3 Søgning

Læs mere

1 Begrebsmodel for Ydelsesindeks

1 Begrebsmodel for Ydelsesindeks 1 Begrebsmodel for Ydelsesindeks Ydelsesindeks skal indeholde metadata om tildelte ydelser, samt nøgler til andre relaterede forretningsobjekter fra Afsendersystemer, således at der kan leveres et tværgående

Læs mere

Tekniske krav til spiludbydere i forbindelse med opnåelse af tilladelse til at udbyde online spil i Danmark

Tekniske krav til spiludbydere i forbindelse med opnåelse af tilladelse til at udbyde online spil i Danmark Tekniske krav til spiludbydere i forbindelse med opnåelse af tilladelse til at udbyde online spil i Danmark Version 1.10 Versionshistorik Version Dato Opsummerende beskrivelse af ændringer 1.00 2010-10-5

Læs mere

FESD-standardiseringsgruppen Att: Palle Aagaard IT- og Telestyrelsen IT-strategisk kontor Holsteinsgade 63 2100 København Ø

FESD-standardiseringsgruppen Att: Palle Aagaard IT- og Telestyrelsen IT-strategisk kontor Holsteinsgade 63 2100 København Ø FESD-standardiseringsgruppen Att: Palle Aagaard IT- og Telestyrelsen IT-strategisk kontor Holsteinsgade 63 2100 København Ø Høringssvar vedr. FESD GIS-integrationsmodel version 2.0 Geodata Danmark har

Læs mere

Guide til integration med NemLog-in / Brugeradministration

Guide til integration med NemLog-in / Brugeradministration Guide til integration med NemLog-in / Brugeradministration Side 1 af 9 21. januar 2013 TG Denne guide indeholder en kort beskrivelse af, hvorledes man som itsystemudbyder (myndighed eller it-leverandør)

Læs mere

Dokumentation af optagelse.dk

Dokumentation af optagelse.dk ApplicationService Indhold Versionsstyring Introduktion Navn URL Formål Sikkerhed Operationer echo() findftuapplicationids(...) findftuapplicationbyid(...) findftuapplicationpdfbyid(...) findftuapplicationenclosurezipurlbyid(...)

Læs mere

System-til-system Grænsefladebeskrivelse

System-til-system Grænsefladebeskrivelse System-til-system Grænsefladebeskrivelse Strålfors Connect System-til-system grænsefladebeskrivelse Side 2 af 72 Indhold 1 Indledning...7 1.1 Version 1.1...7 1.2 Version 1.5...8 2 Referencer til andre

Læs mere

e-tl System til System kommunikationstest

e-tl System til System kommunikationstest e-tl System til System kommunikationstest Version Dato Forfatter Kommentarer Distribueret til 0.5 22/10-07 Anders Bohn Jespersen Udgave til workshop 24/10. 0.6 24/10-07 HGK Opdateret med beskeder. 0.9

Læs mere

Kom i gang med SAS STPbaserede

Kom i gang med SAS STPbaserede make connections share ideas be inspired Kom i gang med SAS STPbaserede webapplikationer Lars L. Andersson Chefkonsulent Webapplikationer Interaktion med serverbaserede data via skærmbilleder leveret gennem

Læs mere

Brugerskabte data en national service (BSD) - produktbeskrivelse

Brugerskabte data en national service (BSD) - produktbeskrivelse - 1 Brugerskabte data en national service (BSD) - produktbeskrivelse Brugerskabte data en national service (BSD) - produktbeskrivelse...1 Indledning...1 Formål...1 Beskrivelse...1 Basale krav til det bibliotek/website

Læs mere

SUP-specifikation, version 2.0. Bilag 9. SUP-Styregruppen. Sikkerhed og samtykke. Udkast af 12. juni Udarbejdet for

SUP-specifikation, version 2.0. Bilag 9. SUP-Styregruppen. Sikkerhed og samtykke. Udkast af 12. juni Udarbejdet for SUP-specifikation, version 2.0 Bilag 9 Sikkerhed og samtykke Udkast af 12. juni 2003 Udarbejdet for SUP-Styregruppen Uddrag af indholdet kan gengives med tydelig kildeangivelse Indholdsfortegnelse 1 Introduktion...

Læs mere

OIOREST webservice design. Guideline til design af REST-baserede webservices. Udgivet af: IT- & Telestyrelsen

OIOREST webservice design. Guideline til design af REST-baserede webservices. Udgivet af: IT- & Telestyrelsen > OIOREST webservice design. Guideline til design af REST-baserede webservices. Udgivet af: IT- & Telestyrelsen Publikationen kan også hentes på IT- & Telestyrelsens Hjemmeside: http://www.itst.dk ISBN

Læs mere

CULR webservice version 4

CULR webservice version 4 CULR webservice version 4 Indhold Beskrivelse af CULR-systemet... 1 Formål... 1 Systemarkitektur... 1 Definitioner... 2 Provider... 2 Account... 2 Patron... 2 Authentication... 2 Operationerne... 3 Uddybende

Læs mere

Ansøgningsskema: Godkendelse af nye sociale tilbud

Ansøgningsskema: Godkendelse af nye sociale tilbud Ansøgningsskema: Godkendelse af nye sociale tilbud Praktiske oplysninger Uddrag af 5: Socialtilsynet træffer efter ansøgning afgørelse om godkendelse som generelt egnet af sociale tilbud mv., jf. 4, på

Læs mere

MØDE OM INTEGRATION GENNEM ØKONOMI I RAMMEARKITEKTUREN 27/8-2015

MØDE OM INTEGRATION GENNEM ØKONOMI I RAMMEARKITEKTUREN 27/8-2015 MØDE OM INTEGRATION GENNEM ØKONOMI I RAMMEARKITEKTUREN 27/8-2015 Introduktion ERP-leverandører har været med i afklarings- og specificeringsforløb siden 2013. Der vil være gentagelser og opsummeringer

Læs mere

Undgå driftsafbrydelser på grund af udløbet virksomheds- eller funktionssignatur

Undgå driftsafbrydelser på grund af udløbet virksomheds- eller funktionssignatur Side 1 af 5 Vejledning 2. august 2013 NITRI Undgå driftsafbrydelser på grund af udløbet virksomheds- eller funktionssignatur Indholdsfortegnelse Formål...2 Virksomhedssignatur...2 Funktionssignatur...3

Læs mere

Overordnet løsningsbeskrivelse - Private aktører og borger log-in via SEB / NemLog-in

Overordnet løsningsbeskrivelse - Private aktører og borger log-in via SEB / NemLog-in Overordnet løsningsbeskrivelse - Private aktører og borger log-in via SEB / NemLog-in (samt mulighed for FMK tilgang via SOSI STS) 15.marts 2017 /chg Baggrund Private aktører på sundhedsområdet som apoteker,

Læs mere

Vejledning til KLIAKT for institutionsbrugere. Dette er en vejledning til brug for indberetning af kollektive tjenesteforseelser i kommunerne

Vejledning til KLIAKT for institutionsbrugere. Dette er en vejledning til brug for indberetning af kollektive tjenesteforseelser i kommunerne Vejledning til KLIAKT for institutionsbrugere Dette er en vejledning til brug for indberetning af kollektive tjenesteforseelser i kommunerne Indholdsfortegnelse 1. Indledning... 3 2. Oprettelse af institutionsbruger...

Læs mere

2. Systemarkitektur... 2

2. Systemarkitektur... 2 Indholdsfortegnelse 2. Systemarkitektur... 2 2.1 Præsentationsserverarkitektur... 3 2.2 Applikationsserverarkitektur... 7 Version 7.0 Side 1 af 7 5. Systemarkitektur Arkitekturen for Nyt BBR bygger på

Læs mere

Bekendtgørelse om Tilbudsportalen

Bekendtgørelse om Tilbudsportalen Bekendtgørelse om Tilbudsportalen I medfør af 14, stk. 4, i lov om social service, jf. lovbekendtgørelse nr. 58 af 18. januar 2007, fastsættes: Formål med Tilbudsportalen 1. Formålet med Tilbudsportalen

Læs mere

FORSLAG TIL MASSEAFSENDELSE

FORSLAG TIL MASSEAFSENDELSE FORSLAG TIL MASSEAFSENDELSE Digital Post og Fjernprint 2015-03-11 Dagsorden 1. Velkomst 2. Nuværende OIO-rest 3. Udfordringer 4. Afrunding Nuværende OIO-REST løsning Digital post De nuværende Digital Post

Læs mere

Den Gode VANSEnvelope. MedCom

Den Gode VANSEnvelope. MedCom Den Gode VANSEnvelope MedCom Den Gode VANSEnvelope Jacob Glasdam Bolette Friis Jensen KMD Erik Jacobsen Multimed Ole Vilstrup CSC Thomas Jørgensen Evenex Dorthe Skou Lassen MedCom Gitte Fleckner Henriksen

Læs mere

UniLock System 10. Manual til Eksport til Nortec vaskerisystem. Projekt PCS125-20 Version 1.0 Revision 131127

UniLock System 10. Manual til Eksport til Nortec vaskerisystem. Projekt PCS125-20 Version 1.0 Revision 131127 UniLock System 10 Manual til Eksport til Nortec vaskerisystem Projekt PCS125-20 Version 1.0 Revision 131127 UniLock eksport til Nortec vaskerisystem anvendes til automatisk at vedligeholde beboerdata i

Læs mere

Sundhedsstyrelsens Elektroniske Indberetningssystem (SEI) Vejledning til indberetning via Citrix-løsning

Sundhedsstyrelsens Elektroniske Indberetningssystem (SEI) Vejledning til indberetning via Citrix-løsning Sundhedsstyrelsens Elektroniske Indberetningssystem (SEI) Vejledning til indberetning via Citrix-løsning Indholdsfortegnelse Indledning... 3 Systemkrav... 4 Installation af Citrix-klient... 5 Tilpasning

Læs mere

ADK 1.0 KRAVSPECIFIKATION

ADK 1.0 KRAVSPECIFIKATION ADK 1.0 KRAVSPECIFIKATION Dokumentets versioner (revisionshistorie) Version Dato Ansvarlig Beskrivelse 0.1 23-06-2014 MST Oprettelse af integrationskrav 0.2 25-06-2014 HAH Review for forståelighed og stringens.

Læs mere

Anvendelse af dobbelthistorik i GD2

Anvendelse af dobbelthistorik i GD2 Grunddataprogrammet under den Fællesoffentlige Digitaliseringsstrategi GD2 - Adresseprogrammet Anvendelse af dobbelthistorik i GD2 Implementerings regler og eksempler på dobbelthistorik MBBL- REF: Version:

Læs mere

Ibrugtagning af Fødselsindberetningsservicen på NSP

Ibrugtagning af Fødselsindberetningsservicen på NSP Ibrugtagning af Fødselsindberetningsservicen på NSP Udarbejdet af: NSI Version: 1.0 Dato: 09.07.2013 Indholdsfortegnelse 1 Vejledning til ibrugtagning af Fødselsindberetningsservicen... 3 1.1 Læsevejledning

Læs mere

Anbefalede testprocedurer

Anbefalede testprocedurer Nets DanID A/S Lautrupbjerg 10 DK 2750 Ballerup T +45 87 42 45 00 F +45 70 20 66 29 info@danid.dk www.nets-danid.dk CVR-nr. 30808460 Anbefalede testprocedurer Nets DanID A/S Marts 2014 Side 1-34 Indholdsfortegnelse

Læs mere

Bilag til standardaftale om delegering af brugerrettigheder mellem lokale identitetsudbydere og serviceudbydere ved anvendelse af SAML-billetter

Bilag til standardaftale om delegering af brugerrettigheder mellem lokale identitetsudbydere og serviceudbydere ved anvendelse af SAML-billetter Bilag til standardaftale om delegering af brugerrettigheder mellem lokale identitetsudbydere og serviceudbydere ved anvendelse af SAML-billetter Servicebeskrivelse Økonomistyrelsen Marts 2011 Side 1 af

Læs mere

Vejledning til registrering som bruger til EudraCT results

Vejledning til registrering som bruger til EudraCT results Vejledning til registrering som bruger til EudraCT results 1 Registrering som ny bruger For at indtaste resultater, skal man registreres som bruger i EudraCT databasen: https://eudract.ema.europa.eu/results-web/

Læs mere

Udkast til REST-ressourcer for Dokumentboks (DKAL) (uddrag fra kravspecifikation og E-boks løsningsbeskrivelse)

Udkast til REST-ressourcer for Dokumentboks (DKAL) (uddrag fra kravspecifikation og E-boks løsningsbeskrivelse) Udkast til REST-ressourcer for Dokumentboks (DKAL) (uddrag fra kravspecifikation og E-boks løsningsbeskrivelse) IT- og Telestyrelsen anbefaler at anvende webservice-standarderne til udarbejdelse af services,

Læs mere

OIOUBL Guideline. OIOUBL Guideline

OIOUBL Guideline. OIOUBL Guideline OIOUBL Guideline OIOUBL Guideline OIOUBL Dokument Reference UBL 2.0 Document Reference G21 Version 1.3 Udgivelsen er beskyttet af Creative Commons license, Navngivning 2.5 Kolofon Kontakt: Digitaliseringsstyrelsen

Læs mere

Underbilag 2Q Vilkår for integration til støttesystemet Klassifikation

Underbilag 2Q Vilkår for integration til støttesystemet Klassifikation Underbilag 2Q Vilkår for integration til støttesystemet Klassifikation 1. Indledning og vejledning Nærværende vejledning beskriver, hvordan Anvendersystemer afsender og/eller modtager objekter til/fra

Læs mere

Denne vejledning dækker opsætning og brug af påmindelsesprofiler og påmindelser om manglende registrering af fravær på AMU kurser.

Denne vejledning dækker opsætning og brug af påmindelsesprofiler og påmindelser om manglende registrering af fravær på AMU kurser. Påmindelsesprofiler Sidst opdateret 28-09-2011/version 2/UNI C/Frederik Andersen Indhold Ændringer og tilføjelser Centrale begreber Generelt Arbejdsgange Denne vejledning dækker opsætning og brug af påmindelsesprofiler

Læs mere

EG Data Inform. Byggebasen. WCF og webservices. Jens Karsø

EG Data Inform. Byggebasen. WCF og webservices. Jens Karsø EG Data Inform Byggebasen WCF og webservices Jens Karsø 10 Indholdsfortegnelse Byggebasen Services indledning... 2 Målsætning... 2 Valg af teknologier... 3 Kommunikationsmodel for byggebasen... 3 Services.byggebasen.dk...

Læs mere

Klik her for at angive tekst. Vejledning til brug af Støttesystemet Sags- og Dokumentindeks

Klik her for at angive tekst. Vejledning til brug af Støttesystemet Sags- og Dokumentindeks 23. maj 2013 HHK/KMJ NOTAT Klik her for at angive tekst. Vejledning til brug af Støttesystemet Sags- og Dokumentindeks KOMBIT A/S Halfdansgade 8 2300 København S Tlf 3334 9400 www.kombit.dk kombit@kombit.dk

Læs mere

Løsningsbeskrivelse. Den fælleskommunale Serviceplatform

Løsningsbeskrivelse. Den fælleskommunale Serviceplatform Løsningsbeskrivelse Den fælleskommunale Serviceplatform Januar 2014 1 Indhold 2 Serviceplatformen... 2 3 Hjemmesiden www.serviceplatformen.dk... 3 3.1 Administrationsmodul... 4 3.2 Servicekatalog... 4

Læs mere

Udkast til dataudveksling med elleverandører og andre tredjeparter via kundestyret dataadgang

Udkast til dataudveksling med elleverandører og andre tredjeparter via kundestyret dataadgang Udkast til dataudveksling med elleverandører og andre tredjeparter via kundestyret dataadgang 29.04.2015 USS/XSTJ Version 1.3 1. Indledning... 2 2. Proces for kundestyret dataadgang... 2 2.1 Fuldmagtsgivning

Læs mere

Vejledning til indberetningsløsning for statslige aktieselskaber m.v. www.offentlige-selskaber.dk

Vejledning til indberetningsløsning for statslige aktieselskaber m.v. www.offentlige-selskaber.dk Vejledning til indberetningsløsning for statslige aktieselskaber m.v. www.offentlige-selskaber.dk 1 Offentlige-selskaber.dk s startside giver direkte adgang til at foretage en indberetning. Som en service

Læs mere

:55 i/iv BEM 2.0 BEM 2.0. Fælles Medicinkort - Dokumentation -

:55 i/iv BEM 2.0 BEM 2.0. Fælles Medicinkort - Dokumentation - 2016-11-22 09:55 i/iv BEM 2.0 BEM 2.0 Fælles Medicinkort - Dokumentation - http://wiki.fmk.netic.dk/ 2016-11-22 09:55 ii/iv BEM 2.0 http://wiki.fmk.netic.dk/ Printed on 2016-11-22 09:55 2016-11-22 09:55

Læs mere

LUDUS Web Installations- og konfigurationsvejledning

LUDUS Web Installations- og konfigurationsvejledning LUDUS Web Installations- og konfigurationsvejledning Indhold LUDUS Web Installations- og konfigurationsvejledning... 1 1. Forudsætninger... 2 2. Installation... 3 3. Konfiguration... 9 3.1 LUDUS Databasekonfiguration...

Læs mere

Det Fælles Medicinkort. Snitfladebeskrivelse for Receptfornyelse og genbestilling. Version 1.4.0

Det Fælles Medicinkort. Snitfladebeskrivelse for Receptfornyelse og genbestilling. Version 1.4.0 Det Fælles Medicinkort Snitfladebeskrivelse for Receptfornyelse og genbestilling Version 1.4.0 2012-11-21 Trifork A/S Margrethepladsen 4 DK-8000 Århus C Denmark +45 8732 8787 Fax: +45 8732 8788 DK www.trifork.com

Læs mere

Grænseflade til afhentning af FTU-ansøgninger på Optagelse.dk

Grænseflade til afhentning af FTU-ansøgninger på Optagelse.dk Grænseflade til afhentning af FTU-ansøgninger på Optagelse.dk Dato 16-09-2015 Version Status 1.0 Gældende Ansvarlig Tobias Thisted Side 2 af 13 Ændringshistorik Version Kapitel/afsnit Beskrivelse 1.0 Hele

Læs mere

Tilsynsrapport Socialtilsyn Hovedstaden

Tilsynsrapport Socialtilsyn Hovedstaden Tilsynsrapport Socialtilsyn Hovedstaden Tilsynstype: Driftsorienteret tilsyn Område: Sociale tilbud Praktiske oplysninger Tilsynsrapporten indeholder socialtilsynets bedømmelse og vurdering af om tilbuddet

Læs mere

Grænsefladebeskrivelse for EFI

Grænsefladebeskrivelse for EFI Ver.: 1.0 Dato 28-06-2010 Grænsefladebeskrivelse for EFI Digitalt Motorregister (DMR) 2010-2011 Grænsefladebeskrivelse for EFI side 1/7 Denne interessentpakke indeholder en detaljeret beskrivelse af de

Læs mere

Fælles retningslinjer for REST webservices

Fælles retningslinjer for REST webservices Fælles retningslinjer for REST webservices Fællesoffentlig digital arkitektur Pelle Borgsten, Nikolaj Malkov, Christian Callsen Dagsorden Punkt 1. Formål 2. Principper og forretningsbehov 3. Retningslinjer

Læs mere

En teknisk introduktion til NemHandel

En teknisk introduktion til NemHandel En teknisk introduktion til NemHandel 02. december 2014 Indhold INDHOLD... 1 INDLEDNING... 2 STANDARDER... 4 OIOUBL e-handelsstandard... 4 OIORASP - transportprotokol... 5 BETINGELSER FOR ANVENDELSE AF

Læs mere

Brugervejledning EDI systemet for pensionsoverførsler. Pensionsoverførsler mellem et pensionsselskab og et pengeinstitut

Brugervejledning EDI systemet for pensionsoverførsler. Pensionsoverførsler mellem et pensionsselskab og et pengeinstitut Brugervejledning EDI systemet for pensionsoverførsler Pensionsoverførsler mellem et pensionsselskab og et pengeinstitut 1. november 2015 Brugervejledning til brugere af EDI-systemet for pensionsoverførsler

Læs mere

Guide til VandData for kommuner

Guide til VandData for kommuner Guide til VandData for kommuner Januar 2017 Version 1.0 Indhold Kapitel 1 Indledning... 1 1.1 Link til VandData... 1 1.2 Baggrund... 1 1.3 Øvrige relevante guides... 1 1.4 Guidens struktur... 1 Kapitel

Læs mere

KRAVSPECIFIKATION for underretningsstatistik

KRAVSPECIFIKATION for underretningsstatistik Ankestyrelsen Data og Analyse Den 4. marts 2014 KRAVSPECIFIKATION for underretningsstatistik Kontakt: Jesper Nyholm, Statistiksektionen, jny@ast.dk, tlf. 61 89 75 07 1 af 12 1. Indledning I denne kravspecifikation

Læs mere

1.1 Formål Webservicen gør det muligt for eksterne parter, at fremsøge informationer om elevers fravær.

1.1 Formål Webservicen gør det muligt for eksterne parter, at fremsøge informationer om elevers fravær. EfterUddannelse.dk FraværService - systemdokumentation BRUGERDOKUMENTATION: WEB-SERVICE Af: Logica Indhold 1. Indledning... 1 1.1 Formål... 1 1.2 Webservice version... 1 1.3 Historik... 1 2. Absence Webservice...

Læs mere

LUDUS WEB. Installations- og konfigurations-vejledning. Den 7. april 2009. J.nr.: 4004 V0624 09

LUDUS WEB. Installations- og konfigurations-vejledning. Den 7. april 2009. J.nr.: 4004 V0624 09 LUDUS WEB Installations- og konfigurations-vejledning Den 7. april 2009 J.nr.: 4004 V0624 09 CSC Scandihealth A/S, P.O. Pedersens Vej 2, DK-8200 Århus N Tlf. +45 3614 4000, fax +45 3614 7324, www.scandihealth.dk,

Læs mere

UNI Login. UNI Login webservice. ws-04

UNI Login. UNI Login webservice. ws-04 UNI Login UNI Login webservice ws-04 UNI Login UNI Login webservice 1.4 Indhold 1 UNI Login webservice... 1 1.1 Informationsmodel... 1 1.2 Entiteter og attributter... 2 1.2.1 Person... 2 1.2.2 Funktion...

Læs mere

STS Anvenderdokument i. STS Anvenderdokument

STS Anvenderdokument i. STS Anvenderdokument i STS Anvenderdokument ii REVISION HISTORY NUMBER DATE DESCRIPTION NAME 0.4 2014-07 N iii Indhold 1 Introduktion 1 1.1 Målgruppen...................................................... 1 2 STS 1 2.1 Snitflade........................................................

Læs mere

Navision Stat 7.0. CVR Integration. Overblik. Side 1 af 15. 30. april 2015 ØS/ØSY/MAG

Navision Stat 7.0. CVR Integration. Overblik. Side 1 af 15. 30. april 2015 ØS/ØSY/MAG Side 1 af 15 Navision Stat 7.0 30. april 2015 ØS/ØSY/MAG CVR Integration Overblik Introduktion I denne vejledning kan du læse om, hvordan du validerer dine debitorers og kreditorers data op imod Det Centrale

Læs mere

SOSI STS Testscenarier

SOSI STS Testscenarier SOSI STS Testscenarier Version 1.0.1 Status: Offentliggjort Indholdsfortegnelse 1 Introduktion... 2 1.1 Baggrund...2 1.2...2 1.3 Baggrundsmateriale... 2 1.4 Adgang...2 2 Test af STS Webservice... 4 2.1

Læs mere

Integrationsmanual. Anvendelse af webservice til kursusoversigt i Campus. Brugervejledning til udviklere

Integrationsmanual. Anvendelse af webservice til kursusoversigt i Campus. Brugervejledning til udviklere Integrationsmanual Anvendelse af webservice til kursusoversigt i Campus Brugervejledning til udviklere Moderniseringsstyrelsen Webservice manual til udviklere 2016 1 1. Indholdsfortegnelse Nyt kapitel

Læs mere

Sådan sætter du TraceTool op til tælleugerne

Sådan sætter du TraceTool op til tælleugerne Sådan sætter du TraceTool op til tælleugerne TraceTool er det værktøj, som medarbejderne i din kommune skal anvende til at registrere henvendelser manuelt i tælleugerne. Denne vejledning beskriver, hvordan

Læs mere

Vejledning til kommuners brug af Serviceplatformen

Vejledning til kommuners brug af Serviceplatformen Vejledning til kommuners brug af Serviceplatformen Udarbejdet for: KOMBIT A/S Halfdansgade 8 2300 København S 1 Indhold 1 Indledning... 3 2 Ordforklaringer... 3 3 Oprettelse... 4 4 Arbejdsgange på Serviceplatformen...

Læs mere