วิธีการย้ายข้อมูลจากการติดตั้งแบบเก่า

คู่มือนี้จะนำเข้าข้อมูลที่มีอยู่ของคุณจากการติดตั้ง HandyCafe V3 หรือ V4 รุ่นเก่าไปยังเซิร์ฟเวอร์ HandyCafe รุ่นใหม่ การย้ายข้อมูลนี้จะไม่ทำลายแหล่งที่มา: ไฟล์ต้นฉบับจะไม่ถูกแก้ไขหรือลบ

การย้ายฐานข้อมูลทำงานได้เฉพาะบน Windows การสนับสนุนการทำงานสำหรับลูกค้าเก่าเพื่อเชื่อมต่อผ่านโปรโตคอลเดิมทำงานได้บนทุกแพลตฟอร์ม (ดู การตั้งค่าลูกค้าเก่า)

สิ่งที่คุณจะต้องมี

• เครื่อง Windows ที่มีทั้งการติดตั้งแบบเก่าและเซิร์ฟเวอร์ HandyCafe รุ่นใหม่ในระบบเดียวกัน หรือการเข้าถึงไฟล์ฐานข้อมูลแบบเก่า
• สิทธิ์ผู้ดูแลระบบในเซิร์ฟเวอร์ HandyCafe
• เซิร์ฟเวอร์แบบเก่าหยุดทำงาน ฐานข้อมูลต้นฉบับไม่ควรถูกเขียนระหว่างการย้ายข้อมูล
• พื้นที่ดิสก์ว่างอย่างน้อยเท่ากับขนาดของฐานข้อมูลแบบเก่า (สำหรับสำเนาฐานข้อมูล HandyCafe ใหม่)
• เวลาที่ไม่ถูกรบกวน 10 ถึง 30 นาที การย้ายข้อมูลในชุดข้อมูลขนาดใหญ่สามารถใช้เวลาหลายนาที อย่าปิด HandyCafe ระหว่างการทำงาน

ขั้นตอนที่ 1: หยุดเซิร์ฟเวอร์แบบเก่า

เปิดแอปพลิเคชันเซิร์ฟเวอร์ HandyCafe แบบเก่า หยุดทุกเซสชันและออกจากแอปพลิเคชัน หากเซิร์ฟเวอร์แบบเก่าทำงานเป็นบริการ Windows ให้หยุดบริการจาก services.msc

ผลลัพธ์ที่คาดหวัง: กระบวนการเซิร์ฟเวอร์แบบเก่าไม่ทำงานอีกต่อไป ไฟล์ฐานข้อมูลไม่ถูกเปิดค้างไว้

ขั้นตอนที่ 2: เปิดหน้าการตั้งค่าลูกค้าเก่า

1. เปิด HandyCafe
2. เปิด Settings ในแถบด้านข้าง
3. คลิก Legacy Clients
4. เลื่อนลงไปที่ส่วน Database Migration

ผลลัพธ์ที่คาดหวัง: หากระบบตรวจพบการติดตั้งแบบเก่า หน้าจะแสดงเส้นทางการติดตั้ง, เส้นทางฐานข้อมูล, เวอร์ชันเซิร์ฟเวอร์, และจำนวนไฟล์ INI หากไม่มีการตรวจพบ หน้าจะแสดงว่า "ไม่พบการติดตั้งแบบเก่า" ในกรณีนั้น ให้ตรวจสอบว่าไฟล์แบบเก่าอยู่ในตำแหน่งมาตรฐานเช่น Program Files\HandyCafe หรือ C:\HandyCafe

ขั้นตอนที่ 3: ตรวจสอบการติดตั้งที่ตรวจพบ

ตรวจสอบว่าค่าที่ตรวจพบตรงกับการติดตั้งแบบเก่าที่คุณรู้จัก:

หากฟิลด์ใดผิด ให้ปิด HandyCafe แก้ไขการติดตั้ง และเปิดใหม่

ขั้นตอนที่ 4: ตรวจสอบฟิลด์การเข้ารหัส

ก่อนที่จะรันการย้ายข้อมูล ยืนยันว่าฟิลด์ Encoding ในส่วน Runtime Protocol ถูกตั้งค่าอย่างถูกต้องสำหรับข้อมูลต้นฉบับของคุณ ซึ่งอยู่ในหน้าเดียวกันด้านบน

หากคุณเปลี่ยนการเข้ารหัส ให้คลิกบันทึกก่อนดำเนินการต่อ

