Om Terminologitjänsten (TT)

Hur fungerar Terminologitjänsten?

Terminologitjänsten fungerar som ett datalager för kodverk, urval och mappningar. Tjänsten har ett användargränssnitt där man kan skapa, söka och hämta hem kodverk. Tjänsten har också ett elektroniskt gränssnitt (api) som kan användas för att söka och hämta kodverk, urval och mappningar från andra IT-tjänster.

Vem kan använda Terminologitjänsten?

Tjänsten är öppen för alla att använda och kräver inte inloggning för att söka och hämta hem icke-licensierade kodverk, urval och mappningar.

För att skapa kodverk, urval och mappningar krävs inloggning, vilket för närvarande är begränsat till regionerna i Sverige.

De regioner som är intresserade av att använda Terminologitjänsten utser en sektorsansvarig, det vill säga den person som kommer att förvalta och ansvara för regionens kodverk, urval och mappningar. Det är också denna person som beslutar om vilka i den egna regionen som ska ha behörighet att kunna logga in till tjänsten och där arbeta med regionens kodverk, urval och mappningar.

Hur gör man för att börja använda Terminologitjänsten?

För att söka och hämta hem kodverk, urval och mappningar krävs inte något avtal, det går bra att använda sökfunktionen på webbsidan direkt.

För att ha möjlighet att skapa kodverk, urval och mappningar, krävs att användande region beställer Terminologitjänsten via Ineras kundportal, se https://inera.se/kontakta-oss.

I samband med hanteringen av beställningen meddelas även vem som ska vara sektorsansvarig.

Vilken information finns i Terminologitjänsten?

Terminologitjänsten innehåller kodverk, urval och mappningar:

kodverk som är nationella och kommer från myndigheter, exempelvis Snomed CT och ICD-10
kodverk, urval och mappningar som skapas och underhålls av enskilda aktörer, såsom regioner eller Inera
kodverk, urval och mappningar som skapas och underhålls av en grupp aktörer, exempelvis en grupp regioner.

Hur gör jag för att få behörighet att logga in i Terminologitjänsten?

Regionens sektorsansvarige beslutar om vilka som ska ha behörighet till tjänsten och då ha möjlighet att skapa kodverk, urval och mappningar.

Regionens sektorsansvarige tar hjälp av sin lokala HSA-förvaltning för att hantera behörigheterna i tjänsten. Behörigheterna registreras som administrativa medarbetaruppdrag med behörighetsområde Terminologitjänsten och behörighetsområdesegenskapen full behörighet eller begränsad behörighet för den egna regionen.

Hur gör vi för att koppla upp oss och läsa Terminologitjänsten elektroniskt?

Först måste organisationen ha ett ramavtal med Inera och därefter ha tecknat ett abonnemang på Terminologitjänsten. Efter det ansöker man om elektronisk anslutning. Detta förfarande innebär att man beskriver sin uppkopplade miljö, genomför tester av sina anrop och gör konfiguration av sin anslutande miljö enligt anvisning från Inera. Därefter kan anrop mot Terminologitjänstens produktionsmiljö göras. Beskrivning och formulär för ansökan om anslutning finns här: Teknisk anslutning

Behöver en sektor vara en region?

En region kan vara förvaltare av en sektor. Det kan i längden också vara en annan avgränsning såsom kommun eller en privat aktör som förvaltar en sektor. Det viktiga är att en sektor har en ansvarig för tilldelning av behörigheter inom sektorn. Det är den som ansökt om sektorn som avgör vad som ska ingå i sektorns arbetsområde.

Hur många förvaltare kan vi ha i en sektor/region? Och vem bestämmer vilka dessa ska vara samt vad de ska heta?

För respektive kodverk, urval eller mappning i Terminologitjänsten är det viktigt att det finns en utpekad och namngiven förvaltning, samt en innehållsansvarig. Terminologitjänsten styr inte vilka och hur många förvaltare som ska finnas inom en sektor eller deras benämning. Innehållet inklusive vilka förvaltare som ska finnas i en sektor är därför mycket upp till på den som har ansökt om en sektor.

Att använda Terminologitjänsten (TT)

Hur lägger jag till enstaka koder till ett urval om koderna inte finns i kodverken?

Ett urval är just ett urval. Dvs, det använder delar ur ett befintligt kodverk. Om det saknas koder i kodverken som man vill ha med i urvalet, skall de antingen tillfogas i befintliga kodverk först, eller ett nytt kodverk skapas. Ett urval kan också göras ur flera kodverk.

Går det att arbeta tillsammans med andra regioner (sektorer)?

Ja, det kommer att gå att samarbeta på många olika sätt:

