เริ่มต้นใช้งาน — การนำเข้าข้อมูลจำนวนมากครั้งแรกของคุณ¶

คู่มือนี้ตั้งสมมติฐานว่า Q5 (รายงาน PM ประจำปีสำหรับ HA) ติดตั้งแล้ว (ข้อมูลตั้งต้น 82 ชั้นของ MoPH จำเป็นแม้สำหรับการนำเข้าผู้ขาย / สถานที่ — เป็น dependency ของโมดูล)

ขั้นที่ 1 — เปิดวิซาร์ด¶

Maintenance → Configuration → Mass-Import Upload

ฟอร์มชั่วคราว 3 ขั้นจะเปิดขึ้น:

ขั้น	สิ่งที่เกิดขึ้น
1. Upload	เลือกประเภทออบเจกต์ + แนบ XLSX
2. Preview	การทดลองรันทำงานฝั่งเซิร์ฟเวอร์; แสดงคำตัดสินต่อแถว
3. Result	ตัวนับการยืนยันการนำเข้า + ลิงก์ไปยังเรกคอร์ดชุดข้อมูล (batch)

ขั้นที่ 2 — ดาวน์โหลดเทมเพลต¶

คลิก ↓ Download Template ที่ขั้นที่ 1 (หรือใช้เมนูแยกต่างหาก Maintenance → Configuration → Download Import Template) เซิร์ฟเวอร์ จะสร้าง XLSX ใหม่จากสคีมาของโมเดลสด — ไม่มีไฟล์เทมเพลตแบบสแตติกมาพร้อม โมดูล ดังนั้นการเพิ่มฟิลด์ในอนาคตจะไม่คลาดเคลื่อน

แต่ละเทมเพลตมี:

แถวที่ 1 — ส่วนหัวคอลัมน์ (เติมสีแดงบนช่องที่จำเป็น, สีน้ำเงินบนช่องที่ไม่บังคับ) ส่วนหัวแปลตามภาษาในเซสชันของคุณ (TH หรือ EN)
แถวที่ 2 — ข้อความช่วยเหลือสีเทาตัวเอียงต่อคอลัมน์ จะปล่อยไว้ก็ได้ (parser ข้ามอย่างเงียบ ๆ ตอนอัปโหลด) หรือจะลบก็ได้
แถวที่ 3+ — ข้อมูลของคุณ

สำหรับเทมเพลตครุภัณฑ์ ชีตที่ซ่อนไว้ __moph_classes มีแคตตาล็อก 82 ชั้น ของ MoPH ฉบับเต็มพร้อม name_en / name_th / risk_tier / pm_freq_months ดรอปดาวน์ data-validation ของ Excel อ้างอิงชีตนี้บน คอลัมน์ MoPH-class

ขั้นที่ 3 — กรอกข้อมูลของคุณ¶

เริ่มจากเล็ก ๆ — ไฟล์ผู้ขาย 5–10 แถวเป็นการทดสอบครั้งแรกที่ง่ายที่สุด ตัวอย่าง (แสดงส่วนหัวภาษาอังกฤษ):

Vendor Name	Tax ID (VAT)	Country Code	Email
Acme Medical Co	TH0123456789	TH	sales@acme.co.th
Siemens Thailand	TH9988776655	TH

ปล่อย External ID ว่างไว้ — Odoo สร้างให้อัตโนมัติเมื่อเรกคอร์ดถูกสร้าง (พฤติกรรมการนำเข้ามาตรฐาน) คอลัมน์ Vendor Name จำเป็น; อย่างอื่นไม่บังคับ

ขั้นที่ 4 — อัปโหลดและดูตัวอย่าง¶

กลับมาที่ขั้นที่ 1: เลือก Vendor, แนบไฟล์ของคุณ, คลิก Next: Preview

การทดลองรันรายงาน:

Summary: 2 OK · 0 WARN · 0 FAIL (2 total rows)

Row	Verdict	Match	Reason
2	OK	create new (vat)	—
3	OK	create new (name_country)	—

คอลัมน์ Match บอกคุณว่าจะเกิดอะไรขึ้นตอนยืนยันการนำเข้า: - create new (vat) — ไม่มีพาร์ตเนอร์ที่มีอยู่จับคู่กับคีย์ธุรกิจ VAT; แถวนี้จะถูกแทรก - upsert #42 (vat) — พาร์ตเนอร์ id 42 จับคู่กับ VAT; แถวนี้จะถูก อัปเดตในที่

ขั้นที่ 5 — ยืนยันการนำเข้า¶

คลิก Commit Batch การยืนยันการนำเข้าที่ห่อด้วย savepoint จะเขียน พาร์ตเนอร์ใหม่ 2 ราย, แท็กทั้งคู่ด้วย roots_hemms_import_batch_id ที่ชี้ ไปยังชุดข้อมูล (batch) ที่คุณเพิ่งสร้าง และโพสต์สรุปบนแชตเตอร์ (chatter) ของชุดข้อมูล (batch)

ขั้นที่ 3 แสดง:

Records created: 2
Records updated: 0
Committed at:    2026-05-22 14:32:11

คลิก Open Batch เพื่อตรวจสอบร่องรอยการตรวจสอบ

ขั้นที่ 6 — ตรวจสอบ¶

Contacts → list view → กรองด้วย "Q6 Test" → เห็นผู้ขายทั้งสองรายพร้อม VAT, ประเทศ และฟิลด์ "Import Batch" ใหม่ที่เติมข้อมูลแล้ว

นั่นคือการเดินทางครบรอบ จากตรงนี้: - อัปโหลดไฟล์เดิมซ้ำ → สร้าง 0, อัปเดต 2 (ทำซ้ำได้ผลเดิม — ดู เวิร์กโฟลว์) - ลบชุดข้อมูล (batch) ภายใน 7 วันเพื่อยกเลิก (ดู เวิร์กโฟลว์) - ไปต่อที่การนำเข้าสถานที่ → จากนั้นครุภัณฑ์ (dependency ของ FK ต้องการลำดับนี้ ดู เวิร์กโฟลว์)