跳到主要内容

KoboToolbox 节点#

认证配置

有关设置身份验证的指南，请参阅 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 请求节点中使用为本服务创建的凭据：

  1. 在 HTTP 请求节点中，选择 认证 > 预定义凭据类型
  2. 选择需要连接的服务
  3. 选择您的凭据

更多信息请参阅 自定义 API 操作