REDCap Data Dic+onary

Transcription

1 REDCap Data Dic+onary ITHS Biomedical Informa+cs Core Bas de Veer MS Research Consultant REDCap version: Last updated December 9,

2 Goals & Agenda Goals CraDing your own Branching Logic Working with the Data Dic+onary Impor+ng and Expor+ng Agenda Assump+ons and Basic Math Branching Logic Data Dic+onary Syntax & Structure Prac+cal Issues Impor+ng & Expor+ng Interac+ve Q&A 2

3 Assump2ons Access to REDCap Familiar with Online Designer Basic REDCap Concepts Basic Opera+on of Excel Non- programmers Basic Logic Operators Basic Math Syntax 3

4 Why?? Why Use the Data Dic+onary/Complex Branching Logic? Bigger Studies Longitudinal Studies Mul+ple Surveys Complex Protocols Lots of Dependencies Complex Logic Streamline Forms Daisy- chain Surveys Together Tailoring of Projects 4

5 Eligibility Evalua+on Criteria for a Hot Flash Study Between a Certain Age (40-62) Menopausal Has Hot Flashes Experiences more than 3 a Day Are Disrup+ng Daily Life Not a Drug User Doesn t have a Corn Allergy Why?? - Example Example of Branching Logic ([age]>=42 and [age]<=62 and [age]<> ) and [meno]= 1 and [hot]= 1 and ([frq(3)]= 1 or [frq(4)]= 1 ) and [disr]= 1 and [drug]= 0 and [corn]<> 1 5

6 Branching Logic 6

7 Branching Logic Follows If è Then, (Else) Structure Example: If [Statement] then [Show Field] else [Hide Field] Only the [Statement] part is configurable by a REDCap user Impossible to influence other fields through branching logic 3 Ways of Edi+ng Branching Logic: Online Designer (Drag & Drop) Online Designer (Advanced Syntax) Data Dic+onary hdps://redcap.iths.org/redcap/index.php?ac2on=help#branchinglogic 7

8 Logic Operators Tradi+onal Operators AND OR NOT REDCap Operators and or <> 8

9 Math Operators Symbols ( Name è REDCap symbol ) Plus è + Minus è - Divide è / Mul+ply è * Equals è = Comparing è <, >, <=, >= Brackets [ and ] è Define a field ( and ) è Define the logical order and è Define a value 9

10 Example - Basic Example 1 Make the ques+on Is the person re+red? visible based on the field [Age]. Needed Elements Field [age] Field [re+red] Branching logic [age] > 65 10

11 Example - AND Example 2 Make the ques+on Do you have hot flashes? visible based on a range in the field [age] Needed Elements Field [age] Field [hoqlash] Branching logic [age] >= 40 and [age] <= 69 11

12 Example - OR Example 3 Display a warning regarding ineligibility based upon the answers of the two fields [smoker] and [drugs] Needed Elements Field [smoker] & [drugs] Field [ineligibility] Branching logic [smoker] = 1 or [drugs] = 1 12

13 Radio vs Checkbox Syntax Difference Due to the way REDCap stores data Radio Butons: [var] = 1 or [var] = 23 Checkboxes [var(1)] = 1 or [var(23)] = 1 13

14 Example - Checkbox Example 4 Display a warning regarding ineligibility countries the pa+ent has visited Needed Elements Field [country] (countries visited) Field [ineligibility] Branching logic [country(3)] = 1 or [country(5)] = 1 or [country(9)] = 1 14

15 Example - EMPTY Example 5 Make a warning appear when the field [age] is empty Needed Elements Field [age] Field [desc1] Branching logic [age] = 15

16 Example - NOT Example 6 Only make the field [gender] appear when [age] is NOT empty Needed Elements Field [age] Field [gender] Branching logic [age] <> 16

17 Example - Complex Example 7 The field [hoqlash] only appears when [age] is NOT between 40 & 62 AND [age] is NOT empty Needed Elements Field [age] Field [hoqlash] Branching logic: ([age] >= 0 and [age] <= 39 and [age] <> '') or ([age] >= 63 and [age] <= 120 and [age] <> '') (([age] >= 0 and [age] <= 39 ) or ([age] >= 63 and [age] <= 120 )) and [age] <> 17

18 Data Dic+onary 18

19 Prac2cal Issues Data Dic+onary defines the ENTIRE project Forms Variables Deleted fields will results in null value Backup beforehand Download current Data Dic+onary Download current data Create an empty test project when learning 19

