NHS England FHIR Implementation Guide (deprecated)

Element Id

PractitionerRole.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-NHSDigital-Account-code

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

costCentre

S I

0..1

Extension(Complex)

Element Id

PractitionerRole.extension:costCentre

Short description

Optional Extensions Element

Alternate names

extensions, user content

Definition

Optional Extension Element - found in all resources.

Comments

Data Type

Extension(Complex)

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

identifier

S Σ

0..*

Element Id

PractitionerRole.identifier

Short description

An identifier that applies to this person in this role.

Definition

FHIR identifier	OID/HL7v3	HL7v2 ITK	Format	Description	Professional Code	Prescribing Code
https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code			G[67]NNNNNN	NHS BSA Spurious Code GENERAL MEDICAL PRACTITIONER PPD CODE	No	Yes
https://fhir.nhs.uk/Id/sds-role-profile-id	1.2.826.0.1285.0.2.0.67		12 digits	SDS Role Profile Code	No	No

The SDS Role Profile Code should be sourced from NHS Identity (SmartCard), this is also held within the Spine Directory Service LDAP database.

Holds NHS BSA spurious codes which are role specific Doctor Index Number (DIN)) codes. NHS BSA spurious codes are issued when a doctor issues medication outside of their normal role, normally at another organisation. In the example below, the doctor is working in a secondary role (with SDS Role Id of 100102238986), as this a has a spurious code of 2345213. If the doctor was prescribing in their primary role this spurious code would be absent.

{
  "resourceType": "PractitionerRole",
  ...
  "identifier": [
          {
            "system": "https://fhir.nhs.uk/Id/sds-role-profile-id",
            "value": "100102238986"
          },
          {
            "system": "https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code",
            "value": "2345213"
          }
        ],
  ...
}

Requirements

Often, specific identities are assigned for the agent.

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
w5:FiveWs.identifier
v2:PRD-7 (or XCN.1)
rim:.id
servd:./Identifiers

(All Slices)

There are no (further) constraints on this element

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension. Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times").

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

sdsRoleProfileID

S Σ

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID

Short description

An identifier that applies to this person in this role.

Definition

An identifier that applies to this person in this role.

Requirements

Often, specific identities are assigned for the agent.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
w5:FiveWs.identifier
v2:PRD-7 (or XCN.1)
rim:.id
servd:./Identifiers

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

PractitionerRole.identifier:sdsRoleProfileID.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/sds-role-profile-id

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

nhsbsaSpuriousCode

S Σ

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode

Short description

An identifier that applies to this person in this role.

Definition

An identifier that applies to this person in this role.

Requirements

Often, specific identities are assigned for the agent.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
w5:FiveWs.identifier
v2:PRD-7 (or XCN.1)
rim:.id
servd:./Identifiers

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

active

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.active

Short description

Whether this practitioner role record is in active use

Definition

Whether this practitioner role record is in active use.

Requirements

Need to be able to mark a practitioner role record as not to be used because it was created in error, or otherwise no longer in active use.

Comments

If this value is false, you may refer to the period to see when the role was in active use. If there is no period specified, no inference can be made about when it was active.

Meaning When Missing

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

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
w5:FiveWs.status
v2:STF-7
rim:.statusCode

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.period

Short description

The period during which the practitioner is authorized to perform in these role(s)

Definition

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

Requirements

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

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
w5:FiveWs.done[x]
v2:PRD-8/9 / PRA-5.4
rim:.performance[@typeCode <= 'PPRF'].ActDefinitionOrEvent.effectiveTime
servd:(ServD maps Practitioners and Organizations via another entity, so this concept is not available)

practitioner

S Σ I

0..1

Element Id

PractitionerRole.practitioner

Short description

Practitioner that is able to provide the defined services for the organization

Definition

This MUST either be a reference to a Practitioner resource or an identifier reference plus a display. In both cases the referenced resource or identfier reference should contain a professional code.

It is recommended an identifier reference and display (practioner full name) is included. This identifier should be the Practitioner's primary professional code (see NHSDigital-Practitioner for details on professional codes).

"practitioner": {
        "display": "Dr Smith",
        "identifier": {
            "system": "https://fhir.hl7.org.uk/Id/gmc-number",
            "value": "C9876543"
          }
    },

For EPS, currently a Resource reference is required.

