Build Your First Form in Form Designer

Modified on Fri, 20 Nov at 4:58 PM

 

ℹ️ Note: This page is for Data Managers responsible for study design.

 

In OpenClinica, Form Designer is the built-in, no-code editor for case report forms (CRFs). This step-by-step tutorial uses Form Designer to build a simple Vital Signs electronic case report form (eCRF), from an empty form to a form version you can test. Along the way, you choose a layout, add questions, calculate body mass index (BMI), and place questions side by side.

 

If you are new to OpenClinica, read Building Forms in OpenClinica: Start Here first. For details on any setting used here, see Build a Form in Form Designer.


 

Prerequisites

 

Check that you have what you need in OpenClinica before you start the tutorial.

  • You must be able to open the study in Study Designer.
  • The study must have at least one event (a study visit or time point), such as Screening. To add an event, see Events & Forms.
  • This example creates a new form. If your study already has a Vital Signs form, use another name, such as Vital Signs Example.

 

Create the Form and Open Form Designer

 

Add the form to an event in OpenClinica Study Designer, then open it in Form Designer.

  1. In Study Designer, find the Screening event and click + Add a form.
  2. Enter Vital Signs as the form name and click + to add as a new form.
  3. On the form card, click Design.

 

Form Designer opens and shows This form is currently empty.


 

Choose the Layout

 

In Form Designer, choose a Grid style so that related measurements can sit side by side.

  1. Click Layout & Settings.
  2. Under Form style, select the Grid / Single page card. Grid styles let related measurements sit side by side.
  3. Check the Version number. New forms start at version 1.

 

Add the Questions

 

In Form Designer, add the five vital signs questions and give each one an Item Name (the variable name in data extracts) and an Item Group (the dataset the item is stored in). Check each item type before you continue, because you cannot change it later.

  1. Click Add Item.
  2. In the Enter question text box, type Systolic blood pressure (mmHg), then click + Add Question.
  3. Select the Integer icon.
  4. Update Item Name to sysbp in the Question Options screen, enter VS in Item Group, and set Required to Always.
  5. Point to the space below the question. When the Add Item button appears, click it and add Diastolic blood pressure (mmHg) the same way (Integer, item name diabp, Item Group VS).
  6. Add Position as a Select One question. In the response list, replace Option 1 and Option 2 with Sitting and Supine. Open its settings and set Item Name to vspos and Item Group to VS.
  7. Add Weight (kg) and Height (cm) as Decimal questions with the item names weight and height, and the Item Group VS.

 

All five questions now appear on the form. Using the same Item Group (VS) keeps the vital signs together in data extracts, like a vital signs (VS) domain in the Clinical Data Acquisition Standards Harmonization (CDASH) standard.


 

Calculate BMI from Weight and Height

 

In Form Designer, a Calculate item works out a derived value from other answers. Here it calculates BMI from weight and height.

  1. Add a question with the text BMI and select the Calculate icon.
  2. Open its settings, set Item Name to bmi and Item Group to VS, then go to the Calculation tab and enter: round(${weight} div ((${height} div 100) * (${height} div 100)), 1). The expression divides the weight in kilograms by the height in meters squared, and round(..., 1) rounds the result to 1 decimal place, such as 24.7. 
  3. To show the result on the form, add a question with the text BMI: ${bmi} and select the Note icon. Here, bmi is the Item Name of the Calculate item.

 

Place the Blood Pressure Questions Side by Side

 

In Form Designer, group the two blood pressure questions so that they share one row of the Grid form.

  1. Hold Ctrl (Command on a Mac) and click the question type icon on the left side of each blood pressure question. Clicking elsewhere in the question box does not select it.
  2. Click the Create group with selected questions icon in the upper left of Form Designer. 

 

  1. Open the settings of each blood pressure question. Under Item width, select Half width.

 

The two questions now appear side by side in one row of the group.


 

Save, Preview, and Add the Form to the Study

 

Save your work in Form Designer, test it in the preview, and then add the form to the OpenClinica study as a version.

  1. Click Save Draft. Your changes are saved as a draft. The study does not use the draft until you add it to the study in step 5.
  2. Click the Preview form icon and enter some test values.
  3. Check that each question appears as expected and that the BMI value calculates from the weight and height you entered.
  4. Click X to close Form Designer.
  5. On the form in Study Designer, open the menu of your draft under Drafts and select Add to Study.

 

The draft becomes a form version. You can now publish the study to the Test environment and test data entry. See Publishing Your Study.


 

What's Next

 

Continue with these OpenClinica articles.


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article