Monitor ERP integrációs útmutató a SkyPlanner APS gyártásütemezéséhez

A Monitor G5 dokumentált integrációs felülete a Monitor ERP API v1. A CQRS és a REST megközelítését ötvözi, és HTTPS-en továbbít JSON-adatokat. (Monitor ERP API)

• A lekérdezések GET-kérésekkel olvasnak adatokat. OData-jellegű paramétereket fogadnak: $filter, $select, $expand, $orderby, $top és $skip.
• A parancsok POST-kérésekkel írnak adatokat, például: Manufacturing/ManufacturingOrderOperations/Update.
• A Batch több parancsot hajt végre egyetlen tranzakcióban a POST /api/v1/Batch végponton keresztül: vagy mindegyik végrehajtódik, vagy egyik sem. A köteg teszteléséhez és visszagörgetéséhez fűzze hozzá a /Simulate vagy a /Validate utótagot. Így biztonságosan visszaírható a teljes ütemterv. (Batch)

Az alap URL: https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. A cégszám az adatbázis számából és a cég azonosítójából áll össze, például: 004.1.

A licencelésről a Monitor így fogalmaz: “It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.” (Az API-ból minden ügyfelünk ingyenesen kérdezhet le és nyerhet ki információt. A parancsok használatához és az ERP-rendszerbe történő adatíráshoz azonban meg kell vásárolni a Monitor ERP API-t.) Már az első naptól számoljon a projektben az íráshoz szükséges licenccel. (api.monitor.se)

A Monitor ERP API referenciadokumentációja nem ismertet webhookokat vagy eseményfeliratkozásokat. A változásokat rendszeres lekérdezéssel lehet észlelni:

• A Common/EntityChangeLogs (a 2.33 verziótól) a következőket adja vissza: ChangeType (Update, Create, Delete), EntityTypeId, EntityId és ModifiedTimestamp. Kérdezze le néhány percenként, és csak a megváltozott rekordokat töltse le. (EntityChangeLog)
• A gyártási rendelések lekérdezését szűrje a nyitott rendelésekre, a lapozáshoz pedig használja a $top és a $skip paramétert.

A SkyPlanner webhookokat küld, amikor az állapot vagy az ütemterv megváltozik, így a visszaírás eseményvezérelt.

1. A törzsadatok kezdeti betöltése. Olvassa be a munkaállomásokat, műveleti sorokat, alternatív műveleti sorokat, anyagsorokat, cikkeket és beosztásokat. Gondosan rendelje hozzá az egyes munkaállomásokat a megfelelő SkyPlanner-munkaállomáshoz. A Pool típusú munkaállomásból munkaállomás-csoport lesz, a hozzá tartozó munkaállomásokból pedig azok a munkaállomások, amelyek közül az ütemezőmotor választ.

2. Rendelések szinkronizálása. Olvassa be a nyitott gyártási rendeléseket a csomópontjaikkal, műveleteikkel és anyagaikkal együtt, valamint a készletet és a nyitott beszerzési rendeléseket. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumán tekinti elérhetőnek, és akkor frissíti a készletet, amikor a beszerzési rendelés Delivered állapotot kap. Az első betöltés után a Common/EntityChangeLogs alapján történik a változások átvétele.

3. Az ütemterv visszaírása. A SkyPlanner minden olyan művelethez, amelyet az ütemezőmotor elhelyezett vagy áthelyezett, ManufacturingOrderOperations/Update kérést küld a PlannedStartDate és a PlannedFinishDate mezőkkel. Ha az ütemezőmotor a csoporton belül másik gépre helyezett át egy műveletet, először a SetWorkCenter fut le. Az egy rendeléshez tartozó parancsok egyetlen Batch kötegbe kerülnek, így a Monitor vagy mindet elfogadja, vagy egyiket sem. Teszteléskor futtassa a köteget a /Validate végponton keresztül.

A Monitor 24.5 előtti verzióiban a tervezett dátumok nem írhatók az Update paranccsal. Helyette használja a ManufacturingOrders/ReplanOperation parancsot (a 2.40 verziótól) a StartDate és a FinishDate mezőkkel, a RestrictToOrderBounds értékét pedig állítsa be a saját szabályainak megfelelően.

4. Üzemi visszajelentések. Egyetlen visszajelentési csatornát használjon:

• Továbbra is a Monitor a csatorna. A dolgozók az eddigiekhez hasonlóan a Recording terminal felületén vagy gépintegráción keresztül jelentik vissza a munkát. A SkyPlanner a ManufacturingOrderOperationReportings adataiból követi az előrehaladást, és újraütemez.
• A SkyPlanner lesz a csatorna. A dolgozók a Mobile Confirmations vagy a Production Timer használatával rögzítik a munkát, a SkyPlanner pedig ReportManufacturingOrderOperation kérést küld a Monitornak.

Ha mindkét rendszerben történik visszajelentés, az idők és a mennyiségek kétszer kerülnek rögzítésre.

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

Az ütközések fő oka, hogy a tervezők továbbra is módosítják a prioritási tervet. A Rescheduling according to New finish funkció és a sorok áthúzása a Priority planning felületen felülírja a SkyPlanner által rögzített dátumokat. Amint a sorrendet a SkyPlanner határozza meg, a Priority planning már csak megtekintésre szolgál. Az Autopilot használatával a SkyPlanner automatikusan újraütemez, ha változás történik a gyártásban.

• Rendelkezésre állási tényező. A Monitor a rendelkezésre állási tényezővel számítja ki a bruttó kapacitásból a nettó kapacitást. Új munkaállomásnál ennek alapértéke 80 %. Csak egyszer vegye figyelembe: vagy a SkyPlanner hatékonysági értékeként, vagy rövidebb műszakokkal, de soha ne mindkettővel.
• Időbeli pontosság. A Day planning beállítást használó munkaállomások kapacitása napi alapidőként szerepel, műszakidőpontok nélkül. A gyártási munkarendek alapján állítsa be a tényleges műszakokat a SkyPlanner rendszerben, hogy a feladatok munkaidőre kerüljenek.
• Várakozási idő és átfedés. A műveletek adatsorai várakozási időt és %-ban megadott átfedést tartalmaznak. A felmérés során döntse el, hogyan felelteti meg ezeket a SkyPlanner beállításainak, különben az átfutási idők megváltoznak az éles indulás után.
• Munkaállomás-csoportok. A csoportba szervezett munkaállomások tervezése a Pool planning, nem pedig a Priority planning felületen történik. A csoportba tartozó munkaállomásokat is olvassa be, ne csak a csoport sorát.
• Verziókövetelmények. A tervezett dátumok Update funkcióval történő módosításához a 24.5-ös verzió szükséges. A munkaállomások kapacitásmezői az API-ban a 24.3-as, az OIDC pedig a 25.8-as verziót igényli. A felmérés előtt ellenőrizze a buildet.
• Hálózat és tanúsítvány. A helyben telepített Monitor a 8001-es porton, önaláírt tanúsítvánnyal szolgálja ki az API-t. A SkyPlanner a felhőben fut, ezért tervezzen be tűzfalszabályt vagy közvetítőt, és kifejezetten állítsa be megbízhatóként a tanúsítványt.
• Licencek. Minden adatot író külső alkalmazáshoz saját, API-licenccel rendelkező felhasználók szükségesek. Minden rendszerhez jár egy csak olvasási jogosultságú API-felhasználó.