Permissible Value (PV) subsetting in an instrument allows the user to select a choice from drop-down values of a control field variable and have the ability to select only specific values (subsets) in the target field variable.
Step-by-step guide
- Identify your instrument and fields that would benefit from this function and identify the specific controlling and target values that will be included.
- Contact REDCap help desk and request that the Plugin "PV Subsetting" be add to your REDCap Project. Also they will give you access to a REDCap Project "Cross Ref for PV Subsets". It is used by this plugin. You will add entries to "Cross Ref for PV Subsets" to set up your controlling and target cross references.
- Here is a sample "Cross Ref for PV Subsets" record fields and screenshots
Project Name:
REDCap Project ID Number: four digit number that identifies the project
Form Name: type in the Instrument Name that you are interested in (no square brackets)>
Controlling Field Variable Name: <type in the field of interest(no square brackets)>
Controlling Permissible Value: < type in the code for the value of interest(no square brackets)>
Target Field for Subset (variable name): < type in the field of interest(no square brackets)>
Target Value(s) to display as subset: <enter the code for the values to display separated by commas)
Comment: <comment>
Is this active: Yes
Make note of: 1) create the instrument with the controlling and target values. You will need to know the:
- REDCap Project ID Number: (found ...)
- Form Name: type in the Instrument Name that you are interested in
- Controlling Field Variable Name: type in the field of interest(no square brackets)>Note the Add new record, fill the fields
- Project Name: Dystonia-MICS
- REDCap Project ID Number: 6286
- Form Name: < type in the Instrument Name that you are interested in (no square brackets)>
- Controlling Field Variable Name: <type in the field of interest(no square brackets)>
- Controlling Permissible Value: < type in the code for the value of interest(no square brackets)> Target Field for Subset (variable name): < type in the field of interest(no square brackets)> Target Value(s) to display as subset: <enter the code for the values to display separated by commas) Comment: <comment>Is this active: Yes
Add action tag to the Target Field in the Action Tags/Field Annotation(optional) column: @WUSM_DPPVSUBSET{"refpid":5947}
Related articles