Business Centrali liidestamise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga

Liidestus kasutab kaht Business Centrali standardvarustusse kuuluvat liidest:

1. API v2.0 äri- ja laoandmete jaoks. Selle kaudu on kättesaadavad items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers ja employees. Tootmisolemeid selles ei ole, seega tulevad tootmisandmed teise liidese kaudu.
2. OData v4 veebiteenused tootmisandmete jaoks. Iga Business Centrali lehe saab avaldada OData v4 veebiteenusena lehel Web Services. Valige objekti tüübiks Page, määrake lehe ID ja teenuse nimi ning märkige Published. Lõpp-punkt on seejärel kasutusvalmis: AL-koodi pole vaja kirjutada ega laiendust juurutada. Integratsioon avaldab standardlehed vabastatud tootmistellimuste, Prod. Order Routing Lines, töökeskuste, masinakeskuste ja tehnoloogiliste marsruutide jaoks. Need on kättesaadavad aadressil /ODataV4/Company('{name}')/{ServiceName}.

Avaldatud lehtede kaudu saab andmeid nii lugeda kui ka kirjutada. Microsoft: “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,” (kui muudetav leht avaldatakse veebiteenusena, saab selle aluseks oleva tabeli andmeid OData päringuga lugeda ja muuta). Uuendamiseks kasutatakse PATCH-päringut. Nii jõuavad planeeritud kuupäevad tagasi Business Centrali sama lehe ja samade valideerimisreeglite kaudu, mida kasutab planeerija.

Ärge kasutage SOAP-i. Microsoft on märkinud SOAP-veebiteenused aegunuks ning Microsofti kasutajaliidese lehtede avaldamine SOAP-teenustena eemaldatakse versioonis 2026 release wave 2 (v29).

Business Central toetab veebihaakide tellimusi päringu POST /api/v2.0/subscriptions kaudu API v2.0 olemite jaoks, näiteks items ja salesOrders. Kehtivad järgmised reeglid:

• Tellimuse loomine nõuab kätlust: teie lõpp-punkt peab tagastama validationToken koos vastusega 200 OK.
• Tellimused aeguvad kolme päeva pärast. Uuendage neid PATCH-päringuga, mille järel tehakse kätlus uuesti.
• Teavitused sisaldavad ressursi teed, välja changeType ja teie määratud väärtust clientState, mitte tervet kirjet. Kirje tuleb seejärel eraldi lugeda.
• Teavitused saabuvad viivitusega: Business Centrali veebiversioon ootab pärast esimest muudatust 30 sekundit. Kui selle aja jooksul muutub üle 1 000 kirje, saadetakse nende kohta üks collection-teavitus.
• Veebiversioonis saab keskkonna kohta olla kuni 200 veebihaagi tellimust.

Tootmistellimusi, tehnoloogiliste marsruutide ridu ja ostutellimusi päritakse iga paari minuti järel avaldatud lehtedelt ja purchaseOrders kaudu. Kui päringud piirduvad avatud tellimustega ja tulemusi päritakse lehekülgede kaupa, jääb päringute arv Business Centrali piiridest selgelt allapoole.

SkyPlanner saadab oleku või ajakava muutumisel veebihaagiteateid, seega on andmete tagasikirjutamine sündmuspõhine.

1. Põhiandmete esmane laadimine. Tooge avaldatud lehtedelt tehnoloogilised marsruudid ja tootmise BOM-id olekuga Certified ning töö- ja masinakeskused. Kaubad ja mõõtühikud tooge API v2.0 kaudu. Vastendage iga töö- või masinakeskus läbimõeldult SkyPlanneri töökeskusega: otsustage, kas kolme masinakeskusega töökeskusest saab üks töökeskuste rühm või kolm töökeskust.

2. Tellimuste sünkroonimine. Lugege avaldatud lehtedelt tootmistellimused olekuga Released (ja Firm Planned, kui koostate ka nende ajakava) koos marsruudiridade ja komponentidega. API v2.0 kaudu lugege lisaks avatud ostutellimuste read. SkyPlanner käsitleb tellitud materjali ostutellimuse tarnekuupäeval saadaolevana ja uuendab laoseisu, kui ostutellimus märgitakse olekusse Delivered. Seega arvestab ajakava nii laoseisu kui ka saabuvate ostudega.

Ärge kunagi koostage ajakava tootmistellimustele olekuga Planned. Microsoft ütleb Business Centrali kohta: “deletes them the next time you run planning.” (kustutab need planeerimise järgmisel käivitamisel). Planning Worksheet teeb jätkuvalt tarneettepanekuid ning SkyPlanner koostab kinnitatud tellimuste ajakava tegelikku võimsust arvestades.

