Info
Configure this section outside the dictionary section.

Example use cases:

Display “Tissue Review Event” only for tissue specimens.
Display “Breast Pathology Annotation form” only if the anatomic site is “Breast”.
Display “Screening form” only for “Screening” visits.
Display “Consent forms” only for the “Consent Collector” role.

Template of Code

Code Block

language	json

[
  /* Other workflows */ 
  {
    "name": "formDataEntryRules",
    "data": {
      "participant": [
         /* Rules for participant form data entry */
        /* Records available for use in rule conditions are user, cpr, and cp */
        ],
      "visit": [
        /* Rules for visits form data entry */
        /* Records available for use in rule conditions are user, cp, cpr, and visit */
      ],
      "specimen": [
        /* Rules for specimens form data entry */
        /* Records available for use in rule conditions are user, cp, cpr, visit, and specimen */
      ],
      "specimenEvent": [
        /* Rules for specimens form data entry */
        /* Records available for use in rule conditions are user, cp, cpr, visit, and specimen */
      ]
    }
  },
  /* Other workflows */
]

...

Code Block

language	json

[
  {
    "name": "formDataEntryRules",
    "data": {
      "participant" : 
        [ 
  		   {
    		  "when" : "cpr.participant.gender == 'Female'",
     	       "forms" : [ "pregnancyTestForm" ]
   		   } 
          {
    		  "when" : "cpr.participant.gender != 'Female'",
     	       "forms" : [ "generalInformation" ] // If you have multiple forms, please add the condition to show those
   		   }
        ]
      }
  }
]

Examples

...

Level

...

Case and Description

...

Example JSON

...

1. Participant

...

Shows forms based on CP’s field at the participant level.

...

language	json

...

User needs to provide the False condtion when they want to show the different forms if first condtion is not satisfied.(See below example)

Code Block
{ "name" : "formDataEntryRules", "view" : null, "ctrl" : null, "data" : { "

...

participant" : [

...

2. Participant

...

Shows forms based on the participant's core fields at the participant level.

...

language	json

...

 {
      "when" : "cpr.ppid == '1'",
      "forms" : [ "cbrc_fields" ]
    },
    {
      "when" : "cpr.

...

ppid != '

...

1'",
      "forms" : [ "

...

consent_withdrawal","trackingForm" ]
    }
   ]

...

}
},

Examples

Add multiple conditions with the help of 'AND(&&)' and 'OR (||)' operators.

