Course Document

Disclaimer: This is a jointly edited document. Your updates and changes can be seen by others, but let’s collaborate and interoperate!


This document

https://www.mojodojocasahouse.guru/ or 

https://docs.google.com/document/d/1fQwQWVcfdRPgzY6qDX-fr1RDj3j0AzbBhFtGIj0eZPo/edit?usp=drive_link 


Background  

Introduction: Six Word Memoir on Interoperability


We will use https://hapi.fhir.org.


These are some publicly available FHIR servers: https://confluence.hl7.org/display/FHIR/Public+Test+Servers


But I don’t know JSON (and I am too smart to admit I know XML)

JSON Quick Guide: https://www.tutorialspoint.com/json/json_quick_guide.htm 


CRUDS = S stands for Search




JSON editors

Notepad++ (PC)

There are various Chrome extensions

Online: JSONCompare: https://jsoncompare.com/#!/simple/ 

HL7 FHIR 5 STU

http://hl7.org/fhir/

HL7 FHIR 4B

http://hl7.org/fhir/R4B/  

The FHIR Test servers list (not exhaustive, but we try)

https://confluence.hl7.org/display/FHIR/Public+Test+Servers 

The Patient Resource: Generic

Navigate to the Patient Resource: 


Here is a sample patient:


{

  "resourceType": "Patient",

  "id": "WL7WGM-Test1",

  "identifier": [ {

    "use": "usual",

    "type": {

      "coding": [ {

        "system": "http://terminology.hl7.org/CodeSystem/v2-0203",

        "code": "MR"

      } ]

    },

    "system": "urn:oid:1.2.36.146.595.217.0.1",

    "value": "12345",

    "period": {

      "start": "2001-05-06"

    },

    "assigner": {

      "display": "Acme Healthcare"

    }

  } ],

  "active": true,

  "name": [ {

    "use": "official",

    "family": "Golang",

    "given": [ "Peter", "James" ]

  }, {

    "use": "usual",

    "given": [ "Jim" ]

  } ],

  "gender": "male",

  "birthDate": "1974-12-25",

  "_birthDate": {

    "extension": [ {

      "url": "http://hl7.org/fhir/StructureDefinition/patient-birthTime",

      "valueDateTime": "1974-12-25T14:35:45-05:00"

    } ]

  },

  "managingOrganization": {

    "reference": "Organization/1839"

  }

}


Here is your sample patient to create for your lazy teacher--pay close attention to the bolded areas as this will need to be updated based on the information from your note card distributed in class:


{

  "resourceType": "Patient",

  "id": "WL7WGM0523-Test1",

  "identifier": [ {

    "use": "usual",

    "type": {

      "coding": [ {

        "system": "http://terminology.hl7.org/CodeSystem/v2-0203",

        "code": "MR"

      } ]

    },

    "system": "urn:oid:1.2.36.146.595.217.0.1",

    "value": "100",

    "period": {

      "start": "2001-05-06"

    },

    "assigner": {

      "display": "Acme Healthcare"

    }

  } ],

  "active": true,

  "name": [ {

    "use": "official",

    "family": "By FHIR 01",

    "given": [ "Trial" ]

  }, {

    "use": "usual",

    "given": [ "Skippy" ]

  } ],

  "gender": "male",

  "birthDate": "1974-04-01",

  "_birthDate": {

    "extension": [ {

      "url": "http://hl7.org/fhir/StructureDefinition/patient-birthTime",

      "valueDateTime": "1974-04-01T14:35:45-05:00"

    } ]

  },

  "managingOrganization": {

    "reference": "Organization/1839"

  }

}




What options do I have?


Where would I find these options?


How do I find details?


Let’s practice on this resource….


Bundles

https://hl7.org/fhir/bundle.html 

Extensions and Profiles

https://hl7.org/fhir/extensibility.html 


http://hl7.org/fhir/us/core/structuredefinition-us-core-patient.html


Implementation Guides

Disclaimer: The comments of Matt Blackmon should not be construed to be official guidance of the ONC or the RCE, the Sequoia Project, or any official position of the US government. All questions and comments related to QHIN should be directed to rce@sequoiaproject.org


Example: TEFCA Facilitated FHIR Implementation Guide Draft Version 2