ผลลัพธ์ที่คาดหวัง: สตริงต้นทางจะถูกถอดรหัสอย่างถูกต้องระหว่างการย้ายข้อมูล ซึ่งจะหลีกเลี่ยงผลลัพธ์ completed_with_warnings

ขั้นตอนที่ 5: เริ่มการย้ายข้อมูล

1. คลิก Start Migration
2. หน้าต่างแสดงความคืบหน้าจะเปิดขึ้น มันจะแสดงเฟสปัจจุบันและจำนวนแถวที่ประมวลผลจนถึงตอนนี้
3. อย่าปิด HandyCafe หรือทำให้คอมพิวเตอร์เข้าสู่โหมดสลีป
4. รอจนเสร็จสิ้น ชุดข้อมูลขนาดเล็กจะเสร็จในเวลาน้อยกว่าหนึ่งนาที ชุดข้อมูลขนาดใหญ่สามารถใช้เวลา 5 ถึง 10 นาที

ผลลัพธ์ที่คาดหวัง: หน้าต่างแสดงความคืบหน้าปิดและสถานะเปลี่ยนเป็น completed หรือ completed_with_warnings การแจ้งเตือนปรากฏยืนยันการทำงาน

ขั้นตอนที่ 6: ตรวจสอบจำนวนที่ย้ายข้อมูลแล้ว

หลังจากเสร็จสิ้น หน้าจะแสดงจำนวนบันทึกที่ย้ายข้อมูลแล้ว:

คลิกที่ตัวขยายรายละเอียดเพื่อดูการแบ่งย่อยทั้งหมด ตรวจสอบว่าจำนวนดูสมเหตุสมผลตามที่คุณคาดหวัง

ผลลัพธ์ที่คาดหวัง: ทั้งสี่หมวดหมู่ (สมาชิก, สินค้า, ออเดอร์, ธุรกรรม) แสดงจำนวนที่ไม่เป็นศูนย์หากแหล่งที่มาของคุณมีข้อมูลในตารางเหล่านั้น

ขั้นตอนที่ 7: จัดการคำเตือน (ถ้ามี)

หากสถานะเป็น completed_with_warnings ขยายรายการคำเตือนและตรวจสอบบันทึกที่ถูกข้าม

คำเตือนทั่วไปและการแก้ไข:

ผลลัพธ์ที่คาดหวัง: คุณยอมรับคำเตือนว่าเป็นการสูญเสียที่ยอมรับได้หรือแก้ไขปัญหาพื้นฐานและรันใหม่

ขั้นตอนที่ 8: ตรวจสอบข้อมูลที่นำเข้า

ก่อนที่จะเลิกใช้เซิร์ฟเวอร์แบบเก่า ตรวจสอบตัวอย่างของแต่ละประเภทบันทึกด้วยตนเอง

1. เปิด Members ในแถบด้านข้าง ค้นหาสมาชิกที่คุณรู้จักจากระบบแบบเก่า ยืนยันชื่อ ยอดเงิน และข้อมูลติดต่อ
2. เปิด Settings > Pricing ยืนยันอัตรารายชั่วโมงตรงกับตารางเวลาแบบเก่า
3. เปิด Products ยืนยันชื่อสินค้าและราคา
4. เปิด Cash Report สำหรับวันที่ประวัติล่าสุด ยืนยันยอดรวมตรงกับที่คุณคาดหวังจากระบบแบบเก่า

ผลลัพธ์ที่คาดหวัง: ตัวอย่างแบบสุ่มตรงกับแหล่งที่มาแบบเก่า หากบันทึกเฉพาะผิด ให้จดบันทึกปัญหา ความแตกต่างในการจัดรูปแบบเล็กน้อยเป็นเรื่องปกติ ความไม่ตรงกันของค่าที่สำคัญบ่งบอกถึงปัญหาการเข้ารหัสหรือความสมบูรณ์ของข้อมูลที่ควรตรวจสอบก่อนใช้งานจริง

ขั้นตอนที่ 9: เปิดใช้งานการสนับสนุนการทำงานของลูกค้าแบบเก่า (ถ้ามี)

หากคุณต้องการให้เครื่องลูกค้า V3 หรือ V4 ที่มีอยู่เชื่อมต่อในขณะที่คุณเปลี่ยนไปใช้ระบบใหม่ ให้เปิดใช้งานโปรโตคอลการทำงานตอนนี้

