cql_qdm_patientapi 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 82e220cc46b50e492e5aa42d30e0f39bcdcd97a5
-  data.tar.gz: 9edcb09f9dae7e87f6c6b7318604d1de3eb06647
+SHA256:
+  metadata.gz: a223682b6169cd2d77aee7a38ca3641dfe08b59454fbbf070e6253c0ebe8e252
+  data.tar.gz: 90844909701048290940079d8ef66189a2debbbf4e3db933e03a599bf4f2314c
 SHA512:
-  metadata.gz: e011b102242c10d1f2d1c0248269b35ff1b9a76d1c1b26f61664f52e86594c6061f2d1fe9729674e2b2cf5767b1c5437baadceb5103577790d1a4469b8b78325
-  data.tar.gz: e06636b05fe937be02a88a1d4f07e0818d0fcacc14e80cc16099d6cb2ecbacb7a1564d21a689b6c5a361d8b04e7262e74b40b0dfb8ae39cf16d913425899d737
+  metadata.gz: cde1743be206ee2d84dcfd6e5f60edb2751652656679cecaa0c79e609e9fb43d0816844bd709c8e246d0289d1134fd3f6ade97f0df763c6def298ec6b8c93b5c
+  data.tar.gz: 23d09bee95558466d483c11fb79bda2f2d1e2a5ea2a4d4025b0a316561850042f4ee969a075ba16e886315a1e59ec983160223cbb11647cf51946aa104d55294

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cql_qdm_patientapi (1.2.0)
+    cql_qdm_patientapi (1.3.0)
       coffee-rails (~> 4.1)
       rails (~> 4.2)
       sprockets-rails (~> 2.3)
@@ -66,12 +66,12 @@ GEM
     loofah (2.2.2)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
-    mail (2.7.0)
+    mail (2.7.1)
       mini_mime (>= 0.1.1)
-    mini_mime (1.0.0)
+    mini_mime (1.0.1)
     mini_portile2 (2.3.0)
     minitest (5.10.3)
-    nokogiri (1.8.4)
+    nokogiri (1.8.5)
       mini_portile2 (~> 2.3.0)
     phantomjs (2.1.1.0)
     rack (1.6.8)

data/app/assets/javascripts/datatypes/adverseevent.js.coffee

@@ -12,18 +12,18 @@ class CQL_QDM.AdverseEvent extends CQL_QDM.QDMDatatype
   ###
   @param {Object} entry - the HDS data criteria object to convert
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    @_facilityLocation = @entry.facility
-    @_relevantPeriodLow = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    if @entry.end_time
-      @_relevantPeriodHigh = CQL_QDM.Helpers.convertDateTime(@entry.end_time)
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    @_facilityLocation = entry.facility
+    @_relevantPeriodLow = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    if entry.end_time
+      @_relevantPeriodHigh = CQL_QDM.Helpers.convertDateTime(entry.end_time)
     else
       # No end time; high is set to infinity
       @_relevantPeriodHigh = CQL_QDM.Helpers.infinityDateTime()
-    @_severity = @entry.severity
-    @_type = @entry.type
+    @_severity = entry.severity
+    @_type = entry.type
 
   ###
   @returns {Date}

data/app/assets/javascripts/datatypes/allergyintolerance.js.coffee

@@ -15,17 +15,17 @@ class CQL_QDM.AllergyIntolerance extends CQL_QDM.QDMDatatype
   ###
   @param {Object} entry - the HDS data criteria object to convert
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    @_prevalencePeriodLow = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    if @entry.end_time
-      @_prevalencePeriodHigh = CQL_QDM.Helpers.convertDateTime(@entry.end_time)
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    @_prevalencePeriodLow = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    if entry.end_time
+      @_prevalencePeriodHigh = CQL_QDM.Helpers.convertDateTime(entry.end_time)
     else
       # No end time; high is set to infinity
       @_prevalencePeriodHigh = CQL_QDM.Helpers.infinityDateTime()
-    @_severity = @entry.severity
-    @_type = @entry.type
+    @_severity = entry.severity
+    @_type = entry.type
 
   ###
   @returns {Date}

data/app/assets/javascripts/datatypes/assessment.js.coffee

@@ -4,6 +4,54 @@ their methods will be accessable through the CQL_QDM namespace)
 ###
 @CQL_QDM ||= {}
 
