Administrative Incubator, published by HL7 International / Patient Administration. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/admin-incubator/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/StructureDefinition/PersonalRelationship | Version: 0.1.0 | |||
| Standards status: Draft Draft as of 2021-01-02 | Maturity Level: 0 | Computable Name: PersonalRelationship | ||
Details about the relationship between 2 individuals.
This resource is to be used for any inter-personal relationship, such as but not limited to:
The relevance of recording appropriate relationships would be determined per use case. Implementation guides addressing each scenario would determine those appropriate levels of relevance. For example, a Public Health Implementation Guide may indicate how to represent broad sets of relationships for contact tracing, while a Social Services Implementation Guide may indicate how to represent households for financial assistance program eligibility. Not all relationships are expected to be recorded, but within any scenario any relationship could be categorized as relevant.
The relationship can include a time period associated with it to represent current as well as future and past relationships. This allows for the temporal nature of the relationship. (e.g., father/daughter is mostly persistent, but resident in household is very transient).
Additionally, there is the ability to assert the certainty of the relationship.
This is not for tracking relationships between a care team or provider and the patient. For example, the social worker would be a Practitioner on your Care Team. The PersonalRelationship is not for tracking caregivers that are performing actions. It does not document a role of an individual, just the relationship between individuals. For example, the lady taking you to church would be a RelatedPerson, which is a role.
Boundaries between this and RelatedPerson
The RelatedPerson resource contains the details of both the individual and their relationship to the patient.
RelatedPerson would be used when the individual is documented within the context of a patient's chart.
RelatedPerson can be an actor and do things. PersonalRelationship cannot do things. PersonalRelationship is one
way you can discover someone who can do things. A PersonalRelationship does not automatically indicate that the
target individual might NOT be assumed to take actions on behalf of a source individual.
Boundaries between this and FamilyMemberHistory
Although there is a relationship within the family member history, it is not the same as the relationship.
It intends to provide the details of the family member's health history that could be relevant to the patient, not the relationship itself.
Boundaries between this and CareTeam
PersonalRelationship is not to be used to represent the relationship of "provides care for". That should be in CareTeam.
Boundaries between this and Group
A group contains all the members and the involvement property indicates the member's relationship to the group, not to the other individuals withing the group.
Boundaries between this and Person.link
Some systems have a situation where they have a single record of a one individual that is related to multiple patients, and can perform actions for each of those patients.
For example, a mother (who is not a Patient) of two children (who are both Patients).
The intent is that this be modeled in FHIR by using multiple RelatedPerson resources that all represent the same record for human individual.
For the mother / two children example, you would have two RelatedPerson resources, both representing the mother.
Each RelatedPerson resource would refer to the Patient resources for the two children.
PersonalRelationship should not be used to indicate that those RelatedPerson resources represent the same individual.
Instead, those different RelatedPerson resources can be linked using Person.link.
Usages:
You can also check for usages in the FHIR IG Statistics
Description Differentials, Snapshots, and other representations.
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | DomainResource | A relationship between two indiduals Elements defined in Ancestors:id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
![]() ![]() |
Σ | 1..1 | Reference(Patient | RelatedPerson | Person) | The individual that is the the source of the relationship |
![]() ![]() |
Σ | 1..1 | CodeableConcept | The relationship between the source and the target individuals Binding: PersonalRelationshipType (preferred) |
![]() ![]() |
Σ | 1..1 | Reference(Patient | RelatedPerson | Person) | The individual that is the the target of the relationship |
![]() ![]() |
0..* | Period | The period of time during which the relationship is active | |
![]() ![]() |
Σ | 0..1 | CodeableConcept | The confidence level of this relationship Binding Description: (example): Value to be provided |
![]() ![]() |
0..1 | Reference(Patient | RelatedPerson | Practitioner | Organization) | Who has asserted the details of the relationship | |
![]() ![]() |
Σ | 0..* | Reference(Group) | This relationship is applicable to the referenced group(s) |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| PersonalRelationship.relationshipType | Base | preferred | Personal Relationship Type | 📦6.0.0-ballot3 | FHIR Std. |
| PersonalRelationship.confidence | Base | example | Not State | Unknown |
<PersonalRelationship xmlns="http://hl7.org/fhir"> <id value="[id]"/><!-- 0..1 * Logical id of this artifact --> <meta><!-- I 0..1 * Metadata about the resource --></meta> <implicitRules value="[uri]"/><!-- I 0..1 * A set of rules under which this content was created --> <language value="[code]"/><!-- I 0..1 * Language of the resource content --> <text><!-- I 0..1 * Text summary of the resource, for human interpretation --></text> <contained><!-- 0..* * Contained, inline Resources --></contained> <extension><!-- See Extensions Additional content defined by implementations --></extension> <modifierExtension><!-- I 0..* * Extensions that cannot be ignored --></modifierExtension> <source><!-- 1..1 * The individual that is the the source of the relationship --></source> <relationshipType><!-- 1..1 * The relationship between the source and the target individuals --></relationshipType> <target><!-- 1..1 * The individual that is the the target of the relationship --></target> <period><!-- 0..* * The period of time during which the relationship is active --></period> <confidence><!-- 0..1 * The confidence level of this relationship --></confidence> <asserter><!-- 0..1 * Who has asserted the details of the relationship --></asserter> <group><!-- 0..* * This relationship is applicable to the referenced group(s) --></group> </PersonalRelationship>
{"resourceType" : "PersonalRelationship", "id" : "<id>", // 0..1 Logical id of this artifact "meta" : { Meta }, // I 0..1 Metadata about the resource "implicitRules" : "<uri>", // I 0..1 A set of rules under which this content was created "language" : "<code>", // I 0..1 Language of the resource content "text" : { Narrative }, // I 0..1 Text summary of the resource, for human interpretation "contained" : [{ Resource }], // 0..* Contained, inline Resources (Extensions - see JSON page) (Modifier Extensions - see JSON page) "source" : { Reference(Patient|Person|RelatedPerson) }, // 1..1 The individual that is the the source of the relationship "relationshipType" : { CodeableConcept }, // 1..1 The relationship between the source and the target individuals "target" : { Reference(Patient|Person|RelatedPerson) }, // 1..1 The individual that is the the target of the relationship "period" : [{ Period }], // 0..* The period of time during which the relationship is active "confidence" : { CodeableConcept }, // 0..1 The confidence level of this relationship "asserter" : { Reference(Organization|Patient|Practitioner|RelatedPerson) }, // 0..1 Who has asserted the details of the relationship "group" : [{ Reference(Group) }] // 0..* This relationship is applicable to the referenced group(s) }
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:PersonalRelationship; fhir:nodeRole fhir:treeRoot; # if this is the parser root fhir:id [ id ] ; # 0..1 Logical id of this artifact fhir:meta [ Meta ] ; # 0..1 I Metadata about the resource fhir:implicitRules [ uri ] ; # 0..1 I A set of rules under which this content was created fhir:language [ code ] ; # 0..1 I Language of the resource content fhir:text [ Narrative ] ; # 0..1 I Text summary of the resource, for human interpretation fhir:contained ( [ Resource ] ... ) ; # 0..* Contained, inline Resources fhir:extension ( [ Extension ] ... ) ; # 0..* I Additional content defined by implementations fhir:modifierExtension ( [ Extension ] ... ) ; # 0..* I Extensions that cannot be ignored fhir:source [ Reference(Patient|Person|RelatedPerson) ] ; # 1..1 The individual that is the the source of the relationship fhir:relationshipType [ CodeableConcept ] ; # 1..1 The relationship between the source and the target individuals fhir:target [ Reference(Patient|Person|RelatedPerson) ] ; # 1..1 The individual that is the the target of the relationship fhir:period ( [ Period ] ... ) ; # 0..* The period of time during which the relationship is active fhir:confidence [ CodeableConcept ] ; # 0..1 The confidence level of this relationship fhir:asserter [ Reference(Organization|Patient|Practitioner|RelatedPerson) ] ; # 0..1 Who has asserted the details of the relationship fhir:group ( [ Reference(Group) ] ... ) ; # 0..* This relationship is applicable to the referenced group(s) ]
Differential View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
0..* | DomainResource | A relationship between two indiduals Elements defined in Ancestors:id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
![]() ![]() |
Σ | 1..1 | Reference(Patient | RelatedPerson | Person) | The individual that is the the source of the relationship |
![]() ![]() |
Σ | 1..1 | CodeableConcept | The relationship between the source and the target individuals Binding: PersonalRelationshipType (preferred) |
![]() ![]() |
Σ | 1..1 | Reference(Patient | RelatedPerson | Person) | The individual that is the the target of the relationship |
![]() ![]() |
0..* | Period | The period of time during which the relationship is active | |
![]() ![]() |
Σ | 0..1 | CodeableConcept | The confidence level of this relationship Binding Description: (example): Value to be provided |
![]() ![]() |
0..1 | Reference(Patient | RelatedPerson | Practitioner | Organization) | Who has asserted the details of the relationship | |
![]() ![]() |
Σ | 0..* | Reference(Group) | This relationship is applicable to the referenced group(s) |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| PersonalRelationship.relationshipType | Base | preferred | Personal Relationship Type | 📦6.0.0-ballot3 | FHIR Std. |
| PersonalRelationship.confidence | Base | example | Not State | Unknown |
Other representations of resource: CSV, Excel
| Name | Type | Description | Expression |
| patient | reference |
The patient this related person is related to |
PersonalRelationship.source.where(resolve() is Patient) | PersonalRelationship.target.where(resolve() is Patient)
|
| relationship | token |
The personal relationship between the patient and the PersonalRelationship |
PersonalRelationship.relationshipType
|
| source | reference |
The source of the relationship |
PersonalRelationship.source
|
| target | reference |
The target of the relationship |
PersonalRelationship.target
|