Documentatie DHD thesauri Bijlage 1 : Uitleverformaat 2.2 Diagnosethesaurus

Transcriptie

1 Documentatie DHD thesauri Bijlage 1 : Uitleverformaat 2.2 Diagnosethesaurus Versie Datum Mei 2015 Status Definitief

2 Inhoud 1 UITLEVERFORMAAT DHD INLEIDING LEESWIJZER TECHNISCH FORMAAT EN NAAMGEVINGSCONCENTIES DATATYPES DATAMODEL TOELICHTING BIJ HET DATAMODEL Thesaurusconcepten en hun relaties (HT ) Brontabellen (RT ) Afleidingen (KT_) OVERZICHT TABELLEN THESAURUSTABELLEN HT_Thesaurus HT_INTERFACE BRONTABELLEN RT_ICD RT_DBC_DIAGNOSE RT_SPECIALISME AFLEIDINGEN KT_ICD KT_DBC_DIAGNOSE Pagina 2 van 12

3 Versiebeheer Versie Datum Korte beschrijving aanpassing januari 2015 Splitsing algemeen stuk en exportformaat - Generiek deel datamodellen naar algemeen document - Interne versleuteling in export aangepast - Diverse wijzigingen in verplicht / niet verplicht - Encoding aangepast Maart 2015 Toelichting DBC koppeling zonder diagnosetypering + volgorde in KT_DBC April Encoding naar UTF-8 - Layout verbeteringen Mei Uitgebreidere toelichting m.b.t. unieke velden - Naamgevingsconventie bestanden - HT_thesaurus: Veldlengte Snomed omschrijving naar RT_ICD10: Veldlengte ICD10 omschrijving naar RT_DBC_Diagnose: Veldlengte Diagnoseomschrijving kort naar Het meer gangbare Verplicht veld aangegeven ipv mag leeg zijn - Document status definitief gegeven Pagina 3 van 12

4 1 Uitleverformaat DHD Inleiding Dit document beschrijft het uitleverformaat 2.2 waarin de Diagnosethesaurus zal worden uitgeleverd. Het exportformaat is de technische structuur van de tabellen en relaties waarin de diagnosethesaurus wordt uitgeleverd. De doelgroep van dit document is ICT-specialisten van zowel de eindgebruikers (b.v. ziekenhuizen) en de EPD/ZIS-leveranciers. 1.2 Leeswijzer Dit document beschrijft uitsluitend de inhoud van de uitlevering. Documentatie over hoe de thesaurus gebruikt dient te worden binnen een EPD-systeem vindt u in de basisdocumentatie die uitleverformaat onafhankelijk is. Indien u nog dient te beginnen met ontwikkeling / implementatie van de Diagnosethesaurus dient u direct versie 3.0 van het exportformaat te gebruiken, in verband met toekomstvastheid. 1.3 Technisch formaat en naamgevingsconcenties Individuele tabellen Elke tabel wordt apart geëxporteerd in Comma separated formaat (CSV) formaat: De encoding is UTF-8. Elk bestand bevat column headers Velden zijn quoted ( ), m.u.v. de datumvelden. Elke bestand voldoet aan de volgende naamgevingsconcentie: YYYYMMDD_HHMMSS_versie_X.Y_bestandsnaam.csv Waarbij versie x.y de versie van het uitleverformaat is. Voorbeelden: ZIP-bestand Alle CSV bestanden worden tezamen in een zip bestand opgenomen. Het ZIP bestand bevat de versienaam van de inhoud én de versienaam van het uitleverformaat conform de volgende naamgevingsconcentie: YYYYMMDD_HHMMSS_VT_VU Bijvoorbeeld Pagina 4 van 12

5 _153220_Diagnosethesaurus_1.4_uitleverformaat_2.2 In dit geval betreft het dus de inhoud van de thesaurus versie 1.4 terwijl het bestandformaat 2.2 is. 1.4 Datatypes De volgende data types worden gebruikt: Type Vulling Toelichting Varchar(n) Tekst Tekstveld met een maximale lengte van n karakters. Boolean / logisch Tekst Technisch gezien ook een varchar, maar uitsluitend gevuld met de tekstuele waarde true of false. Als iets niet van toepassing is, wordt false gekozen. Datum YYYYMMDD Een einddatum in 2099 betekent: geen einddatum. Numeric Nummer Op dit moment altijd gehele getallen (integer). Pagina 5 van 12