+###
+Data elements that meet these criteria using this datatype should document an
+order by a clinician or appropriately licensed care provider to a patient or
+an appropriate provider or organization to perform an assessment indicated by
+the QDM category and its corresponding value set.
+
+Timing: The time the order is authored (i.e., provided to the patient).
+
+NOTE: Orders address the time that the order is authored, a single point in time.
+Some assessment orders will be addressed as components of a care plan which
+incorporates the period (or timing) when the order is to be carried out. Measure
+developers should address feasibility of clinical workflow to capture Assessment,
+Order when evaluating measures.
+###
+class CQL_QDM.AssessmentOrder extends CQL_QDM.QDMDatatype
+  ###
+  @param {Object} entry - the HDS data criteria object to convert
+  ###
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    @_negationRationale = entry.negationReason
+    @_reason = entry.reason
+    delete entry.end_time
+
+  ###
+  @returns {Date}
+  ###
+  authorDatetime: ->
+    @_authorDatetime
+
+  ###
+  @returns {Code}
+  ###
+  negationRationale: ->
+    if @_negationRationale?
+      new cql.Code(@_negationRationale.code, @_negationRationale.code_system, null, @_negationRationale.title || null)
+    else
+      null
+
+  ###
+  @returns {Code}
+  ###
+  reason: ->
+    if @_reason?
+      new cql.Code(@_reason.code, @_reason.code_system, null, @_reason.title || null)
+    else
+      null
 
 ###
 Data elements that meet criteria using this datatype should document completion
@@ -15,17 +63,17 @@ class CQL_QDM.AssessmentPerformed extends CQL_QDM.QDMDatatype
   ###
   @param {Object} entry - the HDS data criteria object to convert
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    @_method = @entry.method
-    @_negationRationale = @entry.negationReason
-    @_reason = @entry.reason
-    if @entry.values? && @entry.values.length > 0
-      @_result = @entry.values?[0]
-    @_relatedTo = @entry.references
-    @_components = @entry.components
-    delete @entry.end_time
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    @_method = entry.method
+    @_negationRationale = entry.negationReason
+    @_reason = entry.reason
+    if entry.values? && entry.values.length > 0
+      @_result = entry.values?[0]
+    @_relatedTo = entry.references
+    @_components = entry.components
+    delete entry.end_time
 
   ###
   @returns {Date}
@@ -108,15 +156,14 @@ class CQL_QDM.AssessmentRecommended extends CQL_QDM.QDMDatatype
   ###
   @param {Object} entry - the HDS data criteria object to convert
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    @_method = @entry.method
-    @_negationRationale = @entry.negationReason
-    @_reason = @entry.reason
-    if @entry.values? && @entry.values.length > 0
-      @_result = @entry.values?[0]
-    delete @entry.end_time
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    @_negationRationale = entry.negationReason
+    @_reason = entry.reason
+    if entry.values? && entry.values.length > 0
+      @_result = entry.values?[0]
+    delete entry.end_time
 
   ###
   @returns {Date}
@@ -124,15 +171,6 @@ class CQL_QDM.AssessmentRecommended extends CQL_QDM.QDMDatatype
   authorDatetime: ->
     @_authorDatetime
 
-  ###
-  @returns {Code}
-  ###
-  method: ->
-    if @_method?
-      new cql.Code(@_method.code, @_method.code_system, null, @_method.title || null)
-    else
-      null
-
   ###
   @returns {Code}
   ###
@@ -150,12 +188,3 @@ class CQL_QDM.AssessmentRecommended extends CQL_QDM.QDMDatatype
       new cql.Code(@_reason.code, @_reason.code_system, null, @_reason.title || null)
     else
       null
-
-  ###
-  @returns {Code}
-  ###
-  method: ->
-    if @_method?
-      new cql.Code(@_method.code, @_method.code_system, null, @_method.title || null)
-    else
-      null

data/app/assets/javascripts/datatypes/careexperience.js.coffee

@@ -14,10 +14,10 @@ class CQL_QDM.PatientCareExperience extends CQL_QDM.QDMDatatype
   ###
   @param {Object} entry - the HDS data criteria object to convert
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    delete @entry.end_time
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    delete entry.end_time
 
   ###
   @returns {Date}
