Vodnik za integracijo sistema Monitor ERP s SkyPlanner APS za terminiranje proizvodnje

Dokumentirani integracijski vmesnik sistema Monitor G5 je Monitor ERP API v1. Združuje pristopa CQRS in REST ter prenaša podatke v obliki JSON prek HTTPS. (Monitor ERP API)

• Poizvedbe berejo podatke z metodo GET. Podpirajo možnosti v slogu OData: $filter, $select, $expand, $orderby, $top in $skip.
• Ukazi zapisujejo podatke z metodo POST, na primer Manufacturing/ManufacturingOrderOperations/Update.
• Batch prek POST /api/v1/Batch izvede več ukazov v eni transakciji po načelu vse ali nič. Za preizkus paketa ukazov in razveljavitev njegovih sprememb dodajte /Simulate ali /Validate. Tako lahko varno zapišete celoten terminski plan. (Batch)

Osnovni URL je https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Številka podjetja združuje številko podatkovne zbirke in identifikator podjetja, na primer 004.1.

Monitor o licenciranju navaja: “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.” (Poizvedovanje in pridobivanje podatkov prek API sta za vse naše stranke brezplačna. Za uporabo ukazov in zapisovanje podatkov v sistem ERP pa je treba kupiti Monitor ERP API.) Licenco za zapisovanje vključite v projekt že od prvega dne. (api.monitor.se)

Referenčna dokumentacija za Monitor ERP API ne navaja spletnih kavljev ali naročnin na dogodke. Spremembe se zaznavajo s periodičnim preverjanjem:

• Common/EntityChangeLogs (od različice 2.33) vrne ChangeType (Update, Create, Delete), EntityTypeId, EntityId in ModifiedTimestamp. Preverjajte ga vsakih nekaj minut in pridobite le spremenjene zapise. (EntityChangeLog)
• Poizvedbe po proizvodnih nalogih omejite na odprte naloge, rezultate pa razdelite na strani z $top in $skip.

SkyPlanner ob spremembi stanja ali terminskega plana pošlje spletni kavelj, zato povratni zapis sprožajo dogodki.

1. Začetni prenos matičnih podatkov. Preberite delovne centre, vrstice operacij, vrstice alternativnih operacij, materialne vrstice, artikle in urnike. Skrbno določite, kateremu delovnemu centru v SkyPlanner ustreza vsak delovni center iz sistema Monitor. Delovni center tipa Pool postane skupina delovnih centrov, vanj vključeni delovni centri pa postanejo delovni centri, med katerimi izbira mehanizem za terminiranje.

2. Sinhronizacija nalogov. Preberite odprte proizvodne naloge z njihovimi vozlišči, operacijami in materiali ter zalogo in odprta nabavna naročila. SkyPlanner naročeni material obravnava kot razpoložljiv na datum dobave iz nabavnega naročila in posodobi zalogo, ko je naročilo označeno kot Delivered. Po začetnem prenosu se spremembe prenašajo na podlagi Common/EntityChangeLogs.

3. Povratni zapis terminskega plana. Za vsako operacijo, ki jo mehanizem za terminiranje razporedi ali premakne, SkyPlanner pošlje ManufacturingOrderOperations/Update s poljema PlannedStartDate in PlannedFinishDate. Če mehanizem operacijo premakne na drug stroj v skupini, se najprej izvede SetWorkCenter. Ukazi za en nalog se združijo v en Batch, zato jih Monitor sprejme vse ali pa nobenega. Med testiranjem paket ukazov izvedite prek /Validate.

V različicah sistema Monitor pred 24.5 planiranih datumov ni mogoče zapisovati prek Update. Namesto tega uporabite ManufacturingOrders/ReplanOperation (od različice 2.40) s poljema StartDate in FinishDate ter nastavite RestrictToOrderBounds v skladu s svojimi pravili.

4. Potrjevanje dela v proizvodnji. Uporabljajte en kanal za poročanje:

• Monitor ostane kanal za poročanje. Operaterji kot doslej poročajo prek Recording terminal ali povezave s stroji. SkyPlanner bere ManufacturingOrderOperationReportings kot podatke o napredku in ponovno terminira proizvodnjo.
• SkyPlanner postane kanal za poročanje. Operaterji beležijo delo s funkcijo Mobile Confirmations ali Production Timer, SkyPlanner pa v Monitor pošlje ReportManufacturingOrderOperation.

Poročanje iz obeh sistemov povzroči podvajanje evidentiranega časa in količin.

5. Pravila o lastništvu podatkov in reševanju neskladij. Zapišite jih pred prehodom v produkcijo:

Do navzkrižij najpogosteje pride, ko planerji še naprej spreminjajo prednostni plan. Rescheduling according to New finish in vlečenje vrstic v modulu Priority planning prepišeta datume, ki jih je zapisal SkyPlanner. Ko zaporedje določa SkyPlanner, se Priority planning uporablja le še za pregled. S funkcijo Autopilot SkyPlanner ob spremembah v proizvodnji samodejno posodobi terminski plan.

• Faktor razpoložljivosti. Monitor s faktorjem razpoložljivosti zmanjša bruto zmogljivost na neto zmogljivost. Pri novem delovnem centru je privzeta vrednost 80 %. Upoštevajte ga le enkrat: bodisi kot učinkovitost v sistemu SkyPlanner bodisi kot krajše izmene, nikoli oboje.
• Časovna natančnost. Delovni centri v načinu Day planning imajo zmogljivost določeno kot osnovni čas na dan, brez podatkov o začetku in koncu izmen. V sistemu SkyPlanner preslikajte dejanske izmene iz proizvodnih urnikov, da bodo dela razporejena znotraj delovnega časa.
• Čakalni čas in prekrivanje. Vrstice operacij vsebujejo čakalni čas in prekrivanje v %. Pri opredelitvi obsega določite, kako se oboje preslika v SkyPlanner, sicer se bodo pretočni časi po prehodu v produkcijo spremenili.
• Skupine delovnih centrov. Delovni centri v skupinah se planirajo v modulu Pool planning, ne v modulu Priority planning. Preberite vključene delovne centre, ne le vrstice skupine.
• Zahtevane različice. Zapisovanje planiranih datumov prek Update zahteva različico 24.5. Polja za zmogljivost delovnega centra v API zahtevajo različico 24.3, OIDC pa 25.8. Pred opredelitvijo obsega preverite izdajo.
• Omrežje in potrdilo. Lokalno nameščeni Monitor omogoča dostop do API prek vrat 8001 s samopodpisanim potrdilom. SkyPlanner deluje v oblaku, zato predvidite pravilo požarnega zidu ali posrednika in izrecno nastavite zaupanje potrdilu.
• Licence. Vsaka zunanja aplikacija, ki zapisuje podatke, potrebuje lastne uporabnike z licenco API. Vsak sistem že vključuje enega uporabnika API samo za branje.