Epicor Kinetic integrációs útmutató a SkyPlanner APS-sel végzett gyártásütemezéshez

Az Epicor közlése szerint: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Minden Kinetic-szolgáltatás elérhető REST-végpontokon keresztül, beleértve az üzleti objektumokat, folyamatokat, jelentéseket, BAQ-lekérdezéseket és Epicor Functions függvényeket.) Az ütemezési integráció négy Epicor-technológiára épül:

1. Kinetic REST API v2 (OData v4). Az üzleti objektumok Erp.BO.<Name>Svc nevű szolgáltatásokként érhetők el. A szokásos elérési út: /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. A REST v1 még létezik, de már örökölt verzió, ezért a v2-re építsen. Az adott kiadás entitáskészleteit és metódusait a REST Help felületén ellenőrizze: /api/help/v2/.
2. Business Activity Queries (BAQ) REST-en keresztül. A BAQ a /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data címen érhető el. Ez a praktikus módja az olyan tervezési adatkivonatok lekérésének, amelyek egyetlen hívásban kapcsolják össze a JobHead, JobOper, JobMtl, PartWhse és PORel adatait (közösségi példa).
3. Epicor Functions (EFx). Szerveroldali függvények, amelyek a /api/v2/efx/{Company}/{Library}/{Function} címen hívhatók meg. Az Epicor leírása szerint: “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (Többféle belépési pontról indíthatók, többek között BPM-ekből, REST-szolgáltatásokból, ütemezetten és alkalmazáseseményekből.)
4. BPM-direktívák. A Method Directives és Data Directives direktívák egy gyártási feladat vagy művelet változásakor aktiválódnak, és meghívhatnak egy adatokat kifelé továbbító függvényt.

Fájlalapú adatcserénél az importálást a DMT, az adatok kinyerését pedig a BAQ-exportok végzik. Az Epicor kínálatában az Epicor Automation Studio is szerepel, amelyet így jellemez: “a low-code app for integration-led automations” (kevés kódolást igénylő alkalmazás integrációra épülő automatizáláshoz). Kerülje a közvetlen adatbázis-hozzáférést: a REST, a BAQ-lekérdezések és a függvények ugyanúgy működnek helyszíni telepítésnél, mint a Kinetic Cloud rendszerben.

Az Epicor nem dokumentál általános, kimenő webhook API-t, ezért a Kinetic változásai kétféleképpen juthatnak el a SkyPlannerhez:

• Eseményvezérelt adatküldés. A JobHead vagy JobOper objektumhoz tartozó BPM Data Directive meghív egy Epicor Function függvényt, amely elküldi a módosult gyártási feladatot a SkyPlanner REST API-nak.
• Ütemezett lekérdezés. Egy módosítási dátumra szűrt BAQ-lekérdezés néhány percenként vagy óránként lefut. Ezt egyszerűbb üzemeltetni és hiba után helyreállítani.

A másik irányban a SkyPlanner webhookokon keresztül küldi el az állapot- és ütemezésváltozásokat. Ezeket az Ön köztes szoftvere vagy egy EFx-végpont fogadja, majd beírja a Kinetic rendszerbe.

1. A törzsadatok kezdeti betöltése. Olvassa be a cikkeket, erőforráscsoportokat, erőforrásokat, képességeket, naptárakat és munkatársakat. A Kinetic erőforrásaiból hozza létre a SkyPlanner munkaállomásait, az erőforráscsoportokból pedig a munkaállomás-csoportokat. Nagy adatmennyiség lekérésekor használjon lapozást a $top és $skip paraméterekkel, vagy kérje le az adatokat tömegesen egy BAQ-n keresztül.

2. Rendelések szinkronizálása. Küldje át a kiadott és a véglegesített gyártási feladatokat a műveleteikkel és anyagaikkal együtt. A gyártási feladat teljes fastruktúráját a GetDatasetForTree metódussal vagy egy BAQ-val kérje le, ne entitásonként. A még nem véglegesített MRP-feladatokat a véglegesítésükig hagyja a Kinetic rendszerben. A készlet lekérésével együtt szinkronizálja a nyitott beszerzési lehívásokat és azok határidejét is. A SkyPlanner a megrendelt anyagot a szállítás napjától tekinti rendelkezésre állónak, a készletet pedig akkor frissíti, amikor a beszerzési rendelés Delivered állapotba kerül. Így az ütemezés a készletet és a beérkező beszerzéseket egyaránt figyelembe veszi.

3. Az ütemterv visszaírása. A SkyPlanner webhookja műveletenként elküldi a tervezett kezdést, befejezést és munkaállomást egy EFx-végpontnak (/api/v2/efx/{Company}/{Library}/{Function}). A függvény a Kinetic ütemezőmotorján keresztül írja be az adatokat. Ugyanez az üzleti objektum szolgálja ki a Job Entry ütemezését és az ütemezőtáblákat is (közösségi példa):

1. A ScheduleEngine.GetNewParamsForJob létrehozza az ütemezőmotor adatkészletét az adott gyártási feladathoz.
2. A függvény beállítja a gyártási feladat számát, a szerelvény és a művelet sorszámát, valamint a tervezett kezdés dátumát és időpontját, majd meghívja a ScheduleEngine.MoveJobItem metódust.
3. Ha a SkyPlanner a csoport egy másik erőforrására helyezte a műveletet, a ScheduleEngine.ChangeResource oda helyezi át. A MoveJobItem önmagában megtartja a csoport alapértelmezett erőforrását.
4. A függvény zárolja a gyártási feladat ütemezését (JobHead.SchedLocked, a Job Entry felület Lock beállítása), így a Global Scheduling megtartja a SkyPlanner által megadott dátumokat.

