Vodnik za integracijo SAP S/4HANA s SkyPlanner APS za terminiranje proizvodnje

S/4HANA ponuja integracijo prek izdanih storitev OData, navedenih na portalu SAP Business Accelerator Hub (api.sap.com). Integracija za terminiranje uporablja storitve OData V2. IDoc in BAPI sta še vedno na voljo, vendar ta vodnik uporablja izdane vmesnike OData API.

Avtentikacija glede na izdajo

• Lokalna namestitev in Private Edition. Storitve aktivirate v SAP Gateway s transakcijo /IWFND/MAINT_SERVICE. Integracijski uporabnik potrebuje ustrezne avtorizacijske objekte, na primer C_AFRU_AWK za potrditve, C_AFKO_AWK za postavke premikov blaga, knjižene s temi potrditvami, in M_PLAF_ORG za planske naloge.
• Public Edition. Storitve so na voljo samo prek komunikacijskih ureditev. Po SAP-ovih navodilih za nastavitev vhodne komunikacije v aplikaciji Communication Arrangements ustvarite komunikacijskega uporabnika, komunikacijski sistem in komunikacijsko ureditev na podlagi SAP-ovega komunikacijskega scenarija (SAP_COM_xxxx). Scenarij določa, katere storitve so na voljo in katere načine avtentikacije lahko uporabite:

– z žetoni: postopki OAuth, SAML ali OpenID Connect z žetoni bearer in prenosom identitete na poslovnega uporabnika – z odjemalskim potrdilom – z osnovno avtentikacijo s tehničnim komunikacijskim uporabnikom

SAP priporoča avtentikacijo z žetoni ali potrdili.

Na strani SkyPlanner je na voljo REST API z avtentikacijo JWT, dokumentiran v Swagger/OpenAPI (referenčna dokumentacija API). Vmesna programska oprema tako na eni strani skrbi za avtentikacijo SAP, na drugi pa za JWT.

Vmesniki API za terminiranje proizvodnje

Storitev	Uporabljene entitete in dejanja	Namen
API_PRODUCTION_ORDER_2_SRV (Production Order, Version 2)	A_ProductionOrder_2, A_ProductionOrderItem_2, A_ProductionOrderOperation_2, A_ProductionOrderComponent_2, A_ProductionOrderStatus_2, A_ProductionRsceTools_2; dejanja ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Nalogi, operacije, komponente, proizvodna sredstva in orodja (PRT), status, povratni zapis terminskega plana
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Delovni centri, kategorije kapacitet, intervali in izmene
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Standardni tehnološki postopki za planiranje pred ustvarjanjem nalogov
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Večnivojska struktura izdelka
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materiali (v API-ju imenovani Product). SAP zdaj za večino entitet izdelkov priporoča API Product (Version 2)
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Rezultati MRP Live pred pretvorbo
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Zaloga po obratih in skladiščnih lokacijah za preverjanje razpoložljivosti materiala
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Odprta nabavna naročila za prihajajoči material
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; dejanja GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Potrditve in premiki blaga iz proizvodnje

V API-ju za proizvodne naloge operacije določa kombinacija ključev OrderInternalBillOfOperations in OrderIntBillOfOperationsItem, ne pa številka operacije, ki jo vidi planer. Dejanje GetConfProposal v API-ju za potrditve isto operacijo naslavlja s poljema OrderID in OrderOperation. V SkyPlanner že ob prvem nalaganju shranite tako interne ključe kot številko operacije.

Dogodki

S/4HANA sproža poslovna dogodka Production Order Created in Production Order Changed, ki v podatkovni vsebini prenašata ManufacturingOrder, ProductionOrder, ProductionOrderType in ProductionPlant. Vsebina vključuje samo ključe, zato integracija znova prebere nalog in njegove operacije. Dogodek Changed se sproži ob vsaki spremembi naloga, zato uvedite časovno združevanje zaporednih dogodkov. V nasprotni smeri spletni kavlji SkyPlanner v realnem času pošiljajo obvestila ob spremembi terminskega plana ali stanja operacije.

Začetek z datotekami

Za preizkus izvozite proizvodne naloge in delovne centre iz seznamskih poročil S/4HANA v Excel ali CSV ter jih uvozite v SkyPlanner. Tako preverite terminski plan, še preden se lotite nastavitev Gateway ali komunikacijskih ureditev.

