Element

ISO 13606 Elements and Data. Each Element is associated with a single Data value which is of the defined DataType and Unit of measurement (if specified). The elementType defines the scope of the Data values, in addition to their base data type.

Property

Description

Identifier

Unique identifier for the ISO-13606 Element

DisplayName

Label (title) used when selecting the Element

Hint

Description displayed when the user hovers over the Element

Extension

The extension to the Identifier. The purpose of the extension is to allow for specialization of identified Elements.

The Element Identifier is used to define the structure of the health record, but the Extension is used in calculations. This means that the same Element (same Extension) can be defined with different behaviours (specified for Elements with different Identifiers, referring to the same Extension)

Selected from the existing Element Identifiers.

If no Extension is specified for an Element then it defaults to be the same as the Identifier

ElementType

The type of the element (in addition to the DataType of the Data contained in the element)

  • simpleType - user control for data entry is based on the DataType

  • patientMedia - upload control for user to select external media

  • calculatedValue - value is calculated using the expression in CalculatedValue (not directly editable by the user)

  • staticValue - a static value calculated from the DefaultValue (then not editable by the user)

  • enumeratedValue - user selected from one of the values defined for the Element in the Data

  • enumeratedCalculatedValue - user selected from one of the values defined for the Element from evaluation of the CalculatedValue

  • enumeratedClass - user selected from one of the values defined in the Class for the Element

  • enumeratedDirectory - user selected from one of the values defined in the Directory for the Element

  • memo - for DataType string - displays a larger memo field

  • range - for DataType integer - displays a range slider between the two values listed in the Data

  • URL - the value (usually a static default value) is displayed as a clickable link

  • age - set to the current patient age (set as a xs:duration)

  • icon - displayed as small inline image

DataType

For the value of Data in an Element - these are datatypes from the XML Datatypes standard (xs:string, xs:date, etc)

  • string

  • date

  • dateTime

  • time

  • duration

  • dayTimeDuration

  • yearMonthDuration

  • double

  • integer

  • boolean

  • anyURI

  • base64Binary

RequiredValue

  • Optional - the Data value can be left blank

  • Required - the user must fill in the Data value

Scope

For user selection of the values for an Element with ElementType of enumeratedValue or enumeratedClass

  • Defined - the user selects from the set of available values, which are not displayed until the user interacts. For enumeratedValue this is a drop-down menu of all defined values. For enumeratedClass this is a button which invokes a dialog box with the classification through which the user can browse and select the required value.

  • Full - all available values are displayed for selection. For enumeratedValue this is a set of radio button selections, one for each of the defined values. For enumeratedClass this enables the autocomplete so that values are found in the classification as the user types in the input box. If the string types by the use exactly matches one value in the classification then that value is filled out; if a limited number of possible values is returned then a drop-down menu of those values is displayed for the user to select.

Unit

The units of measurement for a data value, selected from the units defined on the Unit sheet.

Precision

The precision (length) of the data value. Used to set the size of the input field in the user interface. When used with a calculatedValue of DataType xs:double the Precision is used to determine the rounding of the value to the specified number of decimal places.

Conditions

The Condition is evaluated continuously as the containing Composition is edited by the user. If the Condition evaluates to true then the Element is in-scope, if the Condition evaluates to false then the Element is out-of-scope.

Any out-of-scope Element has its visibility set to false, is hidden from the user, does not get used in other calculations and is removed from the Composition before it is committed to the patient record.

Constraints

Result of the expression is cast to xs:boolean

An expression that is evaluated as the user enters the value of Data for the Element; if the Constraints evaluates to false then the value entered by the user is removed (replaced by an empty value)

DefaultValue

Expression evaluated to calculate the default data value of the Element. The calculation is performed once, when the Form is loaded.

CalculatedValue

Expression evaluated to calculate the data value of the Element. The calculation is evaluated continuously when the Element is displayed, so that the value may be updated as other values are changed on the Form.

Data

For enumeratedValue or calculatedEnumeratedValue the Data specifies pairs of displayName / value for the element. If no value is specified in the pair, then the default value is the same as the displayName.

For enumeratedClass the first displayName / value pair defines the class used as the scope for values of the Element. The value is either a single atomic value that defines the classId or is of the form classId:nodeId where the nodeId defines the Identifier of the entry node in the class.

If an Element of enumeratedClass is used for CategorizationCriteria then there may be multiple values of the form classId:NodeId to define the categories.