Clinical Document Architecture
2.0.0-sd - release

Clinical Document Architecture, published by Health Level 7. This guide is not an authorized publication; it is the continuous build for version 2.0.0-sd built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-core-sd/ and changes regularly. See the Directory of published versions

ValueSet: CDARoleClass

Official URL: http://hl7.org/cda/stds/core/ValueSet/CDARoleClass Version: 2.0.0-sd
Draft as of 2024-05-16 Computable Name: CDARoleClass

Represent a Role which is an association or relationship between two entities - the entity that plays the role and the entity that scopes the role. Roles names are derived from the name of the playing entity in that role.

References

Logical Definition (CLD)

  • Include these codes as defined in http://terminology.hl7.org/CodeSystem/v3-RoleClass
    CodeDisplayDefinition
    LIClicensed entityA relationship in which the scoper certifies the player ( e. g. a medical care giver, a medical device or a provider organization) to perform certain activities that fall under the jurisdiction of the scoper (e.g., a health authority licensing healthcare providers, a medical quality authority certifying healthcare professionals).
    NOTnotary public
    PROVhealthcare providerAn Entity (player) that is authorized to provide health care services by some authorizing agency (scoper).
    CONcontactA person or an organization (player) which provides or receives information regarding another entity (scoper). Examples; patient NOK and emergency contacts; guarantor contact; employer contact.
    ECONemergency contactAn entity to be contacted in the event of an emergency.
    NOKnext of kinAn individual designated for notification as the next of kin for a given entity.
    ASSIGNEDassigned entityAn agent role in which the agent is an Entity acting in the employ of an organization. The focus is on functional role on behalf of the organization, unlike the Employee role where the focus is on the 'Human Resources' relationship between the employee and the organization.
    COMPARcommissioning partyAn Entity that is authorized to issue or instantiate permissions, privileges, credentials or other formal/legal authorizations.
    SGNOFFsigning authority or officerThe role of a person (player) who is the officer or signature authority for of a scoping entity, usually an organization (scoper).
    AGNTagentAn entity (player) that acts or is authorized to act on behalf of another entity (scoper).
    GUARDguardianGuardian of a ward
    EMPemployeeA relationship between a person or organization and a person or organization formed for the purpose of exchanging work for compensation. The purpose of the role is to identify the type of relationship the employee has to the employer, rather than the nature of the work actually performed. (Contrast with AssignedEntity.)
    MILmilitary personA role played by a member of a military service. Scoper is the military service (e.g. Army, Navy, Air Force, etc.) or, more specifically, the unit (e.g. Company C, 3rd Battalion, 4th Division, etc.)
    INVSBJInvestigation SubjectAn entity that is the subject of an investigation. This role is scoped by the party responsible for the investigation.
    CASESBJ
    RESBJresearch subject**Definition:**Specifies the administrative functionality within a formal experimental design for which the ResearchSubject role was established.

    **Examples:** Screening - role is used for pre-enrollment evaluation portion of the design; enrolled - role is used for subjects admitted to the experimental portion of the design.
    CITcitizenCitizen of apolitical entity
    COVPTYcovered partyA role class played by a person who receives benefit coverage under the terms of a particular insurance policy. The underwriter of that policy is the scoping entity. The covered party receives coverage because of some contractual or other relationship with the holder of that policy.

    *Discussion:*This reason for coverage is captured in 'Role.code' and a relationship link with type code of indirect authority should be included using the policy holder role as the source, and the covered party role as the target.

    Note that a particular policy may cover several individuals one of whom may be, but need not be, the policy holder. Thus the notion of covered party is a role that is distinct from that of the policy holder.
    CRINVclinical research investigatorA role played by a provider, always a person, who has agency authority from a Clinical Research Sponsor to direct the conduct of a clinical research trial or study on behalf of the sponsor.
    CRSPNSRclinical research sponsorA role played by an entity, usually an organization, that is the sponsor of a clinical research trial or study. The sponsor commissions the study, bears the expenses, is responsible for satisfying all legal requirements concerning subject safety and privacy, and is generally responsible for collection, storage and analysis of the data generated during the trial. No scoper is necessary, as a clinical research sponsor undertakes the role on its own authority and declaration. Clinical research sponsors are usually educational or other research organizations, government agencies or biopharmaceutical companies.
    GUARguarantorA person or organization (player) that serves as a financial guarantor for another person or organization (scoper).
    PATpatientA Role of a LivingSubject (player) as an actual or potential recipient of health care services from a healthcare provider organization (scoper).

    *Usage Note:* Communication about relationships between patients and specific healthcare practitioners (people) is not done via scoper. Instead this is generally done using the CareProvision act. This allows linkage between patient and a particular healthcare practitioner role and also allows description of the type of care involved in the relationship.
    PAYEEpayeeThe role of an organization or individual designated to receive payment for a claim against a particular coverage. The scoping entity is the organization that is the submitter of the invoice in question.
    PAYORinvoice payorThe role of an organization that undertakes to accept claims invoices, assess the coverage or payments due for those invoices and pay to the designated payees for those invoices. This role may be either the underwriter or a third-party organization authorized by the underwriter. The scoping entity is the organization that underwrites the claimed coverage.
    POLHOLDpolicy holderA role played by a person or organization that holds an insurance policy. The underwriter of that policy is the scoping entity.

    *Discussion:*The identifier of the policy is captured in 'Role.id' when the Role is a policy holder.

    A particular policy may cover several individuals one of whom may be, but need not be, the policy holder. Thus the notion of covered party is a role that is distinct from that of the policy holder.
    QUALqualified entityAn entity (player) that has been recognized as having certain training/experience or other characteristics that would make said entity an appropriate performer for a certain activity. The scoper is an organization that educates or qualifies entities.
    SPNSRcoverage sponsorA role played by an entity, usually an organization that is the sponsor of an insurance plan or a health program. A sponsor is the party that is ultimately accountable for the coverage by employment contract or by law. A sponsor can be an employer, union, government agency, or association. Fully insured sponsors establish the terms of the plan and contract with health insurance plans to assume the risk and to administer the plan. Self-insured sponsors delegate coverage administration, but not risk, to third-party administrators. Program sponsors designate services to be covered in accordance with statute. Program sponsors may administer the coverage themselves, delegate coverage administration, but not risk to third-party administrators, or contract with health insurance plans to assume the risk and administrator a program. Sponsors qualify individuals who may become

    1. a policy holder of the plan;
    2. where the sponsor is the policy holder, who may become a subscriber or a dependent to a policy under the plan; or
    3. where the sponsor is a government agency, who may become program eligibles under a program.

    The sponsor role may be further qualified by the SponsorRole.code. Entities playing the sponsor role may also play the role of a Coverage Administrator.

    *Example:* An employer, union, government agency, or association.
    STDstudentA role played by an individual who is a student of a school, which is the scoping entity.
    UNDWRTunderwriterA role played by a person or an organization. It is the party that

    1. accepts fiscal responsibility for insurance plans and the policies created under those plans;
    2. administers and accepts fiscal responsibility for a program that provides coverage for services to eligible individuals; and/or
    3. has the responsibility to assess the merits of each risk and decide a suitable premium for accepting all or part of the risk. If played by an organization, this role may be further specified by an appropriate RoleCode.

    *Example:*

    1. A health insurer;
    2. Medicaid Program;
    3. Lloyd's of London
    CAREGIVERcaregiverA person responsible for the primary care of a patient at home.
    PRSpersonal relationshipLinks two entities with classCode PSN (person) in a personal relationship. The character of the relationship must be defined by a PersonalRelationshipRoleType code. The player and scoper are determined by PersonalRelationshipRoleType code as well.
    DSTdistributed materialA material (player) distributed by a distributor (scoper) who functions between a manufacturer and a buyer or retailer.
    RETretailed materialMaterial (player) sold by a retailer (scoper), who also give advice to prospective buyers.
    MANUmanufactured productScoped by the manufacturer
    THERtherapeutic agentA manufactured material (player) that is used for its therapeutic properties. The manufacturer is the scoper.
    SDLOCservice delivery locationA role played by a place at which services may be provided.
    DSDLOCdedicated service delivery locationA role of a place (player) that is intended to house the provision of services. Scoper is the Entity (typically Organization) that provides these services. This is not synonymous with "ownership."
    ISDLOCincidental service delivery locationA role played by a place at which health care services may be provided without prior designation or authorization.
    ACCESSaccessA role in which the playing entity (material) provides access to another entity. The principal use case is intravenous (or other bodily) access lines that preexist and need to be referred to for medication routing instructions.
    BIRTHPLbirthplaceRelates a place (playing Entity) as the location where a living subject (scoping Entity) was born.
    EXPRexposed entityA role played by an entity that has been exposed to a person or animal suffering a contagious disease, or with a location from which a toxin has been distributed. The player of the role is normally a person or animal, but it is possible that other entity types could become exposed. The role is scoped by the source of the exposure, and it is quite possible for a person playing the role of exposed party to also become the scoper a role played by another person. That is to say, once a person has become infected, it is possible, perhaps likely, for that person to infect others.

    Management of exposures and tracking exposed parties is a key function within public health, and within most public health contexts - exposed parties are known as "contacts."
    HLDheld entityEntity that is currently in the possession of a holder (scoper), who holds, or uses it, usually based on some agreement with the owner.
    HLTHCHRThealth chartThe role of a material (player) that is the physical health chart belonging to an organization (scoper).
    IDENTidentified entityA role in which the scoping entity designates an identifier for a playing entity.
    MNTmaintained entityAn entity (player) that is maintained by another entity (scoper). This is typical role held by durable equipment. The scoper assumes responsibility for proper operation, quality, and safety.
    OWNowned entityAn Entity (player) for which someone (scoper) is granted by law the right to call the material (player) his own. This entitles the scoper to make decisions about the disposition of that material.
    RGPRregulated productA product regulated by some governmentatl orgnization. The role is played by Material and scoped by Organization.

    Rationale: To support an entity clone used to identify the NDC number for a drug product.
    TERRterritory of authorityRelates a place entity (player) as the region over which the scoper (typically an Organization) has certain authority (jurisdiction). For example, the Calgary Regional Health Authority (scoper) has authority over the territory "Region 4 of Alberta" (player) in matters of health.
    WRTEwarranted productA role a product plays when a guarantee is given to the purchaser by the seller (scoping entity) stating that the product is reliable and free from known defects and that the seller will repair or replace defective parts within a given time limit and under certain conditions.
    GENhas generalizationRelates a specialized material concept (player) to its generalization (scoper).
    GRIChas genericA special link between pharmaceuticals indicating that the target (scoper) is a generic for the source (player).
    INSTinstanceAn individual piece of material (player) instantiating a class of material (scoper).
    SUBSsubsumerAn entity that subsumes the identity of another. Used in the context of merging documented entity instances. Both the player and scoper must have the same classCode.

    The use of this code is **deprecated** in favor of the term SUBY which is its inverse and is more ontologically correct.
    SUBYsubsumed byRelates a prevailing record of an Entity (scoper) with another record (player) that it subsumes.

    *Examples:* Show a correct new Person object (scoper) that subsumes one or more duplicate Person objects that had accidentally been created for the same physical person.

    *Constraints:* Both the player and scoper must have the same classCode.
    IACTinactive ingredientAn ingredient which is not considered therapeutically active, e.g., colors, flavors, stabilizers, or preservatives, fillers, or structural components added to an active ingredient in order to facilitate administration of the active ingredient but without being considered therapeutically active. An inactive ingredient need not be biologically inert, e.g., might be active as an allergen or might have a pleasant taste, but is not an essential constituent delivering the therapeutic effect.
    COLRcolor additiveA substance (player) influencing the optical aspect of material (scoper).
    FLVRflavor additiveA substance (player) added to a mixture (scoper) to make it taste a certain way. In food the use is obvious, in pharmaceuticals flavors can hide disgusting taste of the active ingredient (important in pediatric treatments).
    PRSVpreservativeA substance (player) added to a mixture (scoper) to prevent microorganisms (fungi, bacteria) to spoil the mixture.
    STBLstabilizerA stabilizer (player) added to a mixture (scoper) in order to prevent the molecular disintegration of the main substance.
    INGRingredientRelates a component (player) to a mixture (scoper). E.g., Glucose and Water are ingredients of D5W, latex may be an ingredient in a tracheal tube.
    ACTIactive ingredient**Definition:** a therapeutically active ingredient (player) in a mixture (scoper), where the mixture is typically a manufactured pharmaceutical. It is unknown if the quantity of such an ingredient is expressed precisely in terms of the playing ingredient substance, or, if it is specified in terms of a closely related substance (active moiety or reference substance).
    ACTMactive moietyThe molecule or ion that is responsible for the intended pharmacological action of the drug substance, excluding those appended or associated parts of the molecule that make the molecule an ester, salt (including a salt with hydrogen or coordination bonds), or other noncovalent derivative (such as a complex, chelate, or clathrate).

    Examples: heparin-sodium and heparin-potassium have the same active moiety, heparin; the active moiety of morphine-hydrochloride is morphine.
    ADTVadditiveAn ingredient (player) that is added to a base (scoper), that amounts to a minor part of the overall mixture.
    BASEbaseA base ingredient (player) is what comprises the major part of a mixture (scoper). E.g., Water in most i.v. solutions, or Vaseline in salves. Among all ingredients of a material, there should be only one base. A base substance can, in turn, be a mixture.
    LOCElocated entityRelates an entity (player) to a location (scoper) at which it is present in some way. This presence may be limited in time.
    STORstored entityRelates an entity (player) (e.g. a device) to a location (scoper) at which it is normally found or stored when not used.
    SPECspecimenA role played by a material entity that is a specimen for an act. It is scoped by the source of the specimen.
    ALQTaliquotA portion (player) of an original or source specimen (scoper) used for testing or transportation.
    ISLTisolateA microorganism that has been isolated from other microorganisms or a source matrix.
    CONTcontentRelates a material as the content (player) to a container (scoper). Unlike ingredients, the content and a container remain separate (not mixed) and the content can be removed from the container. A content is not part of an empty container.
    MBRmemberA role played by an entity that is a member of a group. The group provides the scope for this role.

    Among other uses, groups as used in insurance (groups of covered individuals) and in scheduling where resources may be grouped for scheduling and logistical purposes.
    PARTpart**Definition:** an association between two Entities where the playing Entity (the part) is a component of the whole (scoper) in the sense of an integral structural component, that is distinct from other parts in the same whole, has a distinct function in the whole, and, as an effect, the full integrity of the whole depends (to some degree) on the presence of this part, even though the part may often be separable from the whole.

    **Discussion:** Part is defined in opposition to (a) ingredient (not separable), (b) content (not a functional component), and (c) member (not functionally distinct from other members).
    ROLroleCorresponds to the Role class

 

Expansion

Expansion based on codesystem RoleClass v3.1.0 (CodeSystem)

This value set contains 72 concepts.

CodeSystemDisplayInactiveDefinition
  LIChttp://terminology.hl7.org/CodeSystem/v3-RoleClasslicensed entity

A relationship in which the scoper certifies the player ( e. g. a medical care giver, a medical device or a provider organization) to perform certain activities that fall under the jurisdiction of the scoper (e.g., a health authority licensing healthcare providers, a medical quality authority certifying healthcare professionals).

  NOThttp://terminology.hl7.org/CodeSystem/v3-RoleClassnotary public
  PROVhttp://terminology.hl7.org/CodeSystem/v3-RoleClasshealthcare provider

An Entity (player) that is authorized to provide health care services by some authorizing agency (scoper).

  CONhttp://terminology.hl7.org/CodeSystem/v3-RoleClasscontact

A person or an organization (player) which provides or receives information regarding another entity (scoper). Examples; patient NOK and emergency contacts; guarantor contact; employer contact.

  ECONhttp://terminology.hl7.org/CodeSystem/v3-RoleClassemergency contact

An entity to be contacted in the event of an emergency.

  NOKhttp://terminology.hl7.org/CodeSystem/v3-RoleClassnext of kin

An individual designated for notification as the next of kin for a given entity.

  ASSIGNEDhttp://terminology.hl7.org/CodeSystem/v3-RoleClassassigned entity

