Ett releasepaket för en tjänstedomän består av:
Textuella dokument
| Expandera | ||
|---|---|---|
|
...
beskriver tjänstekontrakten inom en tjänstedomän
...
är ett formellt regelverk som reglerar integrationskrav för parter (tjänstekonsumenter och tjänsteproducenter) som avser ansluta system för samverkan enligt dessa tjänstekontrakt
...
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) |
| Expandera | ||
|---|---|---|
|
...
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 |
...
. |
| Expandera | ||
|---|---|---|
|
...
beskriver viktiga arkitekturella beslut som fattats för en tjänstedomän, tillsammans med varför beslutet fattades och dess påverkan på resten av arkitekturen
...
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 |
...
Tekniska artefakter per tjänstekontrakt:
WSDL-fil (interfacebeskrivning)
XML-scheman (metadata för fråge- och svarsmeddelanden)
Exempel-meddelanden (finns endast för vissa tjänstekontrakt)
Skript-filer för att generera Java- och .Net-stubbar för tjänstekonsument och tjänsteproducent
Testsviter
Självdeklarationer
Schematron
| Expandera | ||
|---|---|---|
| ||
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. |
Tekniska artefakter
| Expandera | ||
|---|---|---|
| ||
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). |
| Expandera | ||
|---|---|---|
| ||
Definierar gemensamma element inom en tjänstedomän. |
| Expandera | ||
|---|---|---|
| ||
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. |
| Expandera | ||
|---|---|---|
| ||
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:
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. |