/aggregate

ODK Aggregate Wiki and Issues ( https://github.com/opendatakit/opendatakit/ )

Primary LanguageJavaApache License 2.0Apache-2.0

ODK Aggregate

Platform License Slack status

(The previous Eclipse based version of this project is in commit #f110aa)

ODK Aggregate provides a ready-to-deploy server and data repository to:

  • provide blank forms to ODK Collect (or other OpenRosa clients),
  • accept finalized forms (submissions) from ODK Collect and manage collected data,
  • visualize the collected data using maps and simple graphs,
  • export data (e.g., as CSV files for spreadsheets, or as KML files for Google Earth), and
  • publish data to external systems (e.g., Google Spreadsheets or Google Fusion Tables).

ODK Aggregate can be deployed on Google's App Engine, enabling users to quickly get running without facing the complexities of setting up their own scalable web service. ODK Aggregate can also be deployed locally on a Tomcat server (or any servlet 2.5-compatible (or higher) web container) backed with a MySQL or PostgreSQL database server.

Release cycle

TBD

Setting up your development environment

  1. Download and install Git and add it to your PATH

  2. Download and install IntelliJ

  3. Fork the Aggregate project (why and how to fork)

  4. Clone your fork of the project locally. At the command line:

     git clone https://github.com/YOUR-GITHUB-USERNAME/aggregate
    

If you prefer not to use the command line, you can use IntelliJ to create a new project from version control using https://github.com/YOUR-GITHUB-USERNAME/aggregate.

Now you can open the project in the folder of your clone from IntelliJ and follow the IntelliJ setup instructions

Be sure to read other documents:

Contributing

Any and all contributions to the project are welcome. ODK Aggregate is used across the world primarily by organizations with a social purpose so you can have real impact!

If you're ready to contribute code, see the contribution guide.

The best way to help us test is to build from source! We are currently focusing on stabilizing the build process.

  • We are transitioning from an Eclipse/Ant build to a Gradle fully automated build system. If you have experience in GWT, Gradle or Google App Engine you probably can help us improve the build process and development flow.

  • We are focusing on Google App Engine and Tomcat 8.0 + PostgreSQL support. You can help by building and testing Aggregate with other RDBs like MySQL and SQLServer.