Integraatiot / ERP / QAD Adaptive ERP
QAD Adaptive ERP -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tässä QAD Adaptive ERP -integraatio-oppaassa kerrotaan kumppaneille ja IT-tiimeille, miten QAD Adaptive ERP yhdistetään SkyPlanner APS:ään. Opas kattaa myös aiemmat QAD Enterprise Edition- ja MFG/PRO-asennukset. SkyPlannerin ja QAD Adaptive ERP:n välinen integraatio toimii molempiin suuntiin QAD:n omien rajapintojen kautta:
- SkyPlanneriin tuodaan työmääräimet työvaiheineen, nimikkeet, tuoterakenteet, reititykset, työpisteet, tuotantokalenterit, varastotiedot ja ostotilaukset.
- Suunnitellut vapautus- ja valmistumispäivät palautetaan Work Order Maintenance (16.1) -ohjelmaan.
- Työntekijöiden aikakirjaukset palautetaan Labor Feedback by Work Order (16.20.1) -ohjelmaan ja valmistuneet määrät Work Order Receipt (16.11) -ohjelmaan.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner-tiimi määrittää integraation QAD-ympäristöösi sopivaksi 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 integraation itse SkyPlannerin dokumentoidun REST API -rajapinnan avulla (rajapintakuvaus).
QAD:n integraatiorajapinnat
QAD tarjoaa ulkoiselle tuotannonsuunnitteluohjelmistolle kolme liitäntätapaa:
- QAD QXtend Inbound (QXI). QAD kuvaa sitä seuraavasti: “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.” (Verkkopalvelupohjainen, SOAP-yhteensopiva XML-kehys, joka mahdollistaa täysin alustariippumattoman pääsyn QAD Enterprise Applications -järjestelmän liiketoimintatoimintoihin.) Jokainen pyyntö on QDoc, joka suorittaa QAD-ohjelman samoilla tarkistuksilla kuin ohjelman käyttöliittymä. Jokaiseen pyyntöön palautetaan vastaus-QDoc. Valmiina julkaistuja QDoc-sanomia ovat esimerkiksi
maintainItemMaster,maintainRoutingjamaintainPurchaseOrder. Jos ohjelmalle ei ole julkaistu QDoc-sanomaa, valikko-ohjelman kuvaus tehdään QAD:n QGen-työkalulla: “QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.” (QGen-työkalulla kuvataan mukautetut ohjelmat tai QAD Enterprise Applications -ohjelmat, joille ei ole julkaistu QDoc-skeemoja ja tapahtumatiedostoja.) QAD käyttää tätä liitäntätapaa itsekin: “QAD Production Scheduler uses QAD QXtend to update work orders.” (QAD Production Scheduler päivittää työmääräimet QAD QXtendin avulla.) (QXtend-opas) - QAD QXtend Outbound (QXO). QXO “exports user-configurable business objects as XML QDocs out of QAD products.” (Vie käyttäjän määritettävissä olevia liiketoimintaobjekteja QAD-tuotteista XML-muotoisina QDoc-sanomina.) Vakio-objekteja ovat Item, Product Structure, Routing, Work Center, Department, Inventory Transaction ja Inventory Status.
- Liiketoiminta-asiakirjojen REST API -rajapinnat. Adaptive ERP 2022.1 -versiosta alkaen liiketoiminta-asiakirjoja voi hakea REST-rajapinnoista: “Query REST APIs are now available for business documents,” (Liiketoiminta-asiakirjoille on nyt saatavilla REST-kyselyrajapinnat.) Rajapinnat tukevat suodatusta, lajittelua, sivutusta ja tietojen osittaista hakua. Dokumentaatio on oman ympäristösi Swaggerissa (versiotiedot).
Tiedot kirjoitetaan QXtendin kautta. Lukemiseen käytetään QXO:ta ja REST-kyselyrajapintoja.
Tunnistautuminen ja lisensointi
- QXtend Inbound. Kun vastaanottajan Require Authentication -asetus on käytössä, jokainen QDoc sisältää Session ID -tunnisteen tai QAD-käyttäjätunnuksen ja salasanan. QXI tarkistaa käyttäjän valikkokohtaiset käyttöoikeudet ennen ohjelman suorittamista.
- Integraatiokäyttäjä. Luo integraatiolle oma QAD-käyttäjä, jolla on pääsy vain integraation kutsumiin valikko-ohjelmiin: Work Order Maintenance, Labor Feedback by Work Order, Work Order Receipt sekä perustietojen ylläpito-ohjelmat.
- QXtend-lisenssi. QXtend lisensoidaan agenttien ja vastaanottajien mukaan. QAD:n oppaan mukaan verkkopalveluliikenne ulkoiseen sovellukseen ja sieltä takaisin on maksullista, joten varmista QXtend-lisenssi ennen projektin aloittamista.
SkyPlannerin REST API -rajapinnassa todennukseen käytetään API-tokenia, joka välitetään Authorization-Token-otsakkeessa (SkyPlanner Settings > API). Rajapinta on dokumentoitu Swagger/OpenAPI-muodossa. Integraation aloitusohje opastaa ensimmäisten kutsujen tekemisessä.
Tapahtumat ja muutostiedot
QXtend Outbound välittää QAD:n tietomuutokset. “A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.” (Kun seurattavat tiedot muuttuvat QAD Enterprise Applications -järjestelmässä, muutosilmoitukset kirjoitetaan qxevents-tietokantaan.) QXO muodostaa tämän jälkeen QDoc-sanomat ja toimittaa ne “to a directory location where the subscriber polls for and picks up new QDocs,” (hakemistoon, josta tilaaja tarkistaa ja noutaa uudet QDoc-sanomat) tai tietyssä URL-osoitteessa kuuntelevaan verkkopalveluun.
SkyPlanner toimii verkkopalveluna, joka tilaa QXO:n julkaisemat tiedot. Tiedot, joita QXO ei kata, haetaan säännöllisesti REST-kyselyrajapinnoista. Work Order ei kuulu QXO:n vakio-objekteihin. Siksi integraatiossa joko lisätään QXO-objekti työmääräintauluille (wo_mstr, wr_route) tai haetaan työmääräimet REST-kyselyrajapinnoista muutaman minuutin välein.
SkyPlanner lähettää webhook-ilmoituksia tilan tai aikataulun muuttuessa, joten tietojen palautus QAD:hen toimii tapahtumapohjaisesti.
Tietojen vastaavuudet
| QAD-objekti (ohjelma, rajapinta) | SkyPlannerin objekti | Suunta | Siirtotiheys |
|---|---|---|---|
| Nimikkeet (Item Master Maintenance 1.4.1; QXO Item) | Tuotteet ja materiaalit | QAD → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä QXO:n kautta |
| Tuoterakenteet (13.5; QXO Product Structure) | Tuoterakenne, alituotteet, tuotekohtaiset materiaalit | QAD → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä QXO:n kautta |
| Reititykset (14.13.1; QXO Routing): jonotus-, asetus-, ajo-, odotus- ja siirtoajat | Työvaiheet kestoineen sekä asetus- ja purkuaikoineen | QAD → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä QXO:n kautta |
| Työpisteet (14.5) ja osastot (14.1; QXO Work Center, Department) | Työpisteet, työpisteryhmät, tehokkuudet | QAD → SkyPlanner | Alkutuonti, sen jälkeen harvoin |
| Tuotanto- ja työpistekalenterit | Työvuorot ja vapaapäivät | QAD → SkyPlanner | Päivittäin, tai työvuorot ylläpidetään SkyPlannerissa |
| Työmääräimet (16.1) reitityksineen (16.13.13) ja komponentteineen | Tilaukset ja työt määräpäivineen ja materiaalitarpeineen | QAD → SkyPlanner | Mukautettu QXO-objekti tai REST-kyselyt muutaman minuutin välein |
| Varastotiedot (QXO Inventory Status, Inventory Transaction) | Varastosaldot | QAD → SkyPlanner | Muutosten yhteydessä tai tunnin välein |
| Ostotilaukset toimituspäivineen | Ostotilaukset, saapuvat materiaalit toimituspäivän mukaan | QAD → SkyPlanner | Kyselyt tunnin välein tai suunnitteluajon yhteydessä |
| Työmääräimen vapautus- ja valmistumispäivät (Work Order Maintenance 16.1, QXtend Inbound QDoc) | Tilauksen suunniteltu aloitus ja lopetus | SkyPlanner → QAD | Aikataulun muuttuessa SkyPlannerin webhook-kutsulla |
| Labor Feedback by Work Order (16.20.1): työvaihekohtaiset asetus- ja ajoajat | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → QAD | Kuittaus- tai työvuorokohtaisesti, jos otetaan käyttöön |
| Work Order Receipt (16.11) | Valmistuneet määrät | SkyPlanner → QAD | Kuittauskohtaisesti, jos otetaan käyttöön |
| Ei QAD:ssa | Asetusaikamatriisi, työkalut rajallisina resursseina, vaihtoehtoiset koneet ja henkilöt | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutustavat
1. Perustietojen alkulataus. Lue nimikkeet, tuoterakenteet, reititykset, työpisteet ja kalenterit QXO:n tai REST-kyselyrajapintojen kautta. Suunnittele työpisteiden vastaavuudet huolella: neljän koneen työpisteestä tulee yksi työpisteryhmä tai neljä työpistettä. Myös Production Line Maintenance -ohjelman toistuvan tuotannon linjat voidaan mallintaa työpisteiksi.
2. Työmääräinten synkronointi. Lue suunnitellut työmääräimet, jotka on vahvistettu, sekä vapautetut työmääräimet reitityksineen ja komponentteineen. Lue myös avoimet ostotilaukset. SkyPlanner käsittelee tilatun materiaalin saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered.
Laadi aikataulu työmääräimille, älä MRP:n suunnitelluille tilauksille. Suunnitellut tilaukset muutetaan ensin QAD:ssa työmääräimiksi, jotka ovat joko suunniteltuja ja vahvistettuja tai vapautettuja.
3. Aikataulun palautus QAD:hen. Kun suunnittelumoottori sijoittaa tilauksen aikatauluun tai siirtää sitä, SkyPlannerin webhook käynnistää QXtend Inbound QDoc -kutsun Work Order Maintenance (16.1) -ohjelmaan. Vapautuspäiväksi asetetaan ensimmäisen suunnitellun työvaiheen päivä ja valmistumispäiväksi viimeisen. QXtend suorittaa ohjelman QAD:n omilla tarkistuksilla ja palauttaa vastaus-QDocin, jonka integraatio tarkistaa.
Kunkin koneen työvaihejärjestys säilyy SkyPlannerissa ja välittyy työntekijöille Mobile Confirmations -toiminnon kautta. Näin integraatio ei törmää QAD:n rajoitukseen, joka lukitsee vapautettujen työmääräinten reititykset.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations- tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Voit valita, palautetaanko toteutuneet ajat QAD:hen. Jos palautetaan, työvaihekohtaiset asetus- ja ajoajat viedään Labor Feedback by Work Order -ohjelmaan ja valmistuneet määrät Work Order Receipt -ohjelmaan. Muussa tapauksessa työtunnit kirjataan QAD:hen kuten ennenkin.
5. Tietojen omistajuus ja ristiriitojen käsittelysäännöt. Kirjaa säännöt ennen tuotantokäytön aloittamista:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, tuoterakenteet, reititykset, määrät, työmääräimen tila | QAD |
| Työvaihejärjestys, aloitus- ja lopetusajat, konevalinnat | SkyPlanner |
| Työmääräimen vapautus- ja valmistumispäivät | SkyPlanner kirjoittaa, QAD tallentaa |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja vapaapäivät | Yksi järjestelmä, joka valitaan määrittelyssä |
| Työtunnit, komponenttien otot ja vastaanotot | QAD; kirjataan suoraan sinne tai siirretään SkyPlannerin aikakirjauksista |
Valitse vain yksi järjestelmä päivittämään työmääräinten päivämäärät. SkyPlanner ei tarvitse QAD:n tuotannonsuunnittelumoduulia, vaan päivittää aikatauluttamiensa tilausten päivämäärät suunnittelutyöpöytien tai muiden suunnitteluohjelmistojen sijaan.
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti viikoissa käyttöönoton aloittamisesta. Varmista jo sitä ennen aikataulun toimivuus 30 päivän maksuttomalla kokeilujaksolla. Käytä siihen QAD:sta CSV- tai Excel-muodossa vietyjä työpisteitä, reitityksiä ja avoimia työmääräimiä.
- Tietovastaavuudet. Vahvista vastaavuustaulukko, omistajuussäännöt, mukaan otettavat toimipaikat ja domainit, synkronointitiheydet sekä se, palautetaanko työtunnit QAD:hen.
- QAD-yhteydet ja käyttöoikeudet. Luo integraatiokäyttäjä, varmista QXtend-lisensointi ja määritä QXtend-vastaanottaja sekä QXO-tilaaja. Testaa ensin testidomainissa.
- QDoc-määritykset. Käytä valmiiksi julkaistuja QDoc-sanomia, kun niitä on saatavilla. Luo tarvittaessa QGenillä QDoc-sanomat Work Order Maintenance-, Labor Feedback by Work Order- ja Work Order Receipt -ohjelmille.
- Alkulataus. Nimikkeet, tuoterakenteet, reititykset, työpisteet ja kalenterit.
- Työmääräinten ja ostotilausten synkronointi. QXO-tapahtumat tai säännölliset REST-kyselyt suodatuksineen, sivutuksineen ja uudelleenyrityksineen.
- Rajoitteiden määrittäminen SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai työntekijät.
- Aikataulun takaisinkirjoitus ja rinnakkaistestaus. Kirjaa päivämäärät SkyPlannerin webhook-ilmoitusten perusteella, testaa nykyisen suunnitelman rinnalla, vertaa päivämääriä ja korjaa perustiedot.
- Tuotantokäyttöön siirtyminen. Ota takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä QAD Adaptive ERP -integraatiossa on huomioitava
- CRP:n uudelleenajot. CRP suunnittelee uudelleen valittujen työmääräinten kaikki avoimet työvaiheet. QAD säilyttää käsin asetetut päivämäärät vain ehdolla ”you also adjusted the work order release and due date to match,” (myös työmääräimen vapautus- ja määräpäivä on muutettu vastaaviksi). Juuri nämä päivämäärät SkyPlanner kirjoittaa. Aja CRP takaisinkirjoituksen jälkeen tai jätä SkyPlannerin suunnittelemat työmääräimet ajon ulkopuolelle.
- Vapautettujen työmääräinten reititykset on lukittu. ”Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.” (Kun työmääräimen tila on Exploded, Allocated tai Released, reititystä ei voi enää muuttaa.) Lue reititys vapautuksen yhteydessä ja muuta reitityksiä vain suunnitelluilla tai vahvistetuilla suunnitelluilla työmääräimillä.
- Reitityksen aikayksiköt. Asetus- ja ajoaika lasketaan kuormitukseen, mutta ”queue, wait, and move times are excluded from load calculations.” (Jonotus-, odotus- ja siirtoaikoja ei lasketa kuormitukseen.) Mallinna jonotus, odotus ja siirto SkyPlannerissa pelkkää aikaa varaavina vaiheina. Tarkista myös, onko ajoaika määritetty yksikköä vai tilausta kohti.
- QXtendin suorituskyky. QAD varoittaa: ”UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.” (UI API -sovittimen suorituskyky ei välttämättä riitä suurten tietomäärien tai reaaliaikaisten tapahtumien käsittelyyn.) Lähetä vain muuttuneet tilaukset erissä ja käytä valmiita QDocs-sanomia, kun niitä on saatavilla.
- Toimialueet ja toimipaikat. Usean toimialueen QAD-asennuksissa työpisteet ja työmääräimet pidetään erillään toimialueittain ja toimipaikoittain. Kohdista jokainen integraatioon kuuluva toimipaikka omaan työpisteryhmäänsä.
- Toistuvan valmistuksen ja erillistuotannon yhdistäminen. Advanced Repetitive -linjat käyttävät toistuvan valmistuksen tuotanto-ohjelmia, eivät työmääräimiä. Päätä määrittelyvaiheessa, minkä linjojen tuotannon SkyPlanner suunnittelee.
Kuka määrittää QAD-integraation ja vastaa sen tuesta
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Työ kattaa sovitut QDocs-sanomat, QXO-tilaukset ja REST-kyselyt. Jokainen tehdas käyttää QADia omalla tavallaan, ja tässä tuo osaaminen pääsee käyttöön.
- QAD-kumppanisi voi osallistua. Kumppani tuntee toimialueesi, räätälöintisi ja lisensointisi ja voi määrittää QXtendin, QGen QDocs -sanomat ja integraatiokäyttäjän yhdessä SkyPlanner-tiimin kanssa.
- Omat kehittäjäsi voivat jatkokehittää integraatiota SkyPlannerin REST API -rajapinnan kautta API-tunnisteella. Alkuun pääsee pelkällä API-tunnisteella, ja SkyPlanner-tiimi auttaa tarvittaessa. Ohjeet löytyvät SkyPlannerin integraatiodokumentaatiosta.
SkyPlanner maksaa alkaen 199 € kuukaudessa kuukausilaskutuksella, ja hintaan sisältyy 5 työpistettä. Saat integraatiosta etukäteen prosessisi ja tarpeidesi mukaisen tarjouksen yhdessä palvelupakettisi kanssa. Tutustu hinnastoon, QAD Adaptive ERP -hienokuormitukseen, QAD Adaptive ERP -sivuun ja ERP-integraatioiden koontisivuun.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästöä viikossa
”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 viikossa, ja uusi työjono saadaan linjalle sekunneissa.
+90%tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkevalmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikkien työpisteiden optimoitu kolmen kuukauden suunnitelma syntyy alle 30 minuutissa.
1 000:iaautomaattisesti suunniteltuja työmääräimiä
”Tuotanto on aivan eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on täysin uudella tasolla.”
Hannu Ryynänen, toimitusjohtaja
Mamec · Teollisuussekoittimet, pumput ja korkean teknologian sopimusvalmistus
Tuhansien työmääräinten suunnittelu hoituu automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
99,2 %toimitusvarmuus
”SkyPlanner on auttanut tunnistamaan pullonkaulat ja selkeyttänyt tuotannonohjausta.”
Toni Tuori, tuotantopäällikkö
Piristeel · Kattoturva- ja sadevesijärjestelmät
Toimitusvarmuus nousi tänä vuonna 99,2 %:iin, ja tuotannonsuunnittelussa säästyy jopa neljä tuntia työaikaa päivässä.
Usein kysytyt kysymykset
Onko QAD Adaptive ERP:ssä API-rajapinta työmääräimille?
Kyllä. QXtend Inbound suorittaa Work Order Maintenance -ohjelmaa ja tuotannon kirjausohjelmia SOAPin ja XML-muotoisten QDocs-sanomien kautta. Jos julkaistua QDoc-sanomaa ei ole, se luodaan QGenillä. Liiketoimintadokumenttien REST API -rajapinnat mahdollistavat lisäksi kyselyt suodatuksineen ja sivutuksineen.
Tukeeko QAD webhookeja?
QADin muutostietojen välitysmekanismi on QXtend Outbound: taulujen triggerit tallentavat muutokset, ja QXO toimittaa QDocs-sanomat verkkopalvelun URL-osoitteeseen tai hakemistoon, jota tarkistetaan säännöllisesti. SkyPlannerin omat webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
Miten suunnitellut päivämäärät kirjoitetaan takaisin QADiin?
Päivämäärät kirjoitetaan Work Order Maintenance (16.1) -ohjelmaan QXtend Inboundin QDoc-sanomalla. Se asettaa työmääräimen vapautus- ja määräpäivän SkyPlannerin aikataulun mukaisiksi. QAD tarkistaa QDoc-sanoman samoilla säännöillä kuin käyttöliittymässä syötetyt tiedot ja palauttaa QDoc-vastaussanoman.
Miten työntekijöiden kuittaukset siirtyvät QADiin?
Asetus- ja ajoajat kirjataan Labor Feedback by Work Order (16.20.1) -ohjelman kautta ja valmistuneet määrät Work Order Receipt (16.11) -ohjelman kautta. Molemmissa käytetään QXtend Inboundin QDocs-sanomia. Takaisinkirjoituksen käytöstä päätetään määrittelyvaiheessa.
Kannattaako QAD-kumppanin ehdottaa QAD Advanced Schedulingia vai SkyPlanneria?
SkyPlanneria, kun asiakas käyttää erillistuotannon työmääräimiä ja haluaa todellisen kapasiteetin huomioivan tuotantosuunnitelman käyttöön viikoissa. QAD kuvaa Advanced Schedulingia tehdaskohtaiseksi, linjoittain laadittavaksi tuotantosuunnitelmaksi ja esittelee sen yhdessä DSCP Production Planningin ja Redzonen kanssa (QAD). SkyPlanner yhdistyy QXtendin kautta, suunnittelee jokaisen koneen, työntekijän, työkalun ja materiaalin käytön ja päivittää suunnitelman automaattisesti. Käyttäjämäärää ei ole rajoitettu, ja hinta on alkaen 199 € kuukaudessa.
Voimmeko kokeilla SkyPlanneria ennen integraation rakentamista?
Kyllä. Ilmainen 30 päivän kokeilu tukee jopa 20 työpistettä, ja tiedot voi tuoda QADista CSV- tai Excel-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.