- PSS: 2-To-FHIR
- ListServ: v2-to-fhir@lists.hl7.org
- Zulip: https://chat.fhir.org/#narrow/stream/179188-v2-to.20FHIR
- Conference Call Schedule: http://www.hl7.org/concalls/Default.aspx?ref=nav.
- Every week, Monday 1 - 2 PM ET AND Thursday 11 AM - 12 PM ET
- Timeline: https://docs.google.com/spreadsheets/d/1VGxDBN5veBPhMISyRlL45CxZ9T5VwrmS0729rnTUYas/edit#gid=0
- IG Github: https://github.com/HL7/v2-to-fhir
- Meeting Minutes
- v2-to-FHIR Mapping Review Process
- Connectathon 26
- JIRAs
- v2-FHIR JIRAs - Reviewed with same in block votes to finalize and some assigned to be updated (hopefully before ballot, otherwise carry-over).
- non-v2-FHIR Open JIRAs
- [FHIR-33007] Aligning Appointment.serviceType and .basedOn - Suggest to drop this.
- [FHIR-33038] Observation needs a subID extension - Jira (hl7.org) - Waiting for the extension to have been created.
- [FHIR-31505] Add Identity Unknown Extension to Patient - Jira (hl7.org) - Waiting for the extension to have created
- [FHIR-31587] Add Nature of Abnormal Test Extension to Observation - Jira (hl7.org) - Waiting for the extension to have created
- [FHIR-31586] Add Analysis Date/Time Extension to Observation - Jira (hl7.org) - Waiting for the extension to have created
- [FHIR-33036] Observation needs type and subtype extension - Jira (hl7.org) - Don't need OBX-29 extension as that can be asserted in the message logic. Updated the JIRA with alternatives to address OBX-30.
- [FHIR-33037] Observation Location extension needed - Jira (hl7.org) - Need to address with FHIR-I
- [FHIR-31611] Add Callback Number Extension to ServiceRequest - Jira (hl7.org) - Waiting for the extension to have created
- [FHIR-34194] Add businessEvent extension - Jira (hl7.org) - Needs discussion with either FHIR-I, OO on FHIR, or COW/FOE. Suggest to start with COW/FOE.
- [FHIR-43298] Attachment.data only supports binary64 - Jira (hl7.org) - Waiting for FHIR-I guidance.
- Still to be applied to v2-FHIR IG/spreadsheets:
- [FHIR-33066] Identifier data type could use elements for check digits and assigning facility - Jira (hl7.org) - Pending clarifications to confirm identifier and organization
- [FHIR-31541] Add Note Type Extension to Annotation Data Type - Jira (hl7.org) - Applied - Pending clarification where it is.
- [FHIR-34063] MessageHeader needs a v2Profile extension - Jira (hl7.org) - Waiting for reference to the extension created
Topics
- Mapping Worksheets:
- If referencing a v2 table (value set or code system) in the FHIR coding.system, then use this table to find the correct code system: https://confluence.hl7.org/download/attachments/20022006/v2-tables.xml?api=v2.
- Note that for the table one must use the csuri value, not the table specific OID or uri as same tables share the same code system, e.g., HL70125 is a value set on HL70440.
- gitHub: https://github.com/HL7/v2-to-fhir
- v2-to-FHIR IG: https://build.fhir.org/ig/HL7/v2-to-fhir/branches/master/index.html
- Note that for Messages the different .xml, .json, .turtle, .fsh are available from the mapping page (e.g., https://build.fhir.org/ig/HL7/v2-to-fhir/branches/master/ConceptMap-message-adt-a01-to-bundle.html), but for segment and data type pages you have to construct the URL by inserting your favorite format before the .html part. For example: Change https://build.fhir.org/ig/HL7/v2-to-fhir/branches/master/ConceptMap-segment-obrdiagnosticreport-to-diagnosticreport.html to https://build.fhir.org/ig/HL7/v2-to-fhir/branches/master/ConceptMap-segment-obrdiagnosticreport-to-diagnosticreport.json.html
- Old confluence pages: Implementation Guide
- Profiles
- v2 Sample Messages
- To add samples or output, you can update the page directly, or let Hans know if you don't have an account yet.
- You do need a JIRA/Confluence account. Instructions to create one are here: http://www.hl7.org/permalink?confluence.
- v2 Message Sample Generator: https://github.com/google/simhospital
- HL7 Spy
- v2-to-FHIR: Test Message Conversions
- Extensions
- Extension Proposal List
Format Guidance
See http://hl7.org/fhir/versions.html#extensions for format when pre-adopting from R5.
- See https://chat.fhir.org/#narrow/stream/179202-terminology/topic/Conveying.20original.20terminology.20in.20FHIR for discussion on originalCodeableConcept / code-specification.
- Format for extensions:
- Column J:
- full extension paths with assignments of the url.
- Column K:
- extension??-abc for those we do not know yet whether they would be best done in core vs. next version.
- Column J:
- Format for extensions:
- Validation Rule
- Error Log - Record errors you find in the mapping tables that need to be fixed. Note that these are not meant to include errors to the wrong resource/attribute/component, only errors in syntax and essential data to enable mapping.
- CWE Mapping Discussion
- Write Up: CWE Advice mapping
- Spreadsheet:
- Write Up: CWE Advice mapping
Connectathon Pages:
Other Helpful/Insightful Links:
- Microsoft's Google Spreadsheet Download Tool.
- https://fhirblog.com/2019/05/09/converting-v2-to-fhir/
- http://hl7.org/fhir/resource-operation-convert.html
Known Implementation Projects
Please enter your project if you are contributing to and/or using the mappings as they are being defined.
Approach:
- Data Type Mapping
- Initially target creating worksheets/templates to assist Segment/Field mapping.
- Do so as we go, i.e., work on a segment and populate the data type mappings as we run into them.
- Create flavors as needed.
- Segment/Field Mapping
- Target this as balloted content.
- Create flavors as needed based on use in various messages.
- Segments in priority order for now: MSH, PID, PD1, NK1(RelatePerson/Patient.contact), ROL/PRT, (IN1), PV1, PV2, ORC, OBR, OBX, RXO?, RXE?, RDS?, RXA, RXR, SPM, NTE
- Messages
- Target this as balloted content.
- Message in priority order for now: A01, A04. ORM/OMG, OML, ORU, VXU, DFT
- v2-to-FHIR Security/Access Restriction
Mapping topics to discuss
- The use of the Provenance resource when "entering" information is part of the segment (e.g. ORC-10)
- How to best populate Resource.id and what are the implications for future FHIR queries/searches
- Technically this doesn't seem to be required, but it seems pretty foundational
- If we do decide to populate this, how do it for resources that are the central focus of the v2 message (eg. what is Provider.id for the administering provider of an immunization?)
- The need to provide guidance on required resource elements (if any) when there isn't a direct equivalent in the v2 message
- Many segments use Action Code (Add, Delete, Update) - we should talk about how to handle this information. Does a D map to a status of "entered-in-error"? Do we need to map values of A and U?
- Where FHIR providers a preferred, extensible or required value set and v2 has commonly used table values, do we want to provide a mapping between value sets?
- We should review Zulip threads related to messaging including:
- When we get to medication messages, review the Zulip thread here: https://chat.fhir.org/#narrow/stream/179188-v2-to.20FHIR/topic/RDE_O11.20to.20MedicationRequest.20and.20Medication/near/162455908
- People are asking about what event types to use
- How to handle fields containing ""
- What guidance if any should we give on using contained resources when converting a message to a FHIR bundle.
- We should at least mention deduplication as a implementation decision
- For example, if the same provider shows up multiple times in a message (multiple PRT segments or multiple ORC segments, each with ORC-12 populated), should the transformation create one Practitioner resource for each instance in the message or just create one and reference it multiple times?
- If the transformer does deduplication, what level of "certainty" should they have before deciding multiple occurrences do represent the same person?
- We should come up with a map of OBX-2 values to FHIR data types
Attachments
- PSS: 2-To-FHIR
- ListServ: v2-to-fhir@lists.hl7.org
- Zulip: https://chat.fhir.org/#narrow/stream/179188-v2-to.20FHIR
- Conference Call Schedule: http://www.hl7.org/concalls/Default.aspx?ref=nav.
- Every week, Monday 1 - 2 PM ET AND Tuesday 11 AM - 12 PM ET
- Timeline: https://docs.google.com/spreadsheets/d/1VGxDBN5veBPhMISyRlL45CxZ9T5VwrmS0729rnTUYas/edit#gid=0
- IG Github: https://github.com/HL7/v2-to-fhir
- Meeting Minutes
- v2-to-FHIR Mapping Review Process
- Connectathon 26
Topics
- Mapping Worksheets:
- If referencing a v2 table (value set or code system) in the FHIR coding.system, then use this table to find the correct code system: https://confluence.hl7.org/download/attachments/20022006/v2-tables.xml?api=v2.
- Note that for the table one must use the csuri value, not the table specific OID or uri as same tables share the same code system, e.g., HL70125 is a value set on HL70440.
- gitHub: https://github.com/HL7/v2-to-fhir
- v2-to-FHIR IG: https://build.fhir.org/ig/HL7/v2-to-fhir/branches/master/index.html
- Note that for Messages the different .xml, .json, .turtle, .fsh are available from the mapping page (e.g., https://build.fhir.org/ig/HL7/v2-to-fhir/branches/master/ConceptMap-message-adt-a01-to-bundle.html), but for segment and data type pages you have to construct the URL by inserting your favorite format before the .html part. For example: Change https://build.fhir.org/ig/HL7/v2-to-fhir/branches/master/ConceptMap-segment-obrdiagnosticreport-to-diagnosticreport.html to https://build.fhir.org/ig/HL7/v2-to-fhir/branches/master/ConceptMap-segment-obrdiagnosticreport-to-diagnosticreport.json.html
- Old confluence pages: Implementation Guide
- Profiles
- v2 Sample Messages
- To add samples or output, you can update the page directly, or let Hans know if you don't have an account yet.
- You do need a JIRA/Confluence account. Instructions to create one are here: http://www.hl7.org/permalink?confluence.
- v2 Message Sample Generator: https://github.com/google/simhospital
- HL7 Spy
- v2-to-FHIR: Test Message Conversions
- Extension Proposal List
- Validation Rule
- Error Log - Record errors you find in the mapping tables that need to be fixed. Note that these are not meant to include errors to the wrong resource/attribute/component, only errors in syntax and essential data to enable mapping.
- CWE Mapping Discussion
- Write Up: CWE Advice mapping
- Spreadsheet:
- Write Up: CWE Advice mapping
Connectathon Pages:
Other Helpful/Insightful Links:
- Microsoft's Google Spreadsheet Download Tool.
- https://fhirblog.com/2019/05/09/converting-v2-to-fhir/
- http://hl7.org/fhir/resource-operation-convert.html
Known Implementation Projects
Please enter your project if you are contributing to and/or using the mappings as they are being defined.
Approach:
- Data Type Mapping
- Initially target creating worksheets/templates to assist Segment/Field mapping.
- Do so as we go, i.e., work on a segment and populate the data type mappings as we run into them.
- Create flavors as needed.
- Segment/Field Mapping
- Target this as balloted content.
- Create flavors as needed based on use in various messages.
- Segments in priority order for now: MSH, PID, PD1, NK1(RelatePerson/Patient.contact), ROL/PRT, (IN1), PV1, PV2, ORC, OBR, OBX, RXO?, RXE?, RDS?, RXA, RXR, SPM, NTE
- Messages
- Target this as balloted content.
- Message in priority order for now: A01, A04. ORM/OMG, OML, ORU, VXU, DFT
- v2-to-FHIR Security/Access Restriction
Mapping topics to discuss
- The use of the Provenance resource when "entering" information is part of the segment (e.g. ORC-10)
- How to best populate Resource.id and what are the implications for future FHIR queries/searches
- Technically this doesn't seem to be required, but it seems pretty foundational
- If we do decide to populate this, how do it for resources that are the central focus of the v2 message (eg. what is Provider.id for the administering provider of an immunization?)
- The need to provide guidance on required resource elements (if any) when there isn't a direct equivalent in the v2 message
- Many segments use Action Code (Add, Delete, Update) - we should talk about how to handle this information. Does a D map to a status of "entered-in-error"? Do we need to map values of A and U?
- Where FHIR providers a preferred, extensible or required value set and v2 has commonly used table values, do we want to provide a mapping between value sets?
- We should review Zulip threads related to messaging including:
- When we get to medication messages, review the Zulip thread here: https://chat.fhir.org/#narrow/stream/179188-v2-to.20FHIR/topic/RDE_O11.20to.20MedicationRequest.20and.20Medication/near/162455908
- People are asking about what event types to use
- How to handle fields containing ""
- What guidance if any should we give on using contained resources when converting a message to a FHIR bundle.
- We should at least mention deduplication as a implementation decision
- For example, if the same provider shows up multiple times in a message (multiple PRT segments or multiple ORC segments, each with ORC-12 populated), should the transformation create one Practitioner resource for each instance in the message or just create one and reference it multiple times?
- If the transformer does deduplication, what level of "certainty" should they have before deciding multiple occurrences do represent the same person?
- We should come up with a map of OBX-2 values to FHIR data types