Innehåll i releasepaket för tjänstedomän

Beskrivning av tjänstedomänens krav och regler samt alla ingående tjänstekontrakt. Kompletterar reglerna i de tekniska artefakterna (XML-scheman och WSDL-filer)

Beskrivning där man redovisar resultatet från såväl verksamhets-, begrepps-, informationssäkerhets- och informationsanalys för ett visst syfte. Informationsspecifikationen är till för att på ett standardiserat och strukturerat sätt beskriva informationsbehovet ur ett verksamhetsperspektiv.

Dokumentation av ett eller flera arkitekturella beslut. Ett arkitekturellt beslut kan innefatta alla aspekter av arkitekturen såsom systemstruktur, funktionalitet, standarduppfyllnad, operationella aspekter samt avsteg från regelverk.

Säkerställer att nya personer som börjar jobba med en tjänstedomän snabbt kan sätta sig in i arkitekturen och förstå skälen till att den ser ut som den gör

Anslutning till nationella tjänsteplattformen bygger på en tillitsmodell som innebär att anslutande part själv kan testa att anslutningen följer tjänstekontraktsbeskrivningen. Resultatet av testerna redovisas i självdeklarationer som skickas in till Inera för granskning. 

WSDL (Web Services Description Language) beskriver en webbtjänst.

XML-schema som definierar element som utgör tjänstens begäran och svar (request och respons).

Definierar gemensamma element inom en tjänstedomän.

Testsviter utvecklade i SoapUI används för att verifiera producentanslutningar till nationella tjänsteplattformen. Resultatet av testerna dokumenteras i självdeklarationer. För verifiering av konsumentanslutningar innehåller testsviten ett mockprojekt som returnerar olika typer av svarsmeddelanden. Testsviterna kan laddas ner från rivta.se. 

De flesta tjänstekontrakt har en fil som heter constraints.xml. Denna fil innehåller de schematronregler som valideras i testfallen. På motsvarande sätt kan det finnas en constraint.xml i mockprojekt som validerar de anrop (requests) som skickas till mocken.

Schematron används för att kontrollera de logiska regler som gäller för just detta tjänstekontrakt. Dessa regler finns också listade i TKB, kapitel ”Övriga regler”.

Exempel på logiska regler:

• Om fält X är angivet så får ej fält Y vara angivet

• Fält Z kan bara ha ett värde från en begränsad värdemängd

Schematron är ett regelbaserat schemaspråk där reglerna appliceras på XML-dokument, i detta fall anrop (request) och svar (response) i SOAP-UI. Schematron behöver inte känna till strukturen på XML-dokumentet, istället definierar man olika kontext som schematron letar upp.

Notera att kardinalitet, namn och ordning på element kontrolleras mot kontraktens schemafiler och inte av schematronreglerna.