You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 21 Next »

Time to start building!

Learning Objectives

In Part 3 of the Beginner Tutorial, you will learn the following:

  • How to add, delete, and change the order of questions in a form
  • What some of the different question types are
  • How to add Question IDs and what they mean
  • Adding and editing Label Text

1- Learn how to navigate the Form Designer

After hitting "create" or "edit" on your form, you are inside the Form Designer. The Form Designer is Dimagi's easy-to-use interface for building CommCare forms. As mentioned in CommCare Fundamentals it is possible to use other tools as well, once you are comfortable with the process and structure.

Question Bar

Along the top of the screen you will see the Question Bar, in which a number of different icons which represent question types. You can click on the drop down arrows to see which types of questions are in each menu.

There are several buttons, each one for a type of question to add to your form. These will appear in your "Question Tree" in the order they will appear on your device. In order, these buttons are:

  • Text: Inserts a text question or a "label" that does not elicit a user response
  • Multiple choice: Inserts a multiple choice question that can have a single-answer (i.e. Do you have children? yes or no) or multiple answers (which foods do you like? pizza/toast/peanut butter/apples/carrots)
    • Choice: Inserts the options within your multiple choice question
  • Number: Inserts a question with a numeric response, such as a phone number or age
  • Date: Inserts a date or time question
  • Hidden Value: Allows access to values from other forms or allows you to perform more complex calculations. The user does not see a hidden value when working in the form.
  • Group: Provides a structure to keep related questions together
  • Multimedia Capture: Inserts a question that captures an image, audio, or video file
  • Advanced: A list of more advanced, less common question types

You can hover your cursor over the question button to see what it does. For more information on the From Designer and Question types see our Form Designer Help Site.

Try clicking on the "T" to add a text question. You should see the following:

You will now see that there are two sections in the Form Designer main page:

  1. Question Tree - this is where you will be able to navigate among questions and change the order of questions
  2. Question Properties - this is where you control the actual content and properties of each question. This section is further divided into four sections:
    1. Main Properties- the Question ID is what you will see in the data export, and the Label is the text that the mobile user will be seeing.
    2. Logic Properties- this is where you can control whether a question is required, whether you only want a question to display some of the time, and if you want to put any limits on what type of answer you will accept.
    3. Media and Content- for adding multimedia or other special types of content
    4. Advanced- advanced stuff that we don't have to look at right now.

In this tutorial we will only be concerned with Main Properties and Logic Properties.

Try adding any text in the Question ID and Label Text boxes (i.e. try writing "patient name" or "address")

Delete this text question by using the red delete button in the upper right-hand corner.

 

More detail on Question IDs!

You can't put just anything as a Question ID. Here are the rules:

  • No spaces (underscores are fine)
  • No special characters (like "&" and "$")
  • Cannot start with a number
  • Cannot be the same as another Question ID in the same form

If you violate one or more of these rules, you'll get a warning message! Try it!

In addition, we can suggest some best practices for Question IDs:

  • Make them descriptive- when you look at the data exports you are not going to see the Label text; you are only going to see the Question ID.
  • Be consistent- it is best to have a simple system such as using CamelCase or using underscores like first_name. This will make it easier when you are referencing Question IDs later.

 

2- Add questions

Let's start populating this form with questions.

Text question: Woman's Name

  • Click on the "T" button again to add a text question
  • Set the Question ID to say: woman_name
  • Set Label text to say: Woman's Name

This will create a text question, wherein the user will see a box and a full keyboard to type alphanumeric text. It should look like this in the form builder:

You can ignore everything that is not in "Main Properties."

What is the difference between Question ID and Label Text?

Question ID is what the data will look like when viewing the form submission. The mobile user WILL NOT see the question ID, only people look at the data will. If you are going to use a data analysis package, you may want to consider what format of the Question ID will be easiest for your software to process.

Label Text is the display text that the mobile user will see. If you have more than one language in your application you will have labels for each language, but the same Question ID. You can have any type of special character (or non-English text) in Label text

 Curious how this question will look on the mobile device? Click here to see what the question will look like on CommCare for Android Smartphones.

 

 

