Panduan Integrasi IFS Cloud untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi IFS Cloud ini menjelaskan kepada mitra dan tim TI cara menghubungkan IFS Cloud dengan SkyPlanner APS. SkyPlanner terintegrasi dua arah dengan IFS Cloud melalui API milik IFS:
- Data yang masuk mencakup order produksi beserta operasi dan materialnya, routing, struktur produk, work center, kelas tenaga kerja, perkakas, ketersediaan item persediaan, dan pesanan pembelian.
- Rencana waktu mulai dan selesai serta sumber daya work center yang dipilih dikirim kembali ke operasi pada order produksi.
- Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Selama proses onboarding, tim SkyPlanner menyiapkan integrasi sesuai konfigurasi IFS Cloud Anda dan memberikan dukungan setelah sistem mulai digunakan. Panduan ini ditujukan bagi mitra dan pengembang yang ingin terlibat atau membangun integrasi sendiri menggunakan REST API SkyPlanner yang telah didokumentasikan (referensi API).
Opsi integrasi IFS Cloud
Proyeksi OData (RESTful APIs).
IFS Cloud menyediakan akses ke logika bisnisnya melalui proyeksi OData. “Projections are exposed in the /ifsapplications/projection/ endpoint,” (Proyeksi tersedia melalui endpoint /ifsapplications/projection/), pada endpoint main, int, atau b2b sesuai jenis proyeksi. Jalur umumnya dimulai dari /main/ifsapplications/, dilanjutkan dengan versi proyeksi, lalu layanan .svc proyeksi tersebut beserta kumpulan entitasnya. Setiap proyeksi menyediakan metadata OData, “a machine-readable description of the data model of the APIs.” (deskripsi model data API yang dapat dibaca mesin). (sumber)
API Explorer.
Klien web IFS Cloud menampilkan semua proyeksi beserta dokumentasi API dan spesifikasi OpenAPI untuk lingkungan Anda. Gunakan Premium APIs dan Entity Service APIs untuk integrasi, bukan proyeksi UI yang digunakan halaman klien. Premium APIs memiliki versi: “The old version of the projection will still be retained along with the new version till the next release.” (Versi lama proyeksi tetap dipertahankan bersama versi baru hingga rilis berikutnya). (sumber)
IFS Connect.
Broker integrasi mengarahkan pesan ke alamat HTTP/REST, file, dan alamat lainnya. Menurut IFS: “Modern integration use web services together with IFS Connect and/or 3rd party integration tools.” (Integrasi modern menggunakan layanan web bersama IFS Connect dan/atau alat integrasi pihak ketiga). (sumber) IFS juga mendokumentasikan jalur integrasi melalui middleware seperti Boomi.
File.
Job pada Data Migration Manager, File Migration, dan Excel Migration menangani pemuatan data massal. Selama masa uji coba, ekspor Excel biasa sudah cukup.
Autentikasi
Integrasi eksternal melakukan autentikasi melalui IFS Identity and Access Manager (IAM) dengan OAuth 2.0 dan OpenID Connect:
- Daftarkan IAM Client untuk SkyPlanner dan gunakan alur Client Credentials. Alur ini “allows for a non-interactive authentication of a service account” (memungkinkan autentikasi akun layanan tanpa interaksi pengguna) dan “yields an access token associated with a service user.” (menghasilkan token akses yang terkait dengan pengguna layanan).
- Minta token melalui
POST https://<SYSTEM_URL>/auth/realms/<NAMESPACE>/protocol/openid-connect/token. - Berikan kumpulan izin kepada pengguna layanan hanya untuk proyeksi yang dibaca dan ditulis oleh integrasi, tanpa izin tambahan.
(sumber)
Di sisi SkyPlanner, REST API menggunakan token API untuk autentikasi (SkyPlanner Settings > API) dan didokumentasikan dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan pemanggilan API pertama.
Event dan deteksi perubahan
IFS Cloud memiliki kerangka kerja event: “Events can be used to automate actions within IFS Cloud.” (Event dapat digunakan untuk mengotomatiskan tindakan di IFS Cloud). Event kustom terpicu ketika entitas dibuat, diperbarui, atau dihapus, dan tindakannya dijalankan melalui IFS Connect. (sumber)
Pengiriman keluar ditangani oleh REST Sender: “Outbound messages can be sent either synchronously or asynchronously,” (Pesan keluar dapat dikirim secara sinkron maupun asinkron), dengan pengaturan jalur pesan di IFS Connect. (sumber) Workflow Manager juga dapat memanggil endpoint REST.
Ada dua pola yang dapat digunakan:
- Berbasis event. Event kustom untuk perubahan order produksi dan operasinya memicu pengiriman pesan REST Sender ke REST API SkyPlanner.
- Polling. SkyPlanner membaca order produksi yang masih terbuka dari proyeksi setiap beberapa menit, dengan filter agar hanya mengambil rekaman yang berubah.
Mulailah dengan polling, lalu tambahkan event untuk objek yang paling sering berubah. SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga penulisan kembali data menggunakan pola berbasis event.
Pemetaan data
Nama proyeksi berbeda antarversi rilis. Gunakan nama persis seperti yang tercantum di API Explorer Anda.
| Objek IFS Cloud | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
| Inventory Part (tingkat lokasi) | Produk dan material | IFS → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Product Structure (header, alternatif, baris) | Struktur produk, subproduk, material per produk | IFS → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Routing, Routing Operations: waktu persiapan, proses, pemindahan, dan efisiensi | Tahapan proses beserta durasi, waktu persiapan, dan waktu pembongkaran | IFS → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Work Center, Work Center Resource: kalender, utilisasi, efisiensi | Stasiun kerja, kelompok stasiun kerja, efisiensi | IFS → SkyPlanner | Pemuatan awal, jarang diperbarui setelahnya |
| Personel dalam Labor Class; jumlah anggota tim pada operasi | Personel beserta sif; operator per job | IFS → SkyPlanner | Pemuatan awal; sif dikelola dalam satu sistem |
| Manufacturing Tool, kelompok perkakas | Perkakas sebagai sumber daya produksi bersama dengan kapasitas terbatas | IFS → SkyPlanner | Pemuatan awal |
| Shop Order (Released, Reserved, Started) beserta Shop Order Operations dan material: Need Date, Earliest Start Date, prioritas | Order dan job beserta tenggat dan kebutuhan material | IFS → SkyPlanner | Event atau polling setiap beberapa menit |
| Ketersediaan item persediaan | Saldo stok | IFS → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| Baris pesanan pembelian beserta rencana penerimaan | Pesanan pembelian beserta perkiraan tanggal pengiriman; stok diperbarui saat ditandai Delivered | IFS → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| Shop Order Operation: waktu mulai, waktu selesai, sumber daya work center | Rencana waktu mulai, selesai, dan stasiun kerja per operasi | SkyPlanner → IFS | Saat jadwal berubah, melalui webhook SkyPlanner |
| Pelaporan operasi (waktu mesin, waktu tenaga kerja, kuantitas) | Catatan waktu dan konfirmasi operator | SkyPlanner → IFS | Setiap konfirmasi atau per sif, jika dipilih saat penentuan lingkup |
| Diatur di SkyPlanner | Matriks waktu persiapan, mesin alternatif, dan personel | Dikelola di SkyPlanner | Diatur selama onboarding |
Pola integrasi
1. Pemuatan awal master data. Ambil item persediaan, struktur produk yang dapat diproduksi, routing beserta operasinya, work center beserta sumber dayanya, kelas tenaga kerja, dan perkakas. Petakan setiap sumber daya work center ke stasiun kerja SkyPlanner dengan pertimbangan yang matang. Tentukan apakah work center dengan tiga sumber daya akan menjadi satu kelompok stasiun kerja atau tiga stasiun kerja.
2. Sinkronisasi order produksi. Baca order produksi berstatus Released, Reserved, dan Started beserta operasi dan materialnya. Biarkan MRP menangani order produksi berstatus Planned; order ini berubah setiap kali perencanaan dijalankan. Tambahkan ketersediaan item persediaan dan baris pesanan pembelian yang masih terbuka agar penjadwalan memeriksa stok serta pembelian yang akan diterima. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO.
3. Penulisan kembali jadwal. Untuk setiap operasi yang dijadwalkan atau dipindahkan oleh mesin penjadwalan, SkyPlanner menuliskan rencana waktu mulai dan selesai serta sumber daya work center ke operasi pada order produksi. Penulisan dilakukan melalui proyeksi operasi order produksi yang tercantum di API Explorer Anda, sehingga IFS menjalankan validasinya sendiri. Kuantitas, status, dan biaya tetap dikelola oleh IFS.
4. Konfirmasi dari lantai produksi. Pilih satu saluran untuk setiap lokasi. Operator dapat tetap melapor melalui Shop Floor Workbench, lalu SkyPlanner membaca progresnya. Alternatifnya, operator mencatat pekerjaan dengan SkyPlanner Mobile Confirmations dan Production Timer. Catatan waktu kemudian dikirim ke IFS melalui proyeksi pelaporan operasi yang disepakati saat penentuan lingkup.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Item persediaan, struktur produk, routing, kuantitas, status order produksi | IFS Cloud |
| Urutan operasi, waktu mulai dan selesai, penugasan sumber daya produksi | SkyPlanner |
| Matriks waktu persiapan dan peralihan, kebutuhan alat dan operator, sumber daya alternatif | SkyPlanner |
| Shift dan ketidakhadiran | Satu sistem, dipilih saat penentuan lingkup |
| Pelaporan operasi dan penerimaan | IFS Cloud, dari Shop Floor Workbench atau catatan waktu SkyPlanner |
Sumber konflik utama adalah penjadwalan ulang di IFS. Jika perencana menjadwalkan ulang perintah produksi dengan Infinite Scheduler, perlakukan perintah tersebut sebagai versi baru, sinkronkan kembali, lalu biarkan SkyPlanner menyusun ulang rencananya. Dengan Autopilot, SkyPlanner menjadwalkan ulang secara otomatis saat terjadi perubahan produksi. Pabrik yang juga menggunakan MSO perlu menentukan work center yang menjadi tanggung jawab masing-masing sistem penjadwalan.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam hitungan minggu sejak proses orientasi dimulai, bahkan untuk perusahaan besar. Sebelum itu, Anda dapat menjalankan uji coba gratis selama 30 hari dengan data sendiri: ekspor work center, routing, dan perintah produksi yang masih terbuka dari IFS Cloud ke Excel, lalu impor data tersebut.
- Pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan, frekuensi sinkronisasi, dan saluran pelaporan.
- IAM dan izin akses. Daftarkan klien IAM, buat akun pengguna layanan, dan berikan set izin akses untuk proyeksi. Lakukan di lingkungan sandbox terlebih dahulu, lalu di lingkungan produksi.
- Pemuatan data awal. Item persediaan, struktur produk, routing, work center, klasifikasi tenaga kerja, dan perkakas.
- Sinkronisasi perintah produksi dan pesanan pembelian. Mulai dengan polling, lalu gunakan event khusus jika volume perubahannya tinggi.
- Pengaturan batasan di SkyPlanner. Matriks waktu penyiapan, perkakas, jumlah operator, serta mesin atau personel alternatif.
- Penulisan balik jadwal. Tulis tanggal operasi dan sumber daya produksi ke operasi dalam perintah produksi.
- Pengujian paralel. Jalankan SkyPlanner secara paralel dengan penerapan rencana yang sedang digunakan, bandingkan tanggalnya, lalu perbaiki master data.
- Mulai beroperasi. Aktifkan penulisan balik setelah datanya sesuai.
Hal yang perlu direncanakan dalam integrasi IFS Cloud
- Waktu mesin dan waktu tenaga kerja. Operasi dalam perintah produksi memiliki waktu penyiapan dan waktu pengerjaan yang terpisah untuk mesin dan tenaga kerja, serta jumlah anggota tim. Tentukan waktu mana yang menjadi dasar durasi di setiap stasiun kerja. Jika tidak, durasi setiap operasi akan salah.
- Utilisasi dan efisiensi dihitung dua kali. Utilisasi work center, efisiensi operasi, dan efisiensi sumber daya produksi sama-sama mengurangi waktu yang tersedia di IFS. Petakan semuanya ke efisiensi stasiun kerja SkyPlanner satu kali saja.
- Data kapasitas yang tidak mutakhir. Kapasitas sumber daya produksi baru tersedia setelah Calculate Work Center Resource Capacity dijalankan. Periksa kalender dan masa berlakunya sebelum pemuatan data awal.
- Preferred Resource hanya menunjukkan preferensi. Modelkan alternatif yang benar-benar tersedia secara eksplisit sebagai stasiun kerja alternatif di SkyPlanner.
- Proyeksi UI dapat berubah. Bangun integrasi menggunakan API Premium atau Entity Service, yang mempertahankan versi sebelumnya hingga rilis berikutnya. Uji ulang pada setiap rilis yang terbit dua kali setahun.
- Proyeksi Shop Floor Workbench mengikuti alur UI. Proyeksi yang dibuat untuk asisten Shop Floor Workbench tidak ditujukan untuk integrasi transaksi langsung. Pilih proyeksi pelaporan saat penentuan lingkup.
Siapa yang mengonfigurasi integrasi
Pekerjaan ini mencakup pemetaan ke routing, work center, dan konfigurasi IFS Anda. Cakupannya juga meliputi batasan yang diperhitungkan SkyPlanner saat menyusun jadwal sesuai kapasitas nyata: matriks waktu penyiapan, perkakas, jumlah operator, dan sumber daya produksi alternatif.
- Tim SkyPlanner mengonfigurasi integrasi selama proses orientasi dan memberikan dukungan setelah mulai beroperasi, baik untuk sisi SkyPlanner maupun proyeksi IFS yang disepakati. Setiap pabrik menggunakan IFS Cloud dengan cara berbeda, dan pengetahuan inilah yang diterapkan dalam konfigurasi.
- Mitra IFS Anda dapat ikut terlibat. Mitra memahami konfigurasi Anda dan dapat menyiapkan klien IAM, set izin akses, serta event bersama tim. SkyPlanner menyediakan REST API, dokumentasi Swagger/OpenAPI, dan webhook.
- Pengembang internal Anda juga dapat membangun integrasi menggunakan REST API terdokumentasi yang sama dengan token API. Cukup gunakan token API untuk memulai, dan tim SkyPlanner siap membantu bila diperlukan. Dokumentasi publik tersedia di dokumentasi integrasi SkyPlanner.
Harga SkyPlanner mulai dari 199 € per bulan, sudah termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran biaya integrasi disampaikan di awal sesuai proses dan kebutuhan Anda, bersama paket langganan Anda, sehingga seluruh biaya sudah terlihat sebelum Anda memulai. Lihat perbandingannya dengan penjadwalan bawaan IFS di penjadwalan produksi sesuai kapasitas di IFS Cloud. Gambaran umumnya tersedia di halaman IFS Cloud, sedangkan ERP lainnya ada di pusat integrasi ERP.
Ulasan SkyPlanner dari produsen
2 jamdihemat setiap minggu
“SkyPlanner telah membawa perencanaan produksi kami dari lembar kerja Excel ke optimasi produksi secara real time.”
Kalle Kalliomäki, Spesialis Rantai Pasok
UTU · Panel distribusi listrik dan perangkat hubung bagi
Perencanaan produksi menghemat 2 jam kerja setiap minggu, dan antrean kerja baru sampai ke lini produksi dalam hitungan detik.
+90%efisiensi produksi
“Efisiensi produksi meningkat 90%.”
Abdul Rucyinga, Kepala TI
Laboratory & Allied · Manufaktur farmasi
Efisiensi produksi meningkat 90%, dan penyusunan rencana optimal untuk tiga bulan di seluruh stasiun kerja membutuhkan waktu kurang dari 30 menit.
99,2%keandalan pengiriman
“SkyPlanner memudahkan kami melihat titik kemacetan dan membuat pengelolaan produksi lebih jelas.”
Toni Tuori, Manajer Produksi
Piristeel · Perlengkapan keselamatan atap dan sistem penyaluran air hujan
Keandalan pengiriman mencapai 99,2% tahun ini, dan penjadwalan menghemat hingga empat jam kerja per hari.
Lebih sedikitpenghentian produksi akibat kekurangan material
“Nilai SkyPlanner bagi kami adalah kegunaannya dalam pekerjaan sehari-hari, terutama untuk menetapkan tanggal pengiriman.”
Tommi Männistö, Manajer Perencanaan Produksi
Eskomatic · Jasa pemesinan kontrak
Penjadwalan beban kerja otomatis menghasilkan tanggal pengiriman yang lebih akurat, dan penghentian produksi akibat kekurangan material telah berkurang tajam.
Pertanyaan umum
API IFS Cloud mana yang sebaiknya digunakan untuk integrasi penjadwalan?
Gunakan proyeksi OData di /ifsapplications/projection/, sebaiknya API Premium atau Entity Service yang tercantum di API Explorer Anda. API tersebut dilengkapi spesifikasi OpenAPI untuk setiap lingkungan dan mempertahankan versi sebelumnya hingga rilis berikutnya.
Siapa yang membangun integrasi IFS Cloud?
Tim SkyPlanner mengonfigurasi integrasi dua arah sesuai konfigurasi IFS Anda selama proses orientasi dan memberikan dukungan setelah mulai beroperasi. Mitra IFS atau pengembang internal Anda juga dapat membangun integrasi menggunakan REST API SkyPlanner yang terdokumentasi. Cukup gunakan token API untuk memulai.
Autentikasi apa yang digunakan integrasi ini?
Klien IFS IAM dengan alur OAuth 2.0 Client Credentials, yang terhubung ke akun pengguna layanan dengan set izin akses untuk proyeksi yang diperlukan. API SkyPlanner sendiri menggunakan token API.
Apakah IFS Cloud dapat mengirim perubahan perintah produksi secara real time?
Ya, dengan event khusus saat entitas berubah dan REST Sender, yang keduanya dikonfigurasi di IFS Connect. Mulai dengan polling setiap beberapa menit, lalu tambahkan event jika volume perubahannya tinggi. Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Apakah kami memerlukan MSO atau PSO untuk integrasi ini?
Tidak. SkyPlanner membaca perintah produksi, operasi, dan work center langsung dari proyeksi IFS, lalu menyusun sendiri jadwal yang sesuai dengan kapasitas nyata. Anda tidak memerlukan akses MSO, PSO Cloud Service atau IFS.ai Activation Pass, maupun penganggaran token. Autopilot menyusun ulang rencana secara otomatis setiap kali ada perubahan.
Apakah kami dapat menguji SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor Excel atau CSV dari IFS Cloud, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk penentuan lingkup integrasi.