An agent role in which the agent is an Entity acting in the employ of an organization. The focus is on functional role on behalf of the organization, unlike the Employee role where the focus is on the 'Human Resources' relationship between the employee and the organization.

  COMPARhttp://terminology.hl7.org/CodeSystem/v3-RoleClasscommissioning party

An Entity that is authorized to issue or instantiate permissions, privileges, credentials or other formal/legal authorizations.

  SGNOFFhttp://terminology.hl7.org/CodeSystem/v3-RoleClasssigning authority or officer

The role of a person (player) who is the officer or signature authority for of a scoping entity, usually an organization (scoper).

  AGNThttp://terminology.hl7.org/CodeSystem/v3-RoleClassagent

An entity (player) that acts or is authorized to act on behalf of another entity (scoper).

  GUARDhttp://terminology.hl7.org/CodeSystem/v3-RoleClassguardian

Guardian of a ward

  EMPhttp://terminology.hl7.org/CodeSystem/v3-RoleClassemployee

A relationship between a person or organization and a person or organization formed for the purpose of exchanging work for compensation. The purpose of the role is to identify the type of relationship the employee has to the employer, rather than the nature of the work actually performed. (Contrast with AssignedEntity.)

  MILhttp://terminology.hl7.org/CodeSystem/v3-RoleClassmilitary person

