201701 Medication Track

Return to January 2017 Proposals

Medication Track

Coordinated with other related Connectathon tracks

• US-Core IG

Submitting WG/Project/Implementer Group

Pharmacy FHIR Profiles Project

Pharmacy Work Group

Justification

This project is intended to support the Pharmacy WG in moving the Pharmacy FHIR resources to a higher maturity level based on feedback from the Argonaut Project, HL7 work groups and industry implementers. The key objective for this project is to use implement and test the following FHIR Medication related resources and the corresponding US-Core medication Profiles:

• Medication and US Core Medication

• Medication Order and US Core Medication Order

• Medication - Medication Statement and US Core Medication Statement

• Medication Administration

• Medication Dispense

In addition to implementing the existing US-Core medication Profiles this tract will examine and support the development of new proposed US-Realm profiles for MedicationAdministration and MedicationDispense.

We will also introduce the scenario for search across all Medication Resources using common search parameter as it is described in the Core Specification

Proposed Track Lead

See Connectathon_Track_Lead_Responsibilities

Melva Peters

Brett Marquard

Eric Haas

Expected participants

Please sign up!

If you're working on a server, please complete the "servers" tab of the Signup Spreadsheet **This time around you'll need to update the `status` flag to indicate whether you've begun work (or completed work), so clients will know when to start testing.** You'll also share details about how a developer can obtain OAuth client credentials (`client_id` for public apps, or a `client_id` and `client_secret` for confidential apps) as well as user login credentials. You might consider simply sharing a set of fixed credentials in this spreadsheet, or else directing users to a web page where they can complete self-service registration. If absolutely necessary, you can ask developers to e-mail you directly.

If you're working on a client, please complete the "clients" tab of the Spreadsheet. You'll also need to update the `status` flag to indicate whether you've begun work (or completed work).

Roles

(reproduced from Argonaut Project implementation-program Resprint)

Server/EHR

If you're working on a server, please complete the "servers" tab of the Sprints Spreadsheet (see above). You'll need to update the status flag to indicate whether you've begun work (or completed work), so clients will know when to start testing. You'll also share details about how a developer can obtain OAuth client credentials (client_id for public apps, or a client_id and client_secret for confidential apps) as well as **user login credentials. The preferred approach is to direct users to a web page where they can complete self-service registration. (If absolutely necessary, you can ask developers to e-mail you directly.) Work on your OAuth implementation

The expectation is that servers will follow Argonaut’s best-practice approach by implementing the OAuth2-based SMART on FHIR authorization specification. To make this more approachable for new implementers, you can think about handling security in four parts:

1. open server. Before you get OAuth working, and even once you have an OAuth-secured server, it can be helpful to host sample data at a totally unprotected https endpoint. This facilitates testing, debugging, and exploration
2. Standalone launch. Following SMART’s “standalone launch” flow means that the user (patient, or clinician) can begin by launching an app, and from there can engage in a “connect to my EHR” workflow. This approach is suitable for MU3 patient API access.
3. EHR launch. Following SMART’s “EHR launch” flow means that the user (patient, or clinician) can begin from the EHR or potal, and launch an app from there, ensuring that the app learns the context about the surrounding EHR or portal environment. This approach is suitable for embedding apps in an EHR or portal.
4. Single Sign-on. Using the OAuth2-based OpenID Connect framework for single sign-on, your authorization server can “vouch for” a user’s identity. This helps ensure that users don’t need to create a new account, with new credentials, for every app they use. This approach to SSO can be used with either of SMART’s launch flows.

Client

If you're working on a client, please complete the "clients" tab of the Sprints Spreadsheet (see above) . You'll also need to update the status flag to indicate whether you've begun work (or completed work).

Scenarios

Dedicated Zulip chat stream for this Track.

Use cases:

1. Patient and Provider access to a patient’s active and historical medication list
2. Patient and Provider updates to a patient’s active and historical medication list
3. Create a new outpatient Prescription

Return to January 2017 Proposals

Medication Track

Coordinated with other related Connectathon tracks

• US-Core IG

Submitting WG/Project/Implementer Group

Pharmacy FHIR Profiles Project

Pharmacy Work Group

Justification

This project is intended to support the Pharmacy WG in moving the Pharmacy FHIR resources to a higher maturity level based on feedback from the Argonaut Project, HL7 work groups and industry implementers. The key objective for this project is to use implement and test the following FHIR Medication related resources and the corresponding US-Core medication Profiles:

• Medication and US Core Medication

• Medication Order and US Core Medication Order

• Medication - Medication Statement and US Core Medication Statement

• Medication Administration

• Medication Dispense

In addition to implementing the existing US-Core medication Profiles this tract will examine and support the development of new proposed US-Realm profiles for MedicationAdministration and MedicationDispense.

Proposed Track Lead

See Connectathon_Track_Lead_Responsibilities

Melva Peters

Brett Marquard

Eric Haas

Expected participants

Please sign up!

If you're working on a server, please complete the "servers" tab of the Signup Spreadsheet **This time around you'll need to update the `status` flag to indicate whether you've begun work (or completed work), so clients will know when to start testing.** You'll also share details about how a developer can obtain OAuth client credentials (`client_id` for public apps, or a `client_id` and `client_secret` for confidential apps) as well as user login credentials. You might consider simply sharing a set of fixed credentials in this spreadsheet, or else directing users to a web page where they can complete self-service registration. If absolutely necessary, you can ask developers to e-mail you directly.

If you're working on a client, please complete the "clients" tab of the Spreadsheet. You'll also need to update the `status` flag to indicate whether you've begun work (or completed work).

Roles

(reproduced from Argonaut Project implementation-program ReConnectathon)

Server/EHR

