This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "201901 Public Health"

From HL7Wiki
Jump to navigation Jump to search
Line 90: Line 90:
 
For example: GET https://fhir.experimental.aimsplatform.com/baseDstu3/Bundle/1 with an "Authorization" header of "Bearer <your_token>"  
 
For example: GET https://fhir.experimental.aimsplatform.com/baseDstu3/Bundle/1 with an "Authorization" header of "Bearer <your_token>"  
 
The token stays active for 24 hours, and then it expires, and you have to re-login to get a new token  
 
The token stays active for 24 hours, and then it expires, and you have to re-login to get a new token  
 
 
===Scenario Step 1 Name===
 
:Action: <!--Who does what?  (Use the role names listed above when referring to the participants -->
 
:Precondition: <!-- What setup is required prior to executing this step? -->
 
:Success Criteria: <!-- How will the participants know if the test was successful? -->
 
:Bonus point: <!-- Any additional complexity to make the scenario more challenging -->
 
 
  
 
===Update Knowledge Distribution / Trigger Codes on Public Health FHIR Server===
 
===Update Knowledge Distribution / Trigger Codes on Public Health FHIR Server===
Line 113: Line 105:
  
 
===Ingest Knowledge Distribution / Trigger Codes into EHR===
 
===Ingest Knowledge Distribution / Trigger Codes into EHR===
Action: Provider organization receives a PlanDefinition trigger code / reporting logic update, and ingests them into their EHR to support case report initiation.  
+
:Action: Provider organization receives a PlanDefinition trigger code / reporting logic update, and ingests them into their EHR to support case report initiation.  
Precondition: PlanDefinition trigger codes / reporting logic updates have been received by provider organization  
+
:Precondition: PlanDefinition trigger codes / reporting logic updates have been received by provider organization  
Success Criteria: Updates successfully ingested into EHR  
+
:Success Criteria: Updates successfully ingested into EHR  
Create and Send eICR Document
+
 
Action: Document Creator prepares an eICR (or other registry submission) and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with public health and other extra-clinical organizations. Some may test FHIR messaging for transmissions.  
+
===Create and Send eICR Document===
Precondition: Patient and Encounter resources exist, and sufficient clinical information (Condition, Observation, and other resources) to populate an eICR.  
+
:Action: Document Creator prepares an eICR (or other registry submission) and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with public health and other extra-clinical organizations. Some may test FHIR messaging for transmissions.  
Success Criteria: eICR is successfully posted to a FHIR server and validates against the eCR profiles found here:  
+
:Precondition: Patient and Encounter resources exist, and sufficient clinical information (Condition, Observation, and other resources) to populate an eICR.  
 +
:Success Criteria: eICR is successfully posted to a FHIR server and validates against the eCR profiles found here:  
 
* http://hl7.org/fhir/us/ecr/2018Sep/profiles.html#electronic-initial-case-report-eicr-transaction-and-profiles  
 
* http://hl7.org/fhir/us/ecr/2018Sep/profiles.html#electronic-initial-case-report-eicr-transaction-and-profiles  
  
 
===Receive eICR Document===
 
===Receive eICR Document===
  
Action: eICR Document Creator prepares an initial case report and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with public health. eICRs will be queued. The eICR Document Consumer does a GET on each successive eICR and processes it. Some may test FHIR messaging for transmissions.  
+
:Action: eICR Document Creator prepares an initial case report and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with public health. eICRs will be queued. The eICR Document Consumer does a GET on each successive eICR and processes it. Some may test FHIR messaging for transmissions.  
Precondition: eICR exists on a FHIR server.  
+
:Precondition: eICR exists on a FHIR server.  
Success Criteria: eICR is successfully retrieved from a FHIR server and validates against the eCR profiles found here:  
+
:Success Criteria: eICR is successfully retrieved from a FHIR server and validates against the eCR profiles found here:  
 
* http://hl7.org/fhir/us/ecr/2018Sep/profiles.html#electronic-initial-case-report-eicr-transaction-and-profiles  
 
* http://hl7.org/fhir/us/ecr/2018Sep/profiles.html#electronic-initial-case-report-eicr-transaction-and-profiles  
  
 
===Create Reportability Response (RR)===
 
===Create Reportability Response (RR)===
  
Action: RR Document Creator prepares a reportability response and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with clinical care. Some may test FHIR messaging for transmissions.
+
:Action: RR Document Creator prepares a reportability response and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with clinical care. Some may test FHIR messaging for transmissions.
Precondition: eICR on which the RR is based exists and contains sufficient information to create an RR.  
+
:Precondition: eICR on which the RR is based exists and contains sufficient information to create an RR.  
Success Criteria: RR is successfully posted to a FHIR server and validates against the eCR profiles found here:  
+
:Success Criteria: RR is successfully posted to a FHIR server and validates against the eCR profiles found here:  
 
* http://hl7.org/fhir/us/ecr/2018Sep/profiles.html#reportability-response-rr-transaction-and-profiles  
 
* http://hl7.org/fhir/us/ecr/2018Sep/profiles.html#reportability-response-rr-transaction-and-profiles  
  

Revision as of 06:52, 7 December 2018


DRAFT Public Health (Case Reporting, Registries, and Referrals)

Submitting WG/Project/Implementer Group

Public Health (PH) Work Group

Justification

Public health includes a number of use cases involving the exchange of information between Electronic Health Records in clinical care and governmental Public Health Agencies (PHAs) or other extra-clinical organizations. The use cases differ, but they frequently have a number of common design elements as well. Because the data exchange is inherently interorganizational, and because initiating events frequently occur in healthcare, unsolicited “push,” messaging, and other reporting components are important use case needs. This Connectathon will focus on common components like FHIR messaging and clinical infrastructure to support reporting to many different extra-clinical organizations, as well as specific transactions for disease surveillance and chronic disease prevention and management. Electronic case reporting (eCR) has existing CDA product family standards and has a FHIR in-process ballot. This use case will focus on the FHIR subscription dissemination of public health “knowledge distribution” including reporting trigger codes in a PlanDefinition construct and also establishing a path for distribution of reporting criteria and more complex business logic. It will also involve the triggering and creation of the electronic Initial Case Report (eICR) in EHRs, the messaging and exchange of the eICR, and the creation and transmission of Reportability Response information back to providers of care and clinical care reporters as appropriate. The FHIR electronic Case Reporting implementation guide currently in ballot can be found here:

Public health registry reporting shares numerous design elements with electronic case reporting. Some of these elements include the distribution of triggering / reporting rules from public health, appropriate triggering in EHRs, the application of more complex inclusion/exclusion and reporting logic, unsolicited push messaging, supplemental data acquisition, and provider information provisioning. Cancer reporting and others are exploring approaches to implementation that support needed program outcomes from clinical workflow and data and leverage commonalities with other reporting. The CDC Cancer program plans to work on a FHIR physician reporting specification and triggering issues in this Connectathon.

Bidirectional Services eReferrals (BSeRs) are closed-loop exchanges between EHRs in clinical care and mostly extra-clinical social services and lifestyle change programs. There is a FHIR BSeR September ballot with transactions to support the transmission of a referral and response and update communications from the program back to the referring provider. Numerous Centers for Disease Control and Prevention and other agency programs seek to facilitate cessation and prevention programs to increase health and decrease healthcare costs. Unlike referrals between clinicians, specific data segmentation is appropriate to provide these programs relevant data they need without revealing unrelated patient information. The FHIR Bidirectional Services eReferral specification can be found here:

Clinical input requested

Related tracks

Proposed Track Lead

  • Rick Geimer
  • John Loonsk
  • Arun Srinivasan

See Connectathon_Track_Lead_Responsibilities

Expected participants

  • Association of Public Health Laboratories
  • Centers for Disease Control and Prevention
  • Cerner Corporation
  • CGI Federal
  • Lantana Consulting Group
  • Northrup Grumman
  • Alliance of Chicago
  • YMCAs of America

Roles

Public Health

Responsible for managing and disseminating trigger codes, decision logic, and knowledge resources. It fosters disease control and prevention programs and activities.

Public Health Agencies

Agencies that receive and manage electronic Initial Case Reports (eICRs), and at times send and/or receive Reportability Responses. Some Public Health Agencies support lifestyle and social services programs.

Intermediaries

Organizations in the information flow between a health care organization and a public health agency or extra-clinical program. Examples include Health Information Exchanges, the shared platform supported by APHL and CSTE that performs routing, RCKMS decision support and, at times, creates Reportability Responses, etc.

Health Care Organization

An organization that submits electronic Initial Case Reports (eICRs) based on trigger code matches, and receives trigger code updates and Reportability Responses. Health Care Organizations also report to public health registries and initiate referrals to extra-clinical social services programs. The health care organization can be supported by an EHR vendor in these roles.

Social Services and Lifestyle Change Programs

Organizations that provide classes, planning, counseling, and/or expertise in the control and prevention of chronic and acute diseases, tobacco cessation, diabetes prevention and others.

EHR Document / Report Creator

Organization responsible for creating an electronic initial case report (eICR) or another report and sending it to a EHR Document Report Receiver. Examples: EHR vendors and specialty reporting companies.

EHR Document / Report Receiver

Organization responsible for receiving and processing an electronic initial case report (eICR) and registry submissions. Examples: APHL, public health registry, or a public health agency (PHA). The eICR Document Participant may also play the role of a Reportability Response Document Creator.

Reportability Response Creator

Organization responsible for creating a Reportability Response (RR) and sending it to a Reportability Response Document Consumer. Examples: APHL or a public health agency (PHA). The Reportability Response Document Creator may also play the role of an eICR Document Participant.

Reportability Response Consumer

Organization responsible for receiving and processing a Reportability Response (RR). Examples: EHR vendors and specialty reporting companies). The Reportability Response Document Consumer may also play the role of an eICR Document Creator.

