...
Tjänstekontaktsbeskrivning (TKB) .docx
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
kompletterar reglerna i de tekniska artefakterna (XML-scheman och WSDL-filer)
Informationsspecifikation (IS) .docx
beskriver informationsinnehållet ur ett verksamhetsperspektiv
beskriver vad tjänsten ska göra med hjälp av arbetsflöden och användningsfall
Arkitekturella beslut (AB) .docx
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
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-filer (används för att kontrollera tjänstekontrakts logiska regler). För mer info, se Schematron
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. |