Smart Health Checks
0.3.0 - ci-build Australia flag

Smart Health Checks, published by AEHRC CSIRO. This guide is not an authorized publication; it is the continuous build for version 0.3.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/aehrc/smart-forms-ig/ and changes regularly. See the Directory of published versions

Home

Official URL: https://smartforms.csiro.au/ig/ImplementationGuide/csiro.fhir.au.smartforms Version: 0.3.0
Draft as of 2025-09-05 Computable Name: SmartHealthChecks

Copyright/Legal: Copyright © 2022+ Australian Government Department of Health and Aged Care - All rights reserved. This content is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License. See https://creativecommons.org/licenses/by-sa/4.0/.

Introduction

This implementation guide is provided to support the integration of the Smart Health Checks App within a patient management system enabling users to complete health check assessments such as the Aboriginal and Torres Strait Islander Health Check.

The Smart Health Checks App is a FHIR-based client application aimed at demonstrating effective undertaking of healthcare assessments. It leverages SMART App Launch, Structured Data Capture specification and AU Core to improve clinical workflow, enhance the usefulness of information in the practice record and improve interoperability of health information to support better clinical outcomes.

The Smart Health Checks App is based on the CSIRO Smart Forms App which was provided as a Reference Implementation of using FHIR standards and implementation guides to provide reusable software components that can be applied within Australian healthcare software systems to support uses cases such as national health check assessment forms.

Smart Health Checks Actors

The following figure provides an overview of the actors involved in the Smart Health Checks (SHC) solution.

Actors Overview

SHC App

The SHC App allows a user of the SHC Host to launch the SHC App for filling out a health check form prepopulated with authorized patient health information retrieved from the SHC Host FHIR Server and writeback the collected form data.

The SHC App actor is implemented by the CSIRO Smart Forms App.

SHC Host

The SHC Host allows a user to launch the SHC App within an embedded or externally launched web browser to fill out a health check form.

The SHC Host actor is implemented by the patient management system.

SHC Host FHIR Server

The SHC Host FHIR Server allows the SHC App to retrieve patient health information and writeback collected health check data.

The SHC Host actor is implemented by the patient management system.

SHC Host Authorization Server

The SHC Host Authorization Server allows the SHC App to request authorisation from the user to access patient health information to prepopulate and write back health checks data using the SHC Host FHIR Server.

Smart Health Checks Interactions

The Smart Health Check App follows a standard set of interactions which are summarised as:

  1. App Launch: The SHC User initiates the SHC Host to launch SHC App with a context of the current user, patient and health check form.
  2. SMART Authorization Configuration: The SHC App uses SHC Host FHIR Server to locate the SHC Host Authorization Server endpoints and capability.
  3. Authorization Request: SHC App redirects to the SHC Host Authorization Server to authorise access to patient health information using the SHC Host FHIR Server. The SHC User may be prompted to permit or deny access to the requested data.
  4. Authorization Callback: The SHC Host redirects back to the SHC App to proceed with the authorised launch of the health check form.
  5. Token Request: SHC App requests an access token and associated launch context, including user, patient and health check form, from the SHC Host Authorization Server.
  6. Prepopulate Health Check: SHC App uses the launch context to use the SHC Host FHIR Server to:
    1. read Practitioner;
    2. read Patient;
    3. read or search QuestionnaireResponse; and
    4. various search requests to prepopulate the health check form

    Launch Interactions

  7. Fill and Save Health Check: The user fills out the health check form and saves the form data.
  8. Writeback Questionnaire Response: The health check form data is written back to the SHC Host FHIR Server as a QuestionnaireResponse.
  9. Writeback Extract Transaction: The health check form data extracted from a completed form as FHIR Resources are written back to the SHC Host FHIR Server as transaction Bundle.

    Writeback extract

    Writeback extract

Dependencies

