AU Patient Summary Implementation Guide
0.6.0-cibuild - CI Build Australia flag

AU Patient Summary Implementation Guide, published by HL7 Australia. This guide is not an authorized publication; it is the continuous build for version 0.6.0-cibuild built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7au/au-fhir-ps/ and changes regularly. See the Directory of published versions

General Guidance

Page standards status: Informative

Approach of this Implementation Guide

AU Patient Summary (AU PS) is provided to support the use of patient summaries in HL7® FHIR®© in an Australian context. AU PS is based on IPS and AU Core, setting the minimum conformance expectations for implementing AU PS documents in systems.

AU PS, by design:

  • ensures compliance with AU Core and IPS
  • includes additional requirements agreed as necessary to support patient summaries in an Australian healthcare context (see the AU PS)
  • supports varied stakeholder needs in the use of AU PS artefacts (e.g. government policy, implementers, tooling developers, testers, IG authors/maintainers etc.)

The approach to describing the 'minimum' in AU PS means modelling in such a way that 'at least' what is to be supported is defined without limiting meaningful options for business rules and different clinical workflows. AU PS artefacts are therefore modelled as open templates allowing for additional content including elements, extensions, resources, search parameters, operations, and terminology whilst ensuring the minimum requirements are met.

Australian realm IGs and implementers are expected to comply with AU Base and AU Core and to define extensions, search parameters or operations (in order of precedence):

  • in the FHIR standard (incl. FHIR Extensions Pack)
  • in AU Base
  • in a downstream IG (this IG)
  • in a local IG only if necessary

Scope of AU PS FHIR Artefacts

AU PS profiles:

  • Resources to define minimum support expectations for use in the Australian healthcare context
  • Actors to define systems that play a role in consuming and producing AU PS documents

In this release, AU PS does not define new extensions, search parameters, operations or terminology. AU PS does not include capability statements (the minimum capabilities (behaviours) to be supported for AU PS actors). Future releases of this IG may include capability statements, extensions, search parameters, operations, or terminology.

Extension Approach

AU PS does not define new extensions. All extensions included in AU PS are defined in the FHIR Extensions Pack or AU Base. A limited set of extensions are indicated as Must Support in AU PS resource profiles; these supported extensions have been inherited from the underlying AU Core profile.

It is anticipated that extension profiles may be included in future releases of this IG.

Terminology Approach

AU PS does not define new terminology FHIR artefacts (e.g. value sets or code systems). Terminology supported in AU PS are published in AU Base, the FHIR standard, HL7 Terminology (THO), or the National Clinical Terminology Service (NCTS).

As part of profiling, AU PS inherits the AU Core localised terminology and indicates support expectations for an AU PS actor using Must Support and Obligations. For more information on the terminology modelling inherited from AU Core see the guidance in AU Core Use of Terminology Bindings.

In terms of support in AU PS profiles, a coded element can have support defined for one or many value sets. Coded elements that define support for more than one value set include them in a profile by slicing the Coding part of the element and placing Must Support on each value set slice. These value set slices are not intended to prevent systems from supplying only a text value. Most coded Must Support elements in AU PS profiles define support for one value set, which is bound to the supported element and no value set slice is present.

For:

  • a list of the terminologies supported in AU PS, refer to the Terminology page.
  • a description of the localisation of terminology compared to the IPS, refer to Terminology Localisation.
  • guidance on selection of terminology in HL7 AU IGs, refer to the AU Base guidance on Terminology Selection.

Resource Profile Approach

AU PS Profile Design Principles

AU PS profiles are designed to ensure compliance with AU Core and IPS. AU PS profile design principles are as follows:

  • AU PS profiles SHALL ensure resources validate against both IPS and AU Core profiles (where both profiles exist):
    • Cardinality
    • Fixed values and patterns
    • Data type sub-elements and profiles
    • Data type choices and references
    • Invariants
    • Must Support
    • Terminology bindings
  • AU PS profiles SHALL validate reference elements against AU PS profiles (where available), otherwise the AU Core profile where available, otherwise the IPS profile where available, otherwise the AU Base profile where available
  • In AU PS profiles, terminology bindings inherited from the underlying AU Core profile are preferenced over terminology bindings in IPS profiles:
    • where an element has a required binding, the element SHALL apply the intersection of both value sets (AU Core and IPS)
    • where an element has a lesser binding strength (extensible, preferred, example), use the AU Core value set and binding strength (where AU Core bindings strength is equal or stronger) or use the IPS value set where the binding strength is stronger
  • An AU PS profile SHALL inherit the IPS profile obligations and MAY strengthen the IPS profile obligations (using a specialisation of the defined obligation) or add an additional obligation (e.g. SHOULD:persist), as required for the Australian context. A weaker obligation SHALL NOT be specified.
  • Where one or both AU Core and IPS profiles do not exist, SHALL ensure resources validate against:
    • IPS profile (where only the IPS profile exists)
    • AU Core profile (where only the AU Core profile exists)
    • AU Base profile (where available and neither the IPS or AU Core profile exists)
  • Where a profile referenced in AU PS Bundle is not defined in IPS, or has Must Support elements with no obligations in IPS, the AU PS obligations default to:
    • AU PS Producer: SHALL:populate-if-known
    • AU PS Consumer: SHALL:handle and SHOULD:display
