The Types of FHIR Guides Growing in the OpenMRS Ecosystem

Across the Global Goods industry, there is growing momentum about how to use FHIR to achieve interoperability, or evidence-based content guidance. However, there also seems to be confusion when we just talk about “a FHIR Implementation Guide (IG)” without clarifying the type of IG that we mean.

For example: This year we have heard other Global Good technicians saying, “We are ready to integrate with OpenMRS because we have a FHIR IG” (but then we discover together that IG was not actually the right type); or, “We don’t see how a FHIR IG will help our Global Goods be interoperable; a FHIR IG is only content guidance… right?” (Not necessarily!)

The Main Point: Global Good Integration through FHIR typically relies on one or more “Model IGs”, whereas the WHO’s SMART Guidelines L3 FHIR approach uses “Content IGs”.

The 2 Major Types of FHIR IGs To Know

These are the Top 2 types that anyone working in Integration or Content standardization in the Global Goods space should know about:

 

1. Model IGs

These are like “Connect the Dots” toolkits, explaining “Here is how our system or standard uses FHIR.” For example, the International Patient Summary says “This is how a Patient Summary puts together immunization, medication and procedure history”. Even more specifically, the OpenMRS Model FHIR IG says “This is how our system’s data model converts our patient information into a FHIR patient resource”.
Examples:

Model IGs are quite powerful for in-country implementation teams who need to connect multiple Global Goods, and want to avoid the headache and overhead of having to learn and map the data models between Global Good A, B, and C. For example, UW ITECH found that once they had enough use-case coverage between the OpenMRS Model IG and the OpenELIS FHIR IG, the time for their team to set up integration between OpenMRS and OpenELIS went from 3-6 months to just ~2 days. Video demo of this here.

Model IGs are quite powerful for in-country implementation teams who need to connect multiple Global Goods.

2. Content IGs: 

Like a FHIR-ized Clinical Practice Guideline. These are effectively “Content Toolkits” that focus specifically on the content you would need in a particular use case or domain (e.g. ANC, HIV, etc), and then uses FHIR’s structure to organize that content. For example, medical terminology/codes/concepts are organized under a “valueSet” directory; whereas decision support rules and business logic are organized under the “planDefinitions” area.

Other IGs: There are other possible types of FHIR IGs, such as Specification IGs. These tell people what patterns to follow when they want to write detailed clinical guidance using the FHIR structure. Maybe not many of us will directly write a Specification IG ourselves, but we may use one to create a _Content_ IG. For example, the Clinical Practice Guidelines IG has informed how subsequent Content IGs were written by the WHO SMART L3 Authoring team.

 

For More Information

More detailed examples available on the FHIR website here: https://build.fhir.org/clinicalreasoning-knowledge-artifact-distribution.html#knowledge-artifact-distribution-ig

 

 

To learn more about OpenMRS and FHIR, explore our FHIR 101 page: https://om.rs/fhir101

The Types of FHIR Guides Growing in the OpenMRS Ecosystem
Scroll to top