IGPackageFHIRComment
.. Smart Health Checkscsiro.fhir.au.smartforms#0.3.0R4
... HL7 Terminology (THO)hl7.terminology.r4#6.5.0R4Automatically added as a dependency - all IGs depend on HL7 Terminology
.... FHIR Extensions Packhl7.fhir.uv.extensions.r4#5.2.0R4
... AU Core Implementation Guidehl7.fhir.au.core#1.1.0-previewR4
.... HL7 Terminology (THO)hl7.terminology.r4#6.2.0R4
.... AU Base Implementation Guidehl7.fhir.au.base#5.1.0-previewR4
.... SMART App Launchhl7.fhir.uv.smart-app-launch#2.1.0R4
..... HL7 Terminology (THO)hl7.terminology.r4#5.0.0R4
.... International Patient Accesshl7.fhir.uv.ipa#1.0.0R4
..... SMART App Launchhl7.fhir.uv.smart-app-launch#2.0.0R4
... Structured Data Capturehl7.fhir.uv.sdc#currentR4
.... FHIR Extensions Packhl7.fhir.uv.extensions.r4#5.3.0-ballot-tc1R4
.... HL7 Terminology (THO)hl7.terminology#5.5.0R4
..... FHIR Extensions Packhl7.fhir.uv.extensions.r4#1.0.0R4
... FHIR Tooling Extensions IGhl7.fhir.uv.tools.r4#0.7.1R4for example references

Package hl7.fhir.uv.extensions.r4#5.2.0

This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package hl7.fhir.au.base#5.1.0-preview

This implementation guide is provided to support the use of FHIR®© in an Australian context. (built Wed, Mar 5, 2025 23:00+0000+00:00)

Package hl7.fhir.uv.ipa#1.0.0

This IG describes how an application acting on behalf of a patient can access information about the patient from an clinical records system using a FHIR based API. The clinical records system may be supporting a clinical care provider (e.g. a hospital, or a general practitioner), or a health data exchange, including a national health record system. (built Sun, Mar 26, 2023 20:50+0000+00:00)

Package hl7.fhir.au.core#1.1.0-preview

This implementation guide is provided to support the use of FHIR®© in an Australian context, and defines the minimum set of constraints on the FHIR resources to create the AU Core profiles. This implementation guide forms the foundation to build future AU Realm FHIR implementation guides and its content will continue to grow to meet the needs of AU implementers. (built Thu, Mar 6, 2025 07:19+0000+00:00)

Package hl7.fhir.uv.extensions.r4#5.3.0-ballot-tc1

This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sun, Aug 3, 2025 06:28+1000+10:00)

Package hl7.fhir.uv.sdc#current

The SDC specification provides an infrastructure to standardize the capture and expanded use of patient-level data collected within an EHR. (built Thu, Sep 4, 2025 17:57+0000+00:00)

Package hl7.fhir.uv.extensions.r4#1.0.0

This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sun, Mar 26, 2023 08:46+1100+11:00)

Package hl7.fhir.uv.tools.r4#0.7.1

This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Sat, Jul 26, 2025 06:59+1000+10:00)

Smart Forms is also dependent on:

In addition, the following FHIR implementation guides are referenced:

Usage

This document is a working specification that may be directly implemented by FHIR®© system producers.

FHIR®© connectathon events are key to the verification of the guide as being suitable for implementation. This implementation guide will be used as the basis for Australian connectathon events.

How to read this guide

This guide is divided into several pages which are listed at the top of each page in the menu bar.

  • Home: This page provides the introduction and scope for this guide.
  • Guidance
    • General Requirements: This page documents how CapabilityStatements declare conformance to the SHC profiles and their FHIR interactions. It also defines the expectations for mandatory and Must Support elements.
    • SHC App Integration: This page provides an overview of the integration requirements to launch the Smart Health Check Application.
    • Reference Implementation: This page describes software components that have been developed to demonstrate the Smart Health Checks solution.
  • FHIR Artefacts: These pages provide detailed descriptions and formal definitions for all the FHIR artefacts defined in this guide.
    • Artefact Summary: This page lists all of the FHIR artefacts defined in this guide.
    • Questionnaires: This page lists all of the Questionnaire resources defined in this guide.
    • Profiles and Extensions: This page lists all of the StructureDefinition resources defined in this guide.
    • Capability Statements: This page lists all of the CapabilityStatement resources defined in this guide.
    • Actor Definitions: This page lists all of the ActorDefinition resources defined in this guide.
  • Downloads: This page provides links to downloadable artefacts including the Smart Forms FHIR NPM package.

Collaboration

This guide is the product of collaborative work undertaken with participants from:

  • Australian Government Department of Health and Aged Care
  • National Aboriginal Community Controlled Health Organisation
  • The Royal Australian College of General Practitioners
  • Primary Care Data Quality Foundations Working Group
  • Australian FHIR Implementers Community
  • CSIRO Australian e-Health Research Centre