Panduan Integrasi QAD Adaptive ERP untuk Penjadwalan Produksi dengan SkyPlanner APS

QAD menyediakan tiga jalur bagi sistem penjadwalan eksternal:

1. QAD QXtend Inbound (QXI). QAD menjelaskannya sebagai “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.” (kerangka XML berbasis layanan web yang sesuai dengan SOAP dan menyediakan akses penuh ke fungsi bisnis QAD Enterprise Applications tanpa bergantung pada platform). Setiap permintaan berupa QDoc yang menjalankan program QAD dengan validasi yang sama seperti pada layar program tersebut, dan masing-masing mengembalikan QDoc respons. QDoc yang telah dirilis mencakup maintainItemMaster, maintainRouting, dan maintainPurchaseOrder. Untuk program yang belum memiliki QDoc resmi, alat QGen QAD memetakan program menu tersebut: “QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.” (QGen digunakan untuk memetakan program kustom atau program QAD Enterprise Applications yang belum memiliki skema QDoc dan berkas event resmi). QAD sendiri menggunakan jalur ini: “QAD Production Scheduler uses QAD QXtend to update work orders.” (QAD Production Scheduler menggunakan QAD QXtend untuk memperbarui work order). (panduan QXtend)
2. QAD QXtend Outbound (QXO). QXO “exports user-configurable business objects as XML QDocs out of QAD products.” (mengekspor objek bisnis yang dapat dikonfigurasi pengguna dari produk QAD dalam bentuk QDoc XML). Objek bisnis standar mencakup Item, Product Structure, Routing, Work Center, Department, Inventory Transaction, dan Inventory Status.
3. REST API untuk dokumen bisnis. Sejak Adaptive ERP 2022.1, “Query REST APIs are now available for business documents,” (REST API kueri kini tersedia untuk dokumen bisnis), dengan dukungan filter, pengurutan, paginasi, dan pengambilan sebagian data. Dokumentasinya tersedia di Swagger pada instans Anda (catatan rilis).

QXtend menangani penulisan data. QXO dan REST API kueri menangani pembacaan data.

QXtend Outbound merupakan mekanisme QAD untuk menangani data perubahan. “A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.” (Saat data yang dipantau di QAD Enterprise Applications berubah, notifikasi perubahan ditulis ke basis data qxevents). QXO kemudian membuat QDoc dan mengirimkannya “to a directory location where the subscriber polls for and picks up new QDocs,” (ke direktori tempat subscriber memeriksa dan mengambil QDoc baru secara berkala), atau ke layanan web yang menerima permintaan pada suatu URL.

SkyPlanner menjadi subscriber berupa layanan web yang menerima publikasi QXO, lalu melakukan polling pada REST API kueri untuk data yang tidak dicakup QXO. Work Order bukan objek bisnis standar QXO. Karena itu, integrasi menambahkan objek bisnis QXO pada tabel work order (wo_mstr, wr_route) atau melakukan polling work order melalui REST API kueri setiap beberapa menit.

SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga penulisan kembali data dipicu oleh event.

1. Pemuatan awal master data. Baca item, struktur produk, routing, work center, dan kalender melalui QXO atau REST API kueri. Tentukan pemetaan work center dengan cermat: work center dengan empat mesin menjadi satu kelompok stasiun kerja atau empat stasiun kerja. Lini produksi repetitif dari Production Line Maintenance juga dapat dijadikan stasiun kerja.

2. Sinkronisasi work order. Baca work order berstatus firm planned dan released beserta routing dan komponennya, serta pesanan pembelian yang masih terbuka. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered.

Jadwalkan work order, bukan pesanan rencana MRP. Pesanan rencana harus terlebih dahulu menjadi work order berstatus firm planned atau released di QAD.

3. Penulisan kembali jadwal. Saat mesin penjadwalan menempatkan atau memindahkan pesanan, webhook SkyPlanner memicu QXtend Inbound QDoc pada Work Order Maintenance (16.1). Tanggal rilis ditetapkan sesuai operasi pertama yang dijadwalkan, dan tanggal jatuh tempo sesuai operasi terakhir. QXtend menjalankan program dengan validasi QAD sendiri dan mengembalikan QDoc respons yang diperiksa oleh integrasi.

Urutan operasi pada setiap mesin tetap dikelola di SkyPlanner dan disampaikan kepada operator melalui Mobile Confirmations. Dengan begitu, integrasi tidak terdampak penguncian routing QAD pada pesanan yang telah dirilis.

4. Konfirmasi di lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktu tersebut menjaga jadwal tetap mutakhir. Anda menentukan apakah waktu aktual dikirim kembali ke QAD. Jika ya, waktu persiapan dan proses dikirim ke Labor Feedback by Work Order per operasi, sedangkan jumlah yang selesai diproduksi dikirim ke Work Order Receipt. Jika tidak, data tenaga kerja tetap dimasukkan ke QAD seperti sebelumnya.

5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:

Pilih satu sistem saja untuk menulis tanggal work order. SkyPlanner tidak memerlukan modul penjadwalan QAD. Karena itu, untuk pesanan yang dijadwalkannya, SkyPlanner mengambil alih tugas penulisan tanggal dari workbench penjadwalan atau sistem penjadwalan lain.

• Menjalankan ulang CRP. CRP menjadwalkan ulang semua operasi yang masih terbuka pada work order yang dipilih. QAD mempertahankan tanggal manual hanya jika “you also adjusted the work order release and due date to match,” (Anda juga menyesuaikan tanggal rilis dan tenggat work order agar selaras). Tanggal inilah yang ditulis SkyPlanner. Jalankan CRP setelah penulisan balik, atau kecualikan pesanan yang dijadwalkan SkyPlanner.
• Routing yang sudah dirilis tidak bisa diubah. “Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.” (Setelah status work order menjadi Exploded, Allocated, atau Released, routing tidak dapat diubah lagi.) Baca routing saat work order dirilis, dan ubah routing hanya pada pesanan berstatus planned atau firm planned.
• Satuan waktu routing. Waktu persiapan dan pengerjaan dihitung sebagai beban kapasitas, sedangkan “queue, wait, and move times are excluded from load calculations.” (waktu antre, tunggu, dan perpindahan tidak disertakan dalam perhitungan beban kapasitas). Modelkan waktu antre, tunggu, dan perpindahan sebagai langkah yang hanya memerlukan waktu di SkyPlanner, lalu periksa apakah waktu pengerjaan dihitung per unit atau per pesanan.
• Kapasitas pemrosesan QXtend. QAD memperingatkan bahwa “UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.” (kinerja UI API adapter mungkin tidak memadai saat memproses data dalam volume besar atau transaksi real-time). Kirim hanya pesanan yang berubah, secara berkelompok, dan gunakan QDocs bawaan jika tersedia.
• Domain dan lokasi. Instalasi QAD dengan beberapa domain menyimpan work center dan work order secara terpisah untuk setiap domain dan lokasi. Petakan setiap lokasi dalam lingkup integrasi ke kelompok stasiun kerja tersendiri.
• Kombinasi produksi repetitif dan diskret. Lini Advanced Repetitive menggunakan jadwal repetitif, bukan work order. Saat penentuan lingkup, tetapkan lini mana yang akan dijadwalkan SkyPlanner.