A role played by a member of a military service. Scoper is the military service (e.g. Army, Navy, Air Force, etc.) or, more specifically, the unit (e.g. Company C, 3rd Battalion, 4th Division, etc.)

  INVSBJhttp://terminology.hl7.org/CodeSystem/v3-RoleClassInvestigation Subject

An entity that is the subject of an investigation. This role is scoped by the party responsible for the investigation.

  RESBJhttp://terminology.hl7.org/CodeSystem/v3-RoleClassresearch subject

**Definition:**Specifies the administrative functionality within a formal experimental design for which the ResearchSubject role was established.

Examples: Screening - role is used for pre-enrollment evaluation portion of the design; enrolled - role is used for subjects admitted to the experimental portion of the design.

  CIThttp://terminology.hl7.org/CodeSystem/v3-RoleClasscitizen

Citizen of apolitical entity

  COVPTYhttp://terminology.hl7.org/CodeSystem/v3-RoleClasscovered party

A role class played by a person who receives benefit coverage under the terms of a particular insurance policy. The underwriter of that policy is the scoping entity. The covered party receives coverage because of some contractual or other relationship with the holder of that policy.

*Discussion:*This reason for coverage is captured in 'Role.code' and a relationship link with type code of indirect authority should be included using the policy holder role as the source, and the covered party role as the target.