"practitioner": {
        "reference": "urn:uuid:1557E58E-3B1E-41DD-B3B5-D4D393DC5A3D",
        "display": "Dr Smith"
    },

Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
nhsd-2:An identifier reference or resource reference must be provided
(reference.exists() or identifier.exists())
role-nmc:NMC must be of the format NNANNNNA
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').value.matches('^[0-9]{2}[A-Z]{1}[0-9]{4}[A-Z]{1}$'))
role-gmp:GMP must be of the format GNNNNNNN and not be a spurious code (starts with G6 or G7)
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').value.matches('^[G]{1}[01234589]{1}[0-9]{6}$'))
role-gmc:GMC must be of the format CNNNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').value.matches('^[C]{1}[0-9]{7}$'))
role-gphc:GPHC must be of the format NNNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').value.matches('^[0-9]{7}$'))
role-hcpc:HCPC must be of the format AANNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').value.matches('^[A-Z]{2}[0-9]{6}$'))
role-din:DIN format must be NNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').value.matches('^[0-9]{6}$'))
role-sds-user-numeric:sds-user-id must be numeric
identifier.where(system='https://fhir.nhs.uk/Id/sds-user-id').exists().not() or (identifier.where(system='https://fhir.nhs.uk/Id/sds-user-id').exists() and identifier.where(system='https://fhir.nhs.uk/Id/sds-user-id').value.matches('^[0-9]+$'))
role-gmcreferencenumber:GMC Reference Number must be of the format NNNNNNN
identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-reference-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-reference-number').value.matches('^[0-9]{7}$'))
nacs-code-retired:NACS (/ODS) Practitioner Identifier is retired in NHS FHIR and should not be used. Please use the actual naming system instead (e,g, https://fhir.hl7.org.uk/Id/gmc-number, https://fhir.hl7.org.uk/Id/gmp-number, etc).
identifier.where(system='https://fhir.hl7.org.uk/Id/professional-code').exists().not()

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
rim:.player

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources.

Comments

Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

The type is the Canonical URL of Resource Definition that is the type this reference refers to. References are URLs that are relative to http://hl7.org/fhir/StructureDefinition/ e.g. "Patient" is a reference to http://hl7.org/fhir/StructureDefinition/Patient. Absolute URLs are only allowed for logical models (and can only be used in references in logical models, not resources).

Comments

This element is used to indicate the type of the target of the reference. This may be used which ever of the other elements are populated (or not). In some cases, the type of the target may be determined by inspection of the reference (e.g. a RESTful URL) or by resolving the target of the reference; if both the type and a reference is provided, the reference SHALL resolve to a resource of the same type as that specified.

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier

Short description

Logical reference, when literal reference is not known

Definition

An identifier for the target resource. This is used when there is no way to reference the other resource directly, either because the entity it represents is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference.

Comments

When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy.

When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Reference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any).

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

organization

S Σ I

0..1

Element Id

PractitionerRole.organization

Short description

Organization where the roles are available

Definition

This MUST either be a reference to a Organization resource or an identifier reference. In both cases the reference must contain an ANANA/ODS organisation code.

organisation resource references

It is recommended an identifier reference is included.

"organization": {
        "identifier": {
            "system": "https://fhir.nhs.uk/Id/ods-organization-code",
            "value": "RBA"
          },
        "display": "TAUNTON AND SOMERSET NHS FOUNDATION TRUST"
    }

Optionally Resource reference can be provided. This is required in the current version of EPS but this will be changed to supporting the identifier reference only.

"organization": {
        "reference": "urn:uuid:17c4270d-6966-4788-8cbc-1d1d63536b25",
        "identifier": {
            "system": "https://fhir.nhs.uk/Id/ods-organization-code",
            "value": "RBA"
          },
        "display": "TAUNTON AND SOMERSET NHS FOUNDATION TRUST"
    }

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
nhsd-1:PractitionerRole.organization - An identifier reference or resource reference should be provided
(reference.exists() or identifier.exists())

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
rim:.scoper

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

code

S Σ

0..*

Element Id

PractitionerRole.code

Short description

Roles which this practitioner may perform

Definition

Only supply if this is known from SmartCard/CIS2 data.

"code":  [
        {
            "coding":  [
                {
                    "system": "https://fhir.nhs.uk/CodeSystem/NHSDigital-SDS-JobRoleCode",
                    "code": "S0030:G0100:R0620"
                  }
            ]
        }
    ],

The previous system for this entry was https://fhir.hl7org.uk/CodeSystem/UKCore-SDSJobRoleName, this has been retired and https://fhir.nhs.uk/CodeSystem/NHSDigital-SDS-JobRoleCode should be used instead. Note: https://fhir.hl7org.uk/CodeSystem/UKCore-SDSJobRoleName is currently used by EPS but will be retired in a future release. Pending further guidance, both CodeSystems should be used for EPS interations

Requirements

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

Comments

A person may have more than one role.

Data Type

Binding

The role a person plays representing an organization.

PractitionerRole (example)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:PRD-1 / STF-18 / PRA-3 / PRT-4 / ROL-3 / ORC-12 / OBR-16 / PV1-7 / PV1-8 / PV1-9 / PV1-17
rim:.code
servd:(ServD maps Practitioners and Organizations via another entity, so this concept is not available)

coding

1..*

Element Id

PractitionerRole.code.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

(All Slices)

There are no (further) constraints on this element

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.version

Short description

Version of the system - if relevant

Definition

The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured, and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.

Comments

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

sdsJobRoleCode

S Σ

0..1

Element Id

PractitionerRole.code.coding:sdsJobRoleCode

Short description

SDS Job Role Code

Definition

This value should be sourced from either APIM OAuth2 userinfo endpoint, SDS LDAP or CIS2/SmartCard details.

The CodeSystem is variable and is not present in this Implementation Guide.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

0..1

uriFixed Value

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/CodeSystem/NHSDigital-SDS-JobRoleCode

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

SDSJobRoleName

0..*

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

0..1

uriFixed Value

Element Id

PractitionerRole.code.coding:SDSJobRoleName.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.hl7.org.uk/CodeSystem/UKCore-SDSJobRoleName

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

ukCoreSNOMEDCT

0..*

CodingBinding

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

UKCorePractitionerRoleCode (preferred)

Binding

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

0..1

uriFixed Value

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

http://snomed.info/sct

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

specialty

S Σ

0..*

CodeableConceptBinding

Element Id

PractitionerRole.specialty

Short description

Specific specialty of the practitioner

Definition

This is should be the specialty linked to the role and is not necessarily the practitioners main specialty.

 "specialty": [
        {
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "394814009",
                    "display": "General practice (specialty)"
                }
            ]
        }
    ],

Comments

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

Data Type

UKCorePracticeSettingCode (extensible)

Binding

Specific specialty associated with the agency.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:PRA-5
rim:.player.HealthCareProvider[@classCode = 'PROV'].code
servd:./Specialty

coding

1..*

Element Id

PractitionerRole.specialty.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

(All Slices)

There are no (further) constraints on this element

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

SNOMEDSpecialty

S Σ

0..*

CodingBinding

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

PracticeSettingCodeValueSet (preferred)

Binding

Specific specialty associated with the agency.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

0..1

uriFixed Value

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

http://snomed.info/sct

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

location

Σ I

0..*

Element Id

PractitionerRole.location

Short description

The location(s) at which this practitioner provides care

Definition

The contact address for the practitioner for the service they are providing in this role. This will often be the surgery address, clinic or service address.

If using ODS Codes, the address on ODS must be checked to ensure it is correct. If the address is not correct, then Resource reference MUST be supplied.

"location":  [
         {
            "identifier": {
              "system": "https://fhir.nhs.uk/Id/ods-organization-code",
              "value": "RCB55"
            }
            "display": "YORK HOSPITAL"
          }
  ]

For EPS, currently a Resource reference is required.

"location":  [
         {
            "reference": "urn:uuid:ecc2db8e-3757-4758-a4f1-7f4c7e06662f",
            "display": "YORK HOSPITAL"
          }
  ]

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
nhsd-3:PractitionerRole.location - An identifier or resource reference must be provided
(reference.exists() or identifier.exists())

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
w5:FiveWs.where[x]
rim:.performance.ActDefinitionOrEvent.ServiceDeliveryLocation[@classCode = 'SDLOC']
servd:(ServD maps Practitioners and Organizations via another entity, so this concept is not available)<br/> However these are accessed via the Site.ServiceSite.ServiceSiteProvider record. (The Site has the location)

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.location.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

healthcareService

S I

0..1

Element Id

PractitionerRole.healthcareService

Short description

The list of healthcare services that this worker provides for this role's Organization/Location(s)

Definition

SHOULD be provided for a practitioner in secondary care and will be a reference to clinic or service. This referenced resource or the identifier reference SHOULD contain a ODS/ANANA identifier. In secondary care Electronic Prescription Service (EPS) this will also be called prescribing cost centre. This is used for reimbursements from NHS BSA. In secondary care the healthchare/service cost centre may also be the ODS code for the clinic.

healthcareService Resource reference

An identifier reference MUST be included. For secondary care organisations this will be the ODS/ANANA Cost Centre code given to a clinic.

"healthcareService":  
    [
         {
            "identifier": {
              "system": "https://fhir.nhs.uk/Id/ods-organization-code",
              "value": "A99968"
            }
            "display": "SOMERSET BOWEL CANCER SCREENING CENTRE"
          }
    ]

Optionally Resource reference can be provided. This is required in the current version of EPS but this will be changed to supporting the identifier reference only.

"healthcareService":  
    [
         {
            "reference": "urn:uuid:54b0506d-49af-4245-9d40-d7d64902055e",
            "identifier": {
              "system": "https://fhir.nhs.uk/Id/ods-organization-code",
              "value": "A99968"
            }
            "display": "SOMERSET BOWEL CANCER SCREENING CENTRE"
          }
    ]

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
nhsd-4:PractitionerRole.healthcareService - An identifier reference or resource reference must be provided
(reference.exists() or (identifier.exists()))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:EDU-2 / AFF-3
rim:.player.QualifiedEntity[@classCode = 'QUAL'].code

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

telecom

S Σ I

0..*

Element Id

PractitionerRole.telecom

Short description

Contact details that are specific to the role/location/service

Definition

At least one telecom number MUST be provided. Contact details that are specific to the role/location/service. Often practitioners have a dedicated line for each location (or service) that they work at and need to be able to define separate contact details for each of these.

This is not the personnel contact number of the Practitioner, it the contact number for the practitioner in this role and may be the phone number of the clinic, main or branch surgery.

"telecom": [
          {
            "system": "phone",
            "value": "01234567890",
            "use": "work"
          }
        ]

Requirements

Often practitioners have a dedicated line for each location (or service) that they work at, and need to be able to define separate contact details for each of these.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
cpt-2:A system is required if a value is provided.
value.empty() or system.exists()

Mappings

rim:n/a
v2:XTN
rim:TEL
servd:ContactPoint
rim:.telecom

system

Σ I

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.system

Short description

phone | fax | email | pager | url | sms | other

Definition

Telecommunications form for contact point - what communications system is required to make use of the contact.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

Telecommunications form for contact point.

ContactPointSystem (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:XTN.3
rim:./scheme
servd:./ContactPointType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.value

Short description

The actual contact point details

Definition

The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address).

Requirements

Need to support legacy numbers that are not in a tightly controlled format.

Comments

Additional text data such as phone extension numbers, or notes about use of the contact are sometimes included in the value.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:XTN.1 (or XTN.12)
rim:./url
servd:./Value

