Integrácie / ERP / QAD Adaptive ERP
Sprievodca integráciou QAD Adaptive ERP na rozvrhovanie výroby so SkyPlanner APS
Tento sprievodca integráciou QAD Adaptive ERP ukazuje partnerom a IT tímom, ako prepojiť QAD Adaptive ERP vrátane starších inštalácií QAD Enterprise Edition a MFG/PRO so SkyPlanner APS. SkyPlanner sa s QAD Adaptive ERP integruje obojsmerne prostredníctvom vlastných rozhraní QAD:
- Do SkyPlanner sa prenášajú výrobné príkazy a ich operácie, položky, štruktúry výrobkov, technologické postupy, pracoviská, výrobné kalendáre, zásoby a nákupné objednávky.
- Naplánované dátumy uvoľnenia a dokončenia sa zapisujú späť do Work Order Maintenance (16.1).
- Časové záznamy operátorov sa zapisujú späť cez Labor Feedback by Work Order (16.20.1) a dokončené množstvá cez Work Order Receipt (16.11).
- Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas zavádzania nakonfiguruje integráciu podľa vášho nastavenia QAD a po spustení ostrej prevádzky poskytuje podporu. Tento sprievodca je určený partnerom a vývojárom, ktorí sa chcú zapojiť alebo sami vytvoriť riešenie na základe zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API).
Integračné rozhrania QAD
QAD ponúka externému rozvrhovaciemu systému tri možnosti prepojenia:
- QAD QXtend Inbound (QXI). QAD ho opisuje ako „a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.“ (Rámec XML založený na webových službách a kompatibilný so SOAP, ktorý poskytuje úplný prístup k podnikovým funkciám QAD Enterprise Applications nezávisle od platformy.) Každá požiadavka má podobu dokumentu QDoc, ktorý spustí program QAD s rovnakou validáciou ako na jeho obrazovke. Na každú požiadavku sa vracia odpoveď vo forme dokumentu QDoc. Medzi vydané dokumenty QDoc patria
maintainItemMaster,maintainRoutingamaintainPurchaseOrder. Pre programy bez vydaného dokumentu QDoc slúži nástroj QGen od QAD, ktorý mapuje program z ponuky: „QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.“ (QGen sa používa na mapovanie vlastných programov alebo programov QAD Enterprise Applications, pre ktoré neboli vydané schémy QDoc a súbory udalostí.) Túto možnosť využíva aj samotný QAD: „QAD Production Scheduler uses QAD QXtend to update work orders.“ (QAD Production Scheduler používa QAD QXtend na aktualizáciu výrobných príkazov.) (Príručka QXtend) - QAD QXtend Outbound (QXO). QXO „exports user-configurable business objects as XML QDocs out of QAD products.“ (Exportuje používateľsky konfigurovateľné podnikové objekty z produktov QAD ako dokumenty XML QDoc.) Medzi štandardné podnikové objekty patria Item, Product Structure, Routing, Work Center, Department, Inventory Transaction a Inventory Status.
- REST API pre podnikové dokumenty. Od verzie Adaptive ERP 2022.1 platí: „Query REST APIs are now available for business documents,“ (Pre podnikové dokumenty sú teraz k dispozícii dopytovacie rozhrania REST API.) Podporujú filtrovanie, triedenie, stránkovanie a načítanie časti údajov. Dokumentáciu nájdete v nástroji Swagger vo svojej inštancii (poznámky k vydaniu).
Zápis údajov zabezpečuje QXtend. Na čítanie slúžia QXO a dopytovacie rozhrania REST API.
Autentifikácia a licencie
- QXtend Inbound. Ak je na prijímači zapnuté nastavenie Require Authentication, každý dokument QDoc obsahuje Session ID alebo používateľské meno a heslo QAD. Pred spustením programu QXI skontroluje prístupové práva používateľa k ponuke.
- Integračný používateľ. Vytvorte samostatného používateľa QAD s prístupom len k tým programom v ponuke, ktoré integrácia volá: Work Order Maintenance, Labor Feedback by Work Order, Work Order Receipt a programy na správu kmeňových dát.
- Licencia QXtend. QXtend sa licencuje podľa agentov a prijímačov. Príručka QAD uvádza, že komunikácia webových služieb s externou aplikáciou v oboch smeroch nie je bezplatná. Preto si licenciu QXtend overte ešte pred začiatkom projektu.
Na strane SkyPlanner sa REST API autentifikuje tokenom API v hlavičke Authorization-Token (SkyPlanner Settings > API). Dokumentácia je dostupná vo formáte Swagger/OpenAPI. Integračný návod vás prevedie prvými volaniami.
Udalosti a zmeny údajov
QXtend Outbound je mechanizmus QAD na spracovanie zmien údajov. „A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.“ (V sledovaných údajoch QAD Enterprise Applications nastane zmena. Oznámenia o zmenách sa zapíšu do databázy qxevents.) QXO potom vytvorí dokumenty QDoc a doručí ich „to a directory location where the subscriber polls for and picks up new QDocs,“ (do adresára, v ktorom odberateľ pravidelne vyhľadáva a preberá nové dokumenty QDoc) alebo webovej službe, ktorá prijíma požiadavky na určitej URL.
SkyPlanner odoberá údaje publikované cez QXO ako webová služba. Údaje, ktoré QXO nepokrýva, pravidelne načítava cez dopytovacie rozhrania REST API. Work Order nepatrí medzi štandardné podnikové objekty QXO. Integrácia preto buď pridá podnikový objekt QXO nad tabuľkami výrobných príkazov (wo_mstr, wr_route), alebo načítava výrobné príkazy cez dopytovacie rozhrania REST API každých niekoľko minút.
SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu, takže spätný zápis je riadený udalosťami.
Mapovanie dát
| Objekt QAD (program, rozhranie) | Objekt v SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
| Položky (Item Master Maintenance 1.4.1; QXO Item) | Produkty a materiály | QAD → SkyPlanner | Úvodné načítanie, potom pri zmene cez QXO |
| Štruktúry výrobkov (13.5; QXO Product Structure) | Štruktúra produktu, čiastkové produkty, materiály pre jednotlivé produkty | QAD → SkyPlanner | Úvodné načítanie, potom pri zmene cez QXO |
| Technologické postupy (14.13.1; QXO Routing): čakanie pred operáciou, príprava, spracovanie, čakanie po operácii, presun | Operácie s časmi trvania, prípravy a ukončenia | QAD → SkyPlanner | Úvodné načítanie, potom pri zmene cez QXO |
| Pracoviská (14.5) a oddelenia (14.1; QXO Work Center, Department) | Pracoviská, skupiny pracovísk, efektivita | QAD → SkyPlanner | Úvodné načítanie, potom len zriedka |
| Kalendáre výroby a pracovísk | Zmeny a nepracovné dni | QAD → SkyPlanner | Denne alebo správa zmien v SkyPlanner |
| Výrobné príkazy (16.1) s technologickým postupom príkazu (16.13.13) a komponentmi | Zákazky a operácie s termínmi dokončenia a požiadavkami na materiál | QAD → SkyPlanner | Vlastný objekt QXO alebo načítavanie cez REST každých niekoľko minút |
| Zásoby (QXO Inventory Status, Inventory Transaction) | Stavy zásob | QAD → SkyPlanner | Pri zmene alebo každú hodinu |
| Nákupné objednávky s termínmi dodania | Nákupné objednávky, očakávaný materiál podľa dátumu dodania | QAD → SkyPlanner | Načítavanie každú hodinu alebo pri spustení rozvrhovania |
| Dátumy uvoľnenia a dokončenia výrobných príkazov (Work Order Maintenance 16.1, QXtend Inbound QDoc) | Plánovaný začiatok a koniec každej zákazky | SkyPlanner → QAD | Pri zmene rozvrhu cez webhook SkyPlanner |
| Labor Feedback by Work Order (16.20.1): čas prípravy a spracovania pre každú operáciu | Časové záznamy a potvrdenia obsluhy | SkyPlanner → QAD | Pri každom potvrdení alebo za každú zmenu, ak si to zvolíte |
| Work Order Receipt (16.11) | Dokončené množstvá | SkyPlanner → QAD | Pri každom potvrdení, ak si to zvolíte |
| Nie je v QAD | Matica časov prestavenia, nástroje ako zdroje s obmedzenou kapacitou, alternatívne stroje a pracovníci | Spravuje sa v SkyPlanner | Nastavenie počas zavádzania |
Integračné postupy
1. Úvodné načítanie kmeňových dát. Načítajte položky, štruktúry výrobkov, technologické postupy, pracoviská a kalendáre cez QXO alebo dopytovacie rozhrania REST API. Mapovanie pracovísk si premyslite: z pracoviska so štyrmi strojmi vznikne jedna skupina pracovísk alebo štyri pracoviská. Na pracoviská možno previesť aj linky opakovanej výroby z Production Line Maintenance.
2. Synchronizácia výrobných príkazov. Načítajte pevne naplánované a uvoľnené výrobné príkazy s ich technologickými postupmi a komponentmi, ako aj otvorené nákupné objednávky. SkyPlanner považuje objednaný materiál za dostupný k dátumu dodania nákupnej objednávky a aktualizuje zásoby, keď sa objednávka označí stavom Delivered.
Rozvrhujte výrobné príkazy, nie plánované objednávky MRP. Plánované objednávky sa musia najprv v QAD zmeniť na pevne naplánované alebo uvoľnené výrobné príkazy.
3. Spätný zápis rozvrhu. Keď plánovací mechanizmus zaradí alebo presunie zákazku, webhook SkyPlanner vyvolá QXtend Inbound QDoc pre Work Order Maintenance (16.1). Dátum uvoľnenia nastaví podľa prvej naplánovanej operácie a dátum dokončenia podľa poslednej. QXtend spustí program s vlastnou validáciou QAD a vráti odpoveď vo forme dokumentu QDoc, ktorú integrácia skontroluje.
Poradie operácií na každom stroji zostáva v SkyPlanner a operátori ho dostávajú cez Mobile Confirmations. Integrácia sa tak vyhne obmedzeniam QAD, ktoré pri uvoľnených príkazoch blokujú zmeny technologického postupu.
4. Potvrdzovanie práce vo výrobe. Operátori zaznamenávajú prácu cez SkyPlanner Mobile Confirmations alebo Production Timer. Časové záznamy udržiavajú rozvrh aktuálny. Vy rozhodnete, či sa skutočné časy majú zapisovať späť do QAD. Ak áno, čas prípravy a spracovania sa prenáša pre každú operáciu do Labor Feedback by Work Order a dokončené množstvá do Work Order Receipt. Ak nie, práca sa eviduje v QAD ako doteraz.
5. Pravidlá vlastníctva údajov a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Údaje | Vlastník |
|---|---|
| Položky, štruktúry výrobkov, technologické postupy, množstvá, stav výrobného príkazu | QAD |
| Poradie operácií, časy začiatku a konca, priradenie strojov | SkyPlanner |
| Dátumy uvoľnenia a dokončenia výrobných príkazov | SkyPlanner zapisuje, QAD ukladá |
| Matica časov prestavenia, požiadavky na nástroje a operátorov, alternatívne zdroje | SkyPlanner |
| Zmeny a nepracovné dni | Jeden systém vybraný pri definovaní rozsahu |
| Práca, výdaje komponentov a príjmy | QAD; údaje sa zadávajú priamo v ňom alebo prenášajú z časových záznamov SkyPlanner |
Určte jeden systém, ktorý bude zapisovať dátumy výrobných príkazov. SkyPlanner nepotrebuje rozvrhovací modul QAD. Pri zákazkách, ktoré rozvrhuje, preto preberá zápis dátumov namiesto nástrojov na rozvrhovanie alebo iných rozvrhovacích systémov.
Typický priebeh projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Ešte predtým si počas 30-dňovej bezplatnej skúšobnej verzie overte rozvrh s pracoviskami, technologickými postupmi a otvorenými výrobnými príkazmi exportovanými z QAD vo formáte CSV alebo Excel.
- Mapovanie. Dohodnite mapovaciu tabuľku, pravidlá vlastníctva údajov, zahrnuté prevádzky a domény, frekvenciu synchronizácie a to, či sa údaje o práci budú zapisovať späť.
- Prístup do QAD. Vytvorte integračného používateľa, overte licencie QXtend a nastavte prijímač QXtend a odberateľa QXO. Najprv všetko otestujte v testovacej doméne.
- Nastavenie QDoc. Tam, kde existujú vydané dokumenty QDoc, ich použite. Podľa potreby vygenerujte pomocou QGen dokumenty QDoc pre Work Order Maintenance, Labor Feedback by Work Order a Work Order Receipt.
- Úvodné načítanie. Položky, štruktúry výrobkov, technologické postupy, pracoviská a kalendáre.
- Synchronizácia výrobných príkazov a nákupných objednávok. Udalosti QXO alebo pravidelné načítavanie cez REST s filtrovaním, stránkovaním a opakovaním neúspešných požiadaviek.
- Nastavenie obmedzení v SkyPlanner. Matica časov prestavenia, nástroje, počty operátorov na operáciu a alternatívne stroje alebo pracovníci.
- Spätný zápis rozvrhu a súbežné testovanie. Zapisujte dátumy na základe webhookov SkyPlanner, testujte súbežne so súčasným plánom, porovnávajte dátumy a opravujte kmeňové dáta.
- Spustenie ostrej prevádzky. Keď sa údaje zhodujú, zapnite spätný zápis.
Na čo myslieť pri integrácii s QAD Adaptive ERP
- Opätovné spustenie CRP. CRP preplánuje všetky otvorené operácie vybraných výrobných príkazov. QAD zachová ručne nastavené termíny len vtedy, keď „you also adjusted the work order release and due date to match,“ (zodpovedajúcim spôsobom upravíte aj dátum uvoľnenia a termín dokončenia výrobného príkazu), čo sú presne údaje, ktoré SkyPlanner zapisuje. Spustite CRP po spätnom zápise alebo z neho vylúčte príkazy, ktoré rozvrhuje SkyPlanner.
- Uvoľnené technologické postupy sa už nedajú meniť. „Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.“ (Keď je výrobný príkaz v stave Exploded, Allocated alebo Released, technologický postup už nemožno meniť.) Načítajte technologický postup pri uvoľnení príkazu a postupy meňte len pri plánovaných alebo pevne plánovaných príkazoch.
- Časové jednotky v technologickom postupe. Prípravný a výrobný čas sa započítavajú do zaťaženia, zatiaľ čo „queue, wait, and move times are excluded from load calculations.“ (časy vo fronte, čakania a presunu sú z výpočtov zaťaženia vylúčené). V SkyPlanner ich modelujte ako kroky, ktoré zaberajú iba čas, a overte, či sa výrobný čas vzťahuje na jednotku alebo na celý príkaz.
- Priepustnosť QXtend. QAD upozorňuje: „UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.“ (Výkon adaptéra UI API môže byť pri spracovaní veľkých objemov dát alebo transakcií v reálnom čase neprijateľný.) Posielajte v dávkach iba zmenené príkazy a tam, kde sú k dispozícii natívne QDocs, používajte ich.
- Domény a závody. Inštalácie QAD s viacerými doménami vedú pracoviská a výrobné príkazy podľa domény a závodu. Každý závod zahrnutý do rozsahu integrácie namapujte na vlastnú skupinu pracovísk.
- Kombinácia opakovanej a diskrétnej výroby. Linky v Advanced Repetitive používajú rozvrhy opakovanej výroby, nie výrobné príkazy. Pri definovaní rozsahu určte, ktoré linky bude SkyPlanner rozvrhovať.
Kto nastavuje integráciu s QAD a poskytuje podporu
- Tím SkyPlanner nastaví integráciu počas zavádzania a po spustení ostrej prevádzky poskytuje podporu pre dohodnuté QDocs, odbery QXO a dopyty REST. Každý závod používa QAD inak a práve pri integrácii sa tieto znalosti uplatnia.
- Zapojiť sa môže aj váš partner pre QAD. Pozná vaše domény, úpravy systému aj licenčné podmienky a spolu s tímom SkyPlanner môže nastaviť QXtend, QGen QDocs a integračného používateľa.
- Vaši vlastní vývojári môžu integráciu ďalej rozvíjať cez REST API systému SkyPlanner s použitím API tokenu. Na začiatok stačí API token a tím SkyPlanner v prípade potreby pomôže. Dokumentáciu nájdete na stránke Dokumentácia integrácie SkyPlanner.
Cena SkyPlanner začína na 199 € mesačne pri mesačnej fakturácii a zahŕňa 5 pracovísk. Cenovú ponuku na integráciu podľa vašich procesov a potrieb dostanete vopred spolu s ponukou na predplatné. Pozrite si cenník, plánovanie výroby s ohľadom na reálne kapacity strojov a pracovníkov pre QAD Adaptive ERP, stránku QAD Adaptive ERP a prehľad integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
2 hušetrené každý týždeň
„Vďaka SkyPlanner sme pri plánovaní výroby prešli od excelových tabuliek k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Plánovanie výroby šetrí každý týždeň 2 hodiny pracovného času a nový zoznam operácií sa na linku dostane v priebehu sekúnd.
+90%efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90%.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť výroby sa zvýšila o 90% a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej ako 30 minút.
1 000-kyautomaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou úplne inak a náš prehľad o kapacitách je na celkom inej úrovni.“
Hannu Ryynänen, generálny riaditeľ
Mamec · Priemyselné miešadlá, čerpadlá a technologicky náročná zákazková výroba
Tisíce výrobných príkazov sa rozvrhujú automaticky a celá organizácia má prehľad o výrobe v reálnom čase.
99,2%spoľahlivosť dodávok
„Vďaka SkyPlanner dokážeme lepšie identifikovať úzke miesta a riadenie výroby je prehľadnejšie.“
Toni Tuori, vedúci výroby
Piristeel · Strešné bezpečnostné prvky a systémy na odvod dažďovej vody
Spoľahlivosť dodávok tento rok dosiahla 99,2% a rozvrhovanie šetrí až štyri hodiny pracovného času denne.
Často kladené otázky
Má QAD Adaptive ERP rozhranie API pre výrobné príkazy?
Áno. QXtend Inbound spúšťa Work Order Maintenance a programy pre dielenskú výrobu cez SOAP a XML QDocs. Ak nie je k dispozícii vydaný QDoc, vygeneruje sa pomocou QGen. REST API pre obchodné dokumenty navyše umožňujú dopytovanie s filtrovaním a stránkovaním.
Podporuje QAD webhooky?
Na prenos zmien dát používa QAD mechanizmus QXtend Outbound: triggery tabuliek zaznamenávajú zmeny a QXO doručuje QDocs na URL webovej služby alebo do pravidelne kontrolovaného adresára. Vlastné webhooky systému SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Ako sa naplánované termíny zapisujú späť do QAD?
Cez QDoc v QXtend Inbound pre Work Order Maintenance (16.1), ktorý nastaví dátum uvoľnenia a termín dokončenia výrobného príkazu podľa rozvrhu v SkyPlanner. QAD overí QDoc podľa rovnakých pravidiel ako pri zadávaní cez obrazovku a vráti odpoveď vo forme QDoc.
Ako sa hlásenia operátorov dostanú do QAD?
Prípravný a výrobný čas sa zapisujú cez Labor Feedback by Work Order (16.20.1) a dokončené množstvá cez Work Order Receipt (16.11), v oboch prípadoch ako QDocs v QXtend Inbound. O spätnom zápise sa rozhoduje pri definovaní rozsahu.
Má partner pre QAD odporučiť QAD Advanced Scheduling alebo SkyPlanner?
SkyPlanner, ak zákazník používa výrobné príkazy v diskrétnej výrobe a chce mať v priebehu niekoľkých týždňov funkčný rozvrh, ktorý rešpektuje reálne kapacity strojov a pracovníkov. QAD opisuje Advanced Scheduling ako rozvrhovanie po jednotlivých linkách pre každý závod a predstavuje ho spolu s DSCP Production Planning a Redzone (QAD). SkyPlanner sa pripája cez QXtend, rozvrhuje každý stroj, operátora, nástroj aj materiál, automaticky preplánováva a ponúka neobmedzený počet používateľov od 199 € mesačne.
Môžeme SkyPlanner otestovať ešte pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk s importom dát z QAD cez CSV alebo Excel, bez potreby platobnej karty. Vyskúšajte ju alebo kontaktujte obchodný tím a dohodnite si rozsah integrácie.