Note that a particular policy may cover several individuals one of whom may be, but need not be, the policy holder. Thus the notion of covered party is a role that is distinct from that of the policy holder.

  CRINVhttp://terminology.hl7.org/CodeSystem/v3-RoleClassclinical research investigator

A role played by a provider, always a person, who has agency authority from a Clinical Research Sponsor to direct the conduct of a clinical research trial or study on behalf of the sponsor.

  CRSPNSRhttp://terminology.hl7.org/CodeSystem/v3-RoleClassclinical research sponsor

A role played by an entity, usually an organization, that is the sponsor of a clinical research trial or study. The sponsor commissions the study, bears the expenses, is responsible for satisfying all legal requirements concerning subject safety and privacy, and is generally responsible for collection, storage and analysis of the data generated during the trial. No scoper is necessary, as a clinical research sponsor undertakes the role on its own authority and declaration. Clinical research sponsors are usually educational or other research organizations, government agencies or biopharmaceutical companies.

  GUARhttp://terminology.hl7.org/CodeSystem/v3-RoleClassguarantor

A person or organization (player) that serves as a financial guarantor for another person or organization (scoper).

  PAThttp://terminology.hl7.org/CodeSystem/v3-RoleClasspatient

A Role of a LivingSubject (player) as an actual or potential recipient of health care services from a healthcare provider organization (scoper).

Usage Note: Communication about relationships between patients and specific healthcare practitioners (people) is not done via scoper. Instead this is generally done using the CareProvision act. This allows linkage between patient and a particular healthcare practitioner role and also allows description of the type of care involved in the relationship.

  PAYEEhttp://terminology.hl7.org/CodeSystem/v3-RoleClasspayee

The role of an organization or individual designated to receive payment for a claim against a particular coverage. The scoping entity is the organization that is the submitter of the invoice in question.

  PAYORhttp://terminology.hl7.org/CodeSystem/v3-RoleClassinvoice payor

The role of an organization that undertakes to accept claims invoices, assess the coverage or payments due for those invoices and pay to the designated payees for those invoices. This role may be either the underwriter or a third-party organization authorized by the underwriter. The scoping entity is the organization that underwrites the claimed coverage.

  POLHOLDhttp://terminology.hl7.org/CodeSystem/v3-RoleClasspolicy holder

A role played by a person or organization that holds an insurance policy. The underwriter of that policy is the scoping entity.

*Discussion:*The identifier of the policy is captured in 'Role.id' when the Role is a policy holder.

A particular policy may cover several individuals one of whom may be, but need not be, the policy holder. Thus the notion of covered party is a role that is distinct from that of the policy holder.

  QUALhttp://terminology.hl7.org/CodeSystem/v3-RoleClassqualified entity

