Values[]

Characteristic Description

Icon


Folder icon

Availability

An item that is a child of one of the following:
  • Form that is part of a repeating study event.
  • Repeating form.
  • Repeating section.

Return type

  • If an integer type
  • If a float type—Double[].
  • If a text type
  • If a date time type

Description

Returns an array of values from item instances that are part of a repeating study event, repeating form, or repeating section.

Included in the array

Values of undeleted items. An item is undeleted if someone has provided a value for it, and the form or section that contains the item has not been deleted.

Not included in the array

  • Values of deleted items. An item is deleted if the form or section that contains it is deleted from a study.
  • Values of empty items. An item is empty if the form has been created but a value has not been provided for the item.

Example

A study contains the following repeating forms, which contain the AEDate item:
  • First instance of the form—Someone has entered a value for the AEDate item.
  • Second instance—Someone has filled in values for other items but not the AEDate item (the item is empty).
  • Third instance—Someone entered a value for the AEDate item and deleted the form (the item is deleted).
  • Fourth instance—Someone has entered a value for the AEDate item.
When you use this property, the following instances are returned:
  • First instance
  • Fourth instance

Notes

Note:

Values[], AllValues[], Objects[], and AllObjects[] all return an array of data. Consider the following scenarios when deciding upon the property to use:
  • To include deleted values, use either AllValues[] or AllObjects[].
  • To include null values, use Objects[] or AllObjects[].
Additionally, consider that the following CurrentIndex properties are also available: