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:
|
N/A |
Parent topic: Current()