This page is part of the Argonaut Provider Directory Guide (v0.1.0: Release 1 Draft) based on FHIR v1.9.0. The current version which supercedes this version is 1.0.0. For a full list of available versions, see the Directory of published versions
This profile sets minimum expectations for the PractitionerRole resource to record, search and fetch allergies/adverse events associated with a patient. It identifies the mandatory core elements, extensions, vocabularies and value sets which SHALL be present in the AllergyIntolerance resource when using this profile. The requirements for the Argonaut Provider Directory data model were drawn from IHE Healthcare Provider Directory and the ONC Provider Directory Workshop.
The following data-elements are mandatory (i.e data MUST be present). These are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The Formal Profile Definition below provides the formal summary, definitions, and terminology requirements.
Each PractitionerRole must have:
Profile specific implementation guidance:
The official URL for this profile is:
http://fhir.org/guides/argonaut-pd/StructureDefinition/argo-practitionerrole
This profile builds on PractitionerRole.
This profile was published on Wed Nov 09 00:00:00 AEDT 2016 as a draft by Argonaut Project.
Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
PractitionerRole.practitioner
PractitionerRole.organization
PractitionerRole.location
PractitionerRole.endpoint
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
PractitionerRole | I | 0..* | Argonaut Provider Directory PractitionerRole pd-1: SHALL have contact information or a reference to an Endpoint | |
practitioner | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-practitioner) | |
organization | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-organization) | |
code | S | 1..1 | CodeableConcept | Binding: Argonaut Provider Directory Provider Role (NUCC) (required) |
specialty | S | 1..1 | CodeableConcept | Binding: Argonaut Provider Directory Provider Speciality (NUCC) (required) |
location | S | 0..* | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-location) | |
telecom | SI | 0..* | ContactPoint | |
system | S | 1..1 | code | |
value | S | 1..1 | string | |
endpoint | SI | 0..* | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-endpoint) | |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
PractitionerRole | I | 0..* | Argonaut Provider Directory PractitionerRole pd-1: SHALL have contact information or a reference to an Endpoint | |
id | ∑ | 0..1 | id | Logical id of this artifact |
meta | ∑ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!∑ | 0..1 | uri | A set of rules under which this content was created |
language | 0..1 | code | Language of the resource content Binding: Common Languages (extensible) | |
text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
identifier | ∑ | 0..* | Identifier | Business Identifiers that are specific to a role/location |
active | ∑ | 0..1 | boolean | Whether this practitioner's record is in active use |
practitioner | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-practitioner) | Practitioner that is able to provide the defined services for the organation |
organization | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-organization) | Organization where the roles are available |
code | S | 1..1 | CodeableConcept | Roles which this practitioner may perform Binding: Argonaut Provider Directory Provider Role (NUCC) (required) |
specialty | S | 1..1 | CodeableConcept | Specific specialty of the practitioner Binding: Argonaut Provider Directory Provider Speciality (NUCC) (required) |
location | S | 0..* | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-location) | The location(s) at which this practitioner provides care |
healthcareService | 0..* | Reference(HealthcareService) | The list of healthcare services that this worker provides for this role's Organization/Location(s) | |
telecom | S | 0..* | ContactPoint | Contact details that are specific to the role/location/service |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
system | SI | 1..1 | code | phone | fax | email | pager | url | other Binding: ContactPointSystem (required) |
value | S | 1..1 | string | The actual contact point details |
use | ?!∑ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required) |
rank | ∑ | 0..1 | positiveInt | Specify preferred order of use (1 = highest) |
period | ∑ | 0..1 | Period | Time period when the contact point was/is in use |
period | ∑ | 0..1 | Period | The period during which the practitioner is authorized to perform in these role(s) |
availableTime | I | 0..* | BackboneElement | Times the Service Site is available |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?!∑ | 0..* | Extension | Extensions that cannot be ignored |
daysOfWeek | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required) | |
allDay | 0..1 | boolean | Always available? e.g. 24 hour service | |
availableStartTime | 0..1 | time | Opening time of day (ignored if allDay = true) | |
availableEndTime | 0..1 | time | Closing time of day (ignored if allDay = true) | |
notAvailable | I | 0..* | BackboneElement | Not available during this time due to provided reason |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?!∑ | 0..* | Extension | Extensions that cannot be ignored |
description | 1..1 | string | Reason presented to the user explaining why time not available | |
during | 0..1 | Period | Service not availablefrom this date | |
availabilityExceptions | 0..1 | string | Description of availability exceptions | |
endpoint | S | 0..* | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-endpoint) | Technical endpoints providing access to services operated for the practitioner with this role |
Documentation for this format |
PractitionerRole.practitioner
PractitionerRole.organization
PractitionerRole.location
PractitionerRole.endpoint
Differential View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
PractitionerRole | I | 0..* | Argonaut Provider Directory PractitionerRole pd-1: SHALL have contact information or a reference to an Endpoint | |
practitioner | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-practitioner) | |
organization | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-organization) | |
code | S | 1..1 | CodeableConcept | Binding: Argonaut Provider Directory Provider Role (NUCC) (required) |
specialty | S | 1..1 | CodeableConcept | Binding: Argonaut Provider Directory Provider Speciality (NUCC) (required) |
location | S | 0..* | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-location) | |
telecom | SI | 0..* | ContactPoint | |
system | S | 1..1 | code | |
value | S | 1..1 | string | |
endpoint | SI | 0..* | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-endpoint) | |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
PractitionerRole | I | 0..* | Argonaut Provider Directory PractitionerRole pd-1: SHALL have contact information or a reference to an Endpoint | |
id | ∑ | 0..1 | id | Logical id of this artifact |
meta | ∑ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!∑ | 0..1 | uri | A set of rules under which this content was created |
language | 0..1 | code | Language of the resource content Binding: Common Languages (extensible) | |
text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
identifier | ∑ | 0..* | Identifier | Business Identifiers that are specific to a role/location |
active | ∑ | 0..1 | boolean | Whether this practitioner's record is in active use |
practitioner | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-practitioner) | Practitioner that is able to provide the defined services for the organation |
organization | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-organization) | Organization where the roles are available |
code | S | 1..1 | CodeableConcept | Roles which this practitioner may perform Binding: Argonaut Provider Directory Provider Role (NUCC) (required) |
specialty | S | 1..1 | CodeableConcept | Specific specialty of the practitioner Binding: Argonaut Provider Directory Provider Speciality (NUCC) (required) |
location | S | 0..* | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-location) | The location(s) at which this practitioner provides care |
healthcareService | 0..* | Reference(HealthcareService) | The list of healthcare services that this worker provides for this role's Organization/Location(s) | |
telecom | S | 0..* | ContactPoint | Contact details that are specific to the role/location/service |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
system | SI | 1..1 | code | phone | fax | email | pager | url | other Binding: ContactPointSystem (required) |
value | S | 1..1 | string | The actual contact point details |
use | ?!∑ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required) |
rank | ∑ | 0..1 | positiveInt | Specify preferred order of use (1 = highest) |
period | ∑ | 0..1 | Period | Time period when the contact point was/is in use |
period | ∑ | 0..1 | Period | The period during which the practitioner is authorized to perform in these role(s) |
availableTime | I | 0..* | BackboneElement | Times the Service Site is available |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?!∑ | 0..* | Extension | Extensions that cannot be ignored |
daysOfWeek | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required) | |
allDay | 0..1 | boolean | Always available? e.g. 24 hour service | |
availableStartTime | 0..1 | time | Opening time of day (ignored if allDay = true) | |
availableEndTime | 0..1 | time | Closing time of day (ignored if allDay = true) | |
notAvailable | I | 0..* | BackboneElement | Not available during this time due to provided reason |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?!∑ | 0..* | Extension | Extensions that cannot be ignored |
description | 1..1 | string | Reason presented to the user explaining why time not available | |
during | 0..1 | Period | Service not availablefrom this date | |
availabilityExceptions | 0..1 | string | Description of availability exceptions | |
endpoint | S | 0..* | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-endpoint) | Technical endpoints providing access to services operated for the practitioner with this role |
Documentation for this format |
Downloads: StructureDefinition: (XML, JSON, CSV), Schema: XML Schematron
Below is an overview of the required search and read operations.
Summary of Argonaut Search Criteria for StructureDefinition-argo-practitionerrole
Clients
GET [base]/PractionerRole?identifier=[system]|[code]
GET [base]/PractionerRole?family=[string]&given=[string]
A client has connected to a server and fetched a PractitionerRole by specialty using ‘GET [base]/PractitionerRole?specialty=[system] | [code]’ |
Servers
GET [base]/PractionerRole?identifier=[system]|[code]
GET [base]/PractionerRole?family=[string]&given=[string]
A server is capable of returning a PractitionerRole by specialty using GET [base]/PractitionerRole?specialty=[system] | [code] |
**GET [base]/PractionerRole?identifier=[system] | [code]** |
Support: Mandatory
Implementation Notes: Search based on PractionerRole identifier (how to search by token).
Response Class:
Example:
**GET [base]/PractitionerRole?practitioner.identifier=[system] | [code]** |
Support: Mandatory
Implementation Notes: Search based on Practitioner identifier (NPI) (how to search by token).
Response Class:
Example:
GET [base]/PractitionerRole?practitioner.family=[string]&given=[string]
Support: Mandatory
Implementation Notes: Search based on text name (how to search by string).
Response Class:
Example:
GET http://fhir3.healthintersections.com.au/open/PractitionerRole?practitioner.family=verify&given=v
**GET [base]/PractitionerRole?specialty=[system] | [code]]** |
Support: Mandatory
Implementation Notes: Search based on specialty (how to search by token).
Response Class:
Example:
Searches under development
GET [base]/Practitioner?location.address-city=[city] GET [base]/Practitioner?location.address-city=[city]&specialty=[string] GET [base]/Practitioner?location.near=-72.519854,42.373222&near-distance=2m
Support: Mandatory
Implementation Notes: Search based on location (how to search by reference).
Response Class:
Example:
TBD