Objects[]

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

object[]

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.
  • Values of empty items. An item is empty if the form has been created but a value has not been provided for the item.

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.

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
  • Second 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: