kobotoolbox/kobocat Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

KoBoCAT

从早于2.020.18版本升级的重要注意事项

在包括2.020.18在内的版本中，本项目（KoBoCAT）和KPI共享一个Postgres数据库。现在它们各自拥有独立数据库。如果您正在升级现有单数据库安装，必须按照这些说明将KPI表迁移到新数据库并适当调整配置。

如果您目前不想升级，请使用shared-database-obsolete分支。

弃用通知

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

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

• 为确保安全性和稳定性，许多已在KPI中可用、长期未支持或未充分利用的端点已在2.020.40版本中移除。这些端点与图表和统计、表单克隆、表单共享、用户配置文件、组织/项目/团队、bamboo和ziggy相关。完整列表请参见REMOVALS.md。这些端点最后在2.020.39版本中可用。
• REST服务 - 改进版本已添加至KPI。包含旧版REST服务的最后一个KoBoCAT版本是2.019.39。

关于

KoBoCAT是KoBoToolbox中使用的数据收集平台。它基于Ona LLC开发的优秀onadata平台，而onadata本身是哥伦比亚大学可持续工程实验室开发的formhub平台的重新开发版本。

有关安装KoBoToolbox的说明，请参考kobo-install。

代码结构

• 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