使用 KoboToolbox 节点自动执行 KoboToolbox 中的工作，并将 KoboToolbox 与其他应用程序集成。n8n 内置支持各种 KoboToolbox 功能，包括创建、更新、删除和获取文件、表单、挂钩和提交。
在此页面上，您将找到 KoboToolbox 节点支持的操作列表以及更多资源的链接。
运营
模板和示例
没有任何
选项
查询选项
查询提交操作支持查询选项：
- 在“参数”面板的主要部分中：
- 控制查询的起始索引偏移量（以使用 API 分页逻辑）。
- 设置返回的最大记录数。请注意，无论您提供的值是多少，API 始终限制返回的记录数为 30,000 条。
- 在查询选项部分，您可以激活以下参数：
- 允许您以 MongoDB 的 JSON 查询格式指定过滤谓词。例如：
提交- ，并且提交时间在 2021 年 11 月 1 日 01:02:03 之前。
- 允许您以 MongoDB 的 JSON 格式提供排序条件列表。例如，
有关这些选项的更多详细信息，请参阅
Formhub API 文档
提交选项
所有返回表单提交数据的操作都提供了调整响应的选项。这些选项包括：
- 下载选项允许您下载与每个特定表单提交相关的任何附件，例如图片和视频。它还允许您选择命名模式和要下载的文件大小（如果可用 - 通常用于图像）。
- 格式化选项执行一些重新格式化操作，如关于重新格式化中所述。
KoboToolbox 提交数据的默认 JSON 格式有时很难处理，因为它不具备模式感知能力，因此所有字段都以字符串形式返回。
此节点提供了一种轻量级的、自定的重新格式化逻辑，通过
Reformat?参数启用，可用于返回表单提交的所有操作：提交查询、获取和附件下载操作。
启用后，重新格式化：
- 根据表单的分组，将 JSON 重新组织为多级层次结构。默认情况下，问题分组层次结构由字段名称中的字符具体化，例如。启用重新格式化后，n8n 会将这些字符重新组织为，作为嵌套的 JSON 对象。
- 将字段重命名为 trim （许多下游系统不支持）。
- 将所有地理空间字段（点、线和区域问题类型）解析为其标准 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
}
|
启用重新格式化，并使用适当的多选和数字格式掩码（例如，和），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 操作。