معرفی شرکت ها
django-odk-1.1.6
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Django Data Collection tool using ODK Collect mobile App
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-odk-1.1.6 |
| نام | django-odk |
| نسخه کتابخانه | 1.1.6 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Patrick HOUBEN |
| ایمیل نویسنده | p.houben@cra.wallonie.be |
| آدرس صفحه اصلی | https://github.com/openHBP/django-odk |
| آدرس اینترنتی | https://pypi.org/project/django-odk/ |
| مجوز | GPL-3.0-or-later |
# 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)
- [XLSForm](https://xlsform.org/en/) file with 3 tabs 'survey', 'choices', 'settings'
NEW from version 1.0.2 (xls2xml & create final model)
- Since most of Xforms are using `geopoint`, the database must be set up **with vector geodatabase functionality**: PostGIS, Oracle Spatial, SQLite/SpatiaLite
- **Java Runtime Environment (JRE)** installed `$ sudo apt install default-jre` for XForm validation used by [xlsconv](https://github.com/wq/xlsform-converter)
## Installation
* Run
```bash
$ pip install django-odk
$ python manage.py migrate
$ python manage.py createsuperuser
```
* Add odk and odkdata to your INSTALLED_APPS settings
```py
INSTALLED_APPS = (
...
'odk',
'odkdata',
)
```
* Add LOCALE_PATHS and appropriate language_code in settings
```py
LOCALE_PATHS = [os.path.join(BASE_DIR, 'odk', 'locale')]
LANGUAGE_CODE = 'en'
# translated LANGUAGE_CODE: fr
```
* Add appropriate AUTH_USER_MODEL in settings.py
```py
AUTH_USER_MODEL = 'auth.user'
```
* For a more interactive app, configure **logging** as explained in [Lincoln Loop](https://lincolnloop.com/blog/django-logging-right-way/) and **messages** as explained in [Django](https://docs.djangoproject.com/en/4.0/ref/contrib/messages/)
* For **logging**, add `odk` and `odkdata` entry to `loggers` key of your logging file and adapt `handlers` according to yours.
```py
'loggers': {
...
'odk': {
'handlers': ['console', 'debugger', 'warning', 'error'],
'level': 'DEBUG' if DEBUG else 'INFO',
'propagate': False,
},
'odkdata': {
'handlers': ['console', 'debugger', 'warning', 'error'],
'level': 'DEBUG' if DEBUG else 'INFO',
'propagate': False,
},
}
```
* Add **is_odk_admin** and **is_odk_user** property to your AUTH_USER_MODEL (django.contrib.auth.models file or specific accounts.models)
```py
@property
def is_odk_admin(self):
return self.groups.filter(name='odk-admin').exists()
@property
def is_odk_user(self):
return self.groups.filter(name='odk-user').exists()
```
* Add odk.urls to the main urls.py file:
```py
urlpatterns = [
...
path('odk/', include('odk.urls'), name='odk'),
]
```
* Add menu or buttons to access **Available form**
```py
# bootstrap5 menu item example
<li><a class="dropdown-item" href="{% url 'odk:xform_list' %}">{% trans "ODK available forms" %}</a></li>
```
* Add menu or buttons to access **Submitted form**
```py
# bootstrap5 menu item example
<li><a class="dropdown-item" href="{% url 'odk:xformsubmit_list' %}">{% trans "ODK submitted forms" %}</a></li>
```
## Connect to the Django admin site
* create a group 'odk-admin' with create, read, update access on odk objects
* Associate this group to the appropriate users
## Available form: Build, Upload, Convert, Create
Connect to django-odk => **Available form** => Add and follow 4 steps:
1. **Build** an XLSForm file with 3 tabs 'survey', 'choices', 'settings' [Cfr documentation](https://docs.getodk.org/xlsform/). Do not forget to add 'today' & 'username' fields in Survey tab!
2. **Upload** xlsx file (XForm) by clicking on 'Choose file' and Save
3. **Convert** xlsx file to xml XForm compatible file [Thanks pyxform!](https://github.com/XLSForm/pyxform) If it is not working in production (504 Geteway timeout), xml (previously created from [XLSForm Online](https://getodk.org/xlsform/)) can be uploaded manually from admin site.
From this point, 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/)
4. **Create** Model in odkdata to get submitted data in a model formatted like xlsx form. [Thanks xlsconv!](https://github.com/wq/xlsform-converter)! Model creation is done into App `odkdata` with table name followed by `_orig` suffix when converted by xlsconv.
## Submitted form
Go to **Submitted form** menu of your server to see submitted data in XML format. On record view, click on `Insert` button to insert submitted XML data into `odkdata.models` created on step 4 hereabove.
Several record insert is available through admin interface. Select appropriate records (ie: those without insert date) and choose `Insert in odkdata model` from action dropdown list and click on 'Send' button.
# What next?
Create a new app in you project like `odkdata2` with `templates, views` (importing odkdata.models info) and `urls` to manage display/map/export-xls/update/analyse submitted data from ODK-Collect!
* Do not forget to add `odkdata2` logger specifications in settings.py
Comments/Improvements welcome!
Investigate [WQ Framework](https://wq.io/) but I still don't see how to deploy offline forms on smartphone.
نیازمندی
| مقدار | نام |
|---|---|
| <4.0,>=2.2 | django |
| <2.0,>=1.11 | django-braces |
| <2.0,>=1.10.0 | pyxform |
| <2.0,>=1.3.0 | xlsconv |
| <9.9,>=9.1.1 | pillow |
| <9.0.0,>=4.9.0 | lxml |
نحوه نصب
نصب پکیج whl django-odk-1.1.6:
pip install django-odk-1.1.6.whl
نصب پکیج tar.gz django-odk-1.1.6:
pip install django-odk-1.1.6.tar.gz