Intro HL7 versie 3. Tom de Jong 22 november 2012

Transcriptie

1 Intro HL7 versie 3 Tom de Jong tom@nova-pro.nl 22 november 2012

2 Definitie van Health Level Seven Health Level Seven (HL7) is een applicatieprotocol voor elektronische gegevensuitwisseling in de gezondheidszorg. De aanduiding Seven slaat op het feit dat het protocol betrekking heeft op laag 7 van OSI netwerkmodel (de applicatielaag).

3 HL7 Standaarden Versie 2.x Messaging methodiek (1987+) Versie 3 Messaging methodiek (1995+) Document methodiek (1999+) CDA: Clinical Document Architecture Services methodiek (parallel) Geadopteerd: CCOW: desktop integration Arden Syntax: decision support 3

4 HL7 v2 (A01-)bericht MSH ^~\& ZIS AMC ADT^A P 2.2 AL NE <cr> EVN A <cr> PID "" ^9^M11 Vandenberg^Anne^E^^"" F Prinsengracht^22^Amsterdam^^1000PJ^""^P "" "" "" "" <cr> Message Type Segment Segment Field Subfield Subfield

5 HL7 v3: Fragment december 12 5 Stichting HL7 Nederland

6 Wat is essentieel aan HL7 v3? Niet berichten, documenten of services. Niet XML of SOAP of rooksignalen. Niet AORTA/LSP of CCR/CCD. Wel: referentie informatie model (RIM) Wel: conceptuele modelleermethode (HDF) Wel: scheiding tussen data- en procesmodel Wel: datatypes (elementaire bouwstenen) Wel: regels voor identificatie & classificatie

7 Versie 3 is gebaseerd op modellen Modellen in V3 bieden een taal voor het begrijpen en vastleggen van de betekenis, de vorm en het gedrag van gegevensuitwisseling in de gezondheidszorg Berichten zijn het resultaat van het samenvoegen van gegevens- en procesmodellen: wanneer verstuur ik wat?

8 Informatiemodellen Elk informatiemodel binnen HL7 versie 3 bestaat uit de volgende componenten: Klassen (classes), hun attributen (attributes) en de associaties ertussen (relationships) Data types voor alle attributen en vocabulary domains voor gecodeerde attributen

9 Reference Information Model RIM Vier+twee basisklassen van het RIM (backbone) Role Relationship Act Relationship Entity Role Participation Act

10 Person classcode*: <= PSN determinercode*: <= PSN name: EN [0..*] birthtime: TS [0..*] model voorbeeld Person A Practitioner perfomer Person B Patient subject Anamnese 1..1 patientperson Person Patient classcode*: <= PAT id*: II [1..1] addr: AD [0..1] telecom: TEL [0..*] 1..1 patient subject typecode*: <= SBJ Anamnese classcode* <= xy moodcode* <= xy id*: II [1..1]... Organization playedby scopedby Practitioner classcode*: <= PRT id*: II [1..1] telecom: TEL [0..*] 1..1 practitioner performer typecode*: <= PRF time: IVL<TS>

11 Reference Information Model RIM Modelering door specialisatie + klonen Persoon A classcode Arts classcode Uitvoerder typecode Anamnese classcode Persoon B classcode Patiënt classcode Object typecode RIM Entity Role Participation Act

12 HL7 Development Framework (HDF) scheiding van data- en (optioneel) procesmodel Use-Case Storyboard Dynamic Interaction analysis: Interaction Model Static Domain analysis: D-MIM Document design: CDA Message design: R-MIM Implementable Message/Document Specification (based on ITS)

13 Data Types Data types zijn de basale bouwstenen voor het samenstellen van iedere gegevensstructuur in HL7 versie 3, of het nu gaat om berichten of documenten. Data types bepalen de eigenschappen van een gegevenselement, maar ook de vorm waarin het wordt weergegeven (d.m.v. vaste XML representatie). Drie releases in gebruik: DT R1 DT R1.1 DT R2

14 HL7 v3 Basic Data types (Excerpt) ANY BL Boolean ST Character String INT Integer Number REAL Real Number QTY Quantity PQ Physical Quantity II Instance Identifier ED Encapsulated Data CV Code Value CE Coded Equivalent CD Concept Descriptor EN Entity Name PN Person Name ON Organization Name TEL Telecom Address AD Postal Address TS Point in Time 14

15 Representatie van data types Elk data type heeft: Abstracte specificatie (semantiek, eigenschappen) XML representatie (syntax, formaat, structuur) XML representatie is vast binnen HL7v3 dus gelijke vorm in berichten en documenten stabiele bouwstenen voor alle HL7v3 varianten Voorbeelden: <id root=. extension=. /> <code code= codesystem=. displayname=. > <translation code=. codesystem=. > <translation code=. codesystem=. > </code>

16 V3 coderingssysteem (bijv. G-Standaard als bron van codes)

17 Nabrander Al het voorgaande geldt voor ALLE implementatievormen (dus bijv. bij berichten via AORTA/DBC Grouper, documenten zoals CCD) van HL7v3. Je kunt dus niet zeggen: HL7v3 óf CCD, want CCD is een vorm van CDA (later meer) en CDA is een vorm van HL7 versie 3. Tot zover de overeenkomsten nu de verschillen

18 De smaken binnen HL7v3: uitwisselmechanismes

19 Gegevensmodel (bijv. deel van medisch dossier van specialist)

20 Message payload Transmission Wrapper Transport: van waar naar waar? ControlAct Wrapper Transactie: door wie en waarom? Payload

