: Public Class
Created: 8/6/2009 2:13:40 PM
Modified: 8/23/2019 9:52:37 PM
Project:
Advanced:
DEFINITION:<br/>A relationship between an activity and some criteria to determine if the activity should occur where all activities are part of the global library of activities.<br/><br/>EXAMPLE(S):<br/>Only perform a certain lab test if drug X was administered. (target = another activity)<br/><br/>Only perform a substance administration of drug X if the blood pressure was over some threshold number. (target = observation result from another activity that is an observation)<br/><br/>Only perform a substance administration of drug Y if the blood pressure was over some threshold number and either the result of a certain lab test was positive or the subject's temperature was elevated, i.e. "(A and (B or C))".<br/><br/>OTHER NAME(S):<br/><br/>NOTE(S):<br/>The criteria to evaluate the relationship could be one of the following:<br/>- the outcome of another activity where the source activity does not occur unless the target activity outcome has occurred <br/>- another activity where the source activity does not occur unless the target activity has occurred<br/>- a group of other criteria that may be composed of a mix of other activities, observation results and/or other groups.<br/><br/>To evaluate whether the contingency was satisfied, the simple existence of a PerformedActivity (or subclass) related to the DefinedActivity (or subclass) is not enough by itself.  The PerformedActivity.statusCode and PerformedActivity.negationIndicator must also be checked to ensure that the activity was actually performed. PerformedActivity.statusCode must be "Completed" and PerformedActivity.negationIndicator must not be "true".<br/>
Attribute
Public REAL
  priorityNumber
Details:
Map:HL7SDr1=Precondition3.priorityNumber
Notes: DEFINITION:<br/>A number specifying the relative preference for considering this relationship before other like-typed relationships having the same source activity.<br/><br/>EXAMPLE(S):<br/><br/>OTHER NAME(S):<br/><br/>NOTE(S):<br/>Relationships with lower priorityNumber values are considered before and above those with higher values. <br/><br/>The ordering may be a total ordering, in which all priority number are unique, or a partial ordering, in which the same priority may be assigned to more than one relationship. Decimal numbers may be used to insert values between existing priority numbers.<br/><br/>For multiple criteria, this specifies which criteria are considered before others. <br/><br/>Among alternatives or options that are being chosen by humans, the priorityNumber specifies preference.<br/>
Public URG<PQ.TIME>
  pauseQuantityRange
Details:
Map:Lab=Activity.plannedTimeElapsed
Notes: DEFINITION:<br/>A quantity of time falling within minimum and maximum bounds that specifies the elapsed time between when an activity is ready for execution and the actual beginning of the execution.<br/><br/>EXAMPLE(S):<br/>If drug X was administered, perform lab test Y 1 hour afterwards (contingency target = another activity) – the pauseQuantityRange is 1 hour (minimum and maximum bounds of the range are the same)<br/><br/>Only perform a substance administration of drug X within 10 minutes if the blood pressure was over some threshold number (target = observation result from another activity that is an observation) – the pauseQuantityRange is 0-10 minutes<br/><br/>Only perform a substance administration of drug Y within 10 minutes if the blood pressure was over some threshold number AND either the result of a certain lab test was positive or the subject's temperature was elevated (target = group of criteria, i.e. "(A and (B or C))" – the pauseQuantityRange is 0-10 minutes<br/><br/>OTHER NAME(S):<br/><br/>NOTE(S):<br/>The pauseQuantityRange defines the amount of time between two points in time: (1) the point when all preceding steps (in sequence) and preconditions of an activity have been completed, and (2) the actual start of the activity. The completion of all pre-conditions and preceding steps (based on sequence number) indicates that an activity is "ready for execution" according to the definition above. The pauseQuantityRange counter or timeclock starts then, and when the full amount of time is reached, the activity begins. A pauseQuantityRange with a negative value means that the activity starts some amount of time prior to the estimated time that the activity is "ready for execution", i.e. prior to the estimated time that the pre-conditions and preceding steps will be completed.<br/>
Public CD
  checkpointCode
