substance_use_summary

Summary or persistent information about typical use of a specific substance or class of substances that may harm an individual's health or social well-being.

Summary or persistent information about typical use of a specific substance or class of substances that may harm an individual's health or social well-being.

Purpose. To record summary or persistent information about the typical use of a specific substance or class of substances that may harm an individual's health or social well-being.

Source

ModelLegRole
openEHR-EHR-EVALUATION.substance_use_summary.v1openEHRdefines this table

Columns

ColumnTypeNullDescriptionSource
iduuid primary keynoPrimary key.
form_iduuidformnoThe form this entry was recorded on.
form_block_iduuidyesThe block within the form, when the entry is bound to one.
substance_name
substance_name_code
substance_name_system
substance_name_valueset_id
coded text
text, text, text, text
yesSubstance name/data[at0001]/items[at0002]
overall_status
overall_status_code
overall_status_system
overall_status_valueset_id
coded text
text, text, text, text
yesOverall status/data[at0001]/items[at0003]
overall_descriptiontextyesOverall description/data[at0001]/items[at0007]
first_ever_usetimestamptzyesFirst ever use/data[at0001]/items[at0008]
regular_use_commencedtimestamptzyesRegular use commenced/data[at0001]/items[at0009]
daily_use_commencedtimestamptzyesDaily use commenced/data[at0001]/items[at0010]
overall_quit_datetimestamptzyesOverall quit date/data[at0001]/items[at0028]
overall_commenttextyesOverall comment/data[at0001]/items[at0030]
last_updatedtimestamptzyesLast updated/protocol[at0029]/items[at0031]

Constraints

check ((substance_name_code is null and substance_name_system is null and substance_name_valueset_id is null) or (substance_name is not null and substance_name_code is not null and substance_name_system is not null and substance_name_valueset_id is not null))
check ((overall_status_code is null and overall_status_system is null and overall_status_valueset_id is null and overall_status is null) or (overall_status is not null and overall_status_code is not null and overall_status_system is not null and overall_status_valueset_id is not null))

Unique

References

ColumnsTargetOn delete
form_idformcascade
form_id, form_block_idform_blockcascade
substance_name_valueset_id, substance_name_code, substance_name_system, substance_namevalueset_coderestrict
overall_status_valueset_id, overall_status_code, overall_status_system, overall_statusvalueset_coderestrict

Referenced by

Indexes

Child tables

1 table hang off substance_use_summary, one row per repetition.

substance_use_summary_per_episode

Child table — one row per repetition, deleted with its parent.

ColumnTypeNullDescriptionSource
iduuid primary keynoPrimary key.
substance_use_summary_iduuidsubstance_use_summaryno
positionintegernoOrder of this row within its parent, from zero.
episode_labeltextyesEpisode label/data[at0001]/items[at0012]/items[at0013]
episode_start_datetimestamptzyesEpisode start date/data[at0001]/items[at0012]/items[at0014]
specific_substance_name
specific_substance_name_code
specific_substance_name_system
specific_substance_name_valueset_id
coded text
text, text, text, text
yesSpecific substance name/data[at0001]/items[at0012]/items[at0016]
status
status_code
status_system
status_valueset_id
coded text
text, text, text, text
yesStatus/data[at0001]/items[at0012]/items[at0017]
episode_descriptiontextyesEpisode description/data[at0001]/items[at0012]/items[at0018]
pattern_coded_text
pattern_coded_text_code
pattern_coded_text_system
pattern_coded_text_valueset_id
pattern_quantity_magnitude
pattern_quantity_units
coded text
text, text, text, text, numeric, text
yesPattern/data[at0001]/items[at0012]/items[at0019]
typical_amount_magnitude
typical_amount_units
quantity
numeric, text
yesTypical amount/data[at0001]/items[at0012]/items[at0023]
route
route_code
route_system
route_valueset_id
coded text
text, text, text, text
yesRoute/data[at0001]/items[at0012]/items[at0036]
episode_end_datetimestamptzyesEpisode end date/data[at0001]/items[at0012]/items[at0015]
number_of_quit_attemptsintegeryesNumber of quit attempts/data[at0001]/items[at0012]/items[at0024]
episode_commenttimestamptzyesEpisode comment/data[at0001]/items[at0012]/items[at0026]

Constraints

check ((specific_substance_name_code is null and specific_substance_name_system is null and specific_substance_name_valueset_id is null) or (specific_substance_name is not null and specific_substance_name_code is not null and specific_substance_name_system is not null and specific_substance_name_valueset_id is not null))
check ((status_code is null and status_system is null and status_valueset_id is null and status is null) or (status is not null and status_code is not null and status_system is not null and status_valueset_id is not null))
check ((pattern_coded_text_code is null and pattern_coded_text_system is null and pattern_coded_text_valueset_id is null) or (pattern_coded_text is not null and pattern_coded_text_code is not null and pattern_coded_text_system is not null and pattern_coded_text_valueset_id is not null))
check ((pattern_quantity_magnitude is null and pattern_quantity_units is null) or (pattern_quantity_magnitude is not null and pattern_quantity_units is not null))
check (pattern_quantity_magnitude is null or (pattern_quantity_units = '1/d' and pattern_quantity_magnitude >= 0) or (pattern_quantity_units = '1/wk' and pattern_quantity_magnitude >= 0) or (pattern_quantity_units = '1/mo' and pattern_quantity_magnitude >= 0) or (pattern_quantity_units = '1/a' and pattern_quantity_magnitude >= 0))
check (num_nonnulls(pattern_coded_text, pattern_quantity_magnitude) <= 1)
check ((typical_amount_magnitude is null and typical_amount_units is null) or (typical_amount_magnitude is not null and typical_amount_units is not null))
check (typical_amount_magnitude is null or (typical_amount_units = 'mg/d' and typical_amount_magnitude >= 0) or (typical_amount_units = 'g/d' and typical_amount_magnitude >= 0) or (typical_amount_units = 'mg/wk' and typical_amount_magnitude >= 0) or (typical_amount_units = 'g/wk' and typical_amount_magnitude >= 0) or (typical_amount_units = 'mg/mo' and typical_amount_magnitude >= 0) or (typical_amount_units = 'g/mo' and typical_amount_magnitude >= 0) or (typical_amount_units = 'ug/d' and typical_amount_magnitude >= 0) or (typical_amount_units = 'ug/wk' and typical_amount_magnitude >= 0) or (typical_amount_units = 'ug/mo' and typical_amount_magnitude >= 0))
check ((route_code is null and route_system is null and route_valueset_id is null) or (route is not null and route_code is not null and route_system is not null and route_valueset_id is not null))
check (number_of_quit_attempts is null or number_of_quit_attempts >= 0)

Unique

References

ColumnsTargetOn delete
substance_use_summary_idsubstance_use_summarycascade
specific_substance_name_valueset_id, specific_substance_name_code, specific_substance_name_system, specific_substance_namevalueset_coderestrict
status_valueset_id, status_code, status_system, statusvalueset_coderestrict
pattern_coded_text_valueset_id, pattern_coded_text_code, pattern_coded_text_system, pattern_coded_textvalueset_coderestrict
route_valueset_id, route_code, route_system, routevalueset_coderestrict

Value sets

Value setCodes
org.openehr::openEHR-EHR-EVALUATION.substance_use_summary.v1/overall_status3
org.openehr::openEHR-EHR-EVALUATION.substance_use_summary.v1/pattern2
org.openehr::openEHR-EHR-EVALUATION.substance_use_summary.v1/status2