HandyCafe Docs
owner it-admin

การตั้งค่าลูกค้าเก่า

HandyCafe สามารถทำงานร่วมกับการติดตั้งลูกค้า V3 และ V4 เก่าได้โดยไม่หยุดชะงัก หน้าการตั้งค่าลูกค้าเก่าควบคุมคุณสมบัติสองอย่าง:

  1. โปรโตคอลการทำงาน. เปิดใช้งานตัวรับฟังเครือข่ายที่อนุญาตให้ลูกค้า V3 และ V4 เชื่อมต่อกับเซิร์ฟเวอร์นี้บนพอร์ตเดิมของพวกเขา
  2. การย้ายฐานข้อมูล. นำเข้าข้อมูลสมาชิก ราคา สินค้า คำสั่งซื้อ ธุรกรรม และบันทึกจากการติดตั้งในเครื่องเก่าไปยังฐานข้อมูล HandyCafe ใหม่ ตัวเลือกนี้ใช้ได้เฉพาะบน Windows

คุณสมบัติทั้งสองเป็นอิสระจากกัน คุณสามารถเปิดใช้งานการสนับสนุนการทำงานโดยไม่ต้องย้ายข้อมูล ย้ายข้อมูลโดยไม่ต้องเปิดใช้งานการสนับสนุนการทำงาน หรือทำทั้งสองอย่าง

ส่วนโปรโตคอลการทำงาน

เปิดใช้งานการสนับสนุนลูกค้าเก่า

สวิตช์หลักที่ด้านบนของส่วนนี้ เมื่อเปิดใช้งาน เซิร์ฟเวอร์จะเริ่มตัวรับฟังเครือข่ายสามตัว:

  • ตัวรับฟัง UDP บนกลุ่ม multicast ที่กำหนด
  • ตัวรับฟังคำสั่ง TCP บน UDP port + 2
  • ตัวรับฟังการโอนย้ายไฟล์ TCP บน UDP port + 7

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

ฟิลด์การกำหนดค่า

ฟิลด์ ค่าเริ่มต้น คำอธิบาย
Auth Key HANDYCAFE คีย์ที่ใช้ร่วมกัน 10 ตัวอักษร ทุกเฟรมขาเข้าและขาออกจะมีสตริงนี้ เฟรมที่ไม่ตรงกันจะถูกทิ้ง ลูกค้าเก่าทั้งหมดของคุณต้องใช้คีย์เดียวกัน
UDP Multicast IP 230.4.4.46 กลุ่ม multicast ที่ใช้สำหรับการค้นหาลูกค้าและการส่งคำสั่งแบบ UDP ถูกกำหนดในตัวสร้างลูกค้าเก่าส่วนใหญ่
Server UDP Port 710 พอร์ต UDP ที่เซิร์ฟเวอร์รับฟังสำหรับการค้นหาและคำสั่งจากลูกค้า ลูกค้าเก่าส่งไปยังพอร์ตนี้
Client UDP Port 711 พอร์ต UDP ที่ลูกค้าเก่ารับฟัง เซิร์ฟเวอร์ส่งคำสั่งการจัดการแบบ unicast ไปยังพอร์ตนี้บน IP ของลูกค้าที่ค้นพบ
Encoding cp1254 การเข้ารหัสตัวอักษรสำหรับฟิลด์สตริงในรูปแบบสาย ใช้ cp1254 สำหรับการติดตั้งในตุรกี cp1252 สำหรับยุโรปตะวันตก ค่าที่ไม่รู้จักจะกลับไปที่ cp1254 พร้อมคำเตือนในบันทึกเซิร์ฟเวอร์
Server Version 3.4.01 สตริงเวอร์ชันที่ส่งออกในทุกการค้นหา UDP ลูกค้าเก่าบางรายปฏิเสธเฟรมจากเวอร์ชันที่ไม่รู้จัก ตั้งค่านี้ให้ตรงกับสตริงเวอร์ชันของเซิร์ฟเวอร์เดิมของคุณ
Protocol Variant STE การเลือกฟอร์แมตสาย ดูการเปรียบเทียบตัวแปรด้านล่าง
Inactivity Timeout 10 วินาที. ตัวจับเวลาต่อ MAC หากไม่มีการรับส่งข้อมูลจากลูกค้าภายในช่วงเวลานี้ ลูกค้าจะถูกทำเครื่องหมายว่าออฟไลน์ ช่วงเวลา 10 วินาทีเหมาะสมสำหรับลูกค้าเก่าที่ส่งสัญญาณทุก 2 หรือ 3 วินาที

พอร์ตที่ได้มา

ด้านล่างของฟอร์ม หน้าจะแสดงบรรทัดที่อ่านได้อย่างเดียวที่แสดงพอร์ต TCP ที่ได้มา:

TCP Command Port: 712   File Transfer Port: 717

พอร์ตเหล่านี้คำนวณจากพอร์ตเซิร์ฟเวอร์ UDP คุณไม่สามารถกำหนดค่าแยกต่างหากได้ หากคุณเปลี่ยน Server UDP Port เป็นค่าอื่น พอร์ตที่ได้มาจะเปลี่ยนตามไปด้วย

