visit the hl7 website The Demo site for our new HL7 Version 2+ (plus) Standard

18.3.39 RPT - repeat pattern (2A.3.67)

HL7 Component Table - RPT - Repeat Pattern

Core Framework Base Standard Profile
Seq# Description Interpretation Flags Cardinality Length C.LEN Vocabulary Data Type Implement Cardinality Vocabulary
RPT
1 Repeat Pattern Code [1..1]   repeatPattern (CD VS) CWE SHALL   (CS)
2 Calendar Alignment [0..1]   calendarAlignment (CD VS) ID     (CS)
3 Phase Range Begin Value [0..1]     NM      
4 Phase Range End Value [0..1]     NM      
5 Period Quantity [0..1]     NM      
6
Period Units
C

Condition defined for this element


[1..1]
[0..0]
    CWE MAY    
7 Institution Specified Time [0..1]   expandedYes-NoIndicator (CD VS) ID     (CS)
8 Event [0..1]   eventRelatedPeriod (CD VS) ID     (CS)
9 Event Offset Quantity [0..1]     NM      
10
Event Offset Units
C

Condition defined for this element


[1..1]
[0..0]
    CWE MAY    
11 General Timing Specification [0..1]     GTS      

Conditions/Invariants

The root for the expression is on the segment.

Seq. Referenced Elements Introduction Invariant Comment proposed Optionality
6 ? Period Units
10 ? Event Offset Units

Definition: The repeat pattern data type should be used where it is necessary to define the frequency at which an event is to take place. This data type provides a way to define repeat pattern codes "on the fly". The repeat pattern code is equivalent to the TQ data type, component 2, sub-component 1 (repeat pattern). The additional components define the meaning of the repeat pattern code. Components 2 - 10 are used to define relatively simple repeat patterns. Component 11 is provided to define complex repeat patterns. This data type forms a bridge between the 2.x Repeat Pattern concept from Quantity/Timing, and the Version 3.0 GTS General Timing Specification. Component 1 is the 2.x concept of repeat pattern. Components 2-7 are derived from the version 3.0 data type PIVL. Components 8-10 are derived from the version 3.0 EIVL data type. If a repeat pattern cannot be defined using components 2-10, then component 11, General Timing Specification is provided. This allows the full literal form of the version 3.0 GTS to be specified.

When using the RPT, if an application doesn't recognize the code in component 1, then it may attempt to determine the appropriate frequency using the remaining components. If the application does recognize the code in component 1, the application is not required to determine the frequency from the remaining components.

Use Case: The use case supporting this proposal is the need to define repeat patterns on the fly while placing an order. The TQ data type did not have the capability to define the meaning of a repeat pattern on the fly. To get around this problem, vendors have implemented a variety of solutions to solve this issue. One way was to add Z-components to the TQ data type to transmit information about the repeat pattern. Another solution was to attempt to parse the repeat pattern code in an attempt to decipher what the code meant.

Examples:

|Q1H&Every 1 Hour&HL7xxx^^^^1^h|

|Q2J2&Every second Tuesday&HL7xxx^DW^2^^2^wk|

|BID&Twice a day at institution specified times&HL7xxx^^^^12^h^Y|

|QAM&Every morning at the institution specified time&HL7xxx^HD^00^11^1^d^Y|

|QHS&Every day before the hours of sleep&HL7xxx^^^^1^d^^AHS|

|ACM&Before Breakfast&HL7xxx^^^^^^^ACM|

18.3.39.1 Repeat Pattern Code (CWE) (2A.3.67.0)

Definition: A code representing the repeat pattern defined by the other components of this data type. Refer to User-defined Table 0335 - Repeat Pattern for suggested values.

18.3.39.2 Calendar Alignment (ID) (2A.3.67.1)

Definition: Specifies an alignment of the repetition to a calendar (e.g., to distinguish every 30 days from “the 5th of every month”). Refer to HL7 Table 0527 - Calendar Alignment for valid values.

18.3.39.3 Phase Range Begin Value (NM) (2A.3.67.2)

Definition: Used for Calendar aligned repeat patterns to determine the amount of time from the beginning of particular RPT.2 - Calendar Alignment to the beginning of the phase. If Calendar Alignment is DW (days of week), then this would be the offset from the beginning of the week.

If Phase Range Begin Value is populated, but Phase Range End Value is not populated, then this component defines when the period (RPT.5, 6) begins.

If both Phase Range Begin Value and Phase Range End Value are populated, then this component defines the earliest point in time at which the period (RPT.5, 6) will begin.

The units of measure for this component are derived from the Calendar Alignment value in RPT.2. See HL7 Table 0527 - Calendar Alignment for the units of measure associated with a particular calendar alignment.

18.3.39.4 Phase Range End Value (NM) (2A.3.67.3)

Definition: Used for Calendar aligned repeat patterns to determine the amount of time from the beginning of particular RPT.2 - Calendar Alignment to the end of the phase.

If Phase Range End Value is populated, but Phase Range Begin Value is not populated, then this component defines when the timing period (RPT.5, 6) begins.

If both Phase Range Begin Value and Phase Range End Value are populated, then this component defines the latest point in time at which the period (RPT.5, 6) will begin.

The units of measure for this component are derived from the Calendar Alignment value in RPT.2. See HL7 Table 0527 - Calendar Alignment for the units of measure associated with a particular calendar alignment.

18.3.39.5 Period Quantity (NM) (2A.3.67.4)

Definition: A time duration specifying the frequency at which the periodic interval repeats. RPT.6 - Period Units defines the units of time for this component.

18.3.39.6 Period Units (CWE) (2A.3.67.5)

Definition: Defines the units used for RPT.5 - Period Quantity. Constrained to units of time. Best practice is to use UCUM. Refer to External table the Unified Code for Units of Measure (UCUM) [http://aurora.rg.iupui.edu/UCUM] for valid values.

Condition Rule: This component is required if RPT.5 - Period Quantity is populated.

18.3.39.7 Institution Specified Time (ID) (2A.3.67.6)

Definition: A code that indicates whether the exact timing is up to the party executing the schedule (e.g., to distinguish “every 8 hours” from “3 times a day”). Refer to HL7 Table 0136 - Yes/No Indicator for valid values.

18.3.39.8 Event (ID) (2A.3.67.7)

Definition: A code for a common (periodical) activity of daily living. Refer to HL7 Table 0528 - Event-Related Period for valid values.

18.3.39.9 Event Offset Quantity (NM) (2A.3.67.8)

Definition: An interval that marks the offsets for the beginning, width and end of the event-related periodic interval measured from the time each such event actually occurred. A positive numeric value indicates the amount of time after the event in RPT.8. A negative numeric value indicates the amount of time prior to the event in RPT.8. RPT.10 - Event Offset Units defines the units of time for this component.

Usage Note: This component should not be valued unless there is a value in RPT-8 (Event).

18.3.39.10 Event Offset Units (CWE) (2A.3.67.9)

Definition: Defines the units used for RPT-9 (Event Offset Quantity). Constrained to units of time. The codes for unit of measure are specified in the Unified Code for Units of Measure (UCUM) [http://aurora.rg.iupui.edu/UCUM].

Condition Rule: This component is required if RPT.9 - Event Offset Quantity is populated.