Ha ezeket a hívásokat egyetlen Epicor Function fogja össze, a gyártási feladathoz tartozó írás atomi marad, és saját ellenőrzések is beépíthetők. Ha az adott telephely nem kíván egyedi függvényt használni, ugyanez a hívássor közvetlen REST-hívásokkal is végrehajtható az Erp.BO.ScheduleEngineSvc szolgáltatáson. Soha ne írja közvetlenül a ResourceTimeUsed vagy a JobOper dátummezőit: ezzel megkerüli a motort, és az ütemezőtábla erőforrás-foglalásai nem lesznek összhangban az adatokkal.

4. Üzemi visszajelentések. A gépkezelők a SkyPlanner rendszerben a Mobile Confirmations, a Production Timer vagy a Quick Log Mode funkcióval rögzítik a munkát. Minden lezárt időbejegyzés munkavégzési adatként kerül a Kinetic rendszerbe az Erp.BO.LaborSvc szolgáltatáson keresztül. A folyamatban lévő munka rögzítéséhez a StartActivity és az EndActivityByEmp, az utólagos bejegyzésekhez pedig a Labors és az Update használható. Ha a telephelyen jóváhagyás szükséges, a submitForApproval hívást is vegye fel a folyamatba és az engedélyezett hozzáférések körébe.

5. Adatgazdák és ütközéskezelési szabályok. Rögzítse őket az éles indulás előtt:

A SkyPlanner által ütemezett gyártási feladatokon ütemezési zárolás van, így a Global Scheduling nem módosítja az időpontjaikat. Azoknál az erőforrásoknál, amelyeket nem a SkyPlanner tervez, tartsa meg a Kinetic ütemezését.

A megvalósítás általában a bevezetés megkezdésétől számított néhány héten belül lezárul. Egy Kinetic-projekt a következőket foglalja magában:

1. 30 napos próba a gyártási feladatok, műveletek és erőforrások CSV- vagy Excel-exportjaival, még a fejlesztés megkezdése előtt.
2. API-kulcs, hozzáférési hatókör, külön integrációs felhasználó és az integráció által olvasott BAQ-lekérdezések.
3. A törzsadatok megfeleltetése: a képességek, erőforráscsoportok, erőforrások, naptárak és dolgozók hozzárendelése a SkyPlanner munkaállomásaihoz, csoportjaihoz, műszakjaihoz és munkatársaihoz.
4. A cikkek, gyártási eljárások (BOM és műveletek), valamint erőforrások kezdeti betöltése.
5. A gyártási feladatok és a beszerzési rendelések szinkronizálása (PORel-határidők), valamint a PartWhse készletadatainak átvétele.
6. A műveletek tervezett dátumainak visszaírása a ScheduleEngineSvc (MoveJobItem, ChangeResource) használatával egy Epicor Function függvényen belül, a gyártási feladat ütemezésének zárolásával.
7. Az üzemi visszajelentések átadása munkavégzési adatként a LaborSvc szolgáltatáson keresztül.
8. Tesztelés a jelenlegi Kinetic-ütemtervvel párhuzamosan, majd éles indulás.

Nincs két üzem, amely ugyanúgy használná a Kinetic rendszert. A képességalapú technológiai útvonalak, az erőforráscsoportok naptárai, a BAQ-lekérdezések kialakítása, a BPM-direktívák és a verziófüggő visszaírási metódusok telephelyenként eltérnek. Ezek helyes beállításán múlik, hogy a tervezők megbíznak-e az ütemtervben, vagy újra kell dolgozniuk rajta.

1. A SkyPlanner csapata a bevezetés során beállítja az integrációt, és az éles indulás után is támogatja azt. A csapat megfelelteti az erőforrásokat, a gyártási feladatokat és a beszerzési rendelések lehívásait, majd beállítja a BAQ-alapú olvasást, a BPM-eseményindítókat és a visszaíró függvényt. Összekapcsolja a SkyPlanner REST API-ját és webhookjait a Kinetic REST v2-vel. A támogatás akkor is folytatódik, ha változnak a BAQ-lekérdezések, a BPM-ek vagy a Kinetic verziója.
2. Az Ön Epicor-partnere. A BAQ-lekérdezéseket, BPM-eket és Epicor Functions függvényeket már fejlesztő partnerek ugyanezt a dokumentált SkyPlanner REST API-t használhatják. Ezen keresztül rendelések, termékek, anyagok, folyamatlépések és időnaplók olvashatók és írhatók.
3. Az Ön saját fejlesztői. A Kinetic REST terén tapasztalt belső csapat közvetlenül is fejleszthet, vagy Automation Studio környezetben, ha azt használják. Az induláshoz elég egy SkyPlanner API-kulcs (integrációs útmutató), és a SkyPlanner csapata szükség esetén segít. A termék dokumentációja nyilvánosan elérhető a SkyPlanner dokumentációs oldalán.

Ugyanez az API-kra és webhookokra épülő megoldás más ERP-rendszerekkel is éles üzemben működik, például az UTU vállalatnál. A Laboratory & Allied belső informatikai csapata nagyrészt önállóan, a SkyPlanner segítségével készítette el az SAP Business One integrációját.

Mindegyik út ugyanúgy kezdődik: először használja a 30 napos ingyenes próbát CSV-importokkal, ellenőrizze az ütemtervet, majd építse ki az integrációt. A díj 5 munkaállomással havi 199 €-tól indul, havi számlázással, bármikor lemondható. Az integrációra előzetes árajánlatot adunk az Ön folyamataihoz és igényeihez igazítva, az előfizetéssel együtt, így már az indulás előtt látja a teljes költséget.