ตัวแปรโปรโตคอล

ฟิลด์ Protocol Variant เลือกรูปแบบสายที่เซิร์ฟเวอร์ใช้ เลือกตัวแปรที่ตรงกับวิธีการสร้างเซิร์ฟเวอร์เก่าของคุณ

ตัวแปร เมื่อใช้
STE (Smart/Turbo Edition) ฐานรหัสเก่าที่ทันสมัย เพิ่มคำนำหน้า license-info ขนาด 70 ไบต์ไปยังโครงสร้างเฟรม ขนาดเฟรมคือ 1337 ไบต์ เลือกตัวนี้หากการติดตั้งเก่าของคุณใช้รุ่น Smart หรือ Turbo
Standard การสร้างฐานเก่าที่เรียบง่าย ขนาดเฟรมคือ 1267 ไบต์โดยไม่มีคำนำหน้า license-info เลือกตัวนี้เฉพาะเมื่อการติดตั้งเก่าของคุณเป็นรุ่น Standard โดยไม่มีการลงทะเบียนใบอนุญาต

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

การอยู่ร่วมกับลูกค้าสมัยใหม่

พอร์ตเก่า (710, 711, 712, 717) แยกออกจากพอร์ตโปรโตคอล HandyCafe สมัยใหม่ (TCP 5001, 5002, 5003, UDP 5004) ทั้งสองโปรโตคอลทำงานพร้อมกันโดยไม่ขัดแย้ง คุณสามารถผสมลูกค้าเก่าและใหม่ใน LAN เดียวกันและจัดการจาก Admin Panel เดียวกัน

การใช้การเปลี่ยนแปลง

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

  1. หยุดตัวรับฟังเก่าทั้งสามตัวหากกำลังทำงาน
  2. ตรวจสอบคีย์การยืนยัน (ต้องไม่ว่างเปล่า)
  3. สร้างการกำหนดค่าตัวรับฟังใหม่จากฟิลด์ที่อัปเดต
  4. เริ่มตัวรับฟังใหม่พร้อมกัน
  5. ส่งการแจ้งเตือนเมื่อทั้งสามกลับมาออนไลน์

หากพอร์ตถูกใช้งานโดยกระบวนการอื่น เซิร์ฟเวอร์จะแจ้งข้อผิดพลาดและสวิตช์จะกลับไปปิด ตรวจสอบไฟร์วอลล์และบริการอื่น ๆ ด้วย netstat และเลือกช่วงพอร์ตที่ว่าง

ส่วนการย้ายฐานข้อมูล (เฉพาะ Windows)

คุณสมบัตินี้ใช้ได้เฉพาะเมื่อ HandyCafe ทำงานบน Windows บน macOS และ Linux ส่วนนี้จะแสดงประกาศ: "การย้ายฐานข้อมูลรองรับเฉพาะบน Windows เท่านั้น"

การตรวจจับ

เมื่อเปิด เซิร์ฟเวอร์จะสแกนระบบของคุณเพื่อหาการติดตั้งเก่า การตรวจจับจะดูใน:

  • รีจิสทรีและเส้นทางการติดตั้งทั่วไป เช่น Program Files\HandyCafe และ C:\HandyCafe
  • ไฟล์ฐานข้อมูลที่อยู่ข้างการติดตั้ง
  • ไฟล์ INI การกำหนดค่าในไดเรกทอรีการติดตั้ง

เมื่อการตรวจจับสำเร็จ หน้าจะแสดง:

ป้ายกำกับ ความหมาย
Install Path ที่ตั้งการติดตั้งเก่าบนดิสก์
Database Path เส้นทางเต็มไปยังไฟล์ฐานข้อมูลเก่า
Server Version วิเคราะห์จากการกำหนดค่าเก่า
INI File Count จำนวนไฟล์การกำหนดค่าที่ตรวจพบ มีประโยชน์สำหรับการตรวจสอบความสมบูรณ์ของการติดตั้ง

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

สถานะการย้าย

หน้าจอติดตามประวัติการย้าย:

สถานะ ความหมาย
never คุณยังไม่เคยดำเนินการย้าย
in_progress การย้ายกำลังดำเนินการอยู่ อย่าปิดเซิร์ฟเวอร์ในสถานะนี้
completed การย้ายล่าสุดเสร็จสิ้นโดยไม่มีคำเตือน
completed_with_warnings การย้ายล่าสุดเสร็จสิ้นแต่มีบางรายการที่ถูกข้าม (เช่น เนื่องจากข้อผิดพลาดในการเข้ารหัสหรือวันที่ที่ผิดรูปแบบ) ตรวจสอบคำเตือนก่อนดำเนินการต่อ
undone การย้ายล่าสุดถูกย้อนกลับ

หลังจากการดำเนินการที่สำเร็จครั้งแรก ปุ่ม Start Migration จะเปลี่ยนชื่อเป็น Re-run Migration

