RIV Informationsspecifikation Verksamhetsdokumentation för HSA Struktur och innehåll

Transkript

1 RIV Informationsspecifikation Verksamhetsdokumentation för Kontaktperson: Henrika Littorin, Inera AB

2 2 (79) Innehållsförteckning REVISIONSHISTORIK INLEDNING BAKGRUND GRUNDLÄGGANDE STANDARDER ATTRIBUT, OBJEKT OCH OBJEKTKLASSER Attribut Objektklasser Objekt BESKRIVNING AV VERKSAMHETSOMRÅDET OMFATTNING BERÖRDA PARTER BESKRIVNING INVOLVERADE STÖDREGISTER GJORDA AVGRÄNSNINGAR OCH VAL INFORMATIONSÖVERSIKT ENHETER OCH FUNKTIONER PERSON OCH MEDARBETARUPPDRAG OBJEKTKLASSER I HSA SCHEMATISK TRÄDSTRUKTUR FÖR HSA HSA Organisationsträd HSA Tjänsteträd OBJEKTNAMN OCH IDENTIFIERARE Unika objektsnamn Unika identifierare för objekt VERKSAMHETSORIENTERAD DOMÄNINFORMATIONSMODELL (V-DIM) ATTRIBUT I HSA ORGANISATIONSTRÄD GEOGRAFISK INFORMATION Adresser Geografisk indelning KONTAKTINFORMATION Internetuppgifter Telefonnummer Tider och regler PERSONUPPGIFTER Namn Identitetsnummer Personliga egenskaper Förskrivarkod SITHS KORT- OCH CERTIFIKATSINFORMATION Certifikatsinformation Kortinformation Spärrlistinformation ORGANISATIONSUPPGIFTER VERKSAMHETSTYP OCH VÅRDFORM Sid 2/79

3 3 (79) 6.7 MEDARBETARUPPDRAG OBJEKTINFORMATION TEKNISK INFORMATION ATTRIBUT I HSA TJÄNSTETRÄD GEOGRAFISK INFORMATION Adresser Geografisk indelning INTERNETUPPGIFTER SITHS CERTIFIKATSINFORMATION ENHETSINFORMATION OBJEKTINFORMATION TEKNISK INFORMATION KLASSIFIKATIONER OCH KODVERK UNDERHÅLL AV DOKUMENTATION UNDERHÅLL AV KODER Återanvändning av koder Uppdelning av koder Förändringar av koder TERMER OCH DEFINITIONER FÖRKLARING TILL FORMAT OCH MULTIPLICITET KORT BESKRIVNING AV RIV REFERENSER OCH FÖRKORTNINGAR FRISTÅENDE BILAGOR TILLHÖRANDE DETTA DOKUMENT: HSA-SCHEMA ORGANISATIONSTRÄDET [1] HSA-SCHEMA TJÄNSTETRÄDET [2] VÄRDEMÄNGDSBILAGOR ENLIGT KAPITEL 8 Sid 3/79

4 4 (79) Revisionshistorik Version Status Uppdatering i enlighet med version 4.0 av HSA-schemat för HSA Organisationsträd och HSA Tjänsteträd Uppdatering i enlighet med version 4.1 av HSA-schemat för HSA Organisationsträd och HSA Tjänsteträd. Sid 4/79

5 5 (79) 1 Inledning HSA innehåller kvalitetssäkrad och aktuell information om personer, enheter, funktioner inom vård och omsorg. Policy och regelverk samt informationsstrukturen för HSA ger enhetliga identifieringar och benämningar för personer, enheter och funktioner inom vård- och omsorgsorganisationer som landsting, privata vårdgivare och motsvarande inom kommunala sektorn. Efter prövning kan ytterligare aktörer inom vård och omsorg ingå i HSA. HSA är en nationell tjänst som tillhandahåller all information som de styrande sammanslutningarna inom HSA kommit överens om och som är av nationellt intresse. Härigenom erhålls samlad kvalitetssäkrad individ-, funktions- och organisationsinformation från samtliga vård och omsorgsaktörer. Informationsspecifikationen har arbetats fram enligt RIV:s metodanvisningar för informationsspecifikationer och består av verksamhetsdokumentation och ITdokumentation. Detta dokument utgör verksamhetsdokumentationen. ITdokumentationen för HSA utgör en samling olika dokument som är specifika för den tekniska miljö som HSA är realiserad i. Syftet med detta dokument och tillhörande bilagor är att definiera informationsinnehållet i HSA. Fristående bilagor till detta dokument utgörs av: HSA-schema organisationsträdet [1] HSA-schema tjänsteträdet [2] Delprojekt Informationsstruktur - i arbetet har följande personer deltagit: Projektledare: Henrika Littorin, Inera AB Projektgrupp: HSA förvaltningsgrupp bestående av: Johan Zenk, Landstinget i Östergötland (Ordf) Lennart Linjamaa, Jämtlands läns landsting Anne-Lie Vestlund Nyström, Stockholms läns landsting Wladimir Bislawski, Stockholms läns landsting Rune Gunnarsson, Region Skåne Anders Dahl, Örebro läns landsting Terminolog: Annika Asp, Terminologicentrum TNC Informationsmodellerare: Ulrika Nilsson, Inera AB Kodverk/ sbilagor som redovisas i kapitel 8 i detta dokument Sid 5/79

6 6 (79) 2 Bakgrund 2.1 Grundläggande standarder HSA är baserad på de internationella standarderna LDAPv3 (RFC 4510) och X.500 (ISO 9594/ITU X.500). LDAP bygger på X.500 eller som det uttrycks i standarden The Lightweight Directory Access Protocol (LDAP) is an Internet protocol for accessing distributed directory services that act in accordance with X.500 data and service models. Arbetet med båda dessa uppsättningar standards pågår fortlöpande. HSA kommer att använda nya eller gamla delar av standarderna utifrån behov. 2.2 Attribut, objekt och objektklasser Attribut, objekt och objektklasser är grundläggande begrepp inom HSA. Dessa begrepp beskrivs nedan. Objektklass Objekt består av ingår i Attribut Attributvärde Attribut Ett attribut beskriver en egenskap hos ett objekt. Ett attribut tillhör alltid minst en objektklass och samma attribut kan återfinnas i flera objektklasser. Ett attribut har ett namn och ett värde, t ex kan attributet telefonnummer ha värdet Normalt kan ett attribut ha flera värden, s.k. flervärdesattribut, t.ex. en lista med telefonnummer. Ett attribut kan också ha subattribut. Subattribut har endast betydelse vid sökning, där en sökning på huvudattributet ger en sökning på samtliga subattribut. Exempelvis ger en sökning i huvudattributet telefonnummer samtidig en sökning i subattributet växeltelefonnummer. Attributen i HSA framgår av bilagorna HSA Organisationsträd objekt och attribut och HSA Tjänsteträd objekt och attribut. I dessa dokument framgår även vilka attribut som är subattribut. LDAP/X.500-standarden innehåller ett stort antal fördefinierade attribut. Dessa används alltid i första hand i HSA. Det finns också ett antal attribut som har definierats inom HSA. Dessa har särskilt markerats i attributförteckningen Objektklasser Objektklasser håller samman en uppsättning attribut som beskriver ett objekt av viss typ. Vilka attribut som tillhör en viss objektklass framgår i objekt och attributsbilagorna. En objektklass kan antingen vara strukturell eller utgöra en hjälpklass. Strukturella objekt, t ex person, kan existera som egna objekt i katalogen medan hjälpklasser, t ex HSAPersonExtens- Sid 6/79

7 7 (79) ion, tillför egenskaper på objekt som redan finns, men inte fungerar som egna objekt. De objektklasser som används i HSA framgår av objekt och attributsbilagorna Objekt Ett objekt är en instans av minst en objektklass. Objektet har ett antal attribut, som medges av aktuella objektklasser, med värden angivna. Ibland används termen entry istället för objekt. Sid 7/79

8 8 (79) 3 Beskrivning av verksamhetsområdet 3.1 Omfattning HSA används främst för att erhålla korrekt information om personer, enheter och funktioner. Informationen kan användas som underlag för: säkerhetshantering, t.ex. att skapa certifikat. behörighetshantering, t.ex. inom BIF. vårdsökningstjänster, t.ex. telefonkatalog, vården på webben, Berörda parter Berörda parter är: Interna tjänster, t.ex. lokala- och regionala e-postsystem, telefonisystem och system för behörighetsadministration. Nationella tjänster, bl.a. SITHS, BIF-tjänster och Externa aktörer, bl.a. Försäkringskassan och Apoteket. 3.3 Beskrivning HSA innehåller kvalitetssäkrad information om personer, enheter och funktioner inom vård och omsorg. Informationen i HSA kan vara en delmängd av informationen i respektive organisations interna katalog. HSA som teknisk företeelse består av flera olika delar, bl.a. ett gemensamt kataloghotell samt ett antal externa HSA-kataloger som knyts samman via HSA-toppnod. Bilden nedan visar hur kopplingar till HSA ser ut. Sid 8/79

9 9 (79) Figur1. Teknisk infrastruktur för HSA Policy [3] och regelverk för HSA styr hur HSA utvecklas och används. 3.4 Involverade stödregister Stödregister finns inom respektive organisation, t.ex. befolkningsregister, personalregister, telefonisystem, e-postsystem och ekonomisystem. 3.5 Gjorda avgränsningar och val Inga. Sid 9/79

10 10 (79) 4 Informationsöversikt HSA innehåller information om: enheter inom vård och omsorg personer som är anställda/uppdragstagare på sådana enheter funktioner kopplade till enheterna medarbetaruppdrag som kopplas till vårdenheter och personer Relationerna mellan dessa begrepp framgår av nedanstående modell. Figur 2. HSA-modellen När denna logiska informationsmodell ska realiseras i katalogen så kan informationsobjekten implementeras på olika sätt i de tekniska katalogobjekten. 4.1 Enheter och funktioner För enheter gäller att ett informationsobjekt ofta kan realiseras som ett katalogobjekt. Om behov finns av att visa upp en enhet som inte finns i den officiella enhetshierarkin, eller om det finns behov av att differentiera t ex kontaktinformation för en enhet, kan man använda informationsobjektet Funktion som ett komplement till enhetshierarkin. Till exempel kan enheten Vårdcentralen X kompletteras med funktionerna Sjukgymnastikgruppen och Diabetessköterskan om dessa har andra kontaktuppgifter än Vårdcentralen X. I de fall det inte finns särskild information angiven för funktionen, ärvs information från ovanstående enhet. Funktioner behöver därför presenteras tillsammans med information från överliggande objekt i HSA. Sid 10/79

