Jämförda versioner

Nyckel

  • Dessa rader lades till.
  • Denna rad togs bort.
  • Formateringen ändrades.

...

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 att hämta hem licensierade regionens kodverk, urval och mappningar krävs inloggning och den är förnärvarande begränsad till regionerna i Sverige. . 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 icke-licensierade 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, samt att läsa licensierat material krävs att användande organisation först tecknar ett ramavtal med Inera och sedan ett abonnemang på Terminologitjänsten. Detta görs i Ineras kundportal: www.inera.se  

Därefter ansöker medarbetare i kundens organisation om behörighet hos sin lokala eller regionala HSA-administration för ett så kallat ”administrativt medarbetaruppdrag” i Terminologitjänsten. 

Tjänsten är för närvarande begränsad till att enbart ha regioner som inloggade användare. 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? 

...

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

För att Regionens sektorsansvarige beslutar om vilka som ska ha behörighet till tjänsten och då ha möjlighet att skapa kodverk, urval och mappningar, samt att läsa licensierat material krävs att användande organisation först tecknar ett ramavtal med Inera och sedan ett abonnemang på Terminologitjänsten. Detta görs i Ineras kundportal: www.inera.se  

Därefter ansöker medarbetare i kundens organisation om behörighet hos sin lokala eller regionala HSA-administration för ett så kallat ”administrativt medarbetaruppdrag” i Terminologitjänsten. 

Tjänsten är för närvarande begränsad till att enbart ha regioner som inloggade användare. 

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 som ska få redigeringsbehörighet i en sektor, är därför mycket upp till på den som har ansökt om en sektor. För varje artefakt är det obligatoriskt att ange vem som är förvaltare och innehållsansvarig för artefakten (detta görs i artefaktens ‘Metadataflik’).

Att använda Terminologitjänsten (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 ägare, 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.

...

Ja, all information i Terminologitjänsten kommer att vara synlig för alla användare. (Dock kan det tillkomma begränsningar för kodverk som lyder under licensvillkor som gör att en region inte får dela med sig av dess innehåll).  

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

...

Terminologitjänsten ger teknisk möjlighet att hålla kodverk, urval och mappningar. Alla dessa artefakter kommer att ha en ägare förvaltare 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.

...

Lösningskommentar: Alla kodverk (och andra artefakter) i TT kommer ha en artefaktsägare 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 UtfasadAvställd.

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

...

  • 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.

Varför kan jag inte ladda hem ett kodverk eller urval? 

...

    • .

...

Hur fungerar versioner och vilka ska jag använda?

TT och underliggande produkt och databas 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 (i vårt fall förvaltaren) 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 artefakten en ny artefakt (kodverketkodverk, urvalet urval eller mappningsspecifikationenmappningsspecifikation) skapas har får den statusen versionsstatus ‘Utkast’. Detta är ett tillstånd för utveckling. Här kan en producent av en artefakt den som producerar artefakten göra ändringar i namnsättning, kontaktuppgifter till ägare förvaltaren och innehållsansvarig mm. Här kan även artefaktens innehåll editeras. Exempelvis ett kodverks kodposter kan läggas till, ändras eller tas bort.

...

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 ägaren utgivaren (i vårt fall förvaltaren) 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 ägare och förvaltare utgivaren (i vårt fall förvaltaren) 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).

UtfasadAvstä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 ‘Utfasad‘Avställd'. Det betyder att ägaren utgivaren (i vårt fall förvaltaren) anser att den INTE är avsedd att användas längre.

...

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

...

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’.

  1. Logga in

  2. Välj din artefakt så att du får upp flikarna nedan som används för att hantera artefakten

  3. Välj att ‘Redigera’ artefakten

  4. Välj fliken ‘Versionsinformation’

  5. 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:

  1. kod

  2. klartext

  3. beskrivning

Om någon annan användare förändrat en artefakt i min sektor, går det då att se någon historik-logg på vem som gjort vad?

För att kunna följa vad som hänt i en artefakt, finns artefaktens versionsbeskrivning i fliken ‘Versionsinformation’, samt tidigare versionsbeskrivningar i fliken ‘Versionshistorik’. Det kan även finnas ‘Orsak till avställning’, när den senast ändrades osv. Men dessa ändringar avser avsiktliga transparenta förändringar från ansvarig förvaltare och innehållsansvarig. Terminologitjänsten har haft förfrågningar på loggning av aktivitet kopplad till användare. Här finns GDPR-relaterade risker i samband med GUI och API:er. Lösningstankar finns, men just nu finns ingen möjlighet för en användare att se NÄR för senaste uppdatering samt VEM som gjort förändringar.