Scenarios (Reporting)

The Reporting scenarios will use the AIMS Platform's experimental FHIR Server. To access it:

  • Go to https://fhir.experimental.aimsplatform.com
  • Select "API Key" in top-right
  • Click "Login"
  • Register/login. It will re-direct you back to the HAPI/FHIR server when done. Required fields are first, last, email, username, and password.
  • Select "API Key" in the top-right, again
  • It will show you your token, so that you can use it in FHIR REST API requests

For example: GET https://fhir.experimental.aimsplatform.com/baseDstu3/Bundle/1 with an "Authorization" header of "Bearer <your_token>" The token stays active for 24 hours, and then it expires, and you have to re-login to get a new token

Update Knowledge Distribution / Trigger Codes on Public Health FHIR Server

In this scenario and elsewhere we refer to “trigger codes / reporting logic” which is used to refer to distributable knowledge resources that will be used by clinical care / EHRs to support triggering and reporting. Coordinated through a PlanDefinition, they include value set bundles and other reporting metadata and eventually CQL and other knowledge resources. For some time, the value set bundles may be the only machine processable XML and JSON content, but the additional information provides human processable context and a standards-based wrapper to coordinate these elements.

Action: Public Health determines that the current trigger code value sets / reporting logic require an update. The appropriate value sets are updated using PUT. Also update trigger codes as a Bundle of ValueSet resources referenced by the PlanDefinition so they can be updated as a set and linked to other reporting criteria.
Precondition: Original trigger code value sets / reporting logic exists on test server
Success Criteria: Value sets are successfully updated and can be retrieved on demand with GET