11 11 (79) Ur ett HSA-perspektiv är skillnaden mellan en enhet och en funktion att enheten kan ha flera underobjekt. Funktioner utgör däremot alltid den lägsta nivån i HSA och kan inte ha underobjekt. Det finns även några små skillnader i vilka attribut som är kopplade till de båda informationsobjekten. Det finns inget regelverk i HSA för när enhet eller funktion ska användas. Hur indelningen struktureras bestäms av den organisation som äger informationen. Det finns dock ett antal reserverade funktionsnamn inom HSA som beskrivs i bilagan HSA Organisationsträd objekt och attribut. 4.2 Person och medarbetaruppdrag Personer och medarbetaruppdrag är olika objekt i HSA. I personobjektet lagras både personliga och anställningsrelaterade egenskaper. Detta innebär att samma person kan finnas på flera ställen i HSA, t.ex. om personen har olika anställningsrelaterade egenskaper på olika enheter. Om en person ska synas på flera ställen i HSA med samma uppgifter kan man använda en länk som pekar ut personobjektet i en annan del av katalogen, denna länk kallas för alias i HSA. Förändringar som görs på personen avspeglas därmed på båda ställena i HSA. Medan personobjektet representerar människor med vissa egenskaper beskriver medarbetaruppdrag relationen mellan person och en viss utpekad vårdenhet (medarbetaruppdrag är endast kopplade till enheter som är definierade som vårdenheter). En person kan ha många medarbetaruppdrag kopplade till en eller flera vårdenheter. Medarbetaruppdrag är alltid placerade direkt under den vårdenhet uppdraget tillhör, men personer kopplade till ett medarbetaruppdrag kan ligga var som helst i HSA. Varje medarbetaruppdrag har ett angivet ändamål och ett antal rättigheter som beskriver uppdragets organisationsomfång, tillåtna aktiviteter samt vilken informationstyp uppdraget berör. Värdena för dessa anges i särskilda kodverk. 4.3 Objektklasser i HSA I HSA kan begreppen enhet, funktion och person beskrivas med hjälp av olika objektklasser. Tabellen nedan visar vilka objektklasser som används inom HSA. Objektklasserna är hämtade från LDAP/X.500-standarden och kompletterade med specifika HSA-tillägg. Informationsobjektsklass Enhet Innehåller information om Innehåller information om t.ex. enhetsnamn, besöksadress, telefonnummerverksamhet som bedrivs, ägarform. Katalogobjektsklass organization den översta nivån i enhetshierarkin organizationalunit alla underliggande nivåer i enhetshierarkin HSAOrganizationExtension pkiuser Sid 11/79

12 12 (79) Informationsobjektsklass Innehåller information om Katalogobjektsklass Funktion Funktion används för enheter som inte finns i den officiella enhetshierarkin, eller då det finns behov av att differentiera t ex kontaktinformation för en enhets olika delar. Funktioner innehåller information om t.ex. funktionens namn, besöksadress, telefonnummer och verksamhet som bedrivs. organizationalrole HSARoleExtension pkiuser Person Innehåller information om t.ex. namn, person-id, telefonnummer, e- postadress, legitimerad yrkesgrupp, specialistkod. organizationalperson inetorgperson Person HSAPersonExtension pkiuser Medarbetaruppdrag Innehåller information om uppdragets medlemmar, ändamål och rättigheter. hsacommission Objekt av typerna person, medarbetaruppdrag och enhet lagras i HSA Organisationsträd och objekt av typen funktion kan lagras både i HSA Organisationsträd och i HSA Tjänsteträd, se kapitel 4.4. Sid 12/79

13 13 (79) 4.4 Schematisk trädstruktur för HSA HSA är strukturerad i delträden HSA Organisationsträd och HSA Tjänsteträd. Bilden nedan visar hur den schematiska trädstrukturen ser ut för HSA med de två delträden. Figur 3. Schematisk trädstruktur Tabellen nedan förklarar objekten i ovanstående figur. LDAP-namn root country domain locality organization organizationalunit organizationalrole organizationalperson hsacommission Beskrivning Rot i detta fall HSA-roten Land Sverige Domän avgränsar och delar tjänsteträdet Län ej tvingande geografisk uppdelning Organisation juridisk person oavsett ägarform Enhet bestående av funktioner och personer Funktion Tjänst, t.ex. en IT-tjänst, eller del av en enhet Person en individ Medarbetaruppdrag kopplade till vårdenheter. Sid 13/79

14 14 (79) HSA Organisationsträd På en första nivå i HSA Organisationsträd, under HSA-roten, root, och land, country, finns en geografisk uppdelning i län med hjälp av locality-objekt. Denna nivå är inte tvingande eftersom flera organisationer bedriver verksamhet över länsgränser. Objektet är därför streckat i bilden. Nästa nivå i trädet innehåller olika juridiska personerna, realiserade som organization-objekt, oavsett ägarform. Bilden nedan visar hur HSA Organisationsträd är strukturerat. Figur 4. Schematisk trädstruktur för HSA Organisationsträd Normalt befinner sig såväl personer, organizationalperson, som funktioner, organizational- Role, under en enhet, organizationalunit. För en liten organisation som saknar underliggande organisationsenheter kan dock personer och funktioner ligga direkt under organisation, organization. Medarbetaruppdrag, hsacommission, befinner sig alltid direkt under den enhet som den tillhör. Medarbetaruppdrag kan endast kopplas till enheter som har definierats som vårdenhet i HSA. För ytterligare information om organisationsträdet och dess innehåll, se fristående bilaga HSA-schema organisationsträdet [1]. Sid 14/79

15 15 (79) HSA Tjänsteträd Bilden nedan visar hur HSA Tjänsteträd ser ut. Figur 5. Schematisk trädstruktur för HSA Tjänsteträd, Services HSA Tjänsteträd används för att lagra IT-funktioner avskilt ifrån HSA Organisationsträd. Avsikten med detta är att strukturen av IT-funktioner ska kunna upprätthållas även vid omorganisationer. Tjänsteträdet börjar med två nivåer domain, den första avgränsar Tjänsteträdet från Organisationsträdet och den andra används för att kunna dela Tjänsteträdet mellan flera katalogservrar. Under domain finns de olika juridiska personerna realiserade som organization-objekt. För att gruppera funktionerna används nivån enhet, organizationalunit, som kan ha flera underliggande nivåer. Den nedersta nivån i HSA Tjänsteträd består av funktioner, organizationalroleobjekt. För ytterligare information om HSA Tjänsteträd och dess innehåll, se friståendebilaga HSAschema tjänsteträdet. 4.5 Objektnamn och identifierare Unika objektsnamn Varje objekt i HSA måste ha ett unikt distinguishedname. Detta skapas automatiskt och består av namnet på objektet inklusive namnet på alla objekt upp till land, country-nivå. För att distinguishedname ska bli unikt måste relativedistinguishedname, som är objektsnamn under det närmast överordnade objektet, vara unikt. Det innebär till exempel att två personer med samma namn som arbetar på samma enhet måste skiljas åt med initial. Sid 15/79

16 16 (79) Exempel på distinguishedname: cn=jan Exempelvis,ou=Division 1,ou=Lasarettet i Ystad,o=Region Skåne,l=Skåne län c=se och motsvarande relativedistinguishedname: cn=jan Exempelvis Unika identifierare för objekt Objekt av typen organization, organizationalunit, organizationalperson, hsacommission och organizationalrole ska alla ha en unik identifierare, ett HSA-id. Om en person förekommer på flera ställen hos en och samma katalogägare ska personen ha samma HSA-id för alla dessa förekomster. I de fall en person förekommer hos flera katalogägare kommer dock personen att ha olika HSA-id. HSA-id består av två delar. En del som identifierar utfärdande organisation och en del som identifierar det unika objektet. Strukturen för HSA-id ser ut på följande sätt: SE<identifierare för utfärdande organisation>-<identifierare för objektet> Identifieraren för utfärdande organisation består av organisationsnummer på tio siffror. Av historiska skäl är det tillåtet att ha med sekelsiffran 16, men det bör inte förekomma vid nyinförande. Sid 16/79

17 17 (79) 5 Verksamhetsorienterad domäninformationsmodell (V-DIM) Nedan presenteras V-DIM för HSA Organisationsträd. Observera att HSA inte är en relationsdatabas. Nedanstående bild ska endast ses som en logisk modell. För ytterligare information om attribut och associationer, se fristående bilaga HSA-schema organisationsträdet [1]. Sid 17/79

18 18 (79) 6 Attribut i HSA Organisationsträd 6.1 Geografisk information Adresser besöksadress (street, streetaddress) Besöksadress i form av gatuadress eller motsvarande samt ort om denna inte ingår i enhetens namn. Adressen måste vara tydlig nog för att en taxi t.ex. ska hitta. Exempel på Besöksadress: "Lövdalsvägen 4, 2 tr, Björkvik", "Universitetssjukhuset MAS, Ingång 45, Malmö", "Södersjukhuset, Hjalmar Cederströms gata 14, Stockholm". Används också när man behöver lägga till information som gör det lättare för en besökare att hitta rätt så som: "Röda dörren till höger om huvudentrén", "Använd ringklocka på dörren för att bli insläppt", "Dörren till vänster om receptionen för infektionssjuka barn". TXT Beslutsregel/Teknisk beskrivning Besöksadress kan även kompletteras med information i attributet vägbeskrivning. Max O OU P OR CM L 128 X X X X X Sid 18/79

19 19 (79) fakturaadress Fullständig adress dit faktura TXT (hsainvoiceaddress) ska skickas. godsadress (hsaconsigneeaddress) leveransadress (hsadeliveryaddress) postadress (postaladdress) Fullständig adress dit gods ska skickas, t.ex. till lastbrygga, varumottagning och dylikt. Fullständig adress för varuleverans. Ska vara tillräckligt detaljerad för att nå rätt plats direkt, t ex ett enskilt förråd på en avdelning. Information om fullständig postadress (adressatuppgift och utdelningsadress). För personer behöver dock inte adressat anges. För personer behöver dock inte adressat anges. Exempel: Vårdcentralen Centrum Mellangatan Härnösand TXT TXT TXT Beslutsregel/Teknisk beskrivning Varje adressfält har sex möjliga rader. Informationen ska sorteras så att mer förfinad information ligger högre upp. Varje adressfält har sex möjliga rader. Informationen ska sorteras så att mer förfinad information ligger högre upp. Varje adressfält har sex möjliga rader. Informationen ska sorteras så att mer förfinad information ligger högre upp. Varje adressfält har sex möjliga rader. Informationen ska sorteras så att mer förfinad information ligger högre upp. Max O OU P OR CM L 6*30 X X X X 6*30 X X X X 6*30 X X X X 6*30 Obl X X X Sid 19/79

