Australian Profile for Provider Directory Services

This page is part of the Australian Provider Directory IG (v0.2.0: PD 1 on FHIR STU3 Draft) based on FHIR R3. The current version which supercedes this version is 2.0.1. For a full list of available versions, see the Directory of published versions

SD.4 StructureDefinition-au-pd-practitioner

Australian Practitioner Directory Entry Profile

Provider directory details of an individual person delivering health related services.

Examples

Practitioner Directory Entry Example

SD.4.1 Formal Views of Profile Content

The official URL for this profile is: 

http://hl7.org.au/fhir/StructureDefinition/au-pd-practitioner

Base profile for Australian context Practitioner for provider directory usage

This profile builds on Australian Practitioner.

This profile was published on Fri May 05 16:52:22 AEST 2017 as a draft by null.

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

Australian Practitioner Directory Entry

  1. Must Support Optional: HPI-I
  2. Must Support Required: Active status
  3. Must Support Required: Usual name with family name and one or more given names
NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner 0..*
... identifier S0..*IdentifierHPI-I
... active S0..1boolean
... name HumanNameSlice: Unordered, Open At End by value:use
... name S1..*HumanNameUsual practitioner name
.... use 1..1codeFixed Value: usual
.... family 1..1string
.... given 1..*string

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner I0..*A person with a formal responsibility in the provisioning of healthcare or related services
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier ΣIdentifierA identifier for the person as this agent
Slice: Unordered, Open by value:system, value:type
... identifier SΣ0..*IdentifierHPI-I
... active SΣ0..1booleanWhether this practitioner's record is in active use
... name ΣHumanNameThe name(s) associated with the practitioner
Slice: Unordered, Open At End by value:use
... name SΣ1..*HumanNameUsual practitioner name
.... id 0..1stringxml:id (or equivalent in JSON)
.... use ?!Σ1..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required)
Fixed Value: usual
.... text Σ0..1stringText representation of the full name
.... family Σ1..1stringFamily name (often called 'Surname')
.... given Σ1..*stringGiven names (not always 'first'). Includes middle names
This repeating element order: Given Names appear in the correct order for presenting the name
.... prefix Σ0..*stringParts that come before the name
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix Σ0..*stringParts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ0..1PeriodTime period when name was/is in use
... telecom Σ0..*ContactPointA contact detail for the practitioner (that apply to all roles)
... address Σ0..*AddressAddress(es) of the practitioner that are not role specific (typically home address)
... gender Σ0..1codemale | female | other | unknown
Binding: AdministrativeGender (required)
... birthDate Σ0..1dateThe date on which the practitioner was born
... photo 0..*AttachmentImage of the person
... qualification I0..*BackboneElementQualifications obtained by training and certification
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... identifier 0..*IdentifierAn identifier for this qualification for the practitioner
.... code 1..1CodeableConceptCoded representation of the qualification
Binding: v2 table 0360, Version 2.7 (example)
.... period 0..1PeriodPeriod during which the qualification is valid
.... issuer 0..1Reference(Organization)Organization that regulates and issues the qualification
... communication 0..*CodeableConceptA language the practitioner is able to use in patient communication
Binding: Common Languages (extensible)

doco Documentation for this format

Australian Practitioner Directory Entry

  1. Must Support Optional: HPI-I
  2. Must Support Required: Active status
  3. Must Support Required: Usual name with family name and one or more given names

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner 0..*
... identifier S0..*IdentifierHPI-I
... active S0..1boolean
... name HumanNameSlice: Unordered, Open At End by value:use
... name S1..*HumanNameUsual practitioner name
.... use 1..1codeFixed Value: usual
.... family 1..1string
.... given 1..*string

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner I0..*A person with a formal responsibility in the provisioning of healthcare or related services
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier ΣIdentifierA identifier for the person as this agent
Slice: Unordered, Open by value:system, value:type
... identifier SΣ0..*IdentifierHPI-I
... active SΣ0..1booleanWhether this practitioner's record is in active use
... name ΣHumanNameThe name(s) associated with the practitioner
Slice: Unordered, Open At End by value:use
... name SΣ1..*HumanNameUsual practitioner name
.... id 0..1stringxml:id (or equivalent in JSON)
.... use ?!Σ1..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required)
Fixed Value: usual
.... text Σ0..1stringText representation of the full name
.... family Σ1..1stringFamily name (often called 'Surname')
.... given Σ1..*stringGiven names (not always 'first'). Includes middle names
This repeating element order: Given Names appear in the correct order for presenting the name
.... prefix Σ0..*stringParts that come before the name
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix Σ0..*stringParts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ0..1PeriodTime period when name was/is in use
... telecom Σ0..*ContactPointA contact detail for the practitioner (that apply to all roles)
... address Σ0..*AddressAddress(es) of the practitioner that are not role specific (typically home address)
... gender Σ0..1codemale | female | other | unknown
Binding: AdministrativeGender (required)
... birthDate Σ0..1dateThe date on which the practitioner was born
... photo 0..*AttachmentImage of the person
... qualification I0..*BackboneElementQualifications obtained by training and certification
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... identifier 0..*IdentifierAn identifier for this qualification for the practitioner
.... code 1..1CodeableConceptCoded representation of the qualification
Binding: v2 table 0360, Version 2.7 (example)
.... period 0..1PeriodPeriod during which the qualification is valid
.... issuer 0..1Reference(Organization)Organization that regulates and issues the qualification
... communication 0..*CodeableConceptA language the practitioner is able to use in patient communication
Binding: Common Languages (extensible)

doco Documentation for this format

Downloads: StructureDefinition: (XML, JSON), Schema: XML Schematron

 

SD.4.2 Quick Start

Below is an overview of the requirements for search and read operations.

Read: Practitioner

Read identified practitioner resource content.

GET [base]/Practitioner/[id]

Example: GET [base]/Practitioner/1234

Support: MUST support read Practitioner

Implementation Notes: [(how to read resource)

Search: Practitioner Name

Search based on family, given and/or any name.

GET [base]/Practitioner?family=[string]

GET [base]/Practitioner?family=[string]&given=[string]

GET [base]/Practitioner?name=[string]

Example:

GET [base]/Practitioner?family=Smith

GET [base]/Practitioner?family=Smith&practitioner.given=John

GET [base]/Practitioner?name=Smith

Support: SHOULD support search by family, given and name.

Implementation Notes: (how to search by string)

Search: HPI-I

Search based on identifier token.

GET [base]/Practitioner?identifier=[system]|[value]

Example: GET [base]/Practitioner?identifier=http://ns.electronichealth.net.au/id/hi/hpii/1.0|8003610833334085

Support: SHOULD support search by HPI-I.

Implementation Notes: (how to search by token)