Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.
RelatedPerson
The relatedPerson FHIR resource maps to the
Account and Contact
objects in Salesforce, and is connected to the person that person’s related to using the ContactContactRelation__c object.
FHIR V4.0 - Clinical Data Model Mapping
Here’s how the fields defined by FHIR for RelatedPerson map to the fields in Salesforce.
| RelatedPerson Resource | Salesforce Field | Type | Salesforce Cardinality | Notes |
|---|---|---|---|---|
| identifier | Identifier | Object | 0.M | The identifier information for a related person is represented as Identifier records that reference the related person’s person account using their Identifier.ParentRecordId field. |
| active | Account.IsActive | Boolean | 0.1 | N/A |
| patient | ContactContactRelation__c.Contact__c | Lookup: Contact | 1.1 | Though Salesforce can tehnically accommodate patient as a zero-to-many association, it is recommended to align with the FHIR defined one-to-one association. |
| relationship | ContactContactRelation__c.Role__c | Lookup: ReciprocalRole__c | 0.M | While FHIR defines relatedPerson.relationship as a code set bundle, its Salesforce implementation is a reference to ReicprocalRole__c. |
| name | PersonName | Object | 0.M | The name information for a related person is represented as PersonName records that reference the related person’s person account using their PersonName.ParentRecordId field. |
| telecom | ContactPointPhone | Object | 0.M | The telecom information for a related person is represented as ContactPointPhone records that reference the related person’s person account using their ContactPointPhone.ParentId field. |
| gender | Contact.Gender | Picklist | 0.1 | While FHIR defines relatedPerson.gender as a code set, its Salesforce implementation is a picklist. |
| birthDate | Contact.Birthdate | Date | 0.1 | N/A |
| address | ContactPointAddress | Object | 0.M | The address information for a related person is represented as ContactPointAddress records that reference the related person’s person account using their ContactPointAddress.ParentId field. |
| photo | N/A | N/A | N/A | Not supported |
| period | ContactContactRelation__c.StartDate__c | Date | 0.1 | Because Salesforce doesn’t support a native period data type, the relatedPerson.period FHIR resource is flattened to a set of strart and end dates. |
| ContactContactRelation__c.EndDate__c | Date | 0.1 | ||
| communication | PersonLanguage | Object | 0.M | The language information for a related person is represented as PersonLanguage records that reference the related person’s person account using their PersonLanguage.IndividualId field. |
| communication.language | PersonLanguage.Language | Picklist | 0.1 | While FHIR defines relatedPerson.communication.language as a code set bundle, its Salesforce implementation is a picklist. |
| communication.preferred | PersonLanguage.Rank | Double | 0.1 | While FHIR defines relatedPerson.communication.preferred as a boolean, its Salesforce implementation is an integer field that ranks the degree of preference. |