3. Ajakava tagasikirjutamine. Standardleht Prod. Order Routing avaldatakse OData v4 veebiteenusena. Iga operatsiooni puhul, mille mootor ajakavasse paigutas või ümber tõstis, saadab SkyPlanner vastavale tehnoloogilise marsruudi reale PATCH-päringu koos If-Match ETagiga. See määrab väljade Starting Date-Time ja Ending Date-Time väärtused ning alternatiivsele masinale viidud operatsiooni puhul ka väljade Type ja No. väärtused.

PATCH käivitab lehe ja tabeli päästikud, nii et Business Central valideerib väljad oma loogika alusel täpselt nagu siis, kui planeerija muudab lehte Prod. Order Routing. Vastavalt uuenevad ka tootmistellimuse rea väljad Starting ja Ending Date-Time. Kogused, olek ja kulud jäävad Business Centrali hallata.

4. Tööde kinnitamine tootmises. Operaatorid registreerivad tööd SkyPlanner Mobile Confirmations või Production Timer abil ning ajakirjed hoiavad ajakava ajakohasena. Toodangut saab Business Centralis registreerida nagu varemgi, kasutades Production Journal või Output Journal päevikut.

Kui soovite toodangu ja tarbimise täiesti automaatset kirjendamist, lisatakse toodangupäeviku kirjendamiseks standardne Business Centrali API-leht. Seejärel kirjendab SkyPlanner iga operatsiooni seadistusaja, tööaja ja toodangu koguse. Kirjendamine uuendab Capacity Ledger Entries kandeid ning tehnoloogilise marsruudi viimase operatsiooni toodang lisab kauba lattu.

Valige toodangu kirjendamiseks üks kanal. Kui kirjendate nii SkyPlannerist kui ka Business Centrali Production Journal päevikust, tekivad topeltkanded.

5. Andmete haldamise ja konfliktide lahendamise reeglid. Pange need enne kasutuselevõttu kirja:

Peamised konfliktiallikad on tootmistellimuste toimingud Refresh ja Replan. Microsoft: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Kui kasutate tootmistellimuse ridade ümberarvutamiseks toimingut Refresh, kustutab Business Central olemasolevad read ja arvutab uued.) Replan võib muuta ka võimsusvajadust ning komponentide ümberarvutamine “deletes previous changes in the components.” (kustutab komponentides varem tehtud muudatused).

Käsitlege värskendatud tellimust uue versioonina, sünkroonige see uuesti ja laske SkyPlanneril ajakava ümber koostada. Autopiloti kasutamisel koostab SkyPlanner tootmises toimuvate muutuste korral ajakava automaatselt ümber.

• Tehnoloogiliste marsruutide ühikud. Setup Time kehtib tootmistellimuse kohta, Run Time iga toodetud ühiku kohta ning kummalgi on oma Unit of Measure Code. Wait Time ja Move Time ei kasuta töökeskuse võimsust. Kui töökeskuse ühik on Days, tähendab üks päev 24 tundi, mitte kaheksatunnist vahetust. Teisendage ühikud importimisel, muidu on kõik kestused valed.
• Aegunud kalendrid. Võimsusandmed tekivad alles siis, kui Calculate Work Center Calendar on planeerimisperioodi jaoks käivitatud. Enne esmast laadimist kontrollige välja Calendar Entries Available Until.
• Masinakeskuste võimsus jääb varjatuks. Kui Consolidated Calendar on välja lülitatud, planeeritakse ainult töökeskuse enda võimsust: “The machine center capacity is excluded.” (Masinakeskuse võimsust ei arvestata.) Lugege masinakeskuste võimsusandmeid otse, selle asemel et toetuda töökeskuste koondnäitajatele.
• Capacity ja Efficiency. Business Central arvutab kestuse valemiga Run Time / Efficiency / Capacity ning arvutatud kalendrikanded arvestavad juba mõlemat tegurit. Vastendage Efficiency SkyPlanneri töökeskuse efektiivsusega üks kord, mitte kaks korda.
• Alternate Work Center on üksnes infoks. Microsoft ütleb selle kohta: “isn’t automatically included in planning processes.” (ei kaasata automaatselt planeerimisprotsessidesse). Määratlege alternatiivid eraldi SkyPlanneri alternatiivsete töökeskustena.
• Päringupiirangud. Veebiversiooni piirangud kehtivad kasutaja kohta ning teenuseidentiteet loetakse üheks kasutajaks: 6 000 OData päringut 5-minutilises libisevas ajaaknas ja 5 samaaegset päringut. Lehe suuruse ülempiir on 20 000, $batch võib sisaldada kuni 100 operatsiooni ja operatsiooni ajalõpp saabub 8 minuti järel. Lubatud päringusageduse ületamisel tagastatakse 429. Täieliku taaslaadimise asemel pärige muudatusi, kasutage pakettpäringuid ja jagage tulemused lehekülgedeks.
• Litsentsid. Tootmisfunktsioonid on saadaval ainult Premiumi kasutuskeskkonnas. Essentialsi kasutajad ei saa sisse logida ettevõttesse, mille kasutuskeskkonnaks on määratud Premium.