1. เลื่อนขึ้นไปที่ด้านบนของหน้าการตั้งค่าลูกค้าเก่า
2. สลับ Enable Legacy Client Support เป็นเปิด
3. ยืนยันว่าพอร์ตผู้ฟัง (UDP 710, TCP 712, การโอนย้ายไฟล์ 717) ไม่ขัดแย้งกับสิ่งอื่นในเครือข่ายของคุณ
4. คลิกบันทึก

ผลลัพธ์ที่คาดหวัง: ลูกค้าแบบเก่าบน LAN ปรากฏใน Admin Panel ภายใน 5 ถึง 10 วินาที ดู ลูกค้าเก่า สำหรับวิธีจัดการจากแผงควบคุม

วิธีการยกเลิกการย้ายข้อมูล

หากการย้ายข้อมูลให้ผลลัพธ์ที่ไม่คาดคิด คุณสามารถย้อนกลับได้อย่างสมบูรณ์ ฐานข้อมูลแบบเก่าต้นฉบับจะไม่ถูกแตะต้อง

1. เปิด Settings > Legacy Clients
2. เลื่อนลงไปที่ส่วน Database Migration
3. คลิก Undo Migration
4. ยืนยันในกล่องโต้ตอบ

ทุกแถวที่ย้ายข้อมูลจะถูกลบออกจาก HandyCafe สถานะจะกลับไปเป็น never จากนั้นคุณสามารถแก้ไขปัญหาพื้นฐาน (การเข้ารหัส, การทำความสะอาดข้อมูลต้นทาง ฯลฯ) และรัน Start Migration อีกครั้ง

วิธีการรันการย้ายข้อมูลใหม่

การรันใหม่จะแทนที่ข้อมูลที่ย้ายด้วยข้อมูลใหม่จากแหล่งที่มา

1. เปิด Settings > Legacy Clients
2. คลิก Re-run Migration (ปุ่มจะเปลี่ยนชื่อจาก Start Migration หลังจากการรันครั้งแรกเสร็จสิ้น)
3. กระบวนการเหมือนกับการรันครั้งแรก

การรันใหม่ปลอดภัยที่จะใช้ได้หลายครั้งตามที่คุณต้องการ มันจะไม่ทำให้ข้อมูลซ้ำเพราะมันแทนที่ผลลัพธ์การย้ายข้อมูลที่มีอยู่

ข้อผิดพลาดทั่วไปที่ควรหลีกเลี่ยง

• การรันการย้ายข้อมูลในขณะที่เซิร์ฟเวอร์แบบเก่ากำลังทำงานอยู่ ฐานข้อมูลต้นทางอาจถูกล็อกหรืออาจมีการเขียนบางส่วนเสร็จแล้ว หยุดเซิร์ฟเวอร์แบบเก่าก่อนเสมอ
• การละเลยฟิลด์การเข้ารหัส การรันด้วยการเข้ารหัสที่ผิดจะทำให้ชื่อสมาชิกและข้อความบันทึกเสียหาย การแก้ไขนี้หลังจากข้อเท็จจริงต้องการ Undo และ Re-run
• การปิด HandyCafe ระหว่างการย้ายข้อมูล การรันจะถูกขัดจังหวะและข้อมูลบางส่วนจะถูกเขียน การกู้คืนต้องการ Undo ปล่อยให้หน้าต่างแสดงความคืบหน้าเสร็จสิ้นเสมอ
• การข้ามขั้นตอนการตรวจสอบข้อมูล การเชื่อถือจำนวนบันทึกโดยไม่ตรวจสอบข้อมูลตัวอย่างจะพลาดปัญหาละเอียดเช่นการไม่ตรงกันของภูมิภาคหรือข้อผิดพลาดในการปัดเศษ
• การลบการติดตั้งแบบเก่าเร็วเกินไป เก็บไฟล์ต้นทางไว้อย่างน้อยหนึ่งรอบการจ่ายเงินเต็มหลังจากการย้ายข้อมูล หากมีความคลาดเคลื่อนปรากฏในรายงานรายเดือน คุณสามารถอ้างอิงบันทึกต้นฉบับได้
• การย้ายข้อมูลโดยไม่มีการสำรองข้อมูล คัดลอกโฟลเดอร์การติดตั้งแบบเก่าก่อนการย้ายข้อมูลครั้งแรก แม้ว่าต้นฉบับจะไม่ถูกแก้ไขโดยการย้ายข้อมูล แต่ปัญหาดิสก์หรืออุบัติเหตุอาจเกิดขึ้นได้ การสำรองข้อมูลเป็นการประกันราคาถูก