Skip to main content

Data References

To reference data, names for levels are separated by . are used when functions need coordinates for a data point. For example:

entity.category.field

Entities

Entity is the highest level of categorization for data. Two entities currently exist

  • submission - any form or rule derived data
  • plan - fixed plan attributes (e.g. start date) and calculated columns
  • integration - any incoming payload that a plan has been configured to receive
  • workQueueItem - fixed work queue item attributes

Categories

Some entities must define a second level:

  • submission, category is the form name
  • integration, category is the subject (a.k.a topic) name
  • workQueueItem, category is the work queue name
  • plan, there is no category and the reference requires only two levels

Fields

A field is defined by a name and type information

Examples

For example, to get a field named "field1" from a form named "form1":

submission.form1.field1

Or to read the status of a plan:

carePlan.status

These data references are used by by Healix Expression Grammar discussed next.

Catalog

The following fixed attributes are available

EntityFieldPermitted ValuesWriteable
plantitleread only
planstartDateread only
planendDateread-write
planstatusOPEN, CLOSEDread-write
planriskStatusread-write
workQueueItemtitleread only
workQueueItemcreatedAtread only
workQueueItemticketNumberread only
workQueueItempriorityread-write
workQueueItemserviceLocationread-write
workQueueItemqueuePositionread-write
workQueueItemstatusstatuses defined in the work queue definitionread-write