INDHOLD
Beskrivelse
Behandlingsrelationer med forskellige typer af relationer medlem patienter og behandlende enheder.Udstilles ikke via SKRS; benyttes af BRS servicen som evidenskilde
NSP: LPR3
Forretningsanvendelse
Generel register beskrivelser: Dokumentation af stamdataregistre. Specifikt: LPR3
Anvendelse af B00 Stamdata Kopi register service (SKRS): SDM - Guide til anvendere
Landspatientregisteret udstilles IKKE via SKRS, Bruges kun af BRS som evidenskilde.
Relaterede registre og services
Applikationsbeskrivelse
Generisk parameterstyret import controller, der kalder den dedikerede importer for det aktuelle dataobjekt først mod preflight databasen og hvis det ikke fører til fejl, kaldes den samme dedikerede importer mod produktions databasen.
Indsamlingen af data implementeres i forhold til hvert enkelt kilderegister ved anvendelse af en registerspecifik Parser, men med anvendelse af en fælles Importer-komponent.
Importer-komponenten kører på NSP Backend platformen, og er ansvarlig for at indlæse dataset fra registerfiler, der placeres i en dedikeret mappe i filsystemet . Hvert register har sin egen dedikerede mappe som automatisk bliver oprettet af Importer-komponenten.
Importeren overvåger filsystemet og aktiverer de registerspecifikke parsere, når nye registerfiler er tilgængelige i filsystemet.
De respektive parsere (Importere) processerer registerfilerne og overfører registerdata til den lokale database. Parsningen kan i princippet bestå af en direkte dataoverførsel fra fil til database, men indeholder i de fleste tilfælde forretningslogik, f.eks. transformationer af data og denormaliseringer.
Stamdatatabellerne registreres i NSP’ens replikeringsmekanisme, og de parsede registerdata replikeres derfor automatisk ud til de enkelte NSP instanser, hvorfra de kan tilgås gennem de udstillede stamdataservices.
Opgradering af importer databasen sker automatisk ved serverstart, og fungerer på den måde at sql scripts med navne formatet "Vyyyymmdd_hhmm_description.sql" afvikles på databasen. Script filerne placeres under resources\db\migration" og inkluderes dermed automatisk i den deployede applikation.
Bemærk at sql filerne afvikles i navne orden, og da dato og tid indgår i navnet, kan man styre hvilke scripts der skal afvikles først.
'db_migrations' tabellen varetager den fælles styring af skema-versioner, som alle importerer benytter til at holde styr på hvilke scripts der er afviklet, så hvert script kun afvikles én gang.
Bemærk, at som en af kun få importerer kører LPR3-importer ikke igennem Preflight.
Support ansvarlig: KvalitetsIT
Bemærk: Der er kommet ny LPR3 importer: LPR3 importer - Leverancebeskrivelse
Udstilles ikke af SKRS.
Datastruktur, Stamdata register: Landspatientregister (LPR)
Register properties:
Entitetsbeskrivelser
Landspatientregister
Landspatientregister (LPR3)
Behandlingsrelationer med forskellige typer af relationer medlem patienter og behandlende enheder.
Objektet indeholder følgende infomation:
--------------------------------------------
patientCpr -- cpr numre er SHA-1 hash
admittedStart -- Dato for behandlerrelationens starttidspunkt.
admittedEnd -- Dato for behandlerrelationens sluttidspunkt, bemærk kan være blank
lprReference -- Reference-værdi, audit spor
relationType -- Relationstype :
-- FORLOEBSELEMENT
-- KONTAKT
-- PROCEDURE
-- INITIEL_HENVISNING
-- HENVISNING
-- RESULTATINDBERETNING
-- OPHOLDSADRESSE
sorKode -- SOR-kode
Landspatientregister import-status
Start- og end-tidspunkt og status for alle importerede filer
Ajourføres af LPR importer
Landspatientregister udtræk
Udtræk af behandlingsrelationer fra Sundhedsdatastyrelsen
Opdaterer Landspatient registret
Udtræk fra LPR3 dannes og lægges ud på DXC's FTP server to gange dagligt.
Det indeholder samtlige forløbselementer, der er blevet ændret siden sidste udtræk.
For hvert af de ændrede forløbselementer sendes det nuværende fulde billede for forløbselementet (altså ikke kun de ændrede dele af forløbselementet).
Udtrækket hentes via "udtrækshenteren" i DMZ'en og gøres tilgængelig for importeren i NSP, der sørger for at importere udtræksdataene i NSP databasen.
Aflevering/afhentning af udtræksfiler foregår ved brug af DXC FTP serveren CSC File Gate (herefter betegnet CFG) ved brug af SFTPsFTP protokollen.
Der er defineret 2 konti for hvert miljø – én til aflevering og én til afhentning.
• I forbindelse med login anvendes SSH Public Key nøgler i stedet for ”klartekst passwords”.
Afleveringskontoen lægger filen op i sin udbakke på CFG.
• Medens filen skrives til udbakken, omdøbes den til .tmp.
• Først når filen er færdigskrevet, omdøbes den til sit rigtige navn.
• Dette er en simpel metode til at sikre, at CFG ikke tager fat i filen for tidligt.
Når CFG har identificeret filen, flyttes den automatisk til afhentningskontoens indbakke.
Tabelbeskrivelser
Tabel: LPR3
Database: "register_notifications" (Til brug for BRS servicen: BRS2_Notification, LPR, SSR og refhost; replikeret mellem Backend og NSP-miljøer)
CREATE TABLE IF NOT EXISTS LPR3 (
pk bigint NOT NULL auto_increment,
-- cpr numre er base64 af hashede numre
patientCpr varchar(80) NOT NULL,
admittedStart datetime NOT NULL,
admittedEnd datetime,
lprReference varchar(256) NOT NULL,
relationType varchar(40) NOT NULL,
sorKode bigint(20), -- SOR code
PRIMARY KEY (pk),
INDEX LPR3_INDEX USING HASH (patientCpr, sorKode),
INDEX LPR3_REF_INDEX USING HASH (lprReference)
) ENGINE=InnoDB COLLATE=utf8_bin;
Tabel: lprimporterImportStatus
CREATE TABLE IF NOT EXISTS lprimporterImportStatus (
Id BIGINT(15) AUTO_INCREMENT NOT NULL PRIMARY KEY,
StartTime DATETIME NOT NULL,
EndTime DATETIME,
Outcome VARCHAR(20),
INDEX (StartTime)
) ENGINE=InnoDB COLLATE=utf8_bin;
Fil: Landspatientregister (LPR3) stamdata.zip
.zip-filer, deltaer (indeholder inserts og deletes)
FTP. Vi henter det via ftp://lpr-prod.nspnet.dk fra Sundhedsdatastyrelsen
Filbetegnelse:
• Format: BR_SRO_<løbenummer>_<startdato>_<slutdato>.csv
• BR_SRO er et fast prefix.
• Løbenummeret vil altid være stigende, men der kan være ”huller” i nummerserien, fordi den pågældende kørsel ikke har dannet en udtræksfil. På modtagesiden må man således ikke bero sig på løbenummeret – det har kun praktisk betydning for logninger i database systemet, hvis man har behov for at gå tilbage i tilfælde af fejl- eller årsagssøgning.
Løbenummeret angives som et 5-cifret tal (med foranstillede nuller), og kan således benyttes til alfabetisk sortering af udtræksfilerne.
• Både startdato og slutdato angives på formen yyyymmddhhnnss (altid 14 cifre).
• Ved fuldt udtræk anvendes 00000000000000 som startdato.
• På modtagesiden vil filerne altid kunne kædes sammen, idet ”ny startdato skal være lig gammel slutdato”. Dette gælder dog ikke ved et nyt totaludtræk, hvor startdatoen ”nulstilles”.
• Løbenummeret vil altid være stigende, men der kan være ”huller” i nummerserien, fordi den pågældende kørsel ikke har dannet en udtræksfil. På modtagesiden må man således ikke bero sig på løbenummeret – det har kun praktisk betydning for logninger i database systemet, hvis man har behov for at gå tilbage i tilfælde af fejl- eller årsagssøgning.
• Filextension skal være i lowercase .csv, da der er opsat et filter på FTP serveren, som er case sensitivt.
Tegnsæt/encoding: UTF-8 uden BOM.
• Da der ikke forekommer nationale symboler, er tegnsættet identisk med almindelig 8-bits ASCII.
Linieskift: LF (Unix format)
Separator: Komma
Udtrækket vil omfatte data på følgende format:
--------------------------------------------------
Sted: SOR kode; 18 ch
Patient: SHA1-hashværdi for CPR; SHA1-hashværdi for cprnr. 20 karakterer repræsenteret ved deres 2-tegns hex-værdi; 40 ch
Type: Følgende typer for elementer med organisatoriske relationer er indeholdt i LPR3 og overføres til BRS.; 1 ch
• F: Forløbselement
• K: Kontakt
• P: Procedure
• I: Initiel Henvisning
• H: Henvisning
• R: Resultatindberetning
• O: Opholdsadresse
• X: Slettet relation **)
Relationen starttidspunkt: Dato for behandlerrelationens start. For elementerne Forløbselement, Kontakt, Procedure, Opholdsadresse anvendes Starttidspunkt. dd-mm-yyyy hh:mm
Relationen sluttidspunkt: Dato for behandlerrelationens slut. For elementerne Forløbselement, Kontakt, Procedure, Opholdsadresse anvendes Sluttidspunkt. dd-mm-yyyy hh:mm
Reference *): En identifikation af relationen så behandlingsrelationer kan identificeres og opdateres. Elementer fra samme forløbselement vil have samme reference (Se FR8); 255 ch
*) Reference vil være EXTENSION værdien for forløbelementet, angivet på formen xxxxxxxx-xxxx-xxxxxxxx-xxxxxxxxxxxx (hvor x er hex-værdier).
**) Specielt type X (Slettet relation) anvendes kun, når hele forløbelementet er markeret som slettet i LPR3 systemet. I givet fald vil udtrækket ikke indeholde yderligere linjer for de underliggende elementer.
Teknologibeskrivelse
(udestår)
Refereres fra
- 2.1 NSP Forretningsarkitektur overordnet
- 2.2 NSP Forretningsarkitektur områder
- E08 Behandlingsrelationsservice (BRS)