Overview

Describes the purpose of the Patient Chart Viewer and the clinical review workflows it supports.

Requirements

Defines tenant, user, and patient-level prerequisites required to enable and access the Patient Chart Viewer.

Launch the Chart

Details SMART on FHIR launch construction, required parameters, and redirect behavior for initiating the viewer.

Get the Token

Covers the OAuth authorization flow and access token exchange used by the Patient Chart Viewer.

Retrieving Data

Describes how FHIR resources are retrieved during an active viewer session using the issued access token.

Refresh Token

Addresses token expiration behavior and refresh handling when supported.

End a Session

Details viewer session termination, including logout flow and token revocation considerations.

Launch Errors

Identifies common SMART on FHIR launch and authorization error scenarios and their causes.

Session Behavior

Clarifies session lifecycle rules, token validity, and scope-based data access behavior.

Data and Layout

Explains the structure of the Patient Chart Viewer UI, including section layout and how clinical data types are presented visually.

Clinical Data

Explains how clinical data is organized, categorized, and displayed within the Patient Chart Viewer, including the relationship between procedures, diagnostic results, and source documents.

Record Provenance

Describes how source documents and originating organizations are linked to chart entries, including access to metadata and previews.

Launch Contexts

Covers supported SMART launch contexts, such as patient, encounter, and practitioner, and their effect on viewer behavior.

Viewer Configuration

Details available branding, layout, and redirect configuration options for the Patient Chart Viewer.

Viewer Empty States

Explains scenarios in which chart sections or timelines may appear empty due to missing or incomplete data.

Test Requirements

Defines minimum data requirements for test patients, including the FHIR resources needed to populate viewer sections.

Security and Auditing

Covers OAuth security controls, session access tracking, and audit logging considerations.