20 20 (79) postnummer Postnummer för platsen där TXT verksamheten bedrivs. Kan (utan (postalcode) mellanslag) vara annat postnummer än det som anges i andra adressuppgifter. Associationer En adressuppgift är kopplad till noll till flera Personer En adressuppgift är kopplad till noll till flera Enheter En adressuppgift är kopplad till noll till flera Funktioner Beslutsregel Beslutsregel/Teknisk beskrivning Används normalt enbart för sökändamål. Attributet lagras utan "S" om det är ett svenskt postnummer. Max O OU P OR CM L 40 X X X X Geografisk indelning geografiska koordinater (geographicalcoordinates) Geografiska koordinater (enligt RT90) som anger enhetens fysiska placering. Exempel på en koordinat i Stockholm (Djurgårdsbron) är: X: ,Y: VÄ (utan mellanslag) Beslutsregel/Teknisk kommentar Koordinaterna anges med 7 siffror och värdena är i meter. Koordinatsystemet som används är RT gon Väst. Max O OU P OR CM L 64 X X X Sid 20/79

21 21 (79) geografiska koordinater SWEREF 99 TM (geographicalcoordinatessweref99tm) geografisk plats (l, localityname) Geografiska koordinater enligt SWEREF 99 TM som anger enhetens fysiska placering. Exempel på en koordinat i Linköping (E4-bron över Stångån) är: N: ,E: Namn på plats där enheten är fysiskt placerad. Geografisk plats kan vara detsamma som stad, stadsdel, kommun eller kommundel. Det kan vara annan geografisk plats än det som anges i adressuppgifter. VÄ (utan mellanslag) TXT (KTOV för objektklassen locality) Beslutsregel/Teknisk kommentar Värden är angivna I meter. Om attributet tillhör objektklass locality är detta det officiella namnet på länet enligt värdemängdsbilagan Länskoder. Max O OU P OR CM L 64 X X X 128 X X X X O bl kommundelskod (municipalitysectioncode) Kod för kommundel. TXT Om ifylld måste attributen "kommundelsnamn", "kommunkod" och "kommunnamn" vara ifyllda. 40 X X X kommundelsnamn (municipalitysectionname) Namn på kommundel. TXT Om ifylld måste attributen "kommundelskod", "kommunkod" och "kommunnamn" vara ifyllda. 64 X X X Sid 21/79

22 22 (79) kommunkod Kod för kommun enligt SCB KTOV Kommunkod (municipalitycode) där enheten fysiskt är placerad. kommunnamn (municipalityname) Namn på kommun enligt SCB där enheten fysiskt är placerad. KTOV Kommunkod Beslutsregel/Teknisk kommentar Om ifylld måste attributet "kommunnamn" vara ifyllt, samt attributen "länsnamn" och "länskod". Om ifylld måste attributet "kommunkod" vara ifyllt, samt attributen "länsnamn" och "länskod". Max O OU P OR CM L 2 X X X 64 X X X land (c, Landets beteckning enligt ISO 3166 om annat än Sverige. KTOV Anges med 2 bokstäver enligt ISO X X X countryname) länskod (countycode) Kod för län enligt SCB där enheten fysiskt är placerad. KTOV Länskod Om ifylld måste attributet "länsnamn" vara ifyllt. 2 X X X länsnamn (countyname) Namn på län enligt SCB där enheten är placerad. KTOV Länskod Om ifylld måste attributet "länskod" vara ifyllt. 64 X X X Sid 22/79

23 23 (79) områdesansvar Geografisk definierat område TXT (hsahealthcarearea) för någon form av administrativ indelning. vägbeskrivning (route) Angivelse av olika färdsätt och färdvägar för att ta sig till enheten utifrån olika utgångspunkter. Exempel på hur detta fält kan användas: Vägbeskrivning Centrallasarettet: Buss: Lämpliga busslinjer för att ta sig till X är 1, 2 5 och 7. Hållplatserna Z och Y är de närmast huvudentrén Bil: Med bil tar du dig lättast till X genom att ta av från E4, avfart nummer 123 skyltat mot Z. Följ därefter skyltning X Cykel: Cykelväg till X finns från centrum och är markerad Z. Associationer En Geografisk indelning indelar noll till flera Funktioner En Geografisk indelning indelar noll till flera Enheter TXT Beslutsregel Beslutsregel/Teknisk kommentar Attributet är inte avsett för sökningar utan för att visa upp information om områdesansvar. Max O OU P OR CM L 1024 X X X 1024 X X X Sid 23/79

24 24 (79) 6.2 Kontaktinformation Internetuppgifter 1177-kontaktkortslänk (hsavpwwebpage) e-postadress (mail, rfc822mailbox) innehållsansvarig (hsadirectorycontact) Länk till enhetens kontaktkort på 1177.se. Uppgift om e-postadress. Kontaktfunktion för innehållsfrågor och kommentarer kring organisationens kataloguppgifter. URL KOM (e-post) KOM (e-post) Beslutsregel/Teknisk beskrivning Detta attribut registreras inte manuellt utan genereras med automatik. Länken är uppbyggd på följande vis: aid=<hsa-id> Max O OU P OR CM L X X X 255 Obl X X X 255 X X webbadress (labeleduri) Fullständig webbadress inklusive eller " URL X X X X Sid 24/79

