# Expand Value Set

 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             | <p><img src="https://lh5.googleusercontent.com/Vp6XBRGu-U_Dmd5EKNpCZvEEum0CxOcHOj9NgHh8UMMNLMlXHmLcUE_YWueDRr4uqWLzpPfzSBLJ2k33XQIelLypjQ4wyrD17-t33GtLa8fFxW9AYDvXhiJmBl4VaLgKDg" alt=""></p><p>    <strong>Mature</strong></p> | <p></p><ul><li><strong>One or more OpenHIE implementations of this workflow exist  in one or more countries</strong></li><li><strong>Workflow is defined and ARB approved</strong></li><li><strong>Workflow is supported by mature standards</strong></li></ul>                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Standards\*                   |                                                                                                                                                                                                                                  | <p>The FHIR ValueSet expand operation: <a href="http://build.fhir.org/valueset-operation-expand.html"><http://build.fhir.org/valueset-operation-expand.html></a>. 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. </p><p>This workflow implements the IHE IT Infrastructure Technical Framework Supplement - Sharing Valuesets, Codes, and Maps (SVCM) Transaction: Expand Value Set ITI-Y3.</p> |
| Assumptions and Prerequisites |                                                                                                                                                                                                                                  | The required ValueSets and associated CodeSystems have been preloaded into the Terminology Service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Actors                        |                                                                                                                                                                                                                                  | <p></p><ul><li>PoS - The point-of-service system  or any other HIE component that is requesting the expansion.  </li><li>TS - Stores the curated, official version of the Value Set for the health system.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                             |

## Interaction Description&#x20;

The following is a description of the interaction steps.&#x20;

![](https://lh6.googleusercontent.com/tzzPlEZXJf_0yFSnLH8UKDEBsMSHT7ga4d4dBhMz5D01i1SVUHyjiwmsBkDabqtJG5C1tj7A4AUH1F3oQEYWRIAi1KKNtptfpkTGZJbY7f4wUBOY4T8Ik897x--PciLPEw)

| # | Interaction                 | Data                                                                                                                                 | Transaction Options                       |
| - | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- |
| 1 | ValueSet expansion request  | <p>The expand request is triggered by a PoS or other HIE component.</p><p>Input: The target ValueSet.</p>                            | FHIR ValueSet Resource, $expand operation |
| 2 | ValueSet expansion response | <p>The response is sent back to the requesting system.</p><p>Output: a ValueSet Resource containing the list of Concept members.</p> | FHIR ValueSet Resource, $expand operation |

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.ohie.org/arch-spec/main-1/introduction/terminology-service-workflow/expand-value-set.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.