UK Core Implementation Guide STU3 Sequence - Sprint 6 Review

StructureDefinition-UKCore-RelatedPerson

Description

This profile defines the UK constraints and extensions on the International FHIR resource RelatedPerson.

ProfilePurpose

This profile allows exchange of information about a person that is involved in the care for an individual, but who is not the target of healthcare, nor has a formal responsibility in the care process.

Snapshot View

contactPreferenceI0..1Extension(Complex)
copyCorrespondenceIndicatorI0..1Extension(boolean)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
activeΣ ?!0..1boolean
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
relationshipΣ0..*CodeableConceptBinding
nameΣ0..*HumanName
otherContactSystemI0..1Extension(Coding)
valueΣ0..1string
useΣ ?!0..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
genderΣ0..1codeBinding
birthDateΣ0..1date
addressΣ0..*Address
photoI0..*Attachment
periodI0..1Period
language1..1CodeableConceptBinding
preferred0..1boolean

Differential View

contactPreferenceI0..1Extension(Complex)
copyCorrespondenceIndicatorI0..1Extension(boolean)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
activeΣ ?!0..1boolean
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
relationshipΣ0..*CodeableConceptBinding
nameΣ0..*HumanName
otherContactSystemI0..1Extension(Coding)
valueΣ0..1string
useΣ ?!0..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
genderΣ0..1codeBinding
birthDateΣ0..1date
addressΣ0..*Address
photoI0..*Attachment
periodI0..1Period
language1..1CodeableConceptBinding
preferred0..1boolean

Hybrid View

contactPreferenceI0..1Extension(Complex)
copyCorrespondenceIndicatorI0..1Extension(boolean)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
activeΣ ?!0..1boolean
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
relationshipΣ0..*CodeableConceptBinding
nameΣ0..*HumanName
otherContactSystemI0..1Extension(Coding)
valueΣ0..1string
useΣ ?!0..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
genderΣ0..1codeBinding
birthDateΣ0..1date
addressΣ0..*Address
photoI0..*Attachment
periodI0..1Period
language1..1CodeableConceptBinding
preferred0..1boolean

Table View

RelatedPerson..
RelatedPerson.extension0..
RelatedPerson.extensionExtension0..
RelatedPerson.extensionExtension0..
RelatedPerson.identifier..
RelatedPerson.identifier.assignerReference(UK Core Organization)..
RelatedPerson.patientReference(UK Core Patient)..
RelatedPerson.patient.identifier..
RelatedPerson.patient.identifier.assignerReference(UK Core Organization)..
RelatedPerson.relationship..
RelatedPerson.telecom..
RelatedPerson.telecom.system..
RelatedPerson.telecom.system.extension0..
RelatedPerson.telecom.system.extensionExtension0..


XML View

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="UKCore-RelatedPerson" />
    <url value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-RelatedPerson" />
    <version value="2.4.0" />
    <name value="UKCoreRelatedPerson" />
    <title value="UK Core RelatedPerson" />
    <status value="active" />
    <date value="2022-12-16" />
    <publisher value="HL7 UK" />
    <contact>
        <name value="HL7 UK" />
        <telecom>
            <system value="email" />
            <value value="ukcore@hl7.org.uk" />
            <use value="work" />
            <rank value="1" />
        </telecom>
    </contact>
    <description value="This profile defines the UK constraints and extensions on the International FHIR resource [RelatedPerson](https://hl7.org/fhir/R4/RelatedPerson.html)." />
    <purpose value="This profile allows exchange of information about a person that is involved in the care for an individual, but who is not the target of healthcare, nor has a formal responsibility in the care process." />
    <copyright value="Copyright &#169; 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the &quot;License&quot;); you may not use this file except in compliance with the License. You may obtain a copy of the License at  http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7&#174; FHIR&#174; standard Copyright &#169; 2011+ HL7 The HL7&#174; FHIR&#174; standard is used under the FHIR license. You may obtain a copy of the FHIR license at  https://www.hl7.org/fhir/license.html." />
    <fhirVersion value="4.0.1" />
    <mapping>
        <identity value="rim" />
        <uri value="http://hl7.org/v3" />
        <name value="RIM Mapping" />
    </mapping>
    <mapping>
        <identity value="w5" />
        <uri value="http://hl7.org/fhir/fivews" />
        <name value="FiveWs Pattern Mapping" />
    </mapping>
    <mapping>
        <identity value="v2" />
        <uri value="http://hl7.org/v2" />
        <name value="HL7 v2 Mapping" />
    </mapping>
    <kind value="resource" />
    <abstract value="false" />
    <type value="RelatedPerson" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/RelatedPerson" />
    <derivation value="constraint" />
    <differential>
        <element id="RelatedPerson.extension">
            <path value="RelatedPerson.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <min value="0" />
        </element>
        <element id="RelatedPerson.extension:contactPreference">
            <path value="RelatedPerson.extension" />
            <sliceName value="contactPreference" />
            <min value="0" />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-ContactPreference" />
            </type>
        </element>
        <element id="RelatedPerson.extension:copyCorrespondenceIndicator">
            <path value="RelatedPerson.extension" />
            <sliceName value="copyCorrespondenceIndicator" />
            <min value="0" />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-CopyCorrespondenceIndicator" />
            </type>
        </element>
        <element id="RelatedPerson.identifier.assigner">
            <path value="RelatedPerson.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="RelatedPerson.patient">
            <path value="RelatedPerson.patient" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient" />
            </type>
        </element>
        <element id="RelatedPerson.patient.identifier.assigner">
            <path value="RelatedPerson.patient.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="RelatedPerson.relationship">
            <path value="RelatedPerson.relationship" />
            <binding>
                <strength value="extensible" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-PersonRelationshipType" />
            </binding>
        </element>
        <element id="RelatedPerson.telecom.system.extension">
            <path value="RelatedPerson.telecom.system.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <min value="0" />
        </element>
        <element id="RelatedPerson.telecom.system.extension:otherContactSystem">
            <path value="RelatedPerson.telecom.system.extension" />
            <sliceName value="otherContactSystem" />
            <min value="0" />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-OtherContactSystem" />
            </type>
        </element>
    </differential>
