search

AuDigitalHealth / ci-fhir-r4

Working drafts of HL7™ FHIR® Release 4 (R4) artefacts authored and maintained by the Informatics Architecture team at the Australian Digital Health Agency.
Other
14 stars 3 forks source link

Categorisation of Health Program Participation Observation #137

Closed dtr-agency closed 2 years ago

dtr-agency commented 2 years ago

DESIGN QUERY: Observation.category - current discussion indicates that ‘therapy’ or ‘social history’ are closest fit from existing Observation Category Codes but these are not ideal. Proposal is to extend the HL7 Int set of concepts with a localised concept for health programs including treatment programs and prevention programs. Proposed concept is ‘program’ with definition ‘Observations that describe an individual’s participation in one or more health programs such as treatment or prevention or public health (e.g. disease screening or substance use therapy)’.

Originally posted by @dtr-agency in https://github.com/AuDigitalHealth/ci-fhir-r4/issues/134#issuecomment-1058662760

dtr-agency commented 2 years ago

Proposal is visible in Health Program Participation Observation (for transition to HL7 AU)

dtr-agency commented 2 years ago

New concept in new code system

Reason New code system
Suggested Name ObservationCategoryCodesAU
Suggested Title Observation Category Codes AU
Suggested Description Extended concept codes for observation category codes for use in an Australian context.
Suggested URI http://terminology.hl7.org.au/CodeSystem/observation-category
Compose requirements Add
code: program
display: Program
Definition: Observations that describe an individual’s participation in one or more health programs such as treatment or prevention or public health (e.g. disease screening or substance use therapy).
Business Reason for Request To support the exchange of health program participation information in Australia as part of the the current work plan initiative: NCSR integration with MHR system.
Additionally, it is expected that an AU localisation will be required to support the expansion of definitions in HL7 AU materials.

Adjusted based on review comments below

dtr-agency commented 2 years ago

Post normalisation design review in https://github.com/AuDigitalHealth/ci-fhir-r4/issues/134 approved this design to progress to draft build and submission of PR to AU FHIR Base for adoption into Australian Base Implementation Guide (AU Base 2) subject to WG Approval and entry into HL7 AU Governance.

dtr-agency commented 2 years ago

Value set design

Reason New value set
Suggested Name ObservationCategoryCodesAUExtended
Suggested Title Observation Category Codes - AU Extended
Suggested URI http://terminology.hl7.org.au/ValueSet/observation-category-extended
Suggested Description Observation Category Codes extended for use in an Australian context.
Terminologies included http://terminology.hl7.org/CodeSystem/observation-category
http://terminology.hl7.org.au/CodeSystem/observation-category
Compose requirements Include all codes defined in http://terminology.hl7.org.au/CodeSystem/observation-category
Import all the codes that are contained in http://hl7.org/fhir/ValueSet/observation-category
Business Reason for Request To support the exchange of health program participation information in Australia as part of the the current work plan initiative: NCSR integration with MHR system.
Additionally, it is expected that an AU localisation will be required to support the expansion of definitions in HL7 AU materials.

Adjusted based on review comments below

dtr-agency commented 2 years ago

@dbojicic-agency, please review the proposed value set, code system, and concept.

dbojicic-agency commented 2 years ago

In review with @dbojicic-agency.

dbojicic-agency commented 2 years ago

Review comments - concept Agree with the proposed concept.

Review comments - code system Minor deviation in the proposed definition from the Conventions for extending a core (or external) terminology in Australia, suggest change to 'Extended concept codes for observation category codes for use in an Australian context.'

Review comments - value set Minor deviation in the proposed URL from the Conventions for extending a core (or external) terminology in Australia, suggest change to 'http://terminology.hl7.org.au/ValueSet/observation-category-extended'.

dbojicic-agency commented 2 years ago

@dtr-agency, completed review, please see comments above.

dtr-agency commented 2 years ago

Content proposal is complete. This material will be developed when develop as part of submitting a draft national health program participation model to AU FHIR Base for adoption into Australian Base Implementation Guide (AU Base 2) subject to WG Approval and entry into HL7 AU Governance via Definition of health program participation observation (summary information) #134

dtr-agency commented 2 years ago

Internal PR .../CIL/repos/au-fhir-base-r4/pull-requests/237 in review with @dbojicic-agency.