21 Transmission wrapper Entry Point Message (Message) Id: II [1..1] interactionid: II [1..1] creationtime: profileid: Sender Receiver Device classcode <= DEV Id: II [1..*] Telecom: BAG<TEL> 0..1 Agent classcode: AGNT Exit Point ControlActProcess classcode <= CACT ControlAct Wrapper Stub 0..1 Organization classcode <= ORG Id: Name: Telecom: BAG<TEL>

22 ControlAct Wrapper Stub 22

23 Control Act Wrapper Entry Point CMET (Assigned) R_AssignedPerson [universal] (COCT_MT090100) 0..* 0..* 0..* AuthorOrPerformer typecode: CS time: IVL<TS> signaturecode: InformationRecipient typecode: CS DataEnterer typecode: CS ControlActProcess classcode <= CACT code: CD CWE [0..1] <=HL7TriggerEventCode effectivetime: IVL<TS> [0..1] Payload Stub Subject typecode: <= SUBJ contextconductionind: BL Act classcode <= ACT 0..* Exit Point

24 ControlAct Wrapper Payload Stub

25 Interacties in het berichtmodel A B Order of Query Initial Trigger Accept Acknowledgement Application Response - OK OR Execute reciever responsibilities Application Response - Reject Notificatie Initial Trigger Notification NO reciever responsibilities Accept Acknowledgement 25

26 Interaction = Payload (Static Model) + wrappers, Trigger Event & Receiver Responsibilities Transmission Wrapper ControlAct Wrapper Payload

27 Berichten als body bij aanroepen van een web service (bijv. AORTA) WSDL Voorschriftbericht.wsdl Service Voorschriftbericht_Service Service Location Diagram Communicatie op HTTPniveau: Iedere pijl van client naar server is een HTTP-request, iedere pijl terug van server naar client daaronder is de bijbehorende HTTP response. Voorschriftbericht Operations Voorschriftbericht_ActiveerM edicatievoorschrift SOAP Action Input "urn:hl7-org:v3/voorschriftbericht_activeermedicatievoorschrift" hl7:porx_in932000nl Schema Voorbeelden Output PORX_IN932000NL.xsd PORX_EX932000NL_01.xml PORX_EX932000NL_02.xmlPORX_EX932000NL_03.xml hl7:mcci_in Schema Voorbeelden MCCI_IN xsd MCCI_EX000002_01.xml MCCI_EX000002_01_TOCK.xml MCCI_EX000002_02.xmlMCCI_EX000002_03.xml MCCI_EX000002_05.xml

28 Zelfde payload, maar nu in CDA document Clinical Document Patient Header Provider Body Body Structures (Sections) Body Entries (Clinical Statements) Observation Procedure Encounter Medication...

29 29 <ClinicalDocument>... <StructuredBody> <Section> <text>...</text> <Observation>... </Observation> <Observation> <reference> <ExternalObservation>... </ExternalObservation> </reference> </Observation> </Section> <Section> <Section>...</Section> </Section> </StructuredBody> </ClinicalDocument> D O C U M E N T B O D Y Header S E C T I O N S Narrative Block E N T R I E S External References Main Components of CDA

30 CDA Sections: Level 1 Level 1 <component> <! History --> <section> <title> : History</title> <text> Onset of asthma in his teens. He was hospitalized twice last year, and already twice this year. </text> </section> </component> 30

31 CDA sections: Level 2 Level 2 <component> <! History --> <section> <code code=" " codesystem=" " codesystemname="loinc"/> <title> : History</title> <text> Onset of asthma in his teens. He was hospitalized twice last year, and already twice this year. </text> </section> </component> 31

32 CDA sections: Level 3 Level 3 procedures Obs <component> <section> <code code=" " codesystemname="loinc" codesystem=" /> <title> : History</title> <text> Onset of <content ID="a1">asthma</content> in his teens. He was hospitalized twice last year, and alread twice this year. </text> <entry typecode="comp"> <observation> <code code=" " codesystem=" " codesystemname="snomed CT" displayname="asthma"> <originaltext> <reference value="#a1"/> </originaltext> </code> </observation> </entry> </section> </component>

33 Zelfde betekenis, andere verpakking (m.a.w. ander uitwisselmechanisme) Document header en sections vervullen vergelijkbare rol als wrappers in berichten. Zijn alleen niet gericht op transport en transactie, maar op documentkenmerken, tekstuele weergave en sectie-indeling.

34 Verschil in XML Schema (representatie over de lijn ): Bij messaging: elke payload eigen Schema (gebaseerd op R-MIM van bijbehorend model). Bij CDA document: maar één XML Schema. Elke invulling ervan gebeurt d.m.v. templates. XML Schema van huidige CDA Release (R2) bevat slechts een deel van RIM elementen. Gevolg van bovenstaande zaken is: Niet alle concepten zijn (zuiver) weer te geven in CDA. Representatie van dezelfde (model)concepten zal (meestal) tot een verschillende representatie leiden.

35 Accepteer dat ze vooralsnog beide bestaan, maar laat ze convergeren: Nu reeds mogelijk: Gebruik indien mogelijk XML transformaties Gebruik voor bestaande bouwstenen extensies op CDA om (bericht)modellen te kunnen hergebruiken Opties op termijn: Verander clinical statement in CDA zodanig dat het alle berichtmodellen kan afdekken (CDA R3) Baseer berichtmodellen niet meer op aparte XML Schema s, maar op datzelde clinical statement!