An entity (player) that has been recognized as having certain training/experience or other characteristics that would make said entity an appropriate performer for a certain activity. The scoper is an organization that educates or qualifies entities.

  SPNSRhttp://terminology.hl7.org/CodeSystem/v3-RoleClasscoverage sponsor

A role played by an entity, usually an organization that is the sponsor of an insurance plan or a health program. A sponsor is the party that is ultimately accountable for the coverage by employment contract or by law. A sponsor can be an employer, union, government agency, or association. Fully insured sponsors establish the terms of the plan and contract with health insurance plans to assume the risk and to administer the plan. Self-insured sponsors delegate coverage administration, but not risk, to third-party administrators. Program sponsors designate services to be covered in accordance with statute. Program sponsors may administer the coverage themselves, delegate coverage administration, but not risk to third-party administrators, or contract with health insurance plans to assume the risk and administrator a program. Sponsors qualify individuals who may become

  1. a policy holder of the plan;
  2. where the sponsor is the policy holder, who may become a subscriber or a dependent to a policy under the plan; or
  3. where the sponsor is a government agency, who may become program eligibles under a program.

The sponsor role may be further qualified by the SponsorRole.code. Entities playing the sponsor role may also play the role of a Coverage Administrator.

Example: An employer, union, government agency, or association.

  STDhttp://terminology.hl7.org/CodeSystem/v3-RoleClassstudent

A role played by an individual who is a student of a school, which is the scoping entity.

  UNDWRThttp://terminology.hl7.org/CodeSystem/v3-RoleClassunderwriter

A role played by a person or an organization. It is the party that

  1. accepts fiscal responsibility for insurance plans and the policies created under those plans;
  2. administers and accepts fiscal responsibility for a program that provides coverage for services to eligible individuals; and/or
  3. has the responsibility to assess the merits of each risk and decide a suitable premium for accepting all or part of the risk. If played by an organization, this role may be further specified by an appropriate RoleCode.

Example:

  1. A health insurer;
  2. Medicaid Program;
  3. Lloyd's of London
  CAREGIVERhttp://terminology.hl7.org/CodeSystem/v3-RoleClasscaregiver

A person responsible for the primary care of a patient at home.

  PRShttp://terminology.hl7.org/CodeSystem/v3-RoleClasspersonal relationship

Links two entities with classCode PSN (person) in a personal relationship. The character of the relationship must be defined by a PersonalRelationshipRoleType code. The player and scoper are determined by PersonalRelationshipRoleType code as well.

  DSThttp://terminology.hl7.org/CodeSystem/v3-RoleClassdistributed material

A material (player) distributed by a distributor (scoper) who functions between a manufacturer and a buyer or retailer.

  REThttp://terminology.hl7.org/CodeSystem/v3-RoleClassretailed material

Material (player) sold by a retailer (scoper), who also give advice to prospective buyers.

  MANUhttp://terminology.hl7.org/CodeSystem/v3-RoleClassmanufactured product

Scoped by the manufacturer

  THERhttp://terminology.hl7.org/CodeSystem/v3-RoleClasstherapeutic agent

A manufactured material (player) that is used for its therapeutic properties. The manufacturer is the scoper.

  SDLOChttp://terminology.hl7.org/CodeSystem/v3-RoleClassservice delivery location

A role played by a place at which services may be provided.

  DSDLOChttp://terminology.hl7.org/CodeSystem/v3-RoleClassdedicated service delivery location

A role of a place (player) that is intended to house the provision of services. Scoper is the Entity (typically Organization) that provides these services. This is not synonymous with "ownership."

  ISDLOChttp://terminology.hl7.org/CodeSystem/v3-RoleClassincidental service delivery location

A role played by a place at which health care services may be provided without prior designation or authorization.

  ACCESShttp://terminology.hl7.org/CodeSystem/v3-RoleClassaccess

A role in which the playing entity (material) provides access to another entity. The principal use case is intravenous (or other bodily) access lines that preexist and need to be referred to for medication routing instructions.

  BIRTHPLhttp://terminology.hl7.org/CodeSystem/v3-RoleClassbirthplace

Relates a place (playing Entity) as the location where a living subject (scoping Entity) was born.

  EXPRhttp://terminology.hl7.org/CodeSystem/v3-RoleClassexposed entity