If you're working on a server, please complete the "servers" tab of the Connectathons Spreadsheet (see above). You'll need to update the status flag to indicate whether you've begun work (or completed work), so clients will know when to start testing. You'll also share details about how a developer can obtain OAuth client credentials (client_id for public apps, or a client_id and client_secret for confidential apps) as well as **user login credentials. The preferred approach is to direct users to a web page where they can complete self-service registration. (If absolutely necessary, you can ask developers to e-mail you directly.) Work on your OAuth implementation

The expectation is that servers will follow Argonaut’s best-practice approach by implementing the OAuth2-based SMART on FHIR authorization specification. To make this more approachable for new implementers, you can think about handling security in four parts:

1. open server. Before you get OAuth working, and even once you have an OAuth-secured server, it can be helpful to host sample data at a totally unprotected https endpoint. This facilitates testing, debugging, and exploration
2. Standalone launch. Following SMART’s “standalone launch” flow means that the user (patient, or clinician) can begin by launching an app, and from there can engage in a “connect to my EHR” workflow. This approach is suitable for MU3 patient API access.
3. EHR launch. Following SMART’s “EHR launch” flow means that the user (patient, or clinician) can begin from the EHR or potal, and launch an app from there, ensuring that the app learns the context about the surrounding EHR or portal environment. This approach is suitable for embedding apps in an EHR or portal.
4. Single Sign-on. Using the OAuth2-based OpenID Connect framework for single sign-on, your authorization server can “vouch for” a user’s identity. This helps ensure that users don’t need to create a new account, with new credentials, for every app they use. This approach to SSO can be used with either of SMART’s launch flows.

Client

If you're working on a client, please complete the "clients" tab of the Connectathons Spreadsheet (see above) . You'll also need to update the status flag to indicate whether you've begun work (or completed work).

Scenarios

Dedicated Zulip chat stream for this Track.

Use cases:

1. Patient and Provider access to a patient’s active medication list
2. Patient and Provider updates to a patient’s active medication list
3. Create a new outpatient Prescription

1. Patient and Provider access to a patient’s active and historical medication list

Action: (Patient consumer or Provider) requests active medications or historical medication list.

Using a search on MedicationStatement with the following parameters:

• patient
• status
• category ! note : not defined in core made a CR [#12337] to support as core search parameter

GET /MedicationStatement?patient={id}&status=active,completed,stopped,on-hold&category=inpatient,patientspecified

for inpatient active medications for current or most recent hospitalization

GET /MedicationStatement?patient={id}&status=active&category=outpatient,patientspecified

for a current snapshot of outpatient's active medications

This scenario is similar to the Argonaut use case Connectathon 4. Refer to the Argonaut Medications IG for Success Criteria. (Note although this references DSTU2, our focus is on STU3.)

Examples:

http://fhir3.healthintersections.com.au/open/MedicationStatement/?pat=1&status=active

http://fhir3.healthintersections.com.au/open/MedicationStatement/?pat=1&status=active,completed,stopped,on-hold

Preconditions:

1. Patient does exist on the server previously with medications.
2. Server conforms to the US-Core CapabilityStatement-daf-query-responder for Medication, MedicationStatement, MedicationRequest, and Patient profiles
3. Client conforms to the US-Core MedicationStatement, MedicationRequest, and Patient profiles
4. Server and Client mandatory support of the category element for MedicationStatement and MedicationRequest

Definitions

1. Active Medication List – A list of medications that a given patient is currently taking.
2. MAR linked to workflow and is medication actually given during hospitalization.

Success Criteria:Server returns a Bundle containing entries for:

• all the patient's active medications

-----Still Drafting --- 2. Patient and Provider access to a patient’s active and historical medication list by searching across all medication resources

Action: (Patient consumer or Provider) requests active medications or historical medication list.

1. The medication list includes MedicationRequest, MedicationAdministration and MedicationDispense resources 2. Using a across resource search on these resources with the following common parameters:

• patient
• status
• category ! note : not defined in core made a CR [#12337] to support as core search parameter not a common category search parameter!

     <reference value="Patient/pat1"/>
     <display value="Donald Duck"/>
  </patient>
  <dateWritten value="2015-01-15"/>
  <prescriber>
     <reference value="Practitioner/f007"/>
     <display value="Patrick Pump"/>
  </prescriber>
  <category>
     <coding>
        <system value="http://hl7.org/fhir/medication-request-category"/>
        
        <display value="Inpatient"/>
     </coding>
  </category>
  <dosageInstruction>
     <sequence value="1"/>
     <text value="one to two tablets every 4-6 hours as needed for rib pain"/>
  </dosageInstruction>
</MedicationRequest>

Preconditions:

1. Patient does exist on the server previously with medications.
2. Server Conforms to the US-Core CapabilityStatement-daf-query-responder for Medication, MedicationStatement, MedicationRequest, and Patient profiles
3. Client conforms to the US-Core MedicationStatement, MedicationRequest, and Patient profiles
4. Server and Client mandatory support of the category element for MedicationStatement and MedicationRequest

Success Criteria:

• Client successfully create new MedicationRequest

3.2 Action:

Subsequent workflow steps depend on specific pattern agreed upon by busines partners. See a list of possible scenarios here.

For example the new outpatient Prescription is made actionable by using the Task resource to initiate a prescription to a community or inhouse pharmacy.

Note: The request would generate a NCPDP script for community pharmacy or likely a v2 message or inhouse pharmacy.

Bonus point: update MedicationRequest, MedicationAdministration and/or MedicationDispense resources based on new MedicationRequest.

With Server Conforming to Pharmacy FHIR Maturity Project MedicationAdministration Profile and MedicationDispense Profile

Issues and Questions (GitHub issues link)

TestScript(s)

tbd