Sprievodca integráciou Monitor ERP so SkyPlanner APS na rozvrhovanie výroby

Zdokumentovaným integračným rozhraním Monitor G5 je Monitor ERP API v1. Kombinuje CQRS a REST a prenáša JSON cez HTTPS. (Monitor ERP API)

• Dopyty čítajú dáta metódou GET. Podporujú parametre v štýle OData: $filter, $select, $expand, $orderby, $top a $skip.
• Príkazy zapisujú dáta metódou POST, napríklad Manufacturing/ManufacturingOrderOperations/Update.
• Batch vykoná viacero príkazov v jednej transakcii cez POST /api/v1/Batch: buď sa vykonajú všetky, alebo žiadny. Pridaním /Simulate alebo /Validate dávku otestujete a jej zmeny vrátite späť. Takto môžete bezpečne zapísať celý rozvrh. (Batch)

Základná URL je https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Číslo spoločnosti sa skladá z čísla databázy a identifikátora spoločnosti, napríklad 004.1.

K licencovaniu Monitor uvádza: „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.“ (Dopytovanie a získavanie informácií cez API je pre všetkých zákazníkov bezplatné. Na používanie príkazov a zápis dát do ERP je však potrebné zakúpiť Monitor ERP API.) S licenciou na zápis počítajte v projekte od prvého dňa. (api.monitor.se)

Referenčná dokumentácia Monitor ERP API neuvádza žiadne webhooky ani odbery udalostí. Zmeny sa zisťujú pravidelným dopytovaním:

• Common/EntityChangeLogs (od verzie 2.33) vracia ChangeType (Update, Create, Delete), EntityTypeId, EntityId a ModifiedTimestamp. Dopytujte sa naň každých pár minút a načítavajte iba zmenené záznamy. (EntityChangeLog)
• Dopyty na výrobné príkazy filtrujte tak, aby vracali iba otvorené príkazy, a výsledky stránkujte pomocou $top a $skip.

SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu, takže spätný zápis je riadený udalosťami.

1. Úvodné načítanie kmeňových dát. Načítajte pracoviská, riadky operácií, riadky alternatívnych operácií, materiálové riadky, položky a rozpisy zmien. Každé pracovisko premyslene priraďte k pracovisku v SkyPlanner. Pracovisko typu Pool sa zmení na skupinu pracovísk a pracoviská, ktoré doň patria, sa stanú pracoviskami, medzi ktorými vyberá plánovacie jadro.

2. Synchronizácia príkazov. Načítajte otvorené výrobné príkazy s ich uzlami, operáciami a materiálmi, ako aj zásoby a otvorené nákupné objednávky. SkyPlanner považuje objednaný materiál za dostupný k dátumu dodania nákupnej objednávky a aktualizuje zásoby, keď objednávka dostane stav Delivered. Po prvom načítaní sa prírastkové zmeny načítavajú podľa Common/EntityChangeLogs.

3. Spätný zápis rozvrhu. Pre každú operáciu, ktorú plánovacie jadro zaradilo alebo presunulo, SkyPlanner odosiela ManufacturingOrderOperations/Update s PlannedStartDate a PlannedFinishDate. Ak jadro presunulo operáciu na iný stroj v skupine, najprv sa vykoná SetWorkCenter. Príkazy pre jeden výrobný príkaz sa odošlú v jednej dávke Batch, takže Monitor prijme buď všetky, alebo žiadny. Počas testovania spúšťajte dávku cez /Validate.

Vo verziách Monitor starších ako 24.5 sa plánované termíny nedajú zapisovať cez Update. Namiesto toho použite ManufacturingOrders/ReplanOperation (od verzie 2.40) so StartDate a FinishDate a nastavte RestrictToOrderBounds podľa svojich pravidiel.

4. Potvrdenia z výroby. Používajte jeden kanál vykazovania:

• Kanálom zostáva Monitor. Operátori vykazujú prácu cez Recording terminal alebo cez integráciu strojov tak ako doteraz. SkyPlanner načítava ManufacturingOrderOperationReportings ako údaje o priebehu výroby a preplánuje rozvrh.
• Kanálom sa stáva SkyPlanner. Operátori zaznamenávajú prácu pomocou Mobile Confirmations alebo Production Timer a SkyPlanner odosiela ReportManufacturingOrderOperation do systému Monitor.

Vykazovanie v oboch systémoch vedie k duplicitným časom a množstvám.

5. Pravidlá vlastníctva dát a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:

Konflikty vznikajú najmä vtedy, keď plánovači naďalej upravujú prioritný plán. Rescheduling according to New finish a presúvanie riadkov v Priority planning prepisujú termíny zapísané systémom SkyPlanner. Keď poradie operácií určuje SkyPlanner, Priority planning slúži už len na prezeranie. S funkciou Autopilot SkyPlanner pri zmenách vo výrobe automaticky preplánuje rozvrh.

• Koeficient dostupnosti. Monitor prepočítava hrubú kapacitu na čistú pomocou koeficientu dostupnosti. Na novom pracovisku má predvolenú hodnotu 80 %. Zohľadnite ho len raz: buď ako efektívnosť v systéme SkyPlanner, alebo skrátením zmien, nikdy nie oboma spôsobmi.
• Časová presnosť. Pracoviská v režime Day planning majú kapacitu vyjadrenú ako základný čas na deň bez časov zmien. V systéme SkyPlanner namapujte skutočné zmeny podľa výrobných kalendárov, aby sa úlohy rozvrhovali v rámci pracovného času.
• Čas čakania a prekrývanie. Riadky operácií obsahujú čas čakania a prekrývanie v %. Pri definovaní rozsahu rozhodnite, ako sa oba údaje prenesú do systému SkyPlanner. Inak sa po spustení ostrej prevádzky zmenia priebežné časy.
• Skupiny pracovísk. Pracoviská v skupinách sa plánujú v Pool planning, nie v Priority planning. Načítavajte aj zaradené pracoviská, nielen riadok skupiny.
• Požiadavky na verziu. Zápis plánovaných termínov cez Update vyžaduje verziu 24.5. Polia kapacity pracovísk v API vyžadujú verziu 24.3 a OIDC verziu 25.8. Pred definovaním rozsahu skontrolujte zostavu systému.
• Sieť a certifikát. Lokálne prevádzkovaný Monitor poskytuje API na porte 8001 s certifikátom podpísaným vlastným kľúčom. SkyPlanner beží v cloude, preto počítajte s pravidlom vo firewalle alebo so sprostredkujúcim serverom a certifikát explicitne nastavte ako dôveryhodný.
• Licencie. Každá aplikácia tretej strany, ktorá zapisuje údaje, potrebuje vlastných používateľov s licenciou API. Súčasťou každého systému je jeden používateľ API s prístupom len na čítanie.