Subscribe to Knowledge Distribution / Trigger Codes Updates

Action: Provider organization uses Subscription to subscribe to changes to the PlanDefinition and trigger code value sets / reporting logic using any legal notification method.
Precondition: Original PlanDefinition and trigger code value sets / reporting logic exist on test server
Success Criteria: Provider organization is notified and receives a copy of any PlanDefinition and trigger code value sets / reporting logic specifications that are updated

Ingest Knowledge Distribution / Trigger Codes into EHR

Action: Provider organization receives a PlanDefinition trigger code / reporting logic update, and ingests them into their EHR to support case report initiation.
Precondition: PlanDefinition trigger codes / reporting logic updates have been received by provider organization
Success Criteria: Updates successfully ingested into EHR

Create and Send eICR Document

Action: Document Creator prepares an eICR (or other registry submission) and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with public health and other extra-clinical organizations. Some may test FHIR messaging for transmissions.
Precondition: Patient and Encounter resources exist, and sufficient clinical information (Condition, Observation, and other resources) to populate an eICR.
Success Criteria: eICR is successfully posted to a FHIR server and validates against the eCR profiles found here:

Receive eICR Document

Action: eICR Document Creator prepares an initial case report and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with public health. eICRs will be queued. The eICR Document Consumer does a GET on each successive eICR and processes it. Some may test FHIR messaging for transmissions.
Precondition: eICR exists on a FHIR server.
Success Criteria: eICR is successfully retrieved from a FHIR server and validates against the eCR profiles found here:

Create Reportability Response (RR)

Action: RR Document Creator prepares a reportability response and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with clinical care. Some may test FHIR messaging for transmissions.
Precondition: eICR on which the RR is based exists and contains sufficient information to create an RR.
Success Criteria: RR is successfully posted to a FHIR server and validates against the eCR profiles found here:

Receive Reportability Response

Action: RR Document Creator prepares reportability response and POSTs it to a FHIR server. This POST may be one of several different transport methodologies supported for exchange with clinical care. RRs will be queued. The RR Document Consumer does a GET on each successive RR and processes it. Some may test FHIR messaging for transmissions. Precondition: RR exists on a FHIR server. Success Criteria: RR is successfully retrieved from a FHIR server and validates against the eCR profiles found here:

Scenarios (Referrals)

Scenario Step 1 Name

Action:
Precondition:
Success Criteria:
Bonus point:


Scenarios (Cancer)

Scenario Step 1 Name

Action:
Precondition:
Success Criteria:
Bonus point:

TestScript(s)

Security and Privacy Considerations