Overview

Understand what the SMART on FHIR Patient Chart enables and how it supports clinical review workflows.

Requirements

Review tenant, user, and patient-level requirements for enabling chart access.

Launch the Chart

Build the SMART launch URL with required parameters and redirect logic.

Get the Token

Handle the redirect from Health Gorilla and exchange the code for an access token.

Retrieving Data

Use the access token to retrieve FHIR resources in real time during the viewer session.

Refresh Token

Track token expiration, detect failures, and refresh the token when available.

End a Session

Log out of the viewer, revoke the token if needed, and terminate the session securely.

Launch Errors

Troubleshoot common SMART on FHIR launch errors and identify authorization or data access issues.

Session Behavior

Understand session lifecycle rules, token validity, and how scopes control data access.

Data and Layout

Understand what clinical data types are displayed in the chart and how they are organized by section.

Record Provenance

Review source documents and organizations linked to each chart entry, including document previews and metadata.

Launch Contexts

Launch the chart using patient, encounter, or practitioner context to support role-based and workflow-specific access.

Viewer Configuration

Customize branding, layout options, and redirect behavior to match your application environment.

Viewer Empty States

Understand when the chart timeline and other sections may appear blank due to missing FHIR data, and how the viewer behaves with incomplete or sparse records.

Test Requirements

Review the minimum data requirements for test patients used in the chart, including which FHIR resources must be present to populate the timeline and structured sections.

Security and Auditing

Apply OAuth 2.0 protections, track session access, and integrate audit logging with your internal systems.