RIV Informationsspecifikation HSA Struktur och innehåll
INFORMATIONSSPECIFIKATION HSA Struktur och innehåll Datum 2015-04-14 Version 4.5 RIV Informationsspecifikation Verksamhetsdokumentation för HSA Struktur och innehåll Kontaktperson: Henrika Littorin, Inera AB INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 2 (87) Datum 2015-04-14 Version 4.5 Innehållsförteckning REVISIONSHISTORIK ...................................................................................................................................... 4 1 INLEDNING ................................................................................................................................................... 5 2 BAKGRUND .................................................................................................................................................. 6 2.1 GRUNDLÄGGANDE STANDARDER .............................................................................................................. 6 2.2 ATTRIBUT, OBJEKT OCH OBJEKTKLASSER .................................................................................................. 6 2.2.1 Attribut .............................................................................................................................................. 6 2.2.2 Objektklasser .................................................................................................................................... 6 2.2.3 Objekt................................................................................................................................................ 7 3 BESKRIVNING AV VERKSAMHETSOMRÅDET .................................................................................. 8 3.1 3.2 3.3 3.4 3.5 4 OMFATTNING ............................................................................................................................................ 8 BERÖRDA PARTER ..................................................................................................................................... 8 BESKRIVNING ............................................................................................................................................ 8 INVOLVERADE STÖDREGISTER ................................................................................................................... 9 GJORDA AVGRÄNSNINGAR OCH VAL ......................................................................................................... 9 INFORMATIONSÖVERSIKT ................................................................................................................... 10 4.1 ENHETER OCH FUNKTIONER .................................................................................................................... 10 4.2 PERSON OCH MEDARBETARUPPDRAG ...................................................................................................... 11 4.3 OBJEKTKLASSER I HSA ........................................................................................................................... 11 4.4 SCHEMATISK TRÄDSTRUKTUR FÖR HSA ................................................................................................. 13 4.4.1 HSA Organisationsträd................................................................................................................... 14 4.4.2 HSA Tjänsteträd.............................................................................................................................. 15 4.5 OBJEKTNAMN OCH IDENTIFIERARE .......................................................................................................... 16 4.5.1 Unika objektsnamn ......................................................................................................................... 16 4.5.2 Unika identifierare för objekt ......................................................................................................... 17 5 VERKSAMHETSORIENTERAD DOMÄNINFORMATIONSMODELL (V-DIM) ............................ 18 6 ATTRIBUT I HSA ORGANISATIONSTRÄD ......................................................................................... 19 6.1 GEOGRAFISK INFORMATION .................................................................................................................... 19 6.1.1 Adresser .......................................................................................................................................... 19 6.1.2 Geografisk indelning....................................................................................................................... 21 6.2 KONTAKTINFORMATION .......................................................................................................................... 24 6.2.1 Internetuppgifter ............................................................................................................................. 24 6.2.2 Telefonnummer ............................................................................................................................... 25 6.2.3 Tider och regler .............................................................................................................................. 26 6.3 PERSONUPPGIFTER .................................................................................................................................. 34 6.3.1 Namn ............................................................................................................................................... 34 6.3.2 Identitetsnummer ............................................................................................................................ 36 6.3.3 Personliga egenskaper .................................................................................................................... 38 6.3.4 Förskrivarkod ................................................................................................................................. 42 6.4 SITHS KORT- OCH CERTIFIKATSINFORMATION ....................................................................................... 43 6.4.1 Certifikatsinformation ..................................................................................................................... 43 6.4.2 Kortinformation .............................................................................................................................. 44 6.4.3 Spärrlistinformation........................................................................................................................ 44 6.5 ORGANISATIONSUPPGIFTER ..................................................................................................................... 45 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 2/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 3 (87) Datum 2015-04-14 Version 4.5 6.6 VERKSAMHETSTYP OCH VÅRD- OCH OMSORGSFORM ............................................................................... 51 6.7 MEDARBETARUPPDRAG........................................................................................................................... 53 6.7.1 Medarbetaruppdrag (vårduppdrag) ............................................................................................... 53 6.7.2 Medarbetaruppdrag (administrativa uppdrag)............................................................................... 55 6.8 OBJEKTINFORMATION ............................................................................................................................. 58 6.9 TEKNISK INFORMATION ........................................................................................................................... 61 7 ATTRIBUT I HSA TJÄNSTETRÄD ......................................................................................................... 67 7.1 GEOGRAFISK INFORMATION .................................................................................................................... 67 7.1.1 Geografisk indelning....................................................................................................................... 67 7.2 INTERNETUPPGIFTER ............................................................................................................................... 67 7.3 SITHS CERTIFIKATSINFORMATION ......................................................................................................... 68 7.4 ENHETSINFORMATION ............................................................................................................................. 69 7.5 OBJEKTINFORMATION ............................................................................................................................. 70 7.6 TEKNISK INFORMATION ........................................................................................................................... 72 8 KLASSIFIKATIONER OCH KODVERK ................................................................................................ 75 8.1 UNDERHÅLL AV DOKUMENTATION .......................................................................................................... 81 8.2 UNDERHÅLL AV KODER ........................................................................................................................... 81 8.2.1 Återanvändning av koder ................................................................................................................ 81 8.2.2 Uppdelning av koder ....................................................................................................................... 81 8.2.3 Förändringar av koder ................................................................................................................... 81 9 TERMER OCH DEFINITIONER .............................................................................................................. 82 10 FÖRKLARING TILL FORMAT OCH MULTIPLICITET .................................................................. 83 11 KORT BESKRIVNING AV RIV .............................................................................................................. 86 REFERENSER OCH FÖRKORTNINGAR..................................................................................................... 87 FRISTÅENDE BILAGOR TILLHÖRANDE DETTA DOKUMENT: HSA-SCHEMA ORGANISATIONSTRÄDET [1] HSA-SCHEMA TJÄNSTETRÄDET [2] VÄRDEMÄNGDSBILAGOR ENLIGT KAPITEL 8 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 3/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 4 (87) Datum 2015-04-14 Version 4.5 Revisionshistorik Version Datum Ändrad av Status 4.2 2013-10-22 Ulrika Nilsson Uppdaterad i enlighet med version 4.2 av HSA-schemat för HSA Organisationsträd och HSA Tjänsteträd 4.3 2014-04-29 Ulrika Nilsson Uppdaterad i enlighet med version 4.3 av HSA-schemat för HSA Organisationsträd och HSA Tjänsteträd 4.4 2014-10-21 Ulrika Nilsson Uppdaterad i enlighet med version 4.4 av HSA-schemat för HSA Organisationsträd och HSA Tjänsteträd. 4.5 2015-04-14 Ulrika Nilsson Uppdaterad i enlighet med version 4.5 av HSA-schemat för HSA Organisationsträd och HSA Tjänsteträd. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 4/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 5 (87) Datum 2015-04-14 Version 4.5 1 Inledning Delprojekt Informationsstruktur i arbetet har följande personer deltagit: 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, kommuner och privata vårdgivare. 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. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Projektledare: Henrika Littorin, Inera AB Projektgrupp: HSA Förvaltningsgrupp bestående av: Johan Zenk, Region Östergötland (Ordf) Lennart Linjamaa, Region Jämtland Härjedalen Kamran Khazravi, Stockholms läns landsting Wladimir Bislawski, Stockholms läns landsting Anders Dahl, Region Örebro län Tomas Gustafsson, Västra Götalandsregionen Terminolog: Annika Asp, Inera (Terminologicentrum TNC) Informationsmodellerare: Ulrika Nilsson, Inera (Secure State) 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] Kodverk/Värdemängdsbilagor som redovisas i kapitel 8 i detta dokument Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 5/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 6 (87) Datum 2015-04-14 Version 4.5 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. Attribut Objektklass består av Objekt ingår i Attributvärde 2.2.1 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 ”+4659013900”. 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” [1] och ”HSA Tjänsteträd objekt och attribut” [2]. 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. 2.2.2 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 HSAPersonExtensInera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 6/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 7 (87) Datum 2015-04-14 Version 4.5 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. 2.2.3 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. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 7/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 8 (87) Datum 2015-04-14 Version 4.5 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 Säkerhetstjänster. vårdsökningstjänster, t.ex. telefonkatalog, 1177 Vårdguiden, Mina Vårdkontakter. 3.2 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, Säkerhetstjänster och 1177.se. 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. Bilden nedan visar hur kopplingar till HSA ser ut. Figur1. Teknisk infrastruktur för HSA Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 8/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 9 (87) Datum 2015-04-14 Version 4.5 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. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 9/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 10 (87) Datum 2015-04-14 Version 4.5 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 enheter 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. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 10/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 11 (87) Datum 2015-04-14 Version 4.5 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”[1]. 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 enhet (medarbetaruppdrag som är vårduppdrag är endast kopplade till enheter som är definierade som vårdenheter). En person kan ha många medarbetaruppdrag kopplade till en eller flera enheter. Vårdrelaterade 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 av typen vårduppdrag 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. Under hösten 2013 utvecklades medarbetaruppdrag av administrativ typ. Dessa finns implementerade i HSA-katalogen, men är ännu inte hanterade i gränssnitt såsom administrationsgränssnitt och WebService. Se separat beskrivning om administrativa uppdrag [5]. 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. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 11/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 12 (87) Datum 2015-04-14 Version 4.5 Informationsobjektsklass Innehåller information om Katalogobjektsklass Enhet Innehåller information om t.ex. enhetsnamn, besöksadress, telefonnummerverksamhet som bedrivs, ägarform. organization – den översta nivån i enhetshierarkin organizationalUnit – alla underliggande nivåer i enhetshierarkin HSAOrganizationExtension pkiUser 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. organizationalRole HSARoleExtension pkiUser Funktioner innehåller information om t.ex. funktionens namn, besöksadress, telefonnummer och verksamhet som bedrivs. Person Innehåller information om t.ex. namn, person-id, telefonnummer, epostadress, legitimerad yrkesgrupp, specialistkod. organizationalPerson inetOrgPerson Person HSAPersonExtension pkiUser Medarbetaruppdrag, vårdrelaterat Inera AB Innehåller information om uppdragets medlemmar, ändamål och rättigheter. Box 177 03 Östgötagatan 12 118 93 Stockholm hsaCommission Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 12/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 13 (87) Datum 2015-04-14 Version 4.5 Informationsobjektsklass Innehåller information om Katalogobjektsklass Medarbetaruppdrag, administrativa Innehåller information om uppdragets medlemmar, domänområden, uppdragets organisationsomfång och ansvarig organisation och person hsaAdminCommission 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. 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 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 13/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 14 (87) Datum 2015-04-14 Version 4.5 Tabellen nedan förklarar objekten i ovanstående figur. LDAP-namn Beskrivning root Rot – i detta fall HSA-roten country Land – Sverige domain Domän – avgränsar och delar tjänsteträdet locality Län – ej tvingande geografisk uppdelning organization Organisation – juridisk person oavsett ägarform organizationalUnit Enhet – bestående av funktioner och personer organizationalRole organizationalPerson Funktion – Tjänst, t.ex. en IT-tjänst, eller del av en enhet Person – en individ hsaCommission Medarbetaruppdrag , vårdrelaterade hsaAdminCommission Medarbetaruppdrag, administrativa 4.4.1 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. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 14/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 15 (87) Datum 2015-04-14 Version 4.5 Figur 4. Schematisk trädstruktur för HSA Organisationsträd Normalt befinner sig såväl personer, organizationalPerson, som funktioner, organizationalRole, 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 och hsaAdminCommission), befinner sig alltid direkt under den enhet som den tillhör. Medarbetaruppdrag av vårdtyp 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]”. 4.4.2 HSA Tjänsteträd Bilden nedan visar hur HSA Tjänsteträd ser ut. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 15/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 16 (87) Datum 2015-04-14 Version 4.5 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”[2]. 4.5 Objektnamn och identifierare 4.5.1 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 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 16/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 17 (87) Datum 2015-04-14 Version 4.5 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. 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 4.5.2 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. Identifierare för objektet kan bestå av valfria bokstäver (A-Z) och siffror (0-9). Observera att tecknen å, ä, ö samt @-tecken inte är tillåtna. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 17/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 18 (87) Datum 2015-04-14 Version 4.5 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]. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 18/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 19 (87) Datum 2015-04-14 Version 4.5 6 Attribut i HSA Organisationsträd 6.1 Geografisk information 6.1.1 Adresser Attribut (LDAP-namn) besöksadress (street, streetAddress) Beskrivning Format Mult TXT TXT 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. Kodverk/ Värdemängd Max lgd 128 O OU P OR Envärdes enligt regel (0..1) Beslutsregel/Teknisk beskrivning Besöksadress kan även kompletteras med information i attributet färdväg. X X X X Envärdes enligt regel (0..1) Varje adressfält har sex möjliga rader. Informationen ska sorteras så att mer 6*30 Obl X X X Exempel på Besöksadress: "Lövdalsvägen 4, 2 tr., Björkvik", "Södersjukhuset, Hjalmar Cederströms gata 14, Stockholm" ”Blå stråket 5, Göteborg. Hiss D, plan 13, Sahlgrenska sjukhuset”. postadress (postalAddress) Inera AB Besöksadress kan kompletteras med information som är viktig för att besökaren ska hitta rätt såsom t.ex. "Röda dörren till höger om huvudentrén." Information om fullständig postadress (adressatuppgift och utdelningsadress). För personer behöver dock inte adressat Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 19/87 CM L X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 20 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult TXT Envärdes enligt regel (0..1) Kodverk/ Värdemängd anges. För personer behöver dock inte adressat anges. Beslutsregel/Teknisk beskrivning förfinad information ligger högre upp. Max lgd O OU P OR Används normalt enbart för sökändamål. Attributet lagras utan "S" om det är ett svenskt postnummer. 40 X X X X Exempel: Vårdcentralen Centrum Mellangatan 32 111 23 Härnösand postnummer (postalCode) Postnummer för platsen där verksamheten bedrivs. Kan vara annat postnummer än det som anges i andra adressuppgifter. (utan mellanslag) Associationer En adressuppgift är kopplad till noll till flera Personer Beslutsregel En adressuppgift är kopplad till noll till flera Enheter En adressuppgift är kopplad till noll till flera Funktioner Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 20/87 CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 21 (87) Datum 2015-04-14 Version 4.5 6.1.2 Geografisk indelning Attribut (LDAP-namn) geografiska koordinater RT90 (geographicalCoordinates) Beskrivning Geografiska koordinater (enligt RT90) som anger enhetens fysiska placering. Format Mult VÄ Envärdes enligt regel (0..1) (utan mellanslag) Kodverk/ Värdemängd Exempel på en koordinat i Stockholm (Djurgårdsbron) är: Beslutsregel/Teknisk kommentar Koordinaterna anges med 7 siffror och värdena är i meter. Koordinatsystemet som används är RT90 2.5 gon Väst. Max lgd 64 O OU P OR X X X X CM L ”X:6581164,Y:1630250” geografiska koordinater SWEREF 99 TM (geographicalCoordinatesSweref99TM) Geografiska koordinater enligt SWEREF 99 TM som anger enhetens fysiska placering. VÄ (utan mellanslag) Envärdes enligt regel (0..1) Värden är angivna I meter. 64 X X Envärdes enligt regel (0..1) Om attributet tillhör objektklass locality är detta det officiella namnet på länet enligt värdemängdsbilagan Länskoder. 128 X X 2 X X Exempel på en koordinat i Linköping (E4-bron över Stångån) är: N:6477155,E:536352 geografisk plats (l, localityName) kommunkod (municipalityCode) Inera AB 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. Kod för kommun enligt SCB där enheten fysiskt är placerad. Box 177 03 Östgötagatan 12 118 93 Stockholm TXT (KTOV för objektklassen locality) KTOV Tel 08 452 71 60 [email protected] www.inera.se Envärdes enligt regel (0..1) Kommunkod Organisationsnummer 556559-4230 Om ifylld måste attributet "kommunnamn" vara ifyllt, samt attributen "länsnamn" och "länskod". Sid 21/87 X X X Obl INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 22 (87) Datum 2015-04-14 Attribut (LDAP-namn) kommunnamn (municipalityName) land (c, Version 4.5 Beskrivning Format Mult Namn på kommun enligt SCB där enheten fysiskt är placerad. KTOV Envärdes enligt regel (0..1) Landets beteckning enligt ISO 3166 om annat än Sverige. KTOV Envärdes (0..1) Kod för län enligt SCB där enheten fysiskt är placerad. KTOV Envärdes enligt regel (0..1) Namn på län enligt SCB där enheten är placerad. KTOV Envärdes enligt regel (0..1) TXT Envärdes enligt regel (0..1) Kodverk/ Värdemängd Kommunkod Beslutsregel/Teknisk kommentar Om ifylld måste attributet "kommunkod" vara ifyllt, samt attributen "länsnamn" och "länskod". Max lgd 64 O OU P OR X X X Anges med 2 bokstäver enligt ISO 3166. 2 X X X Länskod Om ifylld måste attributet "länsnamn" vara ifyllt. 2 X X X Länskod Om ifylld måste attributet "länskod" vara ifyllt. 64 X X X Attributet är inte avsett för sökningar utan för att visa upp information om områdesansvar. 1024 X X X countryName) länskod (countyCode) länsnamn (countyName) områdesansvar (hsaHealthCareArea) Inera AB Geografisk definierat område för någon form av administrativ indelning. Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 22/87 CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 23 (87) Datum 2015-04-14 Attribut (LDAP-namn) färdväg (route) Version 4.5 Beskrivning Format Mult Beskrivning av färdväg för att ta sig till enheten. TXT Envärdes enligt regel (0..1) Exempel: Lämpliga busslinjer för att ta sig hit är 1, 2, 5 och 7. Med bil tar du dig lättast hit genom att ta avfart 123 från E4 och därefter följa skyltningen. Det finns även skyltad cykelväg hit från centrum. Associationer En Geografisk indelning indelar noll till flera Funktioner Kodverk/ Värdemängd Beslutsregel/Teknisk kommentar Beslutsregel En Geografisk indelning indelar noll till flera Enheter Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 23/87 Max lgd 1024 O OU X X P OR X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 24 (87) Datum 2015-04-14 Version 4.5 6.2 Kontaktinformation 6.2.1 Internetuppgifter Attribut (LDAP-namn) 1177-kontaktkortslänk (hsaVpwWebPage) Beskrivning Länk till enhetens kontaktkort på 1177.se. Format Mult URL Envärdes (0..1) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd Detta attribut registreras inte manuellt utan genereras med automatik. Länken är uppbyggd på följande vis: O OU X X P OR X http://www.1177.se/Hi ttavard/Kontakt/?hsaid=< HSA-id> e-postadress Uppgift om e-postadress. KOM (e-post) (mail, Envärdes enligt regel (0..1) 255 Obl X Envärdes enligt regel (0..1) 255 X X X X X X X X rfc822Mailbox) Innehållsansvarigs epostadress (hsaDirectoryContact) webbadress (labeledURI) E-postadress till kontaktfunktion för innehållsfrågor och kommentarer kring organisationens eller enhetens kataloguppgifter. Fullständig webbadress inklusive ”http://” eller "https://. KOM (e-post) URL Associationer En Internetuppgift är kontaktuppgift till noll till flera Enheter Envärdes enligt regel (0..1) Beslutsregel En Internetuppgift är kontaktuppgift till noll till flera Funktioner En Internetuppgift är kontaktuppgift till noll till flera Personer Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 24/87 CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 25 (87) Datum 2015-04-14 6.2.2 Version 4.5 Telefonnummer Attribut (LDAP-namn) Beskrivning direkttelefon (telephoneNumber) fax Format Mult Publikt direkttelefonnummer. KOM Flervärdes (0..*) Faxnummer. KOM (Tel) (facsimileTelephoneNumber) minicall (Tel) Minicallnummer. I detta attribut ska inte interna sökare anges. KOM mobiltelefon (mobile, (mobileTelephoneNumber) Mobiltelefonnummer. KOM sms-telefon (smsTelephoneNumber) Telefonnummer som används för SMSmeddelanden. KOM texttelefon Telefon för personer med hörsel- och/eller talhandikapp där kommunikationen sker via terminaler med tangentbord och bildskärm. KOM (pager, (Tel) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Nationella kortnummer, t.ex. 1177 och 112, inleds ej med prefixet “+46”. Max lgd 32 O OU P OR Obl X X X Flervärdes (0..*) 32 X X X X Flervärdes (0..*) 32 X X X X Flervärdes (0..*) 32 X X X X Envärdes enligt regel (0..1) 32 X X X X Flervärdes (0..*) 32 X X X X pagerTelephoneNumber) (hsaTextTelephoneNumber) Inera AB (Tel) Box 177 03 Östgötagatan 12 118 93 Stockholm (Tel) (Tel) Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 25/87 CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 26 (87) Datum 2015-04-14 Attribut (LDAP-namn) tjänstetelefon (hsaTelephoneNumber) växeltelefon (hsaSwitchboardNumber) Beskrivning Version 4.5 Format Mult Telefonnummer för tjänsteärenden. KOM Flervärdes (0..*) Telefonnummer till växel som leder vidare i organisationen. KOM (Tel) (Tel) Kodverk/ Värdemängd Envärdes enligt regel (0..1) Associationer Ett Telefonnummer är kontaktuppgift till noll eller flera Enheter Beslutsregel/Teknisk beskrivning Visas inte på Internet. Max lgd 32 O OU P OR X X X X Nationella kortnummer, t.ex. 1177 och 112, inleds ej med prefixet “+46”. 32 X X X X Max lgd 128 O OU P OR X X X 64 X X X CM L CM L Beslutsregel Ett Telefonnummer är kontaktuppgift till noll eller flera Funktioner Ett Telefonnummer är kontaktuppgift till noll eller flera Personer 6.2.3 Tider och regler Attribut (LDAP-namn) Beskrivning besöksregler för anhöriga (hsaVisitingRules) Informationstext om regler för besökare till patient. Exempel: ”Medhav av blommor är inte tillåtet”. 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. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Format Mult TXT Envärdes enligt regel (0..1) Tid Flervärdes (0..*) (IVL) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Organisationsnummer 556559-4230 Beslutsregel/Teknisk beskrivning Skrivs enligt följande syntax: <D><D>#<FT>#<TT>#<ko mmentar> där D = Dag (kan anta värdena 1 till 7 där 1 = måndag och 7 = sön- Sid 26/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 27 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning dag. Dagar skrivs alltid med streck (–) mellan. Gäller tiden bara en dag skrivs till exempel ”1-1”), FT = Från och med tid (skrivs hh:mm), TT = Till och med tid (skrivs hh:mm). Observera att TT ska vara större än FT och att dygnsgränser inte får överskridas. Kommentar = Frivillig fritextbeskrivning på max 16 tecken Flera tider skrivs som flera instanser av attributet. Exempel: Måndag till fredag 8.00 till 12.00 och 13.00 till 16.30 skrivs i två instanser enligt följande: 1-5#08:00#12:00 1-5#13:00#16:30 Dygnet runt hela veckan skrivs enligt Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 27/87 Max lgd O OU P OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 28 (87) Datum 2015-04-14 Attribut (LDAP-namn) remisskrav (hsaVisitingRuleReferral) telefontid (telephoneHours) Inera AB Beskrivning Version 4.5 Format Mult 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 Envärdes enligt regel (0..1) Den tid då någon svarar i telefonen på det telefonnummer som angivits i attributet "direkttelefon". Tid Flervärdes (0..*) Box 177 03 Östgötagatan 12 118 93 Stockholm (IVL) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Organisationsnummer 556559-4230 Beslutsregel/Teknisk beskrivning följande: 1-7#00:00#24:00 Fredag 21:00 till lördag 6:00 skrivs i två instanser enligt följande: 5-5#21:00#24:00 6-6#00:00#06 Attributet är inte avsett för sökning utan endast för att visa information. Skrivs enligt följande syntax: <D><D>#<FT>#<TT>#<ko mmentar> där D = Dag (kan anta värdena 1 till 7 där 1 = måndag och 7 = söndag. Dagar skrivs alltid med streck (–) mellan. Gäller tiden bara en dag skrivs till exempel ”1-1”), FT = Från och med tid (skrivs hh:mm), TT = Till och med tid Sid 28/87 Max lgd O OU 64 X X 50 X X P OR X X X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 29 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning (skrivs hh:mm). Observera att TT ska vara större än FT och att dygnsgränser inte får överskridas. Kommentar = Frivillig fritextbeskrivning på max 16 tecken Flera tider skrivs som flera instanser av attributet. Exempel: Tisdag till fredag 8.00 till 12.15 (Tidbokning) och 13.00 till 16.20 (Telefonrådgivning) skrivs i två instanser enligt följande: 25#08:00#12:15#Tidb okning 25#13:00#16:20#Telef onrådgivning Dygnet runt hela veckan skrivs enligt följande: Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 29/87 Max lgd O OU P OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 30 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning 1-7#00:00#24:00 Max lgd O OU 40 X X P OR Fredag 21:00 till lördag 6:00 skrivs i två instanser enligt följande: 5-5#21:00#24:00 6-6#00:00#06 tid för dropin-besök utan tidsbokning (dropInHours) Inera AB 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. Box 177 03 Östgötagatan 12 118 93 Stockholm Tid (IVL) Tel 08 452 71 60 [email protected] www.inera.se Flervärdes (0..*) Organisationsnummer 556559-4230 Skrivs enligt följande syntax: <D><D>#<FT>#<TT>#<ko mmentar> där D = Dag (kan anta värdena 1 till 7 där 1 = måndag och 7 = söndag. Dagar skrivs alltid med streck (–) mellan. Gäller tiden bara en dag skrivs till exempel ”1-1”), FT = Från och med tid (skrivs hh:mm), TT = Till och med tid (skrivs hh:mm). Observera att TT ska vara större än FT och att dygnsgränser inte får överskridas. Kommentar = Frivillig fritextbeskrivning på Sid 30/87 X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 31 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning max 16 tecken Flera tider skrivs som flera instanser av attributet. Exempel: Tisdag till fredag 8.00 till 12.15 (Provtagning) och 13.00 till 16.20 (Rådgivning) skrivs i två instanser enligt följande: 25#08:00#12:15#Provt agning 25#13:00#16:20#Rådgi vning Dygnet runt hela veckan skrivs enligt följande: 1-7#00:00#24:00 Fredag 21:00 till lördag 6:00 skrivs i två instanser enligt följande: 5-5#21:00#24:00 6-6#00:00#06 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 31/87 Max lgd O OU P OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 32 (87) Datum 2015-04-14 Attribut (LDAP-namn) åldersregler för vårdkontakt (hsaVisitingRuleAge) Beskrivning Å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". Version 4.5 Format Mult TXT Flervärdes (0..*) (XX-XX) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Anges alltid med år enligt följande: <minvärde><maxvärde>#<eventuell kommentar> Max lgd 22 O OU P OR X X X 64 X X X Exempel: "02-08". Det går även att lägga till en kommentar på max 16 tecken efter intervallet. Minsta värde är "00" för nyfödd och "99" för "ingen övre gräns". öppettider (surgeryHours) Inera AB Den tid då personal finns på plats, då receptionen är bemannad eller då ”dörren är öppen”. Gäller alla typer av enheter. Box 177 03 Östgötagatan 12 118 93 Stockholm Tid (IVL) Tel 08 452 71 60 [email protected] www.inera.se Flervärdes (0..*) Organisationsnummer 556559-4230 Skrivs enligt följande syntax: <D><D>#<FT>#<TT>#<ko mmentar> där D = Dag (kan anta värdena 1 till 7 där 1 = måndag och 7 = söndag. Dagar skrivs alltid med streck (–) mellan. Gäller tiden bara en dag skrivs till exempel ”1-1”), FT = Från och med tid (skrivs hh:mm), TT = Till och med tid Sid 32/87 CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 33 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning (skrivs hh:mm). Observera att TT ska vara större än FT och att dygnsgränser inte får överskridas. Kommentar = Frivillig fritextbeskrivning på max 16 tecken Flera tider skrivs som flera instanser av attributet. Exempel: Tisdag till fredag 8.00 till 12.15 (Provtagning) och 13.00 till 16.20 (Telefonrådgivning) skrivs i två instanser enligt följande: 25#08:00#12:15#Provt agning 25#13:00#16:20#Telef onrådgivning Dygnet runt hela veckan skrivs enligt följande: Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 33/87 Max lgd O OU P OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 34 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning 1-7#00:00#24:00 Max lgd O OU P OR CM L Max lgd 64 O OU P OR CM L Fredag 21:00 till lördag 6:00 skrivs i två instanser enligt följande: 5-5#21:00#24:00 6-6#00:00#06 Associationer En Tider och Regler gäller för noll eller flera Enheter Beslutsregel En Tider och Regler gäller för noll eller flera Funktioner En Tider och Regler gäller för noll eller flera Personer 6.3 Personuppgifter 6.3.1 Namn Attribut (LDAP-namn) efternamn (sn, surName) Inera AB Beskrivning Format Mult Personens efternamn enligt Skatteverkets definition i SKV 717 som bygger på namnlagen. TXT Envärdes enligt regel (1..1) Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd 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. Organisationsnummer 556559-4230 Sid 34/87 Obl INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 35 (87) Datum 2015-04-14 Attribut (LDAP-namn) fullständigt namn (fullName) initial (initials) mellannamn (middleName) smeknamn (nickName) tilltalsnamn (givenName, Inera AB Version 4.5 Beskrivning Format Mult Personens alla förnamn, mellannamn och efternamn enligt Skatteverkets definition i SKV 717 som bygger på namnlagen. TXT Envärdes (1..1) 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 Personens mellannamn enligt Skatteverkets definition i SKV 717 som bygger på namnlagen. TXT Används då tilltalsnamn inte är det namn som personen vill använda/bli tilltalad med. TXT Envärdes enligt regel (0..1) Personens tilltalsnamn enligt Skatteverkets tilltalsmarkering. Finns inte tilltalsmarkering kan ett av TXT Envärdes enligt regel (1..1) Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Hämtas från Skatteverket för alla med svenskt personeller samordningsnummer. Format: ”mellannamn efternamn, förnamn”. Max lgd 180 Envärdes enligt regel (0..1) 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 Envärdes enligt regel (0..1) Hämtas från Skatteverket för alla med svenskt personeller samordningsnummer. Endast ett mellannamn får anges för personen i HSA. 40 Hämtas från Skatteverket för alla med svenskt personeller samordningsnummer. Organisationsnummer 556559-4230 Sid 35/87 O OU P Obl X Obl om fin ns 64 X 64 Obl OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 36 (87) Datum 2015-04-14 Attribut (LDAP-namn) gn) 6.3.2 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR CM L Max lgd 40 O OU P OR CM L förnamnen väljas. För information om övriga förnamn se attributet "fullständigt namn". Identitetsnummer Attribut (LDAP-namn) födelsedatum (hsaPassportBirthDate) giltighetstid för pass (hsaPassportValidThru) Inera AB Beskrivning Version 4.5 Beskrivning Personens födelsedatum. Detta attribut ifylles endast om personen saknar personnummer och samordningsnummer. Giltighetstid för pass som anges i attributet "passnummer". Box 177 03 Östgötagatan 12 118 93 Stockholm Format Mult II Envärdes (0..1) (YYYYMM DD) TP (Datum) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Envärdes (0..1) Organisationsnummer 556559-4230 Beslutsregel/Teknisk beskrivning Detta attribut måste användas om personen inte har personnummer eller samordningsnummer. Om attributet fylls i ska personen vara identifierad med pass och attributen "passnummer" och "giltighetstid för pass" måste även fyllas i och attributet ”person-id” ska lämnas tomt. Attributformatet är text (YYYYMMDD) och inte datum. Detta attribut måste användas om personen inte har personnummer eller samordningsnummer. Om Sid 36/87 X X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 37 (87) Datum 2015-04-14 Attribut (LDAP-namn) passnummer (hsaPassportNumber) person-id (PersonalIdentityNumber) Inera AB Version 4.5 Beskrivning Format Mult Passnummer som används för att legitimera en person som saknar personnummer eller samordningsnummer. Detta ska inledas med den tvåställiga bokstavskoden för landet enligt ISO 3166. II II Anger personnummer eller samordningsnummer med sekelsiffror, d.v.s. tolv siffror. Box 177 03 Östgötagatan 12 118 93 Stockholm (YYYYMM DDXXXX) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning attributet används ska även attributen ”passnummer” och ”födelsedatum” fyllas i och attributet ”person-id” ska lämnas tomt. Ange 000000 (midnatt) som tidpunkt. Identitetshandlingen ska visas vid ett fysiskt möte med katalogadministratören. Max lgd Envärdes (0..1) Detta attribut måste användas om personen inte har personnummer eller samordningsnummer. Om attributet används ska även attributen ”giltighetstid för pass” och ”födelsedatum” fyllas i och attributet ”personid” ska lämnas tomt. Identitetshandlingen ska visas vid ett fysiskt möte med katalogadministratören. 40 X Envärdes enligt regel (0..1) Anges med sekelangivelse och utan streck. Observera att det inte finns någon godkänd 12 Obl Organisationsnummer 556559-4230 Sid 37/87 O OU P OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 38 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beskrivning Format Mult Uppgift i klartext om personens befattning enligt AIDetikett. 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. Man ska vara medveten om att det förekommer lokala variationer i kodningen av AIDetiketterna trots att det finns nationella anvisningar för KTOV Flervärdes (0..*) Beslutsregel/Teknisk beskrivning identitetshandling kopplat till samordningsnummer. Om personen saknar personnummer och samordningsnummer ska attributen "passnummer", "giltighetstid för pass" och "födelsedatum" fyllas i. I detta fall ska attributet "personid" lämnas tomt. Max lgd O OU P OR CM L Beslutsregel/Teknisk beskrivning Om ifylld måste attributet "befattningskod" vara ifylld. Max lgd 64 O OU P OR CM L 6.3.3 Personliga egenskaper Attribut (LDAP-namn) befattning (paTitleName) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Befattning Organisationsnummer 556559-4230 Sid 38/87 X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 39 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P Kod för personens befattning enligt AID-etikett. KTOV Flervärdes (0..*) Befattning Om ifylld måste attributet "befattning" vara ifylld. 64 X Personens chefskod enligt AID-ansvar. Kod anges. KTOV Envärdes enligt regel (0..1) Chefskod En andra position kan förekomma i denna kod, men den har ingen betydelse utanför den egna organisationen. 2 X Legitimerad yrkesgrupp, enligt Socialstyrelsens förteckning, som personen tillhör. KTOV Flervärdes (0..*) Legitimerade yrkesgrupp 64 X Flagga som anger om personen har skyddade personuppgifter. VÄ Envärdes (0..1) 2 X Klartext för specialistutbildning för läkare och tandläkare utöver grundutbildning enligt HOSP. KTOV Flervärdes (0..*) 64 X enhetlig kodning. befattningskod (paTitleCode) chefskod (hsaManagerCode) legitimerad yrkesgrupp (hsaTitle) skyddad person (hsaProtectedPerson) specialitet (specialityName) HOSP Om personen har skyddade personuppgifter skrivs "Ja" annars är fältet tomt. Vilket angivet värde som helst tolkas som ja. Informationen levereras till HSA från Socialstyrelsen i samband med HOSPsynkroniseringen (endast för personer med personnummer). Ibland är specialist- Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 39/87 OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 40 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Format Version 4.5 Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning benämningen densamma för olika utbildningar men sifferkoden olika. Det beror på olika utbildningsinnehåll och/eller tidsperiod för utbildningens genomförande. Observera därför att benämningarna på specialitet enbart blir unik tillsammans med specialitetskod. Max lgd O OU P Om ifylld måste attributet "specialitetskod" vara ifyllt. specialitetskod (specialityCode) Kod för specialistutbildning för läkare och tandläkare utöver grundutbildning enligt HOSP. KTOV Flervärdes (0..*) HOSP Koden kan vara två-, fyr- eller femställig beroende på utbildningsinnehåll och/eller tidsperiod för utbildningens genomförande. Informationen levereras till HSA från Socialstyrelsen i samband med HOSPsynkroniseringen (endast för personer Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 40/87 5 X OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 41 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning med personnummer). Observera att specialitetskod enbart blir unik tillsammans med attributet specialitet. Max lgd O OU P Om ifylld måste attributet "specialitet" vara ifyllt. språkkod (languageKnowledgeCode) titel Kod som anger språk som personen har tillräcklig kunskap i för att vid behov kunna stödja kommunikation. Detta ska dock inte ses som en ersättning för det arbete som en professionell tolk utför. Vad som anses vara tillräcklig språkkunskap är något som varje organisation själv får avgöra. KTOV Flervärdes (0..*) Personens yrkestitel i fritext. TXT Personen har svenskt personnummer, men ingen svensk folkbokföringsadress. Det kan t.ex. bero på att personen fått ett så kallat tilldelat personnummer eller att personen VÄ Envärdes enligt regel (0..1) Envärdes (title) saknar svensk folkbokföringsadress (hsaEmigratedPerson) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Språkkod (0..1) Organisationsnummer 556559-4230 3 X Förkortningar bör undvikas. 64 X Detta kontrolleras i samband med slagning mot folkbokföringen. Attributet kommer att användas av SITHS för att undvika att skapa 2 X Sid 41/87 OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 42 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd har utvandrat. Associationer En Person är anställd av/utför uppdrag åt en eller flera Enheter Beslutsregel/Teknisk beskrivning SITHS-kort med pinkoder som skickas till en icke-existerande folkbokföringsadress. Max lgd O OU P OR CM L Beslutsregel/Teknisk beskrivning Max lgd 40 O OU P OR CM L Beslutsregel 6.3.4 Förskrivarkod Attribut (LDAP-namn) Beskrivning Format Mult Kodverk/ Värdemängd förskrivarkod (personalPrescriptionCode) Kod som identifierar en förskrivare. II Envärdes (0..1) förskrivningsrätt för barnmorskor/ sjuksköterskor (hsaSosNursePrescriptionRight) Anger om personen har förskrivningsrätt som barnmorska eller sjuksköterska. VÄ Flervärdes (0..*) gruppförskrivarkod (hsaGroupPrescriptionCode) Personens lokalt tilldelade gruppförskrivarkod. E-hälsomyndigheten ansvarar för regelverk II Flervärdes (0..*) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 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. Sid 42/87 X 4 X 40 X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 43 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR CM L Beskrivning Format Mult Kodverk/ Värdemängd OU P OR CM L II Flervärdes (0..*) Max lgd 64 O SITHS-certifikatets serienummer. Beslutsregel/Teknisk beskrivning Informationen registreras av SITHS vid publicering av HCC. Det datum som SITHS-certifikatet är giltigt från och med. Datum Flervärdes (0..*) Informationen registreras av SITHS vid publicering av HCC. X Det datum som SITHS-certifikatet är giltigt till och med.” Datum Flervärdes (0..*) Informationen registreras av SITHS vid publicering av HCC. Endast HCC Person lagras i organisationsträdet. X kring detta. 6.4 SITHS kort- och certifikatsinformation 6.4.1 Certifikatsinformation Attribut (LDAP-namn) certifikatsnummer (serialNumber) giltigt fr.o.m. (validNotBefore) giltigt t.o.m. (validNotAfter) HCC Giltiga SITHS-certifikat. (TP) (TP) TXT (certifikat) (userCertificate) Associationer En Certifikat innehas av noll eller en Enhet Flervärdes (0..*) Beslutsregel En Certifikat innehas av noll eller en Person En Certifikat innehas av noll eller en Funktion Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 43/87 X X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 44 (87) Datum 2015-04-14 Version 4.5 6.4.2 Kortinformation Attribut (LDAP-namn) Beskrivning kortnummer Kortnummer för personens SITHS-kort. (cardNumber) mifareserienummer Mifareserienummer för SITHS-kortets mifareslinga. (hsaMifareSerialNumber) Format Mult II Flervärdes (0..*) II Flervärdes (0..*) (kortnummer@mif areserienummer) Kodverk/ Värdemängd Associationer En Kort innehas av en Person Beslutsregel/Teknisk beskrivning Informationen levereras av SITHS vid publicering av HCC. Max lgd 40 <Kortnummer>@<mifareserienu mmer> ( 19 tecken@10 tecken). Informationen leverer-as av SITHS vid publicering av HCC. 40 Beslutsregel/Teknisk beskrivning Attributet är reserverat för SITHS. Max lgd O OU P OR CM L OR CM L X X Beslutsregel 6.4.3 Spärrlistinformation Attribut (LDAP-namn) certifikatspärrlista (certificateRevocationList) Inera AB Beskrivning Spärrlista över icke giltiga certifikat. Box 177 03 Östgötagatan 12 118 93 Stockholm Format Mult TXT Flervärdes (0..*) (CRL) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Organisationsnummer 556559-4230 Sid 44/87 O OU X P INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 45 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR CM L Max lgd 256 O OU P OR CM L X X 64 X X 6.5 Organisationsuppgifter Attribut (LDAP-namn) Beskrivning Format Mult alternativ namnvisning Alternativt sätt att presentera enheters namn som innebär att man har möjlighet att aktivt välja ut vilka delar av en enhets fullständiga DN (i HSA-hierarkin) som ska visas. TXT Envärdes enligt regel (0..1) TXT Flervärdes (0..*) (displayOption) Kodverk/ Värdemängd Man kan t.ex. i ett visst visningsläge vilja visa endast nivån "Karolinska sjukhuset" och "onkologiska kliniken" men välja bort visning av övriga delar av enhetens DN (såsom t.ex. "onkologiska divisionen"). alternativt namn (ouShort) Inera AB Namn på en enhet som används vid sidan av det officiella enhetsnamnet. T.ex. en förkortning av det Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 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 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. Sid 45/87 X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 46 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Enhetens sifferkod hos Apoteket för att följa upp kostnader på läkemedel. Arbetsplatskod utfärdas av respektive landsting. II Flervärdes (0..*) Enhetens officiella namn. Exempel: Ortopediska mottagningen". I undantagsfall kan annat vedertaget enhetsnamn anges. TXT Envärdes enligt regel (1..1) 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. KTOV Flervärdes (0..*) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR De två första tecknen i koden är länskoden. 40 X X X 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. 64 Obl X 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ård- 64 X X 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". arbetsplatskod (unitPrescriptionCode) enhetsnamn (ou, organizationalUnitName) enhetstyp (hsaBusinessType) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Enhetstyp Organisationsnummer 556559-4230 Sid 46/87 X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 47 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult TXT Envärdes (0..1) Kodverk/ Värdemängd mottagningar och avdelningar. godkänd HPT för organisationen (hsaHpt) Dokumentnamn för organisationens godkända HSA Policytillämpning (HPT). Attributet fylls i av HSA Förvaltning. Beslutsregel/Teknisk beskrivning sökning. Max lgd O Skrivs enligt följande syntax: <Typ av HPT>;<Organisationens namn>;<Organisationens versionsnummer>;<HPTmallversion>. Exempel: "HPTA HSA Admin;Grönköpings kommun;v 2.0;Mall 3.6". 64 Obl 1024 X OU P OR Om organisationen är tredjepartsansluten till HSA via ett HSA-ombud ska syntaxen utformas på följande sätt: <Typ av HPT>;<HSA-ombudets organisationsnamn>;tredjepartsanslute n, t.ex. "HPTA HSA Admin;Kommunförbundet Skåne;tredjepartsansluten " information till patient (hsaVpwInformation4) Inera AB Informationstext till patienter, t.ex. ”Innan patientbesök ska enheten kontaktas via telefon” eller ”Infektionskänsliga patienter hänvisas till enhet X”. Box 177 03 Östgötagatan 12 118 93 Stockholm TXT Tel 08 452 71 60 [email protected] www.inera.se Envärdes enligt regel (0..1) Organisationsnummer 556559-4230 Sid 47/87 X X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 48 (87) Datum 2015-04-14 Attribut (LDAP-namn) logotyp (hsaJpegLogotype) mer om (hsaVpwInformation1) organisationsnamn (o, organizationName) organisationsnummer (orgNo) Inera AB Beskrivning Version 4.5 Format Mult Logotyp för organisationen eller enheten. DP Envärdes enligt regel (0..1) 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 Organisationens officiella namn. Exempel: ”Region Skåne”, ”Gotlands kommun”, ”Praktikertjänst AB”. I undantagsfall kan annat vedertaget organisationsnamn anges. Organisationsnummer enligt SCB/Bolagsverket. Exempel: ”802006-3023”. Enhet som pekas ut som vårdgivare måste ha detta attribut ifyllt. Box 177 03 Östgötagatan 12 118 93 Stockholm Max lgd 50kB O OU X X X Envärdes enligt regel (0..1) 1024 X X X TXT Envärdes enligt regel (1..1) 64 Obl II Envärdes enligt regel (0..1) 12 Obl (XXXXXXXXXX) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Logotypen får max vara 50kB. Sekelsiffran ”16” ska inte vara med. Organisationsnummer 556559-4230 Sid 48/87 X P X OR X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 49 (87) Datum 2015-04-14 Attribut (LDAP-namn) prisinformation (hsaVpwInformation3) relaterad enhet (hsaVpwNeighbouringObject) tillfällig information (hsaVpwInformation2) verksamhetschef (hsaHealthCareUnitManager) Inera AB Version 4.5 Beskrivning Format Mult Information om priser, t.ex. kostnader för besök hos distriktssköterska. TXT Envärdes enligt regel (0..1) HSA-id för relaterad enhet som bl.a. ska visas upp på enhetens kontaktkort på Vården på Webben. Beslutsregel/Teknisk beskrivning Flervärdes (0..*) 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. 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 2009-0622”. Vilka enheter som definieras som vårdenheter regleras på central nivå inom respektive vårdgivare. Box 177 03 Östgötagatan 12 118 93 Stockholm Kodverk/ Värdemängd TXT (;ÅÅÅÅM MDD;ÅÅ ÅÅMMD D;text) II (HSAid) Tel 08 452 71 60 [email protected] www.inera.se Envärdes enligt regel (0..1) 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. Envärdes enligt regel (0..1) Organisationsnummer 556559-4230 Sid 49/87 Max lgd 1024 O OU P OR X X X 64 X X X 1024 X X X 31 X X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 50 (87) Datum 2015-04-14 Version 4.5 Attribut (LDAP-namn) Beskrivning Format Mult vårdenhetens ingående enheter Attributet sätts på vårdenhet och pekar ut HSA-id 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 2009-06-22”. Vilka enheter som definieras som vårdenheter regleras på central nivå inom respektive vårdgivare. II Flervärdes (0..*) (hsaHealthCareUnitMember) vårdgivartillhörighet (hsaResponsibleHealthCareProvider) Inera AB Attributet sätts på vårdenhet och pekar ut HSA-id 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 2009-0622”. 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årdenheter. Box 177 03 Östgötagatan 12 118 93 Stockholm (HSAid) II (HSAid) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Envärdes (0..1) Organisationsnummer 556559-4230 Sid 50/87 Max lgd 31 O OU X X 31 X X P OR CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 51 (87) Datum 2015-04-14 Attribut (LDAP-namn) ägarform (management) Beskrivning Organisationens ägarform i klartext. Version 4.5 Format Mult KTOV Flervärdes (0..*) Associationer En Enhet har som anställd/uppdragstagare noll till flera Personer Kodverk/ Värdemängd Ägarform Beslutsregel/Teknisk beskrivning Max lgd 64 O OU X X Max lgd 64 O OU X X P OR CM L CM L X Beslutsregel 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ård- och omsorgsformer 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 6.6 Verksamhetstyp och vård- och omsorgsform Attribut (LDAP-namn) verksamhet (businessClassificationName) Inera AB Beskrivning Format Mult Typ av verksamhet som bedrivs. Klartext till attributet ”verksamhetskod”. Exempel: ”Tandvård”. KTOV Flervärdes (0..*) Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd 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 Organisationsnummer 556559-4230 Sid 51/87 P OR X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 52 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Format Version 4.5 Mult Kodverk/ Värdemängd 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. Max lgd O OU 40 X X P OR Om ifylld ska även attributet ”verksamhetskod” fyllas i. Observera att inte registrera verksamhetskoden på den överordnade enheten utan på de underordnade enheterna och funktionerna. verksamhetskod (businessClassificationCode) Kod för den typ av verksamhet som bedrivs. KTOV Flervärdes (0..*) Verksamhetskod 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 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 52/87 X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 53 (87) Datum 2015-04-14 Attribut (LDAP-namn) Vård- och omsorgsform (careType) Version 4.5 Beskrivning Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning verksamhet fyllas i. Observera att inte registrera verksamhetskoden på den överordnade enheten utan på de underordnade enheterna och funktionerna. Max lgd O OU Kod för den vård- och omsorgsform (öppen vård, sluten vård, hemsjukvård och Socialtjänst) som bedrivs, enligt definition i Socialstyrelsens termbank. Attributet är obligatoriskt för alla enheter och funktioner som bedriver vård och omsorg. KTOV Flervärdes (0..*) Vårdochomsorgsform Bör sättas på lägsta möjliga nivå i trädet för att undvika dubblering, som resulterar i felaktiga sökresultat. 64 X X Associationer En Verksamhetstyp och vård- och omsorgsform innehas av noll eller flera Enheter Beslutsregel En Verksamhetstyp och vård- och omsorgsform innehas av noll eller flera Funktioner 6.7 Medarbetaruppdrag 6.7.1 Medarbetaruppdrag (vårduppdrag) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 53/87 P OR X CM L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 54 (87) Datum 2015-04-14 Version 4.5 Attribut (LDAP-namn) Beskrivning Format Mult medarbetaruppdragets medlemmar HSA-id för de personer som kan använda medarbetaruppdraget (vårduppdraget) samt eventuellt startoch slutdatum. II Flervärdes (0..*) (hsaCommissionMember) (HSAid;(s tartdatum);(slu tdatum)) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Tidsangivelse för start- och slutdatum är frivillig. Om den anges ska den anges i GMT (Greenwich Mean Time). Max lgd 96 O OU P OR CM X Exempel fullständigt: SE2321000040-48HD; 20081112230000Z;2010051 5215959Z Exempel enbart startdatum: SE2321000040-48HD; 20081112230000Z; Exempel enbart slutdatum: SE2321000040-48HD;; 20100515215959Z Exempel utan datum: SE2321000040-48HD;; medarbetaruppdragets rättigheter (hsaCommissionRight) medarbetaruppdragets ändamål (hsaCommissionPurpose) Inera AB Kod för medarbetaruppdragets (vårduppdragets) rättigheter i form av aktivitet, informationstyp och organisationsomfång. KTOV Flervärdes (0..*) Medarbetaruppdrag rättigheter Anges i formatet ”<aktivitet>;<informationstyp>;<org anisationsomfång>”. 255 X Ändamål för användarens medarbetaruppdrag (vårduppdrag) angivet i klar- KTOV Envärdes (0..1) Medarbetaruppdrag ändamål Ändamål "Vård och behandling" får endast anges på medarbetaruppdrag (vårduppdrag) kopplade till en 64 X Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 54/87 L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 55 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Format Version 4.5 Mult Kodverk/ Värdemängd text. Attributet är framför allt kopplat till PDL:s krav på att ange ändamål vid åtkomst till vårddokumentation. Associationer Ett Medarbetaruppdrag, vårduppdrag, kan innehas av noll eller flera Personer Beslutsregel/Teknisk beskrivning vårdenhet. Max lgd O OU P OR CM L Beslutsregel/Teknisk beskrivning Max lgd O OU P OR AC L Beslutsregel 6.7.2 Medarbetaruppdrag (administrativa uppdrag) Attribut (LDAP-namn) Beskrivning domänområdeskod Domänområdeskod för de domänområden som tillhör det administrativa uppdraget. administrativa uppdragets medlemmar, andra uppdrag (hsaAdminCommissionMemberC) Inera AB HSA-id för andra administrativa uppdrag vars medlemmar (personer) har uppdraget samt eventuellt start- och slutdatum för hur länge uppdraget Box 177 03 Östgötagatan 12 118 93 Stockholm Format Mult II Flervärdes (0..*) Domänområdeskoden hämtas från HSA Tjänsteträds gren dc= HSA Domain. 64 X Flervärdes (0..*) Tidsangivelse för start- och slutdatum är frivillig. Om den anges ska den anges i GMT (Greenwich Mean Time). 96 X (<domänkod>;<id>) II (HSAid;(startd atum);(slutda tum)) Kodverk/ Värdemängd Exempel fullständigt: SE232100000011AA;20081112230000Z;20 Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 55/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 56 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Format Version 4.5 Mult Kodverk/ Värdemängd gäller. Beslutsregel/Teknisk beskrivning Max lgd O OU P OR AC 100515215959Z Exempel enbart startdatum: SE232100000011AA;20081112230000Z; Exempel enbart slutdatum: SE232100000011AA;;20100515215959Z Exempel utan datum: SE2321000000-11AA;; administrativa uppdragets medlemmar, personer (hsaAdminCommissionMemberP) HSA-id för de personer som har det administrativa uppdraget samt eventuellt startoch slutdatum för hur länge uppdraget gäller. II (HSAid;(startd atum);(slutda tum)) Flervärdes (0..*) Tidsangivelse för start- och slutdatum är frivillig. Om den anges ska den anges i GMT (Greenwich Mean Time). Exempel fullständigt: SE2321000040-48HD; 20081112230000Z;2010051 5215959Z Exempel enbart startdatum: SE2321000040-48HD; 20081112230000Z; Exempel enbart slutdatum: SE2321000040-48HD;; 20100515215959Z Exempel utan datum: SE2321000040-48HD;; Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 56/87 96 X L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 57 (87) Datum 2015-04-14 Version 4.5 Attribut (LDAP-namn) Beskrivning Format Mult administrativa uppdragets organisationsomfång HSA-id för de enheter som det administrativa uppdraget gäller för. Om en flagga anges för att enheten är en hierarkisk startpunkt så gäller uppdraget från denna enhet och nedåt i HSAstrukturen. II Flervärdes (0..*) (hsaAdminCommissionSector) uppdragsansvarig organisation, administrativa uppdrag (hsaAdminCommissionResponsibleOrganisation) uppdragsansvarig person, administrativa uppdrag (hsaAdminCommissionResponsiblePerson) HSA-id för den organisation som ansvarar för det administrativa uppdraget. HSA-id för den person som ansvarar för det administrativa uppdraget. HSAid(;sub) Box 177 03 Östgötagatan 12 118 93 Stockholm Beslutsregel/Teknisk beskrivning Max lgd O OU P OR AC Exempel då enbart en enhet utgör organisationsomfång: SE2321000000-11AB 35 X 31 X 31 X Exempel då en enhet och dess underliggande enheter utgör organisationsomfång: SE2321000000-11AB;sub II (HSAid) II (HSAid) Envärdes (0..1) Tel 08 452 71 60 [email protected] www.inera.se Den enhet som pekas ut som uppdragsansvarig organisation måste ha organisationsnummer ifyllt. Envärdes (0..1) Associationer Ett Medarbetaruppdrag, administrativt, kan innehas av noll eller flera Personer Inera AB Kodverk/ Värdemängd Beslutsregel Organisationsnummer 556559-4230 Sid 57/87 L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 58 (87) Datum 2015-04-14 Version 4.5 6.8 Objektinformation Attribut (LDAP-namn) alt-text (hsaAltText) beskrivning (description) Beskrivning Format Mult En beskrivande text för en 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. TXT Envärdes enligt regel (0..1) Kort beskrivning/förklaring av speciellt intresse. Exempel: ”Tillhör Region Skåne och Södra Sjukvårdsregionen.” TXT Envärdes enligt regel (0..1) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Ska endast innehålla information som får visas för objektet. 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. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 58/87 Max lgd O OU P OR 128 X X X X 1024 X X X X CM AC L X X X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 59 (87) Datum 2015-04-14 Attribut (LDAP-namn) bild (jpegPhoto) HSA-administratörens kommentar (hsaAdminComment) HSA-id (hsaIdentity) Version 4.5 Beskrivning Format Mult 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 Envärdes enligt regel (0..1) Administrativ kommentar t.ex. information om extern konsults löptid för avtal. TXT Obligatorisk, unik identifierare för personer, enheter, funktioner, uppdrag och organisationer i HSA. II (HSAid) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR Bilden får max vara 50kB. 50kB X X X X Envärdes (0..*) Attributet är endast synligt för HSAadministratörer inom det egna behörighetsområdet. 1024 X X X X X Envärdes (1..1) 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. 31 Obl Obl Obl Obl Obl Syntaxen är uppbyggd på följande sätt: SE<Katalogägarens organisationsnummer med 10 tecken>-<valfria bokstäver (A-Z och a-z) och siffror (0-9)>. Observera Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 59/87 CM AC L X Obl INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 60 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR CM AC Obl Obl Obl Obl X X L att tecknen å, ä, ö samt @-tecken inte är tillåtna. objektnamn (cn, commonName) pekare (seeAlso) slutdatum (endDate) startdatum (startDate) Inera AB Namn på personen, uppdraget eller funktionen. TXT Envärdes enligt regel (1..1) 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. II Flervärdes (0..*) DN till aktuellt objekt. Envärdes (0..1) Tidsangivelse i GMT (Greenwich Mean Time). Exempel: "20100514215959Z". Envärdes (0..1) Tidsangivelse i GMT (Greenwich Mean Time). Exempel: "20081112230000Z". Exempel: "Lars R Mjödberg Larsson". Hänvisning till annat objekt i katalogen. Eventuellt slutdatum då en enhet eller funktion upphör sin verksamhet eller då en person slutar sin anställning. Om inget slutdatum anges tolkas det som "tillsvidare". Startdatum då en enhet eller funktion startar sin verksamhet eller då en person börjar sin anställning. Box 177 03 Östgötagatan 12 118 93 Stockholm (DN) DT (Datum) DT (Datum) Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 60/87 64 X X X X X X X X X X X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 61 (87) Datum 2015-04-14 Attribut (LDAP-namn) visas för (hsaDestinationIndicator) Beskrivning Version 4.5 Format Mult KTOV Flervärdes (0..*) Anger vilka som får se information om aktuell person, enhet, organisation eller funktion. Kod anges. Associationer En Funktion hör till noll eller en geografisk indelning Kodverk/ Värdemängd Visas för Beslutsregel/Teknisk beskrivning Max lgd O OU P OR 2 X X X X Max lgd O OU P OR CM AC CM AC L Beslutsregel En Funktion är del av en och endast en Enhet En Funktion har noll eller flera Verksamhetstyp och noll eller flera vårdoch omsorgsform En Funktion innehar noll eller flera Certifikat En Funktion kontaktas via noll eller flera Adressuppgifter En Funktion kontaktas via noll eller flera Telefonnummer 6.9 Teknisk information Attribut (LDAP-namn) administratörsgrupp (groupMembership) Inera AB Beskrivning Pekare till administratörsgrupp som personen tillhör i HSA admingränssnitt. Box 177 03 Östgötagatan 12 118 93 Stockholm Format Mult DN Flervärdes (0..*) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Attributvärdet ändras endast via HSA admin. Exempel:”cn=DLL_L_adm,ou= D-data,o=Landstinget Sörmland,l=Sörmlands Organisationsnummer 556559-4230 Sid 61/87 X L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 62 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Format Version 4.5 Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR CM AC L län,c=SE" antal närmast underliggande objekt Antal närmast underliggande objekt. KV Envärdes (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 X Totalt antal underliggande objekt. KV Envärdes (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 X (numSubordinates) antal underliggande objekt (numAllSubordinates) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 62/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 63 (87) Datum 2015-04-14 Version 4.5 Attribut (LDAP-namn) Beskrivning Format Mult domäninloggningsnamn Inloggningsnamn i ADdomän som skrivs in i SITHS-certifikatet. KOM Envärdes (0..1) Skapas i ”lokal katalog” eller hämtas från AD (motsv.). Attributet kan ha formatet: ”<hsaid>@<domain>.se” . Anger konfigurationsparametrar som bl.a. används för konfigurering av delegeringsmodellen i HSA admingränssnitt. Flervärdes (0..*) Attributet ska endast användas för särskild programvara, t.ex. HSA admingränssnitt. 32768 Attribut som bl.a. används för konfigurering av delegeringsmodellen i HSA admingränssnitt. Envärdes (0..1) Attributet ska endast användas för särskild programvara, t.ex. HSA admingränssnitt. 2024 Attribut som används av HSA admingränssnitt för att lagra konfigurationsdata. Envärdes (0..1) Lösenord för administratör av HSA. Envärdes (0..1) (userPrincipalName) HSA admin administratörskonfiguration (cybConfigurationParameter) HSA admin administratörskonfigurationsnamn (cybConfigurationNodeName) HSA admin formulärkonfiguration (tabXMLConfig) HSA användarlösenord (userPassword) HSA autentiseringsmetod Inera AB Anger om kortinloggning krävs mot HSAadmingränssnitt. Box 177 03 Östgötagatan 12 118 93 Stockholm VÄ Envärdes (0..1) Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU Organisationsnummer 556559-4230 Sid 63/87 OR X 128 (octet) Om värde saknas krävs kortinloggning mot HSA admingränssnitt. Om P 1 X X X X CM AC L INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 64 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Format Version 4.5 Mult (hsaAuthenticationMethod) HSA enkel sökning (hsaSimpleSearch) HSA fonetisk sökning (hsaPhoneticSearch) HSA-id-prefix (hsaIdPrefix) HSA-id-räknare (hsaIdCounter) individuell egenskap för it-tjänster (hsaSystemRole) Inera AB Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR CM AC L värde ("1") är angivet tillåts även lösenordsinloggning. Attributvärden som används vid förenklad sökning. Fonetiska attributvärden som används vid förenklad fonetisk sökning. TXT Flervärdes (0..*) Varje attributvärde lagras i separata instanser. 1024 X Obl Obl Obl TXT Flervärdes (0..*) Attributvärden som finns i attributet "HSA enkel sökning" kan läggas in i detta attribut med hjälp av en fonetiseringsalgoritm. 1024 X Obl Obl Obl Anger vilket HSA-idprefix som ska användas när objekt skapas. VÄ Envärdes (0..1) 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 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 Systemid tilldelas av HSA förvaltning. 64 Räknare som används för att skapa unika HSA-id:n. Beskriver en tilldelad individuell egenskap för person eller funktion i ett visst system (systemid;roll) VÄ Flervärdes (0..*) Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 64/87 X X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 65 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU P OR CM AC 40 X X X X X X X X X X X X L utan koppling till organisation. internt synkroniseringsid (hsaSyncId) Internt attribut som kan användas för synkronisering av objekt mellan intern katalog och HSA. II Flervärdes (0..*) Formatet regleras i den lokala organisationen. medlem i administratörsgrupp (uniqueMember) Pekare till person som ingår i administratörsgrupp. Personen får de administratörsrättigheter som administratörsgruppen är tilldelad, gäller oftast den enhet administratörsgruppen är placerad under med underliggande objekt. Information om tidpunkt för senaste förändring. II Flervärdes (1..*) Exempel: "cn=Maria Larsson, ou=Systemavdelningen,o =Landstinget Sörmland, l=Sörmlands län,c=SE". TP Envärdes (0..1) 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: "20081112141347Z". senaste förändringstidpunkt (modifyTimeStamp) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm (Datum) Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 65/87 X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 66 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult O OU P OR CM AC L II Envärdes (0..1) X X X X X X X Envärdes (0..1) X X X X X X X X X 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. skapad av (creatorsName) DN för objekt (användare) som skapat objektet. Kan vara en administratör eller ett system. skapandetidpunkt (createTimeStamp) Information om tidpunkt för skapandet av objektet. (Datum) Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Inera AB (DN) II (DN) TP Envärdes (0..1) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Operativt attribut som skapas med automatik av databasen. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: "20081112141347Z". Organisationsnummer 556559-4230 Sid 66/87 Max lgd INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 67 (87) Datum 2015-04-14 Version 4.5 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 7.1.1 Geografisk information Geografisk indelning Attribut (LDAP-namn) land Beskrivning Landets tvåställiga bokstavsbeteckning enligt ISO 3166 om annat än Sverige. (c, Format Mult KTOV Envärdes (0..1) Kodverk/ Värdemängd Beslutsregel/Teknisk kommentar Anges med 2 bokstäver enligt ISO 3166. Max lgd 2 O OU OR X X X Beslutsregel/Teknisk beskrivning Max lgd O OU OR Attributet fylls endast i om e-postadressen ska finnas i certifikatet för att t.ex. använda krypterad och/eller signerad e-post till funkt- 255 X X X DC countryName) Associationer En Geografisk indelning indelar noll till flera Funktioner Beslutsregel En Geografisk indelning indelar noll till flera Enheter 7.2 Internetuppgifter Attribut (LDAP-namn) e-postadress (mail, Beskrivning Funktionens e-postadress, oftast en funktionsbrevlåda. Format Mult KOM Envärdes enligt regel (0..1) (e-post) Kodverk/ Värdemängd rfc822Mailbox) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 67/87 DC INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 68 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU OR DC Beslutsregel/Teknisk beskrivning Observera att SITHS i dagsläget inte använder detta attribut i HSA. Certifikatsmottagare anges på SITHS beställningsblankett för funktionscertifikat. Max lgd 128 O OU OR DC 64 ionen. Associationer En Internetuppgift är kontaktuppgift till noll till flera Enheter Beslutsregel En Internetuppgift är kontaktuppgift till noll till flera Funktioner 7.3 SITHS Certifikatsinformation Attribut (LDAP-namn) certifikatsmottagare (hsaCertificateRecipient) certifikatsnummer (serialNumber) giltigt fr om (validNotBefore) giltigt tom (validNotAfter) HCC Beskrivning Format Mult HSA-id för den som är utpekad mottagare av certifikat för funktionen. II Flervärdes (0..*) SITHS-certifikatets serienummer. II Flervärdes (0..*) Informationen registreras av SITHS vid skapande av HCC och tas bort vid spärr av HCC. Det datum som SITHScertifikatet är giltigt från och med. Det datum som SITHScertifikatet är giltigt till och med. Giltiga SITHS-certifikat. Datum (TP) Flervärdes (0..*) Datum (TP) Flervärdes (0..*) TXT Flervärdes (0..*) Informationen registreras av SITHS vid skapande av HCC och tas bort vid spärr av HCC. Informationen registreras av SITHS vid skapande av HCC och tas bort vid spärr av HCC. SITHS-certifikat av typen HCC Funktion. Informationen registreras av SITHS vid skapande (certifikat) (userCertificate) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd Organisationsnummer 556559-4230 Sid 68/87 X X X X X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 69 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Associationer En Certifikat innehas av noll eller en Funktion 7.4 Beslutsregel/Teknisk beskrivning av HCC och tas bort vid spärr av HCC. Max lgd O OU OR DC Beslutsregel/Teknisk beskrivning Max lgd 64 O OU OR DC Obl X 64 Obl 12 Obl Beslutsregel Enhetsinformation Attribut (LDAP-namn) enhetsnamn (ou, organizationalUnitName) organisationsnamn (o, organizationName) organisationsnummer (orgNo) Kodverk/ Värdemängd Beskrivning Format Mult Kan vara enhetens namn eller namnet på en gruppering av funktioner. Exempel: "e-recept". TXT Envärdes enligt regel (1..1) I tjänsteträdet anges organisationsnamn utan å, ä, ö, och mellanslag. Exempel: o=”Region_Skane”. TXT Envärdes enligt regel (1..1) II Envärdes enligt regel (0..1) Organisationsnummer enligt SCB/Bolagsverket. Exempel: 802006-3023 (XXXXXXXXXX) Associationer En Enhet består av noll eller flera Enheter Kodverk/ Värdemängd Rekommendationen är att skriva in hela enhetsnamnet istället för en förkortning. Enbart ett enhetsnamn får anges i HSA. Endast engelska alfabetet (a-z), siffror (09) samt bindestreck (-) och understreck (_) får användas. Sekelsiffran ”16” ska inte vara med. Beslutsregel En Enhet hör till noll eller en Geografisk indelning Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 69/87 X X X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 70 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Version 4.5 Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU OR DC Beskrivning Format Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning O OU OR DC HSA-id för den som ansvarar för funktionen. II Flervärdes (0..*) Om den ansvariga personen inte finns i organisationen och inte har HSA-id kan namn- och kontaktuppgifter skrivas in i ”HSAadministratörens kommentar”. Max lgd 128 Kort beskrivning/förklaring av speciellt intresse. TXT Envärdes enligt regel (0..1) Ska endast innehålla information som får visas för objektet. På onivå ska organisationens vedertagna namn skrivas, t ex ”Region Östergötland”. För funktioner kan systemtyp anges och vad den används till. 1024 X X X Obligatorisk, unik identifierare för personer, enheter, funktioner och organisationer i HSA. II Envärdes (1..1) Se beskrivning av HSA-id i dokumentet ”RIV Informationsspecifikation HSA Struktur och innehåll”. 31 Obl Obl Obl En Enhet består av noll eller flera Funktioner 7.5 Objektinformation Attribut (LDAP-namn) ansvarig person (hsaResponsiblePerson) beskrivning (description) HSA-id (hsaIdentity) (HSAid) Syntaxen är uppbyggd på följande sätt: SE<Katalogägarens organisationsnummer med 10 tecken><valfria bokstäver (A-Z och a-z) och siffror (0-9)>. Observera att tecknen å, ä, ö samt @-tecken Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 70/87 X X INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 71 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Format Version 4.5 Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU OR 1024 X X X inte är tillåtna. HSA-administratörens kommentar (hsaAdminComment) objektnamn Administrativ kommentar, t.ex. namn- och kontaktinformation till ansvarig person som inte finns i HSA. TXT Envärdes (0..1) Funktionens namn. TXT Envärdes enligt regel (1..1) (cn, Attributet är endast synligt för HSA-administratörer inom det egna behörighetsområdet. URI/DNS-namn för tjänsten registreras alltid i attributets objektnamn om SITHS-certifikat ska skapas, ex ”cn=dsedix.ds.sll.se”. commonName) 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 organisationen som äger domännamnet och organisationen där objektnamnet finns. slutdatum (endDate) startdatum (startDate) Inera AB Eventuellt slutdatum då en enhet eller funktion upphör sin verksamhet. Om inget slutdatum anges tolkas det som "tillsvidare". Startdatum då en enhet eller funktion startar sin verksamhet eller då en person börjar sin anställ- Box 177 03 Östgötagatan 12 118 93 Stockholm DT (Datum) DT (Datum) Tel 08 452 71 60 [email protected] www.inera.se Envärdes (0..1) Tidsangivelse I GMT (Greenwich Mean Time). Exempel: “20081112141347Z”. X X X Envärdes (0..1) Tidsangivelse I GMT (Greenwich Mean Time). Exempel: “20081112141347Z”. X X X Organisationsnummer 556559-4230 Sid 71/87 DC INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 72 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning Format Version 4.5 Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd O OU OR DC Max lgd X O OU OR DC X X X X X X X X X ning. Associationer En Funktion hör till noll eller en geografisk indelning Beslutsregel En Funktion är del av en och endast en Enhet En Funktion innehar noll eller flera Certifikat 7.6 Teknisk information Attribut (LDAP-namn) antal närmast underliggande objekt Beskrivning Format Mult Antal närmast underliggande objekt. KV Envärdes (1..1) Totalt antal underliggande objekt. KV Envärdes (1..1) (numSubordinates) antal underliggande objekt (numAllSubordinates) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Kodverk/ Värdemängd 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. Organisationsnummer 556559-4230 Sid 72/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 73 (87) Datum 2015-04-14 Attribut (LDAP-namn) Version 4.5 Beskrivning Format Mult nodnamn (dc, domainComponent) Namn på nod i HSA Tjänsteträd (DomainComponent, DC). Exempel: Nod 1, Uppdragsmallar, Koder. TXT Envärdes (1..1) HSA användarlösenord (userPassword) Lösenord för systemanvändare av HSA. HSA-id-prefix (hsaIdPrefix) Anger vilket HSA-idprefix som ska användas när objekt skapas. HSA-id-räknare (hsaIdCounter) Räknare som används för att skapa unika HSA-id:n. medlem i administratörsgrupp (uniqueMember) Pekare till person som ingår i administratörsgrupp. Personen får de administratörsrättigheter som administratörsgruppen är tilldelad, gäller oftast den enhet som administra- Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning O 128 (Oct et) 0..1 40 X 0..* 40 X Tel 08 452 71 60 [email protected] www.inera.se Flervärdes (1..*) OR X (SEXXXXX XXXXX-) II OU DC Obl Envärdes (0..1) VÄ Max lgd Exempel: "cn=Maria Larsson,ou=Systemavdelningen,o=Land stinget Sörmland,l=Sörmlands län,c=SE". Organisationsnummer 556559-4230 Sid 73/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 74 (87) Datum 2015-04-14 Attribut (LDAP-namn) Beskrivning senaste förändringstidpunkt (modifyTimeStamp) törsgruppen är placerad under med underliggande objekt. Information om tidpunkt för senaste förändring. senast ändrad av modifiersName) DN för objekt (användare) som senast förändrade objektet. Kan vara en administratör eller ett system. skapad av (creatorsName) DN för objekt (användare) som skapat objektet. Kan vara en administratör eller ett system. skapandetidpunkt (createTimeStamp) Information om tidpunkt för skapandet av objektet. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Version 4.5 Format Mult TP Envärdes (0..1) (Datum) II (DN) II (DN) TP (Datum) Tel 08 452 71 60 [email protected] www.inera.se O OU OR DC X X X X Envärdes (0..1) X X X X Envärdes (0..1) X X X X X X X X Envärdes (0..1) Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning 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: "20081112141347Z". Operativt attribut som skapas med automatik av databasen. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: "20081112141347Z". Organisationsnummer 556559-4230 Sid 74/87 Max lgd INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 75 (87) Datum 2015-04-14 Version 4.5 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: 1.2.752.129.2.2.1.4 Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: HSA Förvaltningsgrupp OID-ägare: SKL Länk: www.inera.se Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Revideringsprocess: Revideras i samband med att källkodverket uppdateras. Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 75/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 76 (87) Datum 2015-04-14 Version 4.5 Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Chefskod Beskriver vilken chefsbefattning en person har. Värdemängden reglerar innehållet i attributet ”chefskod”, hsaManagerCode. Chefskoder, en delmängd som beskriver chefs-, annat lednings- och funktions-/ämnesansvar i förteckningen ”Arbetsidentifikation kommuner och landsting (AID)”. Förteckningen ”Arbetsidentifikation kommuner och landsting (AID)”. HSA Förvaltningsgrupp OID: 1.2.752.129.2.2.1.11 Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: HSA Förvaltningsgrupp OID-ägare: SKL Länk: www.inera.se Används för att visa om en organisation, enhet eller funktion kan klassas som en viss typ av enhet. Denna värdemängd innehåller olika typer av enheter, t ex "sjukhus" eller "vårdcentral". HSA OID: 1.2.752.129.2.2.1.12 Revideringsprocess: Revideras i samband med att källkodverket uppdateras. Ägare/Förvaltare: HSA Förvaltningsgrupp OID-ägare: SKL Länk: www.inera.se Enhetstyp HSA Förvaltningsgrupp Revideringsprocess: På HSA Förvaltningsgrupps initiativ eller då önskemål om ändring inkommer. Kommunkod Inera AB Reglerar innehållet i attributen ”kommunnamn”, municipalityName, och ”kommunkod”, municipalityCode. Denna värdemängd innehåller Sveriges kommuner i kodordning. Källa är SCB:s förteckning över Sveriges kommuner. SCB De två första siffrorna i kommunkoden utgörs av länskoden. Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se OID: 1.2.752.129.2.2.1.17 Ägare/Förvaltare: SCB OID-ägare: SKL Länk: www.inera.se Revideringsprocess: Revideras av HSA i samband med att källkodverket uppdateras. Organisationsnummer 556559-4230 Sid 76/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 77 (87) Datum 2015-04-14 Version 4.5 Namn Syfte Innehåll Källa Legitimerad yrkesgrupp Anger vilken, av Socialstyrelsen, legitimerad yrkesgrupp personen tillhör. Reglerar innehållet i attributet ”legitimerad yrkesgrupp”, HSAtitle. Denna värdemängd innehåller de legitimerade yrkesgrupperna enligt SFS. Reglerar innehållet i attributen länsnamn, localityName, och länskod, countyCode. 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. Länskod Fastställd av OID OID-ägare OID: Saknas (Tillfällig OID finns för teknisk lagring i HSA) OID-ägare: Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: Länk: www.inera.se Revideringsprocess: Revideras av HSA i samband med att källkodverket uppdateras. OID: 1.2.752.129.2.2.1.18 Ägare/Förvaltare: SCB OID-ägare: SKL Länk: www.inera.se 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 Ägare/Förvaltare: Ej fastställt OID-ägare: Länk: www.inera.se Revideringsprocess: Oklart Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 77/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 78 (87) Datum 2015-04-14 Version 4.5 Namn Syfte Innehåll Källa Medarbetaruppdrag ändamål Anger ändamål då ett visst medarbetaruppdrag används. Denna värdemängd innehåller ändamål för medarbetaruppdrag. HSA Fastställd av OID OID-ägare OID: Saknas OID-ägare: Ägare/Förvaltare Länk Revideringsprocess Ägare/Förvaltare: Ej fastställt Länk: www.inera.se Revideringsprocess: Oklart Språkkod Inera AB Används för att tala om vilket språk som personen har kunskap i. 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 6392:2005 (med engelska språkbenämningar), översatt till svenska och kompletterad med det nationella minoritetsspråket Tornedalsfinska. Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se SIS: SS-ISO 6391:2005, 639-2:2005, 639-3:2007 HSA Förvaltningsgrupp Regeringens proposition 1998/99:143 ”Nationella minoriteter i Sverige” som antogs av riksdagen i december 1999 (bet. 1999/200:KU6, rskr.1999/2000:69). Organisationsnummer 556559-4230 OID: 1.2.752.129.2.2.1.9 OID-ägare: SKL Ägare/Förvaltare: Länk: www.inera.se Revideringsprocess: Revideras av HSA i samband med att källorna uppdateras. Sid 78/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 79 (87) Datum 2015-04-14 Version 4.5 Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Ägare/Förvaltare Länk Revideringsprocess 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”, businessClassificationName 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: 1.2.752.129.2.2.1.3 Ägare/Förvaltare: HSA Förvaltningsgrupp OID-ägare: SKL. Länk: www.inera.se 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. Visas för Inera AB Revideringsprocess: På HSA Förvaltningsgruppens initiativ eller då önskemål om ändring inkommer. Box 177 03 Östgötagatan 12 118 93 Stockholm 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: www.inera.se Revideringsprocess: På HSA Förvaltningsgruppens initiativ eller då önskemål inkommer. Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 79/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 80 (87) Datum 2015-04-14 Version 4.5 Namn Syfte Innehåll Källa Fastställd av OID OID-ägare Ägare/Förvaltare Länk Revideringsprocess Vård- och omsorgsform Används för att särskilja på olika typer av vård- och omsorgsformer. Reglerar innehållet i attributet ”vård- och omsorgsform”, careType. Denna värdemängd innehåller förteckning över olika vård- och omsorgsformer, t.ex. öppenvård och slutenvård. Utvecklad inom HSA. HSA Förvaltningsgrupp OID: 1.2.752.129.2.2.1.13 OID-ägare: SKL Ägare/Förvaltare: HSA Förvaltningsgrupp 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 ägarformer, t.ex. landsting/Region, kommun, privat etc. Ägarform Utvecklad inom HSA. HSA Förvaltningsgrupp Länk: www.inera.se OID: 1.2.752.129.2.2.1.14 Revideringsprocess: På HSA Förvaltningsgruppens initiativ eller då önskemål om ändring inkommer. Ägare/Förvaltare: HSA Förvaltningsgrupp OID-ägare: SKL Länk: www.inera.se Revideringsprocess: På HSA Förvaltningsgruppens initiativ eller då önskemål om inkommer. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 80/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 81 (87) Datum 2015-04-14 Version 4.5 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. 8.2.1 Å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. 8.2.2 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 5.2.1. 8.2.3 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 5.2.1. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 81/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 82 (87) Datum 2015-04-14 Version 4.5 9 Termer och definitioner Termer som används inom HSA finns beskrivna i HSA Begrepp och definitioner [4]. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 82/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 83 (87) Datum 2015-04-14 Version 4.5 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 http://en.wikipedia.org/wiki/ISO_8601. 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 Sant/Falskt/ Tomt Sant/Falskt S/F/T BL Boolean Kan antingen vara sant, falskt eller ”tomt”. S/F BN Kan antingen vara sant eller falskt. KTOV CD Boolean not null Coded value Kodat värde med text och OID Instans identifierare II II Engelsk benämning enligt ISO Instance Identifier Förklaring Identifiering av berört kodverk/klassifikation (genom s.k. OID) samt aktuell kod och text Exempel: ” A00.9 Kolera, ospecificerat OID för KSH97 v97 mycket allvarlig kolera ” kod text kodverk K TX OID version förtydligande TX TX 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 kodverk Datapaket Inera AB DP ED Encapsulated data Box 177 03 Östgötagatan 12 118 93 Stockholm aktuellt kodvärde klartext identifierng av berört kodverk/ klassifikation kodverkets version används t ex vid förtydligande av kod ”Övrigt” CV OID aktuellt kodvärde identifierng av berört kodverk/klassifikation 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) Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 83/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 84 (87) Datum 2015-04-14 Svensk benämning på datatyp Värde Förkortning Datatyp enligt ISO Version 4.5 Engelsk benämning enligt ISO VÄ Förklaring Uttrycker värdets datatyp och sort värde värdetyp enhet Kvantitet KV PQ Flertal FLT<x> SET<x> Fritext TXT ST Tele- och datakommunikation KOM TEL/HL7 Datum DT Date Tidpunkt TP TS Tidsintervall IVL ITV<TS> Kodat värde Text aktuellt värde värdetsdatatyp värdets enhet Physical Quantity Uttrycker mängd och sort som resultat av en mätning. Exempel: ”10 kg” Set Uttrycker ett flertal/upprepningar av angiven datatyp Exempel. FLT<DT> 20060915 20061001 20061105 Simple Text Fritext TEL/HL7 Beskriver telekommunikationsadresser t.ex. telefonnummer, fax och e-post. Möjlighet till fritext Date Angivelse av datum. Formatet är ÅÅÅÅMMDD. Det är tillåtet att ange ”datum” med lägre precision, d.v.s. månad eller år. Datatypen kallas fortfarande ”datum”. Formatet är ÅÅÅÅMM respektive ÅÅÅÅ Exempel: 20060713 Point in Time 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, d.v.s. minut eller timme. Formatet är hhmm respektive hh. Exempel: ÅÅÅÅ-MM-DDThh:mm eller ÅÅÅÅ-MMDDThh Detta format är enligt ISO8601. För ytterligare behov av datatyper för tidpunkter – kontakta RIVförvaltningsgrupp. Time interval 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 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 84/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 85 (87) Datum 2015-04-14 Svensk benämning på datatyp Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO Version 4.5 Förklaring uppgifter inom [ ] är valfria. Av de första 3 krävs två separata värden åtskilda av ”/”. Exempel: 1. 2002-03-01T13:00:00Z/2003-05-11T15:30:00Z 2. 2002-03-01T13:00:00Z/P1Y2M10DT2H30M 3. P1Y2M10DT2H30M/2003-05-11T15:30:00Z 4. PT2H31M26.34S, d.v.s. 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 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 85/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 86 (87) Datum 2015-04-14 Version 4.5 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)” http://www.carelink.se/utvecklingsarbete/vardinformation/tis/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 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 86/87 INFORMATIONSSPECIFIKATION HSA Struktur och innehåll 87 (87) Datum 2015-04-14 Version 4.5 Referenser och förkortningar I RIV Metodanvisningar finns en fullständig referenslista avseende metoden. Referenser och förkortningar relevanta för HSA återfinns i dokumentet HSA-policy [3]. [1] [2] [3] [4] [5] Inera AB HSA-schema organisationsträdet version 4.5 2015-04-14.xls. www.inera.se/hsa HSA-schema tjänsteträdet version 4.5 2015-04-14.xls. www.inera.se/hsa HSA-policy www.inera.se/hsa HSA Begrepp och definitioner www.inera.se/hsa Administrativa uppdrag version 1.0 Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 [email protected] www.inera.se Organisationsnummer 556559-4230 Sid 87/87
© Copyright 2024