RelatedData[]

Characteristic Description

Icon


Icon for forms

Availability

Repeating, associated form.

Return type

  • Form instances for the associated form.

or

  • An array of item values from associated forms.

Description

Returns instances of associated forms, sorted by form index, and allows access to arrays of item values from the associated forms.

Example

If the AE and CM forms are associated, and you are creating a rule on a study event that contains both of them:

  • To return an array of associated AE forms:this.CM.Current().RelatedData
  • To return an array of associated CM forms:this.AE.Current().RelatedData
  • To return the value of the Verbatim item on the first AE form:this.CM.Current().RelatedData[0].Verbatim.Value
  • To return an array of values for the drugName item from all instances of the CM form that are associated with the current instance of the AE form:this.AE.Current().RelatedData.drugName.Values

Notes

Trigger dependencies are created in the Oracle Health Sciences InForm application for a data-entry rule using associated forms. When the expression of a data-entry rule references the RelatedData rule model property, a trigger dependency is created for both the item that is explicitly referenced and the item that is referenced through the RelatedData property.

  • When you submit either of the associated forms, the rule runs.
  • When you associate two forms in the Oracle Health Sciences InForm application, a trigger dependency causes rules to run.
  • When you remove a form association in the Oracle Health Sciences InForm application, rules do not run.