| Konfigurationsstyrning tjänstedomänerVersion 2.2.9 ARK_0007 2022-12-07 |
...
1.1 Målgrupp och förkunskaper
Dokumentet riktar sig i första hand till de som praktiskt utvecklar och förvaltar tjänstekontrakt baserade på RIV Tekniska Anvisningar (RIV TA), men även till de som ansluter till tjänster där interaktionen beskrivs av tjänstekontrakt (tjänsteproducenter och tjänstekonsumenter).
För att använda handledningen krävs förkunskaper i användandet av versionshanteringssystem (specifikt Git), design av WSDL och XML-schema, grundläggande kunskaper i hur s.k. WSDL-first-utveckling av tjänster bedrivs i .Net och Java EE
...
.
1.2 Syfte
Det övergripande syftet med denna handledning är att underlätta arbetet för de som utvecklar och vidareutvecklar tjänstekontrakt för att säkerställa korrekt versionshantering och release av tjänstekontrakt och tjänstedomäner.
1.3 Avgränsning
Kravhantering ingår inte i denna handledning, inte heller aktiviteter relaterade till att samordna och informera tjänstedomänens intressenter. Detta förutsätts ske inom aktuellt projekt eller förvaltning.
Dokumentet hanterar endast de releaser och releasekandidater som är föremål för den kvalitetssäkring och publicering som Ineras Arkitektursektion ansvarar för.
1.4 Krav på utvecklingsmiljö
...
Funktion | Verktyg |
Använda versionshanteringssystemet på Bitbucket | Lämplig Git-klient, se http://rivta.se/bitbucket. |
Köra RIVTA - verktyg och verifiera byggscript för JAXWS (genererad Java-version av WSDL-filerna)Oracle JDK version 7 eller högre | |
Verifiera byggscript för WCF (genererad .Net-version av WSDL-filerna) | Microsoft .Net SDK (ingår i Visual Studio, men kan också laddas ner separat från Microsoft) |
Köra RIVTA verktyg | Groovy 2.1 eller högre, se http://groovy.codehaus.org/ Python 2.7 eller högre, se https://www.python.org/ |
RIVTA verifiering | verifyRivtaDomain.py
|
...
När ett dokument ska uppdateras görs det i den senaste versionen av dokumentet som finns för den domänversion som ska uppdateras.
2.2.2 Skapa/uppdatera schemafiler
...
På http://rivta.se/development.html finns referens till verktyg som kan användas vid skapande/uppdatering av schemafiler. De anvisningar som finns på samma sida bör följas.
...
anvisningar som finns på samma sida bör följas.
2.2.3 Skapa/uppdatera testsvit och självdeklaration
...
clinicalprocess:healthcon:actoutcome 4.0.2 | clinicalprocess:healthcon:actoutcome 4.0.2 |
---|---|
GetLaboratoryOutcome 4.0 | GetLaboratoryOutcome 4.0 |
GetReferralOutcome 3.1 | GetReferralOutcome 3.0 |
GetImagingOutcome 1.0 | GetReferralOutcome 3.1 |
GetMaternityMedicalHistory 2.0 | GetImagingOutcome 1.0 |
GetMaternityMedicalHistory 2.0 |
Exempel gällande domänversionering finns under Appendix 2.
3.2 Versionshantering av scheman
...
Typer som används i flera tjänstekontrakt kan deklareras i en eller flera domängemensamma schemafiler som placeras i katalogen /schemas/core_components/
Vid behov av förändringar och tillägg av gemensamma typer behöver följande beaktas:
...
Info | ||||
---|---|---|---|---|
| ||||
Strukturen för tjänstedomäner, enligt regelverket, ser ut på följande sätt: code_gen
|
...
Om ett nytt Git-repository ska skapas för aktuell tjänstedomän på Bitbucket, behöver du själv initiera denna och skapa nödvändig katalogstruktur. Alla tjänstedomäner ska följa en gemensam och fastställd filstruktur. Denna struktur och namnstandard är inkorporerad i script och måste därför strikt följas.
Exempel:
...
...
Figur 2. Filstruktur i tjänstedomän.
docs
I "docs"-katalogen finns tjänstekontraktsbeskrivning (TKB), informationsspecifikation (IS), arkitekturella beslut (AB) och självdeklarationer. Om något eller några tjänstekontrakt i domänen använder JoL-headern, ska denna katalog även innehålla fältregeldokument för de versioner av JoL-headern som används i domänen.
...
Skapa följande katalogstruktur i ditt Git-repository:
code_gen
code_gen/jaxws
code_gen/wcf
docs
schemas
schemas/core_components
...