Vodnik za povezavo Epicor Kinetic s SkyPlanner APS za terminiranje proizvodnje

Epicor navaja: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Vse storitve sistema Kinetic, vključno s poslovnimi objekti, procesi, poročili, BAQs in Epicor Functions, so dostopne prek končnih točk REST.) Integracija za terminiranje temelji na štirih tehnologijah Epicor:

1. Kinetic REST API v2 (OData v4). Poslovni objekti so na voljo kot storitve z imeni Erp.BO.<Name>Svc. Običajna pot je /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 še obstaja, vendar je zastarel, zato integracijo razvijajte na v2. Nabore entitet in metode za svojo izdajo preverite v REST Help na /api/help/v2/.
2. Business Activity Queries (BAQ) prek REST. BAQ je na voljo na /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. To je praktičen način branja podatkov za planiranje, saj lahko z enim klicem združite JobHead, JobOper, JobMtl, PartWhse in PORel (primer iz skupnosti).
3. Epicor Functions (EFx). Strežniške funkcije, ki jih lahko kličete na /api/v2/efx/{Company}/{Library}/{Function}. Epicor navaja: “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (Sprožiti jih je mogoče z več vstopnih točk, vključno z BPM, storitvami REST, urniki in dogodki aplikacije.)
4. Direktive BPM. Method Directives in Data Directives se sprožijo ob spremembi delovnega naloga ali operacije in lahko pokličejo funkcijo, ki podatke pošlje v zunanji sistem.

Pri izmenjavi datotek DMT skrbi za uvoz, izvozi BAQ pa za pridobivanje podatkov iz sistema. Epicor ponuja tudi Epicor Automation Studio, ki ga opisuje kot “a low-code app for integration-led automations” (aplikacijo z malo programiranja za avtomatizacijo na podlagi integracij). Izognite se neposrednemu dostopu do podatkovne zbirke: REST, BAQs in funkcije delujejo enako v lokalni namestitvi in v Kinetic Cloud.

Epicor ne dokumentira splošnega API za odhodne spletne kavlje, zato se spremembe iz sistema Kinetic v SkyPlanner prenašajo na enega od dveh načinov:

• Ob dogodku. BPM Data Directive za JobHead ali JobOper pokliče Epicor Function, ki spremenjeni nalog pošlje v REST API sistema SkyPlanner.
• Periodično preverjanje. BAQ s filtrom po datumu spremembe se izvaja vsakih nekaj minut ali vsako uro. Ta način je preprostejši za vzdrževanje in obnovitev delovanja ob napaki.

V nasprotni smeri SkyPlanner prek svojih spletnih kavljev pošilja spremembe stanja in terminskega plana. Vaša vmesna programska oprema ali končna točka EFx jih sprejme in zapiše v Kinetic.

1. Začetni prenos matičnih podatkov. Preberite artikle, skupine virov, vire, zmogljivosti, koledarje in zaposlene. Iz virov v Kinetic ustvarite delovne centre v sistemu SkyPlanner, iz skupin virov pa skupine delovnih centrov. Pri branju večjih količin podatkov uporabite straničenje z $top in $skip ali množični zajem prek BAQ.

2. Sinhronizacija nalogov. Pošljite sproščene in potrjene naloge z njihovimi operacijami in materiali. Drevesno strukturo naloga pridobite z GetDatasetForTree ali BAQ, ne pa z branjem vsake entitete posebej. Nepotrjene naloge MRP pustite v Kinetic, dokler niso potrjeni. Ob branju zaloge sinhronizirajte tudi odprte odpoklice nabavnih naročil z njihovimi roki dobave. SkyPlanner naročeni material obravnava kot razpoložljiv na datum dobave in posodobi zalogo, ko je nabavno naročilo označeno s statusom Delivered. Pri terminiranju zato preverja tako zalogo kot pričakovane nabave.

3. Zapis terminskega plana nazaj v Kinetic. Spletni kavelj sistema SkyPlanner pošlje planirani začetek, konec in delovni center za vsako operacijo na končno točko EFx (/api/v2/efx/{Company}/{Library}/{Function}). Funkcija podatke zapiše prek pogona za terminiranje v Kinetic. To je isti poslovni objekt, ki se uporablja za terminiranje v Job Entry in na terminskih tablah (primer iz skupnosti):

1. ScheduleEngine.GetNewParamsForJob pripravi podatkovni nabor naloga za pogon za terminiranje.
2. Funkcija nastavi številko naloga, zaporedni številki sklopa in operacije ter planirana datum in čas začetka, nato pa pokliče ScheduleEngine.MoveJobItem.
3. Če je SkyPlanner operacijo razporedil na drug vir v skupini, jo ScheduleEngine.ChangeResource premakne na ta vir. Sam klic MoveJobItem ohrani privzeti vir skupine.
4. Funkcija zaklene terminski plan naloga (JobHead.SchedLocked, možnost Lock v Job Entry), tako da Global Scheduling ohrani datume iz sistema SkyPlanner.

Če te klice združite v eno Epicor Function, ostane zapis za posamezni nalog atomaren, dodate pa lahko tudi lastno preverjanje veljavnosti. Če v obratu ne želite funkcije po meri, lahko isto zaporedje izvedete z neposrednimi klici REST na Erp.BO.ScheduleEngineSvc. Nikoli ne zapisujte neposredno v ResourceTimeUsed ali datumska polja JobOper: s tem obidete pogon za terminiranje in razporeditve na terminskih tablah niso več usklajene.

4. Potrjevanje dela v proizvodnji. Operaterji beležijo delo v sistemu SkyPlanner z Mobile Confirmations, Production Timer ali Quick Log Mode. Vsak zaključen časovni zapis se prek Erp.BO.LaborSvc prenese v Kinetic kot zapis opravljenega dela: za sprotno beleženje se uporabljata StartActivity in EndActivityByEmp, za naknadne vnose pa Labors z Update. Če vaš obrat zahteva odobritev, vključite submitForApproval v potek in obseg dostopnih pravic.

5. Pristojnosti za podatke in pravila ob konfliktih. Pred zagonom jih pisno določite:

Delovni nalogi, ki jih terminira SkyPlanner, imajo zaklenjen terminski plan, zato Global Scheduling njihovih datumov ne spreminja. Za vire, ki jih SkyPlanner ne planira, še naprej uporabljajte terminiranje v sistemu Kinetic.

Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Projekt povezave s sistemom Kinetic obsega:

1. 30-dnevni preizkus z izvozi delovnih nalogov, operacij in virov v obliki CSV ali Excel, še pred začetkom razvoja.
2. Ključ API, obseg dostopa, namenski uporabniški račun za integracijo in BAQs, ki jih integracija bere.
3. Preslikavo matičnih podatkov: zmogljivosti, skupin virov, virov, koledarjev in zaposlenih v delovna mesta, skupine, izmene in osebje v sistemu SkyPlanner.
4. Začetni prenos artiklov, tehnoloških postopkov (BOM in operacij) ter virov.
5. Sinhronizacija nalogov in nabavnih naročil (roki dobave PORel) ter zaloge PartWhse.
6. Zapis planiranih datumov operacij nazaj v Kinetic prek ScheduleEngineSvc (MoveJobItem, ChangeResource) v Epicor Function, z vključenim zaklepanjem naloga.
7. Prenos potrditev iz proizvodnje kot zapisov opravljenega dela prek LaborSvc.
8. Vzporedno testiranje z obstoječim terminskim planom v sistemu Kinetic, nato zagon.

Nobena dva obrata ne uporabljata sistema Kinetic povsem enako. Tehnološki postopki na podlagi zmogljivosti, koledarji skupin virov, zasnova BAQ, direktive BPM in metode za povratni zapis, odvisne od različice, se razlikujejo od obrata do obrata. Od pravilne nastavitve je odvisno, ali bodo planerji terminskemu planu zaupali ali pa ga bodo morali popravljati.

1. Ekipa SkyPlanner integracijo nastavi med uvajanjem in zanjo zagotavlja podporo po zagonu. Preslika vaše vire, delovne naloge in odpoklice nabavnih naročil ter nastavi branje BAQ, sprožilce BPM in funkcijo za povratni zapis. REST API in spletne kavlje sistema SkyPlanner poveže s Kinetic REST v2. Podpora se nadaljuje tudi ob spremembah vaših BAQs, BPMs ali različice sistema Kinetic.
2. Vaš partner Epicor. Partnerji, ki že razvijajo BAQs, BPMs in Epicor Functions, lahko uporabljajo isti dokumentirani REST API sistema SkyPlanner, ki omogoča branje in zapisovanje naročil, izdelkov, materialov, korakov postopka in časovnih zapisov.
3. Vaši razvijalci. Interne ekipe z izkušnjami s Kinetic REST lahko integracijo razvijejo neposredno ali v Automation Studio, če ga uporabljate. Za začetek zadostuje ključ API za SkyPlanner (vodič za integracijo), ekipa SkyPlanner pa po potrebi pomaga. Dokumentacija izdelka je javno dostopna na strani Dokumentacija SkyPlanner.

Enak način povezave z API in spletnimi kavlji že deluje v produkciji z drugimi sistemi ERP, na primer v podjetju UTU. V podjetju Laboratory & Allied je interna ekipa IT povezavo s SAP Business One ob pomoči ekipe SkyPlanner večinoma razvila sama.

Ne glede na izbrano pot začnite enako: najprej uporabite 30-dnevni brezplačni preizkus z uvozom datotek CSV, preverite terminski plan in šele nato razvijte integracijo. Cena je od 199 € na mesec za 5 delovnih mest, z mesečnim obračunom in možnostjo odpovedi kadar koli. Ponudbo za integracijo pripravimo vnaprej glede na vaš proces in potrebe, skupaj z izbranim paketom, tako da celotne stroške poznate še pred začetkom.