Profiling Approach

AU PS profiles:

  • are derived from AU Core, where available, to inherit the nationally agreed localised terminology, identifiers, and extensions.
  • are only constrained (e.g. cardinality, references, terminology, extensions) where the constraint is agreed to be a minimum requirement that is nationally relevant and applicable for all AU PS documents to avoid limiting options for downstream use case decisions and business rules.
  • label elements and extensions that form the minimum requirements with Must Support.
  • do not further constrain elements or extensions that are not labelled Must Support as they are not part of the minimum requirements.
    • an exception to this rule is inherited from underlying AU Core profiles that include an invariant to enforce that if a coded body site is provided, at least one coding is from SNOMED CT.
  • are defined as open, allowing additional elements, extensions, and rules. This results in a more flexible template that can be used across wider contexts, but also means that the resource content is not closed, and applications have to decide how to handle content not described by the profile. See the section Extensibility – 'Additional' Sections or Elements for information.

When modelling AU PS resource profiles, they:

  • are derived from AU Core profiles, or where not available, the AU Base profile (where it exists)
  • apply additional requirements inherited from IPS (in accordance with the AU PS Profile Design Principles)
  • apply additional requirements agreed by the AU PS project (e.g. inclusion of AU PS Encounter profile)
  • use compliesWithProfile to assert compliance with the corresponding IPS profile (where it exists)
AU PS resource profile modelling

Figure 1: AU PS resource profile modelling

This modelling applies the typical HL7 AU profile modelling approach to use derivation to manage compliance across the HL7 AU profile stack and allow for the additional of IPS and AU PS project requirements, see the example in the figure below.

AU PS Patient current profiling approach

Figure 2: Profiling approach for AU PS Patient profile

Due to this modelling, the differential view in an AU PS profile shows the patient summary requirements that are additional to AU Core. In some profiles (e.g. AU PS Organization), the only additional requirements are the obligations for AU PS actors.

The AU PS Bundle profile is not based on AU Core or AU Base as no Bundle profile exists in either IG. The approach to profiling for AU PS Bundle is to:

AU PS Bundle current profiling approach

Figure 3: Profiling approach for AU PS Bundle profile

This approach to AU PS Bundle profiling (deriving from the FHIR Bundle resource and not Bundle (IPS) profile) has been taken as at this time there is a tooling limitation that prevents meeting both of the below conditions:

  • derivation from Bundle (IPS)
  • changing reference targets to AU PS profiles (as AU PS profiles derive from AU Core and not IPS they cannot be easily assessed as meeting IPS rules by the tooling)

Additional detail on profiling is:

Use of Must Support and Obligations

Must Support is used to indicate the elements and extensions that form the minimum requirements of AU PS. Labelling an element Must Support means that systems that produce or consume resources are to provide support for the element in some meaningful way. The FHIR standard does not define exactly what 'meaningful' support for an element means, but indicates that a profile needs to make clear exactly what kind of support is required when an element is labelled as Must Support.

The set of Must Support elements in AU PS profiles is inherited from AU Core and IPS profiles (i.e. the union of IPS and AU Core elements labelled Must Support). In addition, the mandatory elements in AU PS Bundle, are labelled with Must Support (e.g. Bundle.type). This is applied as the convention in this guide is to mark all mandatory elements as Must Support unless they are nested under an optional element.

The meaning of Must Support in AU PS is defined in:

  • narrative in the IG (e.g. Missing Data requirements)
  • the obligation extension on each supported element in a profile, identifying the support expectations for AU PS actors
  • narrative qualification of element obligations present in the profile specific implementation guidance

See Must Support and Obligation for a detailed description of how this is applied in AU PS.

Potential Profiling Options

When managing profile complexity and requirements in the national and international context for AU PS, the following mechanisms are available:

  1. Derived from Profiles (derive)
  2. Informal alignment (humans authoring of rules in a profile)
  3. Complies With Profile (compliesWithProfile)
  4. Dependent Profiles (imposeProfile)

These mechanisms offer differing capabilities and advantages. Typically HL7 AU profiles use derivation to manage compliance within HL7 AU inheritance (e.g. AU PS Patient Profiling Approach). However, as AU PS will comply to both HL7 AU (AU Core) and HL7 Universal Realm (IPS), additional mechanism(s) on top of derivation from the underlying HL7 AU profile stack are required. At this time additional requirements are included in AU PS profiles via informal alignment (i.e. human authoring, human checking) and a compliesWithProfile declaration is made.

For a human, the main differences with use of imposeProfile are:

  • does not rely on humans to maintain compliance rules from the target impose profile
  • does not visually show a human reader of the source profile rules from the target impose profile, i.e. a human reader must view and understand both profiles to understand the complete set of rules
  • where two or more profiles offer optional alternatives (e.g. differing preferred bindings or data type choices) does not make clear which alternative is preferenced

