HealthReferencePractitionerRole
Reference data entity for professional roles and position types of healthcare practitioners. Defines the job function a practitioner performs regardless of their medical specialty.
Overview
HealthReferencePractitionerRole categorizes healthcare workers by their professional function. While HealthReferencePractitionerSpecialty defines clinical expertise areas, this entity defines the type of position (physician, nurse, pharmacist, technician). A cardiologist has specialty "Cardiology" but role "Physician". This distinction enables proper credentialing, scope of practice, and workforce management.
Key Concepts
Role vs Specialty
Understanding the distinction:
| Concept | Entity | Examples |
|---|---|---|
| Role | PractitionerRole | Physician, Nurse, Pharmacist |
| Specialty | PractitionerSpecialty | Cardiology, Pediatrics, Oncology |
A practitioner has one primary role but may have multiple specialties.
Role Categories
Roles are grouped by professional domain:
| Category | Description | Example Roles |
|---|---|---|
medical | Licensed physicians | Physician, Surgeon, Radiologist |
nursing | Nursing professionals | Nurse, Nurse Practitioner, Midwife |
allied-health | Other clinical professionals | Pharmacist, Physiotherapist, Psychologist |
technical | Technical support staff | Lab Technician, Radiology Tech |
administrative | Non-clinical staff | Medical Coder, Administrator |
Standard Roles
Medical Roles
PHYSICIAN- Licensed medical doctor (MD/DO)SURGEON- Physician specializing in surgeryRADIOLOGIST- Physician specializing in imaging
Nursing Roles
NURSE- Registered Nurse (RN)NURSE_PRACTITIONER- Advanced practice nurse (APRN)MIDWIFE- Certified nurse-midwife
Allied Health Roles
PHARMACIST- Licensed pharmacistPHYSIOTHERAPIST- Physical therapistPSYCHOLOGIST- Licensed psychologist
Technical Roles
LAB_TECHNICIAN- Medical laboratory technologist
Role Identification
Each role record contains:
code- Unique role code (e.g., "PHYSICIAN", "NURSE")label- Human-readable namecategory- Professional domaindescription- Role details and scope
Use Cases
Credentialing
When verifying practitioner credentials:
- Identify practitioner's role type
- Verify appropriate licensure for role
- Check role-specific certifications
- Validate scope of practice
- Document credential verification
Order Authorization
When validating clinical orders:
- Check ordering provider's role
- Verify role can place this order type
- Apply role-based ordering rules
- Require co-signature if needed
- Route for appropriate approval
Scheduling
For appointment scheduling:
- Match patient need to appropriate role
- Filter available providers by role
- Consider role-specific visit durations
- Apply role-based scheduling rules
Workforce Planning
For staffing decisions:
- Track staff counts by role category
- Identify role coverage gaps
- Plan recruitment by role needs
- Monitor role ratios (nurse-to-patient)
Access Control
For system permissions:
- Assign base permissions by role
- Apply role-specific feature access
- Restrict sensitive data by role
- Audit access by role category
Related Entities
| Entity | Relationship | Description |
|---|---|---|
| Practitioner | Referenced by | Practitioners assigned this role |
| HealthReferencePractitionerSpecialty | Complements | Medical specialties (separate from role) |
Enums
category
| Value | Description |
|---|---|
medical | Licensed physicians and surgeons (MD, DO, MBBS) |
nursing | Nursing professionals at all levels (RN, LPN, NP, CNM) |
allied-health | Non-physician clinical professionals (pharmacists, therapists, psychologists) |
technical | Clinical technical and laboratory staff |
administrative | Non-clinical administrative and support roles |
other | Roles not fitting other categories |
Properties
| Property | Type | Mode | Description | Required |
|---|---|---|---|---|
| code | string | stored | Unique code identifying the role Example: | Required |
| label | string | stored | Human-readable name of the role Example: | Required |
| category | string | stored | Category of practitioner role Values: Example: | Required |
| description | string | stored | Additional details about the role | Optional |
Examples
Example 1
{
"@type": "HealthReferencePractitionerRole",
"code": "PHYSICIAN",
"label": "Physician",
"category": "medical",
"description": "Licensed medical doctor"
}Example 2
{
"@type": "HealthReferencePractitionerRole",
"code": "SURGEON",
"label": "Surgeon",
"category": "medical",
"description": "Physician specialized in surgical procedures"
}Example 3
{
"@type": "HealthReferencePractitionerRole",
"code": "NURSE",
"label": "Nurse",
"category": "nursing",
"description": "Registered nursing professional"
}Example 4
{
"@type": "HealthReferencePractitionerRole",
"code": "NURSE_PRACTITIONER",
"label": "Nurse Practitioner",
"category": "nursing",
"description": "Advanced practice registered nurse"
}Example 5
{
"@type": "HealthReferencePractitionerRole",
"code": "PHARMACIST",
"label": "Pharmacist",
"category": "allied-health",
"description": "Licensed pharmacy professional"
}Example 6
{
"@type": "HealthReferencePractitionerRole",
"code": "PHYSIOTHERAPIST",
"label": "Physiotherapist",
"category": "allied-health",
"description": "Physical therapy professional"
}Example 7
{
"@type": "HealthReferencePractitionerRole",
"code": "PSYCHOLOGIST",
"label": "Psychologist",
"category": "allied-health",
"description": "Mental health professional"
}Example 8
{
"@type": "HealthReferencePractitionerRole",
"code": "RADIOLOGIST",
"label": "Radiologist",
"category": "medical",
"description": "Medical imaging specialist"
}Example 9
{
"@type": "HealthReferencePractitionerRole",
"code": "LAB_TECHNICIAN",
"label": "Laboratory Technician",
"category": "technical",
"description": "Medical laboratory professional"
}Example 10
{
"@type": "HealthReferencePractitionerRole",
"code": "MIDWIFE",
"label": "Midwife",
"category": "nursing",
"description": "Childbirth and maternal care specialist"
}