A role played by an entity that has been exposed to a person or animal suffering a contagious disease, or with a location from which a toxin has been distributed. The player of the role is normally a person or animal, but it is possible that other entity types could become exposed. The role is scoped by the source of the exposure, and it is quite possible for a person playing the role of exposed party to also become the scoper a role played by another person. That is to say, once a person has become infected, it is possible, perhaps likely, for that person to infect others.

Management of exposures and tracking exposed parties is a key function within public health, and within most public health contexts - exposed parties are known as "contacts."

  HLDhttp://terminology.hl7.org/CodeSystem/v3-RoleClassheld entity

Entity that is currently in the possession of a holder (scoper), who holds, or uses it, usually based on some agreement with the owner.

  HLTHCHRThttp://terminology.hl7.org/CodeSystem/v3-RoleClasshealth chart

The role of a material (player) that is the physical health chart belonging to an organization (scoper).

  IDENThttp://terminology.hl7.org/CodeSystem/v3-RoleClassidentified entity

A role in which the scoping entity designates an identifier for a playing entity.

  MNThttp://terminology.hl7.org/CodeSystem/v3-RoleClassmaintained entity

An entity (player) that is maintained by another entity (scoper). This is typical role held by durable equipment. The scoper assumes responsibility for proper operation, quality, and safety.

  OWNhttp://terminology.hl7.org/CodeSystem/v3-RoleClassowned entity

An Entity (player) for which someone (scoper) is granted by law the right to call the material (player) his own. This entitles the scoper to make decisions about the disposition of that material.

  RGPRhttp://terminology.hl7.org/CodeSystem/v3-RoleClassregulated product

A product regulated by some governmentatl orgnization. The role is played by Material and scoped by Organization.

Rationale: To support an entity clone used to identify the NDC number for a drug product.

  TERRhttp://terminology.hl7.org/CodeSystem/v3-RoleClassterritory of authority

Relates a place entity (player) as the region over which the scoper (typically an Organization) has certain authority (jurisdiction). For example, the Calgary Regional Health Authority (scoper) has authority over the territory "Region 4 of Alberta" (player) in matters of health.

  WRTEhttp://terminology.hl7.org/CodeSystem/v3-RoleClasswarranted product

A role a product plays when a guarantee is given to the purchaser by the seller (scoping entity) stating that the product is reliable and free from known defects and that the seller will repair or replace defective parts within a given time limit and under certain conditions.

  GENhttp://terminology.hl7.org/CodeSystem/v3-RoleClasshas generalization

Relates a specialized material concept (player) to its generalization (scoper).

  GRIChttp://terminology.hl7.org/CodeSystem/v3-RoleClasshas generic

A special link between pharmaceuticals indicating that the target (scoper) is a generic for the source (player).

  INSThttp://terminology.hl7.org/CodeSystem/v3-RoleClassinstance

An individual piece of material (player) instantiating a class of material (scoper).

  SUBShttp://terminology.hl7.org/CodeSystem/v3-RoleClasssubsumerinactive

An entity that subsumes the identity of another. Used in the context of merging documented entity instances. Both the player and scoper must have the same classCode.

The use of this code is deprecated in favor of the term SUBY which is its inverse and is more ontologically correct.

  SUBYhttp://terminology.hl7.org/CodeSystem/v3-RoleClasssubsumed by

Relates a prevailing record of an Entity (scoper) with another record (player) that it subsumes.

Examples: Show a correct new Person object (scoper) that subsumes one or more duplicate Person objects that had accidentally been created for the same physical person.

Constraints: Both the player and scoper must have the same classCode.

  IACThttp://terminology.hl7.org/CodeSystem/v3-RoleClassinactive ingredient

An ingredient which is not considered therapeutically active, e.g., colors, flavors, stabilizers, or preservatives, fillers, or structural components added to an active ingredient in order to facilitate administration of the active ingredient but without being considered therapeutically active. An inactive ingredient need not be biologically inert, e.g., might be active as an allergen or might have a pleasant taste, but is not an essential constituent delivering the therapeutic effect.

  COLRhttp://terminology.hl7.org/CodeSystem/v3-RoleClasscolor additive

A substance (player) influencing the optical aspect of material (scoper).

  FLVRhttp://terminology.hl7.org/CodeSystem/v3-RoleClassflavor additive

A substance (player) added to a mixture (scoper) to make it taste a certain way. In food the use is obvious, in pharmaceuticals flavors can hide disgusting taste of the active ingredient (important in pediatric treatments).

  PRSVhttp://terminology.hl7.org/CodeSystem/v3-RoleClasspreservative