use

Σ ?!

1..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.use

Short description

home | work | temp | old | mobile - purpose of this contact point

Definition

Identifies the purpose for the contact point.

Requirements

Need to track the way a person uses this contact, so a user can choose which is appropriate for their purpose.

Comments

Applications can assume that a contact is current unless it explicitly says that it is temporary or old.

Data Type

Binding

Use of contact point.

ContactPointUse (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:XTN.2 - but often indicated by field
rim:unique(./use)
servd:./ContactPointPurpose

rank

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.rank

Short description

Specify preferred order of use (1 = highest)

Definition

Specifies a preferred order in which to use a set of contacts. ContactPoints with lower rank values are more preferred than those with higher rank values.

Comments

Note that rank does not necessarily follow the order in which the contacts are represented in the instance.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:n/a

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.period

Short description

Time period when the contact point was/is in use

Definition

Time period when the contact point was/is in use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:N/A
rim:./usablePeriod[type="IVL<TS>"]
servd:./StartDate and ./EndDate

availableTime

0..*

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime

Short description

Times the Service Site is available

Definition

A collection of times the practitioner is available or performing this role at the location and/or healthcareservice.

Comments

More detailed availability information may be provided in associated Schedule/Slot resources.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

daysOfWeek

0..*

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime.daysOfWeek

Short description

mon | tue | wed | thu | fri | sat | sun

Definition

Indicates which days of the week are available between the start and end Times.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

The days of the week.

DaysOfWeek (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

allDay

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime.allDay

Short description

Always available? e.g. 24 hour service

Definition

Is this always available? (hence times are irrelevant) e.g. 24 hour service.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

availableStartTime

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime.availableStartTime

Short description

Opening time of day (ignored if allDay = true)

Definition

The opening time of day. Note: If the AllDay flag is set, then this time is ignored.

Comments

The timezone is expected to be for where this HealthcareService is provided at.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

availableEndTime

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime.availableEndTime

Short description

Closing time of day (ignored if allDay = true)

Definition

The closing time of day. Note: If the AllDay flag is set, then this time is ignored.

Comments

The timezone is expected to be for where this HealthcareService is provided at.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

notAvailable

0..*

There are no (further) constraints on this element

Element Id

PractitionerRole.notAvailable

Short description

Not available during this time due to provided reason

Definition

The practitioner is not available or performing this role during this period of time due to the provided reason.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

description

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.notAvailable.description

Short description

Reason presented to the user explaining why time not available

Definition

The reason that can be presented to the user as to why this time is not available.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a

during

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.notAvailable.during

Short description

Service not available from this date

Definition

Service is not available (seasonally or for a public holiday) from this date.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
rim:.effectiveTime

availabilityExceptions

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.availabilityExceptions

Short description

Description of availability exceptions

Definition

A description of site availability exceptions, e.g. public holiday availability. Succinctly describing all possible exceptions to normal site availability as details in the available Times and not available Times.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

endpoint

0..*

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint

Short description

Technical endpoints providing access to services operated for the practitioner with this role

Definition

Technical endpoints providing access to services operated for the practitioner with this role.

Requirements

Organizations have multiple systems that provide various services and ,ay also be different for practitioners too.

So the endpoint satisfies the need to be able to define the technical connection details for how to connect to them, and for what purpose.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

from UK Core PractitionerRole

PractitionerRole

Element Id

PractitionerRole

Short description

Roles/organizations the practitioner is associated with

Definition

A specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.

Data Type

PractitionerRole

Constraints

dom-2:If the resource is contained in another resource, it SHALL NOT contain nested Resources
contained.contained.empty()
dom-4:If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-3:If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-6:A resource should have narrative for robust management
text.`div`.exists()
dom-5:If a resource is contained in another resource, it SHALL NOT have a security label
contained.meta.security.empty()
role-spurious:Spurious Code format must be G6NNNNNN or G7NNNNNN
identifier.where(system='https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code').value.matches('^[G]{1}[67]{1}[0-9]{6}$'))
role-sds-role-profile:SDS Role Profile Id must be 12 digits
identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').exists().not() or (identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').exists() and identifier.where(system='https://fhir.nhs.uk/Id/sds-role-profile-id').value.matches('^[0-9]{12}$'))

Mappings

rim:Entity. Role, or Act
v2:PRD (as one example)
rim:Role
servd:ServiceSiteProvider

extension

0..*

Element Id

PractitionerRole.extension

Short description

Additional content defined by implementations

Alternate names

extensions, user content

Definition

Comments

Data Type

https://fhir.nhs.uk/StructureDefinition/Extension-NHSDigital-Account-code

Sliced:

Unordered, Open, by url(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

costCentre

S I

0..1

Extension(Complex)

Element Id

PractitionerRole.extension:costCentre

Short description

Optional Extensions Element

Alternate names

extensions, user content

Definition

Optional Extension Element - found in all resources.

Comments

Data Type

Extension(Complex)

Extension URL

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ext-1:Must have either extensions or value[x], not both
extension.exists() != value.exists()

Mappings

rim:n/a
rim:N/A

identifier

S Σ

0..*

Element Id

PractitionerRole.identifier

Short description

An identifier that applies to this person in this role.

Definition

FHIR identifier	OID/HL7v3	HL7v2 ITK	Format	Description	Professional Code	Prescribing Code
https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code			G[67]NNNNNN	NHS BSA Spurious Code GENERAL MEDICAL PRACTITIONER PPD CODE	No	Yes
https://fhir.nhs.uk/Id/sds-role-profile-id	1.2.826.0.1285.0.2.0.67		12 digits	SDS Role Profile Code	No	No

The SDS Role Profile Code should be sourced from NHS Identity (SmartCard), this is also held within the Spine Directory Service LDAP database.

{
  "resourceType": "PractitionerRole",
  ...
  "identifier": [
          {
            "system": "https://fhir.nhs.uk/Id/sds-role-profile-id",
            "value": "100102238986"
          },
          {
            "system": "https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code",
            "value": "2345213"
          }
        ],
  ...
}

Requirements

Often, specific identities are assigned for the agent.

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
w5:FiveWs.identifier
v2:PRD-7 (or XCN.1)
rim:.id
servd:./Identifiers

(All Slices)

There are no (further) constraints on this element

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

sdsRoleProfileID

S Σ

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID

Short description

An identifier that applies to this person in this role.

Definition

An identifier that applies to this person in this role.

Requirements

Often, specific identities are assigned for the agent.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
w5:FiveWs.identifier
v2:PRD-7 (or XCN.1)
rim:.id
servd:./Identifiers

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

PractitionerRole.identifier:sdsRoleProfileID.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/Id/sds-role-profile-id

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:sdsRoleProfileID.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

nhsbsaSpuriousCode

S Σ

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode

Short description

An identifier that applies to this person in this role.

Definition

An identifier that applies to this person in this role.

Requirements

Often, specific identities are assigned for the agent.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
w5:FiveWs.identifier
v2:PRD-7 (or XCN.1)
rim:.id
servd:./Identifiers

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

uriFixed Value

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.hl7.org.uk/Id/nhsbsa-spurious-code

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.identifier:nhsbsaSpuriousCode.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

active

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.active

Short description

Whether this practitioner role record is in active use

Definition

Whether this practitioner role record is in active use.

Requirements

Need to be able to mark a practitioner role record as not to be used because it was created in error, or otherwise no longer in active use.

Comments

If this value is false, you may refer to the period to see when the role was in active use. If there is no period specified, no inference can be made about when it was active.

Meaning When Missing

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

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
w5:FiveWs.status
v2:STF-7
rim:.statusCode

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.period

Short description

The period during which the practitioner is authorized to perform in these role(s)

Definition

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

Requirements

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

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
w5:FiveWs.done[x]
v2:PRD-8/9 / PRA-5.4
rim:.performance[@typeCode <= 'PPRF'].ActDefinitionOrEvent.effectiveTime
servd:(ServD maps Practitioners and Organizations via another entity, so this concept is not available)

practitioner

S Σ I

0..1

Element Id

PractitionerRole.practitioner

Short description

Practitioner that is able to provide the defined services for the organization

Definition

"practitioner": {
        "display": "Dr Smith",
        "identifier": {
            "system": "https://fhir.hl7.org.uk/Id/gmc-number",
            "value": "C9876543"
          }
    },

For EPS, currently a Resource reference is required.

"practitioner": {
        "reference": "urn:uuid:1557E58E-3B1E-41DD-B3B5-D4D393DC5A3D",
        "display": "Dr Smith"
    },

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
nhsd-2:An identifier reference or resource reference must be provided
(reference.exists() or identifier.exists())
role-nmc:NMC must be of the format NNANNNNA
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/nmc-number').value.matches('^[0-9]{2}[A-Z]{1}[0-9]{4}[A-Z]{1}$'))
role-gmp:GMP must be of the format GNNNNNNN and not be a spurious code (starts with G6 or G7)
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmp-number').value.matches('^[G]{1}[01234589]{1}[0-9]{6}$'))
role-gmc:GMC must be of the format CNNNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-number').value.matches('^[C]{1}[0-9]{7}$'))
role-gphc:GPHC must be of the format NNNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').value.matches('^[0-9]{7}$'))
role-hcpc:HCPC must be of the format AANNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/hcpc-number').value.matches('^[A-Z]{2}[0-9]{6}$'))
role-din:DIN format must be NNNNNN
identifier.exists().not() or identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/din-number').value.matches('^[0-9]{6}$'))
role-sds-user-numeric:sds-user-id must be numeric
identifier.where(system='https://fhir.nhs.uk/Id/sds-user-id').exists().not() or (identifier.where(system='https://fhir.nhs.uk/Id/sds-user-id').exists() and identifier.where(system='https://fhir.nhs.uk/Id/sds-user-id').value.matches('^[0-9]+$'))
role-gmcreferencenumber:GMC Reference Number must be of the format NNNNNNN
identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-reference-number').exists().not() or (identifier.where(system='https://fhir.hl7.org.uk/Id/gphc-number').exists() and identifier.where(system='https://fhir.hl7.org.uk/Id/gmc-reference-number').value.matches('^[0-9]{7}$'))
nacs-code-retired:NACS (/ODS) Practitioner Identifier is retired in NHS FHIR and should not be used. Please use the actual naming system instead (e,g, https://fhir.hl7.org.uk/Id/gmc-number, https://fhir.hl7.org.uk/Id/gmp-number, etc).
identifier.where(system='https://fhir.hl7.org.uk/Id/professional-code').exists().not()

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
rim:.player

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.practitioner.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

organization

S Σ I

0..1

Element Id

PractitionerRole.organization

Short description

Organization where the roles are available

Definition

This MUST either be a reference to a Organization resource or an identifier reference. In both cases the reference must contain an ANANA/ODS organisation code.

organisation resource references

It is recommended an identifier reference is included.

"organization": {
        "identifier": {
            "system": "https://fhir.nhs.uk/Id/ods-organization-code",
            "value": "RBA"
          },
        "display": "TAUNTON AND SOMERSET NHS FOUNDATION TRUST"
    }

Optionally Resource reference can be provided. This is required in the current version of EPS but this will be changed to supporting the identifier reference only.

"organization": {
        "reference": "urn:uuid:17c4270d-6966-4788-8cbc-1d1d63536b25",
        "identifier": {
            "system": "https://fhir.nhs.uk/Id/ods-organization-code",
            "value": "RBA"
          },
        "display": "TAUNTON AND SOMERSET NHS FOUNDATION TRUST"
    }

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
nhsd-1:PractitionerRole.organization - An identifier reference or resource reference should be provided
(reference.exists() or identifier.exists())

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
rim:.scoper

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.organization.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

code

S Σ

0..*

Element Id

PractitionerRole.code

Short description

Roles which this practitioner may perform

Definition

Only supply if this is known from SmartCard/CIS2 data.

"code":  [
        {
            "coding":  [
                {
                    "system": "https://fhir.nhs.uk/CodeSystem/NHSDigital-SDS-JobRoleCode",
                    "code": "S0030:G0100:R0620"
                  }
            ]
        }
    ],

Requirements

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

Comments

A person may have more than one role.

Data Type

Binding

The role a person plays representing an organization.

PractitionerRole (example)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:PRD-1 / STF-18 / PRA-3 / PRT-4 / ROL-3 / ORC-12 / OBR-16 / PV1-7 / PV1-8 / PV1-9 / PV1-17
rim:.code
servd:(ServD maps Practitioners and Organizations via another entity, so this concept is not available)

coding

1..*

Element Id

PractitionerRole.code.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

(All Slices)

There are no (further) constraints on this element

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

sdsJobRoleCode

S Σ

0..1

Element Id

PractitionerRole.code.coding:sdsJobRoleCode

Short description

SDS Job Role Code

Definition

This value should be sourced from either APIM OAuth2 userinfo endpoint, SDS LDAP or CIS2/SmartCard details.

The CodeSystem is variable and is not present in this Implementation Guide.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

0..1

uriFixed Value

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.nhs.uk/CodeSystem/NHSDigital-SDS-JobRoleCode

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:sdsJobRoleCode.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

SDSJobRoleName

0..*

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

0..1

uriFixed Value

Element Id

PractitionerRole.code.coding:SDSJobRoleName.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

https://fhir.hl7.org.uk/CodeSystem/UKCore-SDSJobRoleName

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:SDSJobRoleName.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

ukCoreSNOMEDCT

0..*

CodingBinding

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

UKCorePractitionerRoleCode (preferred)

Binding

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

0..1

uriFixed Value

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

http://snomed.info/sct

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.coding:ukCoreSNOMEDCT.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.code.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

specialty

S Σ

0..*

CodeableConceptBinding

Element Id

PractitionerRole.specialty

Short description

Specific specialty of the practitioner

Definition

This is should be the specialty linked to the role and is not necessarily the practitioners main specialty.

 "specialty": [
        {
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "394814009",
                    "display": "General practice (specialty)"
                }
            ]
        }
    ],

