For an application to have case management, we need more than one form. We've already created a "registration" form which can be used to create, or register, a new case. But we also will want to create a Home Visit form which can be used to follow up with the pregnant woman, and a Birth form which can close the case and remove it from the phone.

Case Management Tutorial: Creating Follow-up Forms

In the Follow-up Form Building Part of the Case Management Tutorial you will learn:

  • How a form can be represented in spreadsheet form
  • More tools to use when building a form, including the "copy" function

1. Another Way to Represent Form Contents

When we created the Beginner's Tutorial we walked through adding questions step-by-step, so we won't do that again here. But you have a Registration Form which looks like this:

 

We could also represent these questions in a table format. For the beginner's tutorial above, it would look like this:

Question ID or

Item Value

Type
Text (en)
Display Condition

Validation

Condition

Validation Message
Calculate Condition
Required
village_nameText QuestionVillage Name:    yes
woman_nameText QuestionWoman's Name:    yes
lmpDateDate of Last Menstrual Period    yes
show_eddLabel

The woman's EDD is:

<output value="#form/edd"/>

    no
living_childrenMultiple Choice

Has the woman given birth to

children that are still alive?

    no
yesAnswerYes     
noAnswerNo     
living_boysIntegerHow many living boys?#form/living_children = 'yes'. <= 15

The number of living

boys must be less than

or equal to 15!

 no
living_girlsIntegerHow many living girls?#form/living_children = 'yes'. <= 15

The number of living

girls must be less than

or equal to 15!

 no
feeling_sickMultiple ChoiceIs the woman feeling sick today?    no
yesAnswerYes     
noAnswerNo     
clinic_reminderLabel

Remind the pregnant woman

to go to the clinic for her check-up!

    no
total_children Hidden Value    #form/living_boys + #form/living_girlsno
edd Hidden Value    date(#form/lmp + 274)no
pregnancy_risk Hidden Value    

if(#form/total_children > 5 and

#form/feeling_sick = 'yes',

'high_risk','low_risk')

no

For each question you can see the Question ID, the question type, the label text, the display condition, any validation conditions and messages, any calculations, and whether the question is required or not. You know how to do all these things so creating another form should be easy!

Just so you know - there are various reasons why it is helpful to represent the questions like this, e.g. it provides an easy way to see details about each question and the relationships between questions, and serves as a discussion document for multiple people involved in the application design process. You can see any form in a similar format to this one by going to "Tools" then "Export Form Contents" in the Form Builder. (Instructions can be found here: Export Form Contents.)


2. Building a Home Visit Form

We want to build a new form:

  • In CommCareHQ, if you are not there already, go to Applications -> Village Health
  • Because you selected "Case List" when you started your application, a second form, titled "Follow Up" is ready as your second form.
  • Set the Form Name to "Home Visit" by clicking the edit pen next to the form name, and then click Save

  • You can now start working on your new form

We will walk through building this form, but much more quickly than in the Beginner Tutorial.


 

Let's start by prompting the mobile user to follow up if the woman stated she was feeling sick at the last visit.

Add a Label Question by using the dropdown menu next to the "T" in the Question Bar and make the following changes:

  • Question ID: previously_sick
  • Label Text: Last time this woman reported she was sick! Ask her if she recovered

You can see that later we are going to want to link this to the question from the Registration Form.

Next let's find out how she is feeling today.

Add a Single Answer Multiple Choice Question from the Question Bar and make the following changes:

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

Now add two choices- set the Item IDs/Label Text to: yes/Yes and no/No respectively

Now we are going to ask a couple of yes/no questions about whether or not the woman has gone to the clinic. We could add those questions just like we added the yes/no questions above, but since we already have a yes/no question we don't need to start from scratch. We can create a copy of the question "feeling_sick" and just change the Question ID and Label Text; we don't have to change Yes and No since they always remain the same.

Select the question "Is the woman feeling sick today" in the Question Tree and click Ctrl + C to copy the question, and then Ctrl + V to paste it.


Selecting Multiple Questions in the Form Builder using Ctrl + clicking on questions can help make your form builder easier in many ways:

  • Duplicate a series of questions within a form
  • Copy a series of questions from one form to another
  • Move multiple questions to a different place in the form
  • Delete multiple questions at once

Click on the newly created copy and make the following changes:

  • Question ID: clinic_visit_1
  • Label Text: Has woman been to clinic visit 1?

Make a copy of the question you just created, go to the newly created copy, and make the following changes:

  • clinic_visit_2
  • Has woman been to clinic visit 2?

We'll come back later and add all the logic, since it is a bit complex! Right now you should have a form like this:


3. Building a Birth Outcome Form

For this next form, we're just going to show you the desired form contents in table format. You are expert form builders so building a form using the table should be no problem!

If you don't have a second followup form you'll need to add one:

  • Click on "+" next to "Case List"

  • Change the Form Name to "Birth Outcome"
  • Build the form contents as follows:
Question ID
Type
Text (en)
Display Condition

Validation

Condition

Validation Message
Calculate Condition
Required
pregnancy_outcomeMultiple ChoicePregnancy Outcome:    yes
live_birthChoiceLive Birth     
still_birthChoiceStill Birth     
abortionChoiceAbortion     
birth_weightDecimalWeight at birth (kg):#form/pregnancy_outcome = 'live_birth'    
baby_nameTextChild's Name:#form/pregnancy_outcome = 'live_birth'   yes
dobDateDate of Birth:#form/pregnancy_outcome = 'live_birth'. <= today()Date of Birth cannot be in the future!  

 

How do I make the validation condition for the date?

 

To make the validation condition for the question "dob" you can still use the expression builder; just drag the question to the left side (remember, it will be replaced by a dot), choose "less than or equal to" and then type in today(), which grabs today's date from the phone. This will ensure the user doesn't accidentally enter a date of birth in the future!

 

 Make sure to save your changes. Your Question Tree should look like this:

 


4. Test your Application

Great! We now have three forms:

  1. Registration Form - used to register a new pregnant mother in the phone
  2. Home Visit Form - used to collect data and provide information at visits throughout the pregnancy
  3. Birth Form - used to record the outcome of the pregnancy and remove the pregnant mother's name from the phone

Following the same procedure you used in the Beginner Tutorial, go to Deploy -> Make a New Version and install the application on your phone. Or test in CloudCare.

Try accessing each form. You will find that you can directly go to any of the forms. 


That would be fine if they were all separate surveys, but we want them to be linked! We can use case management to get a workflow that links everything together

Just wait until you see how powerful case management can be!!! (You can see we're excited about it!)

 

In the next section will we set the Registration Form to open, or register, a new case.

Go to the Next Section.

  • No labels