Terminologitjänsten kommer förutom regionspecifika sektorer också ha möjlighet att sätta upp sektorer som kan delas mellan flera regioner som vill arbeta tillsammans med vissa kodverk, urval och mappningar. En sådan sektor kommer fortfarande behöva ha en utsedd utgivare, förvaltare och innehållsansvarig.
Tjänsten uppmuntrar till återanvändning av kodverk, urval och mappningar. Det kommer därför gå att söka, titta på och granska andra regioners kodverk, urval och mappningar (så länge dessa inte aktivt skyddats). En region kan således använda andra regioners eller aktörers kodverk.

Går det att återanvända kodverk, urval och mappningar från andra sektorer/regioner?

Ja, all information i Terminologitjänsten kommer att vara synlig för alla användare.

Hur påverkas ett urval av att kodverken som jag hämtat kodposter ifrån får nya versioner?

Ett urval byggs upp mha kodposter från valda versioner av kodverk. Urvalets använder kodposter från de versioner av kodverket som användes vid skapande av urvalet. Underliggande kodverk kan alltså få nya versioner utan att urvalet ändras/påverkas. Detta för att urvalen ska vara pålitliga och ej oavsiktligen röra på sig. Integrationer och tillämpningar som använder ett specifikt urval fortsätter att fungera på samma sätt. Att ändra ett urvals innehåll till att använda andra versioner av underliggande kodverk kräver således en aktiv handling. Det är bra att bygga urval på versioner som har versionsstatus ‘Aktiv' då de inte ändrar på sig. Versioner med versionsstatus 'Utkast’ kan fortfarande förändras.

Är det möjligt att ha exempelvis 'yrkeskodverk' i TT? Dvs, andra kodverk än hälso- och sjukvårdsrelaterade. Exempelvis kodverk relaterade till länstrafiken.

Ja, det finns inga tekniska begränsningar i TT att lägga in andra kodverk. Snarare är det en förvaltningsfråga då det alltid ska finnas någon som är ansvarig för innehållet och dess förvaltningen.

Kommer det gå att sätta kategorier även vid mappning mellan egna kodverk? Exempelvis i mappningar med förhållanden [1..n] eller [n..1]?

Kategorierna är en vanlig del av klassificeringen inom det kodverket som man mappar till. Kategorier i kodverken kommer att kunna editeras i samband med att man arbetar med kodverken, men under själva mappningen så editeras inte ingående kodverk.

Det hittas löpande fel i nya versioner av kodverk som ICD-10 och KVÅ. Kommer Inera testa och kvalitetssäkra nya versioner?

Terminologitjänsten ger teknisk möjlighet att hålla kodverk, urval och mappningar. Alla dessa artefakter kommer att ha en utgivare och en innehållsansvarig som står för kvalitetssäkringen. Inera kommer att ta ansvar för de artefakter som Inera producerar. I de fall ex. ett kodverk inte är Ineras egna produkt ligger kvalitetsansvaret på den producerande organisationen. I fallet ICD-10 och KVÅ är det Socialstyrelsen som skapar dessa kodverk och kvalitetsfrågor gällande tester, förändringar och rättningar kommer att behöva tas upp med Socialstyrelsen som producent.

Det finns tidigare dokumenterade behov av systemstöd för kvalitetsmärkning av exempelvis kodverk. Behöver vi ha kvalitetsindikatorer som är förvaltade och sökbara i TT?

Frågan togs upp en första gång i referensgruppen 2022-12-14 som konstaterade att det är en ganska stor utmaning att åstadkomma detta på ett bra sätt. Bedömningen om ett kodverks innehåll håller hög eller låg kvalitet ligger till stor del i konsumentens syfte med användandet. Ett och samma kodverk kan vara av hög kvalitet för ett användningsområde/syfte, och av låg kvalitet i ett annat användningsområde/syfte. Detta gör att bedömningen lätt uppfattas som subjektiv.

Större kodverk som Snomed och ICD-10 kan generellt antas komma med en viss kvalitetsnivå då de genomgår en kvalitetsprocess.

Lösningskommentar: Alla kodverk (och andra artefakter) i TT kommer ha en förvaltare och en innehållsansvarig med kontaktuppgifter, samt en möjlighet att i TT beskriva syftet med respektive kodverk och dess versioner. Varje version kommer också att ha en versionsstatus motsvarande Utkast, Aktiv eller Avställd.

Hur ser relationerna ut vid mappning mellan kodverk (och urval) i det utvecklade gränssnittet?

Följande riktlinjer används inom Terminologitjänsten (TT) vad gäller relationer mellan artefakter:

