HSA-schema tjänsteträdet Version 4.5 2015-04-14 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Senast ändrad 2015-04-14 Innehåll Revisionshistorik ........................................................................................................................ 3 1 2 Inledning ................................................................................................................................ 4 1.1 Tabellen ........................................................................................................................... 4 1.2 Regional information ........................................................................................................ 5 1.3 Övrig information .............................................................................................................. 5 1.3.1 Information från överliggande objekt ........................................................................ 5 1.3.2 Språk ......................................................................................................................... 5 1.3.3 Rekommendationer kring tecken i objektsnamn ....................................................... 6 1.3.4 Rekommendationer kring tecken i attributvärden ..................................................... 6 Attribut i HSA Tjänsteträd .................................................................................................... 7 2.1 Geografisk information ..................................................................................................... 7 2.1.1 Geografisk indelning ................................................................................................. 7 2.2 Internetuppgifter ............................................................................................................... 7 2.3 SITHS Certifikatsinformation............................................................................................ 8 2.4 Enhetsinformation ............................................................................................................ 9 2.5 Objektinformation ........................................................................................................... 10 2.6 Teknisk information ........................................................................................................ 13 3 Syntax .................................................................................................................................. 17 4 Förklaring till Format och Multiplicitet.............................................................................. 18 Referenser .................................................................................................................................. 21 Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 2/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Senast ändrad 2015-04-14 Revisionshistorik I revisionshistoriken nedan redogörs för de ändringar som skett i denna version av HSAschemat. För information om tidigare versioners ändringar se aktuell version av detta dokument. Revisionshistoriken redogör även för ändringar av teknisk information som specificeras i motsvarande exceldokument [1]. Version Datum 4.2 2013-10-22 4.3 2014-04-29 4.4 2014-10-21 4.5 2015-04-14 Inera AB Status Fastställd i HSA Förvaltningsgrupp med följande ändringar: Införande av två nya grenar i HSA Tjänsteträd, se motsvarande excelark för information om attribut i dessa grenar: - ”Certifier” (dc=Certifier), för hantering av HOSP-kontroll för personer som inte finns i HSA (berör intygstjänster) - ”HSA Domain” (dc=HSA Domain), för hantering av domäner och domänområden för administrativa uppdrag Borttag av attributet ”fakturaadress” I HOSP-grenen (dc=HOSP) har attributet ”beskrivning”, description, lyfts fram eftersom det anger tidpunkt då HOSP senast uppdaterades med uppgifter ifrån Socialstyrelsen. Fastställd i HSA Förvaltningsgrupp med följande ändringar: Förtydligande av syntax för attributet ”HSA-id” Förtydligande av innehållsbekrivning för attributet ”slutdatum” Fastställd i HSA förvaltningsgrupp med följande ändringar: Tillägg av attributet HOSP-id, hospIdentityNumber, i dc=HOSP Förtydligad teknisk beskrivning för attributet ”förskrivarkod”, personalPrescriptionCode, i dc=Koder Se motsvarande excelark för information om dessa båda ändringar i dc=HOSP Fastställd av HSA Förvaltningsgrupp med följande ändringar: Justerad innehållsbeskrivning och teknisk kommentar för attributen ”HSA användarlösenord”, ”ansvarig person”, ”certifikatsmottagare”, ”enhetsnamn” och ”epostadress” Justerad innehållsbeskrivning för attributet ”HSAadministratörens kommentar” Ändrad svensk attributbenämning, innehållsbeskrivning och teknisk kommentar för atttributet ”medlem i administratörsgrupp” Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 3/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Version Datum Senast ändrad 2015-04-14 Status Förtydligand teknisk kommentar för attributen ”certifikatsnummer”, ”giltigt fr.o.m.”, ”giltigt t.o.m.” samt ”HCC” Borttag av attributen ”länskod” och ”länsnamn” i HSA Tjänsteträd Ändrat svenskt attributbenämning och innehållsbeskrivning för attributet domainComponent, dc ”nodnamn” Justerad teknisk beskrivning för attributet ”beskrivning” 1 Inledning Detta dokument är en fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll [2] och beskriver objekt och attribut i HSA Tjänsteträd. Alla objekt och attribut som presenteras i HSA Tjänsteträd måste följa de anvisningar som beskrivs i detta dokument. 1.1 Tabellen Kolumnerna i tabellerna på nästföljande sidor har följande innebörd: Attribut Det svenska namnet på attributen följt av attributets LDAP-namn. I de fall synonymer används för LDAP-namnet står även dessa med. Beskrivning Innehållsmässig beskrivning av attributet. Format Beskriver hur innehållet ska vara formaterat enligt RIV. För ytterligare information om format hänvisas till en beskrivning sist i dokumentet. I några fall anges format även direkt i fältet. Mult Anger multiplicitet för attributet, dvs. antal möjliga förekomster av attributet. Attribut i HSA kan antingen vara envärdes- eller flervärdesattribut. Envärdesattribut innebär att attributet endast kan ha ett värde för en viss instans av ett objekt. Flervärdesattribut kan däremot ha flera värden. Mer information om RIV-angivelse av detta finns i slutet av detta dokument. Kodverk/ Värdemängd Anger namn på kodverket/värdemängden som innehåller tillåtna värden för attributet. Beslutsregel/ Teknisk beskrivning Teknisk beskrivning av och eventuella kommentarer till attributen. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 4/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Senast ändrad 2015-04-14 Max lgd Maximal teckenlängd i HSA för attributet. Detta är i de flesta fall ingen katalogteknisk begränsning utan en överenskommelse inom HSA för att underlätta användning av attribut inom andra områden. Org Ett kryss i denna kolumn anger att attributet används för objektklassen Organization. Om ”Obl” är angivet istället för ett kryss innebär detta att attributet är obligatoriskt för objektklassen, dvs. attributet ska ha innehåll. OrgUnit Ett kryss i denna kolumn anger att attributet används för objektklassen OrganizationalUnit. Om ”Obl” är angivet istället för ett kryss innebär detta att attributet är obligatoriskt för objektklassen, dvs. attributet ska ha innehåll. OrgRole Ett kryss i denna kolumn anger att attributet används för objektklassen OrganizationalRole (Funktion). Om ”Obl” är angivet istället för ett kryss innebär detta att attributet är obligatoriskt för objektklassen, dvs. attributet ska ha innehåll. DC DomainComponent, DC, består av två nivåer. Den första nivån, Services, innehåller ingen annan information än själva namnet. Den andra nivån av DomainComponent kallas Nod X. Ett kryss i kolumnen DC anger att attributet används för den andra nivån av objektklassen DomainComponent. Om ”Obl” är angivet istället för ett kryss innebär detta att attributet är obligatoriskt för objektklassen, dvs. attributet ska ha innehåll. 1.2 Regional information Det är tillåtet att lagra information i den egna delen av HSA som inte finns specificerad i detta dokument. Detta kan till exempel vara intressant för regiongemensamma ändamål. Vad man då bör vara uppmärksam på är att om man använder generella attribut och objekt ur LDAP/X.500standarden löper man risken att dessa i ett senare skede blir formellt definierade i HSA och man blir då tvungen att anpassa sig. Dessutom finns vissa standardattribut som används på icke standardmässigt sätt i HSA. Det rekommenderas att man istället använder egna attribut med egna namn, lämpligen inledda med något eget prefix, och egna OID:er. Inom HSA har varje organisation möjlighet att få en egen OID-serie för dessa attribut. Dessa beskrivs i detta dokuments tillhörande excelark [1]. Det kan även vara lämpligt att dölja dessa för andra än dem som kan förstå dem. 1.3 Övrig information 1.3.1 Information från överliggande objekt Generellt försöker man undvika dubbellagring. Därför har i de flesta fall ett personobjekt till exempel ingen adressinformation. I de fall man saknar information av en viss typ på ett objekt bör man alltid söka informationen på närmast överliggande objekt. 1.3.2 Språk Alla attribut ska fyllas med svensk text. Om så önskas kan den svenska texten i tillämpliga fall kompletteras med text på andra språk. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 5/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Senast ändrad 2015-04-14 1.3.3 Rekommendationer kring tecken i objektsnamn Den teknik som används i HSA ger vissa begränsningar i vilka tecken som kan användas i namn på objekt. Textsträngar som lagras i HSA kan rent tekniskt innehålla vilka tecken som helst men för att praktisk användning av allehanda tecken ska vara möjlig måste även samtliga klienter som använder HSA vara förberedda för att hantera alla tecken. Alla klienter på marknaden är inte förberedda och inom HSA finns inte total kontroll över vilka klienter som används. Istället finns dessa rekommendationer. Namn på personobjekt begränsas naturligt av vilka tecken som Skatteverket tillåter i folkbokföringen (ISO/IEC 8859-1). Vad gäller namn på enheter och funktioner, som oftast är manuellt registrerade i katalogen/katalogerna, är det istället viktigt att rekommenderade tecken kan kommuniceras till administratörer. Tecken som kan orsaka tekniska problem och som ska undvikas i objektnamn är: Tecken Benämning * Stjärna + Plus \ Bakåt snedstreck , Komma ; Semikolon ” Citattecken < Mindre än > Större än ( Vänster parentes ) Höger parentes Mellanslag först och/eller sist i texten Inget tecken (Unicode 0000) Null Rekommendationen gäller i första hand attributen enhetsnamn, ou (organizationalUnitName), organisationsnamn, o (organizationalName) och objektnamn, cn (commonName) men också alla andra attribut som kan uppträda som RDN (RelativeDistinguishedName). 1.3.4 Rekommendationer kring tecken i attributvärden Det är tillåtet att använda radbrytningstecken i fritextattribut vid behov. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 6/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Senast ändrad 2015-04-14 2 Attribut i HSA Tjänsteträd 2.1 2.1.1 Geografisk information Geografisk indelning Attribut (LDAP-namn) land (c, Beskrivning Format Mult Landets tvåställiga bokstavsbeteckning enligt ISO 3166 om annat än Sverige. KTOV Envärdes (0..1) Kodverk/ Värdemängd Max lgd Org Org Unit Org Role 2 X X X Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role 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 255 X X X Beslutsregel/Teknisk kommentar Anges med 2 bokstäver enligt ISO 3166. DC countryName) Associationer Beslutsregel En Geografisk indelning indelar noll till flera Funktioner En Geografisk indelning indelar noll till flera Enheter 2.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 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 7/21 DC HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Attribut (LDAP-namn) Beskrivning Format Senast ändrad 2015-04-14 Mult Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role DC Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role DC funktionen. Associationer Beslutsregel En Internetuppgift är kontaktuppgift till noll till flera Enheter En Internetuppgift är kontaktuppgift till noll till flera Funktioner 2.3 SITHS Certifikatsinformation Attribut (LDAP-namn) certifikatsmottagare (hsaCertificateRecipient) certifikatsnummer (serialNumber) giltigt fr.o.m. (validNotBefore) giltigt t.o.m. (validNotAfter) Inera AB Beskrivning Format Mult HSA-id för den som är utpekad mottagare av certifikat för funktionen. II Flervärdes (0..*) Observera att SITHS i dagsläget inte använder detta attribut i HSA. Certifikatsmottagare anges på SITHS beställningsblankett för funktionscertifikat. 128 X SITHS-certifikatets serienummer. II Flervärdes (0..*) Informationen registreras av SITHS vid skapande av HCC och tas bort vid spärr av HCC. 64 X Det datum som SITHScertifikatet är giltigt från och med. Datum (TP) Flervärdes (0..*) Informationen registreras av SITHS vid skapande av HCC och tas bort vid spärr av HCC. X Det datum som SITHScertifikatet är giltigt till och med. Datum (TP) Flervärdes (0..*) Informationen registreras av SITHS vid skapande av HCC och tas bort vid spärr av HCC. X Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Kodverk/ Värdemängd Organisationsnummer 556559-4230 Sid 8/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Attribut (LDAP-namn) HCC Beskrivning Giltiga SITHS-certifikat. Format Mult TXT Flervärdes (0..*) (certifikat ) (userCertificate) Senast ändrad 2015-04-14 Associationer Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role DC X SITHS-certifikat av typen HCC Funktion. Informationen registreras av SITHS vid skapande av HCC och tas bort vid spärr av HCC. Beslutsregel En Certifikat innehas av noll eller en Funktion 2.4 Enhetsinformation Attribut (LDAP-namn) enhetsnamn (ou, organizationalUnitName) organisationsnamn (o, organizationName) Inera AB 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) Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd 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 (0-9) samt bindestreck (-) och understreck (_) får användas. 64 64 Organisationsnummer 556559-4230 Sid 9/21 Org Obl Org Unit Org Role Obl X DC X HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Attribut (LDAP-namn) organisationsnummer (orgNo) Beskrivning Organisationsnummer enligt SCB/Bolagsverket. Format Mult II Envärdes enligt regel (0..1) (XXXXXXXXXX) Exempel: 802006-3023 Associationer Senast ändrad 2015-04-14 Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role 12 Obl X X Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role Sekelsiffran ”16” ska inte vara med. DC 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 2.5 Objektinformation Attribut (LDAP-namn) ansvarig person (hsaResponsiblePerson) beskrivning (description) Inera AB Beskrivning HSA-id för den som ansvarar för funktionen. Kort beskrivning/förklaring av speciellt intresse. Box 177 03 Östgötagatan 12 118 93 Stockholm Format Mult II Flervärdes (0..*) Om den ansvariga personen inte finns i organisationen och inte har HSA-id kan namn- och kontaktuppgifter skrivas in i ”HSA-administratörens kommentar”. 128 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 1024 Tel 08 452 71 60 info@inera.se www.inera.se Kodverk/ Värdemängd Organisationsnummer 556559-4230 Sid 10/21 DC X X X X X HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Attribut (LDAP-namn) Beskrivning Format Mult Senast ändrad 2015-04-14 Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role 31 Obl Obl Obl X X X och vad den används till. HSA-id (hsaIdentity) HSA-administratörens kommentar (hsaAdminComment) objektnamn Obligatorisk, unik identifierare för personer, enheter, funktioner och organisationer i HSA. II (HSAid) Envärdes (1..1) Se beskrivning av HSA-id i dokumentet ”RIV Informationsspecifikation HSA Struktur och innehåll”. 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 inte är tillåtna. Administrativ kommentar, t.ex. namn- och kontaktinformation till ansvarig person som inte finns i HSA. TXT Envärdes (0..1) Attributet är endast synligt för HSA-administratörer inom det egna behörighetsområdet. 1024 Funktionens namn. TXT Envärdes enligt regel (1..1) URI/DNS-namn för tjänsten registreras alltid i attributets objektnamn om SITHS-certifikat ska skapas, ex ”cn=dsedix.ds.sll.se”. 64 (cn, commonName) Endast domännamn som ägs av organisationen de befinner sig under (o=[organisationen]) får Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 11/21 Obl DC HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Attribut (LDAP-namn) Beskrivning Format Mult Senast ändrad 2015-04-14 Kodverk/ Värdemängd Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role 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) 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ällning. DT (Datum) DT (Datum) Associationer 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 Beslutsregel En Funktion hör till noll eller en geografisk indelning En Funktion är del av en och endast en Enhet En Funktion innehar noll eller flera Certifikat Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 12/21 DC HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll 2.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) Namn på nod i HSA Tjänsteträd (DomainComponent, DC). Exempel: Nod 1, Uppdragsmallar, Koder. TXT Envärdes (1..1) (numSubordinates) antal underliggande objekt (numAllSubordinates) nodnamn (dc, domainComponent) Inera AB Senast ändrad 2015-04-14 Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Beslutsregel/Teknisk beskrivning Max lgd Org Org Unit Org Role DC 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 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 Kodverk/ Värdemängd Obl Organisationsnummer 556559-4230 Sid 13/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Attribut (LDAP-namn) Beskrivning 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ättighet er som administratörsgruppen är tilldelad, gäller oftast den enhet som administratörsgruppen är placerad under med Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Format VÄ Mult Senast ändrad 2015-04-14 Beslutsregel/Teknisk beskrivning Kodverk/ Värdemängd Max lgd Org (Octet) 0..1 40 X 0..* 40 X Tel 08 452 71 60 info@inera.se www.inera.se Flervärdes (1..*) 128 Exempel: "cn=Maria Larsson,ou=Systemavdelningen,o=L andstinget Sörmland,l=Sörmlands län,c=SE". Organisationsnummer 556559-4230 Sid 14/21 Org Role X Envärdes (0..1) (SEXXXXX XXXXX-) II Org Unit DC HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Attribut (LDAP-namn) Beskrivning Format Mult TP Envärdes (0..1) Senast ändrad 2015-04-14 Beslutsregel/Teknisk beskrivning Org Org Unit Org Role DC X X X X Envärdes (0..1) X X X X Envärdes (0..1) X X X X Kodverk/ Värdemängd Max lgd underliggande objekt. senaste förändringstidpunkt (modifyTimeStamp) 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 DN för objekt (användare) som skapat objektet. Kan vara en administratör eller ett system. (creatorsName) Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm (Datum) II (DN) II (DN) Tel 08 452 71 60 info@inera.se www.inera.se Operativt attribut som skapas med automatik av databasen vid förändring av information på objektet i något attribut. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: "20081112141347Z". Organisationsnummer 556559-4230 Sid 15/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Attribut (LDAP-namn) skapandetidpunkt (createTimeStamp) Inera AB Beskrivning Format Mult Information om tidpunkt för skapandet av objektet. TP (Datum) Envärdes (0..1) Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Senast ändrad 2015-04-14 Beslutsregel/Teknisk beskrivning Kodverk/ Värdemängd Operativt attribut som skapas med automatik av databasen. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: "20081112141347Z". Organisationsnummer 556559-4230 Sid 16/21 Max lgd Org Org Unit Org Role DC X X X X HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Senast ändrad 2015-04-14 3 Syntax Datum Enligt RFC4517. Det vill säga minst YYYYMMDDhhZ. Där Z står för tidszonen Zulu, d v s UTC. HSAid SE[Katalogägarens organisationsnummer med 10 tecken]-[valfria bokstäver (A-Z och a-z) och siffror (0-9)]. Observera att tecknen å, ä, ö samt @-tecken inte är tillåtna. De katalogägare som redan börjat använda organisationsnummer med ”sekelsiffra” (d.v.s. 12 tecken) får fortsätta med det men för nya katalogägare är det inte tillåtet. Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 17/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Senast ändrad 2015-04-14 4 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 S/F/T BL Boolean Kan antingen vara sant, falskt eller ”tomt”. Sant/Falskt S/F BN Boolean not null Kan antingen vara sant eller falskt. KTOV CD Coded value Identifiering av berört kodverk/klassifikation (genom sk OID) samt aktuell kod och text Exempel: ” A00.9 Kolera, ospecificerat OID för KSH97 v97 mycket allvarlig kolera ” Kodat värde med text och OID Instans identifierare Datapaket Inera AB II DP II ED Engelsk benämning enligt ISO Instance Identifier Encapsulate d data Box 177 03 Östgötagatan 12 118 93 Stockholm Förklaring kod K aktuellt kodvärde text TX klartext kodverk OID identifierng av berört kodverk/ klassifikation version TX kodverkets version förtydliga nde TX används t ex vid förtydligande av kod ”Övrigt” En unik identifikation av en instans, företeelse eller objekt. T.ex. remissid, personnummer, HSA-id. Exempel: ” MMÅÅDD-XXXX OID för personnummer” kod CV aktuellt kodvärde kodverk OID identifierng av berört kodverk/klassifikation 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 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 18/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Svensk benämning på datatyp Värde Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO VÄ Förklaring Uttrycker värdets datatyp och sort värde Kvantitet KV PQ Flertal FLT<x> SET<x> Fritext TXT ST Tele- och datakommunikati on KOM TEL/HL7 Datum DT Date Tidpunkt TP Tidsintervall IVL Inera AB Senast ändrad 2015-04-14 aktuellt värde värdetyp Kodat värde värdetsdatatyp enhet Text 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, dvs månad eller år. Datatypen kallas fortfarande ”datum”. Formatet är ÅÅÅÅMM respektive ÅÅÅÅ Exempel: 20060713 TS 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, dvs 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. ITV<TS> Time interval Angivelse av ett utrymme i tiden. Detta kan anges på 4 sätt: 1. Start och slut Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 19/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Svensk benämning på datatyp Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO Senast ändrad 2015-04-14 Förklaring 2. Start och varaktighet 3. Varaktighet och slut 4. Varaktighet (utan relation till realtid) Formatet är P[tY][mM][dD][T[hH][mM][s[.s]S]] där uppgifter inom [ ] är valfria. 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 , dvs jordbävningen pågick i 2 timmar, 31 minuter och 26,34 sekunder Webbadress URL URL Kolumn Multiplicitet (antal möjliga förekomster) Kod, ex Förklaring 1(1..1) En förekomst 0..1 Ingen eller en förekomst 0..* Ingen eller många förekomster 1..2 En till två förekomster 1..* En till många förekomster Inera AB Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 20/21 HSA-schema tjänsteträdet version 4.5 Fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll Senast ändrad 2015-04-14 Referenser [1] [2] Inera AB HSA-schema tjänsteträdet version 4.5.xls RIV Informationsspecifikation HSA Struktur och innehåll version 4.5 Box 177 03 Östgötagatan 12 118 93 Stockholm Tel 08 452 71 60 info@inera.se www.inera.se Organisationsnummer 556559-4230 Sid 21/21
© Copyright 2024