fhir-types 0.1.109

// @generated by fhir-codegen from hl7.fhir.r3.core 3.0.2. DO NOT EDIT.
// Change the emitter (tools/fhir-codegen) and regenerate.
// SPDX-FileCopyrightText: Cadasto B.V.
// SPDX-License-Identifier: Apache-2.0
//! Who, What, When for a set of resources

/// Who, What, When for a set of resources
///
/// Provenance of a resource is a record that describes entities and processes
/// involved in producing and delivering or otherwise influencing that resource.
/// Provenance provides a critical foundation for assessing authenticity,
/// enabling trust, and allowing reproducibility. Provenance assertions are a
/// form of contextual metadata and can themselves become important records with
/// their own provenance. Provenance statement indicates clinical significance
/// in terms of confidence in authenticity, reliability, and trustworthiness,
/// integrity, and stage in lifecycle (e.g. Document Completion - has the
/// artifact been legally authenticated), all of which may impact security,
/// privacy, and trust policies.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct Provenance {
    /// Logical id of this artifact
    ///
    /// The logical id of the resource, as used in the URL for the resource. Once
    /// assigned, this value never changes.
    pub id: Option<super::primitives::Id>,
    /// Metadata about the resource
    ///
    /// The metadata about the resource. This is content that is maintained by the
    /// infrastructure. Changes to the content may not always be associated with
    /// version changes to the resource.
    pub meta: Option<super::meta::Meta>,
    /// A set of rules under which this content was created
    ///
    /// A reference to a set of rules that were followed when the resource was
    /// constructed, and which must be understood when processing the content.
    pub implicit_rules: Option<super::primitives::Uri>,
    /// Language of the resource content
    ///
    /// The base language in which the resource is written.
    pub language: Option<super::primitives::Code>,
    /// Text summary of the resource, for human interpretation
    ///
    /// A human-readable narrative that contains a summary of the resource, and may
    /// be used to represent the content of the resource to a human. The narrative
    /// need not encode all the structured data, but is required to contain
    /// sufficient detail to make it "clinically safe" for a human to just read the
    /// narrative. Resource definitions may define what content should be
    /// represented in the narrative to ensure clinical safety.
    pub text: Option<super::narrative::Narrative>,
    /// Contained, inline Resources
    ///
    /// These resources do not have an independent existence apart from the resource
    /// that contains them - they cannot be identified independently, and nor can
    /// they have their own independent transaction scope.
    pub contained: Vec<super::resource::Resource>,
    /// Additional Content defined by implementations
    ///
    /// May be used to represent additional information that is not part of the
    /// basic definition of the resource. In order 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 is allowed to
    /// define an extension, there is a set of requirements that SHALL be met as
    /// part of the definition of the extension.
    pub extension: Vec<super::extension::Extension>,
    /// Extensions that cannot be ignored
    ///
    /// May be used to represent additional information that is not part of the
    /// basic definition of the resource, and that modifies the understanding of the
    /// element that contains it. Usually modifier elements provide negation or
    /// qualification. In order 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 is allowed to define an extension, there
    /// is a set of requirements that SHALL be met as part of the definition of the
    /// extension. Applications processing a resource are required to check for
    /// modifier extensions.
    pub modifier_extension: Vec<super::extension::Extension>,
    /// Target Reference(s) (usually version specific)
    ///
    /// The Reference(s) that were generated or updated by the activity described in
    /// this resource. A provenance can point to more than one target if multiple
    /// resources were created/updated by the same activity.
    pub target: Vec<super::reference::Reference>,
    /// When the activity occurred
    ///
    /// The period during which the activity occurred.
    pub period: Option<super::period::Period>,
    /// When the activity was recorded / updated
    ///
    /// The instant of time at which the activity was recorded.
    pub recorded: super::primitives::Instant,
    /// Policy or plan the activity was defined by
    ///
    /// Policy or plan the activity was defined by. Typically, a single activity may
    /// have multiple applicable policy documents, such as patient consent,
    /// guarantor funding, etc.
    pub policy: Vec<super::primitives::Uri>,
    /// Where the activity occurred, if relevant.
    pub location: Option<super::reference::Reference>,
    /// Reason the activity is occurring
    ///
    /// The reason that the activity was taking place.
    pub reason: Vec<super::coding::Coding>,
    /// Activity that occurred
    ///
    /// An activity is something that occurs over a period of time and acts upon or
    /// with entities; it may include consuming, processing, transforming,
    /// modifying, relocating, using, or generating entities.
    pub activity: Option<super::coding::Coding>,
    /// Actor involved
    ///
    /// An actor taking a role in an activity for which it can be assigned some
    /// degree of responsibility for the activity taking place.
    pub agent: Vec<ProvenanceAgent>,
    /// An entity used in this activity.
    pub entity: Vec<ProvenanceEntity>,
    /// Signature on target
    ///
    /// A digital signature on the target Reference(s). The signer should match a
    /// Provenance.agent. The purpose of the signature is indicated.
    pub signature: Vec<super::signature::Signature>,
}

