type: resource-definitionsresource: Practitioner

Practitioner Definitions

Practitioner

A person with a formal responsibility in the provisioning of healthcare or related services

Definition: A person who is directly or indirectly involved in the provisioning of healthcare or related services.

Cardinality: 0..*

Mappings: v2=PRD (as one example); rim=Role; interface=ParticipantLiving; servd=Provider; w5=administrative.individual

Practitioner.identifier

An identifier for the person as this agent

Definition: An identifier that applies to this person in this role.

Requirements: Often, specific identities are assigned for the agent.

Cardinality: 0..*

Type: Identifier

Summary: true

Mappings: w5=FiveWs.identifier; v2=PRD-7 (or XCN.1); rim=./id; interface=Participant.identifier; servd=./Identifiers

Practitioner.active

Whether this practitioner's record is in active use

Definition: Whether this practitioner's record is in active use.

Comments: If the practitioner is not in use by one organization, then it should mark the period on the PractitonerRole with an end date (even if they are active) as they may be active in another role.

Requirements: Need to be able to mark a practitioner record as not to be used because it was created in error.

Meaning if Missing: This resource is generally assumed to be active if no value is provided for the active element

Cardinality: 0..1

Type: boolean

Summary: true

Is Modifier: true (Reason: This element is labelled as a modifier because it is a status element that can indicate that a record should not be treated as valid)

Mappings: w5=FiveWs.status; rim=./statusCode; interface=Participant.active

Practitioner.name

The name(s) associated with the practitioner

Definition: The name(s) associated with the practitioner.

Comments: The selection of the use property should ensure that there is a single usual name specified, and others use the nickname (alias), old, or other values as appropriate.

In general, select the value to be used in the ResourceReference.display based on this:

There is more than 1 name
Use = usual
Period is current to the date of the usage
Use = official
Other order as decided by internal business rules.

Requirements: The name(s) that a Practitioner is known by. Where there are multiple, the name that the practitioner is usually known as should be used in the display.

Cardinality: 0..*

Type: HumanName

Summary: true

Mappings: v2=XCN Components; rim=./name; interface=Participant.name; servd=./PreferredName (GivenNames, FamilyName, TitleCode)

Practitioner.telecom

A contact detail for the practitioner (that apply to all roles)

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

Comments: Practitioner 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.

DO NOT use .telecom properties to represent user identities. Refer to the Security and Privacy section for additional guidance on representing user identities.

Requirements: Need to know how to reach a practitioner independent to any roles the practitioner may have.

Cardinality: 0..*

Type: ContactPoint

Summary: true

Mappings: v2=PRT-15, STF-10, ROL-12; rim=./telecom; interface=ParticipantContactable.telecom; servd=./ContactPoints

Practitioner.gender

male | female | other | unknown

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

Requirements: Needed to address the person correctly.

Cardinality: 0..1

Type: code

Binding: required:administrative-gender

Summary: true

Mappings: v2=STF-5; rim=./administrativeGender; interface=ParticipantLiving.gender; servd=./GenderCode

Practitioner.birthDate

The date on which the practitioner was born

Definition: The date of birth for the practitioner.

Requirements: Needed for identification.

Cardinality: 0..1

Type: date

Summary: true

Mappings: v2=STF-6; rim=./birthTime; interface=ParticipantLiving.birthDate; servd=(not represented in ServD)

Practitioner.deceased[x]

Indicates if the practitioner is deceased or not

Definition: Indicates if the practitioner is deceased or not.

Comments: If there's no value in the instance, it means there is no statement on whether or not the practitioner is deceased. Most systems will interpret the absence of a value as a sign of the person being alive.

Cardinality: 0..1

Type: boolean, dateTime

Summary: true

Is Modifier: true (Reason: This element is labeled as a modifier because once a practitioner is marked as deceased, the record should only be used/retained for historical purposes.)

Mappings: rim=player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime

Practitioner.address

Address(es) of the practitioner that are not role specific (typically home address)

Definition: Address(es) of the practitioner that are not role specific (typically home address). Work addresses are not typically entered in this property as they are usually role dependent.

Comments: The PractitionerRole does not have an address value on it, as it is expected that the location property be used for this purpose (which has an address).

Requirements: The home/mailing address of the practitioner is often required for employee administration purposes, and also for some rostering services where the start point (practitioners home) can be used in calculations.

Cardinality: 0..*

Type: Address

Summary: true

Mappings: v2=ORC-24, STF-11, ROL-11, PRT-14; rim=./addr; interface=ParticipantContactable.address; servd=./Addresses

