HL7 Terminology (THO)
6.1.0 - Continuous Process Integration (ci build) International flag

HL7 Terminology (THO), published by HL7 International - Vocabulary Work Group. This guide is not an authorized publication; it is the continuous build for version 6.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/UTG/ and changes regularly. See the Directory of published versions

CodeSystem: ActMood

Official URL: http://terminology.hl7.org/CodeSystem/v3-ActMood Version: 3.0.0
Active as of 2023-05-30 Responsible: Health Level Seven International Computable Name: ActMood
Other Identifiers: OID:2.16.840.1.113883.5.1001

Copyright/Legal: 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.html

OpenIssue: In Ballot 2009May, a strong Negative vote was lodged against several of the concept definitions in the vocabulary used for Act.moodCode. The vote was found "Persuasive With Mod", with the understanding that M and M would undertake a detailed review of these concept definitions for a future release of the RIM.

This Code system is referenced in the content logical definition of the following value sets:

Generated Narrative: CodeSystem v3-ActMood

Language: en

Properties

This code system defines the following properties for its concepts

NameCodeURITypeDescription
Specializes Specializes Coding The child code is a more narrow version of the concept represented by the parent code. I.e. Every child concept is also a valid parent concept. Used to allow determination of subsumption. Must be transitive, irreflexive, antisymmetric.
Generalizes Generalizes Coding Inverse of Specializes. Only included as a derived relationship.
internalId internalId http://terminology.hl7.org/CodeSystem/utg-concept-properties#v3-internal-id code The internal identifier for the concept in the HL7 Access database repository.
Status status http://hl7.org/fhir/concept-properties#status code A property that indicates the status of the concept. One of active, experimental, deprecated, or retired.
Deprecation Date deprecationDate http://hl7.org/fhir/concept-properties#deprecationDate dateTime The date at which a concept was deprecated. Concepts that are deprecated but not inactive can still be used, but their use is discouraged.
Name:Class Name:Class http://terminology.hl7.org/CodeSystem/utg-concept-properties#rim-Class code The formal name for the class clone under this code
Not Selectable notSelectable http://hl7.org/fhir/concept-properties#notSelectable boolean Indicates that the code is abstract - only intended to be used as a selector for other concepts
Synonym synonymCode http://hl7.org/fhir/concept-properties#synonym code An additional concept code that was also attributed to a concept
HL7 Concept Usage Notes HL7usageNotes http://terminology.hl7.org/CodeSystem/utg-concept-properties#HL7usageNotes string HL7 Concept Usage Notes

Concepts

This case-sensitive code system http://terminology.hl7.org/CodeSystem/v3-ActMood defines the following codes in a Is-A hierarchy:

LvlCodeDisplayDefinitionDeprecatedinternalIdStatusDeprecation DateName:ClassNot SelectableSynonymHL7 Concept Usage Notes
1 _ActMoodCompletionTrack ActMoodCompletionTrack

These are moods describing activities as they progress in the business cycle, from defined, through planned and ordered to completed.

20935 active Process true
2   _ActMoodPotential potential

Definition: A possible act.

23087 active Potential true
3     DEF definition

Definition: A definition of a kind of act that can occur .

OpenIssue: The semantic constructs embodied in DEF and CRT moods seem indistinguishable, and their uses can readily be determined by the context in which these are used. Therefore, this OpenIssue has been created to declare that it is likely that ActMood.DEF will be "retired" in the future in favor of the more general ActMood.CRT.

10198 active Definition
3     PERM permission

Definition: A kind of act that defines a permission that has been granted.

21381 active Permission
3     SLOT resource slot

Definition: A kind of act that may occur during the specified time period.

19168 active ResourceSlot
2   EVN event (occurrence)

Definition: An act that actually happens (may be an ongoing act or a documentation of a past act).

10201 active Event
2   INT intent

Definition: An intention or plan for an act.

>UsageNotes: The final outcome of the intent, the act that is intended to occur, is always an event. However the final outcome may be reached indirectly via steps through other intents, such as promise, permission request, or an appointment that may lead to an actual event to occur. Alternatively, the intended act may never occur.

10199 active Intent
3     _ActMoodDesire desire

Definition: A desire to have an act occur.

23088 active Desire true
4       _ActMoodActRequest act request

Definition: A request (or order) for an act that is part of a defined request/fulfillment cycle.

UsageNotes: Use of an HL7 defined request/fulfillment framework is not required to use this mood code.

23089 active ActRequest true Use of an HL7 defined request/fulfillment framework is not required to use this mood code.
5         ARQ appointment request

Definition: A request act that is specialized for the appointment scheduling request/fulfillment cycle. An appointment request is fulfilled only and completely by an appointment (APT), i.e., all that the appointment request intends is to create an appointment (the actual act may well not happen if that is the professional decision during the appointment).

11625 active AppointmentRequest
5         PERMRQ permission request

Definition: A request for a permission to perform the act. Typically a payer (or possibly a supervisor) is being requested to give permission to perform the act. As opposed to the RQO, the requestee is not asked to perform or cause to perform the act but only to give the permission.

21382 active PermissionRequest
5         RQO request

Definition: A request act that is specialized for an event request/fulfillment cycle.

UsageNotes: The fulfillment cycle may involve intermediary fulfilling acts in moods such as PRMS, APT, or even another RQO before being fulfilled by the final event.

UsageNotes: The concepts of a "request" and an "order" are viewed as different, because there is an implication of a mandate associated with order. In practice, however, this distinction has no general functional value in the inter-operation of health care computing. "Orders" are commonly refused for a variety of clinical and business reasons, and the notion of a "request" obligates the recipient (the fulfiller) to respond to the sender (the author). Indeed, in many regions, including Australia and Europe, the common term used is "request."

Thus, the concept embodies both notions, as there is no useful distinction to be made. If a mandate is to be associated with a request, this will be embodied in the "local" business rules applied to the transactions. Should HL7 desire to provide a distinction between these in the future, the individual concepts could be added as specializations of this concept.

The critical distinction here, is the difference between this concept and an "intent", of which it is a specialization. An intent involves decisions by a single party, the author. A request, however, involves decisions by two parties, the author and the fulfiller, with an obligation on the part of the fulfiller to respond to the request indicating that the fulfiller will indeed fulfill the request.

19973 active Request ORD The concepts of a "request" and an "order" are viewed as different, because there is an implication of a mandate associated with order. In practice, however, this distinction has no general functional value in the inter-operation of health care computing. "Orders" are commonly refused for a variety of clinical and business reasons, and the notion of a "request" obligates the recipient (the fulfiller) to respond to the sender (the author). Indeed, in many regions, including Australia and Europe, the common term used is "request." Thus, the concept embodies both notions, as there is no useful distinction to be made. If a mandate is to be associated with a request, this will be embodied in the "local" business rules applied to the transactions. Should HL7 desire to provide a distinction between these in the future, the individual concepts could be added as specializations of this concept. The critical distinction here, is the difference between this concept and an "intent", of which it is a specialization. An intent involves decisions by a single party, the author. A request, however, involves decisions by two parties, the author and the fulfiller, with an obligation on the part of the fulfiller to respond to the request indicating that the fulfiller will indeed fulfill the request.
5         ORD request

Definition: A request act that is specialized for an event request/fulfillment cycle.

UsageNotes: The fulfillment cycle may involve intermediary fulfilling acts in moods such as PRMS, APT, or even another RQO before being fulfilled by the final event.

UsageNotes: The concepts of a "request" and an "order" are viewed as different, because there is an implication of a mandate associated with order. In practice, however, this distinction has no general functional value in the inter-operation of health care computing. "Orders" are commonly refused for a variety of clinical and business reasons, and the notion of a "request" obligates the recipient (the fulfiller) to respond to the sender (the author). Indeed, in many regions, including Australia and Europe, the common term used is "request."