6 2 Datamodel Onderstaande figuur geeft het datamodel schematisch weer. Sleutelvelden zijn onderstreept en vet 2.1 Toelichting bij het datamodel Op hoofdlijnen bestaat de thesaurus uit drie soorten tabellen: - Thesaurusconcepten en hun relaties (links in de figuur); - Brontabellen (rechts) met stamgegevens; - Afleidingen (midden) die een koppeling leggen tussen de thesaurusconcepten en de bronbestanden Thesaurusconcepten en hun relaties (HT ) De tabel HT_thesaurus bevat alle, op SNOMED CT-gebaseerde concepten, die zijn opgenomen in de diagnosethesaurus. De concepten zijn voorzien van attributen die afgeleid zijn uit SNOMED CT of toegevoegd zijn door de DHD. Een concept is geassocieerd met meerdere termen en meerdere afleidingen. De tabel HT_interface bevat de zoektermen (synoniemen en referentietermen) per concept. Pagina 6 van 12

7 2.1.2 Brontabellen (RT ) De brontabellen worden niet door de DHD onderhouden. Deze worden wel mee uitgeleverd, zodat er altijd een consistente set kan worden uitgeleverd en de gebruiker van de DHD thesauri niet ook nog verplicht zelf deze bestanden hoeft te verzamelen. Op dit moment zijn er de volgende brontabellen: - ICD10 (RIVM); - Specialismen (Vektis); - DBC-diagnosetyperingen (DBC onderhoud)/nza) Afleidingen (KT_) De afleidingen koppelen de ThesaurusConcepten aan één of meer van de brontabellen. Op dit moment zijn er afleidingen voor DBC en ICD10. Beide koppeltabellen zijn ingericht op meer-op-meer relaties. DBC-afleiding (enkel en meervoudig) Deze tabel koppelt de Thesaurusterm voor een bepaald specialisme aan één of meer DBC diagnosetypering(en). Indien er sprake is van een enkelvoudige afleiding is er dus één regel met daarin DBC, specialisme en term. In sommige gevallen is er sprake van meervoudige afleidingen, in dat geval zijn er dus meerdere regels opgenomen. ICD10-afleiding (één op meer) De ICD10 afleiding is een één-op-meer relatie. Belangrijkste verschil met de DBC afleidingen is dat de ICD10 afleiding niet afhankelijk is van het specialisme. Daarnaast kunnen meerdere ICD10 codes bij één term horen en gezamenlijk de codering bepalen. Bij de DBC afleidingen zijn het dus alternatieven. Bij de ICD10 is het één afleiding naar meerdere termen. Pagina 7 van 12

8 3 Overzicht tabellen In de export van de diagnosethesaurus worden de volgende tabellen uitgeleverd: Type HT_Thesaurus HT_Interface RT_ICD10 KT_ICD10 RT_DBC_Diagnose KT_DBC_Diagnose RT_Specialisme Vulling Hoofdtabel, diagnoseconcepten (voorkeurstermen), Snomed CT Hoofdtabel, diagnosen (zoektermen) Referentietabel ICD-10 coderingen Koppeltabel ICD-10 coderingen per concept Referentietabel DBC diagnosen Koppeltabel DBC typeringen per concept/specialisme Referentietabel specialismen De volgende paragrafen bevat per uit te leveren tabel met de veldbeschrijvingen. veldnamen Het teken in de veldnaam is bedoeld om te markeren dat in de opmaak van dit document een regeleinde is ingevoegd; dit teken kan worden genegeerd. Veldnamen bevatten geen spaties of regeleinden. Pagina 8 van 12

9 3.1 Thesaurustabellen HT_Thesaurus Tabelnaam: HT_Thesaurus: diagnoseconcepten Veldnaam Veldlengte Inhoud Uniek Verplicht ID_Thesaurus 30 Uniek ID voor de Zie toelichting Ja diagnosethesaurus; mag in deze tabel éénmaal voorkomen, in combinatie met begindatum ReferentieTerm 255 Voorkeursterm Ja Ja TypeConcept 32 Keuze uit: Ja Zorgbehoefte Migratie1 ID_Snomed 255 Snomed ID Zie toelichting Snomed_omschrijving 255 Snomed Fully Specified Name (FSN) Engelstalig (wel verplicht gevuld als ID_Snomed gevuld) Begindatum DATUM Begindatum record Ja Einddatum DATUM Einddatum record Ja Mutatiedatum DATUM Mutatiedatum record ID_Nieuw_concept 30 Verwijzing naar ander ID_Thesaurus bijvoorbeeld wanneer een record een einddatum heeft gekregen Uniekheid van concepten: ThesaurusID Het thesaurusid is en blijft uniek. DHD zorgt bij het heropenen van een concept voor een nieuw ID. Een concept met een bepaald ID mag ook niet van betekenis wijzigen. In dat geval dient het concept te worden afgesloten (Einddatum gevuld) en een nieuw concept te worden aangemaakt met een nieuw thesaurusid. SNOMED ID Het SNOMED ID Is niet 100% uniek. Wel mag elk SNOMED CT ID maar 1 keer voorkomen op een bepaalde geldigheidsdatum. M.a.w. er mogen niet twee concepten zijn waarbij de begin/einddatum en SNOMED ID overlapt. Pagina 9 van 12

