Examples--Using the Current() method and IsValueInArray function

The following examples show the following:

  • Rule expressions that use the Current() rule method.
  • For each correct rule expression that uses the Current() method, an alternative rule expression that uses the IsValueInArray function. Each example that uses the IsValueInArray function is correct, and passes validation.

The examples use the following abbreviations for study objects:

  • evt—Study event
  • frm—Form
  • sct—Section
  • int—Integer item
  • float—Float item
  • yn—Yes/No codelist

Example—Data-entry rule:

Rule expression Correct—Rule passes validation Incorrect—Validation error occurs

Data-entry rule

–

–

this.frm1a.Current().int1.Value == 1

query on this.frm1a.Current().sctbc.float1: query text

query on this.frm1.float1: query text

Data-entry rule using an array

–

–

this.frm1a.int1.Values.Count>0 && Functions._IsValueInArray(1,this.frm1a.int1.Values) == true

query on this.frm1a.Current().sctbc.float1: query text

N/A

–

query on this.frm1.float1: query text

N/A

Example—Workflow rule:

Rule expression Correct—Rule passes validation Incorrect—Validation error occurs

Workflow rule

–

–

this.evt6.Current().frm2a.sct2b.yn2.Value == this.evt6.Current().frm2a.sct2b.yn2.YesNoCodelist2.YesCodelistItem2

You can use this rule expression to trigger a form in study event evt6.

You cannot use this rule expression to trigger a form in a study event other than evt6.

Workflow rule using an array

–

–

this.evt6.frm2a.sct2b.yn2.AllValues.Count>0 && Functions._IsValueInArray(this.evt6[0].frm2a[0].sct2b[0].yn2.YesNoCodelist2.YesCodelistItem2,this.evt6.frm2a.sct2b.yn2.AllValues)==true

You can use this rule expression to trigger any study event.

N/A

Example—Global condition:

Rule expression Correct—Rule passes validation Incorrect—Validation error occurs

Global condition

–

–

this.evt1a.Current().frm3.yn1.Value == this.evt1a.Current().frm3.yn1.YesNoCodelist.YesCodelistItem

You can use this rule expression to trigger form frm1 in study event evt1a.

You cannot use this rule expression to trigger form frm1 in a study event other than evt1a.

Global condition using an array

–

–

this.evt1a.frm3.yn1.Values.Count>0 && Functions._IsValueInArray(this.evt1a[0].frm3.yn1.YesNoCodelist.YesCodelistItem,this.evt1a.frm3.yn1.Values)== true

You can use this rule to trigger:

  • Form frm1 in study event evt1a
  • Form frm1 in study event evt2

N/A

Parent topic: Current()