Integraatiot / ERP / SAP Business ByDesign
SAP Business ByDesign -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä SAP Business ByDesign -integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten ByDesign yhdistetään SkyPlanner APS:ään. SkyPlannerin ja ByDesignin välinen integraatio toimii molempiin suuntiin SAP:n julkaisemien verkkopalvelujen kautta:
- SkyPlanneriin tuodaan vapautetut tuotantotilaukset työvaiheineen, Production Models, Bills of Material ja Bills of Operations sekä laite- ja henkilöstöresurssit, materiaalit, varastotiedot ja ostotilaukset.
- Kunkin tuotantotilauksen suunniteltu aloitus ja kunkin työvaiheen pääresurssi siirretään takaisin ByDesigniin.
- Kuitatut määrät, hylkymäärät ja valmistuneet tehtävät voidaan kirjata takaisin tuotantoerille.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner-tiimi määrittää integraation ByDesign-ympäristöösi REST API -rajapinnan kautta käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa itse SkyPlannerin dokumentoidun REST API -rajapinnan varaan (rajapintadokumentaatio).
SAP ByDesignin integraatiorajapinnat
ByDesignin julkaisemat A2X SOAP -verkkopalvelut on lueteltu versiokohtaisesti verkkopalvelujen API-luettelossa. Tuotannonsuunnittelun integraatiossa käytetään seuraavia palveluja:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER palauttaa pyydetyt, aikaisimmat ja myöhäisimmät aloitus- ja lopetusajat, resurssit suunniteltuine ja toteutuneine kestoineen, prioriteetin sekä toteutuksen ja suunnittelun tilan. MAINTAIN_BUNDLE_V2 päivittää EarliestStartPeriod- tai LatestEndPeriod-kentän sekä työvaiheen MainResourceID-kentän (SAP:n ohje).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle luo tai päivittää tuotantotehtäviä. Tietoihin kuuluvat raportointipistekohtaiset kuitatut määrät, hylkymäärät ja kuittauksen valmistumismerkintä, tehtävän päättäminen suorittavan työntekijän ja suoritusajan tietoineen sekä resurssien käyttö (SAP:n ohje).
- Kyselypalvelut. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (myös resurssikohtaisesti), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks ja Determine Availability of Products.
- OData. Mukautetut OData-palvelut liiketoimintaobjekteille sekä OData tietolähteille ja analyysiraporteille. SAP:n mukaan “companies are fully empowered to decide which business objects” (yritykset voivat täysin itse päättää, mitkä liiketoimintaobjektit) avataan rajapinnan kautta (SAP:n integraatioskenaariot).
Käytä tietojen lukemiseen Query-palveluja tai ODataa ja kaikkeen kirjoittamiseen kahta Manage-palvelua.
Todennus ja lisensointi
Luo ByDesignissa SkyPlannerille viestintäjärjestelmä ja käyttämillesi palveluille viestintäjärjestely. Jokaisella järjestelyllä on oma tekninen käyttäjänsä. SAP:n tietoturvaopas kuvaa sovellusintegraation todennuksen seuraavasti: “user ID plus password, and the X.509 client certificate” (käyttäjätunnus ja salasana sekä asiakasvarmenne) (tietoturvaopas). ODataa varten voidaan määrittää OAuth 2.0. Kunkin palvelun WSDL ladataan viestintäjärjestelystä tai Service Explorerista.
SkyPlannerin puolella jokainen kutsu sisältää API-tunnisteen Authorization-Token-otsakkeessa. Luo tunniste SkyPlannerissa kohdassa Settings > API. Pelkkä API-tunniste riittää toteutuksen aloittamiseen.
Tapahtumat ja määräaikaiskyselyt
SkyPlanner lähettää webhook-ilmoituksen jokaisesta aikataulumuutoksesta, joten tiedot kirjoitetaan takaisin ByDesigniin suunnitelman muuttuessa.
Hae ByDesignin muutokset kyselemällä Query-palveluja säännöllisesti. Lue vapautetut tuotantotilaukset ja tuotantoerät muutaman minuutin välein sekä materiaalit, varastotiedot ja ostotilaukset harvemmin. Kyselytulokset sivutetaan QueryHitsMaximumNumberValue- ja LastReturnedObjectID-kenttien avulla. SAP kertoo oletussivukoon verkkopalveluja käsittelevällä sivullaan.
Tietojen vastaavuudet
| ByDesign-objekti (rajapinta) | SkyPlanner-objekti | Suunta | Siirtoväli |
|---|---|---|---|
| Materiaalit (Query Materials) | Tuotteet ja materiaalit | ByDesign → SkyPlanner | Alkusiirto, sen jälkeen säännölliset kyselyt |
| Production Bill of Material (Query Production Bill of Materials) | Tuoterakenne, tuotekohtaiset materiaalit | ByDesign → SkyPlanner | Alkutuonti, sen jälkeen muutosten yhteydessä |
| Production Bill of Operations: työvaiheet sekä Setup-, Produce- ja Tear down -toiminnot (Query Production Bill of Operations) | Työvaiheet kestoineen sekä asetus- ja purkuajat | ByDesign → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
| Production Model (Query Production Model) | Tuotteen toimipaikkakohtainen reititys | ByDesign → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
| Laiteresurssit ja resurssiryhmät (Read Equipment Resources) | Työpisteet, työpisteryhmät, työkalut | ByDesign → SkyPlanner | Alkusiirto, sen jälkeen harvoin |
| Henkilöstöresurssit, työajat (Query Labour Resource) | Henkilöstö ja työvuorot | ByDesign → SkyPlanner | Päivittäin, tai työvuorot ylläpidetään SkyPlannerissa |
| Vapautetut tuotantotilaukset ja työvaiheet (Query Production Orders, READ_PROD_ORDER) | Tilaukset ja työt määräpäivineen ja materiaalitarpeineen | ByDesign → SkyPlanner | Kyselyt muutaman minuutin välein |
| Tuotantoerät ja tehtävät (Query Production Lots) | Työn eteneminen | ByDesign → SkyPlanner | Kyselyt muutaman minuutin välein |
| Yksilöity varasto, tuotteiden saatavuus (Query Identified Stocks, Determine Availability of Products) | Varastosaldot | ByDesign → SkyPlanner | Kyselyt tunneittain tai suunnitteluajon yhteydessä |
| Ostotilaukset (Query Purchase Orders) | Ostotilaukset, saapuva materiaali toimituspäivän mukaan | ByDesign → SkyPlanner | Kyselyt tunneittain tai suunnitteluajon yhteydessä |
| EarliestStartPeriod, työvaiheen MainResourceID (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Suunniteltu aloitus, osoitettu työpiste | SkyPlanner → ByDesign | Aikataulun muuttuessa SkyPlannerin webhook-ilmoituksella |
| Kuitattu määrä, hylkymäärä, tehtävän päättäminen (Manage Production Lots, MaintainBundle) | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → ByDesign | Kuittaus- tai vuorokohtaisesti, jos siirto on valittu käyttöön |
| Ei ByDesignissa | Asetusaikamatriisi, usean työntekijän tarve, vaihtoehtoiset koneet ja työntekijät | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toimintamallit
1. Perustietojen alkusiirto. Lue materiaalit, Production Models, Bills of Material ja Bills of Operations sekä laite- ja henkilöstöresurssit. Määritä resurssien vastaavuudet harkiten: neljän koneen resurssiryhmästä tulee yksi työpisteryhmä tai neljä työpistettä. Työkaluiksi määritetyt laiteresurssit tuodaan SkyPlanneriin työkaluina, joiden rajallinen saatavuus huomioidaan suunnittelussa.
2. Tuotantotilausten synkronointi. Lue vapautetut tuotantotilaukset työvaiheineen ja materiaaleineen sekä avoimet ostotilaukset. SkyPlanner käsittelee tilatun materiaalin saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered. Tuotantoehdotukset pysyvät ByDesignin Supply Planning -moduulissa, kunnes niistä tulee tuotantotilauksia.
3. Aikataulun kirjoittaminen takaisin. Kun suunnittelumoottori sijoittaa tai siirtää tilauksen aikataulussa, SkyPlannerin webhook-ilmoitus käynnistää Manage Production Orders -palvelun MAINTAIN_BUNDLE_V2-toiminnon. Se asettaa EarliestStartPeriod-kentän sekä SkyPlannerin valitseman työvaiheen MainResourceID-kentän.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations- tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Päätät itse, siirretäänkö toteumat takaisin. Jos siirretään, Manage Production Lots -palvelun MaintainBundle kirjaa kuitatun määrän, hylkymäärän ja valmistuneen tehtävän suorittavan työntekijän tietoineen. Muussa tapauksessa kuittaukset kirjataan ByDesigniin kuten ennenkin.
5. Tietojen omistajuus ja ristiriitatilanteiden säännöt. Kirjaa ne ennen tuotantokäytön aloitusta:
| Tiedot | Omistaja |
|---|---|
| Materiaalit, Production Models, määrät, tilausten ja erien tilat | ByDesign |
| Työvaihejärjestys, aloitus- ja lopetusajat, resurssien osoittaminen | SkyPlanner |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja vapaapäivät | Yksi määrittelyssä valittu järjestelmä |
| Kuittaukset, varastotapahtumat, kustannuslaskenta | ByDesign: tiedot kirjataan siellä tai siirretään SkyPlannerin aikakirjauksista |
Valitse yksi järjestelmä vastaamaan tilausten päivämäärien kirjoittamisesta. Älä suorita Load Leveling -toimintoa resursseille, joiden tuotannonsuunnittelusta SkyPlanner vastaa. Varmista myös, ettei suunnitteluajo siirrä SkyPlannerin hallinnassa olevia vapautettuja tilauksia.
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti viikkojen kuluessa käyttöönoton aloittamisesta. Varmista sitä ennen aikataulun toimivuus 30 päivän maksuttomassa kokeilussa. Käytä ByDesignista CSV- tai Excel-muodossa vietyjä resursseja, Bills of Operations -tietoja ja avoimia tuotantotilauksia.
- Tietojen kohdistus. Lyö lukkoon vastaavuustaulukko, tietojen omistajuussäännöt, synkronointivälit ja se, siirretäänkö kuittaukset takaisin.
- ByDesign-yhteys. Luo viestintäjärjestelmä ja viestintäjärjestelyt sekä lataa WSDL-tiedostot. Testaa ensin ByDesignin testiympäristössä.
- Alkusiirto. Materiaalit, Production Models, Bills of Material ja Bills of Operations, resurssit ja työajat.
- Tuotanto- ja ostotilausten synkronointi. Säännölliset kyselyt, joissa käytetään sivutusta, suodattimia ja uudelleenyrityksiä.
- Rajoitteiden määrittäminen SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai työntekijät.
- Aikataulun kirjoittaminen takaisin. SkyPlannerin webhookeista käynnistyvät MAINTAIN_BUNDLE_V2-kutsut sekä tuotantoerien kuittausten siirto, jos se on valittu käyttöön.
- Rinnakkaistestaus. Käytä SkyPlanneria nykyisen suunnitelman rinnalla, vertaa päivämääriä ja korjaa perustiedot.
- Tuotantokäyttö. Ota tietojen kirjoittaminen takaisin käyttöön, kun tiedot täsmäävät.
Mitä SAP ByDesign -integraatiossa on huomioitava
- Yksi päivämäärä kutsua kohti. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (EarliestStartPeriod- ja LatestEndPeriod-kenttiä ei voi päivittää samalla kertaa.) Käytä aloituspäivää takaisin kirjoitettavana päivämääränä.
- Ei lukituksia. A2X-palvelut ovat tilattomia, joten SAPin mukaan transaktio- tai loogisia lukituksia ei voi pakottaa käyttöön. Lue tilaus uudelleen ennen jokaista kirjoitusta ja käsittele ristiriidat.
- Valmis tarkoittaa valmista. “Confirmation Finished Indicator cannot be unchecked once it is set.” (Confirmation Finished Indicator -valintaa ei voi poistaa, kun se on kerran asetettu.) Lähetä valmistumistieto vasta, kun työntekijä sulkee tehtävän.
- Pää- ja lisäresurssit. ByDesign huomioi tuotannonsuunnittelussa pääresurssit. Mallinna lisäresursseihin kuuluvat työntekijät ja työkalut SkyPlannerissa resursseiksi, joiden kapasiteetti on rajallinen, jotta suunnitelmassa tarkistetaan myös niiden saatavuus.
- Asetus ja purku. Bills of Operations sisältää asetuksen ja purun aktiviteetteina. Siirrä työjärjestyksestä riippuvat tuotevaihtoajat asetusaikamatriisiin.
Kuka määrittää SAP ByDesign -integraation ja vastaa sen tuesta
- SkyPlanner-tiimi määrittää integraation käyttöönoton yhteydessä ja tukee sitä tuotantokäytön alettua. Työ kattaa sovitut verkkopalvelut ja OData-kyselyt. Jokainen yritys käyttää ByDesignia omalla tavallaan, ja tämä tuntemus hyödynnetään integraation toteutuksessa.
- SAP ByDesign -kumppanisi voi osallistua. Kumppani tuntee ympäristösi, määrittelysi ja laajennuksesi ja voi määrittää tiedonsiirtojärjestelyt yhdessä SkyPlanner-tiimin kanssa.
- Omat kehittäjäsi voivat jatkokehittää integraatiota SkyPlannerin REST API -rajapinnalla käyttämällä API-tokenia
Authorization-Token-otsakkeessa. SkyPlanner-tiimi auttaa tarvittaessa. Ohjeet löytyvät SkyPlannerin integraatiodokumentaatiosta.
SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja se sisältää 5 työpistettä. Laskutus on kuukausittainen. Integraatiosta saat etukäteen prosessisi ja tarpeidesi mukaisen tarjouksen yhdessä tilaustarjouksen kanssa. Katso hinnasto, SAP ByDesignin hienokuormitus, SAP Business ByDesign -sivu ja ERP-integraatioiden koontisivu. Muille SAP-järjestelmille on omat oppaansa: SAP Business One ja SAP S/4HANA.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kytkinlaitteet
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono siirtyy tuotantolinjalle sekunneissa.
+90 %tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkkeiden valmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikkien työpisteiden optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
100 %toimitusvarmuus vuodesta 2021
”SkyPlanner antaa meille näkyvyyden kapasiteettiin ja tekee suunnittelusta ennakoitavaa.”
Dan Berglund, COO/CFO
Opes Corporation · Kemikaalien ja elintarvikkeiden valmistus
Toimitusvarmuus on ollut 100 % koko SkyPlannerin käytön ajan, vuodesta 2021 lähtien.
Vähemmänmateriaalipuutteista johtuvia seisokkeja
”SkyPlannerin arvo meille on siinä, että se toimii päivittäisessä käytössä, erityisesti toimituspäivien määrittämisessä.”
Tommi Männistö, tuotannonsuunnittelupäällikkö
Eskomatic · Sopimuskoneistus
Automaattinen kuormitussuunnittelu tarkentaa toimituspäiviä, ja materiaalipuutteista johtuvat tuotantoseisokit ovat vähentyneet huomattavasti.
Usein kysytyt kysymykset
Mitä SAP ByDesignin rajapintoja SkyPlanner käyttää?
SAPin julkaisemia A2X-verkkopalveluja. Lukemiseen käytetään Query-palveluja, kuten Query Production Orders ja Query Purchase Orders, tai mukautettua OData-rajapintaa. Kirjoittamiseen käytetään Manage Production Orders – ja Manage Production Lots -palveluja.
Mitä SkyPlanner kirjoittaa takaisin ByDesigniin?
Kunkin tuotantotilauksen EarliestStartPeriod-kentän ja työvaiheen MainResourceID-kentän. Halutessasi myös vahvistetut määrät, hylkymäärät ja valmistuneet tehtävät kirjataan tuotantoerälle.
Lähettääkö ByDesign tapahtumia SkyPlanneriin?
SkyPlanner hakee tilaukset ja erät ByDesignin Query-palveluista muutaman minuutin välein. SkyPlanner itse lähettää jokaisesta aikataulumuutoksesta webhookin, joka käynnistää takaisin kirjoittamisen.
Miten SkyPlanner tunnistautuu ByDesigniin?
SAPin tietoturvaoppaan mukaisesti tiedonsiirtojärjestelmän ja tiedonsiirtojärjestelyn kautta teknisellä käyttäjätunnuksella. SkyPlannerin oma API käyttää API-tokenia Authorization-Token-otsakkeessa.
Siirtyvätkö tuotantoehdotukset SkyPlanneriin?
SkyPlanner suunnittelee vapautettujen tuotantotilausten aikataulut. Ehdotukset pysyvät ByDesign Supply Planning -moduulissa, kunnes niistä tulee tuotantotilauksia.
Kuka toteuttaa integraation?
SkyPlanner-tiimi määrittää integraation käyttöönoton yhteydessä ja tukee sitä tuotantokäytön alettua. Myös SAP ByDesign -kumppanisi tai omat kehittäjäsi voivat kehittää integraatiota SkyPlannerin REST API -rajapinnalla käyttäen API-tokenia.