A substance (player) added to a mixture (scoper) to prevent microorganisms (fungi, bacteria) to spoil the mixture.

  STBLhttp://terminology.hl7.org/CodeSystem/v3-RoleClassstabilizer

A stabilizer (player) added to a mixture (scoper) in order to prevent the molecular disintegration of the main substance.

  INGRhttp://terminology.hl7.org/CodeSystem/v3-RoleClassingredient

Relates a component (player) to a mixture (scoper). E.g., Glucose and Water are ingredients of D5W, latex may be an ingredient in a tracheal tube.

  ACTIhttp://terminology.hl7.org/CodeSystem/v3-RoleClassactive ingredient

Definition: a therapeutically active ingredient (player) in a mixture (scoper), where the mixture is typically a manufactured pharmaceutical. It is unknown if the quantity of such an ingredient is expressed precisely in terms of the playing ingredient substance, or, if it is specified in terms of a closely related substance (active moiety or reference substance).

  ACTMhttp://terminology.hl7.org/CodeSystem/v3-RoleClassactive moiety

The molecule or ion that is responsible for the intended pharmacological action of the drug substance, excluding those appended or associated parts of the molecule that make the molecule an ester, salt (including a salt with hydrogen or coordination bonds), or other noncovalent derivative (such as a complex, chelate, or clathrate).

Examples: heparin-sodium and heparin-potassium have the same active moiety, heparin; the active moiety of morphine-hydrochloride is morphine.

  ADTVhttp://terminology.hl7.org/CodeSystem/v3-RoleClassadditive

An ingredient (player) that is added to a base (scoper), that amounts to a minor part of the overall mixture.

  BASEhttp://terminology.hl7.org/CodeSystem/v3-RoleClassbase

A base ingredient (player) is what comprises the major part of a mixture (scoper). E.g., Water in most i.v. solutions, or Vaseline in salves. Among all ingredients of a material, there should be only one base. A base substance can, in turn, be a mixture.

  LOCEhttp://terminology.hl7.org/CodeSystem/v3-RoleClasslocated entity

Relates an entity (player) to a location (scoper) at which it is present in some way. This presence may be limited in time.

  STORhttp://terminology.hl7.org/CodeSystem/v3-RoleClassstored entity

Relates an entity (player) (e.g. a device) to a location (scoper) at which it is normally found or stored when not used.

  SPEChttp://terminology.hl7.org/CodeSystem/v3-RoleClassspecimen

A role played by a material entity that is a specimen for an act. It is scoped by the source of the specimen.

  ALQThttp://terminology.hl7.org/CodeSystem/v3-RoleClassaliquot

A portion (player) of an original or source specimen (scoper) used for testing or transportation.

  ISLThttp://terminology.hl7.org/CodeSystem/v3-RoleClassisolate

A microorganism that has been isolated from other microorganisms or a source matrix.

  CONThttp://terminology.hl7.org/CodeSystem/v3-RoleClasscontent

Relates a material as the content (player) to a container (scoper). Unlike ingredients, the content and a container remain separate (not mixed) and the content can be removed from the container. A content is not part of an empty container.

  MBRhttp://terminology.hl7.org/CodeSystem/v3-RoleClassmember

A role played by an entity that is a member of a group. The group provides the scope for this role.

Among other uses, groups as used in insurance (groups of covered individuals) and in scheduling where resources may be grouped for scheduling and logistical purposes.

  PARThttp://terminology.hl7.org/CodeSystem/v3-RoleClasspart

Definition: an association between two Entities where the playing Entity (the part) is a component of the whole (scoper) in the sense of an integral structural component, that is distinct from other parts in the same whole, has a distinct function in the whole, and, as an effect, the full integrity of the whole depends (to some degree) on the presence of this part, even though the part may often be separable from the whole.

Discussion: Part is defined in opposition to (a) ingredient (not separable), (b) content (not a functional component), and (c) member (not functionally distinct from other members).

  ROLhttp://terminology.hl7.org/CodeSystem/v3-RoleClassrole

Corresponds to the Role class


Explanation of the columns that may appear on this page:

Level A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies
System The source of the definition of the code (when the value set draws in codes defined elsewhere)
Code The code (used as the code in the resource instance)
Display The display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application
Definition An explanation of the meaning of the concept
Comments Additional notes about how to use the code