Metadata-Version: 2.1
Name: django-odk
Version: 0.1.6
Summary: Django Data Collection tool using ODK Collect mobile App
Home-page: https://github.com/openHBP/django-odk
Author: Patrick HOUBEN
Author-email: p.houben@cra.wallonie.be
License: GPL-3.0-or-later
Platform: Linux
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: Framework :: Django
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
Requires-Dist: django (<4.0,>=2.2)
Requires-Dist: django-braces (<2.0,>=1.11)
Requires-Dist: lxml (<4.9.0,>=4.4.0)

# django-odk
Django data collection tool using [ODK-collect](https://play.google.com/store/apps/details?id=org.odk.collect.android&hl=en_US&gl=US) mobile app.


## Prerequisite
- Django web site up and running
- Smartphone or tablet with [ODK-Collect installed](https://play.google.com/store/apps/details?id=org.odk.collect.android&hl=en_US&gl=US)
- Set of forms in [Xforms](https://xlsform.org/en/) format available in xml. Use https://getodk.org/xlsform/ to validate and export your forms in xml format.


## Installation
Run

```bash
$ pip install django-odk
$ python manage.py migrate
$ python manage.py createsuperuser
```

Add django_odk to your INSTALLED_APPS setting:

```py
INSTALLED_APPS = (
    ...
    'odk',
)
```

Add the following variables to settings.py
```py
# django-odk app
AVAILABLE_TXT = 'Available form'
SUBMITTED_TXT = 'Submitted form'
```

Add odk.urls to the main urls.py file:

```py
urlpatterns = [
    ...
    path('odk/', include('odk.urls'), name='odk'),
]
```

## Upload Xforms
Connect to django-odk => **Available form** => Add and follow instructions to upload xml forms

Once it is done, you are ready to go with form encoding on your smartphone!

> Follow [ODK instructions](https://docs.getodk.org/collect-connect/#configure-server-manually) to configure the connexion to the server

> Get, fill-in and submit data [using ODK Collect](https://docs.getodk.org/collect-using/)

## Get submitted data on server
Go to **Submitted form** menu of your server to see submitted data





