Viewer Empty States
The Patient Chart Viewer suppresses certain sections or layout elements when required clinical data is missing. Understanding how the viewer handles empty states can help you troubleshoot missing data, build more complete test patients, and set appropriate expectations for end users.
Timeline Visibility
The timeline view is displayed only when the viewer retrieves at least one valid Encounter resource. If no encounters are returned for the patient, the timeline is hidden, even if other data types (such as Observation or Condition) are available.
To ensure the timeline appears:
- Include at least one
Encounterin your test patient’s FHIR data - Make sure the
Encounterresource includes required fields such asstatus,period, andparticipant - Confirm that the encounter occurred within the timeframe shown in the viewer (default: last 3 years)
Section Suppression
Chart sections are shown only when relevant FHIR data is available. If a resource type (e.g., AllergyIntolerance or Immunization) is not returned or has been filtered out due to authorization constraints, the corresponding section is not displayed in the chart.
The viewer does not show placeholder messages for missing sections to avoid confusion. Instead, the layout dynamically adjusts to only show sections backed by available and authorized data.
Testing and Data Expectations
To verify that the viewer renders all expected components:
- Populate the test patient with
Encounter,DocumentReference, and at least three additional resource types (e.g.,MedicationStatement,Condition,Observation) - Ensure each resource includes complete and valid FHIR fields
- Use real retrieval mechanisms (such as Patient360 queries) to test how data flows into the viewer
Empty state behavior is driven entirely by the content returned by the FHIR API during session initialization. If the chart appears blank or partially populated, review the patient’s data payload and SMART on FHIR scopes for completeness.