Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Version 1.0 september 2019

Table of Contents


Indledning

...

Certificering til anvendelse af SORUS i produktion, opnås ved at dokumentere at basale use cases i SORUS Testprotokol kan gennemføres uden fejl ved test afviklet på NSP testmiljø.

Funktionalitet og målgruppe 

SOR (Sundhedsvæsenets Organisations RegisterSOR (Sundhedsvæsenets OrganisationsRegister) indeholder alle organisationsenheder inden for det danske sundhedsvæsen – regionale sygehuse, kommunale sundhedsinstitutioner, såvel som private lægepraksis, apoteksfilialer, osv.

Disse er bygget op i hierarkier af SOR-enheder (SOR entities) og blev oprindeligt vedligeholdt vba. den såkaldte ”SOR GUI” som læste og ændrede direkte i SORs interne database, men med implementeringen af SOR-services, mere specifikt i dette tilfælde: ”SOR Opdateringsservice” (SORUS), er det nu muligt at lave ”System-til-System”-opdateringer af SOR, fra NSP (den Nationale ServicePlatform). Dette simplificerer muligheden for ekstern brug af SOR.

Kort beskrivelse af baggrunden for SORUS

SOR blev oprindeligt implementeret i 2009 for at erstatte den eksisterende SHAK-klassifikation (SygeHusAfdelingsKode-klassifikation), for at imødekomme formatmæssige begrænsninger. Disse begrænsninger var dog imidlertid ikke så kritiske som forventet og derfor blev SOR introduceret, men kun brugt i begrænset omfang. Dette var realiteten indtil for nyligt, hvor man vedtog lovkrav om rapportering af budget og lign. på et finere granuleret niveau, og i denne sammenhæng har man nu brug for den detaljegrad som er tilladt i SOR, til forskel for SHAK.

For at hjælpe med til en bredere accept af SOR, implementerer man ”SOR Services”.

Diagram over løsning

Gliffy Diagram
nameSORUS
pagePin4
 

SORs Opbygning

.

SOR Opdateringsservice (SORUS) anvendes til administration af regioners SOR data.

Servicen indeholder funktionalitet til at oprette, opdatere, flytte, erstatte og nedlægge enheder i SOR. Endvidere er det muligt at opdatere EDI oplysninger på en enhed.

Servicens brugere er regionernes SOR ansvarlige.

Diagram over forretningsprocesser i løsningen

Gliffy Diagram
nameSORUS
pagePin4
 


Testprotokolens testcases  

Nedenstående 6 test cases indeholder de basale funktioner, der understøttes i SORUS.

De er beskrevet detaljeret med information om testcasens forløb, pre- og postconditions, fejlscenarier og begreber og definitioner.

Klik på linket for at gå til den enkelte testcase. 

NøgleProduktTestcasesVariationerStatus
UC1SORUS

UC1 Testcases; Opret ny enhed i SOR

Opret organisatorisk enhed (obligatorisk information / alt information / arvet information)


UC2SORUSUC2 Testcases; Opdater enhed i SOROpdater informationer på en eksisterende organisatorisk enhed (obligatorisk information / alt information / arvet information)
UC3SORUSUC3 Testcases; Flyt enhed i SOR Flyt en organisatorisk enhed i SOR
UC4SORUSUC4 Testcases; Erstat enhed i SORLav en erstatningsnote på en organisatorisk enhed
UC5SORUSUC5 Testcases; Nedlæg enhed i SORNedlæg en organisatorisk enhed
UC10SORUSUC10 Testcases; Opdater EDI oplysninger i SOROpdater EDI-oplysninger på en organisatorisk enhed

SOR's Opbygning

SOR's SORs opbygning består af hele det danske sundhedsvæsens enheder – dvs. alt fra Rigshospitalet, til fodterapeuter og mindre private lægepraksis. Alle disse enheder er bygget op i ”træstrukturer” – heri kaldet ”hierarkier”. I disse hierarkier eksisterer relationsmæssige regler, ud fra SOR-typerne: (dansk / engelsk – begge notationer bruges aktivt):

Niveau

Typenavn - Dansk

Kort


Typenavn - Engelsk

Kort

1

InstitutionsEjer

IE


Institution Owner

IO

2

SundhedsInstitution

SI


Health Institution

HI

3+

Organisatorisk Enhed

OE


Organizational Unit

OU


Gliffy Diagram
nameSOR Opbygning
pagePin3

Ud over regler for hvorledes et hierarki er bygget, er der også krav til, at det skal bestå af minimum tre niveauer, for at være validt og blive trukket ud af SOR, i forbindelse med udtræk.

I forbindelse med denne tilslutningstest vil det kun være Organisatoriske Enheder, der er af relevans. 

SOR-typer og data

Alle enheder i SOR indeholder masser af information, hvilket til tider kan være svært at gennemskue. For at gøre datamodellen mere transparent , forsøges her at give gives en kort gennemgang af al obligatorisk information på tværs af typer:

...

Mere information om dette data kan ses i delafsnittende nedenfor.

SOR-typer:

IO – Institution Owner

Øverste instans, niveau 1, i enhedshierarkier. Disse kommer i fire enhedstyper: Privat, Regional, Kommune og Stat. Der eksisterer nogle begrænsninger på indhold i underliggende enheder, afhængig af IO’ens enhedstype.

...

SOR-Typespecifik information:

CVR-nummer

Adresser:

Postadresse

 

Virtuel adresse


HI – Health Institution

Niveau 2, i alle hierarkier. Disse kommer i 53 forskellige enhedstyper, bl.a. ”Apoteker”, ”Fodterapeuter”, ”Administrative enheder”, m.fl. Af særheder tilknyttet HI-typen kan nævnes at HI’er af typen ”Apotek” er den eneste form for enhed der kan indeholde parameteren: ”Pharmacy Identifier”. Derudover er det kun HI’er af typen ”Hospital”, under en IO af typen ”Regional”, der kan have en såkaldt ”Geografisk Lokalitet”. Rent funktionelt betyder det at de er tilknyttet en adresse, som indgår i ”Geographical Localization”-tabellen, i databasen.

...

Enhedstypespecifik information:

Geografisk Lokalitet

Kun for hospitaler


Pharmacy Identifier

Kun for apoteker

Adresser:

Postadresse

 

 

Besøgsadresse

 

 

Virtuel adresse

 


OU – Organizational Unit

Niveau 3 og under. Disse kommer i 48 forskellige enhedstype, og er den SOR-type der indeholder flest ”implicitte” begrænsninger (se tabel nedenfor). Et eksempel er at OU-enheder af enhedstypen: ”-hospital” (se SOR-lookupdata -> enhedstyper -> OEh), kun kan placeres under en HI-enhed af enhedstypen: ”Hospital”. 

...

SOR-Typespecifik information:

LocalAttributeCollection

 


Specialty Collection (specialer)

 


Enhedstypespecifik information:

Geografisk Lokalitet

Kun for hospitaler


Provider Identifier (ydernummer)

Ikke for hospitaler

 

Lokalkode

Kun for hospitaler

 

ReportingLevel

Kun for hospitaler

 

PatientsAdmitted Indicator

Kun for hospitaler

 

AmbulantActivity Indicator

Kun for hospitaler

Adresser:

Postadresse

 

 

Besøgsadresse

 

 

Aktivitetsadresse

 

 

Virtuel adresse

 

...


Adressetyper

Alle enheder i SOR har såvel fysiske, som virtuelle adresser. Der eksisterer fire forskellige adressetyper:

...

I forbindelse med oprettelse eller opdatering af en enhed vha. SORUS, vil en udfyldt adressetype resultere i en ”udfyldt” adresse, dvs. ingen arv, men hvis en adressetype efterlades tom, vil denne blive arvet fra parent.

Enhedsnavn (EntityName)

Enhedens navn – eks. ”Lægeklinik Vestergade”, ”Rigshospitalet”, osv.

Enhedstyper (EntityTypeIdentifier)

Teknisk nøgle for EntityType (SNOMED Concept Id); Enhedstyper (EntityTypeIdentifier) i SOR er et obligatorisk felt på alle enheder og indeholder yderligere information om hvad en SOR-enheds faktiske funktion er; et tænkt hierarki kan se ud som følger:

...

Som nævnt i afsnittet ovenfor, eksisterer der til tider forskellige begrænsninger i datamodellen, på baggrund af disse enhedstyper. Eksempelvis kan kun apoteker indeholde ”Apoteks ID”, hospitalsenheder kan have information om ”Indlagte Patienter” osv.

EAN LokationskodeStatus (EanLocationCodeState)

Denne oplysning fortæller om hvorvidt en given enhed har et EAN Lokationsnummer, eller ej. Til forskel fra adressenedarvning – som enten kan være finde sted eller ej – kommer LokationsnummerStatus i tre varianter:

1

Own

EanLocationCode-informationer er/skal angivet/-s og enheden har/får en unik lokationskode

2

None

Enheden har ingen lokationskode og ingen yderligere oplysninger behøves

3

Inherited

Enheden arver lokationskode fra sin parent og ingen yderligere oplysninger behøves; såfremt ingen lokationskode er angivet i hierarkisk overliggende enheder, modtages en fejl om at arv er umuligt

Testcases

Opdater EDI-oplysninger på en organisatorisk enhed
NøgleProduktTestcasesVariationerStatus
UC1SORUS

UC1 Testcases; Opret ny enhed i SOR

Opret organisatorisk enhed (obligatorisk information / alt information / arvet information)

UC2SORUSUC2 Testcases; Opdater enhed i SOROpdater informationer på en eksisterende organisatorisk enhed (obligatorisk information / alt information / arvet information)UC3SORUSUC3 Testcases; Flyt enhed i SOR Flyt en organisatorisk enhed i SORUC4SORUSUC4 Testcases; Erstat enhed i SORLav en erstatningsnote på en organisatorisk enhedUC5SORUSUC5 Testcases; Nedlæg enhed i SORNedlæg en organisatorisk enhedUC10SORUSUC10 Testcases; Opdater EDI oplysninger i SOR

Begreber og definitioner

Guide til anvendere; Information om operationer og input.

...