Entegrasyonlar / ERP / QAD Adaptive ERP
SkyPlanner APS ile Üretim Çizelgeleme için QAD Adaptive ERP Entegrasyon Kılavuzu
Bu QAD Adaptive ERP entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine QAD Adaptive ERP’yi SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. Önceki QAD Enterprise Edition ve MFG/PRO kurulumları da buna dahildir. SkyPlanner, QAD’nin kendi arayüzlerini kullanarak QAD Adaptive ERP ile çift yönlü entegre olur:
- Üretim emirleri ve bunların operasyonları, stok kartları, ürün yapıları, rotalar, iş merkezleri, atölye takvimleri, stoklar ve satın alma siparişleri SkyPlanner’a aktarılır.
- Çizelgelemede belirlenen serbest bırakma ve termin tarihleri Work Order Maintenance (16.1) programına geri yazılır.
- Operatörlerin süre kayıtları Labor Feedback by Work Order (16.20.1), tamamlanan miktarlar ise Work Order Receipt (16.11) üzerinden geri aktarılır.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu QAD kurulumunuza göre yapılandırır ve canlıya geçişten sonra da destekler. Bu kılavuz, sürece katılmak veya SkyPlanner’ın belgelenmiş REST API’sini (API başvuru kaynağı) kullanarak kendi çözümlerini geliştirmek isteyen iş ortakları ve geliştiriciler içindir.
QAD’nin entegrasyon arayüzleri
QAD, harici bir çizelgeleme uygulaması için üç yol sunar:
- QAD QXtend Inbound (QXI). QAD bunu şöyle tanımlar: “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.” (QAD Enterprise Applications işlevlerine platformdan tamamen bağımsız erişim sağlayan, web servisleri tabanlı, SOAP uyumlu bir XML çerçevesi.) Her istek bir QDoc belgesidir; QAD programını, program ekranındakiyle aynı doğrulama kurallarıyla çalıştırır ve karşılığında bir yanıt QDoc’u döner. Yayımlanmış QDoc’lar arasında
maintainItemMaster,maintainRoutingvemaintainPurchaseOrderbulunur. Yayımlanmış QDoc’u olmayan programlarda QAD’nin QGen aracı menü programını eşleştirir: “QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.” (QGen, yayımlanmış QDoc şemaları ve olay dosyaları bulunmayan özel programları veya QAD Enterprise Applications programlarını eşleştirmek için kullanılır.) QAD de bu yolu kullanır: “QAD Production Scheduler uses QAD QXtend to update work orders.” (QAD Production Scheduler, üretim emirlerini güncellemek için QAD QXtend kullanır.) (QXtend kılavuzu) - QAD QXtend Outbound (QXO). QXO “exports user-configurable business objects as XML QDocs out of QAD products.” (Kullanıcının yapılandırabildiği iş nesnelerini QAD ürünlerinden XML QDoc’ları olarak dışa aktarır.) Standart iş nesneleri arasında Item, Product Structure, Routing, Work Center, Department, Inventory Transaction ve Inventory Status bulunur.
- İş belgeleri için REST API’leri. Adaptive ERP 2022.1 sürümünden itibaren bu özellik kullanılabilir: “Query REST APIs are now available for business documents,” (İş belgeleri için artık sorgulama amaçlı REST API’leri kullanılabilir.) Filtreleme, sıralama, sayfalama ve verinin yalnızca bir bölümünü alma özellikleri sunan bu API’ler, kendi ortamınızdaki Swagger belgelerinde açıklanır (sürüm notları).
Yazma işlemleri QXtend üzerinden yapılır. Okuma işlemleri ise QXO ve REST sorgu API’leri üzerinden yürütülür.
Kimlik doğrulama ve lisanslama
- QXtend Inbound. Alıcıda Require Authentication etkinleştirildiğinde her QDoc bir Session ID veya QAD kullanıcı adı ve parolası içerir. QXI, programı çalıştırmadan önce kullanıcının menü erişim yetkilerini kontrol eder.
- Entegrasyon kullanıcısı. Yalnızca entegrasyonun çağırdığı menü programlarına erişebilen, entegrasyona özel bir QAD kullanıcısı oluşturun: Work Order Maintenance, Labor Feedback by Work Order, Work Order Receipt ve ana veri programları.
- QXtend lisansı. QXtend, aracı ve alıcı sayısına göre lisanslanır. QAD kılavuzunda, harici bir uygulamayla yapılan çift yönlü web servisi trafiğinin ücretsiz olmadığı belirtilir. Bu nedenle proje başlamadan önce QXtend lisansını teyit edin.
SkyPlanner tarafında REST API, Authorization-Token başlığındaki API token’ı ile kimlik doğrular (SkyPlanner Settings > API). API, Swagger/OpenAPI ile belgelenmiştir. Entegrasyon rehberi, ilk çağrıları adım adım açıklar.
Olaylar ve veri değişiklikleri
QXtend Outbound, QAD’nin veri değişikliklerini aktarma mekanizmasıdır. “A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.” (QAD Enterprise Applications içinde izlenen veriler değiştiğinde, değişiklik bildirimleri qxevents veritabanına yazılır.) QXO daha sonra QDoc’ları oluşturur ve bunları “to a directory location where the subscriber polls for and picks up new QDocs,” (abonenin düzenli olarak kontrol edip yeni QDoc’ları aldığı bir dizine) veya bir URL üzerinden dinleyen web servisine iletir.
SkyPlanner, QXO’nun yayın yaptığı noktaya web servisi olarak abone olur. QXO’nun kapsamadığı verileri ise REST sorgu API’lerini düzenli aralıklarla sorgulayarak alır. Work Order, standart QXO iş nesnelerinden biri değildir. Bu nedenle entegrasyonda ya üretim emri tabloları (wo_mstr, wr_route) üzerinde bir QXO iş nesnesi eklenir ya da üretim emirleri REST sorgu API’leri üzerinden birkaç dakikada bir sorgulanır.
SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir. Böylece geri yazma işlemleri olay odaklı yürütülür.
Veri eşleme
| QAD nesnesi (program, arayüz) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
| Stok kartları (Item Master Maintenance 1.4.1; QXO Item) | Ürünler ve malzemeler | QAD → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda QXO üzerinden |
| Ürün yapıları (13.5; QXO Product Structure) | Ürün yapısı, alt ürünler, ürün başına malzemeler | QAD → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda QXO üzerinden |
| Rotalar (14.13.1; QXO Routing): kuyruk, hazırlık, işlem, bekleme, taşıma | Süre, hazırlık süresi ve söküm süresi bilgileriyle süreç adımları | QAD → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda QXO üzerinden |
| İş merkezleri (14.5) ve bölümler (14.1; QXO Work Center, Department) | İş merkezleri, iş merkezi grupları, verimlilik oranları | QAD → SkyPlanner | İlk yükleme, sonrasında nadiren |
| Atölye ve iş merkezi takvimleri | Vardiyalar ve çalışılmayan günler | QAD → SkyPlanner | Günlük veya vardiyaların SkyPlanner’da yönetilmesi |
| Rotaları (16.13.13) ve bileşenleriyle birlikte üretim emirleri (16.1) | Termin tarihleri ve malzeme ihtiyaçlarıyla birlikte siparişler ve işler | QAD → SkyPlanner | Özel QXO nesnesi veya birkaç dakikada bir REST sorgulaması |
| Stoklar (QXO Inventory Status, Inventory Transaction) | Stok bakiyeleri | QAD → SkyPlanner | Değişiklik olduğunda veya saatte bir |
| Termin tarihleriyle birlikte satın alma siparişleri | Satın alma siparişleri, teslimat tarihine göre gelecek malzemeler | QAD → SkyPlanner | Saatte bir veya çizelgeleme çalıştırıldığında sorgulama |
| Üretim emri serbest bırakma ve termin tarihleri (Work Order Maintenance 16.1, QXtend Inbound QDoc) | Her emir için planlanan başlangıç ve bitiş | SkyPlanner → QAD | Çizelge değiştiğinde SkyPlanner webhook’u aracılığıyla |
| Labor Feedback by Work Order (16.20.1): operasyon bazında hazırlık ve işlem süresi | Süre kayıtları ve operatör bildirimleri | SkyPlanner → QAD | Tercih edilirse bildirim veya vardiya başına |
| Work Order Receipt (16.11) | Tamamlanan miktarlar | SkyPlanner → QAD | Tercih edilirse bildirim başına |
| QAD’de bulunmaz | Hazırlık süresi matrisi, sınırlı kaynak olarak takımlar, alternatif makineler ve personel | SkyPlanner’da yönetilir | Devreye alma sırasında yapılandırılır |
Entegrasyon yöntemleri
1. Ana verilerin ilk yüklemesi. Stok kartlarını, ürün yapılarını, rotaları, iş merkezlerini ve takvimleri QXO veya REST sorgu API’leri üzerinden okuyun. İş merkezlerinin nasıl eşleştirileceğini dikkatle belirleyin: dört makineli bir iş merkezi, bir iş merkezi grubuna veya dört ayrı iş merkezine dönüşür. Production Line Maintenance içindeki tekrarlı üretim hatları da iş merkezi olarak tanımlanabilir.
2. Üretim emri senkronizasyonu. Kesin planlanmış ve serbest bırakılmış üretim emirlerini, rotaları ve bileşenleriyle birlikte okuyun; açık satın alma siparişlerini de alın. SkyPlanner, sipariş edilen malzemeyi satın alma siparişinin teslim tarihinde kullanılabilir kabul eder. Sipariş Delivered olarak işaretlendiğinde stoku günceller.
MRP planlı siparişlerini değil, üretim emirlerini çizelgeleyin. Planlı siparişler önce QAD’de kesin planlanmış veya serbest bırakılmış üretim emirlerine dönüştürülür.
3. Çizelgenin geri yazılması. Çizelgeleme motoru bir emri yerleştirdiğinde veya zamanını değiştirdiğinde SkyPlanner webhook’u, Work Order Maintenance (16.1) üzerinde bir QXtend Inbound QDoc tetikler. Serbest bırakma tarihi çizelgedeki ilk operasyonun tarihine, termin tarihi ise son operasyonun tarihine ayarlanır. QXtend, programı QAD’nin kendi doğrulama kurallarıyla çalıştırır ve entegrasyonun kontrol ettiği bir yanıt QDoc’u döndürür.
Her makinedeki operasyon sırası SkyPlanner’da tutulur ve Mobile Confirmations üzerinden operatörlere iletilir. Böylece entegrasyon, QAD’nin serbest bırakılmış emirlerde rota değişikliklerini engellemesinden etkilenmez.
4. Üretim sahasından bildirimler. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder. Bu süre kayıtları çizelgeyi güncel tutar. Gerçekleşen sürelerin QAD’ye geri aktarılıp aktarılmayacağını siz seçersiniz. Aktarılacaksa hazırlık ve işlem süreleri operasyon bazında Labor Feedback by Work Order’a, tamamlanan miktarlar ise Work Order Receipt’e gönderilir. Aktarılmayacaksa işçilik kayıtları eskisi gibi QAD’ye girilir.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bu kuralları yazılı hale getirin:
| Veri | Sorumlu sistem |
|---|---|
| Stok kartları, ürün yapıları, rotalar, miktarlar, üretim emri durumu | QAD |
| Operasyon sırası, başlangıç ve bitiş zamanları, makine ataması | SkyPlanner |
| Üretim emri serbest bırakma ve termin tarihleri | SkyPlanner yazar, QAD saklar |
| Hazırlık süresi matrisi, takım ve operatör gereksinimleri, alternatif kaynaklar | SkyPlanner |
| Vardiyalar ve çalışılmayan günler | Kapsam belirleme aşamasında seçilen tek bir sistem |
| İşçilik, bileşen çıkışları ve üretim girişleri | QAD; kayıtlar doğrudan girilir veya SkyPlanner süre kayıtlarından aktarılır |
Üretim emri tarihlerini yazacak tek bir sistem seçin. SkyPlanner herhangi bir QAD çizelgeleme modülüne ihtiyaç duymaz. Bu nedenle çizelgelediği emirlerin tarihlerini yazma görevini, çizelgeleme çalışma ekranlarından veya diğer çizelgeleme uygulamalarından devralır.
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra genellikle haftalar içinde tamamlanır. Öncesinde, QAD’den CSV veya Excel olarak dışa aktarılan iş merkezleri, rotalar ve açık üretim emirleriyle 30 günlük ücretsiz denemede çizelgenizi doğrulayın.
- Eşleştirme. Eşleştirme tablosunu, veri sahipliği kurallarını, kapsamdaki tesisleri ve domain’leri, senkronizasyon sıklıklarını ve işçilik kayıtlarının geri aktarılıp aktarılmayacağını kesinleştirin.
- QAD erişimi. Entegrasyon kullanıcısını oluşturun, QXtend lisansını teyit edin, QXtend alıcısını ve QXO abonesini yapılandırın. Önce bir test domain’inde deneyin.
- QDoc yapılandırması. Varsa yayımlanmış QDoc’ları kullanın. Gerektiğinde Work Order Maintenance, Labor Feedback by Work Order ve Work Order Receipt için QGen ile QDoc oluşturun.
- İlk yükleme. Stok kartları, ürün yapıları, rotalar, iş merkezleri, takvimler.
- Üretim emri ve satın alma siparişi senkronizasyonu. QXO olayları veya filtreleme, sayfalama ve yeniden deneme mekanizmalarıyla REST üzerinden düzenli sorgulama.
- SkyPlanner’da kısıtların tanımlanması. Hazırlık süresi matrisi, takımlar, iş başına operatör sayıları ve alternatif makineler veya personel.
- Çizelgenin geri yazılması ve paralel test. SkyPlanner webhook’ları üzerinden tarihleri aktarın, mevcut planla paralel çalıştırın, tarihleri karşılaştırın ve ana verileri düzeltin.
- Canlıya geçiş. Veriler eşleştiğinde geri yazmayı etkinleştirin.
QAD Adaptive ERP entegrasyonunda dikkat edilmesi gerekenler
- CRP’nin yeniden çalıştırılması. CRP, seçilen üretim emirlerinin tüm açık operasyonlarını yeniden çizelgeler. QAD, elle girilen tarihleri yalnızca “you also adjusted the work order release and due date to match,” (üretim emrinin serbest bırakma ve termin tarihlerini de eşleşecek şekilde ayarladığınızda) korur. SkyPlanner’ın yazdığı tarihler tam olarak bunlardır. CRP’yi geri yazma işleminden sonra çalıştırın veya SkyPlanner’ın çizelgelediği emirleri kapsam dışında bırakın.
- Serbest bırakılan emirlerin rotaları sabitlenir. “Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.” (Üretim emrinin durumu Exploded, Allocated veya Released olduğunda rotada artık değişiklik yapılamaz.) Rotayı serbest bırakma sırasında okuyun; rota değişikliklerini yalnızca planlanmış veya kesin planlanmış emirlerde yapın.
- Rotadaki zaman birimleri. Hazırlık ve işlem süreleri kapasite yüküne dahildir; ancak “queue, wait, and move times are excluded from load calculations.” (kuyruk, bekleme ve taşıma süreleri yük hesaplamalarına dahil edilmez.) SkyPlanner’da kuyruk, bekleme ve taşıma adımlarını yalnızca süre içerecek şekilde modelleyin. İşlem süresinin birim başına mı yoksa emir başına mı tanımlandığını kontrol edin.
- QXtend işlem kapasitesi. QAD şu uyarıyı yapar: “UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.” (Yüksek hacimli veriler veya gerçek zamanlı işlemler işlenirken UI API bağdaştırıcısının performansı kabul edilemez düzeyde olabilir.) Yalnızca değişen emirleri toplu olarak gönderin ve mevcutsa yerleşik QDocs belgelerini kullanın.
- Domain ve tesisler. Birden fazla domain içeren QAD kurulumlarında iş merkezleri ve üretim emirleri, domain ve tesis bazında tutulur. Kapsamdaki her tesisi kendine ait bir iş merkezi grubuyla eşleştirin.
- Tekrarlı ve kesikli üretimin bir arada kullanılması. Advanced Repetitive hatlarında üretim emirleri değil, tekrarlı üretim çizelgeleri kullanılır. SkyPlanner’ın hangi hatları çizelgeleyeceğine kapsam belirleme aşamasında karar verin.
QAD entegrasyonunu kim yapılandırır ve destekler?
- SkyPlanner ekibi, ilk kurulum sürecinde entegrasyonu yapılandırır ve canlıya geçişten sonra destek sağlar. Bu hizmet, üzerinde anlaşılmış QDocs belgelerini, QXO aboneliklerini ve REST sorgularını kapsar. Her tesis QAD’yi farklı kullanır; bu bilgi birikimi de burada devreye girer.
- QAD iş ortağınız da sürece katılabilir. İş ortağınız domain yapınızı, özelleştirmelerinizi ve lisans koşullarınızı bilir. SkyPlanner ekibiyle birlikte QXtend, QGen QDocs ve entegrasyon kullanıcısının kurulumunu yapabilir.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için bir API belirteciyle SkyPlanner’ın REST API arayüzünü kullanabilirler. Başlamak için bir API belirteci yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur. Teknik bilgilere SkyPlanner entegrasyon dokümantasyonundan ulaşabilirsiniz.
SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlayan fiyatlarla sunulur ve aylık faturalandırılır. Entegrasyon için sürecinize ve ihtiyaçlarınıza göre hazırlanan fiyat teklifi, seçtiğiniz planla birlikte önceden verilir. Fiyatlandırmayı, QAD Adaptive ERP ile üretim çizelgeleme sayfasını, QAD Adaptive ERP sayfasını ve ERP entegrasyonları sayfasını inceleyin.
Üreticilerin SkyPlanner yorumları
2 saathaftalık zaman tasarrufu
“SkyPlanner, üretim planlamamızı Excel tablolarından gerçek zamanlı üretim optimizasyonuna taşıdı.”
Kalle Kalliomäki, Tedarik Zinciri Uzmanı
UTU · Elektrik panoları ve şalt donanımları
Üretim planlama sayesinde her hafta 2 saatlik çalışma süresinden tasarruf ediliyor ve yeni iş kuyruğu saniyeler içinde üretim hattına ulaşıyor.
+%90üretim verimliliği
“Üretimde verimlilik %90 arttı.”
Abdul Rucyinga, BT Müdürü
Laboratory & Allied · İlaç üretimi
Üretim verimliliği %90 arttı. Tüm iş merkezlerini kapsayan, optimize edilmiş üç aylık bir planı hazırlamak 30 dakikadan az sürüyor.
1.000’lerceüretim emri otomatik çizelgeleniyor
“Üretimi artık bambaşka bir şekilde kontrol altında tutuyoruz ve kapasitemizi çok daha iyi anlıyoruz.”
Hannu Ryynänen, CEO
Mamec · Endüstriyel karıştırıcılar, pompalar ve yüksek teknolojili fason üretim
Binlerce üretim emri otomatik olarak çizelgeleniyor ve tüm kuruluş üretimi gerçek zamanlı olarak görebiliyor.
%99,2teslimat performansı
“SkyPlanner, darboğazları belirlemek için gereken görünürlüğü sağladı ve üretim yönetimini netleştirdi.”
Toni Tuori, Üretim Müdürü
Piristeel · Çatı güvenliği ve yağmur suyu sistemleri
Teslimat performansı bu yıl %99,2’ye ulaştı. Çizelgeleme sayesinde günde dört saate kadar çalışma süresinden tasarruf ediliyor.
Sık sorulan sorular
QAD Adaptive ERP’de üretim emirleri için bir API var mı?
Evet. QXtend Inbound, Work Order Maintenance ve üretim sahası programlarını SOAP ve XML QDocs üzerinden çalıştırır. Yayımlanmış bir QDoc bulunmadığında gerekli QDoc, QGen ile oluşturulur. İş belgelerine yönelik REST API arayüzleri ise filtreleme ve sayfalama özellikleriyle sorgu erişimi sağlar.
QAD, webhook desteği sunuyor mu?
QAD, veri değişikliklerini QXtend Outbound ile aktarır: tablo tetikleyicileri değişiklikleri kaydeder; QXO ise QDocs belgelerini bir web servisi URL’sine veya düzenli olarak kontrol edilen bir dizine iletir. SkyPlanner’ın kendi webhook’ları, çizelge değişikliklerini gerçekleştikleri anda gönderir.
Çizelgelenen tarihler QAD’ye nasıl geri yazılır?
Work Order Maintenance (16.1) üzerinde bir QXtend Inbound QDoc kullanılır. Bu belge, üretim emrinin serbest bırakma ve termin tarihlerini SkyPlanner çizelgesine göre ayarlar. QAD, QDoc belgesini ekranda uygulanan kurallarla doğrular ve yanıt olarak bir QDoc döndürür.
Operatör bildirimleri QAD’ye nasıl ulaşır?
Hazırlık ve işlem süreleri Labor Feedback by Work Order (16.20.1), tamamlanan miktarlar ise Work Order Receipt (16.11) üzerinden kaydedilir. Her iki aktarımda da QXtend Inbound QDocs kullanılır. Verilerin geri yazılıp yazılmayacağına kapsam belirleme aşamasında karar verilir.
Bir QAD iş ortağı, QAD Advanced Scheduling’i mi yoksa SkyPlanner’ı mı önermeli?
Müşteri kesikli üretim emirleriyle çalışıyor ve haftalar içinde gerçek kapasiteyi dikkate alan, işler bir üretim çizelgesi istiyorsa SkyPlanner’ı önermeli. QAD, Advanced Scheduling’i her tesis için hat bazında çizelgeleme sağlayan bir çözüm olarak tanımlıyor ve DSCP Production Planning ile Redzone’un yanında sunuyor (QAD). SkyPlanner, QXtend üzerinden bağlanır; her makineyi, operatörü, takımı ve malzemeyi çizelgeler, otomatik olarak yeniden planlama yapar ve aylık 199 €’dan başlayan fiyatlarla sınırsız kullanıcı sunar.
Entegrasyonu kurmadan önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz denemede, QAD’den CSV veya Excel ile veri aktararak 20 iş merkezine kadar çalışabilirsiniz. Kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.