1. Nalaganje matičnih podatkov. Naložite materiale, kosovnice, delovne centre z njihovimi intervali kapacitet in izmenami ter tehnološke postopke. Na tej točki določite, kateri sistem bo pristojen za izmene. Deluje naslednja razdelitev: tovarniški koledar ostane v S/4HANA, podrobni razporedi izmen, odsotnosti in nadure pa se vodijo v SkyPlanner, kjer jih planerji dnevno spreminjajo.

2. Sinhronizacija nalogov. Naročite se na dogodke Production Order Created/Changed. Kjer poslovni dogodki niso nastavljeni, poizvedujte po A_ProductionOrder_2 glede na časovni žig spremembe. Filtrirajte po obratu, vrsti naloga in statusu. Naloge pošljite ob ustvarjanju, da lahko SkyPlanner planira vnaprej, in jih sprostite v S/4HANA (ReleaseOrder ali ReleaseOperation), ko jih SkyPlanner terminira.

3. Povratni zapis terminskega plana. Ko spletni kavelj SkyPlanner sporoči spremembo terminskega plana, integracija za vsako spremenjeno operacijo pokliče ScheduleProductionOrderOperation v API_PRODUCTION_ORDER_2_SRV. Pošlje:

• ManufacturingOrder, OrderInternalBillOfOperations in OrderIntBillOfOperationsItem kot ključe
• OpSchedulingMode z vrednostjo F (naprej) ter začetnim datumom in časom iz SkyPlanner v OpSchedldStartDate in OpSchedldStartTime
• OpSchedulingStatus z vrednostjo DISP (razporeditev) in obvezno polje OpSchedulingStrategy z vrednostjo M
• ETag v if-match

Vse operacije enega naloga se pošljejo v enem naboru sprememb, v zaporedju iz SkyPlanner, tako da S/4HANA z enim klicem razporedi celoten plan naloga. Način K se nikoli ne uporablja: ohrani prvotne datume operacij in prezre poslane datume.

SkyPlanner izračuna trajanje operacij iz istih standardnih vrednosti tehnološkega postopka in formul za kapacitete delovnih centrov, kot jih uporablja S/4HANA. Zato se končni datum, ki ga S/4HANA izračuna iz poslanega začetka, ujema s planom v SkyPlanner. Po vsakem naboru sprememb integracija znova prebere operacije in označi vse datume, ki odstopajo, planer pa jih vidi še pred naslednjo izmeno.

4. Potrditve iz proizvodnje. Vsak časovni zapis iz Mobile Confirmations ali Production Timer postane potrditev v S/4HANA. Spletni kavelj SkyPlanner sproži zapis ProdnOrdConf2 z dobro količino, izmetom in časi aktivnosti. Integracija najprej pokliče GetConfProposal, da S/4HANA predlaga količine, aktivnosti, datume in podatke o osebju. GetGdsMvtProposal predlaga premike blaga.

Prihajajoči material. Odprta nabavna naročila so del vhodne sinhronizacije. SkyPlanner obravnava naročeni material kot razpoložljiv na predvideni datum dobave iz nabavnega naročila. Dela, ki čakajo na kupljene komponente, se razporedijo na dan prihoda materiala, namesto da bi jih blokiralo današnje stanje zaloge.

S/4HANA ostaja merodajen vir podatkov o prevzemih: ob knjiženju prevzema blaga se zaloga poveča, odprta količina postavke nabavnega naročila pa zmanjša. Naslednja sinhronizacija posodobi zalogo v SkyPlanner in v celoti prejeto nabavno naročilo označi kot Delivered; po delnem prevzemu ostane preostala odprta količina predvidena za prejem na datum iz terminske vrstice. Obravnava nabavnih naročil v SkyPlanner je opisana v dokumentaciji SkyPlanner.

5. Pravila pristojnosti. S/4HANA je pristojen za količine, kosovnice, tehnološke postopke, kalkulacije stroškov in statuse. SkyPlanner je pristojen za zaporedje, dodelitev delovnemu centru in datume operacij. Nikoli ne dovolite, da bi oba sistema zapisovala v isto polje. Če planerji še vedno premikajo operacije v Capacity Scheduling Board, določite, kateri sistem ima prednost. Bodisi naslednja sinhronizacija nalogov prenese njihovo spremembo v SkyPlanner bodisi ta delovni center ostane zunaj obsega SkyPlanner.

