การใช้งาน KoboToolbox

เรียนรู้วิธีใช้ node KoboToolbox ใน n8n ปฏิบัติตามเอกสารทางเทคนิคเพื่อรวม node KoboToolbox เข้ากับ workflow ของคุณ

ใช้ node KoboToolbox เพื่อทำงานอัตโนมัติใน KoboToolbox และรวม KoboToolbox เข้ากับแอปพลิเคชันอื่นๆ n8n มีการสนับสนุนในตัวสำหรับคุณสมบัติ KoboToolbox ที่หลากหลาย รวมถึงการสร้าง อัปเดต การลบ และรับไฟล์ แบบฟอร์ม hooks และการส่ง

ในหน้านี้ คุณจะพบรายการการดำเนินการที่ node KoboToolbox รองรับ และลิงก์ไปยังแหล่งข้อมูลเพิ่มเติม

Credentials

อ้างถึง KoboToolbox credentials สำหรับคำแนะนำในการตั้งค่าการรับรองความถูกต้อง

การดำเนินงาน

• ไฟล์
  • สร้าง
  • ลบ
  • รับ
  • รับมากมาย
• แบบฟอร์ม
  • รับ
  • รับมากมาย
    • ปรับใช้ใหม่
• ตะขอ
  • รับ
  • รับมากมาย
  • บันทึก
  • ลองอีกครั้งทั้งหมด
  • ลองอีกครั้งหนึ่ง
• การส่ง
  • ลบ
  • รับ
  • รับมากมาย
  • รับสถานะการตรวจสอบ
  • อัปเดตสถานะการตรวจสอบ

เทมเพลตและตัวอย่าง

เรียกดูเทมเพลตการรวมเอกสาร node KoboToolbox หรือ ค้นหาเทมเพลตทั้งหมด

ตัวเลือก

Query Options

การดำเนินการส่งแบบสอบถามสนับสนุนตัวเลือกแบบสอบถาม:

• ในส่วนหลักของ Parameters แผงหน้าปัด:
  • Start ควบคุมการชดเชยดัชนีเพื่อเริ่มการสืบค้น (เพื่อใช้ตรรกะ pagination API)
  • Limit กำหนดจำนวนระเบียนสูงสุดที่จะส่งคืน โปรดทราบว่า API จะมีขีดจำกัดที่ส่งคืนระเบียน 30,000 รายการเสมอ ไม่ว่าคุณจะระบุค่าใดก็ตาม
• ใน Query Options ส่วน คุณสามารถเปิดใช้งาน parameter ต่อไปนี้:
  • Query ช่วยให้คุณระบุภาคแสดงตัวกรองในรูปแบบแบบสอบถาม JSON ของ MongoDB ตัวอย่างเช่น: {"status": "success", "_submission_time": {"$lt": "2021-11-01T01:02:03"}} สอบถามการส่งทั้งหมดด้วยค่า success สำหรับสนาม status และส่งก่อนวันที่ 1 พฤศจิกายน 2021, 01:02:03 น.
  • Fields ช่วยให้คุณระบุรายการฟิลด์ที่คุณต้องการดึงข้อมูล เพื่อให้การตอบกลับเบาลง
  • Sort ช่วยให้คุณระบุรายการเกณฑ์การเรียงลำดับในรูปแบบ MongoDB JSON ตัวอย่างเช่น {"status": 1, "_submission_time": -1} ระบุลำดับการจัดเรียงตามสถานะจากน้อยไปมาก จากนั้นจึงส่งเวลาจากมากไปน้อย

รายละเอียดเพิ่มเติมเกี่ยวกับตัวเลือกเหล่านี้สามารถพบได้ใน เอกสาร Formhub API

ตัวเลือกการส่ง (Submission options)

การดำเนินการทั้งหมดที่ส่งคืนข้อมูลการส่งแบบฟอร์มเสนอตัวเลือกในการปรับแต่งการตอบสนอง ซึ่งรวมถึง:

