This page is part of the FHIR Specification (v0.05: DSTU 1 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Resource Person - Content

Status: A domain resource developed as an examplar. Not an approved resource. Under consideration by the Patient Admin work group

A person who is involved in the healthcare process.

The resource name as it appears in a RESTful URL is /person/

Resource Content

UML Image

<Person xmlns="http://hl7.org/fhir">
 <id><!-- 1..1 id Master Resource Id, always first in all resources --></id>
 <identifier d?><!-- 0..* HumanId A Human identifier for this person --></identifier>
 <name d?><!-- 0..* HumanName A name associated with the person --></name>
 <address d?><!-- 0..* Address An address for the person --></address>
 <contact d?><!-- 0..* Contact A contact detail for the person --></contact>
 <dob d?><!-- 0..1 dateTime The birth date for the person --></dob>
 <gender d?><!-- 0..1 CodeableConcept Administrative Gender --></gender>
 <religion d?><!-- 0..1 CodeableConcept Religion of the person --></religion>
 <race d?><!-- 0..* CodeableConcept The race of a person --></race>
 <qualification>  <!-- 0..* Qualifications, Accreditations, Certifications -->
  <identifier d?><!-- 0..1 Identifier Identifier for the qualification --></identifier>
  <code d?><!-- 0..1 CodeableConcept A code for the qualification --></code>
  <institution d?><!-- 0..1 Resource(Organization) Who conferred it --></institution>
  <period d?><!-- 0..1 Period When the qualification is valid (date only) --></period>
 </qualification>
 <language>  <!-- 0..* language (with proficiency) -->
  <code><!-- 1..1 code ISO 639-3 code for language --></code>
  <use d?><!-- 0..1 code How well the language is used --></use>
 </language>
 <relatedPerson>  <!-- 0..* Kin, Guardians, Agents, Caregivers -->
  <identifier d?><!-- 0..1 HumanId Identifier for the person --></identifier>
  <role><!-- 1..1 CodeableConcept Type of relationship --></role>
  <name d?><!-- 0..1 HumanName Name of the person --></name>
  <contact d?><!-- 0..* Contact Contact details for the person --></contact>
 </relatedPerson>
 <extension><!-- 0..* Extension  See Extensions  --></extension>
 <text><!-- 1..1 Narrative Text summary of person, for human interpretation --></text>
</Person>

Alternate definitions: Schema/Schematron, RDF (to do), XML, Resource Profile

Terminology Bindings

Person.gender has the definition AdministrativeGender: "The gender of a person used for administrative purposes "
Person.religion has the definition Religion: "The denomination to which a person professes affiliation "
Person.race has the definition Race: "The race of the person". If an appropriate code exists in HL7 v2 table 0200 then it should be used
Person.qualification.code has the definition Qualifications: "Formal qualifications, accreditations, and Certifications acquired by a person "
Person.language.code has the definition Language: "A human language". For example values, see ISO 639-3

Person.language.use has the definition LanguageUse: "How well a person speaks a language". Possible values:

none	The person does not speak the language at all
poor	The person has minimal functional capability in the language
useable	The person can use the language, but may not be full conversant, particularly with regards to health concepts
fluent	The person is fully capable of using the language

Person.relatedPerson.role has the definition PersonRelationship: "The relationship a person has to the subject, including familial, marital, financial, legal, and casual relationships "

Notes:

There are various types of people of interest - patients, employees, etc. Different types of people might come from different service end points.
The administrative gender of the patient is that one that matters for the record. This may match the gendor of birth or the current socially-reported gender.
Qualifications covers both formal education gained in the past, and ongoing certification and accreditation often associated with healthcare providers.
Various jurisdictions define their own qualification and/or codes, and some care about this more than others.
The organization references are all optional, so can be replaced by simple text rather than a full resource reference
A related person can be either reference to another resource using the id, or can provide what is known about the person directly

Search Parameters

Search Parameters for RESTful searches. The standard parameters also apply. See Searching for more information.

n : integer	Starting offset of the first record to return in the search set
count : integer	Number of return records requested. The server is not bound to conform
id : token	The id of the resource
identifier : qtoken	A patient Identifier
name : string	a portion of name in any name part
phonetic : string	a portion of name using some kind of phonetic matching algorithm
contact : qtoken	the value in any kind of contact
address : string	an address in any kind of address/part
gender : qtoken	gender of the person
language : qtoken	language code (irrespective of use value)
related : string	portion of name or id in a related person
dob : date	date equal to the patient's date of birth
dob-before : date	date before or equal to the patient's date of birth
dob-after : date	date after or equal to the patient's date of birth

(See Searching).

This is an old version of FHIR retained for archive purposes. Do not use for anything else
Implementers are welcome to experiment with the content defined here, but should note that the contents are subject to change without prior notice.
© HL7.org 2011 - 2012. FHIR v0.05 generated on Sun, Sep 9, 2012 03:28+1000. License