Comments

Data Type

UKCorePracticeSettingCode (extensible)

Binding

Specific specialty associated with the agency.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:PRA-5
rim:.player.HealthCareProvider[@classCode = 'PROV'].code
servd:./Specialty

coding

1..*

Element Id

PractitionerRole.specialty.coding

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

Sliced:

Unordered, Open, by system(Value)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

(All Slices)

There are no (further) constraints on this element

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

SNOMEDSpecialty

S Σ

0..*

CodingBinding

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty

Short description

Code defined by a terminology system

Definition

A reference to a code defined by a terminology system.

Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Data Type

PracticeSettingCodeValueSet (preferred)

Binding

Specific specialty associated with the agency.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
rim:CV
orim:fhir:Coding rdfs:subClassOf dt:CDCoding
v2:C*E.1-8, C*E.10-22
rim:union(., ./translation)
orim:fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding

system

0..1

uriFixed Value

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.system

Short description

Identity of the terminology system

Definition

The identification of the code system that defines the meaning of the symbol in the code.

Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Fixed Value

http://snomed.info/sct

Mappings

rim:n/a
v2:C*E.3
rim:./codeSystem
orim:fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem

version

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.version

Short description

Version of the system - if relevant

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.7
rim:./codeSystemVersion
orim:fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion

code

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.code

Short description

Symbol in syntax defined by the system

Definition

A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

Requirements

Need to refer to a particular code in the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.1
rim:./code
orim:fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.display

Short description

Representation defined by the system

Definition

A representation of the meaning of the code in the system, following the rules of the system.

Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.2 - but note this is not well followed
rim:CV.displayName
orim:fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName

userSelected

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.coding:SNOMEDSpecialty.userSelected

Short description

If this coding was chosen directly by the user

Definition

Indicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).

Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:Sometimes implied by being first
rim:CD.codingRationale
orim:fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]

text

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.specialty.text

Short description

Plain text representation of the concept

Definition

A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

Requirements

Comments

Very often the text is the same as a displayName of one of the codings.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:C*E.9. But note many systems use C*E.2 for this
rim:./originalText[mediaType/code="text/plain"]/data
orim:fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText

location

Σ I

0..*

Element Id

PractitionerRole.location

Short description

The location(s) at which this practitioner provides care

Definition

The contact address for the practitioner for the service they are providing in this role. This will often be the surgery address, clinic or service address.

If using ODS Codes, the address on ODS must be checked to ensure it is correct. If the address is not correct, then Resource reference MUST be supplied.

"location":  [
         {
            "identifier": {
              "system": "https://fhir.nhs.uk/Id/ods-organization-code",
              "value": "RCB55"
            }
            "display": "YORK HOSPITAL"
          }
  ]

For EPS, currently a Resource reference is required.

"location":  [
         {
            "reference": "urn:uuid:ecc2db8e-3757-4758-a4f1-7f4c7e06662f",
            "display": "YORK HOSPITAL"
          }
  ]

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
nhsd-3:PractitionerRole.location - An identifier or resource reference must be provided
(reference.exists() or identifier.exists())

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
w5:FiveWs.where[x]
rim:.performance.ActDefinitionOrEvent.ServiceDeliveryLocation[@classCode = 'SDLOC']
servd:(ServD maps Practitioners and Organizations via another entity, so this concept is not available)<br/> However these are accessed via the Site.ServiceSite.ServiceSiteProvider record. (The Site has the location)

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.location.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.location.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

healthcareService

S I

0..1

Element Id

PractitionerRole.healthcareService

Short description

The list of healthcare services that this worker provides for this role's Organization/Location(s)

Definition

healthcareService Resource reference

An identifier reference MUST be included. For secondary care organisations this will be the ODS/ANANA Cost Centre code given to a clinic.

"healthcareService":  
    [
         {
            "identifier": {
              "system": "https://fhir.nhs.uk/Id/ods-organization-code",
              "value": "A99968"
            }
            "display": "SOMERSET BOWEL CANCER SCREENING CENTRE"
          }
    ]

Optionally Resource reference can be provided. This is required in the current version of EPS but this will be changed to supporting the identifier reference only.

"healthcareService":  
    [
         {
            "reference": "urn:uuid:54b0506d-49af-4245-9d40-d7d64902055e",
            "identifier": {
              "system": "https://fhir.nhs.uk/Id/ods-organization-code",
              "value": "A99968"
            }
            "display": "SOMERSET BOWEL CANCER SCREENING CENTRE"
          }
    ]

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
nhsd-4:PractitionerRole.healthcareService - An identifier reference or resource reference must be provided
(reference.exists() or (identifier.exists()))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:EDU-2 / AFF-3
rim:.player.QualifiedEntity[@classCode = 'QUAL'].code

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.healthcareService.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

telecom

S Σ I

0..*

Element Id

PractitionerRole.telecom

Short description

Contact details that are specific to the role/location/service

Definition

This is not the personnel contact number of the Practitioner, it the contact number for the practitioner in this role and may be the phone number of the clinic, main or branch surgery.

"telecom": [
          {
            "system": "phone",
            "value": "01234567890",
            "use": "work"
          }
        ]

Requirements

Often practitioners have a dedicated line for each location (or service) that they work at, and need to be able to define separate contact details for each of these.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
cpt-2:A system is required if a value is provided.
value.empty() or system.exists()

Mappings

rim:n/a
v2:XTN
rim:TEL
servd:ContactPoint
rim:.telecom

system

Σ I

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.system

Short description

phone | fax | email | pager | url | sms | other

Definition

Telecommunications form for contact point - what communications system is required to make use of the contact.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

Telecommunications form for contact point.

ContactPointSystem (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:XTN.3
rim:./scheme
servd:./ContactPointType

value

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.value

Short description

The actual contact point details

Definition

The actual contact point details, in a form that is meaningful to the designated communication system (i.e. phone number or email address).

Requirements

Need to support legacy numbers that are not in a tightly controlled format.

Comments

Additional text data such as phone extension numbers, or notes about use of the contact are sometimes included in the value.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:XTN.1 (or XTN.12)
rim:./url
servd:./Value

use

Σ ?!

1..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.use

Short description

home | work | temp | old | mobile - purpose of this contact point

Definition

Identifies the purpose for the contact point.

Requirements

Need to track the way a person uses this contact, so a user can choose which is appropriate for their purpose.

Comments

Applications can assume that a contact is current unless it explicitly says that it is temporary or old.

Data Type

Binding

Use of contact point.

ContactPointUse (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:XTN.2 - but often indicated by field
rim:unique(./use)
servd:./ContactPointPurpose

rank

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.rank

Short description

Specify preferred order of use (1 = highest)

Definition

Specifies a preferred order in which to use a set of contacts. ContactPoints with lower rank values are more preferred than those with higher rank values.

Comments

Note that rank does not necessarily follow the order in which the contacts are represented in the instance.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:n/a

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.telecom.period

Short description

Time period when the contact point was/is in use

Definition

Time period when the contact point was/is in use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:N/A
rim:./usablePeriod[type="IVL<TS>"]
servd:./StartDate and ./EndDate

availableTime

0..*

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime

Short description

Times the Service Site is available

Definition

A collection of times the practitioner is available or performing this role at the location and/or healthcareservice.

Comments

More detailed availability information may be provided in associated Schedule/Slot resources.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

daysOfWeek

0..*

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime.daysOfWeek

Short description

mon | tue | wed | thu | fri | sat | sun

Definition

Indicates which days of the week are available between the start and end Times.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Binding

The days of the week.

DaysOfWeek (required)

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

allDay

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime.allDay

Short description

Always available? e.g. 24 hour service

Definition

Is this always available? (hence times are irrelevant) e.g. 24 hour service.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

availableStartTime

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime.availableStartTime

Short description

Opening time of day (ignored if allDay = true)

Definition

The opening time of day. Note: If the AllDay flag is set, then this time is ignored.

Comments

The timezone is expected to be for where this HealthcareService is provided at.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

availableEndTime

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.availableTime.availableEndTime

Short description

Closing time of day (ignored if allDay = true)

Definition

The closing time of day. Note: If the AllDay flag is set, then this time is ignored.

Comments

The timezone is expected to be for where this HealthcareService is provided at.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

notAvailable

0..*

There are no (further) constraints on this element

Element Id

PractitionerRole.notAvailable

Short description

Not available during this time due to provided reason

Definition

The practitioner is not available or performing this role during this period of time due to the provided reason.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

description

1..1

There are no (further) constraints on this element

Element Id

PractitionerRole.notAvailable.description

Short description

Reason presented to the user explaining why time not available

Definition

The reason that can be presented to the user as to why this time is not available.

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a

during

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.notAvailable.during

Short description

Service not available from this date

Definition

Service is not available (seasonally or for a public holiday) from this date.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
rim:.effectiveTime

availabilityExceptions

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.availabilityExceptions

Short description

Description of availability exceptions

Definition

Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:.effectiveTime

endpoint

0..*

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint

Short description

Technical endpoints providing access to services operated for the practitioner with this role

Definition

Technical endpoints providing access to services operated for the practitioner with this role.

Requirements

Organizations have multiple systems that provide various services and ,ay also be different for practitioners too.

So the endpoint satisfies the need to be able to define the technical connection details for how to connect to them, and for what purpose.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)

reference

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.reference

Short description

Literal reference, Relative, internal or absolute URL

Definition

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

type

0..1

uriBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.type

Short description

Type the reference refers to (e.g. "Patient")

Definition

The expected type of the target of the reference. If both Reference.type and Reference.reference are populated and Reference.reference is a FHIR URL, both SHALL be consistent.

Comments

Data Type

Binding

Aa resource (or, for logical models, the URI of the logical model).

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
rim:N/A

identifier

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier

Short description

Logical reference, when literal reference is not known

Definition

Comments

Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CX / EI (occasionally, more often EI maps to a resource id or a URL)
rim:II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
servd:Identifier
rim:.identifier

use

Σ ?!

0..1

codeBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.use

Short description

usual | official | temp | secondary | old (If known)

Definition

The purpose of this identifier.

Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Data Type

Binding

Identifies the purpose for this identifier, if known .

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:N/A
rim:Role.code or implied by context

type

0..1

CodeableConceptBinding

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.type

Short description

Description of identifier

Definition

A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

Data Type

Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Mappings

rim:n/a
v2:CE/CNE/CWE
rim:CD
orim:fhir:CodeableConcept rdfs:subClassOf dt:CD
v2:CX.5
rim:Role.code or implied by context

system

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.system

Short description

The namespace for the identifier value

Definition

Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

http://www.acme.com/identifiers/patient

Mappings

rim:n/a
v2:CX.4 / EI-2-4
rim:II.root or Role.id.root
servd:./IdentifierType

value

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.value

Short description

The value that is unique

Definition

The portion of the identifier typically relevant to the user and which is unique within the context of the system.

Comments

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())

Examples

General

Mappings

rim:n/a
v2:CX.1 / EI.1
rim:II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
servd:./Value

period

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.period

Short description

Time period when id is/was valid for use

Definition

Time period during which identifier is/was valid for use.

Comments

Period is not used for a duration (a measure of elapsed time). See Duration.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
per-1:If present, start SHALL have a lower value than end
start.hasValue().not() or end.hasValue().not() or (start <= end)

Mappings

rim:n/a
v2:DR
rim:IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"]
v2:CX.7 + CX.8
rim:Role.effectiveTime or implied by context
servd:./StartDate and ./EndDate

assigner

Σ I

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.identifier.assigner

Short description

Organization that issued id (may be just text)

Definition

Organization that issued/manages the identifier.

Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Data Type

Constraints

ele-1:All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
ref-1:SHALL have a contained resource if a local reference is provided
reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Mappings

rim:n/a
rim:The target of a resource reference is a RIM entry point (Act, Role, or Entity)
v2:CX.4 / (CX.4,CX.9,CX.10)
rim:II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
servd:./IdentifierIssuingAuthority

display

0..1

There are no (further) constraints on this element

Element Id

PractitionerRole.endpoint.display

Short description

Text alternative for the resource

Definition

Plain text narrative that identifies the resource in addition to the resource reference.

Comments

This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.

Data Type