Details:
Map:HL7SDr1=Precondition3.checkpointCode
Notes: DEFINITION:<br/>A coded value spedifying the points in the course of an activity when a precondition for the activity is evaluated.<br/><br/>EXAMPLE(S)<br/>When the checkpointCode for a criterion of a repeatable activity is "end," the criterion is tested only at the end of each repetition of that activity. When the condition holds true, the next repetition is ready for execution.<br/><br/>When the checkpointCode is "entry," the criterion is checked at the beginning of each repetition, if any, whereas "beginning" means the criterion is checked only once before the repetition "loop" starts.<br/><br/>NOTE(S):<br/>The checkpointCode specifies when the precondition is to be checked; it is analogous to the various conditional statements and loop constructs in programming languages "while-do" vs. "do-while" or "repeat-until" vs. "loop-exit." <br/>
Public BL
  completionRequiredBeforeStartingIndicator
Details:
Map:CTRv1.0=DefinedContingentOnRelationship.completionRequiredBeforeStartingIndicator
Map:TDM=TriggeringRule
Notes: DEFINITION:<br/>Specifies whether the target activity must have completed prior to starting the source activity.<br/><br/>EXAMPLE(S):<br/><br/>OTHER NAME(S):<br/><br/>NOTE(S):<br/>This attribute may only be used if the target is an activity, not if the target is an observation result or a criterion group.<br/>
Element Source Role Target Role
DefinedActivity
Class  
Name: prerequisiteDefinedContingentOnRelationship
 
Name: contingentDefinedActivity
 
Details:
DESCRIPTION:<br/>Each DefinedContingentOnRelationship always is a condition for one DefinedActivity. Each DefinedActivity might be contingent upon one or more DefinedContingentOnRelationship.<br/><br/>DEFINITION:<br/><br/>EXAMPLE(S):<br/><br/>OTHER NAME(S):<br/><br/>NOTE(S):<br/><br/>
DefinedCriterionGroup
Class  
Name: contingentDefinedContingentOnRelationship
 
Name: prerequisiteDefinedCriterionGroup
 
Details:
DESCRIPTION:<br/>Each DefinedContingentOnRelationship might be contingent upon one DefinedCriterionGroup. Each DefinedCriterionGroup might be a condition for one or more DefinedContingentOnRelationship.<br/><br/>DEFINITION:<br/><br/>EXAMPLE(S):<br/><br/>OTHER NAME(S):<br/><br/>NOTE(S):<br/><br/>
DefinedObservationResult
Class  
Name: contingentDefinedContingentOnRelationship
 
Name: prerequisiteDefinedObservationResult
 
Details:
DESCRIPTION:<br/>Each DefinedContingentOnRelationship might be contingent upon one DefinedObservationResult. Each DefinedObservationResult might be a condition for one or more DefinedContingentOnRelationship.<br/><br/>DEFINITION:<br/><br/>EXAMPLE(S):<br/><br/>OTHER NAME(S):<br/><br/>NOTE(S):<br/><br/>
DefinedActivity
Class  
Name: contingentDefinedContingentOnRelationship
 
Name: prerequisiteDefinedActivity
 
Details:
DESCRIPTION:<br/>Each DefinedContingentOnRelationship might be contingent upon one DefinedActivity. Each DefinedActivity might be a condition for one or more DefinedContingentOnRelationship.<br/><br/>DEFINITION:<br/><br/>EXAMPLE(S):<br/><br/>OTHER NAME(S):<br/><br/>NOTE(S):<br/><br/>
Tag Value
Map:APSRv2.1 [Problem] hl7:organizer - [Problem] hl7:organizer > hl7:component [Region of Interest] > hl7:regionOfInterest > hl7:precondition
Details:
 
Map:CTOM ActivityRelationship.typeCode
Details:
 
Map:CTRPv3.8 ActivityRelationship.typeCode
Details:
 
Map:CTRv1.0 DefinedContingentOnRelationship
Details:
 
Map:HL7SD EligibilityCriterion.Precondition2
Details:
 
Map:TDM AbstractRule.evaluableExpression
Details:
 
Map:TDM TriggeringRule
Details:
 
Constraint Type Status
completionRequiredIndicator Qualifier Invariant Approved
Details:
completionRequiredBeforeStartingIndicator may only be used if the target of this relationship is an activity, not if the target is an observation result or a criterion group.<br/>
be contingent upon Exclusive Or Invariant Approved
Details:
A DefinedContingentOnRelationship must be associated to one and only one of the following: DefinedActivity, DefinedObservationResult, DefinedCriterionGroup.<br/>