25 25 (79) Associationer En Internetuppgift är kontaktuppgift till noll till flera Enheter En Internetuppgift är kontaktuppgift till noll till flera Funktioner En Internetuppgift är kontaktuppgift till noll till flera Personer Beslutsregel Telefonnummer direkttelefon (telephonenumber) Publikt direkttelefonnummer. KOM (Tel) Beslutsregel/Teknisk beskrivning Nationella kortnummer, t.ex och 112, inleds ej med prefixet +46. Max O OU P OR CM L 32 Obl X X X fax (facsimiletelephonenumber) Faxnummer. KOM (Tel) 32 X X X X minicall (pager, pagertelephonenumber) Minicallnummer. I detta attribut ska inte interna sökare anges. KOM (Tel) 32 X X X X mobiltelefon (mobile, (mobiletelephonenumber) Mobiltelefonnummer. KOM (Tel) 32 X X X X Sid 25/79

26 26 (79) sms-telefon KOM (smstelephonenumber) (Tel) Telefonnummer som används för SMSmeddelanden. Beslutsregel/Teknisk beskrivning Max O OU P OR CM L 32 X X X X texttelefon (hsatexttelephonenumber) Telefon för personer med hörsel- och/eller talhandikapp där kommunikationen sker via terminaler med tangentbord och bildskärm. KOM (Tel) 32 X X X X tjänstetelefon (hsatelephonenumber) Telefonnummer för tjänsteärenden. KOM (Tel) 32 X X X X växeltelefon (hsaswitchboardnumber) Telefonnummer till växel eller liknande som kan leda vidare i organisationen. KOM (Tel) Nationella kortnummer, t.ex och 112, inleds ej med prefixet X X X X Associationer Ett Telefonnummer är kontaktuppgift till noll eller flera Enheter Beslutsregel Ett Telefonnummer är kontaktuppgift till noll eller flera Funktioner Ett Telefonnummer är kontaktuppgift till noll eller flera Personer Sid 26/79

27 27 (79) Tider och regler besöksregler för anhöriga (hsavisitingrules) Informationstext om regler för besökare till patient. Exempel: Medhav av blommor är inte tillåtet. TXT Beslutsregel/Teknisk beskrivning Max O OU P OR CM L 128 X X X besökstider för anhöriga (visitinghours, SE Öppettider ) Den tid då anhöriga/närstående kan komma på besök, t.ex. på en vårdavdelning. Tid (IVL) 64 X X X remisskrav (hsavisitingrulereferral) Beskrivning av remisskrav. Attributet ska endast fyllas i om remisskrav finns, i annat fall ska fältet vara tomt. Exempel: "Remiss från vårdcentral eller motsvarande krävs för ny patient". TXT Attributet är inte avsett för sökning utan endast för att visa information. 64 X X X telefontid (telephonehours) Den tid då någon svarar i telefonen på det telefonnummer som angivits i attributet "direkttelefon". Tid (IVL) 50 X X X X tid för dropin-besök utan tidsbokning (dropinhours) Den tid då patienter tas emot utan tidsbokning. Eventuella regler/rutiner kring detta (endast patienter över 65 år, ring alltid innan besök etc.) anges i fälten besöksregler/ patientinformation/beskrivning. Tid (IVL) 40 X X X Sid 27/79

28 28 (79) åldersregler för vårdkontakt TXT (XX-XX) (hsavisitingruleage) öppettider (surgeryhours) Åldersregler för patienter i de fall enheten riktar sig till en specifik åldersgrupp. Anges alltid som ett åldersintervall, med ett min- och ett maxvärde, t.ex: "02-08". Den tid då personal finns på plats, då receptionen är bemannad eller då dörren är öppen. Gäller alla typer av enheter. Tid (IVL) Beslutsregel/Teknisk beskrivning Alltid år. 2 tkn från och med, streck, 2tkn till och med. 00 för nyfödd, 99 för ingen övre gräns. Exempel: Det går även att lägga till en kommentar på max 16 tecken efter intervallet. Detta skrivs då in enligt följande syntax: "<minvärde>- <maxvärde>#<kommentar >. Max O OU P OR CM L 22 X X X 64 X X X Associationer En Tider och Regler gäller för noll eller flera Enheter En Tider och Regler gäller för noll eller flera Funktioner En Tider och Regler gäller för noll eller flera Personer Beslutsregel Sid 28/79

29 29 (79) 6.3 Personuppgifter Namn efternamn (sn, surname) fullständigt namn (fullname) Personens efternamn enligt Skatteverkets definition i SKV 717 som bygger på namnlagen. Personens alla förnamn, mellannamn och efternamn enligt Skatteverkets definition i SKV 717 som bygger på namnlagen. TXT TXT (1..1) (1..1) Beslutsregel/Teknisk beskrivning Efternamn hämtas från Skatteverket för alla med svenskt person- eller samordningsnummer. En person kan bara ha ett efternamn registrerat i HSA. Hämtas från Skatteverket för alla med svenskt personeller samordningsnummer. Format: mellannamn efternamn, förnamn. Max O OU P OR CM L 64 Obl 180 Obl initial (initials) De bokstäver eller siffror som används för att undvika dubbletter av namn på personer med samma tilltalsoch efternamn. (Kan t.ex. användas i e-postadressen). TXT Ska i första hand härledas ur förnamn som inte är tilltalsnamn. Initialernas ordning behöver inte överensstämma med ordningen som namnen har i attributet fullständigt namn. Kan vara mer än ett tecken. 40 X Sid 29/79

30 30 (79) mellannamn Personens mellannamn TXT (middlename) enligt Skatteverkets definition i SKV 717 som bygger på namnlagen. Beslutsregel/Teknisk beskrivning Hämtas från Skatteverket för alla med svenskt personeller samordningsnummer. Endast ett mellannamn får anges för personen i HSA. Max O OU P OR CM L 40 Obl om fin ns smeknamn (nickname) Används då tilltalsnamn inte är det namn som personen vill använda/bli tilltalad med. TXT 64 X tilltalsnamn (givenname, gn) Personens tilltalsnamn enligt Skatteverkets tilltalsmarkering. Finns inte tilltalsmarkering kan ett av förnamnen väljas. För information om övriga förnamn se attributet "fullständigt namn". TXT (1..1) Hämtas från Skatteverket för alla med svenskt personeller samordningsnummer. 64 Obl Sid 30/79

31 31 (79) Identitetsnummer födelsedatum (hsapassportbirthdate) giltighetstid för pass (hsapassportvalidthru) Personens födelsedatum. Detta attribut ifylles endast om personen saknar personnummer och samordningsnummer. Giltighetstid för pass som anges i attributet "passnummer". II (YYYYMM DD) TP () Beslutsregel/Teknisk beskrivning Detta attribut måste användas om personen inte har personnummer/samordningsnum mer. Om detta attribut fylls i ska personen vara identifi-erad med pass eller EU-id-kort och attributen "passnummer" och "giltighetstid för pass" måste även fyllas i. Detta attribut måste användas om personen inte har personnummer/samordningsnum mer. Om detta attribut används ska även attributen passnummer och födelsedatum fyllas i. Ange (midnatt) som tidpunkt. Identitetshandlingen ska visas vid ett fysiskt möte med katalogadministratören. Max O OU P OR CM L 40 X X Sid 31/79

32 32 (79) passnummer Passnummer som används för II (hsapassportnumber) att legitimera en person som saknar personnummer eller samordningsnummer. Rekommendation att detta inleds med den tvåställiga bokstavskoden för landet enligt ISO person-id (PersonalIdentityNumber) Anger personnummer eller samordningsnummer enligt SKV 704 respektive SKV 707. II (YYYYMM DDXXXX) Beslutsregel/Teknisk beskrivning Detta attribut måste användas om personen inte har personnummer/samordningsnummer. Om detta attribut används ska även attributen giltighetstid för pass och födelsedatum fyllas i. Identitetshandlingen ska visas vid ett fysiskt möte med katalog-administratören. Anges med sekelangivelse och utan streck. Om personen saknar personnummer/samordningsnummer ska attributen "passnummer", "giltighetstid för pass" och "födelsedatum" fyllas i. I detta fall ska attributet "personid" lämnas tomt. Max O OU P OR CM L 40 X 12 Obl Sid 32/79

33 33 (79) Personliga egenskaper befattning (patitlename) befattningskod (patitlecode) chefskod (hsamanagercode) legitimerad yrkesgrupp (hsatitle) skyddad person (hsaprotectedperson) Uppgift om vad personen är anställd som enligt AIDetikett. Klartext för personens befattning. Attributet kan behöva fyllas i även för privata aktörer i de fall då behörighetsgrundande information krävs för personen, t.ex. i fallet då en läkarstuderande får ett vikariat som läkare. Kod för personens befattning enligt AID-etikett. Personens chefskod enligt AID-ansvar. Kod anges. Klartext för legitimerad yrkesgrupp, enligt Socialstyrelsens förteckning, som personen tillhör. Flagga som anger om personen har skyddade personuppgifter. KTOV KTOV KTOV KTOV VÄ Befattning Befattning Chefskod Legitimerade yrkesgrupper Beslutsregel/Teknisk beskrivning Om ifylld måste attributet "befattningskod" vara ifylld. Om ifylld måste attributet "befattning" vara ifylld. En andra position kan förekomma i denna kod, men den har ingen betydelse utanför den egna organisationen. Om personen har skyddade personuppgifter skrivs "Ja" annars är fältet tomt. Max O OU P OR CM L 64 X 64 X 2 X 64 X 2 X Sid 33/79

34 34 (79) specialitet (specialityname) specialitetskod (specialitycode) språkkod (languageknowledgecode) titel (title) saknar svensk folkbokföringsadress (hsaemigratedperson) Klartext för specialistutbildning utöver grundutbildning enligt HOSP. Kod för specialistutbildning utöver grundutbildning enligt HOSP. Kod som motsvarar språk som personen har kunskap nog om och möjlighet att ta emot patienter på. KTOV KTOV KTOV Personens yrkestitel i fritext. TXT Personen har svenskt personnummer, VÄ men ingen svensk folkbokföringsadress. Det kan t.ex. bero på att personen fått ett så kallat tilldelat personnummer eller att personen har utvandrat. Associationer En Person är anställd av/utför uppdrag åt en eller flera Enheter HOSP HOSP Beslutsregel/Teknisk beskrivning Vilket angivet värde som helst tolkas som ja. Om ifylld måste attributet "specialitetskod" vara ifyllt. Om ifylld måste attributet "specialitet" vara ifyllt. Max O OU P OR CM L 64 X 5 X Språkkod 3 X Beslutsregel Förkortningar bör undvikas. Detta kontrolleras i samband med slagning mot folkbokföringen. Attributet kommer att användas av SITHS för att undvika att skapa SITHS-kort med pinkoder som skickas till en icke-existerande folkbokföringsadress. 64 X 2 X Sid 34/79

35 35 (79) Förskrivarkod förskrivarkod (personalprescriptioncode) Kod som identifierar en förskrivare. II Beslutsregel/Teknisk beskrivning Max O OU P OR CM L 40 X förskrivningsrätt för barnmorskor/ sjuksköterskor (hsasosnurseprescriptionright) Anger om personen har förskrivningsrätt som barnmorska eller sjuksköterska. VÄ Anges enligt följande syntax om personen har förskrivningsrätt som barnmorska/sjuksköterska: "<Kod för legitimerad yrkesgrupp>;<j>". Exempel: "SJ;J" för sjuksköterska med förskrivningsrätt. 4 X gruppförskrivarkod (hsagroupprescriptioncode) Kod som identifierar en grupp av förskrivare. II 40 X Sid 35/79

36 36 (79) 6.4 SITHS kort- och certifikatsinformation Certifikatsinformation certifikatsnummer SITHS-certifikatets serienummer. II (serialnumber) Beslutsregel/Teknisk beskrivning Informationen registreras av SITHS vid publicering av HCC. Max O OU P OR CM L 64 X giltigt fr.o.m. (validnotbefore) Det datum som SITHS-certifikatet är giltigt från och med. (TP) Informationen registreras av SITHS vid publicering av HCC. X giltigt t.o.m. (validnotafter) HCC (usercertificate) Det datum som SITHS-certifikatet är giltigt till och med. Giltiga SITHS-certifikat. (TP) TXT (certifikat) Informationen registreras av SITHS vid publicering av HCC. Endast HCC Person lagras i organisationsträdet. X X rotcertifikat (cacertificate) Rotcertifikat för SITHS CA. TXT (Certifikat) I HSA finns detta endast på ett ställe per version av SITHS CA. Associationer En Certifikat innehas av noll eller en Enhet Beslutsregel En Certifikat innehas av noll eller en Person En Certifikat innehas av noll eller en Funktion Sid 36/79

37 37 (79) Kortinformation kortnummer (cardnumber) Kortnummer för personens SITHS-kort. II Beslutsregel/Teknisk beskrivning Informationen levereras av SITHS vid publicering av HCC. Max O OU P OR CM L 40 X mifareserienummer (hsamifareserialnumber) Mifareserienummer för SITHS-kortets mifareslinga. II (kortnummer@mif areserienummer) <Kortnummer>@<mifareserienu mmer> ( 19 tecken@10 tecken). Informationen leverer-as av SITHS vid publicering av HCC. 40 X SITHS pinkod för inpassering (hsasithspin) Pinkod för inpassering med SITHS-kort. II (kortnummer@hsa sithspin) Octet- String Attributet är reserverat för SITHS och lagras krypterat i HSA. Kryptering och dekryptering sker utanför HSA. 50 kb X Utökad behörighet (annan än den som gäller för att se personnummer) fordras för att få läsa detta attribut. Associationer En Kort innehas av en Person Beslutsregel Sid 37/79

38 38 (79) Spärrlistinformation certifikatspärrlista (certificaterevocationlist) Spärrlista över icke giltiga certifikat. TXT (CRL) Beslutsregel/Teknisk beskrivning Attributet är reserverat för SITHS. Max O OU P OR CM L X delta-spärrlista (deltarevocationlist) För uppdelning av stor spärrlista i flera mindre listor. TXT (CRL) Attributet är reserverat för SITHS men används inte för närvarande. X utfärdarspärrlista (authorityrevocationlist) Spärrlista över icke giltiga CA (Certification Authority). TXT (CRL) Attributet är reserverat för SITHS. 6.5 Organisationsuppgifter alternativ namnvisning Alternativt sätt att presentera TXT (displayoption) enheters namn som innebär att man har möjlighet att aktivt välja ut vilka delar av en enhets fullständiga DN (i HSAhierarkin) som ska visas. Man kan t.ex. i ett visst visningsläge vilja visa endast nivån "Karolinska sjukhuset" och "onkologiska Beslutsregel/Teknisk beskrivning Delar av objektets DN ifrån organisationsnivån (=1) med siffror som symboliserar nivån och med "#"- tecken mellan olika OUnivåer. Exempel: Om DN "c=se/l= Stockholms län/o= Stockholms läns landsting/ou=karolinska universitetssjukhuset/ou=onkologisk division/ ou=onkologiska Max O OU P OR CM L 256 X X X Sid 38/79

39 39 (79) kliniken" men välja bort visning av övriga delar av enhetens DN (såsom t.ex. "onkologiska divisionen"). alternativt namn (oushort) Namn på en enhet som används vid sidan av det officiella enhetsnamnet. T.ex. en förkortning av det officiella namnet, såsom "SöS" för Södersjukhuset eller ett gammalt men invant namn på en enhet som numer officiellt heter något annat, t.ex. "Hornstulls vc" som i dag heter "Curera Sjukvård AB". TXT Beslutsregel/Teknisk beskrivning kliniken" betyder alternativ namn-visning "2#4" att detta ska uttydas som "Karolinska universitetssjukhuset, Onkologiska kliniken". Siffrorna ska alltid anges från lägsta siffra till högsta siffra, alltså t.ex. 1#3#4 eller 3#5. Max O OU P OR CM L 64 X X arbetsplatskod (unitprescriptioncode) Enhetens sifferkod hos Apoteket för att följa upp kostnader på läkemedel. Arbetsplatskod utfärdas av respektive landsting. II De två första tecknen i koden är länskoden. 40 X X X Sid 39/79

40 40 (79) enhetsnamn Enhetens officiella namn. TXT (ou, Exempel: Ortopediska mottagningen". I undantagsfall (1..1) organizationalunitname) kan annat veder- taget enhetsnamn anges. enhetstyp (hsabusinesstype) godkänd HPT för organisationen (hsahpt) information till patient (hsavpwinformation4) Attributet används för att visa om en organisation, enhet eller funktion kan klassas som "sjukhus" eller "vårdcentral". Kod anges. Observera att endast sjukhus och vårdcentraler kodas, inte underliggande enheter och funktioner, t.ex. mottagningar och avdelningar. Dokumentnamn för organisationens godkända HSA Policytillämpning (HPT). Attributet fylls i av HSA Förvaltning. Informationstext till patienter, t.ex. Innan patientbesök ska enheten kontaktas via telefon eller Infektionskänsliga patien- KTOV TXT TXT Enhetstyp Beslutsregel/Teknisk beskrivning Rekommendationen är att skriva in hela enhetsnamnet istället för en förkortning. Enbart ett enhetsnamn får anges i HSA. Enhetsnamn behöver anges så att allmänheten kan hitta enheten. Vilka enheter och funktioner som får kodas som sjukhus respektive vårdcentral regleras på central nivå inom respektive landsting/region. Attributet är framför allt användbart i samband med vårdsökning. Skrivs enligt följande syntax: <Typ av HPT>;<Organisationens namn>;<organisationens versionsnummer>;<hptmallversion>. Max O OU P OR CM L 64 Obl X 64 X X X 64 Obl 1024 X X X Sid 40/79

41 41 (79) ter hänvisas till enhet X. Beslutsregel/Teknisk beskrivning Max O OU P OR CM L logotyp (hsajpeglogotype) Logotyp för organisationen eller enheten. DP Logotypen får max vara 50kB. 50kB X X X mer om (hsavpwinformation1) Kompletterande information om enheten som t.ex. kommer att visas på enhetens kontaktkort på 1177.se. Observera att denna information i vårdsökssammanhang ugör ett komplement till den beskrivningen av verksamheten som anges i attributet beskrivning. TXT 1024 X X X organisationsnamn (o, organizationname) Organisationens officiella namn. Exempel: Region Skåne, Gotlands kommun, Praktikertjänst AB. I undantagsfall kan annat vedertaget organisationsnamn anges. TXT (1..1) 64 Obl organisationsnummer (orgno) enligt SCB/Bolagsverket. Exempel: Enhet som pekas ut som vårdgivare måste ha detta attribut ifyllt. II (XXXXXX- XXXX) Sekelsiffran 16 ska inte vara med. 12 Obl X X X Sid 41/79

42 42 (79) prisinformation Information om priser, TXT (hsavpwinformation3) t.ex. kostnader för besök hos distriktssköterska. Beslutsregel/Teknisk beskrivning Max O OU P OR CM L 1024 X X X relaterad enhet (hsavpwneighbouringobject) tillfällig information (hsavpwinformation2) HSA-id för relaterad enhet som bl.a. ska visas upp på enhetens kontaktkort på Vården på Webben. Tillfällig information om enheten som t.ex. kommer att visas på enhetens kontaktkort på vården på Webben. Exempel på sådan information kan vara tider för influensavaccination, datum då blodbussen kommer, ändrade öppettider. TXT (;ÅÅÅÅM MDD;ÅÅ ÅÅMMD D;text) Informationen kan inledas med start- och slutdatum som gäller för visning av denna information, då inleds och avgränsas datumfälten med semikolon (;). Om attributvärdet inleds utan semikolon ska texten publiceras direkt på 1177.se tillsvidare. 64 X X X 1024 X X X verksamhetschef (hsahealthcareunit- Manager) HSA-id för den person som är verksamhetschef för den aktuella vårdenheten. Här avses vårdenhet enligt definition i dokumentet Slutrapport PDLiP, rev Vilka enheter som definieras som vårdenheter regleras på central nivå inom respektive vårdgivare. II (HSAid) 31 X X Sid 42/79

43 43 (79) vårdenhetens ingående II enheter Beslutsregel/Teknisk beskrivning (hsahealthcareunitmember) Attributet sätts på vårdenhet och pekar ut HSAid för enheter och funktioner som ingår i denna vårdenhet. Varje enhet/funktion får bara tillhöra en vårdenhet. Här avses vårdenhet enligt definition i dokumentet Slutrapport PDLiP, rev Vilka enheter som definieras som vårdenheter regleras på central nivå inom respektive vårdgivare. (HSAid) Max O OU P OR CM L 31 X X vårdgivartillhörighet (hsaresponsiblehealthcareprovider) Attributet sätts på vårdenhet och pekar ut HSAid för den vårdgivare som vårdenheten tillhör. Här avses vårdgivare enligt definition i Socialstyrelsens termbank samt vårdenhet enligt definition i dokumentet Slutrapport PDLiP, rev Vilka enheter som definieras som vårdenheter regleras på central nivå inom respektive vårdgivare. Vårdgivartillhörighet måste fyllas i för alla vår- II (HSAid) 31 X X Sid 43/79

44 44 (79) denheter. Beslutsregel/Teknisk beskrivning Max O OU P OR CM L ägarform (management) Organisationens ägarform i klartext. KTOV Associationer En Enhet har som anställd/uppdragstagare noll till flera Personer En Enhet består av noll eller flera Enheter En Enhet hör till noll eller en Geografisk indelning En Enhet består av noll eller flera Funktioner En Enhet har noll eller flera Verksamhetstyper och noll eller flera vårdformer En Enhet innehar noll eller flera Certifikat En Enhet kontaktas via noll eller flera Adressuppgifter En Enhet kontaktas via noll eller flera Telefonnummer En Enhet kontaktas via noll eller flera Internetuppgifter Ägarform 64 X X X Beslutsregel Sid 44/79

45 45 (79) 6.6 Verksamhetstyp och vårdform verksamhet Typ av verksamhet KTOV Verksamhetskod (businessclassificationname) som bedrivs. Klartext till attributet verksamhetskod. Exempel: Tandvård. verksamhetskod (businessclassificationcode) Kod för den typ av verksamhet som bedrivs. KTOV Verksamhetskod Beslutsregel/Teknisk beskrivning Bör sättas på lägsta möjliga nivå i trädet för den typ av verksamhet som enheten/funktionen bedriver (detta för att undvika dubbletter som kan resultera i felaktiga sökresultat). Välj verksamhetskod/er utifrån den huvudverksamhet som bedrivs och verksamhetskod/er som speglar smal eller specifik verksamhet som är viktig att hitta ur ett sökperspektiv. Om ifylld ska även attributet verksamhetskod fyllas i. Observera att inte registrera verksamhetskoden på den överordnade enheten utan på de underordnade enheterna och funktionerna. Bör sättas på lägsta möjliga nivå i trädet för den typ av verksamhet som enheten/funktionen bedriver (detta för att undvika dubbletter som kan resultera i felaktiga sökresultat). Välj verksamhetskod/er utifrån Max O OU P OR CM L 64 X X X 40 X X X Sid 45/79

46 46 (79) vårdform (caretype) Kod för den vårdform (öppen vård, sluten vård och hemsjukvård) som bedrivs, enligt definition i Socialstyrelsens termbank. Attributet är obligatoriskt för alla enheter och funktioner som bedriver vård och omsorg. KTOV Associationer En Verksamhetstyp och vårdform innehas av noll eller flera Enheter En Verksamhetstyp och vårdform innehas av noll eller flera Funktioner Vårdform Beslutsregel Beslutsregel/Teknisk beskrivning den huvudverksamhet som bedrivs och verksamhetskod/er som speglar smal eller specifik verksamhet som är viktig att hitta ur ett sökperspektiv. Om ifylld ska även attributet verksamhet fyllas i. Observera att inte registrera verksamhetskoden på den överordnade enheten utan på de underordnade enheterna och funktionerna. Bör sättas på lägsta möjliga nivå i trädet för att undvika dubblering, som resulterar i felaktiga sökresultat. Max O OU P OR CM L 64 X X X Sid 46/79

47 47 (79) 6.7 Medarbetaruppdrag medarbetaruppdragets medlemmar II (hsacommissionmember) Anger vilka personer som kan använda medarbetaruppdraget och under vilken tid. (HSAid;(s tartdatum);(slu tdatum)) Beslutsregel/Teknisk beskrivning Tidsangivelse för start- och slutdatum är frivillig. Om den anges ska den anges i GMT (Greenwich Mean Time). Exempel fullständigt: SE HD; Z; Z Exempel enbart startdatum: SE HD; Z; Exempel enbart slutdatum: SE HD;; Z Exempel utan datum: SE HD;; Max O OU P OR CM L 96 X medarbetaruppdragets rättigheter (hsacommissionright) Anger medarbetaruppdragets rättigheter i form av aktivitet, informationstyp och organisationsomfång. Kod anges. KTOV Medarbetaruppdrag rättigheter Anges i formatet <aktivitet>;<informationstyp>;<org anisationsomfång>. 255 X Sid 47/79

48 48 (79) medarbetaruppdragets ändamål KTOV (hsacommissionpurpose) Anger ändamål då användaren utför sitt uppdrag. Attributet är framför allt kopplat till PDL:s krav på att ange ändamål vid åtkomst till vårddokumentation. Klartext anges. Associationer Ett Medarbetaruppdrag kan innehas av noll eller flera Personer Medarbetaruppdrag ändamål Beslutsregel Beslutsregel/Teknisk beskrivning Max O OU P OR CM L 64 X 6.8 Objektinformation alt-text En beskrivande text för en TXT (hsaalttext) bild där texten förmedlar det som bilden avser att säga. Syftet är bland annat att människor med nedsatt syn kan få texten uppläst och ändå tillgodogöra sig kommunikationsvärdet i bilden. Beslutsregel/Teknisk beskrivning Max O OU P OR CM L 128 X X X X Sid 48/79

49 49 (79) beskrivning Kort beskrivning/förklaring TXT (description) av speciellt intresse. Exempel: Tillhör Region Skåne och Södra Sjukvårdsregionen. Observera att denna beskrivning kommer att användas för enheter och funktioner som ska presenteras i vårdsökssammanhang. För 1177.se kommer beskrivningen t.ex. att användas på kontaktkorten. Beslutsregel/Teknisk beskrivning Ska endast innehålla information som får visas för objektet. Max O OU P OR CM L 1024 X X X X X X bild (jpegphoto) Fotografi på t.ex. byggnad och/eller person. Om bilden föreställer en person krävs att personen lämnat sitt samtycke till att bilden finns i HSA. DP Bilden får max vara 50kB. 50kB X X X X X HSA-administratörens kommentar (hsaadmincomment) Administrativ kommentar t.ex. information om extern konsults löptid för avtal. TXT Attributet är endast synligt för HSA-administratörer inom det egna behörighetsområdet X X X X X Sid 49/79

50 50 (79) HSA-id Obligatorisk, unik identifierare II (hsaidentity) för personer, enhet- (1..1) (HSAid) er, funktioner, uppdrag och organisationer i HSA. objektnamn (cn, commonname) pekare (seealso) Namn på personen, uppdraget eller funktionen. Exempel: "Lars R Mjödberg Larsson". Hänvisning till annat objekt i katalogen. TXT II (DN) (1..1) Beslutsregel/Teknisk beskrivning Se beskrivning av HSA-id i dokumentet "RIV Informationsspecifikation HSA Struktur och innehåll". Rekommendation är att HSA-id inte överskrider 48 tecken om man avser använda SITHS-kort. När det gäller personers namn bör de skapas med attributen Tilltalsnamn (Initial) (Mellannamn) Efternamn. Namn på uppdrag ska alltid vara utformat på ett tillräckligt tydligt sätt för att en person ska kunna välja bland sina uppdrag. Max O OU P OR CM L 31 Obl Obl Obl Obl Obl 64 Obl Obl Obl DN till aktuellt objekt. X X X X X slutdatum (enddate) Eventuellt slutdatum då en enhet eller funktion upphör sin verksamhet eller då en person slutar sin anställning. DT () Tidsangivelse i GMT (Greenwich Mean Time). Exempel: " Z". X X X X Sid 50/79

51 51 (79) startdatum Startdatum då en enhet DT (startdate) eller funktion startar sin () verksamhet eller då en person börjar sin anställning. Beslutsregel/Teknisk beskrivning Tidsangivelse i GMT (Greenwich Mean Time). Exempel: " Z". Max O OU P OR CM L X X X X visas för (hsadestinationindicator) Anger vilka som får se information om aktuell person, enhet, organisation eller funktion. Kod anges. KTOV Visas för 2 X X X X Associationer En Funktion hör till noll eller en geografisk indelning En Funktion är del av en och endast en Enhet En Funktion har noll eller flera Verksamhetstyp och noll eller flera vårdform En Funktion innehar noll eller flera Certifikat En Funktion kontaktas via noll eller flera Adressuppgifter En Funktion kontaktas via noll eller flera Telefonnummer Beslutsregel Sid 51/79

52 52 (79) 6.9 Teknisk information administratörsgrupp Pekare till administratörsgrupp DN (groupmembership) som perso- nen tillhör i HSA admingränssnitt. Beslutsregel/Teknisk beskrivning Attributvärdet ändras endast via HSA admin. Exempel: cn=dll_l_adm,ou=ddata,o=landstinget Sörmland,l=Sörmlands län,c=se" Max O OU P OR CM L X antal närmast underliggande objekt (numsubordinates) Antal närmast underliggande objekt. KV (1..1) Attributet används av SITHS statisitk och loggar. Attributet kan inte fyllas i manuellt utan innehållet skapas med automatik. Värdet är alltid 0 på person-, funktions- och uppdragsobjekt. X X X X X X antal underliggande objekt (numallsubordinates) Totalt antal underliggande objekt. KV (1..1) Attributet används av SITHS statisitk och loggar. Attributet ska inte fyllas i manuellt utan innehållet skapas med automatik. Värdet är alltid 0 på person-, funktions- och uppdragsobjekt. X X X X X X domäninloggningsnamn (userprincipalname) Inloggningsnamn i ADdomän som skrivs in i SITHS-certifikatet. KOM Skapas i lokal katalog eller hämtas från AD (motsv.). Attributet kan ha formatet: <hsaid>@<domain>.se. X Sid 52/79

53 53 (79) HSA admin administratörskonfiguration (cybconfigurationparameter) Anger konfigurationsparametrar som bl.a. används för konfigurering av delegeringsmodellen i HSA admingränssnitt. Beslutsregel/Teknisk beskrivning Attributet ska endast användas för särskild programvara, t.ex. HSA admingränssnitt. Max O OU P OR CM L HSA admin administratörskonfigurationsnamn (cybconfigurationnodename) Attribut som bl.a. används för konfigurering av delegeringsmodellen i HSA admingränssnitt. Attributet ska endast användas för särskild programvara, t.ex. HSA admingränssnitt HSA admin formulärkonfiguration (tabxmlconfig) Attribut som används av HSA admingränssnitt för att lagra konfigurationsdata. HSA användarlösenord (userpassword) Lösenord för användare av HSA. När användare loggar in med HCC sätts ett slumpmässigt lösenord efter det att autentisering och behörighetskontroll har skett. 128 (oct et) X X HSA autentiseringsmetod (hsaauthenticationmethod) Anger om kortinloggning krävs mot HSAadmingränssnitt. VÄ Om värde saknas krävs kortinloggning mot HSA admingränssnitt. Om värde ("1") är angivet tillåts även lösenordsinloggning. 1 X X Sid 53/79

54 54 (79) HSA enkel sökning Attributvärden som TXT (hsasimplesearch) används vid förenklad sökning. Beslutsregel/Teknisk beskrivning Varje attributvärde lagras i separata instanser. Max O OU P OR CM L 1024 X Obl Obl Obl HSA fonetisk sökning (hsaphoneticsearch) Fonetiska attributvärden som används vid förenklad fonetisk sökning. TXT Attributvärden som finns i attributet "HSA enkel sökning" kan läggas in i detta attribut med hjälp av en fonetiseringsalgoritm X Obl Obl Obl HSA-id-prefix (hsaidprefix) Anger vilket HSA-idprefix som ska användas när objekt skapas. VÄ För närvarande använder HSA admingränssnitt ett annat attribut för detta ändamål. Detta ska ändras så att hsaidprefix används. 40 X X HSA-id-räknare (hsaidcounter) Räknare som används för att skapa unika HSA-id:n. För närvarande använder HSA admingränssnitt ett annat attribut för detta ändamål. Detta ska ändras så att hsaidcounter används. 40 X X Individuell behörighetsegenskap för it-tjänster (hsasystemrole) Beskriver behörighet för person eller funktion i ett visst system. VÄ (systemid;roll) Systemid tilldelas av HSA förvaltning. 64 X X Sid 54/79

55 55 (79) internt synkroniserings-id Internt attribut som II (hsasyncid) kan användas för synkronisering av objekt mellan intern katalog och HSA. Beslutsregel/Teknisk beskrivning Formatet regleras i den lokala organisationen. Max O OU P OR CM L 40 X X X X X medlem i administratörsgruppen för HSA admingränssnitt (uniquemember) senaste förändringstidpunkt (modifytimestamp) Pekare till person med administratörsrättigheter i administratörsgruppens delträd, dvs. den enhet som administratörsgruppen är placerad under med underliggande objekt. Information om tidpunkt för senaste förändring. II TP () (1..*) Attributet lagras i administratörsgrupper och ändras enbart i HSA Admingränssnitt. Exempel: "cn=maria Larsson, ou=systemavdelningen,o=la ndstinget Sörmland, l=sörmlands län,c=se". Operativt attribut som skapas med automatik av databasen vid förändring av information på objektet i något attribut. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: " Z". X X X X X senast ändrad av (modifiersname) DN för objekt (användare) som senast förändrade objektet. Kan vara en administratör eller ett system. II (DN) X X X X X Sid 55/79

56 56 (79) skapad av DN för objekt (användare) II (creatorsname) som skapat ob- (DN) jektet. Kan vara en administratör eller ett system. Beslutsregel/Teknisk beskrivning Max O OU P OR CM L X X X X X skapandetidpunkt (createtimestamp) Information om tidpunkt för skapandet av objektet. TP () Operativt attribut som skapas med automatik av databasen. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: " Z". X X X X X Sid 56/79

57 57 (79) 7 Attribut i HSA Tjänsteträd Informationen i detta kapitel är hämtat från den fristående bilagan HSA-schema tjänsteträdet [2]. 7.1 Geografisk information Adresser Fakturaadress (hsainvoiceaddress) Fullständig adress dit faktura ska skickas. TXT Varje adressfält har sex möjliga rader. Informationen ska sorteras så att mer förfinad information ligger högre upp. Max Org Beslutsregel/Teknisk beskrivning OrgUnit Org Role 6*30 X X X DC Associationer En adressuppgift är kopplad till noll till flera Enheter En adressuppgift är kopplad till noll till flera Funktioner Beslutsregel Sid 57/79

58 58 (79) Geografisk indelning Land (c, countryname) Landets tvåställiga bokstavsbeteckning enligt ISO 3166 om annat än Sverige. KTOV Anges med 2 bokstäver enligt ISO Max Org Beslutsregel/Teknisk kommentar OrgUnit Org Role 2 X X X DC Länskod (countycode) Kod för län enligt SCB där enheten fysiskt är placerad. KTOV Länskod Om ifylld måste länsnamn vara ifylld. 2 X X X Länsnamn (countyname) Namn på län enligt SCB där enheten är placerad. KTOV Länskod Om ifylld måste länskod vara ifylld. 64 X X X Associationer En Geografisk indelning indelar noll till flera Funktioner Beslutsregel En Geografisk indelning indelar noll till flera Enheter Sid 58/79

59 59 (79) 7.2 Internetuppgifter Max Org Beslutsregel/Teknisk beskrivning OrgUnit Org Role DC e-postadress (mail, rfc822mailbox) Uppgift om e-postadress. KOM (e-post) 255 X X X Associationer En Internetuppgift är kontaktuppgift till noll till flera Enheter En Internetuppgift är kontaktuppgift till noll till flera Funktioner Beslutsregel 7.3 SITHS Certifikatsinformation Certifikatsmottagare (hsacertificaterecipient) Certifikatsnummer (serialnumber) Här anges person- och kontaktuppgifter till behörig mottagare av certifikat för den aktuella funktionen om detta är annan person än ansvarig person. Exempel: Anna Andersson, SITHS-certifikatets serienummer. TXT II Informationen registreras av SITHS vid publicering av HCC. Max Org Beslutsregel/Teknisk beskrivning OrgUnit Org Role 128 X 64 X DC Sid 59/79

60 60 (79) Giltigt fr om (validnotbefore) Det datum som SITHScertifikatet är giltigt från och med. (TP) Informationen registreras av SITHS vid publicering av HCC. Max Org Beslutsregel/Teknisk beskrivning OrgUnit Org Role X DC Giltigt t om (validnotafter) HCC (usercertificate) Det datum som SITHScertifikatet är giltigt till och med. Giltiga SITHS-certifikat. (TP) TXT (certifikat) Informationen registreras av SITHS vid publicering av HCC. SITHS-certifikat av typen HCC Funktion X X Associationer En Certifikat innehas av noll eller en Funktion Beslutsregel 7.4 Enhetsinformation Enhetsnamn (ou, organizationalunitname) Kan i detta sammanhang vara enhetens namn eller namnet på en gruppering av tjänster. Exempel: erecept. Rekommendationen är att undvika å, ä, ö och mellanslag. TXT (1..1) Beslutsregel/Teknisk beskrivning Rekommendationen är att skriva in hela enhetsnamnet istället för en förkortning. Enbart ett enhetsnamn får anges HSA. Max Org OrgUnit Org Role 64 Obl X DC Sid 60/79

61 61 (79) Organisationsnamn (o, organizationname) (orgno) I tjänsteträdet anges organisationsnamn utan å, ä, ö, och mellanslag. Exempel: o= Region_Skane. enligt SCB/Bolagsverket. Exempel: Associationer En Enhet består av noll eller flera Enheter En Enhet hör till noll eller en Geografisk indelning En Enhet består av noll eller flera Funktioner TXT II (XXXXXX- XXXX) (1..1) Beslutsregel Beslutsregel/Teknisk beskrivning Sekelsiffran 16 ska inte vara med. Max Org OrgUnit Org Role DC 64 Obl X 12 Obl X X 7.5 Objektinformation Ansvarig person (hsaresponsibleperson) Person- och kontaktuppgifter till den som ansvarar för funktionen eller enheten. TXT Beslutsregel/Teknisk beskrivning På organisationsnivå kan t.ex. firmatecknare anges i detta attribut. För funktioner t.ex. systemägare eller motsvarande. Exempel: Systemägare Sven Svensson, sven.svensson@lio.se, Max Org OrgUnit Org Role 128 X X X DC Sid 61/79

62 62 (79) Beskrivning (description) Kort beskrivning/förklaring av speciellt intresse. TXT Beslutsregel/Teknisk beskrivning Ska endast innehålla information som får visas för objektet. På o- nivå ska organisationens vedertagna namn skrivas, t ex Landstinget i Östergötland. För funktioner kan systemtyp anges och vad den används till. Max Org OrgUnit Org Role DC 1024 X X X X HSA-id (hsaidentity) Obligatorisk, unik identifierare för personer, enheter, funktioner och organisationer i HSA. II (HSAid) (1..1) Se beskrivning av HSA-id i dokumentet RIV Informationsspecifikation. 31 Obl Obl Obl HSA-administratörens kommentar (hsaadmincomment) Administrativ kommenter, t.ex. information om extern konsults löptid för avtal. TXT Attributet är endast synligt för HSA-administratörer inom det egna behörighetsområdet X X X Objektnamn (cn, commonname) Funktionens namn. TXT (1..1) URI/DNS-namn för tjänsten registreras alltid i attributets objektnamn om SITHS-certifikat ska skapas, ex cn=dsedix.ds.sll.se. 64 Obl Endast domännamn som ägs av organisationen de befinner sig under (o=[organisationen]) får läggas upp i objektnamn. Om andra domännamn läggs in skall skriftlig fullmakt finnas mellan Sid 62/79

63 63 (79) Beslutsregel/Teknisk beskrivning organisationen som äger domännamnet och organisationen där objektnamnet finns. Max Org OrgUnit Org Role DC Slutdatum (enddate) Eventuellt slutdatum då en enhet eller funktion upphör sin verksamhet. DT () Tidsangivelse I GMT (Greenwich Mean Time). Exempel: Z. X X X Startdatum (startdate) Startdatum då en enhet eller funktion startar sin verksamhet eller då en person börjar sin anställning. DT () Tidsangivelse I GMT (Greenwich Mean Time). Exempel: Z. X X X Associationer Beslutsregel En Funktion hör till noll eller en geografisk indelning En Funktion är del av en och endast en Enhet En Funktion innehar noll eller flera Certifikat Sid 63/79

64 64 (79) 7.6 Teknisk information antal närmast underliggande objekt (numsubordinates) antal underliggande objekt (numallsubordinates) Antal närmast underliggande objekt. Totalt antal underliggande objekt. KV KV (1..1) (1..1) Beslutsregel/Teknisk beskrivning Attributet används av SITHS statisitk och loggar. Attributet kan inte fyllas i manuellt utan innehållet skapas med automatik. Värdet är alltid 0 på person-, funktions- och uppdragsobjekt. Attributet används av SITHS statisitk och loggar. Attributet ska inte fyllas i manuellt utan innehållet skapas med automatik. Värdet är alltid 0 på person-, funktions- och uppdragsobjekt. Max Org OrgUnit Org Role DC X X X X X X X X X X Domainnamn dc, (domaincomponent) Namn för Domain. Exempel: Nod 1. TXT (1..1) Obl HSA användarlösenord userpassword Lösenord för användare av HSA. När användare loggar in med HCC sätts ett slumpmässigt lösenord efter det att autentisering och behörighetskontroll har skett. 128 (Oct et) X X Sid 64/79

65 65 (79) HSA-id-prefix hsaidprefix Anger vilket HSA-idprefix som ska användas när objekt skapas. VÄ (SEXXXXX XXXXX-) Beslutsregel/Teknisk beskrivning Max X Org OrgUnit Org Role DC HSA-id-räknare hsaidcounter Räknare som används för att skapa unika HSA-id:n. 0..* 40 X Medlem i administratörsgruppen för HSA admingränssnitt (uniquemember) Senaste förändringstidpunkt (modifytimestamp) Pekare till person med administratörsrättigheter i administratörsgruppens delträd, dvs. den enhet som administratörsgruppen är placerad under med underliggande objekt. Information om tidpunkt för senaste förändring. II TP () (1..*) Attributet lagras i administratörsgrupper och ändras enbart i HSA Admingränssnitt. Exempel: "cn=maria Larsson,ou=Systemavdelningen,o=Land stinget Sörmland,l=Sörmlands län,c=se". Operativt attribut som skapas med automatik av databasen vid förändring av information på objektet i något attribut. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: " Z". X X X X Sid 65/79

66 66 (79) Senast ändrad av (modifiersname) DN för objekt (användare) som senast förändrade objektet. Kan vara en administratör eller ett system. II (DN) Beslutsregel/Teknisk beskrivning Max Org OrgUnit Org Role DC X X X X Skapad av (creatorsname) DN för objekt (användare) som skapat objektet. Kan vara en administratör eller ett system. II (DN) X X X X Skapandetidpunkt (createtimestamp) Information om tidpunkt för skapandet av objektet. TP () Operativt attribut som skapas med automatik av databasen. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: " Z". X X X X Sid 66/79

67 67 (79) 8 Klassifikationer och kodverk I detta avsnitt beskrivs vilka attribut som har fastställda värdemängder. Varje värdemängd eller kodverk motsvaras av en fristående bilaga till detta dokument. Kodverken finns även implementerade i HSA Tjänsteträd. För med information om implementeringen hänvisas till bilagan HSA-schema tjänsteträdet [2]. Kodverken som finns i värdemängdsbilagorna består ofta av en kod och ett kodnamn, t ex så finns i värdemängden länskoder koden 05 med kodnamnet Östergötlands län. I vissa fall har koden och kodnamnet en kompletterande definition. För mer information om dessa kodverk, se respektive bilaga. Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Befattning Beskriver vad en person arbetar som. Kodverket reglerar innehållet i HSAattributet befattning, patitlename och befattningskod, patitlecode. AID-etiketter, en delmängd som beskriver arbetsområden i förteckningen Arbetsidentifikation kommuner och landsting (AID). Förteckningen Arbetsidentifikation kommuner och landsting (AID). HSA förvaltningsgrupp OID: OID-ägare: SKL Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: HSA förvaltningsgrupp Länk: Revideringsprocess: Revideras i samband med att källkodverket uppdateras. Sid 67/79

68 68 (79) Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Chefskod Enhetstyp Beskriver vilken chefsbefattning en person har. en reglerar innehållet i attributet chefskod, hsamanagercode. Används för att visa om en organisation, enhet eller funktion kan klassas som en viss typ av enhet. Chefskoder, en delmängd som beskriver chefs-, annat lednings- och funktions-/ämnesansvar i förteckningen Arbetsidentifikation kommuner och landsting (AID). Denna värdemängd innehåller olika typer av enheter, t ex "sjukhus" eller "vårdcentral". Förteckningen Arbetsidentifikation kommuner och landsting (AID). HSA HSA förvaltningsgrupp HSA förvaltningsgrupp OID: OID-ägare: SKL OID: OID-ägare: SKL Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: HSA förvaltningsgrupp Länk: Revideringsprocess: Revideras i samband med att källkodverket uppdateras. Ägare/Förvaltare: HSA förvaltningsgrupp Länk: Revideringsprocess: På HSA förvaltningsgrupps initiativ eller då önskemål om ändring inkommer. Kommunkod Reglerar innehållet i attributen kommunnamn, municipalityname, och kommunkod, municipalitycode. Denna värdemängd innehåller Sveriges kommuner i kodordning. De två första siffrorna i kommunkoden utgörs av länskoden. Källa är SCB:s förteckning över Sveriges kommuner. SCB OID: OID-ägare: SKL Ägare/Förvaltare: SCB Länk: Revideringsprocess: Revideras av HSA i samband med att källkodverket uppdateras. Sid 68/79

69 69 (79) Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Legitimerad yrkesgrupp Länskod Anger vilken, av Socialstyrelsen, legitimerad yrkesgrupp personen tillhör. Reglerar innehållet i attributet legitimerad yrkesgrupp, HSAtitle. Reglerar innehållet i attributen länsnamn, localityname, och länskod, countycode. Denna värdemängd innehåller de legitimerade yrkesgrupperna enligt SFS. Denna värdemängd innehåller Sveriges län i kodordning. Källa är Svensk författningssamling, SFS 1998:531 (ändring införd t om 2006:728). Ytterligare definition om dessa legitimerade yrkestitlar finns i SFS 1998:1513 (ändring införd t om SFS 2006:65). Källa är SCB:s förteckning över Sveriges län. OID: Saknas (Tillfällig OID finns för teknisk lagring i HSA) OID-ägare: OID: OID-ägare: SKL Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: Länk: Revideringsprocess: Revideras av HSA i samband med att källkodverket uppdateras. Ägare/Förvaltare: SCB Länk: Revideringsprocess: Revideras av HSA i samband med att källkodverket uppdateras. Medarbetaruppdrag rättigheter Anger vilka rättigheter i form av aktivitet, organisationsomfång och informationstyp som ett medarbetaruppdrag har. Denna värdemängd innehåller aktiviteter, organisationsomfång och informationstyp för medarbetaruppdrag HSA OID: Saknas OID-ägare: Ägare/Förvaltare: Ej fastställt Länk: Revideringsprocess: Oklart Sid 69/79

70 70 (79) Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Ägare/Förvaltare Länk Revideringsprocess Medarbetaruppdrag ändamål Anger ändamål då ett visst medarbetaruppdrag används. Denna värdemängd innehåller ändamål för medarbetaruppdrag. HSA OID: Saknas OID-ägare: Ägare/Förvaltare: Ej fastställt Länk: Revideringsprocess: Oklart Språkkod Används t ex för att tala om vilka språk en individ kan använda i mötet med en vårdtagare. Reglerar innehållet i attributet språkkunskapskod, languageknowledgecode. Denna värdemängd innehåller de olika språk som talas enligt den svenska standarden SS-ISO 639-2:2005 (med engelska språkbenämningar), översatt till svenska och kompletterad med det nationella minoritetsspråket Tornedalsfinska. SIS: SS-ISO 639-2:2005. Regeringens proposition 1998/99:143 Nationella minoriteter i Sverige som antogs av riksdagen i december 1999 (bet. 1999/200:KU6, rskr.1999/2000:69). HSA förvaltningsgrupp OID: OID-ägare: SKL Ägare/Förvaltare: Länk: Revideringsprocess: Revideras av HSA i samband med att källorna uppdateras. Sid 70/79

71 71 (79) Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Verksamhetskod Verksamhetskod används för att tala om vilken typ av vård en vårdgivare kan leverera. Reglerar innehållet i attributen verksamhet, busi- nessclassification- Name och verksamhetskod, businessclassificationcode. Denna värdemängd innehåller en förteckning över de verksamheter som bedrivs inom Sveriges vård- och omsorgssektor. Utvecklad inom HSA. För referenser, se värdemängdsbilagan. HSA förvaltningsgrupp OID: OID-ägare: SKL. Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: HSA förvaltningsgrupp Länk: Revideringsprocess: På HSA förvaltningsgruppens initiativ eller då önskemål om ändring inkommer. Visas för Denna värdemängd används för att tala om för vem ett objekt får visas. Reglerar innehållet i attributet visas för, hsadestinationindicator. Denna värdemängd innehåller en förteckning över olika målgrupper för informationen. Utvecklad inom HSA. HSA förvaltningsgrupp OID: Saknas (Tillfällig OID finns för teknisk lagring i HSA) OID-ägare: Ägare/Förvaltare: HSA förvaltningsgrupp Länk: Revideringsprocess: På HSA förvaltningsgruppens initiativ eller då önskemål inkommer. Sid 71/79

72 72 (79) Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Vårdform Ägarform Används för att särskilja på olika typer av vårdformer. Reglerar innehållet i attributet vårdform, caretype. Används för att kunna särskilja olika typer av ägarformer. Reglerar innehållet i attributet ägarform, management. Denna värdemängd innehåller förteckning över olika vårdformer, t.ex. öppenvård och slutenvård. Denna värdemängd innehåller förteckning över olika ägarformer, t.ex. landsting/region, kommun, privat etc. Utvecklad inom HSA. Utvecklad inom HSA. HSA förvaltningsgrupp HSA förvaltningsgrupp OID: OID-ägare: SKL OID: OID-ägare: SKL Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: HSA förvaltningsgrupp Länk: Revideringsprocess: På HSA förvaltningsgruppens initiativ eller då önskemål om ändring inkommer. Ägare/Förvaltare: HSA förvaltningsgrupp Länk: Revideringsprocess: På HSA förvaltningsgruppens initiativ eller då önskemål om inkommer. Sid 72/79

73 73 (79) 8.1 Underhåll av dokumentation Översyn av dokumentationen inom HSA sker en gång per år på förvaltningsgruppens initiativ. Eventuella uppdateringar föregås av granskning och formuleras som ett beslutsunderlag som sprids till berörda genom förvaltningsgruppens medlemmar. Minst tre månader bör gå från färdigt beslutsunderlag till dess att förvaltningsgruppen godkänner förändringen. Förslag på innehållsförändringar i HSA kan även tas upp av organisationer anslutna till HSA samt tjänster som nyttjar HSA. Sådana förändringsförslag ska skickas till HSA förvaltningsgrupp. 8.2 Underhåll av koder För att kunna följa och återskapa vilka koder som har använts finns alla gamla koder dokumenterade med koppling till nya gällande koder och giltighetstid för dessa koder Återanvändning av koder Grundprincipen är att ingen återanvändning av koder får ske, men i de fall ett använt externt kodverk återanvänder en gammal kod görs detta även i HSA Uppdelning av koder En kod kan delas upp på två olika sätt. Antingen kan en tidigare kod delas i flera koder som tillsammans innefattar hela den gamla koden eller så kan en delmängd av den tidigare koden utskiljas som en egen kod. I det första fallet kommer nya koder att tas fram och den gamla koden att tas bort. I det andra fallet kommer definitionen på den gamla koden att förändras. Om ett externt kodverk används följs principen för återanvändning av koder beskriven i kapitel Förändringar av koder I de fall en kod får ändrad betydelse ska den ersättas med en ny. Detta gäller dock inte vid mindre definitionsförändringar. Om en kod ändras ska den gamla koden finnas med i den nya versionen av kodverket/värdemängden, markerad som utgången. I nästföljande version av kodverket/värdemängden kan den gamla koden tas bort. Om ett externt kodverk används följs principen för återanvändning av koder beskriven i kapitel Sid 73/79

74 74 (79) 9 Termer och definitioner Termer som används inom HSA finns beskrivna i HSA Begrepp och definitioner [4]. Sid 74/79

75 75 (79) 10 Förklaring till Format och Multiplicitet Nedanstående datatyper för tidpunkter/-intervall utgår från ISO 8601 om inte annat anges. För information om ISO 8601 se t ex För ytterligare behov av specificering av datatyper kontakta RIV-förvaltningsgrupp. Observera att nedanstående formattabell ska uppdateras av RIV. Svensk benämning på datatyp Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO Förklaring Sant/Falskt/ S/F/T BL Boolean Kan antingen vara sant, falskt eller tomt. Tomt Sant/Falskt S/F BN Boolean not null Kan antingen vara sant eller falskt. Kodat värde Coded value Identifiering av berört kodverk/klassifikation (genom KTOV CD med text och sk OID) samt aktuell kod och text OID Exempel: A00.9 Kolera, ospecificerat OID för KSH97 v97 mycket allvarlig kolera kod K aktuellt kodvärde text TX klartext kodverk OID identifierng av berört kodverk/ klassifikation version TX kodverkets version förtydligande TX används t ex vid förtydligande av kod Övrigt Instans identifierare II II Instance Identifier En unikt identifikation av en instans, företeelse eller objekt. T.ex. remissid, personnummer, HSA-id. Exempel: MMÅÅDD-XXXX OID för personnummer kod CV aktuellt kodvärde kodverk OID identifierng av berört kodverk/klassifikation Datapaket DP ED Encapsulated data Används för att ange typ av bild, ljud och andra multimediadata detta specificeras senare vid behov (för information kontakta RIV förvaltningsgrupp) Sid 75/79

76 76 (79) Svensk benämning på datatyp Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO Förklaring Värde VÄ Uttrycker värdets datatyp och sort värde aktuellt värde värdetyp Kodat värdetsdatatyp värde enhet Text värdets enhet Kvantitet KV PQ Physical Quantity Uttrycker mängd och sort som resultat av en mätning. Exempel: 10 kg Flertal FLT<x> SET<x> Set Uttrycker ett flertal/upprepningar av angiven datatyp Exempel. FLT<DT> Fritext TXT ST Simple Text Fritext Tele- och datakommunikation KOM TEL/HL7 TEL/HL7 Beskriver telekommunikationsadresser t.ex. telefonnummer, fax och e-post Möjlighet till fritext DT Date Date Angivelse av datum. Formatet är ÅÅÅÅMMDD. Det är tillåtet att ange datum med lägre precision, dvs månad eller år. Datatypen kallas fortfarande datum. Formatet är ÅÅÅÅMM respektive ÅÅÅÅ Exempel: Tidpunkt TP TS Point in Time Tidsintervall IVL ITV<TS> Time interval Angivelse av datum och klockslag med exaktheten sekund. Formatet är ÅÅÅÅ-MM-DDThh:mm:ss.xxxxx Det är tillåtet att ange tidpunkt med lägre precision, dvs minut eller timme. Formatet är hhmm respektive hh. Exempel: ÅÅÅÅ-MM-DDThh:mm eller ÅÅÅÅ-MM- DDThh Detta format är enligt ISO8601. För ytterligare behov av datatyper för tidpunkter kontakta RIVförvaltningsgrupp. Angivelse av ett utrymme i tiden. Detta kan anges på 4 sätt: 1. Start och slut 2. Start och varaktighet 3. Varaktighet och slut 4. Varaktighet (utan relation till realtid) Formatet är P[tY][mM][dD][T[hH][mM][s[.s]S]] där uppgifter inom [ ] är valfria. Sid 76/79

77 77 (79) Svensk benämning på datatyp Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO Förklaring Av de första 3 krävs två separata värden åtskilda av /. Exempel: T13:00:00Z/ T15:30:00Z T13:00:00Z/P1Y2M10DT2H30M 3. P1Y2M10DT2H30M/ T15:30:00Z 4. PT2H31M26.34S, dvs jordbävningen pågick i 2 timmar, 31 minuter och 26,34 sekunder Webbadress URL URL Kolumn Multiplicitet (antal möjliga förekomster) Kod, ex Förklaring 1(1..1) En förekomst 0..1 Ingen eller en förekomst 0..* Ingen eller många förekomster 1..2 En till två förekomster 1..* En till många förekomster Sid 77/79

78 78 (79) 11 Kort beskrivning av RIV Vid elektroniskt informationsutbyte mellan två eller flera parter måste informationen specificeras väl. Det är t.ex. nödvändigt att en remiss har en struktur och ett innehåll som gör att mottagare kan tolka informationen korrekt. Det krävs att ingående parter uppfattar termer och begrepp samt att informationen utväxlas i överenskommet format. Informationsspecifikationen har arbetats fram enligt RIV Metodanvisningar för beskrivning och strukturering av information, nedan kallad RIV Metodanvisningar och dokumenterats enligt RIV Dokumentationsanvisningar. Vi har i vårt arbete sökt återvinna så mycket goda erfarenheter från andra som möjligt. Informationsspecifikationen består av två delar, dels ett IT-orienterat utdrag, en ITdokumentation och ett utdrag, Verksamhetsdokumentationen, för representanter från verksamheten, vilka ska ta del av innehållet i informationsutbytet, utan att vara modellexperter, samtidigt som det är en bakgrundsbeskrivning för IT-specialister. Det samlade materialet finns tillgängligt på det Tillämpade informationsstrukturbiblioteket (TIB) Metoden bygger på en stark samverkan mellan verksamhetsföreträdare och IT-företrädare samt grundar sig på svenska och europeiska standarder. Standarder som tillämpats framgår av RIV Metodanvisningar. Arbetsmetoden består av tre steg: I arbetssteget Informationsbehovsanalys framställs: Informationsflöde mellan parter, tillhör verksamhetsdokumentationen Informationsöversikter, tillhör verksamhetsdokumentationen I arbetsteget Informationsmodellering samt Terminologiarbete framställs: Verksamhetsorienterad DIM (V-DIM), tillhör verksamhetsdokumentationen Termer och definitioner som används, tillhör verksamhetsdokumentationen Referenser till Klassifikationer och kodverk, tillhör verksamhetsdokumentationen En Domäninformationsmodell (DIM), tillhör IT-dokumentationen Hierarkisk meddelandebeskrivning (HMD), tillhör IT-dokumentationen Meddelandeinformationsmodeller (MIM), tillhör IT-dokumentationen I arbetssteget Formatering framställs: XML-scheman, tillhör IT-dokumentationen. WSDL-scheman, tillhör IT-dokumentationen. Sid 78/79