AU Core Implementation Guide
0.4.0-preview - Preview Australia flag

This page is part of the AU Core (v0.4.0-preview: QA Preview) based on FHIR (HL7® FHIR® Standard) R4. . For a full list of available versions, see the Directory of published versions

Home

Official URL: http://hl7.org.au/fhir/core/ImplementationGuide/hl7.fhir.au.core Version: 0.4.0-preview
IG Standards status: Draft Maturity Level: 1 Computable Name: AUCoreImplementationGuide

Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License. HL7 Australia© 2022+; Licensed Under Creative Commons No Rights Reserved.

AU Core 0.4.0-preview for testing

This June 2024 preview snapshot supports testing of AU Core prior to Ballot of AU Core R1.

Testing plays a crucial role in the development of AU Core. It helps to build an AU Core that is aligned with its intended purpose and is practical, and responsive to the diverse needs of various stakeholders.

Testing AU Core helps identify issues, challenges, or gaps in the specification, enabling its improvement. During testing, implementers test their FHIR resources, software products, and/or proof of concepts with AU Core and provide essential feedback.

This testing period ends 08 September 2024.

To learn more about testing AU Core or express your interest in participating, see AU Core FHIR IG Testing.

Introduction

AU Core is provided to support the use of HL7® FHIR®© in an Australian context. It sets the minimum expectations on FHIR resources to support conformance and implementation in systems.

AU Core defines the Data model and RESTful API interactions that set minimum expectations for a system to record, update, search, and retrieve core digital health and administrative information.

AU Core uses AU Base representations, where available, as the basis for profiles that define the FHIR resources to be supported, and the elements, extensions, vocabularies, and value sets that SHALL be present are identified, and how they are used is defined. It also documents the minimum FHIR RESTful interactions for each resource type to access data. AU Core promotes interoperability and adoption through common implementation and SHOULD be the basis of further implementation guide development for specific use cases.

There are two different ways to implement AU Core:

  1. Profile Only Support: systems support only the resources as profiled by AU Core to represent digital health information.
  2. Profile Support + Interaction Support: systems support the resources as profiled by AU Core to represent digital health information (Profile Support) and the RESTful FHIR API interactions defined for it (Interaction Support).

In this regard it is similar in nature to other national core specifications such as US Core FHIR Implementation Guide and international FHIR specifications such as International Patient Access FHIR Implementation Guide.

For a detailed description of the different ways to implement AU Core see the Conformance Requirements page.

Project background

This implementation guide is under development through the AU Core project as part of the Sparked AU FHIR Accelerator. The Sparked AU FHIR Accelerator is a community comprising government, technology vendors, provider organisations, peak bodies, practitioners, and domain experts, to accelerate the creation and use of national FHIR standards in health care information exchange.

The AU Core Sparked project includes:

  • Australian Core Data for Interoperability - clinician focussed data requirements project.
  • AU Core FHIR Implementation Guide - HL7 Australia technical data access and exchange specification.

The Australian Core Data for Interoperability (AUCDI) aims to define requirements underlying the standardisation of the capture, structure, usage, and exchange of health data to counteract the current fragmentation of Australia’s health data systems. The AUCDI forms a basis for clinical data requirements for AU Core.

Contributing to AU Core Development

AU Core R1 is in currently in development. Ballot for Comment is scheduled for March 2024.

Join the AU Core Technical Design Group

See How to Register - Participant Information for information on how to participate in the AU Core Technical Design Group and Clinical Design Group as part of Sparked, the Australian FHIR Accelerator.

Visit the HL7 Australia - AU Core Technical Design Group Home

Discuss an issue in chat.fhir.org

If you have a question, feature request, or proposed change, the best place to start is Zulip e.g. the Australia stream https://chat.fhir.org/#narrow/stream/179173-australia.

Identify future work or raise discussion points

To identify future work or raise discussion points, you can post in the Australia stream https://chat.fhir.org/#narrow/stream/179173-australia or raise specification feedback through a Jira issue tracker.

Discuss with the team

Once the issue is logged, you should discuss with the team on chat.fhir.org in the australia > AU Core topic before attempting to make changes yourself. It’s important to coordinate with the other people working on the project. When everyone has agreed on a course of action, IG changes should be submitted as a pull request for review in the AU Core repository.

Dependencies

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

This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sat, Apr 27, 2024 18:39+1000+10:00)

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

This implementation guide is provided to support the use of FHIR®© in an Australian context. (built Thu, Jun 20, 2024 13:49+1000+10:00)

Package hl7.fhir.uv.extensions#5.1.0

This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sat, Apr 27, 2024 18:39+1000+10: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.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)

Usage

AU Core is particularly useful in defining:

  • A testable level of system conformance
  • Assumed support by client applications
  • As the basis of downstream implementation guides

Implementation of capabilities defined in AU Core enables specifications, applications and business logic to be developed with confidence.

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.

AU Core Actors

The following actors are part of AU Core:

AU Core Requestor

A system that creates and initiates a data access request to retrieve core digital health and administrative information. The AU Core Requestor is the client in a client-server interaction.


AU Core Responder

A system that responds to the data access request submitted by requesters, providing responses to requests for core digital health and administrative information. The AU Core Responder is the server in a client-server interaction.


AU Core FHIR RESTful interactions

For systems that support AU Core FHIR RESTful interactions (Profile Support + Interaction Support), the interaction requirements, such as read and search operations, are detailed in the AU Core Requester and AU Core Responder CapabilityStatements.

The following are simple examples of AU Core FHIR RESTful interactions between AU Core Requester and AU Core Responder actors:

Example of a FHIR RESTful read interaction

FHIR RESTful read interaction example


Figure 1: Read a Patient using the logical id

Example of a FHIR RESTful search interaction

FHIR RESTful search interaction example


Figure 2: Search for patients that match a family name

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.
  • Conformance: This page describes the set of rules to claim conformance to this guide including the expectations for Must Support elements in AU Core profiles.
    • General Requirements: This page defines requirements common to all actors and profiles used in this guide including how CapabilityStatements are used to claim conformance. This page defines the expectations for mandatory and Must Support elements in AU Core Profiles.
    • Declaring Conformance: This page describes how to declare conformance to AU Core.
  • Guidance: This set of pages lists the guidance for this guide.
  • FHIR Artefacts: These pages provide detailed descriptions and formal definitions for all the FHIR artefacts defined in this guide.
    • Profiles and Extensions: This set of pages describes the profiles and extensions that are defined in this guide to exchange quality data. Each profile page includes a narrative description and guidance, formal definition and a “Quick Start” guide which summarises the supported search transactions for each profile. Although the guidance typically focuses on the profiled elements, it may also may focus on un-profiled elements to aid with implementation.
    • Search Parameters: This set of pages lists the search parameters extended for use in this guide for use in AU Core operations.
    • Terminology: This set of pages lists the value sets and code systems defined in this guide.
    • Capability Statements: This set of pages define the expected FHIR capabilities of AU Core Responders and Requesters.
    • Actor Definitions: This set of pages define the AU Core actors, AU Core Responder and AU Core Requester.
  • Examples: This page lists all the examples used in this guide.
  • Downloads: This page provides links to downloadable artefacts that developers can use to help them implement this guide.
  • Change Log: This page documents the changes across versions of this guide.

Collaboration

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

Primary Editors: Brett Esler, Danielle Tavares-Rixon, Dusica Bojicic.