สิ่งที่ถูกย้าย

ตาราง คำอธิบาย
Members บันทึกข้อมูลลูกค้าพร้อมชื่อ ข้อมูลติดต่อ และยอดคงเหลือบัญชี
Pricing ตารางราคาและอัตรารายชั่วโมง
Products รายการสินค้าในแคตตาล็อก
Orders ประวัติคำสั่งซื้อพร้อมการอ้างอิงเซสชัน
Transactions รายการบัญชีพร้อมเวลาประทับ จำนวนเงิน และวิธีการชำระเงิน
Logs บันทึกการตรวจสอบและคำเตือนจากฐานข้อมูลเก่า

การรับประกัน "ไฟล์ปลอดภัย"

หน้าจอแสดงประกาศในสีน้ำเงิน: "ไฟล์ฐานข้อมูลต้นฉบับจะไม่ถูกลบ คุณสามารถลบได้อย่างปลอดภัยเมื่อการย้ายข้อมูลได้รับการยืนยัน" การย้ายข้อมูลเป็นการอ่านอย่างเดียวจากแหล่งที่มา แม้ว่าคุณจะดำเนินการย้ายข้อมูลหลายครั้ง ฐานข้อมูลเก่าต้นฉบับยังคงไม่ถูกแตะต้อง สิ่งนี้ช่วยให้คุณทดลองกับการนำเข้า ตรวจสอบจำนวน และย้อนกลับโดยไม่มีความเสี่ยง

เริ่ม, ดำเนินการใหม่, และย้อนกลับ

  • Start Migration. เปิดโมดอลแสดงความคืบหน้า โมดอลแสดงเฟสปัจจุบันและจำนวนรายการขณะที่การนำเข้าดำเนินการ อย่าปิด HandyCafe ในช่วงเวลานี้
  • Re-run Migration. ใช้ได้หลังจากการดำเนินการเสร็จสิ้น ดำเนินการนำเข้าใหม่จากต้นฉบับ การนำเข้าใหม่จะแทนที่ข้อมูลก่อนหน้าใน HandyCafe
  • Undo Migration. ใช้ได้หลังจากการดำเนินการเสร็จสิ้น เปิดกล่องโต้ตอบยืนยัน เมื่อยืนยันแล้ว แถวที่ย้ายทั้งหมดจะถูกลบออกจาก HandyCafe แหล่งที่มาเก่าไม่ถูกแตะต้อง หลังจากย้อนกลับ สถานะจะกลับไปที่ never

เสร็จสิ้นพร้อมคำเตือน

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

  • การเข้ารหัสไม่ตรงกัน. แถวต้นทางมีอักขระที่ไม่สามารถถอดรหัสได้ในรูปแบบการเข้ารหัสที่กำหนด เปลี่ยนฟิลด์การเข้ารหัส (cp1254 หรือ cp1252) และดำเนินการย้ายใหม่
  • วันที่ผิดรูปแบบ. บันทึกเก่าบางรายการมีเวลาประทับที่ไม่ถูกต้อง รายการเหล่านี้จะถูกข้ามเพื่อให้แถวที่ถูกต้องยังคงนำเข้าได้
  • คีย์ซ้ำ. มีบันทึกที่มีตัวระบุเดียวกันอยู่แล้วใน HandyCafe การย้ายข้อมูลจะรักษาบันทึกที่มีอยู่และข้ามรายการซ้ำ

เคล็ดลับ

  • หยุดเซิร์ฟเวอร์เก่าก่อนดำเนินการย้าย หากระบบเก่ายังคงเขียนไปยังฐานข้อมูล การนำเข้าอาจเห็นข้อมูลที่ล้าสมัยหรือบางส่วน
  • จับคู่ฟิลด์การเข้ารหัสกับโลเคลเก่าของคุณก่อนการย้ายครั้งแรก การเปลี่ยนแปลงหลังจากที่ข้อมูลถูกนำเข้าแล้วจะไม่แก้ไขชื่อที่เสียหายแล้ว
  • ดำเนินการย้ายทดสอบก่อนเสมอ ตรวจสอบจำนวนบันทึกภายใต้ "Last Counts" และตรวจสอบแถวสมาชิกและธุรกรรมบางส่วนก่อนที่จะให้พนักงานใช้ระบบใหม่
  • เปิดใช้งานการสนับสนุนการทำงานและรักษาการเชื่อมต่อลูกค้าเก่าของคุณในช่วงเปลี่ยนผ่าน สิ่งนี้ช่วยให้คุณตรวจสอบว่าเซิร์ฟเวอร์ใหม่ให้บริการพวกเขาเหมือนเดิมก่อนที่คุณจะเลิกใช้เซิร์ฟเวอร์เก่า
  • หากคุณเปลี่ยน Server UDP Port จำไว้ว่าพอร์ตคำสั่งและการโอนย้ายไฟล์ที่ได้มาจะเปลี่ยนตาม กฎไฟร์วอลล์ต้องอัปเดตตามนั้น