< Back

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 Encounter in your test patient’s FHIR data
  • Make sure the Encounter resource includes required fields such as status, period, and participant
  • 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.