</StructureDefinition>

JSON View

{
    "resourceType": "StructureDefinition",
    "id": "UKCore-RelatedPerson",
    "url": "https://fhir.hl7.org.uk/StructureDefinition/UKCore-RelatedPerson",
    "version": "2.4.0",
    "name": "UKCoreRelatedPerson",
    "title": "UK Core RelatedPerson",
    "status": "active",
    "date": "2022-12-16",
    "publisher": "HL7 UK",
    "contact":  [
        {
            "name": "HL7 UK",
            "telecom":  [
                {
                    "system": "email",
                    "value": "ukcore@hl7.org.uk",
                    "use": "work",
                    "rank": 1
                }
            ]
        }
    ],
    "description": "This profile defines the UK constraints and extensions on the International FHIR resource [RelatedPerson](https://hl7.org/fhir/R4/RelatedPerson.html).",
    "purpose": "This profile allows exchange of information about a person that is involved in the care for an individual, but who is not the target of healthcare, nor has a formal responsibility in the care process.",
    "copyright": "Copyright © 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at  http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at  https://www.hl7.org/fhir/license.html.",
    "fhirVersion": "4.0.1",
    "mapping":  [
        {
            "identity": "rim",
            "uri": "http://hl7.org/v3",
            "name": "RIM Mapping"
        },
        {
            "identity": "w5",
            "uri": "http://hl7.org/fhir/fivews",
            "name": "FiveWs Pattern Mapping"
        },
        {
            "identity": "v2",
            "uri": "http://hl7.org/v2",
            "name": "HL7 v2 Mapping"
        }
    ],
    "kind": "resource",
    "abstract": false,
    "type": "RelatedPerson",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/RelatedPerson",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "RelatedPerson.extension",
                "path": "RelatedPerson.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "rules": "open"
                },
                "min": 0
            },
            {
                "id": "RelatedPerson.extension:contactPreference",
                "path": "RelatedPerson.extension",
                "sliceName": "contactPreference",
                "min": 0,
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-ContactPreference"
                        ]
                    }
                ]
            },
            {
                "id": "RelatedPerson.extension:copyCorrespondenceIndicator",
                "path": "RelatedPerson.extension",
                "sliceName": "copyCorrespondenceIndicator",
                "min": 0,
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-CopyCorrespondenceIndicator"
                        ]
                    }
                ]
            },
            {
                "id": "RelatedPerson.identifier.assigner",
                "path": "RelatedPerson.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "RelatedPerson.patient",
                "path": "RelatedPerson.patient",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient"
                        ]
                    }
                ]
            },
            {
                "id": "RelatedPerson.patient.identifier.assigner",
                "path": "RelatedPerson.patient.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "RelatedPerson.relationship",
                "path": "RelatedPerson.relationship",
                "binding": {
                    "strength": "extensible",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-PersonRelationshipType"
                }
            },
            {
                "id": "RelatedPerson.telecom.system.extension",
                "path": "RelatedPerson.telecom.system.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "rules": "open"
                },
                "min": 0
            },
            {
                "id": "RelatedPerson.telecom.system.extension:otherContactSystem",
                "path": "RelatedPerson.telecom.system.extension",
                "sliceName": "otherContactSystem",
                "min": 0,
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-OtherContactSystem"
                        ]
                    }
                ]
            }
        ]
    }
}

Examples

Related Person - An example to illustrate a person who is related to the patient.
Example UKCore-RelatedPerson

Example Usage Scenarios

The following are example usage scenarios for the UK Core RelatedPerson profile:

  • Query for related person information for a given Patient
  • Exchange related person information within a FHIR document or message.

Profile Specific Implementation Guidance:

Extensions

More information about the extensions can be found using the links below.

Extension Context Link Comment
contactPreference RelatedPerson Extension UKCore-ContactPreference The preferred method of contact, contact times and written communication format given by a Patient or Related Person.
copyCorrespondenceIndicator RelatedPerson Extension UKCore-CopyCorrespondenceIndicator Indicates that a Patient contact or RelatedPerson must be copied in to Patient correspondence.
otherContactSystem RelatedPerson.telecom.system Extension UKCore-OtherContactSystem Information about other contact methods which could be used in addition to those listed in ContactPoint.system.

Bindings (differential)

More information about the bindings to UK Core ValueSets can be found below.

Context Strength Link
RelatedPerson.extension:contactPreference.extension:PreferredContactMethod Extensible ValueSet UKCore-PreferredContactMethod
RelatedPerson.extension:contactPreference.extension:PreferredWrittenCommunicationFormat Extensible ValueSet UKCore-PreferredWrittenCommunicationFormat
RelatedPerson.relationship Extensible ValueSet UKCore-PersonRelationshipType

patient

The resource being referenced SHOULD conform to the Profile UKCore-Patient.


telecom

A contact detail for the person using the ContactPoint data type.


back to top