Skip to content

Latest commit

 

History

History
90 lines (57 loc) · 4.2 KB

getting-started.rst

File metadata and controls

90 lines (57 loc) · 4.2 KB

Getting Started Guide

Using ODK

In most cases, users of ODK:

  • Create survey forms using Build or XLSForm
  • Upload forms to an Aggregate server
  • Load forms into Collect on an Android device
  • Use Collect to fill out forms with :term:`participants <participant>`
  • Upload survey data from Collect to Aggregate
  • Analyse or export data in Aggregate

This requires:

Tip

While this is the typical use pattern, it is not the only way to do things. For example:

  • Forms can be created using tools other than Build or XLSForm
  • Forms can be uploaded directly to Collect, without using Aggregate

ODK is a very flexible set of tools, and organizations will find their own best practices for adopting it.

Install Collect

The easiest way to install the ODK Collect App is to get it from the Google Play store.

For other installation options, see :ref:`installing-collect` in the :doc:`collect-guide`.

Installing Aggregate

The easiest, recommended way to setup an ODK Aggregate instance is to use Google App Engine and the ODK Aggregate Installer.

You'll set up a new Google Cloud project, and then run the install utility locally. This will connect to your Google Cloud account and install Aggregate there.

For full details, and other installation methods, see the :doc:`ODK Aggregate Installation and Setup Guide <aggregate-install>`.

You can also watch this video which explains the installation procedure of ODK Aggregate on Google App Engine and also this Aggregate tutorial video which describes few of its functionalities.

Create and Upload Survey Forms with ODK Build

The quickest and easiest way to start using your own survey forms is to create them online with ODK Build. To create a form, you can follow the steps below or watch this tutorial which explains the creation process.

Tip

Load, Complete, and Upload a Form with ODK Collect

Now, you should be able to log back into your ODK Aggregate instance and see your completed survey results.