Thus, the concept embodies both notions, as there is no useful distinction to be made. If a mandate is to be associated with a request, this will be embodied in the "local" business rules applied to the transactions. Should HL7 desire to provide a distinction between these in the future, the individual concepts could be added as specializations of this concept.

The critical distinction here, is the difference between this concept and an "intent", of which it is a specialization. An intent involves decisions by a single party, the author. A request, however, involves decisions by two parties, the author and the fulfiller, with an obligation on the part of the fulfiller to respond to the request indicating that the fulfiller will indeed fulfill the request.

19973 retired Request RQO The concepts of a "request" and an "order" are viewed as different, because there is an implication of a mandate associated with order. In practice, however, this distinction has no general functional value in the inter-operation of health care computing. "Orders" are commonly refused for a variety of clinical and business reasons, and the notion of a "request" obligates the recipient (the fulfiller) to respond to the sender (the author). Indeed, in many regions, including Australia and Europe, the common term used is "request." Thus, the concept embodies both notions, as there is no useful distinction to be made. If a mandate is to be associated with a request, this will be embodied in the "local" business rules applied to the transactions. Should HL7 desire to provide a distinction between these in the future, the individual concepts could be added as specializations of this concept. The critical distinction here, is the difference between this concept and an "intent", of which it is a specialization. An intent involves decisions by a single party, the author. A request, however, involves decisions by two parties, the author and the fulfiller, with an obligation on the part of the fulfiller to respond to the request indicating that the fulfiller will indeed fulfill the request.
4       PRP proposal

Definition: A suggestion that an act might be performed. Not an explicit request, and professional responsibility may or may not be present.

16726 active Proposal
5         RMD recommendation

Definition: A suggestion that an act should be performed with an acceptance of some degree of professional responsibility for the resulting act. Not an explicit request. .

UsageNotes: Where there is no clear definition or applicable concept of "professional responsibility", RMD becomes indistinguishable from PRP. .

21571 active Recommendation Where there is no clear definition or applicable concept of "professional responsibility", RMD becomes indistinguishable from PRP. .
3     PRMS promise

Definition: A commitment to perform an act (may be either solicited or unsolicited). The committer becomes responsible to the other party for executing the act, and, as a consequence, the other party may rely on the first party to perform or cause to perform the act.

UsageNotes: Commitments may be retracted or cancelled.

16728 active Promise Commitments may be retracted or cancelled.
4       APT appointment

Definition: An act that has been scheduled to be performed at a specific place and time.

11626 active Appointment
1 _ActMoodPredicate ActMoodPredicate

Definition: An act that expresses condition statements for other acts.

20936 active Predicate true
2   CRT criterion

Deprecation Comment: This concept This codes should no longer be used. Instead, set attribute Act.isCriterionInd to "true" and use the desired mood for your criterion.

Definition: A condition that must be true for the source act to be considered.

Deprecated 22042 deprecated 2010-07-12 Criterion
3     EVN.CRT event criterion

Deprecation Comment: This concept This codes should no longer be used. Instead, set attribute Act.isCriterionInd to "true" and use the desired mood for your criterion.

Definition: A criterion (CRT) that has_match = an event (EVN).

Deprecated 10203 deprecated 2010-07-12 EventCriterion
3     GOL.CRT goal criterion

A criterion expressed over goals (ActMood.GOL).

23057 retired
3     INT.CRT intent criterion

A criterion expressed over intents (ActMood.INT).

23054 retired
4       PRMS.CRT promise criterion

A criterion expressed over promises (ActMood.PRMS).

23056 retired
4       RQO.CRT request criterion

A criterion expressed over requests or orders (ActMood.RQO).

23055 retired
3     RSK.CRT risk criterion

A criterion expressed over risks (ActMood.RSK).

23058 retired
2   EXPEC expectation

Definition: An act that is considered to have some noteworthy likelihood of occurring in the future (has_match = event).