"specimen" : [

Level

Case and Description

Example JSON

1. Participant

Shows forms based on CP’s field at the participant level.

Code Block

language	json

 "participant" :  [ 
{
    "when" : "cprcp.participant.vitalStatusshortTitle == 'AliveTesting rule CP'",

     "forms" : [ "participantFamilyHistoryXYZForm" ]
 }
]

32. Participant

Shows forms based on the participant's custom core fields at the participant level.Add multiple conditions with the help of 'AND(&&)' and 'OR (||)' operators.

Code Block

language	json

"participant" :  [ 
{
      "when" : "cpr.participant.extensionDetail.attrsMap.DD2gender == 'MarriedMale'",
      "forms" : [ "partnerSDetailssmokingHistoryForm" ]
 }, 
 {
      "when" : "cpr.participant.extensionDetail.attrsMap.DD2gender == 'MarriedFemale' && ",
      "forms" : [ "pregnancyTestForm" ]
 }, {
      "when" : "cpr.participant.gendervitalStatus == 'FemaleAlive'",
      "forms" : [ "partnerSDetailsparticipantFamilyHistory" ]
 }
]

43. Participant

Shows forms based on user role the participant's custom fields at the participant level.

Code Block

language	json

"participant" :  [ 
{
    "when" : "user.hasRole('Coordinator')",cpr.participant.extensionDetail.attrsMap.DD2 == 'Married'",
    "forms" : [ "participantRuleFormpartnerSDetails" ]
}
]

5. Participant

Show forms based on value exist or not in another field.

Code Block

language	json

"participant" : [
      {, {
         "when" : "cpr.participant.extensionDetail.attrsMap.genderDD2 !== null",
   'Married' && cpr.participant.gender == 'Female'",
    "forms" : [ "XYZFormpartnerSDetails" ]
    
 },
      
]

4. Participant

Shows forms based on user role at the participant level.

Code Block

language	json

"participant" : [
{
        "when": "cpr.participant.gender == null",
     "when": "user.hasRole('Coordinator')",
  "forms": ["ABCFormparticipantRuleForm"]
  
   }
]

65. VisitParticipant

Shows Show forms based on CP’s field at the visit levelvalue exist or not in another field.

Code Block

language	json

"visitparticipant" :  [
      {
        "when" : "cpcpr.participant.shortTitlegender =!= 'Testing rule CP'null",
        "forms" : ["XYZForm"]
    } ]

7. Visit

Shows forms based on participant's and visit's core fields at the visit level.

Code Block

language	json

"visit" :  [ },
      {
 {       "when": "visitcpr.participant.statusgender == 'Complete'null",
        "forms": ["visitFormRuleABCForm"]
      },
]

6. Visit

Shows forms based on CP’s field at the visit level.

Code Block

language	json

"visit" :  [ 
    {
       "when" : "cpr.participant.gender cp.shortTitle == 'MaleTesting rule CP'",
       "forms" : ["visitInfoCollectedByCoordinatorXYZForm"]
    }
]

87. Visit

Shows forms based on the participant's and visit's custom core fields at the visit level.

Code Block

language	json

"visit" :  [  
     {
        "when": "visit.extensionDetail.attrsMap.CB8status == 'YesComplete'",
 
      "forms": ["visitInfoCollectedByCoordinatorvisitFormRule"]
    },
    {
     } ]

9. Visit

Shows forms based on user role at the visit level.

Code Block

language	json

"visit" :  [ 
    {
        "when" : "user.hasRole('Coordinator')cpr.participant.gender == 'Male'",
        "forms" : [ "visitInfoCollectedByCoordinator" ]
    }
]

108. SpecimenVisit

Shows forms based on participant’s, the visit's , and specimen's core custom fields at the specimen visit level.

Add multiple conditions with the help of 'AND(&&)' and 'OR (||)' operators

Code Block

language	json

Code Block

language	json

"visit" :  [ 
      {
        "when": "visit.extensionDetail.attrsMap.CB8 == 'Yes'",
        "forms": ["visitInfoCollectedByCoordinator"]
      }
]

9. Visit

Shows forms based on user role at the visit level.

Code Block

language	json

"visit" :  [ 
    {
        "when" : "user.hasRole('Coordinator'),
        "forms" : [ "visitInfoCollectedByCoordinator" ]
    }
]

10. Specimen

Shows forms based on participant’s, visit's, and specimen's core fields at the specimen level.

Add multiple conditions with the help of 'AND(&&)' and 'OR (||)' operators

Code Block

language	json

"specimen" :  [ 
  {
        "when": "specimen.type == 'Whole Blood'",
        "forms": ["fluidInfoForm"]
  },
  {
        "when": "specimen.type == 'DNA' || specimen.type == 'RNA'",
        "forms": ["support_6200", "cPOneSpecimenForm"]
  },
  {
        "when": "specimencpr.participant.typegender == 'Whole BloodFemale'",
        "forms": ["fluidInfoFormspecimenAdditionalRule"]
  },
  {
        "when": "specimen.type == 'DNA' || specimen.type "visit.clinicalStatus == 'RNAFollow-up'",
        "forms": ["support_6200", "cPOneSpecimenFormfluidInfoForm"]
  },
  {
        "when": "cprspecimen.participant.genderlineage == 'FemaleNew'",
        "forms": ["specimenAdditionalRuletechSpecimenForm"]
  },
  {
        "when": "visit.clinicalStatuscpr.participant.gender == 'Female' && visit.clinicalStatus == 'Follow-up' && specimen.lineage == 'Follow-upNew'",
        "forms": ["specimenAdditionalRule","fluidInfoForm","techSpecimenForm"]
  }
]

11. Specimen

Shows forms based on the specimen's custom fields at the specimen level.

Code Block

language	json

"specimen" :  ["fluidInfoForm"]
 
},   {
        "when": "specimen.lineageextensionDetail.attrsMap.DD4 == 'NewA'",
        "forms": ["fluidInfoForm"]
       }
]

12. Specimen

Shows forms based on user role at the specimen level.

Code Block

language	json

  "formsspecimen" :  ["techSpecimenForm"] 
 },   {
        "when": "cpr.participant.gender == 'Female' && visit.clinicalStatus == 'Follow-up' user.hasRole('Technician') && specimen.lineage == 'New'",
        "forms": ["specimenAdditionalRule","fluidInfoForm","techSpecimenForm"]
   }
]

