fhir 0.1.0

Fast Healthcare Interoperability Resources (FHIR) API is a standardized, RESTful interface for exchanging electronic health records.
Documentation
//! PractitionerRole
//!
//! URL: http://hl7.org/fhir/StructureDefinition/PractitionerRole
//!
//! Version: 5.0.0
//!
//! PractitionerRole Resource: A specific set of Roles/Locations/specialties/services that a practitioner may perform, or has performed at an organization during a period of time.
//!
//! FHIR: <https://build.fhir.org/>
//!
//! UML: <https://build.fhir.org/uml.html>

// Allow unused crate::r5::types as types;
#![allow(unused_imports)]

use crate::r5::types;
use ::serde::{Deserialize, Serialize};
use fhir_derive_macros::Validate;

/// A specific set of roles, locations, specialties, and services that a
/// practitioner may perform, or has performed, at an organization during a
/// period of time. In FHIR R5 this resource is administrative rather than
/// clinical: it does not describe a person, but instead the relationship that
/// binds a practitioner to an organization and the context in which that
/// practitioner acts. A single practitioner can have many PractitionerRole
/// records, one for each distinct combination of organization, role, specialty,
/// location, or engagement period. The resource is central to provider
/// directories, scheduling and referral workflows, and access-control decisions,
/// because it answers who can perform what, on whose behalf, where, and when.
/// It also carries contact details, spoken languages, availability, and endpoints
/// used to reach the practitioner while acting in this particular role.
///
/// # See also
///
/// A PractitionerRole references a `Practitioner` (the person) and an
/// [`Organization`](crate::r5::resources::organization::Organization), and may
/// point to `Location` and `HealthcareService` resources. Roles and specialties
/// are expressed with [`CodeableConcept`](crate::r5::types::CodeableConcept),
/// and links to other systems use [`Reference`](crate::r5::types::Reference).
///
/// # Examples
///
/// ```
/// use fhir::r5::resources::practitioner_role::PractitionerRole;
///
/// let value = PractitionerRole::default();
/// let json = ::serde_json::to_value(&value).unwrap();
/// let back: PractitionerRole = ::serde_json::from_value(json).unwrap();
/// assert_eq!(value, back);
/// ```
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct PractitionerRole {
    /// Logical id of this artifact
    pub id: Option<types::String>,

    /// Metadata about the resource
    pub meta: Option<types::Meta>,

    /// A set of rules under which this content was created
    pub implicit_rules: Option<types::Uri>,

    /// Language of the resource content
    pub language: Option<types::Code>,

    /// Text summary of the resource, for human interpretation
    pub text: Option<types::Narrative>,

    /// Contained, inline Resources
    pub contained: Option<Vec<::serde_json::Value>>,

    /// Additional content defined by implementations
    pub extension: Option<Vec<types::Extension>>,

    /// Extensions that cannot be ignored
    pub modifier_extension: Option<Vec<types::Extension>>,

    /// Identifiers for a role/location
    pub identifier: Option<Vec<types::Identifier>>,

    /// Whether this practitioner role record is in active use
    pub active: Option<types::Boolean>,

    /// The period during which the practitioner is authorized to perform in these role(s)
    pub period: Option<types::Period>,

    /// Reference to the Practitioner (the person) who acts in this role
    pub practitioner: Option<types::Reference>,

    /// Reference to the Organization on whose behalf the practitioner performs this role
    pub organization: Option<types::Reference>,

    /// Coded roles this practitioner may perform, such as doctor, nurse, or pharmacist
    pub code: Option<Vec<types::CodeableConcept>>,

    /// Coded clinical specialties exercised by the practitioner in this role
    pub specialty: Option<Vec<types::CodeableConcept>>,

    /// Location(s) where the practitioner provides care
    pub location: Option<Vec<types::Reference>>,

    /// Healthcare services provided for this role's Organization/Location(s)
    pub healthcare_service: Option<Vec<types::Reference>>,

    /// Official contact details relating to this PractitionerRole
    pub contact: Option<Vec<types::ExtendedContactDetail>>,

    /// Collection of characteristics (attributes)
    pub characteristic: Option<Vec<types::CodeableConcept>>,

    /// A language the practitioner (in this role) can use in patient communication
    pub communication: Option<Vec<types::CodeableConcept>>,

    /// Times the Practitioner is available at this location and/or healthcare service (including exceptions)
    pub availability: Option<Vec<types::Availability>>,

    /// Endpoints for interacting with the practitioner in this role
    pub endpoint: Option<Vec<types::Reference>>,
}

#[cfg(test)]
mod tests {
    use super::*;
    type T = PractitionerRole;

    #[test]
    fn test_default() {
        let _ = T::default();
    }

    #[test]
    fn test_serde_round_trip() {
        let value = T::default();
        let json = ::serde_json::to_value(&value).expect("to_value");
        let back: T = ::serde_json::from_value(json).expect("from_value");
        assert_eq!(value, back);
    }
}