https://rce.sequoiaproject.org/wp-content/uploads/2022/12/TEFCA-Facilitated-FHIR-Implementation-Guide-Draft-2-Pilot-Version.pdf 



Some Helpful Resources

The FHIR Cheatsheets (requires Confluence sign-in): https://confluence.hl7.org/pages/viewpage.action?spaceKey=FHIR&title=FHIR+Cheatsheets 

Resources from Firely: https://fhir.fire.ly/wp-content/uploads/2020/10/Cheat_Sheet_R4_OKT_2020.pdf


A Few Things We Did Not Talk About

Security

See the HL7 FHIR Security Event recordings

https://info.hl7.org/hl7-fhir-security-education-event-live 


Terminology


Conformance and Testing

Crucible (MITRE) https://www.projectcrucible.org

Supports FHIR DSTU2, STU3 and R4

FHIR Server Testing

Touchstone (AEGIS.net, Inc.) http://touchstone.com

Supports FHIR DSTU2, STU3, R4 and all intermediate or snapshot (Connectathon) versions

FHIR Client and Server Testing

Firely https://fire.ly/

Software, training, and services

The Sequoia Interoperability Testing Platform

FHIR testing coming in 2022!

NIST FHIR Toolkit https://nist.gov

Project Crucible https://projectcrucible.org/

SMART/Subscriptions bit.ly/smart-fhir-tech (Josh Mandels’s WGM notes)

Too many others to list… growing everyday--do you know of any I missed?



Accelerators

Argonaut

CARIN Alliance

CodeX

Da Vinci

Gravity

Vulcan

The State of FHIR Adoption

https://lantern.healthit.gov/?tab=dashboard_tab Project Lantern


2023 State of FHIR Survey Results September 2023

https://www.hl7.org/documentcenter/public/white-papers/23-HL7-010%20State%20of%20FHIR%20Survey%20Results%20_c3.pdf


Next Steps


Questions

Post here 


Bonus


{

  "resourceType": "Patient",

  "id": "example-patient",

  "text": {

    "status": "generated",

    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">John Doe</div>"

  },

  "identifier": [

    {

      "use": "usual",

      "type": {

        "coding": [

          {

            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",

            "code": "MR",

            "display": "Medical Record Number"

          }

        ],

        "text": "MRN"

      },

      "system": "http://hospital.smarthealthit.org",

      "value": "123456",

      "period": {

        "start": "2024-01-01T00:00:00Z"

      },

      "assigner": {

        "display": "Hospital A"

      }

    }

  ],

  "active": true,

  "name": [

    {

      "use": "official",

      "family": "Doe",

      "given": ["John"],

      "prefix": ["Mr."]

    }

  ],

  "telecom": [

    {

      "system": "phone",

      "value": "+1-555-555-5555",

      "use": "home"

    },

    {

      "system": "email",

      "value": "johndoe@example.com",

      "use": "home"

    }

  ],

  "gender": "male",

  "birthDate": "1980-01-01",

  "address": [

    {

      "use": "home",

      "line": ["123 Main St"],

      "city": "Anytown",

      "state": "Anystate",

      "postalCode": "12345",

      "country": "USA"

    }

  ],

  "maritalStatus": {

    "coding": [

      {

        "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",

        "code": "M",

        "display": "Married"

      }

    ],

    "text": "Married"

  },

  "contact": [

    {

      "relationship": [

        {

          "coding": [

            {

              "system": "http://terminology.hl7.org/CodeSystem/v2-0131",

              "code": "N",

              "display": "Next of Kin"

            }

          ],

          "text": "Next of Kin"

        }

      ],

      "name": {

        "family": "Doe",

        "given": ["Jane"],

        "prefix": ["Mrs."]

      },

      "telecom": [

        {

          "system": "phone",

          "value": "+1-555-555-5556",

          "use": "home"

        }

      ],

      "address": {

        "use": "home",

        "line": ["123 Main St"],

        "city": "Anytown",

        "state": "Anystate",

        "postalCode": "12345",

        "country": "USA"

      },

      "gender": "female",

      "period": {

        "start": "2024-01-01T00:00:00Z"

      }

    }

  ],

  "communication": [

    {

      "language": {

        "coding": [

          {

            "system": "urn:ietf:bcp:47",

            "code": "en",

            "display": "English"

          }

        ],

        "text": "English"

      },

      "preferred": true

    }

  ]

}