Aktiviteter och frågeställningar - Tillfällig sida -tas bort när allt är klart!
Aktuella domäner - Sammanställning över aktuella domäner
Masterfiler domännamnsättning - Används för att skicka för publicering på intranät - kan utgå när publicering görs på annat sätt
Domändatabasen - Databas där nedanstående information om domänerna finns beskrivet och lagrat.
Domännamnsättning - anvisning - Beskrivning av hur domännamnsättning sker
Domänkarta - Karta över domäner
Domäninformation - Informationsspecifikation för domäninformation
Samtliga domäntyper skall använda samma struktur för domännamn och metadata, men har lite olika regler för namnsättning och ifyllnad av metadata. Gransknings/kvalitetssäkringsprocessen är olika för de olika domäntyperna.
Processen för domännamnsättning sker i fyra steg:
1: Förslag till namn på domän med tillhörande metadata tas fram av projekt/intressent enligt nedanstående riktlinjer. Förslaget mailas till nationellkundservice@inera.se
2: Diskussion/avstämning med Arkitektur och regelverk inklusive avstämning av beskrivning med kommunikatör
3: Avstämning och godkännande i Strategisk arkitektur
4: Arkitektur och regelverk dokumentera domänen och registrerar domänen i domändatabasen
Riktlinjer för namnsättning av domäner och dess metadata
Domäntyp
Anger typ av tjänstedomän. Idag finns tre typer:
Domäntyp | Beskrivning | |
---|---|---|
Nationell tjänstedomän | Tjänstedomänen utvecklas och/eller förvaltas av Inera. Inera A&R ansvarar för kvalité inom teknik, informatik, arkitektur och testsviter/tjänsteproducenter, samt att att domänen passar in i och har en tydlig roll i den sammantagna pottföljen av nationella tjänstekontrakt. A&Rs kvalitetssäkringsprocess följs under utvecklings- och förvaltningsfasen. | |
Extern tjänstedomän | Annan part än Inera A&R utvecklar/förvaltar tjänstedomänen. Annan part ansvarar för kvalité inom teknik, informatik och arkitektur. Tjänstekontrakten i tjänstedomänen följer giltig RIV TA-profil (tjänstekontraktens tekniska utformning och paketering) och kan därmed driftsättas och anslutningshanteras i NTJP om ICC.s infrastrukturkrav är uppfyllda. Tjänstekontrakten tillämpas inte inom Ineras uppdrag. Inera A&R ansvarar inte för namnsättning utöver vad som anges nedan, men kan konsulteras om extern part önskar. | |
Applikationsspecifik tjänstedomän | Tjänstedomänen definierar ett applikations/lösningsspecifikt API till en applikation/tjänst som ägs av Inera. Applikationsförvaltningen vill återanvända Ineras anslutningsorganisation och infrastruktur (Tjänsteplattformen), men ha kvar full kontroll över alla beslut som rör kontraktsdesign, versioner och releaser. Förvaltningen har ett eget, lokalt ansvar för tjänstekontraktens arkitektur, informatik och teknik inom ramen för det ansvar som projektet/förvaltningen har för applikationen/tjänsten i sig. Tjänstekontrakten får bara användas när den specifika applikationen/tjänsten är en av parterna i informationsutbytet. |
Tekniskt domännamn
Det tekniska domännamnet används i uppbyggnaden av meddelandefinitionens namnrymd. Namnrymden ger ett avtryck i den information som förs över och har därför en inverkan på kompatibilitet mellan versioner. Tjänstekontraktets huvudversion är också en del av namnrymden. Därför innebär en ändring av såväl tekniskt namn som huvudversion att kompatibiliteten (teknisk interoperabilitet) bryts. Därför kan tekniska domännamnet enbart ändras i samband med lansering av en ny huvudversion. Ineras namnsättning av tjänstedomäner är en slutprodukt av Ineras portfölj- och kvalitetsstyrningen för tjänstekontraktsutbudet. Den tekniska namnsättningen speglar i regel strukturen i den domänkarta som Inera tillämpar. Med hjälp av domänkartan kan Inera katalogisera tjänstedomäner och undvika överlapp/redundans i portföljen.
Namnsättning sker enligt följande kriterier:
Kriterier | Namnsättning | |
---|---|---|
1 | Nationell tjänstedomän | Tekniskt domännamn tilldelas enligt gällande rutin för domännamnsättning |
2 | Extern tjänstedomän | Tekniskt domännamn tilldelas av ägande organisation. |
3 | Applikationsspecifik tjänstedomän | Tekniska domännamnets första del sätts till applikationens namn (förkortas vid behov). Resterande två delar sätts av applikationsförvaltningen. Rekommendationen är att den namnsättningen speglar applikationens egen arkitektur/namnsättning. |
4 | Övrigt | Kontakta Arkitektur och regelverk |
Tekniskt prefix
Tekniskt prefix är den första byggstenen i namnrymden för det innehåll som kommuniceras när tjänstekontraktet tillämpas för informationsutbyte.
Kriterier | Namnsättning | |
---|---|---|
1 | Nationell tjänstedomän | riv: |
2 | Extern tjänstedomän | riv-<ägande organisation>: |
3 | Applikationsspecifik tjänstedomän | riv-application: |
4 | Övrigt | Kontakta Arkitektur och regelverk |
Svenskt kortnamn
Namnet skall vara kortfattat och kärnfullt och beskriva vad tjänstedomänen hanterar för information. Speglar alltid domänens innehåll, det är därför viktigt att det får rätt namn. Används för att hitta/söka och i mänsklig kommunikation. Saknar användning inom Journal- och läkemedelskontrakten.
Definition
Anger domänens syfte och ändamål. Skrivs av Inera Arkitektur och regelverk för Nationella domäner. För övriga domäner skriver respektive ägare definitionen.
Beskrivning
Beskrivning av domänen, motsvarar dagens webtext. Beskrivning kan behöva uppdateras exempelvis till följd av nya tjänstekontrakt inom domänen. Förändring får endast ske vid majoruppdateringar och skall ske enligt rutin Hantering av webb-text.
Ägande organisation
Organisation som ansvarar för och äger domänen. För nationella tjänstedomäner och för applikationsspecifik tjänstedomän är ägaren Inera. För applikationsspecifika tjänstedomäner anges även vilken förvaltning inom Inera som äger applikationen vars API domänen beskriver.
Exempel:
- Inera
- Inera, Stöd- och behandlingsplattformens förvaltning
- Socialstyrelsen
- SKL
- Ehm
- SLL
- Telia
Kategori nivå1 och nivå 2
Används för kategorisering och gruppering av domäner samt för att söka/hitta inom en domän, möjliggör en samlad bild, som annars blir fragmenterad, även om varje enskild domän är sökbar. Motsvarar det tidigare Svenskt domännamn. Viktigt i Arkitektur och regelverks arbete för att styra och förvalta tjänstekontraktsportföljen.
Kategorierna sätts enligt Arkitektur och regelverks gällande domänkarta och sker enligt gällande rutin för domännamsättning.
Saknas domänen i gällande domänkarta får utökning/tillägg/omdefinition göras. Detta för att få den samlade bilden.
Anges endast för Nationella tjänstedomäner.
Referens modell
Referensmodell som har används för den tekniska namnsättning.
VIFO, IHE, HL7 FHIR m.fl på sikt
Anges endast för nationella tjänstedomäner.
Exempel
Exempel 1 – PCD från IHE
Tekniskt domännamn: IHE.PCD.DEC
Tekniskt prefix: riv:
Svenskt kortnamn: Mätdata från mätutrustning
Kategori nivå 1: vård- och omsorg kärnprocess
Kategori nivå 2: hantera hälsorelaterade tillstånd
Ref modell: IHE
Ägande organisation: Inera
Domäntyp: Nationell tjänstedomän
Exempel 2 – Utomlänsfakturering
Tekniskt domännamn: Financial:billing:claim
Tekniskt prefix: riv:
Svenskt kortnamn: Utomlänsfakturering
Tagg-Kategori nivå 1: Affärshantering
Tagg-Kategori nivå 2: Fakturahantering
Tagg-Ref modell: FHIR
Ägande organisation: Inera
Domäntyp: Nationell tjänstedomän
Exempel 3 – Extern tjänstedomän - CGI efrikort
Tekniskt domännamn: cgi:healthcare:efrikort
Tekniskt prefix: riv-cgi:
Svenskt kortnamn: CGI Efrikort
Tagg-Kategori nivå 1: N/A
Tagg-Kategori nivå 2: N/A
Tagg-Ref modell: N/A
Ägande organisation: CGI
Domäntyp: Extern tjänstedomän
Exempel 4 – Applikationsapi för Stöd- ochbehandlingsplattformen
Tekniskt domännamn: sob:apps:resident
Tekniskt prefix: riv-application:
Svenskt kortnamn: Applikationsapi Stöd och behandlingsplattform
Tagg-Kategori nivå 1: N/A
Tagg-Kategori nivå 2: N/A
Tagg-Ref modell: N/A
Ägande organisation: Ineras förvaltning för Stöd- och behandlingsplattformen
Domäntyp: Applikationsspecifik tjänstedomän