Epicor Kinetic integravimo vadovas gamybos tvarkaraščiams sudaryti su SkyPlanner APS

Epicor teigia: „All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Visos Kinetic paslaugos, įskaitant verslo objektus, procesus, ataskaitas, BAQ ir Epicor Functions, pasiekiamos per REST galinius taškus.) Integruojant gamybos tvarkaraščių sudarymo sistemą naudojamos keturios Epicor technologijos:

1. Kinetic REST API v2 (OData v4). Verslo objektai pasiekiami per tarnybas, kurių pavadinimai sudaromi pagal šabloną Erp.BO.<Name>Svc. Įprastas kelias – /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 vis dar veikia, tačiau tai pasenusi versija, todėl integraciją kurkite su v2. Savo versijos esybių rinkinius ir metodus patikrinkite REST Help adresu /api/help/v2/.
2. Business Activity Queries (BAQ) per REST. BAQ pasiekiama adresu /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Tai praktiškas būdas nuskaityti planavimui skirtus duomenis, kai viena užklausa sujungiami JobHead, JobOper, JobMtl, PartWhse ir PORel duomenys (bendruomenės pavyzdys).
3. Epicor Functions (EFx). Serverio funkcijos, iškviečiamos adresu /api/v2/efx/{Company}/{Library}/{Function}. Epicor nurodo, kad jos „can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.“ (gali būti paleidžiamos įvairiais būdais, įskaitant BPM, REST tarnybas, vykdymą pagal tvarkaraštį ir programos įvykius).
4. BPM direktyvos. Method Directives ir Data Directives suveikia pasikeitus užduočiai ar operacijai ir gali iškviesti funkciją, kuri išsiunčia duomenis.

Failai importuojami naudojant DMT, o duomenys eksportuojami naudojant BAQ eksportą. Epicor taip pat siūlo Epicor Automation Studio, kurią apibūdina kaip „a low-code app for integration-led automations” (mažai programavimo reikalaujančią programą procesams automatizuoti per integracijas). Nenaudokite tiesioginės prieigos prie duomenų bazės: REST, BAQ ir funkcijos vienodai veikia tiek vietinėje infrastruktūroje, tiek Kinetic Cloud.

Epicor dokumentacijoje nėra bendrosios API išeinantiems webhook pranešimams, todėl Kinetic pakeitimai SkyPlanner pasiekia vienu iš dviejų būdų:

• Pagal įvykius. Objekto JobHead arba JobOper BPM Data Directive iškviečia Epicor Function, kuri pakeistą gamybos užsakymą siunčia į SkyPlanner REST API.
• Periodinės užklausos. Pagal pakeitimo datą filtruojama BAQ vykdoma kas kelias minutes arba kas valandą. Šį sprendimą paprasčiau prižiūrėti ir atkurti jo veikimą po sutrikimo.

Kita kryptimi SkyPlanner siunčia būsenos ir tvarkaraščio pakeitimus per savo webhook pranešimus. Juos gauna jūsų tarpinė programinė įranga arba EFx galinis taškas ir įrašo į Kinetic.

1. Pradinis pagrindinių duomenų įkėlimas. Nuskaitykite gaminius, išteklių grupes, išteklius, jų galimybes, kalendorius ir darbuotojus. Pagal Kinetic išteklius sukurkite SkyPlanner darbo centrus, o pagal išteklių grupes – darbo centrų grupes. Didelius duomenų kiekius skaitykite puslapiais naudodami $top ir $skip arba gaukite juos masiškai per BAQ.

2. Užsakymų sinchronizavimas. Siųskite vykdyti išleistus ir patvirtintus gamybos užsakymus su jų operacijomis ir medžiagomis. Visą gamybos užsakymo medį gaukite per GetDatasetForTree arba BAQ, o ne skaitydami kiekvieną esybę atskirai. Nepatvirtintus MRP gamybos užsakymus palikite Kinetic, kol jie bus patvirtinti. Kartu su atsargų nuskaitymu sinchronizuokite atviras pirkimo užsakymų tiekimo eilutes ir jų pristatymo terminus. SkyPlanner laiko, kad užsakytos medžiagos bus prieinamos pristatymo dieną, o atsargas atnaujina, kai pirkimo užsakymui nustatoma būsena Delivered. Taigi sudarant tvarkaraštį tikrinamos ir atsargos, ir būsimi pirkimų pristatymai.

3. Tvarkaraščio įrašymas atgal į Kinetic. SkyPlanner webhook siunčia kiekvienos operacijos planuojamą pradžią, pabaigą ir darbo centrą į EFx galinį tašką (/api/v2/efx/{Company}/{Library}/{Function}). Funkcija duomenis įrašo per Kinetic tvarkaraščių sudarymo variklį – tą patį verslo objektą, kurį naudoja Job Entry tvarkaraščių sudarymas ir planavimo lentos (bendruomenės pavyzdys):

1. ScheduleEngine.GetNewParamsForJob suformuoja tvarkaraščių sudarymo varikliui skirtą gamybos užsakymo duomenų rinkinį.
2. Funkcija nustato gamybos užsakymo numerį, surinkimo ir operacijos eilės numerius bei planuojamos pradžios datą ir laiką, tada iškviečia ScheduleEngine.MoveJobItem.
3. Jei SkyPlanner operacijai priskyrė kitą tos pačios grupės išteklių, ScheduleEngine.ChangeResource perkelia operaciją į jį. Naudojant vien MoveJobItem, lieka numatytasis grupės išteklius.
4. Funkcija užrakina gamybos užsakymo tvarkaraštį (JobHead.SchedLocked, parinktis Lock lange Job Entry), todėl Global Scheduling išsaugo SkyPlanner nustatytas datas.

Sujungus šiuos iškvietimus į vieną Epicor Function, kiekvieno gamybos užsakymo duomenys įrašomi kaip nedaloma operacija, be to, galima pridėti savo patikros taisykles. Jei įmonė nenori naudoti pasirinktinės funkcijos, tą pačią seką galima vykdyti tiesioginiais REST iškvietimais į Erp.BO.ScheduleEngineSvc. Niekada tiesiogiai nerašykite į ResourceTimeUsed ar JobOper datų laukus: taip apeinamas variklis ir planavimo lentose išteklių paskyrimai nebeatitinka tvarkaraščio.

4. Atliktų darbų patvirtinimai ceche. Operatoriai registruoja darbą SkyPlanner naudodami Mobile Confirmations, Production Timer arba Quick Log Mode. Kiekvienas užbaigtas darbo laiko įrašas per Erp.BO.LaborSvc tampa Kinetic darbo apskaitos įrašu: veiklai registruoti realiuoju laiku naudojami StartActivity ir EndActivityByEmp, o jau atliktam darbui įvesti – Labors su Update. Jei jūsų įmonėje reikalingas patvirtinimas, į procesą ir prieigos teisių apimtį įtraukite submitForApproval.

5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Aprašykite jas prieš pradėdami naudoti integraciją:

SkyPlanner planuojamoms užduotims nustatytas tvarkaraščio užraktas, todėl Global Scheduling jų datų nekeičia. Išteklius, kurių SkyPlanner neplanuoja, ir toliau planuokite su Kinetic.

Diegimas paprastai užbaigiamas per kelias savaites nuo jo pradžios. Kinetic projektas apima:

1. 30 dienų bandomąjį naudojimą su CSV arba Excel formatu eksportuotomis užduotimis, operacijomis ir ištekliais, dar nepradėjus programavimo darbų.
2. API raktą, prieigos sritį, atskirą integracijos naudotoją ir BAQ, iš kurių integracija skaito duomenis.
3. Pagrindinių duomenų susiejimą: gebos, išteklių grupės, ištekliai, kalendoriai ir darbuotojai susiejami su SkyPlanner darbo vietomis, grupėmis, pamainomis ir personalu.
4. Pradinį gaminių, gamybos metodų (BOM ir operacijų) bei išteklių įkėlimą.
5. Gamybos ir pirkimo užsakymų sinchronizavimas (PORel pristatymo terminai), taip pat PartWhse atsargų sinchronizavimas.
6. Planuojamų operacijų datų įrašymas atgal per ScheduleEngineSvc (MoveJobItem, ChangeResource) naudojant Epicor Function ir užrakinant gamybos užsakymo tvarkaraštį.
7. Ceche pateiktų atlikto darbo patvirtinimų įrašymas į darbo apskaitą per LaborSvc.
8. Testavimą lygiagrečiai su esamu Kinetic tvarkaraščiu, o po jo – paleidimą.

Kiekviena gamykla Kinetic naudoja savaip. Technologiniai maršrutai pagal gebas, išteklių grupių kalendoriai, BAQ struktūra, BPM direktyvos ir nuo versijos priklausantys duomenų grąžinimo metodai skiriasi. Nuo tinkamo jų suderinimo priklauso, ar planuotojai tvarkaraščiu pasitikės, ar turės jį perdaryti.

1. SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir ją prižiūri pradėjus naudoti. Komanda susieja jūsų išteklius, užduotis ir pirkimo užsakymų tiekimo grafiko eilutes, nustato duomenų skaitymą per BAQ, BPM paleidiklius ir duomenų grąžinimo funkciją. Ji sujungia SkyPlanner REST API ir webhook pranešimus su Kinetic REST v2. Pagalba teikiama ir pasikeitus jūsų BAQ, BPM ar Kinetic versijai.
2. Jūsų Epicor partneris. Partneriai, jau kuriantys BAQ, BPM ir Epicor Functions, gali naudoti tą pačią dokumentuotą SkyPlanner REST API, kuri skaito ir įrašo užsakymus, gaminius, medžiagas, proceso žingsnius bei darbo laiko įrašus.
3. Jūsų programuotojai. Vidinės komandos, turinčios Kinetic REST patirties, gali kurti integraciją tiesiogiai arba per Automation Studio, jei ją naudojate. Pradėti pakanka SkyPlanner API rakto (integravimo instrukcija), o prireikus padeda SkyPlanner komanda. Produkto dokumentacija viešai pasiekiama SkyPlanner dokumentacijos svetainėje.

Toks pat integravimo per API ir webhook pranešimus būdas jau naudojamas gamyboje su kitomis ERP sistemomis, pavyzdžiui, įmonėje UTU. Įmonės Laboratory & Allied vidinė IT komanda SAP Business One integraciją daugiausia sukūrė pati, padedama SkyPlanner.

Visi būdai prasideda vienodai: pirmiausia pasinaudokite 30 dienų nemokamu bandomuoju laikotarpiu su importuotais CSV duomenimis, patikrinkite tvarkaraštį ir tik tada kurkite integraciją. Kaina – nuo 199 € per mėnesį už 5 darbo vietas, mokama kas mėnesį, atsisakyti galima bet kada. Integracijos kaina pagal jūsų procesą ir poreikius pateikiama iš anksto kartu su pasirinktu planu, todėl visas išlaidas žinote dar prieš pradėdami.