OpenHIE Architecture Specification
4.0
4.0
  • Specification Overview
  • How to use the Specification
  • Architecture Specification
    • Architecture
    • Architectural Principles
    • Standards and Profiles
  • OpenHIE Component Specifications
    • Non-Functional Requirements
    • Client Registry (CR)
    • OpenHIE Facility Registry (FR)
    • OpenHIE Finance and Insurance Service (FIS)
    • OpenHIE Health Management Information System (HMIS)
    • OpenHIE Health Worker Registry (HWR)
    • OpenHIE Interoperability Layer (IOL)
    • OpenHIE Logistics Management Information System (LMIS)
    • OpenHIE Product Catalogue (PC)
    • OpenHIE Shared Health Record (SHR)
    • OpenHIE Terminology Service (TS)
    • Point-Of-Care Systems
  • Workflow (Exchange) Specification
    • Aggregate Reporting Workflows
      • Export Aggregate Data
      • Validate and Save Aggregate Data
    • Alerting / Sending Reminders or Information
      • Send Client Alert Workflow
      • Send Health Worker Alert Workflow
    • Care Services Discovery
      • Query Health Worker and/or Facility Records Workflow
      • Query Care Services Records Workflow
      • Search Care Services Workflow
      • Request Care Services Updates Workflow
    • Laboratory Work Flows
      • Order Laboratory Test
      • Report Lab Results
    • Patient Identity Management Workflows
      • Create Patient Demographic Record Workflow
      • Update Patient Demographic Record Workflow
      • Query Patient Demographic Records by Identifier Workflow
      • Query Patient Demographic Records by Demographics Workflow
    • Shared Health Record
      • Save Patient-level Clinical Data Workflow
      • Query Patient-level Clinical Data Workflow
    • Terminology Service Workflows
      • Expand Value Set
      • Translate Code
      • Verify Code Existence
      • Verify Code Membership
      • Query Value Set
      • Query Code Systems
      • Query Concept Maps
      • Lookup Code
    • Vaccine Workflows
  • How to Provide Feedback and Input
  • Change Log and Versioning
Powered by GitBook
On this page
  • Interaction Description
  1. Workflow (Exchange) Specification
  2. Terminology Service Workflows

Expand Value Set

PreviousTerminology Service WorkflowsNextTranslate Code

Last updated 3 years ago

This transaction allows a PoS, or any OHIE component, to access terminological information in the terminology service and retrieve the set of all Concepts in the Value Set. Rather than testing each code contained in an incoming patient data message for Value Set membership, this operation enables a component to "cache" the Value Set members and test individual membership locally, avoiding extensive network overhead. Due to the likely updating of Value Set definitions, on the other hand, components should periodically refresh their local copy of the expansion.

Both external systems and systems inside the HIE may perform this transaction directly with the TS. The sequence diagram below shows the steps that occur for a system using this transaction.

  1. Expansion: Retrieve the set of Concept Codes that are members of the HIV Value Set.

Workflow Maturity

Mature

  • One or more OpenHIE implementations of this workflow exist in one or more countries

  • Workflow is defined and ARB approved

  • Workflow is supported by mature standards

Standards*

This workflow implements the IHE IT Infrastructure Technical Framework Supplement - Sharing Valuesets, Codes, and Maps (SVCM) Transaction: Expand Value Set ITI-Y3.

Assumptions and Prerequisites

The required ValueSets and associated CodeSystems have been preloaded into the Terminology Service.

Actors

  • PoS - The point-of-service system or any other HIE component that is requesting the expansion.

  • TS - Stores the curated, official version of the Value Set for the health system.

Interaction Description

The following is a description of the interaction steps.

#

Interaction

Data

Transaction Options

1

ValueSet expansion request

The expand request is triggered by a PoS or other HIE component.

Input: The target ValueSet.

FHIR ValueSet Resource, $expand operation

2

ValueSet expansion response

The response is sent back to the requesting system.

Output: a ValueSet Resource containing the list of Concept members.

FHIR ValueSet Resource, $expand operation

The FHIR ValueSet expand operation: . HL7 FHIR Specifications v3.0 or higher support expand. The response is Value Set Resource that contains a collection of all the Concepts in the Value Set. If Concept attributes are to be returned with the collection, the attributes can be specified in the expand request.

http://build.fhir.org/valueset-operation-expand.html