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

Az integráció a Business Central két, alapból rendelkezésre álló interfészére épül:

1. API v2.0 a kereskedelmi és készletadatokhoz. A következő entitásokat teszi elérhetővé: items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers és employees. Gyártási entitásokat nem tartalmaz, ezért a gyártási adatok a második interfészen keresztül érkeznek.
2. OData v4 webszolgáltatások a gyártási adatokhoz. A Business Central bármely oldala közzétehető OData v4 webszolgáltatásként a Web Services oldalon. Válassza ki a Page objektumtípust, adja meg az oldal azonosítóját és a szolgáltatás nevét, majd jelölje be a Published lehetőséget. A végpont máris elérhető, AL-kód és telepítendő bővítmény nélkül. Az integráció a kiadott gyártási rendelések standard oldalait, valamint a Prod. Order Routing Lines, Work Center, Machine Center és Routing standard oldalakat teszi közzé a /ODataV4/Company('{name}')/{ServiceName} címen.

A közzétett oldalak olvashatók és írhatók. A Microsoft megfogalmazásában: “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,” (ha egy szerkeszthető oldalt webszolgáltatásként tesznek közzé, a mögöttes tábla adatai OData-hívással elérhetők és módosíthatók). A frissítésekhez PATCH használható. Így kerülnek vissza a tervezett időpontok a Business Centralba, ugyanazon az oldalon és ugyanazokon az ellenőrzéseken keresztül, amelyeket a tervező is használ.

Ne használjon SOAP-ot. A Microsoft elavultnak nyilvánította a SOAP-webszolgáltatásokat, és a 2026-os kiadás 2. hullámában (v29) megszünteti a Microsoft felhasználói felületéhez tartozó oldalak SOAP-ként való közzétételét.

A Business Central a POST /api/v2.0/subscriptions végponton keresztül támogatja a webhook-feliratkozásokat az API v2.0 entitásaihoz, például az items és a salesOrders entitáshoz. A szabályok a következők:

• A feliratkozás létrehozásához kézfogás szükséges: a végpontnak 200 OK válasszal kell visszaadnia a validationToken értékét.
• A feliratkozások három nap után lejárnak. PATCH-hívással újíthatók meg, ekkor a kézfogási folyamat ismét lefut.
• Az értesítések az erőforrás elérési útját, a changeType és az Ön által megadott clientState értékét tartalmazzák, nem a teljes rekordot. A rekordot ezután külön kell lekérni.
• Az értesítések késleltetve érkeznek: a Business Central online az első módosítás után 30 másodpercet vár. Ha ezalatt több mint 1 000 rekord változik, egyetlen collection értesítés érkezik róluk.
• Az online változatban környezetenként legfeljebb 200 webhook-feliratkozás engedélyezett.

A gyártási rendelések, a technológiai útvonalak sorai és a beszerzési rendelések lekérdezése néhány percenként történik a közzétett oldalakon, illetve a purchaseOrders entitáson keresztül. A nyitott rendelésekre szűrés és a lapozás révén a kérések száma jóval a Business Central korlátai alatt marad.

A SkyPlanner webhookot küld, amikor az állapot vagy az ütemezés megváltozik, így a visszaírás eseményvezérelten működik.

1. A törzsadatok első betöltése. Olvassa be a Certified állapotú technológiai útvonalakat és gyártási darabjegyzékeket, valamint a munkaállomásokat és gépközpontokat a közzétett oldalakról, a cikkeket és mértékegységeket pedig az API v2.0-n keresztül. Tudatosan alakítsa ki, hogy az egyes munkaállomások és gépközpontok mely SkyPlanner-munkaállomásoknak feleljenek meg: döntse el, hogy egy három gépközpontot tartalmazó munkaállomásból egy munkaállomáscsoport vagy három munkaállomás legyen.

2. A rendelések szinkronizálása. Olvassa be a Released állapotú gyártási rendeléseket – és a Firm Planned állapotúakat is, ha ezeket is ütemezi – a technológiai útvonaluk soraival és komponenseikkel együtt a közzétett oldalakról, a nyitott beszerzési rendelések sorait pedig az API v2.0-n keresztül. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumán tekinti elérhetőnek, és frissíti a készletet, amikor a rendelés Delivered jelölést kap. Az ütemezés így a készletet és a beérkező beszerzéseket egyaránt ellenőrzi.

Soha ne ütemezzen Planned állapotú gyártási rendeléseket: a Microsoft szerint a Business Central “deletes them the next time you run planning.” (a tervezés következő futtatásakor törli őket). A Planning Worksheet továbbra is javaslatokat tesz az ellátásra, a SkyPlanner pedig a rögzített rendeléseket ütemezi a tényleges kapacitás figyelembevételével.

