SkyPlanner APS ile Üretim Çizelgeleme için Epicor Kinetic Entegrasyon Kılavuzu

Epicor şöyle açıklıyor: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (İş nesneleri, süreçler, raporlar, BAQ’lar ve Epicor Functions dahil tüm Kinetic servislerine REST uç noktaları üzerinden erişilebilir.) Çizelgeleme entegrasyonu dört Epicor teknolojisi üzerine kurulur:

1. Kinetic REST API v2 (OData v4). İş nesneleri, Erp.BO.<Name>Svc adıyla servis olarak sunulur. Standart erişim yolu /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet} şeklindedir. REST v1 hâlâ mevcuttur ancak eski sürümdür; bu nedenle entegrasyonu v2 üzerine kurun. Kullandığınız sürümün varlık kümelerini ve metotlarını /api/help/v2/ adresindeki REST Help üzerinden doğrulayın.
2. REST üzerinden Business Activity Queries (BAQ). Bir BAQ’ya /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data adresinden erişilir. JobHead, JobOper, JobMtl, PartWhse ve PORel verilerini tek çağrıda birleştirerek planlama için veri çekmenin pratik yolu budur (topluluktan bir örnek).
3. Epicor Functions (EFx). Sunucu tarafında çalışan bu fonksiyonlar /api/v2/efx/{Company}/{Library}/{Function} adresinden çağrılabilir. Epicor’un açıklamasına göre bu fonksiyonlar “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (BPM’ler, REST servisleri, zamanlanmış görevler ve uygulama olayları dâhil birden fazla giriş noktasından tetiklenebilir.)
4. BPM yönergeleri. Bir iş veya operasyon değiştiğinde Method ve Data Directives tetiklenir ve dışarıya veri gönderen bir fonksiyonu çağırabilir.

Dosya aktarımında içe aktarma işlemlerini DMT, dışa aktarma işlemlerini ise BAQ dışa aktarımları yürütür. Epicor ayrıca Epicor Automation Studio’yu sunar ve bunu şöyle tanımlar: “a low-code app for integration-led automations” (entegrasyon odaklı otomasyonlar için az kod gerektiren bir uygulama). Veritabanına doğrudan erişmeyin: REST, BAQ’lar ve fonksiyonlar hem şirket içi kurulumlarda hem de Kinetic Cloud’da aynı şekilde çalışır.

Epicor’un belgelerinde genel amaçlı bir dışa veri gönderme webhook API’si bulunmaz. Bu nedenle Kinetic’teki değişiklikler SkyPlanner’a iki yoldan biriyle ulaşır:

• Olay tabanlı aktarım. JobHead veya JobOper üzerindeki bir BPM Data Directive, bir Epicor Function çağırır. Bu fonksiyon, değişen işi SkyPlanner REST API’ye gönderir.
• Zamanlanmış sorgulama. Değişiklik tarihine göre filtrelenmiş bir BAQ, birkaç dakikada bir veya saatte bir çalışır. Bu yöntemi yönetmek ve hata sonrasında yeniden işler hale getirmek daha kolaydır.

Ters yönde ise SkyPlanner, durum ve çizelge değişikliklerini webhook’ları üzerinden gönderir. Ara yazılımınız veya bir EFx uç noktası bu değişiklikleri alır ve Kinetic’e yazar.

1. Ana verilerin ilk yüklemesi. Parçaları, kaynak gruplarını, kaynakları, yetenekleri, takvimleri ve çalışanları okuyun. Kinetic kaynaklarından SkyPlanner iş merkezlerini, kaynak gruplarından da iş merkezi gruplarını oluşturun. Büyük veri okumalarını $top ve $skip ile sayfalayın veya toplu veriyi bir BAQ üzerinden çekin.

