kobotoolbox/kobocat

KoBoCAT

从早于https://github.com/kobotoolbox/kobocat/releases/tag/2.020.18%E7%89%88%E6%9C%AC%E5%8D%87%E7%BA%A7%E7%9A%84%E9%87%8D%E8%A6%81%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9

在包括https://github.com/kobotoolbox/kobocat/releases/tag/2.020.18%E5%9C%A8%E5%86%85%E7%9A%84%E7%89%88%E6%9C%AC%E4%B8%AD%EF%BC%8C%E6%9C%AC%E9%A1%B9%E7%9B%AE%EF%BC%88KoBoCAT%EF%BC%89%E5%92%8Chttps://github.com/kobotoolbox/kpi%E5%85%B1%E4%BA%AB%E4%B8%80%E4%B8%AAPostgres%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82%E7%8E%B0%E5%9C%A8%E5%AE%83%E4%BB%AC%E5%90%84%E8%87%AA%E6%8B%A5%E6%9C%89%E7%8B%AC%E7%AB%8B%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82**%E5%A6%82%E6%9E%9C%E6%82%A8%E6%AD%A3%E5%9C%A8%E5%8D%87%E7%BA%A7%E7%8E%B0%E6%9C%89%E5%8D%95%E6%95%B0%E6%8D%AE%E5%BA%93%E5%AE%89%E8%A3%85%EF%BC%8C%E5%BF%85%E9%A1%BB%E6%8C%89%E7%85%A7%E8%BF%99%E4%BA%9B%E8%AF%B4%E6%98%8E%E5%B0%86KPI%E8%A1%A8%E8%BF%81%E7%A7%BB%E5%88%B0%E6%96%B0%E6%95%B0%E6%8D%AE%E5%BA%93%E5%B9%B6%E9%80%82%E5%BD%93%E8%B0%83%E6%95%B4%E9%85%8D%E7%BD%AE%E3%80%82**

如果您目前不想升级，请使用https://github.com/kobotoolbox/kobocat/tree/shared-database-obsolete%E5%88%86%E6%94%AF%E3%80%82

弃用通知

此应用的许多用户面向功能正在迁移至https://github.com/kobotoolbox/kpi。KoBoCAT的数据访问API和OpenRosa功能将保持不变，任何相反计划将提前充分公告。有关更多详情和讨论，请参考<[***]>。

随着功能迁移，我们将在此列出各功能及其最后存在的版本：

• 为确保安全性和稳定性，许多已在KPI中可用、长期未支持或未充分利用的端点已在https://github.com/kobotoolbox/kobocat/releases/tag/2.020.40%E7%89%88%E6%9C%AC%E4%B8%AD%E7%A7%BB%E9%99%A4%E3%80%82%E8%BF%99%E4%BA%9B%E7%AB%AF%E7%82%B9%E4%B8%8E%E5%9B%BE%E8%A1%A8%E5%92%8C%E7%BB%9F%E8%AE%A1%E3%80%81%E8%A1%A8%E5%8D%95%E5%85%8B%E9%9A%86%E3%80%81%E8%A1%A8%E5%8D%95%E5%85%B1%E4%BA%AB%E3%80%81%E7%94%A8%E6%88%B7%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E3%80%81%E7%BB%84%E7%BB%87/%E9%A1%B9%E7%9B%AE/%E5%9B%A2%E9%98%9F%E3%80%81bamboo%E5%92%8Cziggy%E7%9B%B8%E5%85%B3%E3%80%82%E5%AE%8C%E6%95%B4%E5%88%97%E8%A1%A8%E8%AF%B7%E5%8F%82%E8%A7%81REMOVALS.md%E3%80%82%E8%BF%99%E4%BA%9B%E7%AB%AF%E7%82%B9%E6%9C%80%E5%90%8E%E5%9C%A8https://github.com/kobotoolbox/kobocat/releases/tag/2.020.39%E7%89%88%E6%9C%AC%E4%B8%AD%E5%8F%AF%E7%94%A8%E3%80%82
• REST服务 - 改进版本已添加至https://github.com/kobotoolbox/kpi/pull/1864%E3%80%82%E5%8C%85%E5%90%AB%E6%97%A7%E7%89%88REST%E6%9C%8D%E5%8A%A1%E7%9A%84%E6%9C%80%E5%90%8E%E4%B8%80%E4%B8%AAKoBoCAT%E7%89%88%E6%9C%AC%E6%98%AFhttps://github.com/kobotoolbox/kobocat/releases/tag/2.019.39%E3%80%82

关于

KoBoCAT是KoBoToolbox中使用的数据收集平台。它基于Ona LLC开发的优秀http://github.com/onaio/onadata%E5%B9%B3%E5%8F%B0%EF%BC%8C%E8%80%8Conadata%E6%9C%AC%E8%BA%AB%E6%98%AF%E5%93%A5%E4%BC%A6%E6%AF%94%E4%BA%9A%E5%A4%A7%E5%AD%A6%E5%8F%AF%E6%8C%81%E7%BB%AD%E5%B7%A5%E7%A8%8B%E5%AE%9E%E9%AA%8C%E5%AE%A4%E5%BC%80%E5%8F%91%E7%9A%84http://github.com/SEL-Columbia/formhub%E5%B9%B3%E5%8F%B0%E7%9A%84%E9%87%8D%E6%96%B0%E5%BC%80%E5%8F%91%E7%89%88%E6%9C%AC%E3%80%82

有关安装KoBoToolbox的说明，请参考https://github.com/kobotoolbox/kobo-install%E3%80%82

代码结构

• logger - 此应用向ODK Collect和Enketo提供XForms并接收提交数据。
• viewer - 此应用提供logger中存储数据的csv和xls导出功能。该应用使用pyxform生成的数据字典，还提供地图和单个调查视图。
• main - 此应用是连接logger和viewer的纽带。

本地化

从零开始生成区域设置（例如西班牙语）：

sh
$ django-admin.py makemessages -l es -e py,html,email,txt ;
$ for app in {main,viewer} ; do cd kobocat/apps/${app} && django-admin.py makemessages -d djangojs -l es && cd - ; done

更新PO文件：

sh
$ django-admin.py makemessages -a ;
$ for app in {main,viewer} ; do cd kobocat/apps/${app} && django-admin.py makemessages -d djangojs -a && cd - ; done

编译MO文件并更新实时翻译：

sh
$ django-admin.py compilemessages ;
$ for app in {main,viewer} ; do cd kobocat/apps/${app} && django-admin.py compilemessages && cd - ; done

KoBoCAT中的测试

对于kobo-install用户，进入kobo-install文件夹并运行以下命令：

./run.py -cf exec kobocat bash

对于其他用户，使用以下命令进入容器：

sh
$ docker exec -it {{kobocat容器}} /bin/bash

安装开发依赖：

sh
$ pip install -r requirements/dev.pip

运行pytest执行所有自动化测试：

sh
$ pytest