Skip to content

10.03 Master Data Synchronization Strategy ​


📌 At a Glance ​

รายการรายละเอียด
TopicMaster Data Synchronization Strategy
Difficulty⭐⭐ Intermediate
Reading Time10 นาที
TargetDeveloper, System Integrator
Related APIsGET /receivers, GET /products, GET /units

🎯 Learning Objectives ​

หลังจากศึกษาหัวข้อนี้แล้ว ผู้อ่านจะสามารถ

  • ออกแบบการ Synchronize Master Data ได้อย่างมีประสิทธิภาพ
  • ลดจำนวนการเรียก API ที่ไม่จำเป็น
  • เพิ่มประสิทธิภาพของระบบ Client
  • ลดโอกาสเกิด Validation Errors จากข้อมูลอ้างอิงที่ไม่เป็นปัจจุบัน

Overview ​

Master Data เป็นข้อมูลอ้างอิงที่ใช้ในการสร้างรายการตรวจรับสินค้า เช่น ผู้รับสินค้า สินค้า และหน่วยนับ

เพื่อให้ระบบมีประสิทธิภาพ SISAHYGO แนะนำให้ Client System ทำการ Synchronize Master Data มาเก็บไว้ในฐานข้อมูลของตนเอง และอัปเดตข้อมูลเป็นระยะ แทนการเรียก API ทุกครั้งที่ผู้ใช้งานสร้างรายการ

แนวทางนี้ช่วยลดจำนวน API Calls ลดเวลาในการตอบสนอง และทำให้ระบบสามารถทำงานได้ต่อเนื่อง แม้ในช่วงที่การเชื่อมต่อเครือข่ายมีความหน่วง


Figure 10-3 Master Data Synchronization Strategy ​

Figure 10-3

Figure 10-3 แสดงแนวทางการ Synchronize ข้อมูล Master Data จาก SISAHYGO API ไปยังฐานข้อมูลของ Client System และการนำข้อมูลดังกล่าวไปใช้งานในกระบวนการสร้างรายการ


Master Data APIs ​

ข้อมูลอ้างอิงที่ควร Synchronize

APIPurpose
GET /receiversข้อมูลผู้รับสินค้า
GET /productsข้อมูลสินค้า
GET /unitsข้อมูลหน่วยนับ

Recommended Synchronization Flow ​

text
Application Start

        │

        ▼

GET /receivers

        │

        ▼

GET /products

        │

        ▼

GET /units

        │

        ▼

Local Database

        │

        ▼

Business Application

Synchronization Architecture ​

text
           SISAHYGO API

        Receivers

        Products

        Units

             │

             ▼

      Synchronization Service

             │

             ▼

      Local Database

             │

             ▼

 ERP / POS / WMS / TMS

Recommended Synchronization Frequency ​

Master DataRecommendation
Receiversทุกวัน หรือเมื่อมีการเปลี่ยนแปลงข้อมูล
Productsทุกวัน หรือเมื่อมีการเพิ่มสินค้าใหม่
Unitsเมื่อมีการเปลี่ยนแปลงข้อมูลหน่วยนับ
Manual Syncเปิดให้ผู้ดูแลระบบสั่ง Synchronize ได้ทันที

Local Database Benefits ​

การจัดเก็บ Master Data ในระบบของ Client มีข้อดีดังนี้

  • ลดจำนวน API Calls
  • เพิ่มความเร็วในการค้นหาข้อมูล
  • ลดภาระของ API Server
  • รองรับการทำงานของผู้ใช้งานหลายคนพร้อมกัน
  • รองรับการทำงานในช่วงที่เครือข่ายมีความหน่วง

Synchronization Best Practices ​

  • Synchronize ข้อมูลตามรอบเวลา (Scheduled Job)
  • รองรับ Manual Synchronization
  • ใช้ Transaction ในการอัปเดตข้อมูล
  • บันทึกเวลาที่ Synchronize ล่าสุด
  • ตรวจสอบความสมบูรณ์ของข้อมูลหลังการ Synchronize

Example Schedule ​

TimeTask
ทุกวัน 02:00Synchronize Receivers
ทุกวัน 02:15Synchronize Products
ทุกวัน 02:30Synchronize Units
เมื่อผู้ดูแลร้องขอManual Synchronization

Client-side Validation ​

เมื่อข้อมูลถูก Synchronize มาแล้ว

Client System ควรตรวจสอบ

  • Receiver
  • Product
  • Unit

จากฐานข้อมูลภายในก่อนเรียก API

ซึ่งจะช่วยลด Validation Errors และเพิ่มความเร็วในการทำงาน


Common Mistakes ​

ProblemRecommendation
เรียก Master Data ทุกครั้งที่สร้าง Orderใช้ Local Database
ไม่ Synchronize ข้อมูลเป็นเวลานานตั้ง Scheduled Job
ไม่มี Manual Syncเพิ่มปุ่ม Synchronize
ใช้ข้อมูลเก่าตรวจสอบเวลาการอัปเดตล่าสุด

Related Sections ​

  • 10.02 Recommended API Call Sequence
  • 10.04 Caching Strategy
  • 10.05 Retry & Recovery Strategy

Summary ​

การ Synchronize Master Data เป็นแนวทางที่แนะนำสำหรับการใช้งาน SISAHYGO API ในระดับ Production โดยช่วยลดจำนวนการเรียก API เพิ่มประสิทธิภาพของระบบ และทำให้ข้อมูลอ้างอิงที่ใช้ในการสร้างรายการมีความถูกต้องและเป็นปัจจุบันอยู่เสมอ การจัดเก็บข้อมูลไว้ในฐานข้อมูลของ Client ควบคู่กับการอัปเดตตามรอบเวลาและการรองรับ Manual Synchronization จะช่วยให้ระบบมีความเสถียรและพร้อมรองรับการใช้งานในระยะยาว


Next Step ​

➡️ 10.04 Caching Strategy

SISAHYGO API Integration Guide