• ตัวเลือกการดาวน์โหลดช่วยให้คุณสามารถดาวน์โหลดไฟล์แนบที่เชื่อมโยงกับการส่งแบบฟอร์มแต่ละรายการ เช่น รูปภาพและวิดีโอ นอกจากนี้ยังให้คุณเลือกรูปแบบการตั้งชื่อและขนาดไฟล์ที่จะดาวน์โหลด (หากมี - โดยทั่วไปสำหรับรูปภาพ)
• ตัวเลือกการจัดรูปแบบจะดำเนินการฟอร์แมตใหม่ตามที่อธิบายไว้ใน เกี่ยวกับการฟอร์แมตใหม่ .

เกี่ยวกับการฟอร์แมตใหม่ (About reformatting)

รูปแบบ JSON เริ่มต้นสำหรับข้อมูลการส่ง KoboToolbox บางครั้งจัดการได้ยาก เนื่องจากไม่รับรู้สคีมา ดังนั้นฟิลด์ทั้งหมดจึงส่งคืนเป็น string

node นี้จัดเตรียมตรรกะการจัดรูปแบบใหม่ที่เน้นความคิดเห็นแบบน้ำหนักเบา ซึ่งเปิดใช้งานด้วย Reformat? parameter พร้อมใช้งานในการดำเนินการทั้งหมดที่ส่งคืนการส่งแบบฟอร์ม: แบบสอบถามการส่ง รับ และการดำเนินการดาวน์โหลดไฟล์แนบ

เมื่อเปิดใช้งาน การจัดรูปแบบใหม่:

• จัดระเบียบ JSON ใหม่เป็นลำดับชั้นหลายระดับตามกลุ่มของแบบฟอร์ม ตามค่าเริ่มต้น ลำดับชั้นของการจัดกลุ่มคำถามจะเกิดขึ้นโดย a / อักขระในชื่อฟิลด์ เป็นต้น Group1/Question1 . เมื่อเปิดใช้งานการฟอร์แมตใหม่ n8n จะจัดระเบียบสิ่งเหล่านี้ใหม่เป็น Group1.Question1 เป็นวัตถุ JSON ที่ซ้อนกัน
• เปลี่ยนชื่อฟิลด์ที่จะตัดแต่ง _ (ไม่รองรับระบบดาวน์สตรีมหลายระบบ)
• แยกวิเคราะห์ฟิลด์ภูมิสารสนเทศทั้งหมด (ประเภทคำถามจุด เส้น และพื้นที่) ให้เทียบเท่ากับ GeoJSON มาตรฐาน
• แยกฟิลด์ทั้งหมดที่ตรงกับฟิลด์ใดฟิลด์หนึ่ง Multiselect Mask มาสก์ไวด์การ์ดลงใน array เนื่องจากฟิลด์แบบเลือกหลายรายการปรากฏเป็น string ที่คั่นด้วยช่องว่าง จึงไม่สามารถคาดเดาตามอัลกอริทึมได้ ดังนั้นคุณจึงต้องจัดเตรียมรูปแบบการตั้งชื่อฟิลด์ จัดรูปแบบมาสก์เป็นรายการที่คั่นด้วยเครื่องหมายจุลภาค รายการสนับสนุน * ไวด์การ์ด
• แปลงฟิลด์ทั้งหมดที่ตรงกับฟิลด์ใดฟิลด์หนึ่ง Number Mask มาสก์ไวด์การ์ดลงใน JSON float

นี่คือตัวอย่างโดยละเอียดใน JSON:

{
  "_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 แยกวิเคราะห์เป็น:

{
  "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
}

จะทำอย่างไรถ้าการดำเนินการของคุณไม่รองรับ

หาก node นี้ไม่สนับสนุนการดำเนินการที่คุณต้องการ คุณสามารถใช้ HTTP Request เพื่อเรียก API ของบริการ

คุณสามารถใช้ credentials ที่คุณสร้างขึ้นสำหรับบริการนี้ใน node คำขอ HTTP:

1. ใน node คำขอ HTTP ให้เลือก Authentication > Predefined Credential Type.
2. เลือกบริการที่คุณต้องการเชื่อมต่อ
3. เลือกข้อมูลประจำตัวของคุณ

อ้างถึง Custom API actions for existing nodes สำหรับข้อมูลเพิ่มเติม