2nd DSTU Draft For Comment

This page is part of the FHIR Specification (v0.4.0: DSTU 2 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

5.4.7 Resource Practitioner - Detailed Descriptions

Detailed Descriptions for the elements in the Practitioner resource.

Practitioner
Definition

A person who is directly or indirectly involved in the provisioning of healthcare.

Control1..1
Requirements

Need to track doctors, staff, locums etc. for both healthcare practitioners, funders, etc.

Comments

Note that a cab driver no longer fits the bill. You probably would be interested in the organization rather than the individual?.

Practitioner.identifier
Definition

An identifier that applies to this person in this role.

Control0..*
TypeIdentifier
Requirements

Often, specific identities are assigned for the agent.

Summarytrue
Practitioner.name
Definition

A name associated with the person.

Control0..1
TypeHumanName
Requirements

Contact persons need to be identified by name, but it is uncommon to need details about multiple other names for that person.

Summarytrue
Practitioner.telecom
Definition

A contact detail for the practitioner, e.g. a telephone number or an email address.

Control0..*
TypeContactPoint
Requirements

Need to know how to reach a practitioner.

Summarytrue
Comments

Person may have multiple ways to be contacted with different uses or applicable periods. May need to have options for contacting the person urgently, and also to help with identification.

Practitioner.address
Definition

The postal address where the practitioner can be found or visited or to which mail can be delivered.

Control0..*
TypeAddress
Requirements

Need to keep track where the practitioner can found during work or for directing mail.

Summarytrue
Practitioner.gender
Definition

Administrative Gender - the gender that the person is considered to have for administration and record keeping purposes.

Control0..1
BindingAdministrativeGender: Required: http://hl7.org/fhir/administrative-gender (The gender of a person used for administrative purposes)
Typecode
Requirements

Needed to address the person correctly.

Summarytrue
Practitioner.birthDate
Definition

The date of birth for the practitioner.

Control0..1
Typedate
Requirements

Needed for identification.

Summarytrue
Practitioner.photo
Definition

Image of the person.

Control0..*
TypeAttachment
Requirements

Many EHR systems have the capability to capture an image of patients and personnel. Fits with newer social media usage too.

Practitioner.practitionerRole
Definition

The list of Roles/Organizations that the Practitioner is associated with.

Control0..*
Practitioner.practitionerRole.managingOrganization
Definition

The Organization where the Practitioner performs the roles associated.

Control0..1
TypeReference(Organization)
Practitioner.practitionerRole.role
Definition

Roles which this practitioner is authorized to perform for the organization.

Control0..1
BindingPractitionerRole: Example: See http://hl7.org/fhir/vs/practitioner-role (The role a person plays representing an organization)
TypeCodeableConcept
Requirements

Need to know what authority the practitioner has - what can they do?.

Summarytrue
Comments

A person may have more than one role. At least one role is required.

Practitioner.practitionerRole.specialty
Definition

Specific specialty of the practitioner.

Control0..*
BindingPractitionerSpecialty: Example: See http://hl7.org/fhir/vs/practitioner-specialty (Specific specialty associated with the agency)
TypeCodeableConcept
Summarytrue
Practitioner.practitionerRole.period
Definition

The period during which the person is authorized to act as a practitioner in these role(s) for the organization.

Control0..1
TypePeriod
Requirements

Even after the agencies is revoked, the fact that it existed must still be recorded.

Summarytrue
Practitioner.practitionerRole.location
Definition

The location(s) at which this practitioner provides care.

Control0..*
TypeReference(Location)
Practitioner.practitionerRole.healthcareService
Definition

The list of healthcare services that this worker offers at this location of this organization.

Control0..*
TypeReference(HealthcareService)
Practitioner.qualification
Definition

Qualifications obtained by training and certification.

Control0..*
Practitioner.qualification.identifier
Definition

An identifier that applies to this person's qualification in this role.

Control0..*
TypeIdentifier
Requirements

Often, specific identities are assigned for the qualification.

Practitioner.qualification.code
Definition

Coded representation of the qualification.

Control1..1
BindingQualification: Example: See http://hl7.org/fhir/vs/anzsco-occupations (Specific qualification the practitioner has to provide a service)
TypeCodeableConcept
Practitioner.qualification.period
Definition

Period during which the qualification is valid.

Control0..1
TypePeriod
Requirements

Qualifications are often for a limited period of time, and can be revoked.

Practitioner.qualification.issuer
Definition

Organization that regulates and issues the qualification.

Control0..1
TypeReference(Organization)
Practitioner.communication
Definition

A language the practitioner is able to use in patient communication.

Control0..*
BindingLanguage: Required: IETF language tag (A human language)
TypeCodeableConcept
Requirements

Knowing which language a practitioner speaks can help in facilitating communication with patients.

Comments

The structure aa-BB with this exact casing is one the most widely used notations for locale. However not all systems actually code this but instead have it as free text. Hence CodeableConcept instead of code as the data type.