201605 Data Access Framework (DAF)

Return to May 2016 Proposals

DAF Observation, DAF DiagnosticReport

Extend DAF connectathon to include retrieval of laboratory results supporting both provider and patient access. This connectathon will address the question whether accessing a patient's laboratory results using the DAF Observation resource the DAF DiagnosticReport resource as the 'entry' point to the information.

DAF Patient, DAF Condition, DAF MedicationStatement and DAF Allergies

This is a continuation of the first DAF connectathon in January.

Pre-Requisites

This track should require minimal work in advance of the connectathon. If creating a server, advanced preparation will be required, but the scenarios listed below should limit the effort.

Review the FHIR Search API including:

• search by token
• search by reference
• search by date

Review U.S. Data Access Framework (DAF) FHIR Implementation Guide (IG) Including:

• DAF Patient Profile
• DAF Condition(Problem) Profile
• DAF MedicationStatment Profile
• DAF Allergies Profile
• DAF Results Profile
• DAF DiagnosticReport Profile

Submitting WG/Project/Implementer Group

Infrastructure and Messaging (I&M)

Orders and Observations (OO)

Justification

• This is a logical next step to FHIR connectathon Track 1 - Patient access that conforms to a specific profile.

• Its purpose is to provide a the next step for folks creating the simple FHIR client for accessing a patient. It is quite feasible to complete the client side of the track within a day with only knowledge of a development environment - no previous FHIR knowledge.

• The Data Access Framework (DAF) profiles have been by the the Argonaut project as a basis for their work. This is another opportunity to use test the profiles, identify issues, and help progress the standard and profile to maturity.

• The subsequent step is extending to accessing patient lab data and investigating how whether the DAF DiagnaosticReport Resource is needed for secondary access of lab data.

Proposed Track Lead

Coordinator: Nagesth Bahsyam (Dragon)

Track Lead: Eric Haas

Expected participants

The expected participants are those implementing DAF profiles, vendors planning to implement FHIR/DAF profiles for 2015 API certification criteria and participated in the Argonaut Sprints in the fall of 2015. This includes LIS Vendors, Large Labs, Application developers.

Roles

FHIR Client

Refer to the 2015 Edition Common Clinical Data Set for more information.

Enable the retrieval of the DAF Patient:

These requirements are intended to meet the 2015 Edition ONC Certification criterion Patient Selection 170.315(g)(7).

• A client has connected to a server and fetched a patient using GET [base]/Patient/[id].
• A client has connected to a server and searched through available Patients using at least 2 (example name.family and gender) of the following search parameters:
  • name.family or name.last
  • gender
  • birthdate

The following requirements are intended to support the 2015 Edition ONC Certification criterion Data Category Request 170.315(g)(8).

Enable the retrieval of all of a patient's Problems:

• A client has connected to a server and fetched all problems for a patient, including current as well as historical problems using GET /Condition?patient=[id]&category=problem.

Enable the retrieval of all of a patient's Allergies:

• A client has connected to a server and fetched a patient's allergies using GET /AllergyIntolerance?patient=[id].

Enable the retrieval of all of a patient's Medications:

• A client has connected to a server and fetched a patient's medications using GET /MedicationStatement?patient=[id]..

Enable the retrieval of all of a patient's Lab Results:

• A client has connected to a server and fetched all of a patient's laboratory diagnostic reports using GET [base]/DiagnosticReport?patient=[id]&category=LAB.

• A client has connected to a server and fetched all of a patient's laboratory results listed in the table below using 'GET [base]/Observation?patient=[id]&category=laboratory.

FHIR Server

The server is capable of returning all the search requests listed above following the conformance requirements at http://hl7.org/fhir/dstu2/daf/conformance-daf-query-responder.html for servers.

Servers are expected to have some prepopulated for each of the resources specified with appropriate linking between resources. See Testscript Section below for source files fore each of the scenarios listed below: This is a starting point and should be supported by each server.

Please add your system information here: DAF Participant Tracker

Scenarios

1. Retrieve Patient record

Action: DAF Requestor (client) queries the patient Service for a Patient record.

Precondition: There is a patient that has been created in the system.

Success Criteria: Patient's data is displayed in interface.

Bonus point: The Server supports multiple versions and Clients can query and display previous versions of the Patient

2. Search for a patient based on one or more parameters specified by DAF Responder conformance statement

Action: DAF Requestor (client) searches the patient Service for patients with one or more search parameters.

Precondition: Patients with the search criteria have been created

Success Criteria: patients displayed in interface. (use browser query to confirm)

3. Search for all Conditions or Medications or Allergies for a patient

Action: Server support query of DAF Condition, DAF MedicationStatement, DAF Allergy resources based on patient.id and Clients can query based on the Patient.id parameter.

Precondition: There is a DAF Condition or DAF MedicationStatement or DAF Allergy resourcesthat has been created in the system.

Success Criteria: All DAF Condition or DAF MedicationStatement or DAF Allergy resource data for a patient are displayed in an interface.

Bonus point: Server supports querying of DAF Condition, DAF MedicationStatement or DAF Allergy resources based on patient.id and date period and Clients can query based on the Patient.id and date period parameters.

4. Search for all Laboratory Results for a patient

Action: Server support query of DAF Observation based on patient.id and Clients can query based on the Patient.id parameter.

Precondition: There is a DAF Observation that has been created in the system.

Success Criteria: DAF Observation resource data is displayed in interface.

Bonus point: Server supports querying of DAF Observation resources based on patient.id and date period and Clients can query based on the Patient.id and date period parameters.

Help Links

Here are some links to assist implementers:

• REST API in the Spefication.
• Patient resource in the Spefication.
• Java client sample.
• .net client sample.
• Publicly Available FHIR Servers for testing.

TestScripts

The supporting TestScripts resources, corresponding test-case examples resources files, and test plan documents have been committed to the FHIR SVN repository at:

http://gforge.hl7.org/svn/fhir/trunk/connectathons/MontrealMay2016/Connectathon12/Track-11-LabOrders

>> Use an SVN browser such as Tortoise to view files

There are 4 TestScripts definitions - one for each original test order:

• Test Order Number 100
• Test Order Number 200
• Test Order Number 300
• Test Order Number 400

FHIR Resource ID Assigned by the Client, XML Format - Baseline DiagnosticOrder, Order, OrderRespone, DiagnosticReport, Observation, Specimen, Patient = Todd Lerr, Practitioner = Leonard BloodDraw, Practitioner = Gregory F House, Organization = Acme Labs to create, update, retrieve history and search with client assigned resource id.

>>todo add bonus testscripts