Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-30605

"session launch context" and Task.for

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive
    • Icon: Highest Highest
    • US Specialty Rx (FHIR)
    • 0.1.0 [deprecated]
    • Pharmacy
    • Information Flows Requiring Human Interaction
    • Hide

      Revised the section to be clearer by specifying what is sent in the EHR's initial call to the app versus what is later returned in the EHR authorization server's token response:

       

      When the clinic staff takes action on the work queue item, the EHR…

      • launches the information requester's SMART App, sending a launch context parameter reflecting:
        • the `.id` of the Patient it received in the `.for` element of the Task resource--which references the Data Source system's Patient resource
        • the Task.identifier value--which the SMART app will use to present the right questions for the patient and medication. This value is later returned to the app in the access token response from the EHR authorization server
        • For example, the EHR redirects to:
          https://my-pharmacy-smart-app.com?
          launch=123&
          iss=htttp://my-ehr.com/fhir
      • responds to the app's authorization request in the launch sequence with an OAuth 2.0 access token response that includes the Patient.id and appContext values. For example: {    access_token:"secret-token-xyz",    expires-in:"3600",    patient:"specialty-rx-patient-1",    appContext:"launch-context-id-01345005",    ... }
      • sets the Task `status` to `in-progress`

       

      Show
      Revised the section to be clearer by specifying what is sent in the EHR's initial call to the app versus what is later returned in the EHR authorization server's token response:   When the clinic staff takes action on the work queue item, the EHR… launches the information requester's SMART App, sending a launch context parameter reflecting: the `.id` of the Patient it received in the `.for` element of the Task resource--which references the Data Source system's Patient resource the Task.identifier value--which the SMART app will use to present the right questions for the patient and medication. This value is later returned to the app in the access token response from the EHR authorization server For example, the EHR redirects to: https://my-pharmacy-smart-app.com? launch=123& iss=htttp://my-ehr.com/fhir responds to the app's authorization request in the launch sequence with an OAuth 2.0 access token response that includes the Patient.id and appContext values. For example: {    access_token:"secret-token-xyz",    expires-in:"3600",    patient:"specialty-rx-patient-1",    appContext:"launch-context-id-01345005",    ... } sets the Task `status` to `in-progress`  
    • Frank McKinney / Tim McNeil : 11-0-3
    • Clarification
    • Non-substantive
    • 0.1.0 [deprecated]

    Description

      To be easily understandable by a reader, you should additional clarify that you intend for the SMART server to set and pass the "patient" SMART launch context parameter, alongside the access_token, containing the patient FHIR id received in the Task.for element. Also, see related comment that this fhir id should be the Data Source's, not the requesters.

      Existing Wording:

      sets a session launch context using the Patient ID it received in the \.for element of the Task resource

      (Comment 12 - imported by: Jean Duteau)

      Attachments

        Activity

          People

            Unassigned Unassigned
            Isaac.Vetter Isaac Vetter
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: