CommCare Fundamentals - CommCare Structure

1. CommCare Software

CommCare is a software program that allows people to create and manage mobile applications through the website, CommCareHQ. CommCare is the overall tool for building applications, making changes, downloading applications to phones, registering the application users, and viewing data submissions.

A CommCare application ("app") can take many shapes and levels of complexity- there are CommCare apps for maternal and child health, for simple surveys, for agricultural extension agents, nutrition, education, and all sorts of domains where there is a need to help frontline workers do their jobs better and collect data digitally. To test out some applications that have been made with CommCare, please visit the free CommCare Exchange where anyone can share CommCare applications they have created. There is additional information about the CommCare Exchange here.

Applications are built on the CommCareHQ website. It is not necessary to download any software; you can just create an account from any computer and start using CommCare.

2. CommCare Projects

Each program has its own project space on CommCareHQ with its own name. A project is a secure web portal in the CommCare system that contains all data related to your CommCare applications, as well as tools that help you create, manage, and deploy your applications and workers. Anyone can create their own project space, and can choose to let other people have access to their project space.

For example, there is a project called “helpsite” where we keep applications that are used on the help site. We decided to name the project "helpsite" because it is simple and easy to remember. Whenever I visit a page in my project I can see “helpsite” in the address. For example, reports from the helpsite project are located here: www.commcarehq.org/a/helpsite/reports

You will see all websites in CommCareHQ have a similar structure.

A project can have one application or many applications. Applications can all be separate, or they can communicate with each other using “case management,” which we will discuss later. 

To have access to any project space, you must have a CommCareHQ account. 

As a CommCareHQ user, you can create or be invited to multiple project spaces. If you belong to multiple project spaces, after logging into CommCareHQ you will be able to choose which space you want to work in at that time. Data is not shared among project spaces, so unless you invite someone else to your project, no one else will be able to see your application or your data.

3. Forms

The basic unit of data collection in CommCare is called a form. It’s just like most paper-based systems- if you want to complete a task like registration, a transaction, or a updating information, you often have to fill out a form to create a record. Sometimes a project requires lots of forms.

For example, if you are monitoring the condition of a river, you might have to fill out one form the first time you visit the river to collect basic data about it. When you return to the river, you may have to take measurements that require filling out a different form. If there is a flood or an oil spill there is a third type of form you have to fill out.

A CommCare form is a group of questions and messages that the user views sequentially on the phone. This is the core content of CommCare applications. When users submit data, they submit completed forms. They are fully customizable and support all kinds of useful features like multiple languages, skip logic, and multimedia content.

A form can contain many types of questions. For example:

• Text Questions - words or phrases
• Numeric Questions - numbers
• Date Questions
• GPS Questions

You can find more information here.

A form will usually contain a series of questions like this:

In CommCare, you can combine all of the forms we need over the course of a particular project and link them together. 

4. Modules

In CommCare, forms that are all related to the same type of thing are grouped together in modules.  A module can have one or many forms, and an application could have many modules.  A module about pregnancy could contain a registration form, a home visit form, a pregnancy outcome, and a danger signs form. Each form has a different purpose but they are all related to the pregnancy.

For example, if we have an application for a community health worker, we could have a pregnancy module, a malaria module, and an HIV/AIDS module.

A single CommCare application can contain multiple modules. So here is what an application's structure might look like:

In the example above, Forms 1 and 2 are probably referring to the same type of individual, facility, or thing- maybe about a child- so they are grouped into the same module. Form 3 may refer to something or someone different- maybe a village- so it is in a different module. Sometimes two modules may be about the same type of person, facility, or thing, but it depends upon how the application is being used.

The details are not important now, but the key points to remember are:

• The unit of data submission and work is a form. Every time a mobile phone user fills out a form, it is sealed and sent over to the CommCareHQ server through the cellular or WiFi network.
• Forms can be grouped into modules and applications.

There are lots of tutorials on the CommCare Help Site to help you navigate the structure of an application, but now you know all of the basics!

Now it is time to learn a bit about one of the key concepts of CommCare: Case Management.

Go to the next section.