@@ -37,9 +37,9 @@ class CQL_QDM.ProviderCareExperience extends CQL_QDM.QDMDatatype
   ###
   @param {Object} entry - the HDS data criteria object to convert
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
 
   ###
   @returns {Date}

data/app/assets/javascripts/datatypes/caregoal.js.coffee

@@ -15,17 +15,17 @@ class CQL_QDM.CareGoal extends CQL_QDM.QDMDatatype
   ###
   @param {Object} entry - the HDS data criteria object to convert
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    @_relevantPeriodLow = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    if @entry.end_time
-      @_relevantPeriodHigh = CQL_QDM.Helpers.convertDateTime(@entry.end_time)
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    @_relevantPeriodLow = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    if entry.end_time
+      @_relevantPeriodHigh = CQL_QDM.Helpers.convertDateTime(entry.end_time)
     else
       # No end time; high is set to infinity
       @_relevantPeriodHigh = CQL_QDM.Helpers.infinityDateTime()
-    @_relatedTo = @entry.references
-    @_targetOutcome = @entry.targetOutcome
+    @_relatedTo = entry.references
+    @_targetOutcome = entry.targetOutcome
 
   ###
   @returns {Interval<Date>}

data/app/assets/javascripts/datatypes/communication.js.coffee

@@ -6,20 +6,35 @@ their methods will be accessable through the CQL_QDM namespace)
 
 
 ###
-To meet criteria using this datatype, the communication indicated by the
-Communication QDM category and its corresponding value set must be
-communicated from a patient to a provider.
+To meet criteria using this datatype, the communication indicated by the Communication
+QDM category is a conveyance of information from one entity (e.g., person, organization,
+or device) to another.
+
+Timing:
+Relevant Period: The time the communication is sent (start time) to the time the
+communication is received (end time)
+Author dateTime the time the communication is documented (specifically significant for
+negation rationale, i.e., Communication Not Performed)
 ###
-class CQL_QDM.CommunicationFromPatientToProvider extends CQL_QDM.QDMDatatype
+class CQL_QDM.CommunicationPerformed extends CQL_QDM.QDMDatatype
   ###
   @param {Object} entry - the HDS data criteria object to convert
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    @_negationRationale = @entry.negationReason
-    @_relatedTo = @entry.references
-    delete @entry.end_time
+  constructor: (entry) ->
+    super entry
+    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    @_negationRationale = entry.negationReason
+    @_relatedTo = entry.references
+    @_relevantPeriodLow = CQL_QDM.Helpers.convertDateTime(entry.start_time)
+    if entry.end_time
+      @_relevantPeriodHigh = CQL_QDM.Helpers.convertDateTime(entry.end_time)
+    else
+      # No end time; high is set to infinity
+      @_relevantPeriodHigh = CQL_QDM.Helpers.infinityDateTime()
+    @_category = entry.category
+    @_sender = entry.sender
+    @_recipient = entry.recipient
+    @_medium = entry.medium
 
   ###
   @returns {Date}
@@ -42,78 +57,49 @@ class CQL_QDM.CommunicationFromPatientToProvider extends CQL_QDM.QDMDatatype
   relatedTo: ->
     CQL_QDM.Helpers.relatedTo(@_relatedTo)
 
-
-###
-To meet criteria using this datatype, the communication indicated by the
-Communication QDM category and its corresponding value set must be
-communicated from a provider to a patient.
-###
-class CQL_QDM.CommunicationFromProviderToPatient extends CQL_QDM.QDMDatatype
   ###
-  @param {Object} entry - the HDS data criteria object to convert
+  @returns {Interval<Date>}
   ###
-  constructor: (@entry) ->
-    super @entry
-    @_negationRationale = @entry.negationReason
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    @_relatedTo = @entry.references
-    delete @entry.end_time
+  relevantPeriod: ->
+    low = @_relevantPeriodLow
+    high = @_relevantPeriodHigh
+    if low?
+      new cql.Interval(low, high)
+    else
+      null
 
   ###
   @returns {Code}
   ###
-  negationRationale: ->
-    if @_negationRationale?
-      new cql.Code(@_negationRationale.code, @_negationRationale.code_system, null, @_negationRationale.title || null)
+  category: ->
+    if @_category?
+      new cql.Code(@_category.code, @_category.code_system, null, @_category.title || null)
     else
       null
 