• Povratni zapis je klic dejanja z ETag. Dokumentirani način terminiranja operacije je ScheduleProductionOrderOperation, ne zahteva PATCH za A_ProductionOrderOperation_2. Način F terminira naprej od začetka, B pa nazaj od konca, medtem ko K in S ohranita obstoječe datume in prezreta vaše. ETag v if-match se sestavi iz polja LastChangeDateTime naloga (YYYYMMDDHHMMSS), zato ob vsaki spremembi naloga zastara. Uvedite branje pred pisanjem in čakalno vrsto za ponovne poskuse.
• Kapaciteta ni zapisana v glavi delovnega centra. Razpoložljiva kapaciteta izhaja iz kategorije kapacitete (001 stroji, 002 delo), tovarniškega koledarja ter intervalov in izmen, ki imajo prednost pred njim. Formule za kapacitete pretvorijo standardne vrednosti tehnološkega postopka v potrebe za pripravo, obdelavo in pospravljanje. Preberite A_WorkCenterCapacityInterval_2 in entitete izmen ter se dogovorite, kako se formule pretvorijo v trajanja v SkyPlanner.
• Standardne vrednosti je treba urediti. Tehnološki postopki, ki se vzdržujejo za kalkulacijo stroškov, pogosto vsebujejo povprečne pripravljalne čase ali pripravo, evidentirano v napačni kategoriji kapacitet.
• Pravila za potrditve so stroga. SAP za množično knjiženje priporoča paketne klice. Vsak nabor sprememb se izvede v celoti ali pa sploh ne, zato en napačen časovni listek blokira preostanek nabora. Preklici v paketu se morajo izvajati v obratnem vrstnem redu ConfirmationCount. Na enem nalogu ne morete mešati vrst potrditev, knjižiti premikov blaga brez potrditve ali potrjevati operacij, katerih sprožilne točke zahtevajo pogovorno okno.
• Preverite, ali je PP/DS aktiven. Vgrajeni PP/DS zahteva aktivnost Customizing Activate Advanced Planning and Scheduling in SAP HANA integrated liveCache. SAP ga prodaja kot ločen izdelek, SAP S/4HANA Manufacturing for planning and scheduling. Kjer je aktiven, za vsak material določite, kateri sistem ga terminira: materiali, označeni za napredno planiranje, sodijo pod PP/DS. SAP za API za planirane naloge navaja tudi: “Automatic integration to PP/DS is not enabled from this API.” (Samodejna integracija s tem sistemom prek tega API ni omogočena.)
• Merske enote. Enote za količine operacij, osnovne količine tehnoloških postopkov in potrditve se lahko razlikujejo. Pretvorbo izvedite izrecno z uporabo enote operacije, ne osnovne enote materiala.
• Razlike med izdajami. SAP Learning prikazuje, kako klasično plansko tabelo CM21/CM22 nadomeščajo Manage Work Center Capacity, Capacity Scheduling Table in Capacity Scheduling Board. Public Edition omogoča dostop do API samo prek komunikacijskih scenarijev, ponujene različice storitev pa se lahko razlikujejo od lokalne namestitve. API za tehnološke postopke ne omogoča brisanja tehnoloških postopkov ali posodabljanja dodelitev materialov. Ekipa SkyPlanner med opredelitvijo obsega za vsak sistem stranke določi različice storitev na podlagi vnosa za ustrezno izdajo na portalu API Business Accelerator Hub.
• Omejitve, ki jih tehnološki postopki ne zajemajo. Menjave, odvisne od zaporedja, konflikte pri uporabi orodij in operacije z več operaterji vodite v SkyPlanner, ne v standardnih vrednostih tehnoloških postopkov. Matrika pripravljalnih časov vsebuje čase menjav za vsak par izdelkov. Orodja iz PRT naloga so omejeni viri in so lahko hkrati na voljo le enemu delovnemu centru, operacija pa lahko zahteva več ljudi hkrati.