# text.div
Generated Narrative: CodeSystem object-role

Last updated: 2025-05-13 00:00:00+0000; Language: en

This case-sensitive code system http://terminology.hl7.org/CodeSystem/object-role defines the following codes:

Code | Display | Definition
1 | Patient | This object is the patient that is the subject of care related to this event. It is identifiable by patient ID or equivalent. The patient may be either human or animal.
2 | Location | This is a location identified as related to the event. This is usually the location where the event took place. Note that for shipping, the usual events are arrival at a location or departure from a location.
3 | Report | This object is any kind of persistent document created as a result of the event. This could be a paper report, film, electronic report, DICOM Study, etc. Issues related to medical records life cycle management are conveyed elsewhere.
4 | Domain Resource | A logical object related to a health record event. This is any healthcare specific resource (object) not restricted to FHIR defined Resources.
5 | Master file | This is any configurable file used to control creation of documents. Examples include the objects maintained by the HL7 Master File transactions, Value Sets, etc.
6 | User | A human participant not otherwise identified by some other category.
7 | List | (deprecated).
8 | Doctor | Typically, a licensed person who is providing or performing care related to the event, generally a physician. The key distinction between doctor and practitioner is with regards to their role, not the licensing. The doctor is the human who actually performed the work. The practitioner is the human or organization that is responsible for the work.
9 | Subscriber | A person or system that is being notified as part of the event. This is relevant in situations where automated systems provide notifications to other parties when an event took place.
10 | Guarantor | Insurance company, or any other organization who accepts responsibility for paying for the healthcare event.
11 | Security User Entity | A person or active system object involved in the event with a security role.
12 | Security User Group | A person or system object involved in the event with the authority to modify security roles of other objects.
13 | Security Resource | A passive object, such as a role table, that is relevant to the event.
14 | Security Granularity Definition | (deprecated) Relevant to certain RBAC security methodologies.
15 | Practitioner | Any person or organization responsible for providing care. This encompasses all forms of care, licensed or otherwise, and all sorts of teams and care groups. Note the distinction between practitioner and the doctor that actually provided the care to the patient.
16 | Data Destination | The source or destination for data transfer, when it does not match some other role.
17 | Data Repository | A source or destination for data transfer that acts as an archive, database, or similar role.
18 | Schedule | An object that holds schedule information. This could be an appointment book, availability information, etc.
19 | Customer | An organization or person that is the recipient of services. This could be an organization that is buying services for a patient, or a person that is buying services for an animal.
20 | Job | An order, task, work item, procedure step, or other description of work to be performed; e.g. a particular instance of an MPPS.
21 | Job Stream | A list of jobs or a system that provides lists of jobs; e.g. an MWL SCP.
22 | Table | (Deprecated).
23 | Routing Criteria | An object that specifies or controls the routing or delivery of items. For example, a distribution list is the routing criteria for mail. The items delivered may be documents, jobs, or other objects.
24 | Query | The contents of a query. This is used to capture the contents of any kind of query. For security surveillance purposes knowing the queries being made is very important.
25 | Data Source | The source or origin of data, when there is no other matching role available
26 | Processing Element | A data processing element that creates, analyzes, modifies, or manipulates data as part of this event.

# description
Code representing the role the entity played in the audit event.

# copyright
This material derives from the HL7 Terminology (THO). THO is copyright ©1989+ Health Level Seven International and is made available under the CC0 designation. For more licensing information see: https://terminology.hl7.org/license

# concept[].definition
This object is the patient that is the subject of care related to this event.  It is identifiable by patient ID or equivalent.  The patient may be either human or animal.

# concept[].definition
This is a location identified as related to the event.  This is usually the location where the event took place.  Note that for shipping, the usual events are arrival at a location or departure from a location.

# concept[].definition
This object is any kind of persistent document created as a result of the event.  This could be a paper report, film, electronic report, DICOM Study, etc.  Issues related to medical records life cycle management are conveyed elsewhere.

# concept[].definition
A logical object related to a health record event.  This is any healthcare  specific resource (object) not restricted to FHIR defined Resources.

# concept[].definition
This is any configurable file used to control creation of documents.  Examples include the objects maintained by the HL7 Master File transactions, Value Sets, etc.

# concept[].definition
A human participant not otherwise identified by some other category.

# concept[].definition
Typically, a licensed person who is providing or performing care related to the event, generally a physician.   The key distinction between doctor and practitioner is with regards to their role, not the licensing.  The doctor is the human who actually performed the work.  The practitioner is the human or organization that is responsible for the work.

# concept[].definition
A person or system that is being notified as part of the event.  This is relevant in situations where automated systems provide notifications to other parties when an event took place.

# concept[].definition
Insurance company, or any other organization who accepts responsibility for paying for the healthcare event.

# concept[].definition
A person or active system object involved in the event with a security role.

# concept[].definition
A person or system object involved in the event with the authority to modify security roles of other objects.

# concept[].definition
A passive object, such as a role table, that is relevant to the event.

# concept[].definition
(deprecated)  Relevant to certain RBAC security methodologies.

# concept[].definition
Any person or organization responsible for providing care.  This encompasses all forms of care, licensed or otherwise, and all sorts of teams and care groups. Note the distinction between practitioner and the doctor that actually provided the care to the patient.

# concept[].definition
The source or destination for data transfer, when it does not match some other role.

# concept[].definition
A source or destination for data transfer that acts as an archive, database, or similar role.

# concept[].definition
An object that holds schedule information.  This could be an appointment book, availability information, etc.

# concept[].definition
An organization or person that is the recipient of services.  This could be an organization that is buying services for a patient, or a person that is buying services for an animal.

# concept[].definition
An order, task, work item, procedure step, or other description of work to be performed; e.g. a particular instance of an MPPS.

# concept[].definition
A list of jobs or a system that provides lists of jobs; e.g. an MWL SCP.

# concept[].definition
An object that specifies or controls the routing or delivery of items.  For example, a distribution list is the routing criteria for mail.  The items delivered may be documents, jobs, or other objects.

# concept[].definition
The contents of a query.  This is used to capture the contents of any kind of query.  For security surveillance purposes knowing the queries being made is very important.

# concept[].definition
The source or origin of data, when there is no other matching role available

# concept[].definition
A data processing element that creates, analyzes, modifies, or manipulates data as part of this event.