#นำเข้า

#บทนำ

คุณสามารถนำเข้าข้อมูลโดยใช้เทมเพลต Excel ได้ครับ/ค่ะ โดยคุณสามารถกำหนดได้ว่าจะนำเข้าฟิลด์ใดบ้าง และระบบจะสร้างเทมเพลตให้โดยอัตโนมัติ

#คำแนะนำการนำเข้า

#ฟิลด์ประเภทตัวเลข

รองรับค่าตัวเลขและเปอร์เซ็นต์ครับ/ค่ะ ข้อความอย่าง N/A หรือ - จะถูกกรองออกไป

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "ตัวเลข 1": 123,
  "เปอร์เซ็นต์": 0.25,
  "ตัวเลข 2": null,
  "ตัวเลข 3": null,
}

#ฟิลด์ประเภทบูลีน

ข้อความที่รองรับสำหรับการนำเข้า (ภาษาอังกฤษไม่คำนึงถึงตัวพิมพ์เล็ก-ใหญ่) มีดังนี้ครับ/ค่ะ:

• Yes, Y, True, 1, ใช่
• No, N, False, 0, ไม่ใช่

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "Field1": false,
  "Field2": true,
  "Field3": true,
  "Field4": true,
  "Field5": false,
}

#ฟิลด์ประเภทวันที่

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "DateOnly": "2023-01-18T00:00:00.000Z",
  "Local(+08:00)": "2023-01-18T14:22:22.000Z",
  "GMT": "2023-01-18T22:22:22.000Z",
}

#ฟิลด์ประเภทตัวเลือก

ทั้งค่าตัวเลือก (Option Value) และป้ายกำกับตัวเลือก (Option Label) สามารถใช้เป็นข้อความสำหรับนำเข้าได้ครับ/ค่ะ โดยตัวเลือกหลายรายการจะคั่นด้วยเครื่องหมายจุลภาค (, ，) หรือเครื่องหมายวรรคตอน (、)

ตัวอย่างเช่น ฟิลด์ Priority มีตัวเลือกดังนี้ครับ/ค่ะ:

ทั้งค่าตัวเลือกและป้ายกำกับตัวเลือกสามารถใช้เป็นข้อความสำหรับนำเข้าได้ครับ/ค่ะ

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

[{ 优先级: 'high' }, { 优先级: 'low' }];

#ฟิลด์เขตการปกครองของจีน

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "地区1": ["11","1101"],
  "地区2": ["12","1201"]
}

#ฟิลด์ไฟล์แนบ

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "附件": [
    {
      "filename": "logo.png",
      "title": "logo.png",
      "extname": ".png",
      "url": "https://www.nocobase.com/images/logo.png"
    }
  ]
}

#ฟิลด์ประเภทความสัมพันธ์

ข้อมูลหลายรายการจะคั่นด้วยเครื่องหมายจุลภาค (, ，) หรือเครื่องหมายวรรคตอน (、) ครับ/ค่ะ

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "Department": [1], // 1 คือ ID ของเรคคอร์ดแผนกที่มีชื่อว่า "ทีมพัฒนา"
  "Category": [1,2], // 1,2 คือ ID ของเรคคอร์ดหมวดหมู่ที่มีหัวข้อว่า "หมวดหมู่ 1" และ "หมวดหมู่ 2"
}

#ฟิลด์ประเภท JSON

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "JSON": {"key":"value"}
}

#ฟิลด์ประเภทรูปทรงเรขาคณิตบนแผนที่

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "Point": [1,2],
  "Line": [[1,2], [3,4]],
  "Polygon": [[1,2], [3,4], [1,2]],
  "Circle": [1,2,3]
}

#รูปแบบการนำเข้าที่กำหนดเอง

คุณสามารถลงทะเบียน ValueParser ที่กำหนดเองได้ผ่านเมธอด db.registerFieldValueParsers() ครับ/ค่ะ ตัวอย่างเช่น:

import { BaseValueParser } from '@nocobase/database';

class PointValueParser extends BaseValueParser {
  async setValue(value) {
    if (Array.isArray(value)) {
      this.value = value;
    } else if (typeof value === 'string') {
      this.value = value.split(',');
    } else {
      this.errors.push('Value invalid');
    }
  }
}

const db = new Database();

// เมื่อนำเข้าฟิลด์ที่มี type=point ข้อมูลจะถูกแยกวิเคราะห์โดย PointValueParser
db.registerFieldValueParsers({
  point: PointValueParser,
});

ตัวอย่างการนำเข้า

เมื่อแปลงเป็น JSON จะได้ดังนี้ครับ/ค่ะ

{
  "Point": [1,2]
}

#การตั้งค่าแอคชัน

• กำหนดค่าฟิลด์ที่สามารถนำเข้าได้

• กฎการเชื่อมโยง: สำหรับแสดง/ซ่อนปุ่มแบบไดนามิกครับ/ค่ะ
• แก้ไขปุ่ม: สำหรับแก้ไขชื่อ, ประเภท และไอคอนของปุ่มครับ/ค่ะ