20 Prac2cal Issues Data Dic+onary does NOT define: Events Surveys Project Sewngs User Rights Scheduling Randomiza+on Data Quality Rules 20

21 How to get your Data Dic2onary Project Set- up page of your project Download a.csv file to your computer Edit in Excel, Libre Office, Numbers etcetera 21

22 Data Dic2onary Syntax Columns è aspects of variables Rows è list of variables 1 variables per row 4 types of aspects Mandatory Condi+onal Mandatory (based on field type) Non- Mandatory Matrix fields 22

23 Data Dic2onary Syntax Mandatory Fields: Variable/Field Name (Unique) Form Name Field Type (limited choice) Field Label Field Type choices: htps://redcap.iths.org/redcap/index.php?ac+on=help#fieldtypes 23

24 Data Dic2onary Syntax Condi+onal Mandatory Fields: Choices OR Calcula+ons Dropdown Checkboxes Radio Butons Slider Calculated Fields Matrix Fields 24

25 Data Dic2onary Syntax Condi+onal Mandatory Fields: Choices Syntax: value, label value, label Calcula+ons Any type of JavaScript Func+on e.g. Datediff() Variables in [var1] Branching Logic Syntax Slider labels Syntax: label label label Maximum of 3 labels 25

26 Data Dic2onary Syntax Matrix Fields: Matrix Group Name Needs to be the Same Sequen+al Only Radio or Checkbox Field Types Choices must match 26

27 Data Dic2onary Syntax Non- Mandatory Fields: Sec+on Header Field Note Text Valida+on Type (Text or Slider) Text Valida+on Min Text Valida+on Max Iden+fier Branching Logic Required Field Custom Alignment Ques+on (Survey only) 27

28 Data Dic2onary Syntax Non- Mandatory Fields: Free text: Sec+on Header Field Note Limited based on Text Field Type Text Valida+on Type Text Valida+on Min Text Valida+on Max Yes or No (y) Iden+fier Required Field Specific Syntax Branching Logic 28

29 Prac2cal Issues D- SQL field type Coded as SQL in field type column Only modifiable by REDCap Admin Moving Posi+on Field Label Edits Other Aspects Edits Will cause your Data Dic+onary upload to fail Contact a REDCap Admin to modify 29

30 Data Dic2onary Syntax HTML Compa+ble Fields Used for Formawng Text Compa+ble fields Sec+on Header Field Label Choices or Slider Labels Field Note Text to HTML editor can be found at: htps://redcap.iths.org/redcap/iths/ 30

31 Impor+ng & Expor+ng 31

32 Impor2ng & Expor2ng Possible for: Data Dic+onary (.csv) Code Books Data Import (.csv) Export (.csv, SPSS, STATA, R, SAS, PDF) Instruments/Forms (PDF) Alloca+on Tables (Randomiza+on) Various Logs Strict Format Restric+ons for Imports! 32

33 Impor2ng & Expor2ng Data Data Import Tool (.csv) Data Exports, Reports & Stats.csv, SPSS, STATA, R, SAS De- Iden+fica+on PDF Through the Export Tool In a Specific Record 33

34 Expor2ng 34

35 Expor2ng Report Crea+on 1. Naming Your Report 2. Defining Access 3. Selec+ng Fields 4. Sewng Up Filters 5. Ordering The Results Viewing Your Results Expor+ng Your Results 35

36 Expor2ng Data Exports, Reports, and Stats Big PDF All Records With All Forms ZIP File of All Uploads Individual Records Single Form (blank) Single Form (with data) All Forms (blank) All Forms (with data) 36

37 Expor2ng Advanced API (Applica+on Programming Interface) Export/Import Automa+cally Data Entry Triggers Uses REDCap- Amalga Bridge Import Medical Data from EMR Run Tailored Reports Whatever System you want to Hook Up 37

38 Learn How To Use REDCap INTRODUCTION TO REDCAP WHEN: (once a month, hdps:// class- schedule) WHERE: South Lake Union ADVANCED CLASSES WHEN: (hdps:// class- schedule) WHERE: South Lake Union ONLINE VIDEOS & HELP REDCap Training Resources FAQ Supplemental Documenta+on ONGOING HELP iths_redcap@uw.edu (REDCap community list) iths_redcap_admin@uw.edu (REDCap administrators; last resort for help) 38

39 Future Advanced Classes Data Dic+onary - Impor+ng and Expor+ng Data User Rights Randomiza+on Best Prac+ces Advanced Longitudinal Studies & Surveys Schedule and Loca+ons will be on the ITHS website & will be announced in to users. hdps:// class- schedule 39