To support reduction of maintenance efforts in AU PS, it is under consideration that all AU PS profiles derive from AU Core, where available, and use imposeProfile to apply IPS rules. That would mean that either:

  • a number of IPS-imposed requirements including cardinality, terminology, and flagging of Must Support would not be directly visible in the formal views within this guide, or
  • if the additional IPS constraints were included directly in the AU PS profile + use imposeProfile, those constraints would be repeated from a validation sense and could be an additional validation burden.

Users of this implementation guide are encouraged to provide their feedback about the potential use of imposeProfile.

Actor Approach

AU PS actors are defined to describe the specific sets of functionality supported by systems that play a role in producing or consuming AU PS documents. Each actor is defined by:

  • an actor definition that includes reference to support expectations (narrative conformance requirements)
  • resource profiles that define support expectations for actors using Must Support and Obligations

In this release, AU PS does not include capability statements that describe the requirements for an AU PS actor. It is anticipated that capability statements may be included in future releases of this IG.

AU PS Actor Design Principles

AU PS actors are designed to ensure compliance with IPS and support the use of patient summaries in Australia. AU PS actor design principles are as follows:

  • AU PS actors:
    • SHALL inherit the narrative conformance requirements from AU Core and IPS including Missing Data, Empty Sections, Known Absence of Data
    • SHALL inherit IPS Document requirements (see AU PS Resource Profile Approach)
    • SHALL inherit AU Core resource profile requirements (see AU PS Resource Profile Approach)
    • SHALL inherit Must Support (the union of IPS and AU Core elements labelled Must Support) and IPS Obligation requirements
    • MAY strengthen inherited requirements as required for the Australian context. A weaker requirement SHALL NOT be specified.
    • MAY apply additional requirements agreed by the AU PS project

Extensibility – 'Additional' Sections or Elements

As in IPS, a producer can send:

  • 'additional' elements beyond those flagged with Must Support in a profile
  • 'additional' sections (often referred to as 'undefined' sections) beyond those defined in the AU PS Composition

Additional sections or elements are often required by other profiles the system may conform to, allowing local requirements, including technical and workflow context for the resource, to be reflected and extending the health information supported in exchanges. For this reason, extensibility is generally encouraged and expected in AU PS profiles. Only in some exceptionally rare use case profiles are rules tightened to limit the nature of additional information that can be sent.

Implementers intending to populate the AU PS with an unprofiled resource type, e.g. MedicationAdministration, are recommended to consider the corresponding AU Base profile, e.g. AU Base MedicationAdministration, as guidance for that resource type in an Australian healthcare context.

Extensibility – 'Additional' Sections

Implementers need to be aware, the rules of the Composition.section:All Slices defined in the AU PS Composition profile apply to all sections, defined or undefined:

  • Composition.section.title is mandatory and has obligations defined for AU PS Producers and AU PS Consumers
  • Composition.section.text is mandatory and has obligations defined for AU PS Producers and AU PS Consumers

It is recommended that where a producing system intends to populate 'additional' sections there is some definition available in a specification describing the intended contents and use of these additional sections.

Extensibility – 'Additional' Elements

Specification authors adopting AU PS are encouraged to enable greater interoperability and software re-use by avoiding reductions in an element's cardinality.

Depending on local requirements, a consumer (i.e. client application) may ignore these 'additional' elements, may treat the data as for rendering only, or be capable of recognising and using the element.

Structuring Terminology Choices

The AU PS shares the same structure as IPS and contains sections that can include coded elements in reusable 'minimal' data blocks.

The AU PS identifies a number of terminologies as Must Support for AU PS consumers and producers. Primary terminologies used in this specification include SNOMED CT Australian Edition (SNOMED CT-AU) for clinical concepts (e.g. allergies, problems, procedures, medicines), LOINC for observation codes (e.g. pathology results and vital signs), UCUM for units of measure, ISO 3166 for countries, PBS Item codes for medicines, Australian Immunisation Register codes for vaccines, and FHIR defined CodeSystems.

Within the AU PS context (i.e. the Australian healthcare context), the Australian localised value sets, developed and published by the National Clinical Terminology Service (NCTS) and the HL7 AU FHIR Working Group are preferred over IPS value sets to support the consumer on their healthcare journey in the AU healthcare context.

In an IPS context, IPS proposes that to support interoperability of IPS content between organisations that use different SNOMED CT value set content, a 'common proximal ancestor' strategy is used. See IPS Structuring Terminology Choices for more information.

Patient Safety in IPS Context

See the guidance defined in IPS Patient Safety in IPS Context.

Medicinal Product Identification

See the guidance defined in AU Core Medicine Information.

Representing Body Site, Which May Include Laterality

See the guidance defined in AU Core Representing Body Site, Which May Include Laterality.

Provenance

See the guidance defined in IPS Provenance.