-  ###
-  @returns {Date}
-  ###
-  authorDatetime: ->
-    @_authorDatetime
-
-  ###
-  @returns {Array}
-  ###
-  relatedTo: ->
-    CQL_QDM.Helpers.relatedTo(@_relatedTo)
-
-
-###
-To meet criteria using this datatype, the communication indicated by the
-Communication QDM category and its corresponding value set must be
-communicated from one provider to another.
-###
-class CQL_QDM.CommunicationFromProviderToProvider extends CQL_QDM.QDMDatatype
-  ###
-  @param {Object} entry - the HDS data criteria object to convert
-  ###
-  constructor: (@entry) ->
-    super @entry
-    @_negationRationale = @entry.negationReason
-    @_authorDatetime = CQL_QDM.Helpers.convertDateTime(@entry.start_time)
-    @_relatedTo = @entry.references
-    delete @entry.end_time
-
   ###
   @returns {Code}
   ###
-  negationRationale: ->
-    if @_negationRationale?
-      new cql.Code(@_negationRationale.code, @_negationRationale.code_system, null, @_negationRationale.title || null)
+  sender: ->
+    if @_sender?
+      new cql.Code(@_sender.code, @_sender.code_system, null, @_sender.title || null)
     else
       null
 
   ###
-  @returns {Date}
+  @returns {Code}
   ###
-  authorDatetime: ->
-    @_authorDatetime
+  recipient: ->
+    if @_recipient?
+      new cql.Code(@_recipient.code, @_recipient.code_system, null, @_recipient.title || null)
+    else
+      null
 
   ###
-  @returns {Array}
+  @returns {Code}
   ###
-  relatedTo: ->
-    CQL_QDM.Helpers.relatedTo(@_relatedTo)
+  medium: ->
+    if @_medium?
+      new cql.Code(@_medium.code, @_medium.code_system, null, @_medium.title || null)
+    else
+      null

data/app/assets/javascripts/datatypes/datatype.js.coffee

@@ -10,8 +10,13 @@ Base QDM datatype class; implements various functions that all implemented
 QDM datatypes must support.
 ###
 class CQL_QDM.QDMDatatype
-  constructor: (@entry) ->
-    @_codes = @entry?.codes
+  constructor: (entry) ->
+    @_id = entry?._id
+    @_oid = entry?.oid
+    @_codes = entry?.codes
+    @_description = entry?.description
+    @_end_time = entry?.end_time
+    @_start_time = entry?.start_time
 
   ###
   Returns any instances of this attribute currently within this namespace.
@@ -39,8 +44,8 @@ class CQL_QDM.QDMDatatype
   @returns {Id}
   ###
   id: ->
-    if @entry?._id?
-      return new CQL_QDM.Id(@entry._id)
+    if @_id?
+      return new CQL_QDM.Id(@_id)
     else
       null
 
@@ -69,13 +74,13 @@ class CQL_QDM.QDMDatatype
   ###
   toString: ->
     # Grab description from entry; if blank use classname
-    description = if @entry?.description then "#{@entry.description}\n" else "#{@constructor.name}\n"
+    description = if @_description? then "#{@_description}\n" else "#{@constructor.name}\n"
     # Grab start and end time, format for proper display
-    startTime = if @entry?.start_time then "START: #{moment.utc(@entry.start_time, 'X').format('MM/DD/YYYY h:mm A')}\n" else ""
-    endTime = if @entry?.end_time then "STOP: #{moment.utc(@entry.end_time, 'X').format('MM/DD/YYYY h:mm A')}\n" else ""
+    startTime = if @_start_time? then "START: #{moment.utc(@_start_time, 'X').format('MM/DD/YYYY h:mm A')}\n" else ""
+    endTime = if @_end_time? then "STOP: #{moment.utc(@_end_time, 'X').format('MM/DD/YYYY h:mm A')}\n" else ""
     # TODO: Refactor getCode()/code() so that this special logic is not necessary.
-    # If it is a patient characteristic (other than payer), use getCode() instead of code()
-    if /PatientCharacteristic/.test(this.constructor.name) and this.constructor.name != 'PatientCharacteristicPayer'
+    # These PatientCharacteristics use getCode instead of code.  Others still use code.
+    if /PatientCharacteristic(?:Ethnicity|Expired|Race|Sex|Birthdate)/.test(this.constructor.name)
       code = @getCode()
     else if @_codes
       # Get code if this datatype has any