2. Sipariş senkronizasyonu. Üretime açılmış ve kesinleştirilmiş işleri, operasyonları ve malzemeleriyle birlikte gönderin. İş ağacını varlıkları tek tek okuyarak değil, GetDatasetForTree veya bir BAQ ile çekin. Kesinleştirilmemiş MRP işlerini kesinleştirilene kadar Kinetic’te bırakın. Stok verilerini okurken açık satın alma siparişi teslimatlarını da termin tarihleriyle birlikte senkronize edin. SkyPlanner, sipariş edilen malzemeyi teslimat tarihinde kullanılabilir kabul eder ve satın alma siparişi Delivered olarak işaretlendiğinde stoğu günceller. Böylece çizelgelemede hem stoktaki hem de satın alma siparişleri kapsamında teslim alınacak malzemeler kontrol edilir.

3. Çizelgenin geri yazılması. SkyPlanner webhook’u, her operasyon için planlanan başlangıcı, bitişi ve iş merkezini bir EFx uç noktasına (/api/v2/efx/{Company}/{Library}/{Function}) gönderir. Fonksiyon, Kinetic’in çizelgeleme motoru üzerinden yazar. Bu motor, Job Entry çizelgelemesinin ve çizelgeleme panolarının da kullandığı iş nesnesidir (topluluktan bir örnek):

1. ScheduleEngine.GetNewParamsForJob, iş için çizelgeleme motorunun kullanacağı veri kümesini oluşturur.
2. Fonksiyon; iş numarasını, montaj ve operasyon sıra numaralarını, planlanan başlangıç tarihini ve saatini ayarlar, ardından ScheduleEngine.MoveJobItem çağrısını yapar.
3. SkyPlanner operasyonu gruptaki başka bir kaynağa atamışsa ScheduleEngine.ChangeResource, operasyonu o kaynağa taşır. Tek başına MoveJobItem, grubun varsayılan kaynağını korur.
4. Fonksiyon, işin çizelge kilidini (JobHead.SchedLocked, Job Entry içindeki Lock seçeneği) etkinleştirir. Böylece Global Scheduling, SkyPlanner’ın tarihlerini korur.

Bu çağrıları tek bir Epicor Function içinde toplamak, her iş için yazma işleminin atomik kalmasını sağlar ve kendi doğrulama kontrollerinizi eklemenize olanak tanır. Tesis özel bir fonksiyon kullanmayı tercih etmiyorsa aynı sıra, doğrudan Erp.BO.ScheduleEngineSvc servisine yapılan REST çağrılarıyla yürütülür. ResourceTimeUsed veya JobOper tarih alanlarına asla doğrudan yazmayın: bu, çizelgeleme motorunu atlar ve panodaki kaynak tahsislerinin çizelgeyle uyumunu bozar.

4. Üretim sahasından gerçekleşme bildirimleri. Operatörler, Mobile Confirmations, Production Timer veya Quick Log Mode ile SkyPlanner’a iş kaydı girer. Kapatılan her süre kaydı, Erp.BO.LaborSvc üzerinden Kinetic’te bir işçilik kaydına dönüşür. Çalışmayı anlık olarak kaydetmek için StartActivity ve EndActivityByEmp, sonradan girilen kayıtlar için ise Labors ile birlikte Update kullanılır. Tesisinizde onay gerekiyorsa submitForApproval metodunu hem akışa hem de yetki kapsamına ekleyin.

5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı olarak belirleyin:

SkyPlanner’ın çizelgelediği işlerde çizelge kilidi bulunur; böylece Global Scheduling bu işlerin tarihlerini değiştirmez. SkyPlanner’ın planlamadığı kaynaklar için Kinetic çizelgelemesini kullanmaya devam edin.

Kurulum, devreye alma sürecinin başlamasından itibaren normalde birkaç hafta içinde tamamlanır. Bir Kinetic projesi şunları kapsar:

1. Herhangi bir geliştirmeye başlamadan önce, işlerin, operasyonların ve kaynakların CSV veya Excel dışa aktarımlarıyla 30 günlük deneme.
2. API anahtarı, erişim kapsamı, entegrasyona özel bir kullanıcı ve entegrasyonun okuduğu BAQ’lar.
3. Ana verilerin eşleştirilmesi: yeteneklerin, kaynak gruplarının, kaynakların, takvimlerin ve çalışanların SkyPlanner’daki iş istasyonları, gruplar, vardiyalar ve personelle eşleştirilmesi.
4. Parçaların, üretim yöntemlerinin (BOM ve operasyonlar) ve kaynakların ilk yüklemesi.
5. İşlerin ve satın alma siparişlerinin (PORel termin tarihleri) yanı sıra PartWhse stok verilerinin senkronizasyonu.
6. Planlanan operasyon tarihlerinin, bir Epicor Function içinde ScheduleEngineSvc (MoveJobItem, ChangeResource) üzerinden iş kilidi etkinleştirilerek geri yazılması.
7. Üretim sahasından gelen gerçekleşme bildirimlerinin LaborSvc üzerinden işçilik kaydı olarak aktarılması.
8. Mevcut Kinetic çizelgesiyle paralel testlerin ardından canlıya geçiş.

Her tesis Kinetic’i farklı şekilde kullanır. Yeteneğe göre rota tanımları, kaynak grubu takvimleri, BAQ tasarımı, BPM yönergeleri ve sürüme özgü geri yazma metotları tesisten tesise değişir. Bunlar doğru yapılandırıldığında planlamacılar çizelgeye güvenir; aksi halde çizelgeyi yeniden düzenlemek zorunda kalırlar.

1. SkyPlanner ekibi, devreye alma sürecinde entegrasyonu yapılandırır ve canlıya geçişten sonra destek verir. Ekip; kaynaklarınızı, işlerinizi ve satın alma siparişlerinizin teslimat kalemlerini eşleştirir, BAQ okuma işlemlerini, BPM tetikleyicilerini ve geri yazma fonksiyonunu kurar. SkyPlanner’ın REST API’sini ve webhook’larını Kinetic REST v2’ye bağlar. BAQ’larınız, BPM’leriniz veya Kinetic sürümünüz değiştiğinde de destek devam eder.
2. Epicor iş ortağınız. BAQ, BPM ve Epicor Functions geliştiren iş ortakları, siparişleri, ürünleri, malzemeleri, işlem adımlarını ve süre kayıtlarını okuyup yazan aynı belgelenmiş SkyPlanner REST API’si üzerinde çalışabilir.
3. Kendi geliştiricileriniz. Kinetic REST deneyimi olan şirket içi ekipler doğrudan geliştirme yapabilir veya kullanıyorsanız Automation Studio’da çalışabilir. Başlamak için bir SkyPlanner API anahtarı yeterlidir (entegrasyon eğitimi); SkyPlanner ekibi gerektiğinde yardımcı olur. Ürün belgelerine SkyPlanner dokümantasyonu üzerinden herkes erişebilir.

Aynı API ve webhook yaklaşımı, örneğin UTU‘da olduğu gibi diğer ERP sistemleriyle de canlı kullanımda çalışır. Laboratory & Allied‘ın şirket içi BT ekibi, SAP Business One entegrasyonunu SkyPlanner’ın desteğiyle büyük ölçüde kendi başına geliştirdi.

Hangi yolu seçerseniz seçin başlangıç aynıdır: önce CSV verilerini içe aktararak 30 günlük ücretsiz denemeyi kullanın, çizelgenin işinize uygunluğunu doğrulayın, ardından entegrasyonu kurun. 5 iş istasyonu için fiyatlar aylık 199 €’dan başlar. Faturalandırma aylıktır ve istediğiniz zaman iptal edebilirsiniz. Sürecinize ve ihtiyaçlarınıza göre entegrasyon teklifi, abonelik planınızla birlikte önceden sunulur; böylece başlamadan önce toplam maliyeti görürsünüz.