Practitioner.photo

Image of the person

Definition: Image of the person.

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

Cardinality: 0..*

Type: Attachment

Mappings: rim=./subjectOf/ObservationEvent[code="photo"]/value; interface=ParticipantLiving.photo; servd=./ImageURI (only supports the URI reference)

Practitioner.qualification

Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care

Definition: The official qualifications, certifications, accreditations, training, licenses (and other types of educations/skills/capabilities) that authorize or otherwise pertain to the provision of care by the practitioner.

For example, a medical license issued by a medical board of licensure authorizing the practitioner to practice medicine within a certain locality.

Comments: The PractitionerRole.specialty defines the functional role that they are practicing at a given organization or location. Those specialties may or might not require a qualification, and are not defined on the practitioner.

Cardinality: 0..*

Type: BackboneElement

Mappings: v2=CER?; rim=.playingEntity.playingRole[classCode=QUAL].code; servd=./Qualifications

Practitioner.qualification.identifier

An identifier for this qualification for the practitioner

Definition: An identifier that applies to this person's qualification.

Comments: Systems MAY use identifier for user identities (using the type='USER'). Refer to the Security and Privacy section for additional guidance on representing user identities.

Requirements: Often, specific identities are assigned for the qualification.

Cardinality: 0..*

Type: Identifier

Mappings: rim=.playingEntity.playingRole[classCode=QUAL].id

Practitioner.qualification.code

Coded representation of the qualification

Definition: Coded representation of the qualification.

Cardinality: 1..1

Type: CodeableConcept

Binding: example:v2-0360

Mappings: rim=.playingEntity.playingRole[classCode=QUAL].code; servd=./Qualifications.Value

Practitioner.qualification.status

Status/progress of the qualification

Definition: Qualifications often take time to attain and might be tracked during this time, and completed qualifications might not always be valid. This status concept has some overlap with period and both should be considered together. Refer to the descriptions of the codes for how the period should be interpreted.

If a qualification is revoked or otherwise cancelled, then the period is likely to be ignored, and m be related to when it was active.

Cardinality: 0..1

Type: CodeableConcept

Binding: preferred:qualification-status

Mappings: rim=N/A

Practitioner.qualification.period

Period during which the qualification is valid

Definition: Period during which the qualification is valid.

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

Cardinality: 0..1

Type: Period

Mappings: rim=.playingEntity.playingRole[classCode=QUAL].effectiveTime; servd=./Qualifications.StartDate and ./Qualifications.EndDate

Practitioner.qualification.issuer

Organization that regulates and issues the qualification

Definition: Organization that regulates and issues the qualification.

Cardinality: 0..1

Type: Reference(Organization)

Mappings: rim=.playingEntity.playingRole[classCode=QUAL].scoper

Practitioner.communication

A language which may be used to communicate with the practitioner

Definition: A language which may be used to communicate with the practitioner, often for correspondence/administrative purposes.

The PractitionerRole.communication property should be used for publishing the languages that a practitioner is able to communicate with patients (on a per Organization/Role basis).

Comments: If no language is specified, this implies that the default local language is spoken. If you need to convey proficiency for multiple modes, then you need multiple Practitioner.Communication associations, using the patient-proficiency extension.

For animals, language is not a relevant field, and should be absent from the instance.

Cardinality: 0..*

Type: BackboneElement

Mappings: rim=LanguageCommunication

Practitioner.communication.language

The language code used to communicate with the practitioner

Definition: The language which may be used to communicate with the individual.

Comments: The language is commonly represented using the ISO-639-1 alpha code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha code for the region in upper case. For example, "en" for English, or "en-US" for American English versus "en-AU" for Australian English, sgn-US for American Sign Language, sgn-NL for Dutch Sign Language, etc.

Not all systems actually code this but instead have it as free text. Hence CodeableConcept instead of code as the data type.

Requirements: Most systems in multilingual countries will want to convey language. Not all systems actually need the regional dialect.

Cardinality: 1..1

Type: CodeableConcept

Binding: required:all-languages

Mappings: v2=PID-15, LAN-2; rim=player[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code

Practitioner.communication.preferred

Language preference indicator

Definition: Indicates whether or not the person prefers this language (over other languages he masters up a certain level).

Comments: This language is specifically identified for communicating directly with the practitioner (typically un-related to patient communications).

Requirements: People that master multiple languages up to certain level may prefer one or more, i.e. feel more confident in communicating in a particular language making other languages sort of a fall back method.

Cardinality: 0..1

Type: boolean

Mappings: rim=preferenceInd