Revisionshistorik

Domännamnsättning - anvisning - Beskrivning av hur domännamnsättning sker
Domänkarta - Karta över domäner

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 kundservice@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: 

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 (vid nyutveckling av domäner):

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.

OBSERVERA: nedanstående gäller vid nyutveckling av domäner. Domäner som bytt ägare utan att det funnits tekniska behov av förändring kan fortsatt ha tidigare prefix så det är inte nedanstående prefix som hårt styr kategoriseringen.

Vid ny huvudrelease ska dock prefix ändras och det innebär då att alla tjänstekontrakt som ingår i domänen behöver ändras och därmed få en ny huvudversion oavsett om det finns funktionella krav.

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 /wiki/spaces/TG/pages/5182564.

Ä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

Anges endast för Nationella tjänstedomäner.

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.

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.

Referensmodell

Anges endast för nationella tjänstedomäner.

Referensmodell som har används för den tekniska namnsättning.
VIFO, IHE, HL7 FHIR m.fl på sikt

Exempel

Exempel 1 – Utomlänsfakturering

Namespace: urn:riv:financial:billing:claim:1

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 2 Extern domän - Läkemedelsverket

Namespace: urn:riv-lv:lv:reporting:pharmacovigilance:1

Tekniskt domännamn:           riv-lv:lv:reporting:pharmacovigilance:1    

Tekniskt prefix:                      riv-lv:

Svenskt kortnamn:                Läkemedelsbiverkningar

Tagg-Kategori nivå 1:           N/A

Tagg-Kategori nivå 2:           N/A

Tagg-Ref modell:                 N/A

Ägande organisation:          Läkemedelsverket

Domäntyp:                           Extern tjänstedomän

Exempel 3 – Applikationsspecifik domän - Stöd och behandlingsplattformen

Namespace: urn:riv-application:sob:apps:resident:1

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:          Inera

Domäntyp:                           Applikationsspecifik tjänstedomän