KoboToolbox 节点#
认证配置
有关设置身份验证的指南，请参阅 KoboToolbox 认证配置。
操作功能#
- 文件
- 创建
- 删除
- 获取单个
- 获取多个
- 表单
- 获取单个
- 获取多个
- 重新部署
- 钩子
- 获取单个
- 获取多个
- 查看日志
- 全部重试
- 单条重试
- 删除
- 获取单个
- 获取多个
- 获取验证状态
- 更新验证状态
模板与示例#
配置选项#
查询选项#
- 在参数面板主区域：
- 起始位置 控制查询起始的索引偏移量（用于API分页逻辑）
- 限制数量 设置返回记录的最大数量。注意API始终限制返回30,000条记录，与设置值无关
- 在查询选项区域可启用以下参数：
- 字段筛选 可指定需要获取的字段列表以减轻响应负载
更多选项详情请参阅 Formhub API 文档
- 格式化选项提供数据重构功能，具体说明参见关于数据重构
关于数据重构#
启用重构后将实现：
- 按照表单组结构将JSON重组为多级层次。默认情况下，问题分组层次通过字段名中的
/字符体现（例如Group1/Question1）。启用重构后，n8n会将其重组为嵌套JSON对象格式Group1.Question1 - 移除字段名中的
_字符（许多下游系统不支持该字符） - 将所有地理空间字段（点、线、面问题类型）解析为标准GeoJSON格式
- 将匹配多选掩码通配符掩码的所有字段拆分为数组。由于多选字段以空格分隔的字符串形式显示，算法无法自动识别，需手动提供字段命名掩码。掩码格式为逗号分隔的列表，支持
*通配符 - 将匹配数字掩码通配符掩码的所有字段转换为JSON浮点数类型
以下是详细的JSON示例：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
|
{ "_id": 471987, "formhub/uuid": "189436bb09a54957bfcc798e338b54d6", "start": "2021-12-05T16:13:38.527+02:00", "end": "2021-12-05T16:15:33.407+02:00", "Field_Details/Field_Name": "Test Fields", "Field_Details/Field_Location": "-1.932914 30.078211 1421 165", "Field_Details/Field_Shape": "-1.932914 30.078211 1421 165;-1.933011 30.078085 0 0;-1.933257 30.078004 0 0;-1.933338 30.078197 0 0;-1.933107 30.078299 0 0;-1.932914 30.078211 1421 165", "Field_Details/Crops_Grown": "maize beans avocado", "Field_Details/Field_Size_sqm": "2300", "__version__": "veGcULpqP6JNFKRJbbMvMs", "meta/instanceID": "uuid:2356cbbe-c1fd-414d-85c8-84f33e92618a", "_xform_id_string": "ajXVJpBkTD5tB4Nu9QXpgm", "_uuid": "2356cbbe-c1fd-414d-85c8-84f33e92618a", "_attachments": [], "_status": "submitted_via_web", "_geolocation": [ -1.932914, 30.078211 ], "_submission_time": "2021-12-05T14:15:44", "_tags": [], "_notes": [], "_validation_status": {}, "_submitted_by": null }
启用重新格式化功能，并配置相应的多选与数值格式化掩码（例如分别使用 Crops_* 和 *_sqm），n8n 会将其解析为：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
|
{ "id": 471987, "formhub": { "uuid": "189436bb09a54957bfcc798e338b54d6" }, "start": "2021-12-05T16:13:38.527+02:00", "end": "2021-12-05T16:15:33.407+02:00", "Field_Details": { "Field_Name": "Test Fields", "Field_Location": { "lat": -1.932914, "lon": 30.078211 }, "Field_Shape": { "type": "polygon", "coordinates": [ { "lat": -1.932914, "lon": 30.078211 }, { "lat": -1.933011, "lon": 30.078085 }, { "lat": -1.933257, "lon": 30.078004 }, { "lat": -1.933338, "lon": 30.078197 }, { "lat": -1.933107, "lon": 30.078299 }, { "lat": -1.932914, "lon": 30.078211 } ] }, "Crops_Grown": [ "maize", "beans", "avocado" ], "Field_Size_sqm": 2300 }, "version": "veGcULpqP6JNFKRJbbMvMs", "meta": { "instanceID": "uuid:2356cbbe-c1fd-414d-85c8-84f33e92618a" }, "xform_id_string": "ajXVJpBkTD5tB4Nu9QXpgm", "uuid": "2356cbbe-c1fd-414d-85c8-84f33e92618a", "attachments": [], "status": "submitted_via_web", "geolocation": { "lat": -1.932914, "lon": 30.078211 }, "submission_time": "2021-12-05T14:15:44", "tags": [], "notes": [], "validation_status": {}, "submitted_by": null }
操作不受支持时的解决方案#
若当前节点不支持您要执行的操作，可使用 HTTP 请求节点 调用服务的 API。
您可以在 HTTP 请求节点中使用为本服务创建的凭据：
- 在 HTTP 请求节点中，选择 认证 > 预定义凭据类型
- 选择需要连接的服务
- 选择您的凭据
更多信息请参阅 自定义 API 操作