Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You can hover your cursor over the question button to see the type of question it will add. Click on the drop-down next to each category to see a list of all possible question types. For more information on the From Builder and Question types see our Form Builder Help Page.

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

...

You will now see that there are two sections in the Form Designer Builder 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. Basic- 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- 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- for adding multimedia
    4. Advanced- advanced options that are discussed in other tutorials.

...

Info
titleMore detail on Question IDs!

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

  • No spaces (underscores are fine; if you try to add a space it will be replaced by an underscore)
  • 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 adding questions to this form with questions.

Text question: Woman's Name

...

Curious how this question will look on the mobile device? Click here to see what
Info
titleWhat 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 a Label text.

Expand
title

 

Here's how the question will look

...

on CommCare for Android

...

:

Image Modified

...

 

Text Question: Village Name

...

Easy, right?

Double check it:

...

Here's how it is going to look on the phone:

Image Modified

 

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:

...

Info
titleWhat 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 dropdown menu in the upper left corner of the Question Properties box. The questions are indicated by the same icons as in the Question Bar. The only thing you can't change is a label question.

 

...

Here's how this question will look on the

...

phone (note that calendar questions may differ depending upon phone models):

Image Modified

 

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 previously gave birth previously.

This means we need to add three things:

...

  • Choice Value: no
  • Label: No

It will look like this:

...

Here is how this question will

...

appear on the phone:

Image Modified

 

Integer Questions: How Many Children?

...

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

How does it look?

...

Here's how it will look on the

...

phone:

Image Modified

 

Single Select Question: Feeling Sick today?

...

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

...

  • Question ID: clinic_reminder
  • Label Text: Remind the pregnant woman to go to the clinic for her check-up!

...

Here is how a label will look on the

...

phone:

Image Modified

 

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

...

You've got a beautiful form! But before we go too far we should test the form. It's important to test your form frequently so you can catch mistakes early. Fortunately, CommCare has a built in tool for form testing that doesn't even require a phone.

Go on to the next section, Part 4.