impl super::super::codec::Json for Provenance {
    fn to_json(&self) -> Result<super::super::codec::Object, super::super::codec::EncodeError> {
        let mut object = super::super::codec::Object::new();
        object.insert(
            std::string::String::from("resourceType"),
            super::super::codec::Value::String(std::string::String::from("Provenance")),
        );
        if let Some(item) = &self.id {
            if let Some(v) = super::super::codec::Primitive::value_json(item)? {
                object.insert(std::string::String::from("id"), v);
            }
            if let Some(e) = super::super::codec::Primitive::element_json(item)? {
                object.insert(std::string::String::from("_id"), e);
            }
        }
        if let Some(item) = &self.meta {
            object.insert(
                std::string::String::from("meta"),
                super::super::codec::Value::Object(super::super::codec::Json::to_json(item)?),
            );
        }
        if let Some(item) = &self.implicit_rules {
            if let Some(v) = super::super::codec::Primitive::value_json(item)? {
                object.insert(std::string::String::from("implicitRules"), v);
            }
            if let Some(e) = super::super::codec::Primitive::element_json(item)? {
                object.insert(std::string::String::from("_implicitRules"), e);
            }
        }
        if let Some(item) = &self.language {
            if let Some(v) = super::super::codec::Primitive::value_json(item)? {
                object.insert(std::string::String::from("language"), v);
            }
            if let Some(e) = super::super::codec::Primitive::element_json(item)? {
                object.insert(std::string::String::from("_language"), e);
            }
        }
        if let Some(item) = &self.text {
            object.insert(
                std::string::String::from("text"),
                super::super::codec::Value::Object(super::super::codec::Json::to_json(item)?),
            );
        }
        if !self.contained.is_empty() {
            let mut items = Vec::with_capacity(self.contained.len());
            for item in &self.contained {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("contained"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.extension.is_empty() {
            let mut items = Vec::with_capacity(self.extension.len());
            for item in &self.extension {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("extension"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.modifier_extension.is_empty() {
            let mut items = Vec::with_capacity(self.modifier_extension.len());
            for item in &self.modifier_extension {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("modifierExtension"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.target.is_empty() {
            let mut items = Vec::with_capacity(self.target.len());
            for item in &self.target {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("target"),
                super::super::codec::Value::Array(items),
            );
        }
        if let Some(item) = &self.period {
            object.insert(
                std::string::String::from("period"),
                super::super::codec::Value::Object(super::super::codec::Json::to_json(item)?),
            );
        }
        if let Some(v) = super::super::codec::Primitive::value_json(&self.recorded)? {
            object.insert(std::string::String::from("recorded"), v);
        }
        if let Some(e) = super::super::codec::Primitive::element_json(&self.recorded)? {
            object.insert(std::string::String::from("_recorded"), e);
        }
        if !self.policy.is_empty() {
            let (values, elements) = super::super::codec::primitive_arrays(&self.policy)?;
            object.insert(std::string::String::from("policy"), values);
            if let Some(elements) = elements {
                object.insert(std::string::String::from("_policy"), elements);
            }
        }
        if let Some(item) = &self.location {
            object.insert(
                std::string::String::from("location"),
                super::super::codec::Value::Object(super::super::codec::Json::to_json(item)?),
            );
        }
        if !self.reason.is_empty() {
            let mut items = Vec::with_capacity(self.reason.len());
            for item in &self.reason {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("reason"),
                super::super::codec::Value::Array(items),
            );
        }
        if let Some(item) = &self.activity {
            object.insert(
                std::string::String::from("activity"),
                super::super::codec::Value::Object(super::super::codec::Json::to_json(item)?),
            );
        }
        if !self.agent.is_empty() {
            let mut items = Vec::with_capacity(self.agent.len());
            for item in &self.agent {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("agent"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.entity.is_empty() {
            let mut items = Vec::with_capacity(self.entity.len());
            for item in &self.entity {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("entity"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.signature.is_empty() {
            let mut items = Vec::with_capacity(self.signature.len());
            for item in &self.signature {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("signature"),
                super::super::codec::Value::Array(items),
            );
        }
        Ok(object)
    }

    fn from_json(
        object: &super::super::codec::Object,
        path: &mut super::super::codec::Path,
    ) -> Result<Self, super::super::codec::DecodeError> {
        let mut raw_id: Option<&super::super::codec::Value> = None;
        let mut raw_id_element: Option<&super::super::codec::Value> = None;
        let mut raw_meta: Option<&super::super::codec::Value> = None;
        let mut raw_implicit_rules: Option<&super::super::codec::Value> = None;
        let mut raw_implicit_rules_element: Option<&super::super::codec::Value> = None;
        let mut raw_language: Option<&super::super::codec::Value> = None;
        let mut raw_language_element: Option<&super::super::codec::Value> = None;
        let mut raw_text: Option<&super::super::codec::Value> = None;
        let mut raw_contained: Option<&super::super::codec::Value> = None;
        let mut raw_extension: Option<&super::super::codec::Value> = None;
        let mut raw_modifier_extension: Option<&super::super::codec::Value> = None;
        let mut raw_target: Option<&super::super::codec::Value> = None;
        let mut raw_period: Option<&super::super::codec::Value> = None;
        let mut raw_recorded: Option<&super::super::codec::Value> = None;
        let mut raw_recorded_element: Option<&super::super::codec::Value> = None;
        let mut raw_policy: Option<&super::super::codec::Value> = None;
        let mut raw_policy_element: Option<&super::super::codec::Value> = None;
        let mut raw_location: Option<&super::super::codec::Value> = None;
        let mut raw_reason: Option<&super::super::codec::Value> = None;
        let mut raw_activity: Option<&super::super::codec::Value> = None;
        let mut raw_agent: Option<&super::super::codec::Value> = None;
        let mut raw_entity: Option<&super::super::codec::Value> = None;
        let mut raw_signature: Option<&super::super::codec::Value> = None;
        for (key, value) in object {
            match key.as_str() {
                "resourceType" => {
                    if value.as_str() != Some("Provenance") {
                        return Err(path.error(super::super::codec::DecodeErrorKind::ResourceType));
                    }
                }
                "id" => {
                    raw_id = Some(value);
                }
                "_id" => {
                    raw_id_element = Some(value);
                }
                "meta" => {
                    raw_meta = Some(value);
                }
                "implicitRules" => {
                    raw_implicit_rules = Some(value);
                }
                "_implicitRules" => {
                    raw_implicit_rules_element = Some(value);
                }
                "language" => {
                    raw_language = Some(value);
                }
                "_language" => {
                    raw_language_element = Some(value);
                }
                "text" => {
                    raw_text = Some(value);
                }
                "contained" => {
                    raw_contained = Some(value);
                }
                "extension" => {
                    raw_extension = Some(value);
                }
                "modifierExtension" => {
                    raw_modifier_extension = Some(value);
                }
                "target" => {
                    raw_target = Some(value);
                }
                "period" => {
                    raw_period = Some(value);
                }
                "recorded" => {
                    raw_recorded = Some(value);
                }
                "_recorded" => {
                    raw_recorded_element = Some(value);
                }
                "policy" => {
                    raw_policy = Some(value);
                }
                "_policy" => {
                    raw_policy_element = Some(value);
                }
                "location" => {
                    raw_location = Some(value);
                }
                "reason" => {
                    raw_reason = Some(value);
                }
                "activity" => {
                    raw_activity = Some(value);
                }
                "agent" => {
                    raw_agent = Some(value);
                }
                "entity" => {
                    raw_entity = Some(value);
                }
                "signature" => {
                    raw_signature = Some(value);
                }
                other => {
                    return path.with(other, |path| {
                        Err(path.error(super::super::codec::DecodeErrorKind::UnknownProperty))
                    });
                }
            }
        }
        let field_id = match (raw_id, raw_id_element) {
            (None, None) => None,
            (value, element) => Some(path.with("id", |path| {
                super::super::codec::Primitive::from_json_parts(value, element, path)
            })?),
        };
        let field_meta = raw_meta
            .map(|value| {
                path.with("meta", |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(
                            super::super::codec::expect_single(value, path)?,
                            path,
                        )?,
                        path,
                    )
                })
            })
            .transpose()?;
        let field_implicit_rules = match (raw_implicit_rules, raw_implicit_rules_element) {
            (None, None) => None,
            (value, element) => Some(path.with("implicitRules", |path| {
                super::super::codec::Primitive::from_json_parts(value, element, path)
            })?),
        };
        let field_language = match (raw_language, raw_language_element) {
            (None, None) => None,
            (value, element) => Some(path.with("language", |path| {
                super::super::codec::Primitive::from_json_parts(value, element, path)
            })?),
        };
        let field_text = raw_text
            .map(|value| {
                path.with("text", |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(
                            super::super::codec::expect_single(value, path)?,
                            path,
                        )?,
                        path,
                    )
                })
            })
            .transpose()?;
        let mut field_contained = Vec::new();
        if let Some(raw) = raw_contained {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_contained.push(path.with_index("contained", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let mut field_extension = Vec::new();
        if let Some(raw) = raw_extension {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_extension.push(path.with_index("extension", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let mut field_modifier_extension = Vec::new();
        if let Some(raw) = raw_modifier_extension {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_modifier_extension.push(path.with_index(
                    "modifierExtension",
                    index,
                    |path| {
                        super::super::codec::Json::from_json(
                            super::super::codec::expect_object(value, path)?,
                            path,
                        )
                    },
                )?);
            }
        }
        let mut field_target = Vec::new();
        if let Some(raw) = raw_target {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_target.push(path.with_index("target", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let field_period = raw_period
            .map(|value| {
                path.with("period", |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(
                            super::super::codec::expect_single(value, path)?,
                            path,
                        )?,
                        path,
                    )
                })
            })
            .transpose()?;
        let field_recorded = path.with("recorded", |path| {
            super::super::codec::Primitive::from_json_parts(
                raw_recorded,
                raw_recorded_element,
                path,
            )
        })?;
        let mut field_policy = Vec::new();
        for (index, (value, element)) in
            super::super::codec::pair_arrays(raw_policy, raw_policy_element, path)?
                .into_iter()
                .enumerate()
        {
            field_policy.push(path.with_index("policy", index, |path| {
                super::super::codec::Primitive::from_json_parts(value, element, path)
            })?);
        }
        let field_location = raw_location
            .map(|value| {
                path.with("location", |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(
                            super::super::codec::expect_single(value, path)?,
                            path,
                        )?,
                        path,
                    )
                })
            })
            .transpose()?;
        let mut field_reason = Vec::new();
        if let Some(raw) = raw_reason {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_reason.push(path.with_index("reason", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let field_activity = raw_activity
            .map(|value| {
                path.with("activity", |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(
                            super::super::codec::expect_single(value, path)?,
                            path,
                        )?,
                        path,
                    )
                })
            })
            .transpose()?;
        let mut field_agent = Vec::new();
        if let Some(raw) = raw_agent {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_agent.push(path.with_index("agent", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let mut field_entity = Vec::new();
        if let Some(raw) = raw_entity {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_entity.push(path.with_index("entity", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let mut field_signature = Vec::new();
        if let Some(raw) = raw_signature {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_signature.push(path.with_index("signature", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        Ok(Self {
            id: field_id,
            meta: field_meta,
            implicit_rules: field_implicit_rules,
            language: field_language,
            text: field_text,
            contained: field_contained,
            extension: field_extension,
            modifier_extension: field_modifier_extension,
            target: field_target,
            period: field_period,
            recorded: field_recorded,
            policy: field_policy,
            location: field_location,
            reason: field_reason,
            activity: field_activity,
            agent: field_agent,
            entity: field_entity,
            signature: field_signature,
        })
    }
}

impl serde::Serialize for Provenance {
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        let mut map = serde::Serializer::serialize_map(serializer, None)?;
        if let Some(item) = &self.id {
            super::super::codec::element_entry(&mut map, "_id", item)?;
        }
        if let Some(item) = &self.implicit_rules {
            super::super::codec::element_entry(&mut map, "_implicitRules", item)?;
        }
        if let Some(item) = &self.language {
            super::super::codec::element_entry(&mut map, "_language", item)?;
        }
        super::super::codec::element_list_entry(&mut map, "_policy", &self.policy)?;
        super::super::codec::element_entry(&mut map, "_recorded", &self.recorded)?;
        if let Some(item) = &self.activity {
            serde::ser::SerializeMap::serialize_entry(&mut map, "activity", item)?;
        }
        if !self.agent.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "agent", &self.agent)?;
        }
        if !self.contained.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "contained", &self.contained)?;
        }
        if !self.entity.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "entity", &self.entity)?;
        }
        if !self.extension.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "extension", &self.extension)?;
        }
        if let Some(item) = &self.id {
            super::super::codec::value_entry(&mut map, "id", item)?;
        }
        if let Some(item) = &self.implicit_rules {
            super::super::codec::value_entry(&mut map, "implicitRules", item)?;
        }
        if let Some(item) = &self.language {
            super::super::codec::value_entry(&mut map, "language", item)?;
        }
        if let Some(item) = &self.location {
            serde::ser::SerializeMap::serialize_entry(&mut map, "location", item)?;
        }
        if let Some(item) = &self.meta {
            serde::ser::SerializeMap::serialize_entry(&mut map, "meta", item)?;
        }
        if !self.modifier_extension.is_empty() {
            serde::ser::SerializeMap::serialize_entry(
                &mut map,
                "modifierExtension",
                &self.modifier_extension,
            )?;
        }
        if let Some(item) = &self.period {
            serde::ser::SerializeMap::serialize_entry(&mut map, "period", item)?;
        }
        super::super::codec::value_list_entry(&mut map, "policy", &self.policy)?;
        if !self.reason.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "reason", &self.reason)?;
        }
        super::super::codec::value_entry(&mut map, "recorded", &self.recorded)?;
        serde::ser::SerializeMap::serialize_entry(&mut map, "resourceType", "Provenance")?;
        if !self.signature.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "signature", &self.signature)?;
        }
        if !self.target.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "target", &self.target)?;
        }
        if let Some(item) = &self.text {
            serde::ser::SerializeMap::serialize_entry(&mut map, "text", item)?;
        }
        serde::ser::SerializeMap::end(map)
    }
}

impl<'de> serde::Deserialize<'de> for Provenance {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let value = <super::super::codec::Value as serde::Deserialize>::deserialize(deserializer)?;
        let mut path = super::super::codec::Path::root("Provenance");
        let object =
            super::super::codec::expect_object(&value, &path).map_err(serde::de::Error::custom)?;
        super::super::codec::Json::from_json(object, &mut path).map_err(serde::de::Error::custom)
    }
}

/// Actor involved
///
/// An actor taking a role in an activity for which it can be assigned some
/// degree of responsibility for the activity taking place.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ProvenanceAgent {
    /// xml:id (or equivalent in JSON)
    ///
    /// unique id for the element within a resource (for internal references). This
    /// may be any string value that does not contain spaces.
    pub id: Option<std::string::String>,
    /// Additional Content defined by implementations
    ///
    /// May be used to represent additional information that is not part of the
    /// basic definition of the element. In order 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 is allowed to
    /// define an extension, there is a set of requirements that SHALL be met as
    /// part of the definition of the extension.
    pub extension: Vec<super::extension::Extension>,
    /// Extensions that cannot be ignored
    ///
    /// May be used to represent additional information that is not part of the
    /// basic definition of the element, and that modifies the understanding of the
    /// element that contains it. Usually modifier elements provide negation or
    /// qualification. In order 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 is allowed to define an extension, there
    /// is a set of requirements that SHALL be met as part of the definition of the
    /// extension. Applications processing a resource are required to check for
    /// modifier extensions.
    pub modifier_extension: Vec<super::extension::Extension>,
    /// What the agents role was
    ///
    /// The function of the agent with respect to the activity. The security role
    /// enabling the agent with respect to the activity.
    pub role: Vec<super::codeable_concept::CodeableConcept>,
    /// Who participated
    ///
    /// The individual, device or organization that participated in the event.
    pub who: ProvenanceAgentWho,
    /// Who the agent is representing
    ///
    /// The individual, device, or organization for whom the change was made.
    pub on_behalf_of: Option<ProvenanceAgentOnBehalfOf>,
    /// Type of relationship between agents
    ///
    /// The type of relationship between agents.
    pub related_agent_type: Option<super::codeable_concept::CodeableConcept>,
}

impl super::super::codec::Json for ProvenanceAgent {
    fn to_json(&self) -> Result<super::super::codec::Object, super::super::codec::EncodeError> {
        let mut object = super::super::codec::Object::new();
        if let Some(v) = &self.id {
            object.insert(
                std::string::String::from("id"),
                super::super::codec::Value::String(v.clone()),
            );
        }
        if !self.extension.is_empty() {
            let mut items = Vec::with_capacity(self.extension.len());
            for item in &self.extension {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("extension"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.modifier_extension.is_empty() {
            let mut items = Vec::with_capacity(self.modifier_extension.len());
            for item in &self.modifier_extension {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("modifierExtension"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.role.is_empty() {
            let mut items = Vec::with_capacity(self.role.len());
            for item in &self.role {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("role"),
                super::super::codec::Value::Array(items),
            );
        }
        let (suffix, value, element) = self.who.to_json_parts()?;
        if let Some(value) = value {
            object.insert(format!("who{suffix}"), value);
        }
        if let Some(element) = element {
            object.insert(format!("_who{suffix}"), element);
        }
        if let Some(item) = &self.on_behalf_of {
            let (suffix, value, element) = item.to_json_parts()?;
            if let Some(value) = value {
                object.insert(format!("onBehalfOf{suffix}"), value);
            }
            if let Some(element) = element {
                object.insert(format!("_onBehalfOf{suffix}"), element);
            }
        }
        if let Some(item) = &self.related_agent_type {
            object.insert(
                std::string::String::from("relatedAgentType"),
                super::super::codec::Value::Object(super::super::codec::Json::to_json(item)?),
            );
        }
        Ok(object)
    }

    fn from_json(
        object: &super::super::codec::Object,
        path: &mut super::super::codec::Path,
    ) -> Result<Self, super::super::codec::DecodeError> {
        let mut raw_id: Option<&super::super::codec::Value> = None;
        let mut raw_extension: Option<&super::super::codec::Value> = None;
        let mut raw_modifier_extension: Option<&super::super::codec::Value> = None;
        let mut raw_role: Option<&super::super::codec::Value> = None;
        let mut raw_who = super::super::codec::ChoiceSlot::default();
        let mut raw_on_behalf_of = super::super::codec::ChoiceSlot::default();
        let mut raw_related_agent_type: Option<&super::super::codec::Value> = None;
        for (key, value) in object {
            match key.as_str() {
                "id" => {
                    raw_id = Some(value);
                }
                "extension" => {
                    raw_extension = Some(value);
                }
                "modifierExtension" => {
                    raw_modifier_extension = Some(value);
                }
                "role" => {
                    raw_role = Some(value);
                }
                "whoUri" => {
                    raw_who.value("Uri", value, path)?;
                }
                "_whoUri" => {
                    raw_who.element("Uri", value, path)?;
                }
                "whoReference" => {
                    raw_who.value("Reference", value, path)?;
                }
                "_whoReference" => {
                    raw_who.element("Reference", value, path)?;
                }
                "onBehalfOfUri" => {
                    raw_on_behalf_of.value("Uri", value, path)?;
                }
                "_onBehalfOfUri" => {
                    raw_on_behalf_of.element("Uri", value, path)?;
                }
                "onBehalfOfReference" => {
                    raw_on_behalf_of.value("Reference", value, path)?;
                }
                "_onBehalfOfReference" => {
                    raw_on_behalf_of.element("Reference", value, path)?;
                }
                "relatedAgentType" => {
                    raw_related_agent_type = Some(value);
                }
                other => {
                    return path.with(other, |path| {
                        Err(path.error(super::super::codec::DecodeErrorKind::UnknownProperty))
                    });
                }
            }
        }
        let field_id = raw_id
            .map(|value| {
                path.with("id", |path| {
                    let value = super::super::codec::expect_single(value, path)?;
                    super::super::codec::expect_string(value, path)
                })
            })
            .transpose()?;
        let mut field_extension = Vec::new();
        if let Some(raw) = raw_extension {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_extension.push(path.with_index("extension", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let mut field_modifier_extension = Vec::new();
        if let Some(raw) = raw_modifier_extension {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_modifier_extension.push(path.with_index(
                    "modifierExtension",
                    index,
                    |path| {
                        super::super::codec::Json::from_json(
                            super::super::codec::expect_object(value, path)?,
                            path,
                        )
                    },
                )?);
            }
        }
        let mut field_role = Vec::new();
        if let Some(raw) = raw_role {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_role.push(path.with_index("role", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let field_who = path.with("who", |path| {
            let suffix = raw_who
                .suffix
                .ok_or_else(|| path.error(super::super::codec::DecodeErrorKind::MissingProperty))?;
            ProvenanceAgentWho::from_json_parts(suffix, raw_who.value, raw_who.element, path)
        })?;
        let field_on_behalf_of = match raw_on_behalf_of.suffix {
            None => None,
            Some(suffix) => Some(path.with("onBehalfOf", |path| {
                ProvenanceAgentOnBehalfOf::from_json_parts(
                    suffix,
                    raw_on_behalf_of.value,
                    raw_on_behalf_of.element,
                    path,
                )
            })?),
        };
        let field_related_agent_type = raw_related_agent_type
            .map(|value| {
                path.with("relatedAgentType", |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(
                            super::super::codec::expect_single(value, path)?,
                            path,
                        )?,
                        path,
                    )
                })
            })
            .transpose()?;
        Ok(Self {
            id: field_id,
            extension: field_extension,
            modifier_extension: field_modifier_extension,
            role: field_role,
            who: field_who,
            on_behalf_of: field_on_behalf_of,
            related_agent_type: field_related_agent_type,
        })
    }
}

impl serde::Serialize for ProvenanceAgent {
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        let mut map = serde::Serializer::serialize_map(serializer, None)?;
        if let Some(ProvenanceAgentOnBehalfOf::Uri(inner)) = &self.on_behalf_of {
            super::super::codec::element_entry(&mut map, "_onBehalfOfUri", inner)?;
        }
        if let ProvenanceAgentWho::Uri(inner) = &self.who {
            super::super::codec::element_entry(&mut map, "_whoUri", inner)?;
        }
        if !self.extension.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "extension", &self.extension)?;
        }
        if let Some(v) = &self.id {
            serde::ser::SerializeMap::serialize_entry(&mut map, "id", v)?;
        }
        if !self.modifier_extension.is_empty() {
            serde::ser::SerializeMap::serialize_entry(
                &mut map,
                "modifierExtension",
                &self.modifier_extension,
            )?;
        }
        match &self.on_behalf_of {
            Some(ProvenanceAgentOnBehalfOf::Reference(inner)) => {
                serde::ser::SerializeMap::serialize_entry(
                    &mut map,
                    "onBehalfOfReference",
                    inner.as_ref(),
                )?;
            }
            Some(ProvenanceAgentOnBehalfOf::Uri(inner)) => {
                super::super::codec::value_entry(&mut map, "onBehalfOfUri", inner)?;
            }
            None => {}
        }
        if let Some(item) = &self.related_agent_type {
            serde::ser::SerializeMap::serialize_entry(&mut map, "relatedAgentType", item)?;
        }
        if !self.role.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "role", &self.role)?;
        }
        match &self.who {
            ProvenanceAgentWho::Reference(inner) => {
                serde::ser::SerializeMap::serialize_entry(
                    &mut map,
                    "whoReference",
                    inner.as_ref(),
                )?;
            }
            ProvenanceAgentWho::Uri(inner) => {
                super::super::codec::value_entry(&mut map, "whoUri", inner)?;
            }
        }
        serde::ser::SerializeMap::end(map)
    }
}

impl<'de> serde::Deserialize<'de> for ProvenanceAgent {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let value = <super::super::codec::Value as serde::Deserialize>::deserialize(deserializer)?;
        let mut path = super::super::codec::Path::root("ProvenanceAgent");
        let object =
            super::super::codec::expect_object(&value, &path).map_err(serde::de::Error::custom)?;
        super::super::codec::Json::from_json(object, &mut path).map_err(serde::de::Error::custom)
    }
}

/// The \`onBehalfOf\[x\]\` choice of \`ProvenanceAgent\`.
///
/// The individual, device, or organization for whom the change was made.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ProvenanceAgentOnBehalfOf {
    /// The `uri` form.
    Uri(super::primitives::Uri),
    /// The `Reference` form.
    Reference(Box<super::reference::Reference>),
}

impl ProvenanceAgentOnBehalfOf {
    /// The key suffix, the value part, and the `_name` part of this form.
    ///
    /// # Errors
    ///
    /// Returns [`super::super::codec::EncodeError`] when a held value has no JSON form.
    pub fn to_json_parts(
        &self,
    ) -> Result<
        (
            &'static str,
            Option<super::super::codec::Value>,
            Option<super::super::codec::Value>,
        ),
        super::super::codec::EncodeError,
    > {
        match self {
            Self::Uri(inner) => Ok((
                "Uri",
                super::super::codec::Primitive::value_json(inner)?,
                super::super::codec::Primitive::element_json(inner)?,
            )),
            Self::Reference(inner) => Ok((
                "Reference",
                Some(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(inner.as_ref())?,
                )),
                None,
            )),
        }
    }

    /// Decodes the form named by `suffix` from its value and `_name` parts.
    ///
    /// # Errors
    ///
    /// Returns [`super::super::codec::DecodeError`] for an unknown suffix or a malformed part.
    pub fn from_json_parts(
        suffix: &str,
        value: Option<&super::super::codec::Value>,
        element: Option<&super::super::codec::Value>,
        path: &mut super::super::codec::Path,
    ) -> Result<Self, super::super::codec::DecodeError> {
        match suffix {
            "Uri" => Ok(Self::Uri(super::super::codec::Primitive::from_json_parts(
                value, element, path,
            )?)),
            "Reference" => {
                if element.is_some() {
                    return Err(path.error(super::super::codec::DecodeErrorKind::WrongType {
                        expected: "no underscore form for a complex type",
                    }));
                }
                let value = value.ok_or_else(|| {
                    path.error(super::super::codec::DecodeErrorKind::MissingProperty)
                })?;
                let inner = super::super::codec::Json::from_json(
                    super::super::codec::expect_object(
                        super::super::codec::expect_single(value, path)?,
                        path,
                    )?,
                    path,
                )?;
                Ok(Self::Reference(Box::new(inner)))
            }
            _ => Err(path.error(super::super::codec::DecodeErrorKind::UnknownProperty)),
        }
    }
}

/// The \`who\[x\]\` choice of \`ProvenanceAgent\`.
///
/// The individual, device or organization that participated in the event.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ProvenanceAgentWho {
    /// The `uri` form.
    Uri(super::primitives::Uri),
    /// The `Reference` form.
    Reference(Box<super::reference::Reference>),
}

impl ProvenanceAgentWho {
    /// The key suffix, the value part, and the `_name` part of this form.
    ///
    /// # Errors
    ///
    /// Returns [`super::super::codec::EncodeError`] when a held value has no JSON form.
    pub fn to_json_parts(
        &self,
    ) -> Result<
        (
            &'static str,
            Option<super::super::codec::Value>,
            Option<super::super::codec::Value>,
        ),
        super::super::codec::EncodeError,
    > {
        match self {
            Self::Uri(inner) => Ok((
                "Uri",
                super::super::codec::Primitive::value_json(inner)?,
                super::super::codec::Primitive::element_json(inner)?,
            )),
            Self::Reference(inner) => Ok((
                "Reference",
                Some(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(inner.as_ref())?,
                )),
                None,
            )),
        }
    }

    /// Decodes the form named by `suffix` from its value and `_name` parts.
    ///
    /// # Errors
    ///
    /// Returns [`super::super::codec::DecodeError`] for an unknown suffix or a malformed part.
    pub fn from_json_parts(
        suffix: &str,
        value: Option<&super::super::codec::Value>,
        element: Option<&super::super::codec::Value>,
        path: &mut super::super::codec::Path,
    ) -> Result<Self, super::super::codec::DecodeError> {
        match suffix {
            "Uri" => Ok(Self::Uri(super::super::codec::Primitive::from_json_parts(
                value, element, path,
            )?)),
            "Reference" => {
                if element.is_some() {
                    return Err(path.error(super::super::codec::DecodeErrorKind::WrongType {
                        expected: "no underscore form for a complex type",
                    }));
                }
                let value = value.ok_or_else(|| {
                    path.error(super::super::codec::DecodeErrorKind::MissingProperty)
                })?;
                let inner = super::super::codec::Json::from_json(
                    super::super::codec::expect_object(
                        super::super::codec::expect_single(value, path)?,
                        path,
                    )?,
                    path,
                )?;
                Ok(Self::Reference(Box::new(inner)))
            }
            _ => Err(path.error(super::super::codec::DecodeErrorKind::UnknownProperty)),
        }
    }
}

/// An entity used in this activity.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ProvenanceEntity {
    /// xml:id (or equivalent in JSON)
    ///
    /// unique id for the element within a resource (for internal references). This
    /// may be any string value that does not contain spaces.
    pub id: Option<std::string::String>,
    /// Additional Content defined by implementations
    ///
    /// May be used to represent additional information that is not part of the
    /// basic definition of the element. In order 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 is allowed to
    /// define an extension, there is a set of requirements that SHALL be met as
    /// part of the definition of the extension.
    pub extension: Vec<super::extension::Extension>,
    /// Extensions that cannot be ignored
    ///
    /// May be used to represent additional information that is not part of the
    /// basic definition of the element, and that modifies the understanding of the
    /// element that contains it. Usually modifier elements provide negation or
    /// qualification. In order 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 is allowed to define an extension, there
    /// is a set of requirements that SHALL be met as part of the definition of the
    /// extension. Applications processing a resource are required to check for
    /// modifier extensions.
    pub modifier_extension: Vec<super::extension::Extension>,
    /// derivation | revision | quotation | source | removal
    ///
    /// How the entity was used during the activity.
    pub role: super::primitives::Code,
    /// Identity of entity
    ///
    /// Identity of the Entity used. May be a logical or physical uri and maybe
    /// absolute or relative.
    pub what: ProvenanceEntityWhat,
    /// Entity is attributed to this agent
    ///
    /// The entity is attributed to an agent to express the agent's responsibility
    /// for that entity, possibly along with other agents. This description can be
    /// understood as shorthand for saying that the agent was responsible for the
    /// activity which generated the entity.
    pub agent: Vec<ProvenanceAgent>,
}

impl super::super::codec::Json for ProvenanceEntity {
    fn to_json(&self) -> Result<super::super::codec::Object, super::super::codec::EncodeError> {
        let mut object = super::super::codec::Object::new();
        if let Some(v) = &self.id {
            object.insert(
                std::string::String::from("id"),
                super::super::codec::Value::String(v.clone()),
            );
        }
        if !self.extension.is_empty() {
            let mut items = Vec::with_capacity(self.extension.len());
            for item in &self.extension {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("extension"),
                super::super::codec::Value::Array(items),
            );
        }
        if !self.modifier_extension.is_empty() {
            let mut items = Vec::with_capacity(self.modifier_extension.len());
            for item in &self.modifier_extension {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("modifierExtension"),
                super::super::codec::Value::Array(items),
            );
        }
        if let Some(v) = super::super::codec::Primitive::value_json(&self.role)? {
            object.insert(std::string::String::from("role"), v);
        }
        if let Some(e) = super::super::codec::Primitive::element_json(&self.role)? {
            object.insert(std::string::String::from("_role"), e);
        }
        let (suffix, value, element) = self.what.to_json_parts()?;
        if let Some(value) = value {
            object.insert(format!("what{suffix}"), value);
        }
        if let Some(element) = element {
            object.insert(format!("_what{suffix}"), element);
        }
        if !self.agent.is_empty() {
            let mut items = Vec::with_capacity(self.agent.len());
            for item in &self.agent {
                items.push(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(item)?,
                ));
            }
            object.insert(
                std::string::String::from("agent"),
                super::super::codec::Value::Array(items),
            );
        }
        Ok(object)
    }

    fn from_json(
        object: &super::super::codec::Object,
        path: &mut super::super::codec::Path,
    ) -> Result<Self, super::super::codec::DecodeError> {
        let mut raw_id: Option<&super::super::codec::Value> = None;
        let mut raw_extension: Option<&super::super::codec::Value> = None;
        let mut raw_modifier_extension: Option<&super::super::codec::Value> = None;
        let mut raw_role: Option<&super::super::codec::Value> = None;
        let mut raw_role_element: Option<&super::super::codec::Value> = None;
        let mut raw_what = super::super::codec::ChoiceSlot::default();
        let mut raw_agent: Option<&super::super::codec::Value> = None;
        for (key, value) in object {
            match key.as_str() {
                "id" => {
                    raw_id = Some(value);
                }
                "extension" => {
                    raw_extension = Some(value);
                }
                "modifierExtension" => {
                    raw_modifier_extension = Some(value);
                }
                "role" => {
                    raw_role = Some(value);
                }
                "_role" => {
                    raw_role_element = Some(value);
                }
                "whatUri" => {
                    raw_what.value("Uri", value, path)?;
                }
                "_whatUri" => {
                    raw_what.element("Uri", value, path)?;
                }
                "whatReference" => {
                    raw_what.value("Reference", value, path)?;
                }
                "_whatReference" => {
                    raw_what.element("Reference", value, path)?;
                }
                "whatIdentifier" => {
                    raw_what.value("Identifier", value, path)?;
                }
                "_whatIdentifier" => {
                    raw_what.element("Identifier", value, path)?;
                }
                "agent" => {
                    raw_agent = Some(value);
                }
                other => {
                    return path.with(other, |path| {
                        Err(path.error(super::super::codec::DecodeErrorKind::UnknownProperty))
                    });
                }
            }
        }
        let field_id = raw_id
            .map(|value| {
                path.with("id", |path| {
                    let value = super::super::codec::expect_single(value, path)?;
                    super::super::codec::expect_string(value, path)
                })
            })
            .transpose()?;
        let mut field_extension = Vec::new();
        if let Some(raw) = raw_extension {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_extension.push(path.with_index("extension", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        let mut field_modifier_extension = Vec::new();
        if let Some(raw) = raw_modifier_extension {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_modifier_extension.push(path.with_index(
                    "modifierExtension",
                    index,
                    |path| {
                        super::super::codec::Json::from_json(
                            super::super::codec::expect_object(value, path)?,
                            path,
                        )
                    },
                )?);
            }
        }
        let field_role = path.with("role", |path| {
            super::super::codec::Primitive::from_json_parts(raw_role, raw_role_element, path)
        })?;
        let field_what = path.with("what", |path| {
            let suffix = raw_what
                .suffix
                .ok_or_else(|| path.error(super::super::codec::DecodeErrorKind::MissingProperty))?;
            ProvenanceEntityWhat::from_json_parts(suffix, raw_what.value, raw_what.element, path)
        })?;
        let mut field_agent = Vec::new();
        if let Some(raw) = raw_agent {
            for (index, value) in super::super::codec::expect_array(raw, path)?
                .iter()
                .enumerate()
            {
                field_agent.push(path.with_index("agent", index, |path| {
                    super::super::codec::Json::from_json(
                        super::super::codec::expect_object(value, path)?,
                        path,
                    )
                })?);
            }
        }
        Ok(Self {
            id: field_id,
            extension: field_extension,
            modifier_extension: field_modifier_extension,
            role: field_role,
            what: field_what,
            agent: field_agent,
        })
    }
}

impl serde::Serialize for ProvenanceEntity {
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        let mut map = serde::Serializer::serialize_map(serializer, None)?;
        super::super::codec::element_entry(&mut map, "_role", &self.role)?;
        if let ProvenanceEntityWhat::Uri(inner) = &self.what {
            super::super::codec::element_entry(&mut map, "_whatUri", inner)?;
        }
        if !self.agent.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "agent", &self.agent)?;
        }
        if !self.extension.is_empty() {
            serde::ser::SerializeMap::serialize_entry(&mut map, "extension", &self.extension)?;
        }
        if let Some(v) = &self.id {
            serde::ser::SerializeMap::serialize_entry(&mut map, "id", v)?;
        }
        if !self.modifier_extension.is_empty() {
            serde::ser::SerializeMap::serialize_entry(
                &mut map,
                "modifierExtension",
                &self.modifier_extension,
            )?;
        }
        super::super::codec::value_entry(&mut map, "role", &self.role)?;
        match &self.what {
            ProvenanceEntityWhat::Identifier(inner) => {
                serde::ser::SerializeMap::serialize_entry(
                    &mut map,
                    "whatIdentifier",
                    inner.as_ref(),
                )?;
            }
            ProvenanceEntityWhat::Reference(inner) => {
                serde::ser::SerializeMap::serialize_entry(
                    &mut map,
                    "whatReference",
                    inner.as_ref(),
                )?;
            }
            ProvenanceEntityWhat::Uri(inner) => {
                super::super::codec::value_entry(&mut map, "whatUri", inner)?;
            }
        }
        serde::ser::SerializeMap::end(map)
    }
}

impl<'de> serde::Deserialize<'de> for ProvenanceEntity {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let value = <super::super::codec::Value as serde::Deserialize>::deserialize(deserializer)?;
        let mut path = super::super::codec::Path::root("ProvenanceEntity");
        let object =
            super::super::codec::expect_object(&value, &path).map_err(serde::de::Error::custom)?;
        super::super::codec::Json::from_json(object, &mut path).map_err(serde::de::Error::custom)
    }
}

/// The \`what\[x\]\` choice of \`ProvenanceEntity\`.
///
/// Identity of the Entity used. May be a logical or physical uri and maybe
/// absolute or relative.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ProvenanceEntityWhat {
    /// The `uri` form.
    Uri(super::primitives::Uri),
    /// The `Reference` form.
    Reference(Box<super::reference::Reference>),
    /// The `Identifier` form.
    Identifier(Box<super::identifier::Identifier>),
}

impl ProvenanceEntityWhat {
    /// The key suffix, the value part, and the `_name` part of this form.
    ///
    /// # Errors
    ///
    /// Returns [`super::super::codec::EncodeError`] when a held value has no JSON form.
    pub fn to_json_parts(
        &self,
    ) -> Result<
        (
            &'static str,
            Option<super::super::codec::Value>,
            Option<super::super::codec::Value>,
        ),
        super::super::codec::EncodeError,
    > {
        match self {
            Self::Uri(inner) => Ok((
                "Uri",
                super::super::codec::Primitive::value_json(inner)?,
                super::super::codec::Primitive::element_json(inner)?,
            )),
            Self::Reference(inner) => Ok((
                "Reference",
                Some(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(inner.as_ref())?,
                )),
                None,
            )),
            Self::Identifier(inner) => Ok((
                "Identifier",
                Some(super::super::codec::Value::Object(
                    super::super::codec::Json::to_json(inner.as_ref())?,
                )),
                None,
            )),
        }
    }

    /// Decodes the form named by `suffix` from its value and `_name` parts.
    ///
    /// # Errors
    ///
    /// Returns [`super::super::codec::DecodeError`] for an unknown suffix or a malformed part.
    pub fn from_json_parts(
        suffix: &str,
        value: Option<&super::super::codec::Value>,
        element: Option<&super::super::codec::Value>,
        path: &mut super::super::codec::Path,
    ) -> Result<Self, super::super::codec::DecodeError> {
        match suffix {
            "Uri" => Ok(Self::Uri(super::super::codec::Primitive::from_json_parts(
                value, element, path,
            )?)),
            "Reference" => {
                if element.is_some() {
                    return Err(path.error(super::super::codec::DecodeErrorKind::WrongType {
                        expected: "no underscore form for a complex type",
                    }));
                }
                let value = value.ok_or_else(|| {
                    path.error(super::super::codec::DecodeErrorKind::MissingProperty)
                })?;
                let inner = super::super::codec::Json::from_json(
                    super::super::codec::expect_object(
                        super::super::codec::expect_single(value, path)?,
                        path,
                    )?,
                    path,
                )?;
                Ok(Self::Reference(Box::new(inner)))
            }
            "Identifier" => {
                if element.is_some() {
                    return Err(path.error(super::super::codec::DecodeErrorKind::WrongType {
                        expected: "no underscore form for a complex type",
                    }));
                }
                let value = value.ok_or_else(|| {
                    path.error(super::super::codec::DecodeErrorKind::MissingProperty)
                })?;
                let inner = super::super::codec::Json::from_json(
                    super::super::codec::expect_object(
                        super::super::codec::expect_single(value, path)?,
                        path,
                    )?,
                    path,
                )?;
                Ok(Self::Identifier(Box::new(inner)))
            }
            _ => Err(path.error(super::super::codec::DecodeErrorKind::UnknownProperty)),
        }
    }
}