10 3.1.2 HT_INTERFACE Tabelnaam: HT_Interface (zoektermen) Veldnaam Veldlengte Inhoud Uniek Verplicht ID_Thesaurus 30 Algemeen sleutelveld Ja ID_Interface 30 ID voor interfaceterm Ja Ja InterfaceTerm 255 Interfaceterm Ja Begindatum DATUM Begindatum record Ja Einddatum DATUM Einddatum record Ja Mutatiedatum DATUM Mutatiedatum record Pagina 10 van 12

11 3.2 Brontabellen RT_ICD10 Tabelnaam: RT_ICD10 (referentietabel ICD-10) Veldnaam Veldlengte Inhoud Uniek Verplicht ICD10_Code 20 ICD-10 code Ja Ja ICD10_Code_Dotted 20 ICD10 code, incl. leestekens Ja DiagnoseTypering 512 ICD-10 omschrijving Ja Begindatum DATUM Begindatum record Ja Einddatum DATUM Einddatum record Ja Mutatiedatum DATUM Mutatiedatum record RT_DBC_DIAGNOSE Tabelnaam: RT_DBC_diagnose (referentietabel DBC-diagnosetypering) Veldnaam Veldlengte Inhoud Uniek Verplicht SpecialismeCode 4 AGB Specialismecode Ja DiagnoseTypering 20 DBC Diagnosetypering Ja DiagnoseOms 200 DBC Diagnose omschrijving Ja DiagnoseOmsKort 125 DBC Diagnose korte omschrijving Ja Begindatum DATUM Begindatum record Ja Einddatum DATUM Einddatum record Ja Mutatiedatum DATUM Mutatiedatum record 3.3 RT_SPECIALISME 1. Tabelnaam: RT_Specialisme (referentietabel specialisme) Veldnaam Veldlengte Inhoud waarde is Verplicht uniek SpecialismeCode 4 AGB code specialisme Ja Ja SpecialismeKort 4 Afkorting specialisme Ja Ja Specialisme 50 Omschrijving specialisme Ja Ja Pagina 11 van 12

12 3.4 Afleidingen KT_ICD10 Tabelnaam: KT_ICD10: koppeltabel ICD-10 Veldnaam Veldlengte Inhoud waarde is Verplicht uniek ID_Thesaurus 30 Algemeen sleutelveld Ja ICD10_Code 20 ICD10 code Ja ICD10_Code_ 20 ICD10 code, incl. leestekens Ja Dotted Volgorde Numeriek Numerieke waarde, waarmee de Ja volgorde van rapportage van ICD10 codes wordt vastgesteld. 1=eerste code, 2=tweede, enz. Begindatum DATUM Begindatum record Ja Einddatum DATUM Einddatum record Ja Mutatiedatum DATUM Mutatiedatum record Validatiestatus Logisch True, indien de afleiding is geautoriseerd door het RIVM Validatiedatum DATUM Validatiedatum KT_DBC_DIAGNOSE Tabelnaam: KT_DBC_diagnose (koppeltabel DBC diagnosetypering) Veldnaam Veldlengte Inhoud waarde is Verplicht uniek ID_Thesaurus 30 Algemeen sleutelveld Ja SpecialismeCode 4 DBC Specialismecode Ja DiagnoseTypering 20 DBC Diagnosetypering Zie toelichting Begindatum DATUM Begindatum record Ja Einddatum DATUM Einddatum record Ja Mutatiedatum DATUM Mutatiedatum record Validatiestatus Logisch True, indien de afleiding is geautoriseerd Validatiedatum DATUM Validatiedatum Volgorde Numeriek Numerieke waarde, waarmee de volgorde van DBC afleidingen wordt. 1=eerste code, 2=tweede, enz. Ja Indien de diagnosetypering leeg is, betekent dit dat de term wel in de sub-set van het specialisme moet voorkomen maar dat er bewust geen DBC aan gekoppeld is. Pagina 12 van 12