Integraatiot / ERP / Plex Smart Manufacturing Platform
Plex-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Plex-integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten Plex Smart Manufacturing Platform yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Plexin välinen integraatio toimii molempiin suuntiin:
- Työt, nimikkeet, reititykset, työpisteet, varastotiedot ja ostotilaukset siirtyvät SkyPlanneriin.
- Suunnitellut aloitus- ja lopetusajat palautetaan Plexiin työvaihekohtaisesti.
- Työntekijöiden kuittaukset välitetään Plexin tuotantoraportointiin.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner-tiimi määrittää integraation Plex-ympäristösi mukaiseksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on tarkoitettu kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa sen itse SkyPlannerin dokumentoidun REST API -rajapinnan avulla (rajapintakuvaus).
Plex-integraation rajapinnat
Plex on yhteinen, usean asiakkaan pilvialusta, joten kaikilla asiakkailla on käytössä ajantasainen versio. Integraation voi toteuttaa neljällä tavalla:
- Plex Connect REST APIs. Plex julkaisi Plex Connectin vuonna 2015 kuvauksella “a new REST/JSON API.” (uusi REST- ja JSON-pohjainen rajapinta). (lähde) Versioidut kokoelmat kattavat nimikkeet, toimittajat, asiakkaat, ostotilaukset, työpisteet ja työkalut.
- Plex Custom APIs. Plexin tuote-esitteessä todetaan: “The developer portal is also available for creating unique APIs.” (Kehittäjäportaalissa voi myös luoda omia rajapintoja.) (lähde) Kumppanit käyttävät tätä objekteihin, joille ei ole vakiokokoelmaa.
- Plex UX Data Sources. Plex tarjoaa tietolähteensä REST-rajapinnan kautta. Työt, töiden työvaiheet, tuotantokirjaukset ja varastoyksiköt luetaan yleensä tätä kautta.
- Plex Classic Data Sources. Vanha SOAP-yhteys, jota käytetään vain, jos Classic-tietolähteelle ei ole UX-vastinetta.
SkyPlanner käyttää Plex Connectia perustietojen ja ostotietojen käsittelyyn sekä Plex Data Sources -tietolähteitä töiden, työvaiheiden ja tuotantotietojen käsittelyyn.
Käyttöoikeudet ja PCN
Rajapinnan käyttöoikeudet määritetään sovelluskohtaisesti Plex Developer Portal -portaalissa, jossa otetaan käyttöön integraation tarvitsemat rajapintakokoelmat. Jokainen kutsu kohdistuu PCN-tunnukseen (Plant Control Number), joka yksilöi tehtaan tai juridisen yksikön Plexissä. Konsernilla, jolla on kolme tehdasta, on kolme PCN-tunnusta. Integraatiossa kukin PCN yhdistetään joko omaan SkyPlanner-ympäristöönsä tai yhteisen ympäristön työpisteryhmiin.
Data Source -kutsuissa käytetään PCN-kohtaisia verkkopalvelutunnuksia. Luo integraatiolle oma käyttäjätili, jolla on pääsy vain sen tarvitsemiin tietolähteisiin.
SkyPlannerin REST API -rajapinnassa tunnistaudutaan API-tokenilla (SkyPlanner Settings > API), ja rajapinta on dokumentoitu Swagger/OpenAPI-muodossa. Integraation ohje opastaa ensimmäisten kutsujen tekemisessä.
Synkronointimalli
Plexin puolella synkronointi tehdään ajastetusti. SkyPlanner lukee uudet ja muuttuneet työt, työvaiheet ja varastotiedot Plex Connectista ja Data Sources -tietolähteistä tehdaskohtaisesti määritetyin väliajoin. Plex-kumppani voi myös lähettää muutokset Plexistä suoraan SkyPlannerin REST API -rajapintaan Plexin tapahtumien perusteella, esimerkiksi kun työ luodaan.
SkyPlanner lähettää webhook-ilmoituksia tilan tai suunnitelman muuttuessa, joten tietojen palautus on tapahtumapohjaista.
Tietojen vastaavuudet
| Plex-objekti (rajapinta) | SkyPlanner-objekti | Suunta | Tiheys |
|---|---|---|---|
| Part (Plex Connectin parts-kokoelma) | Tuotteet ja materiaalit | Plex → SkyPlanner | Alkulataus, sen jälkeen muutosten synkronointi |
| Bill of Materials (Data Source) | Tuoterakenne, alituotteet ja tuotekohtaiset materiaalit | Plex → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Reititys ja nimikkeen työvaiheet: työpiste ja standardiajat (Data Source) | Työvaiheet sekä niiden asetus- ja suoritusajat | Plex → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Työpiste: kone, solu tai alue (Plex Connectin work centers -kokoelma) | Työpisteet, työpisteryhmät ja tehokkuudet | Plex → SkyPlanner | Alkulataus, sen jälkeen harvoin |
| Työ ja sen työvaiheet: määrä ja määräpäivä (Data Source) | Tilaukset ja työt | Plex → SkyPlanner | Muutaman minuutin välein tai lähetys työn luonnin yhteydessä |
| Varastotiedot ja varastoyksiköt (Data Source) | Varastosaldot | Plex → SkyPlanner | Tunnin välein tai ennen jokaista suunnitteluajoa |
| Ostotilaukset ja odotetut saapumiset (Plex Connectin purchase orders -kokoelma) | Saapuva materiaali toimituspäivänään; varastosaldo päivittyy, kun tilaksi merkitään Delivered | Plex → SkyPlanner | Tunnin välein tai ennen jokaista suunnitteluajoa |
| Työkalut (Plex Connectin tools-kokoelma) | Työkalut yhteisinä resursseina, joiden saatavuus on rajallinen | Plex → SkyPlanner | Alkulataus, sen jälkeen ylläpito SkyPlannerissa |
| Suunniteltu aloitus ja lopetus työvaiheittain ja työpisteittäin (Custom API tai Data Source) | Tuotantosuunnitelma | SkyPlanner → Plex | Suunnitelman muuttuessa SkyPlannerin webhook-ilmoituksen kautta |
| Tuotantokirjaukset: määrät, aloitus, lopetus ja seisokit | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → Plex | Kuittaus- tai vuorokohtaisesti |
| SkyPlannerin rajoitetiedot | Asetusaikamatriisi, työkohtainen työntekijämäärä sekä vaihtoehtoiset työpisteet ja henkilöt | Ylläpito SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toimintamallit
1. Perustietojen alkulataus. Lataa nimikkeet, osaluettelot, reititykset työvaiheineen, työpisteet ja työkalut. Valitse työpisteiden tarkkuustaso harkiten. Plexin työpiste voi olla yksittäinen kone, solu tai alue. SkyPlannerissa työt tulee suunnitella sillä tasolla, jolla on yksi yhteinen työjono.
2. Töiden synkronointi. Lue vapautetut työt työvaiheineen, määrineen ja määräpäivineen sekä varastotiedot ja avoimet ostotilaukset. SkyPlanner käsittelee tilattua materiaalia saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered. Suunnittelussa tarkistetaan sekä varastosaldot että saapuvat ostot.
3. Suunnitelman palautus. SkyPlanner lähettää jokaisen suunnittelumoottorin sijoittaman tai siirtämän työvaiheen suunnitellun aloitusajan, lopetusajan ja työpisteen takaisin Plexiin sovitun Custom API -rajapinnan tai tietolähteen kautta. Työ, sen määrä ja tila säilyvät Plexin hallinnassa.
4. Tuotannon kuittaukset. Työntekijät kirjaavat aloitukset, määrät ja seisokit Mobile Confirmations-, Production Timer- tai Quick Log Mode -toiminnolla, ja suunnitelma päivittyy työn edetessä. Kuittaukset palautetaan Plexiin tuotantokirjauksina. Valitse kullekin työpisteelle yksi kuittauskanava: työntekijät kuittaavat joko SkyPlannerissa tai Plex Control Panelissa, eivät molemmissa.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäytön aloittamista:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, osaluettelot, reititykset, työn määrä ja tila sekä varastotiedot | Plex |
| Työvaiheiden järjestys, aloitus- ja lopetusajat sekä työpisteen valinta | SkyPlanner |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset sekä vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja poissaolot | Yksi järjestelmä, joka valitaan määrittelyssä |
| Tuotantokirjaukset | Plex, kirjaukset siirretään SkyPlannerin kuittauksista |
Työn määrän tai reitityksen muutos Plexissä muodostaa työstä uuden version. SkyPlanner lukee sen uudelleen, ja Autopilot päivittää suunnitelman automaattisesti tuotannon muuttuessa.
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti muutamassa viikossa käyttöönoton aloittamisesta. Sitä ennen voit käyttää omia tietojasi 30 päivän maksuttomassa kokeilussa. Vie avoimet työt, työvaiheet ja työpisteet Plexistä Excel- tai CSV-tiedostoon, tuo ne SkyPlanneriin ja tarkista suunnitelman toimivuus ennen integraatiotyön aloittamista.
Tämän jälkeen projekti etenee seitsemässä vaiheessa:
- Tietojen vastaavuudet. Vahvista vastaavuustaulukko, PCN- ja työpistetasot, tietojen omistajuussäännöt ja synkronointivälit.
- Plexin käyttöoikeudet. Ota Plex Connect -kokoelmat käyttöön Developer Portalissa ja määritä Data Source -käyttäjätili kullekin PCN-tunnukselle.
- Alkulataus. Nimikkeet, osaluettelot, reititykset, työpisteet ja työkalut.
- Töiden ja ostotilausten synkronointi. Työt, työvaiheet, varastotiedot ja avoimet ostotilaukset synkronoidaan ajastetusti.
- Rajoitteiden määrittäminen SkyPlannerissa. Asetusaikamatriisi, työkohtaiset työntekijämäärät sekä vaihtoehtoiset työpisteet ja henkilöt.
- Takaisinkirjoitus ja kuittaukset. Suunnitellut ajat ja tuotantokirjaukset Plexiin.
- Rinnakkaiskäyttö ja tuotantokäyttöön siirtyminen. Käytä SkyPlanneria nykyisen suunnitelman rinnalla, korjaa perustiedot ja ota sitten takaisinkirjoitus käyttöön.
Mitä Plex-integraation suunnittelussa on huomioitava
- Oikean tietolähteen valinta. Plexissä on useita tietolähteitä, joiden kentät ovat osittain päällekkäisiä. Plex-integraation vaikein osuus on valita lähde, joka palauttaa juuri tarkoitetun määrän tai tilan. Sopikaa määrittelyssä jokainen käytettävä lähde nimeltä.
- Työpisteiden tarkkuustaso. Jos työpiste tarkoittaa todellisuudessa neljän koneen aluetta, se on mallinnettava neljänä työpisteenä tai ryhmänä, jolle määritetään tehokkuudet. Muuten suunnitelma ylittää sen kapasiteetin.
- Mittayksiköt. Prosessiteollisuudessa erät käsitellään grammoina tai litroina, mutta seuraavassa työvaiheessa yksikkönä on kappale. Tee yksikkömuunnokset työvaihekohtaisesti tietojen tuonnin yhteydessä.
- Varastoyksiköt ja nimikkeiden kokonaismäärät. Plex seuraa tuotantotilojen varastoa varastoyksiköittäin. Laske yhteen suunnittelussa käytettävissä olevien varastoyksiköiden määrät ja jätä käyttökiellossa tai karanteenissa oleva varasto pois.
- Vakioajat. Vertaa nimikkeiden työvaiheiden asetus- ja ajoaikoja toteutuneisiin tuotantokirjauksiin ennen ensimmäistä suunnitteluajoa.
- Useita PCN-tunnuksia. Pidä tehtaat erillään tietojen kohdistuksessa, jotta yhden tehtaan työt eivät koskaan päädy toisen tehtaan työpisteille.
Kuka määrittää Plex-integraation ja vastaa sen tuesta?
Työhön kuuluvat tietojen kohdistus töihin, reitityksiin, työpisteisiin ja PCN-tunnuksiin sekä SkyPlannerin suunnittelussa käyttämien rajoitteiden määrittäminen: asetusaikamatriisi, työntekijämäärät ja vaihtoehtoiset resurssit.
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäytössä. Vastuu kattaa SkyPlannerin puolen ja sovitut Plex-rajapinnat. Jokainen tehdas käyttää Plexiä omalla tavallaan, ja juuri tässä tarvitaan sen tuntemusta.
- Plex-kumppaninne voi osallistua toteutukseen tai rakentaa integraation. Kumppani tuntee PCN-tunnuksenne, tietolähteenne ja Custom APIs -rajapintanne. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Myös omat kehittäjänne voivat rakentaa integraation saman dokumentoidun REST API -rajapinnan avulla käyttäen API-tokenia. Alkuun pääsee pelkällä API-tokenilla, ja SkyPlanner-tiimi auttaa tarvittaessa. Julkinen dokumentaatio, joka kattaa myös ostotilaukset sekä tuotteiden ja materiaalien API-rajapinnan, löytyy SkyPlannerin dokumentaatiosta.
SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja siihen sisältyy 5 työpistettä. Laskutus on kuukausittainen. Saat integraatiosta prosessiinne ja tarpeisiinne perustuvan tarjouksen etukäteen yhdessä tilaushinnan kanssa, joten tiedät kokonaiskustannukset ennen aloittamista. Vertaa Plexin omaa suunnittelua SkyPlanneriin sivulla Plexin hienokuormitus, tutustu yleiskatsaukseen Plex-sivulla ja muihin järjestelmiin ERP-integraatioiden sivulla.
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 saadaan linjalle sekunneissa.
+90%tuotannon tehokkuuteen
”Tuotannon tehokkuus on kasvanut 90%.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkevalmistus
Tuotannon tehokkuus on kasvanut 90%, ja kaikkien työpisteiden optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
6 kuukauttavapaata kapasiteettia myynnin nähtävissä
”SkyPlanner luo luotettavan perustan kaikelle tuotannonsuunnittelulle.”
Anu Järvinen, tuotantopäällikkö
Fredman Operations · Elintarvikekelpoiset pakkauspaperit
Myynti näkee vapaan kapasiteetin kuusi kuukautta eteenpäin. Suunnitelman muutospyyntöihin, joiden käsittely vei aiemmin tunnin tai enemmän, vastataan nyt sekunneissa.
100%toimitusvarmuus vuodesta 2021
”SkyPlanner antaa meille näkyvyyden kapasiteettiin ja tekee suunnittelusta ennakoitavaa.”
Dan Berglund, COO/CFO
Opes Corporation · Kemikaali- ja elintarvikevalmistus
Toimitusvarmuus on ollut 100% koko SkyPlannerin käytön ajan, vuodesta 2021 lähtien.
Usein kysytyt kysymykset
Onko Plexissä API-rajapinta tuotannonsuunnittelun tiedoille?
Kyllä. Plex Connect tarjoaa REST/JSON-rajapinnat nimikkeille, ostotilauksille, työpisteille ja työkaluille. Plex Data Sources tuo saataville työt, työvaiheet, tuotantokirjaukset ja varastotiedot. Plex Custom APIs kattaa muut tarpeet.
Kuka rakentaa Plex-integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation Plex-ympäristöönne käyttöönoton aikana ja tukee sitä tuotantokäytössä. Myös Plex-kumppaninne tai omat kehittäjänne voivat toteuttaa integraation SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Alkuun pääsee pelkällä API-tokenilla.
Miksi yhdistää SkyPlanner Plexiin sen sijaan, että ottaisi käyttöön Plex Finite Schedulingin tai Finite Schedulerin?
Plex sisällyttää hienokuormituksen MES/MOM-toimintoihinsa (lähde) ja markkinoi Finite Scheduleria kuvauksella “An Adaptive Plex MES Integration” (mukautuva Plex MES -integraatio) (lähde). SkyPlanner yhdistyy jo käyttämäänne Plex-kokonaisuuteen ja on tuotantokäytössä viikkojen kuluessa käyttöönoton aloittamisesta. Autopilot päivittää suunnitelman automaattisesti aina, kun tapahtuu merkittävä muutos. SkyPlanner-tiimi määrittää kaksisuuntaisen integraation ja vastaa sen tuesta, ja Plex-kumppaninne voi vastata integraation Plex-puolesta.
Pitääkö Plexiin asentaa jotain?
Ei. Käyttöoikeudet määritetään Plex Developer Portalissa ja PCN-kohtaisesti. SkyPlanner toimii pilvessä Plexin rinnalla.
Voiko Plex lähettää muutokset reaaliajassa?
Plexin puolella tiedot synkronoidaan ajastetusti, yleensä muutaman minuutin välein. Plex-kumppani voi myös lähettää uusia töitä SkyPlannerin REST API -rajapintaan Plexin tapahtumien perusteella. Toiseen suuntaan SkyPlannerin webhookit lähettävät suunnitelman muutokset heti niiden tapahtuessa.
Voimmeko kokeilla SkyPlanneria ennen integraation rakentamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voit käyttää jopa 20 työpistettä ja tuoda tiedot Plexistä CSV- tai Excel-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