**Examples:**Prognosis of a condition, Expected date of discharge from hospital, patient will likely need an emergency decompression of the intracranial pressure by morning.

**UsageNotes:**INT (intent) reflects a plan for the future, which is a declaration to do something. This contrasts with expectation, which is a prediction that something will happen in the future. GOL (goal) reflects a hope rather than a prediction. RSK (risk) reflects a potential negative event that may or may not be expected to happen.

21574 active Expectation INT (intent) reflects a plan for the future, which is a declaration to do something. This contrasts with expectation, which is a prediction that something will happen in the future. GOL (goal) reflects a hope rather than a prediction. RSK (risk) reflects a potential negative event that may or may not be expected to happen.
3     GOL Goal

Definition: An expectation that is considered to be desirable to occur in the future

**Examples:**Target weight below 80Kg, Stop smoking, Regain ability to walk, goal is to administer thrombolytics to candidate patients presenting with acute myocardial infarction.

UsageNotes: INT (intent) reflects a plan for the future, which is a declaration to do something. This contrasts with goal which doesn't represent an intention to act, merely a hope for an eventual result. A goal is distinct from the intended actions to reach that goal. "I will reduce the dose of drug x to 20mg" is an intent. "I hope to be able to get the patient to the point where I can reduce the dose of drug x to 20mg" is a goal. EXPEC (expectation) reflects a prediction rather than a hope. RSK (risk) reflects a potential negative event rather than a hope.

18864 active Goal INT (intent) reflects a plan for the future, which is a declaration to do something. This contrasts with goal which doesn't represent an intention to act, merely a hope for an eventual result. A goal is distinct from the intended actions to reach that goal. "I will reduce the dose of drug x to 20mg" is an intent. "I hope to be able to get the patient to the point where I can reduce the dose of drug x to 20mg" is a goal. EXPEC (expectation) reflects a prediction rather than a hope. RSK (risk) reflects a potential negative event rather than a hope.
3     RSK risk

**Definition:**An act that may occur in the future and which is regarded as undesirable

**Examples:**Increased risk of DVT, at risk for sub-acute bacterial endocarditis.

**UsageNotes:**Note: An observation in RSK mood expresses the undesirable act, and not the underlying risk factor. A risk factor that is present (e.g. obesity, smoking, etc) should be expressed in event mood. INT (intent) reflects a plan for the future, which is a declaration to do something. This contrasts with RSK (risk), which is the potential that something negative will occur that may or may not ever happen. GOL (goal) reflects a hope to achieve something. EXPEC (expectation) is the prediction of a positive or negative event. This contrasts with RSK (risk), which is the potential that something negative will occur that may or may not ever happen, and may not be expected to happen.

21575 active Risk Note: An observation in RSK mood expresses the undesirable act, and not the underlying risk factor. A risk factor that is present (e.g. obesity, smoking, etc) should be expressed in event mood. INT (intent) reflects a plan for the future, which is a declaration to do something. This contrasts with RSK (risk), which is the potential that something negative will occur that may or may not ever happen. GOL (goal) reflects a hope to achieve something. EXPEC (expectation) is the prediction of a positive or negative event. This contrasts with RSK (risk), which is the potential that something negative will occur that may or may not ever happen, and may not be expected to happen.
2   OPT option

Definition: One of a set of acts that specify an option for the property values that the parent act may have. Typically used in definitions or orders to describe alternatives. An option can only be used as a group, that is, all assigned values must be used together. The actual mood of the act is the same as the parent act, and they must be linked by an actrelationship with type = OPTN.

10204 active Option

History

DateActionAuthorCustodianComment
2023-11-14reviseMarc DuteauTSMGAdd standard copyright and contact to internal content; up-476
2022-10-18reviseMarc DuteauTSMGFixing missing metadata; up-349
2022-02-17 00:00:32+1100reviseGrahame GrieveVocabulary WGPopulate Missing caseSensitive property; UP-286
2020-05-06reviseTed KleinVocabulary WGMigrated to the UTG maintenance environment and publishing tooling.