Ett Urval i TT är just ett urval av kodposter från 1..n kodverk inlagda i TT .
Urval avses ej kunna göras utifrån befintliga urval, endast utifrån befintliga kodverk.
En Mappning kan ske:
- Källa/Från kodposter i 1st urval eller 1st kodverk (som utgör mappningens källa). Om källan är ett urval så kan det bygga på 1..n i TT inlagda kodverk
- Mål/Till 1..n antal kodposter tagna från 1st antal urval eller kodverk
- Alla kodposter som används i mappningen skall tas från vald källa eller mål. Det kommer inte gå att lägga till 'lösa' kodposter vid själva mappningen som inte redan ligger i källan eller målet.
- Alla kodposter i källan (eller målet) behöver inte finnas med i den färdiga mappningen. En färdig mappning skall kunna innehålla/använda en delmängd av källans (och målets) kodposter.

Hur fungerar versioner och vilka ska jag använda?

TT arbetar med något som vi kallar versionsstatus. För en version av ett kodverk, urval eller mappning kan versionsstatus ha något av följande status/tillstånd, där en version kan jämföras med en utgåva av en bok.

Bokens utgåva (version) är densamma under resan från Utkast, Aktiv och till att den blir Avställd. Men senare kan utgivaren (förvaltaren/innehållsansvarig) vilja ge ut en ny utgåva (version) av boken och påbörjar då en ny version som då har versionsstatus ‘Utkast’.

Utkast

När en ny artefakt (kodverk, urval eller mappningsspecifikation) skapas får den versionsstatus ‘Utkast’. Detta är ett tillstånd för utveckling. Här kan den som producerar artefakten göra ändringar i namnsättning, kontaktuppgifter till utgivare mm. Här kan även artefaktens innehåll editeras. Exempelvis ett kodverks kodposter kan läggas till, ändras eller tas bort.

Ur ett konsumentperspektiv är innehållet rörligt och ej ‘färdigt’. För att uppfylla kraven på tjänsten om möjlighet att följa, granska och återanvända andra aktörers utvecklingsarbete, går det även att söka fram egna och andras utkast.

Som en liknelse är det som en bok (som en eller flera) fortfarande håller på att skapa. Detta kan fortgå under en lång tid.

Aktiv

När den aktuella versionen är färdig kan den som producerar och äger en artefakt sätta artefakten som ‘Aktiv'. Det betyder att utgivaren anser den är avsedd att användas. Versionen är nu ej längre möjlig att editera. Ungefär som att skicka boken till 'tryck’. Ur producentperspektiv är den lämplig att distribuera vidare i sin organisation eller till andra intressenter.

Ur ett konsumentperspektiv är innehållet garanterat orörligt. Det betyder att det går att lita på att denna version ej ändras, vilket är viktigt för att kunna använda den i konsumerande system, integrationer, etc.

Om utgivare och förvaltare vill göra ytterligare förändringar (i boken som nu är skickad till tryck), så får dessa göras i nästa ‘upplaga'. Dvs, då kan denna ‘Aktiva’ artefakt användas för att skapa ett nytt 'Utkast’ (en ny version/utgåva).

Avställd

När den aktuella versionen av olika skäl inte är lämplig att användas (utdaterad, ej supportad, ej längre aktuell osv.) kan den som producerar och äger en artefakt sätta artefakten som ‘Avställd'. Det betyder att utgivaren anser att den INTE är avsedd att användas längre.

Som liknelse anser producenten att det finns bättre böcker eller senare utgåvor som är bättre lämpade, men precis som gamla utgåvor av böcker, kan producenten inte veta om de ändå fortfarande läses och används.

I TT går det fortfarande att söka och titta på avställda artefakter, samt även senare att plocka upp en gammal avställd artefakt för att skapa ett nytt utkast. Då skapas en ny version för detta.

Att ändra versionsstatus

Hur ändrar jag versionsstatus från ‘Utkast’ till ‘Aktiv’ för en version?

Om du är inloggad och du har behörighet att redigera artefakten så kan du ändra en artefakt från ‘Utkast’ till ‘Aktiv' och sedan när den inte ska användas längre vidare till 'Avställd’.

Logga in
Välj din artefakt så att du får upp flikarna nedan som används för att hantera artefakten
Välj att ‘Redigera’ artefakten
Välj fliken ‘Versionsinformation’
Tryck på knappen ‘Aktivera..’

Kom ihåg! Om det finns fel eller varningar vad gäller metadata eller innehåll i artefakten kan tjänsten förhindra en aktivering.

Vilka filformat fungerar vid import av kodverk?

I denna stund (aug-2023) avses endast kodposter tas från fil vid import. Övrig metadata förutsätts läggas till manuellt vid skapande av det kodverk som avses importeras till.

Initialt filformat är Excelfiler (*.xlsx). Andra filformat kan tillkomma senare.

Varje rad i filen ska innehålla:

kod
klartext
beskrivning

Öppen info: Terminologitjänsten

Vanliga frågor och svar