Text Question: Village Name

  • Add another text question from the Question Bar
  • Set the Question ID to village_name
  • Set the Label text to: Village Name:

Easy, right?

Double check it:

 Curious how this question will look on the mobile device? Click here to see what the question will look like on CommCare for Android Smartphones.

 

Changing the Order

Look at the question tree- now we have two questions, woman's name and village name. Let's say we want to put Village name as the first question. You will click on "Village Name" in the Question Tree, and then drag it above Woman's Name. There is a small bar that will show where the question is going to be inserted and you will also see a green check mark.  It will look like this:

  • Move Village Name above Woman's Name in the Question Tree

Date Question: Last Menstrual Period (LMP)

  • Add a Date question from the Question Bar (the calendar icon)
  • Set the Question ID to: lmp
  • Set the Label Text to: Date of Last Menstrual Period


Everything is the same as when you added a text question, just the question type is different!

What if I want to change question types? Do I have to delete the question and do it over again?

You can change the question type using the "T" dropdown menu in the upper left corner of the Question Properties box. The only thing you can't change is a label.

 Curious how this question will look on the mobile device? Click here to see what the question will look like on CommCare for Android Smartphones.

 

 

Multiple Choice (one answer) Question: Had previous pregnancy?

Now comes a new type of question- the Multiple Choice question. We are going to ask a yes or no question- whether or not the woman gave birth previously.

This means we need to add three things:

  • The question
  • The answer choice "No"
  • The answer choice "Yes"

To do that, click on the "multiple choice" question button in the Question Bar. When you do that you will see that the circle button next to it lights up:

  • Click the "Add Answer" button twice to add both answers. It should look like this in the Question Tree:

Click on the question ("question4" in the image above) and fill out the Question ID and Label Text:

  • Question ID: living_children
  • Label Text: Has the woman given birth to children that are still alive?


However, we also need to change the names of the choices. Click on one of them and you will see something similar to what you have seen for questions:

The Answer Value is similar to the Question ID - this is how the data will be coded; the Label is the text that the user will see. 

Set the first one to:

  • Answer Value: yes
  • Label Text: Yes

And the second choice:

  • Answer Value: no
  • Label Text: No

It will look like this:

 Curious how this question will look on the mobile device? Click here to see what the question will look like on CommCare for Android Smartphones.

 

Integer Questions: How Many Children?

This next two questions will be easy again. We want to add two integer questions. Click on the numeric question type to add the question.

The first one should look like this:

  • Question ID: living_girls
  • Label Text: How many living girls?

And then make a second question like this:

  • Question ID: living_boys
  • Label Text: How many living boys?

How does it look?

 Curious how this question will look on the mobile device? Click here to see what the question will look like on CommCare for Android Smartphones.

 

Single Select Question: Feeling Sick today?

Almost done with the first part!

Add another Multiple Choice (Single Answer) question:

  • Question ID: feeling_sick
  • Label Text: Is the woman feeling sick today?

Then add two choices:

  • Choice 1:
    • Answer Value: yes
    • Label Text: Yes
  • Choice 2
    • Answer Value: no
    • Label Text: No

Label: Be sure to tell the woman to go to get her ANC check-up!

The last thing we want to add is a screen that doesn't ask for any information, but provides a written message to the mobile user. We want to remind her to tell the pregnant woman to go to the clinic.

To add a label you will need to click on the drop-down menu text to the "T" for text question in the Question Bar:

Then set the main properties as follows:

  • Question ID: clinic_reminder
  • Label Text: Remind the pregnant woman to go to the clinic for her check-up!
 Curious how this question will look on the mobile device? Click here to see what the question will look like on CommCare for Android Smartphones.

 

You're done adding questions! Here is what you're Question Tree should look like:

 

You've got a beautiful form! But there are a couple of things we can improve... for example, we shouldn't ask how many living boys or girls there are if the woman says she has no living children. And we also might want to stop the user from accidentally saying that a woman has 100 girls! We can fix some of these issue by adding some logic to the form. Go on to the next section.

  • No labels