1113. Specimen

Shows forms based on the specimen's custom fields at the specimen levelbased on a range of availability field.

Code Block

language	json

"specimen" :  [ 
    {
        "when": "specimen.extensionDetail.attrsMap.DD4 == 'A'availableQty > 5",
        "forms": ["fluidInfoFormspecimenAdditionalRule"]
    }
]

1214. Specimen Shows forms based on user role at the specimen levelEvent

If CP collects the tissue samples from the participants, then that CP has the 'Tissue Review Event' form under the specimen.

Code Block

language	json

  "specimenspecimenEvent" :  [
    {
        "when": "user.hasRole('Technician') && specimen.lineagespecimenClass == 'NewTissue'",
        "forms": ["techSpecimenFormSpecimenTissueReviewEvent"]
    }
]

1315. Specimen Event

Shows forms based on a range of availability field.participant's, visit's, and specimen's core fields at the specimen event level.

Add multiple conditions with the help of 'AND(&&)' and 'OR (||)' operators

Code Block

language	json

"specimen" :specimenEvent": [
    {
  [      {
        "when": "specimen.availableQty > 5"when": "cpr.participant.gender == 'Female' && visit.clinicalStatus == 'Follow-up' && specimen.specimenClass == 'Tissue'",
        "forms": ["specimenAdditionalRuleSpecimenTissueReviewEvent"]
    }
]

1416. Specimen EventIf CP collects the tissue samples from the participants, then that CP has the 'Tissue Review Event' form under the specimen.No Forms

It does not show any forms at the derivative level

Code Block

language	json

"specimenEventspecimen" : [
    {
 
      "when" : "specimen.specimenClasslineage == 'TissueDerived'",
        "forms" : [ "SpecimenTissueReviewEvent" ]
    } 
]

15. Specimen Event

Shows forms based on participant's, visit's, and specimen's core fields at the specimen event level.

Add multiple conditions with the help of 'AND(&&)' and 'OR (||)' operators17. Visit

Show form based on event label

Code Block

language	json

"specimenEvent

{
    "name":

[

"formDataEntryRules",
    "data": {
    "visit": [
	{

"when":

"cpr.participant.gender

==

'Female' &&

 "when": "visit.

clinicalStatus

status == '

Follow-up

Complete' &&

specimen

visit.

specimenClass

eventLabel == '

Tissue

BASELINE'",


      "forms": ["

SpecimenTissueReviewEvent

rde_visit_testing"]
    }

]

16. No Forms

It does not show any forms at the derivative level

Code Block

language	json

, {
      "when"

: "

specimen

visit.

lineage

status == '

Derived

Complete'",
      "forms"

: [

""

]
    }
  ]
 }
}

1718. VisitShow form based on event labelConsent

Consent forms should be displayed to those who have access to the consent form. For example, ‘Consent Collector’.

Code Block

language	json

{

"participant" :  [ 
    {
        "

name

when": "

formDataEntryRules

user.hasRole('Consent Collector')",

"data":

{

visit

forms": ["consentForm"]

{

"when": "visit.status == 'Complete' && visit.eventLabel == 'BASELINE'",

Specimens

Shows form based on CP title

Code Block

language	json

"specimen" :  [ 
    {
      "

forms

when":  "[

"rde_visit_testing"] }, { "when": "visit.status == 'Complete'",

'101_Translational', '51Legacy', 'More CP names separated by comma'].indexOf(cp.shortTitle) >= 0"
       "forms": ["consentForm"]
    }

} }

18. Consent

Consent forms should be displayed to those who have access to the consent form. For example, ‘Consent Collector’.

Info

How to Escape single quote in code?

You need to use the double slash \\ before the chararcher as below

Code Block

language	json

...

specimen" :  [ 
    {

...

"when":

...

 "['101_Translational\\'s', '51Legacy', 'More CP names separated by comma'].indexOf(cp.shortTitle) >= 0"
       "forms": ["consentForm"]
    } 
]

Example JSON

View file

name	ST_6868.json

...

Versions Compared

Old Version 16

New Version Current

Key

Template of Code

Examples

Examples

Example JSON

Page Comparison

Versions Compared

Old Version 16

New Version Current

Key

Template of Code

Examples

Examples

Example JSON