3. Az ütemterv visszaírása. A standard Prod. Order Routing oldalt OData v4 webszolgáltatásként teszik közzé. A SkyPlanner minden olyan művelet technológiaiútvonal-sorához PATCH-kérést küld az If-Match ETag használatával, amelyet az ütemezőmotor elhelyezett vagy áthelyezett. Beállítja a Starting Date-Time és az Ending Date-Time mezőt, valamint a Type és a No. mezőt is, ha a művelet alternatív gépre került.

A PATCH lefuttatja az oldal és a tábla triggereit, így a Business Central a saját logikájával ellenőrzi a mezőket, pontosan úgy, mint amikor egy tervező szerkeszti a Prod. Order Routing oldalt. Ennek megfelelően módosul a gyártási rendelés sorának Starting és Ending Date-Time mezője is. A mennyiségek, az állapot és a költségek kezelése a Business Centralban marad.

4. Üzemi visszajelentések. A kezelők a SkyPlanner Mobile Confirmations vagy a Production Timer segítségével rögzítik a munkát, és az időbejegyzések naprakészen tartják az ütemezést. A gyártási teljesítmény a korábbiakhoz hasonlóan a Business Centralban, a Production Journal vagy az Output Journal segítségével jelenthető.

Ha teljesen automatikusan szeretné könyvelni a gyártási teljesítményt és az anyagfelhasználást, a rendszer kiegészül egy szabványos Business Central API-oldallal a teljesítménynapló könyveléséhez. A SkyPlanner ezután műveletenként könyveli az átállási időt, a futásidőt és a gyártott mennyiséget. A könyvelés frissíti a Capacity Ledger Entries tételeit, a technológiai útvonal utolsó műveletén jelentett teljesítmény pedig készletre veszi a cikket.

Egyetlen csatornát válasszon a gyártási teljesítmény könyvelésére. Ha a SkyPlannerből és a Business Central Production Journal naplójából is könyvel, a tételek megkettőződnek.

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

Az ütközések fő forrása a gyártási rendeléseken végrehajtott Refresh és Replan művelet. A Microsoft szerint: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Ha a Refresh művelettel újraszámítja a gyártási rendelés sorait, a Business Central törli a meglévő sorokat, és újakat számít ki.) A Replan a kapacitásigényt is módosíthatja, a komponensek újraszámítása pedig “deletes previous changes in the components.” (törli a komponenseken korábban végzett módosításokat).

A frissített rendelést kezelje új verzióként, szinkronizálja újra, majd hagyja, hogy a SkyPlanner újraütemezze. Az Autopilot használatával a SkyPlanner automatikusan újraütemez, amikor változás történik a gyártásban.

• Mértékegységek a technológiai útvonalakban. A Setup Time gyártási rendelésenként, a Run Time pedig legyártott cikkenként értendő, és mindkettőhöz saját Unit of Measure Code tartozik. A Wait Time és a Move Time nem köt le munkaállomás-kapacitást. Ha a munkaállomás mértékegysége Days, egy nap 24 órát jelent, nem egy nyolcórás műszakot. Importáláskor végezze el az átváltást, különben minden időtartam hibás lesz.
• Elavult naptárak. Csak akkor áll rendelkezésre kapacitás, ha a Calculate Work Center Calendar művelet lefutott a tervezési időszakra. Az első betöltés előtt ellenőrizze a Calendar Entries Available Until mezőt.
• Rejtve maradó gépközpont-kapacitás. Ha a Consolidated Calendar ki van kapcsolva, a tervezés csak a munkaállomás saját kapacitásával számol: “The machine center capacity is excluded.” (A gépközpont kapacitása kimarad.) Közvetlenül olvassa be a gépközpont kapacitását, ne hagyatkozzon a munkaállomás összesített értékeire.
• Capacity és Efficiency. A Business Central a Run Time / Efficiency / Capacity képlettel számítja ki az időtartamot, a kiszámított naptárbejegyzések pedig már mindkét tényezőt tartalmazzák. Az Efficiency értékét egyszer vegye figyelembe a SkyPlanner-munkaállomás hatékonyságában, ne kétszer.
• Az Alternate Work Center csak tájékoztató adat. A Microsoft szerint “isn’t automatically included in planning processes.” (nem kerül be automatikusan a tervezési folyamatokba). Az alternatívákat külön modellezze a SkyPlannerben alternatív munkaállomásként.
• Kéréskorlátozás. Az online korlátok felhasználónként érvényesek, és a szolgáltatásnév (service principal) egy felhasználónak számít: 5 perces gördülő időablakban 6 000 OData-kérés, egyidejűleg pedig 5 kérés engedélyezett. Az oldalméret felső határa 20 000, egy $batch legfeljebb 100 műveletet tartalmazhat, a műveletek pedig 8 perc után időtúllépéssel leállnak. A megengedett kérésgyakoriság túllépése 429-es választ eredményez. Teljes újratöltések helyett használjon kötegelt kéréseket, lapozást és a változások időszakos lekérdezését.
• Licencelés. A gyártási funkciók csak a Premium használati módban érhetők el. Az Essentials felhasználói nem jelentkezhetnek be Premium módra állított vállalatba.