Průvodce integrací Sage X3 se SkyPlanner APS pro rozvrhování výroby
Tento průvodce ukazuje partnerům Sage a IT týmům, jak propojit Sage X3 se SkyPlanner APS. Vysvětluje, která rozhraní X3 použít, které objekty přenášejí data a kde v projektech vznikají problémy. SkyPlanner se se Sage X3 propojuje obousměrně, a to v cloudu i při místním nasazení X3:
- Do SkyPlanner se přenášejí výrobní příkazy, operace, technologické postupy, pracoviště, kalendáře, zásoby a otevřené nákupní objednávky.
- Naplánované termíny operací a pracoviště se zapisují zpět do výrobních příkazů (GESMFG).
- Časové záznamy operátorů se zapisují do evidence výroby (GESMTK).
- Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Tým SkyPlanner během zavádění nakonfiguruje integraci podle vašeho nastavení X3 a po spuštění ostrého provozu pro ni zajišťuje podporu.
Pokud teprve zvažujete, zda X3 vůbec potřebuje nástroj pro plánování výroby, který respektuje skutečné kapacity strojů a pracovníků, přečtěte si nejprve článek Umožňuje Sage X3 plánování výroby podle dostupných kapacit? Přehled produktu najdete na stránce SkyPlanner APS pro Sage X3, další systémy ERP pak v přehledu integrací s ERP.
Jakou roli má SkyPlanner v prostředí X3
Standardní rozvrhování v Sage X3 (FUNMAUTJ) řadí operace podle údajů z technologických postupů, ale každý výrobní příkaz rozvrhuje samostatně. Příručka podpory Sage UK to říká jasně: „does not delay or stagger work orders based on overall resource load.“ (neodkládá ani časově nerozkládá výrobní příkazy podle celkového vytížení výrobních zdrojů). Plánování výroby se zohledněním dostupných kapacit tvoří samostatnou vrstvu a Sage nabízí dvě možnosti:
- Production Scheduler (kód aktivity POPS), pouze pro místní nasazení.
- Obecné rozhraní Finite scheduler (kód aktivity GFS), které propojuje cloudové nebo místně nasazené X3 se Sage X3 Web Scheduling nebo s rozvrhovacím nástrojem od nezávislého dodavatele softwaru.
SkyPlanner tuto roli plní jako externí cloudový rozvrhovací nástroj využívající standardní API systému X3. Funguje tak stejně v cloudu i při místním nasazení X3. MRP (FUNMRP) nadále vytváří návrhy výrobních příkazů a nákupních objednávek. SkyPlanner řadí potvrzené a plánované výrobní příkazy podle skutečných kapacit.
Možnosti integrace se Sage X3
Způsob integrace závisí na typu nasazení. Cloudové Sage X3 nezpřístupňuje aplikacím třetích stran ani souborový systém aplikace, ani databázi. Integrace proto probíhá přes API nebo hostovanou službu pro přenos souborů. Místní nasazení navíc umožňuje přímý import souborů a využití tabulek pro dočasné uložení přenášených dat v databázi X3.
| Možnost | Popis | Ověřování | Vhodné použití |
|---|---|---|---|
| GraphQL API (Sage X3 Web API) | Sage ji pro API systému X3 označuje jako „technology of choice“ (preferovanou technologii); vyvíjí se bez verzování | JWT (HS256) podepsaný pomocí Secret objektu Connected application, Client ID jako iss, URL jako aud, vyhrazený uživatel Syracuse | Produkty, závody, nákup, zásoby; uzly pro výrobu, pokud je rozhraní zpřístupňuje |
| REST api1 | REST založené na reprezentacích: .../api1/x3/$$prod/<FOLDER>.<ENTITY>?representation=<REP>.$query | Ověřování v Syracuse | Entity, které GraphQL nezpřístupňuje |
| Objektové webové služby SOAP | Objekty publikované ve Web services (GESAWE); pole odpovídají polím na obrazovkách objektu; čtení, ukládání a úpravy | OAuth2 pro fondy připojení Syracuse | Zpětný zápis do objektů Work order (GESMFG) a Production tracking (GESMTK) |
| SOAP Template Services | Šablony pro import a export přes SOAP pomocí AOWSIMPORT a AOWSEXPORT | OAuth2; X3 nepovoluje pro SOAP základní ověřování | Spouštění šablon z middlewaru |
| Šablony pro import a export | Dávkové soubory zpracovávané podle šablon | Souborový systém (místní nasazení) nebo hostovaný přenos souborů (cloud) | Počáteční načtení dat, noční hromadná synchronizace |
| Sync API (Cloud BI) | Pouze v cloudu a pouze pro čtení: přírůstkový export dat a datový proud NDJSON; na vyžádání prostřednictvím vašeho zástupce Sage pro ISV | Token Bearer a X-API-KEY pro každého tenanta | Čtení velkého objemu změn v cloudu |
Při místním nasazení je pro GraphQL nutné přidat "bearer" do pole session.auth v souboru nodelocal.js. V Sage X3 SaaS je ověřování připojených aplikací ve výchozím nastavení zapnuté. V Sage X3 Cloud nemůže připojená aplikace používat uživatele admin: místo něj vytvořte uživatele Syracuse s ověřováním Standard.
Která rozhraní použít pro jednotlivé datové toky
- Produkty, závody, nákup a zásoby: GraphQL, stejně jako v oficiálních příkladech Sage.
- Výrobní příkazy, operace, technologické postupy a pracoviště: Reprezentace REST api1 nebo exportní šablony spouštěné prostřednictvím AOWSEXPORT. Ve verzích, jejichž schéma GraphQL zpřístupňuje výrobní doménu (
xtremX3Manufacturing), integrace čte stejná data přes GraphQL. - Zápis termínů operací a pracovišť zpět do X3: webová služba SOAP objektu Work order (GESMFG), operace modify. Náhradní možnost: importní šablona přes AOWSIMPORT.
- Evidence výroby: webová služba SOAP objektu Production tracking (GESMTK), operace save.
Stejné řešení funguje v cloudovém i místně nasazeném X3, protože žádná jeho část nepotřebuje přímý přístup k souborovému systému ani databázi. Do X3 se nic neinstaluje: integrace využívá připojenou aplikaci, uživatele Syracuse a webové služby publikované v GESAWE.
Události: počítejte s pravidelným dotazováním
Veřejná vývojářská dokumentace Sage pro X3 nepopisuje funkci pro odchozí webhooky ani podnikové události. Nastavení „Callback URL“ přidané ve verzi 2024 R1 slouží pro Mobile Automation a Web Scheduling při volání webových služeb SOAP. Nejde o obecný systém událostí. Změny zjišťujte pravidelným načítáním dat: dotazy GraphQL, v cloudu pomocí kurzoru s časovým razítkem v Sync API nebo pravidelnými exporty přes šablony.
Mapování dat ze Sage X3 do SkyPlanner
| Objekt Sage X3 (tabulka, funkce) | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
| Product, ITMMASTER | Produkt | X3 → SkyPlanner | Na začátku, poté v nastavených intervalech |
| Production BOM (GESBODP) | Víceúrovňová struktura produktu, materiály | X3 → SkyPlanner | Na začátku, poté při změně |
| Routing (GESROU): OPENUM, pracoviště WST, SETTIM, OPETIM, časová jednotka TIMUOMCOD | Kroky procesu s časy seřízení a zpracování | X3 → SkyPlanner | Na začátku, poté při změně |
| Work center (GESMWS, WORKSTATIO): WST, WSTTYP, WSTNBR, EFF, SHR, náhradní pracoviště s prioritou | Pracoviště, efektivita, alternativy | X3 → SkyPlanner | Na začátku, poté jen zřídka |
| Work center group (WCR) | Skupiny pracovišť | X3 → SkyPlanner | Na začátku |
| Weekly structure (TWD), pracovní doby, tabulka změn kapacity, DEFDIH | Směny, přesčasové směny, absence | X3 → SkyPlanner | Na začátku, poté při změně |
| Výrobní příkazy: MFGHEAD, MFGOPE, včetně produktů a materiálů | Zakázka, materiály, kroky procesu | X3 → SkyPlanner | Dotazování každých 5 až 15 min |
| Zásoby podle závodu | Skladové zůstatky | X3 → SkyPlanner | Pravidelné dotazování |
| Nákupní objednávky (POH): otevřené řádky, očekávané datum příjmu | Očekávaný materiál s předpokládaným datem dodání | X3 → SkyPlanner | Dotazování každých 5 až 15 min |
| Záložka Operations v GESMFG: Start OPESTR, End OPEEND, pracoviště | Naplánovaný začátek, konec a vybrané pracoviště | SkyPlanner → X3 | Při změně rozvrhu (webhook) |
| Production tracking (GESMTK): časy operací, množství, evidence materiálu, vykazování výroby | Časové záznamy, množství, spotřeba materiálu | SkyPlanner → X3 | Při každém potvrzení (webhook) |
Potvrzené výrobní příkazy načítejte vždy. Plánované načítejte tehdy, pokud je plánovači chtějí v Ganttově diagramu vidět jako předběžné zatížení. Návrhy zůstávají v MRP, dokud nejsou převedeny na výrobní příkazy.
Postupy integrace
1. Počáteční načtení kmenových dat. Nejprve načtěte pracoviště a kalendáře, poté produkty, kusovníky a technologické postupy. Technologické postupy totiž odkazují na pracoviště.
2. Synchronizace příkazů a objednávek. Pravidelně se dotazujte na MFGHEAD a MFGOPE a načítejte nové i změněné výrobní příkazy. Každý řádek MFGOPE namapujte na krok procesu ve SkyPlanner na pracovišti určeném kódem WST. Ve stejném cyklu synchronizujte otevřené nákupní objednávky. SkyPlanner považuje objednaný materiál za dostupný k datu dodání uvedenému na nákupní objednávce a aktualizuje zásoby, jakmile je objednávka označena stavem Delivered. Kontroly materiálu pak zahrnují zásoby i očekávané dodávky.
3. Zápis rozvrhu zpět do X3. Při změně rozvrhu se spustí webhook SkyPlanner. Integrace zavolá operaci modify objektu Work order (GESMFG), publikovaného jako webová služba SOAP v GESAWE. U každé změněné operace aktualizuje Start (OPESTR), End (OPEEND) a pracoviště. Při dávkových aktualizacích se stejná pole přenášejí přes importní šablonu výrobních příkazů pomocí AOWSIMPORT. Zapisujte pouze termíny a pracoviště, nikdy množství, řádky kusovníku ani technologické postupy.
4. Zpětný přenos vybraného stroje. Pokud jsou pracoviště mapována jedna ku jedné, stroj vybraný výpočetním jádrem z dostupných alternativ se zapíše zpět jako pracoviště operace. X3 tak eviduje stroj, na kterém operace skutečně probíhá. Pokud pracoviště v X3 představuje skupinu strojů, ve frontě práce operátora se zobrazí konkrétní stroj. Do X3 se přenese pracoviště celé skupiny spolu s naplánovanými termíny.
5. Potvrzování práce z výrobního provozu. Operátoři zaznamenávají práci pomocí Mobile Confirmations nebo Production Timer. Integrace zapíše každé potvrzení operací save objektu Production tracking (GESMTK): čas a množství do evidence operací a také spotřebu materiálu, pokud ji tam evidujete. X3 přijímá záznamy pouze pro výrobní příkazy ve stavu Firm. Komponenty musí být dostupné, pokud není u produktu pro daný závod vybrána možnost Release if shortage (MFGSHTCOD).
6. Spolehlivá synchronizace. Pro každý zápis do evidence výroby použijte jako klíč ID časového záznamu SkyPlanner a uložte číslo záznamu, který vznikl v X3. Opakované doručení webhooku tak nikdy nezpůsobí dvojí zápis. Výrobní příkazy uzavřené nebo zrušené v X3 odeberte z rozvrhu při příštím dotazování. Odmítnutá volání zaznamenejte včetně chybové zprávy X3, místo abyste je naslepo opakovali. Když je X3 nedostupné, ukládejte změny do fronty, aby se po obnovení dostupnosti zapsaly ve správném pořadí.
7. Pravidla odpovědnosti za data. X3 určuje, co se vyrábí: produkt, množství, kusovník, technologický postup a závod. SkyPlanner určuje, kdy a kde: pořadí, pracoviště a časy zahájení a dokončení. Dohodněte se, že plánovači přestanou měnit rozvrh v Planning workbench a spouštět FUNMAUTJ pro příkazy spravované ve SkyPlanner. Jinak se jejich změny při příštím zpětném zápisu přepíšou.
Typický průběh projektu
Implementace bývá dokončena během několika týdnů od zahájení zavádění. Projekt integrace se Sage X3 zahrnuje:
- Vyzkoušení na vlastních datech. Pomocí exportních šablon X3 nebo Excelu vyexportujte pracoviště, technologické postupy a aktuální přehled otevřených výrobních příkazů a importujte je jako CSV. Upravujte směny, efektivitu a priority, dokud Ganttův diagram nebude odpovídat skutečnosti.
- Mapování kmenových dat. Namapujte pracoviště GESMWS na pracoviště ve SkyPlanner, operace GESROU na kroky procesu a časové jednotky a týdenní rozvrhy na směny. Přitom opravte operace technologických postupů bez přiřazených pracovišť, dny bez stanovené pracovní doby a nesprávné časové jednotky.
- Počáteční načtení dat. Produkty, výrobní kusovníky, technologické postupy a pracoviště, poté kalendáře.
- Synchronizace zakázek a nákupních objednávek. Připojená aplikace, uživatel Syracuse, dotazy GraphQL nebo exporty pomocí šablon a úloha pro pravidelné načítání výrobních příkazů, skladových zásob a otevřených nákupních objednávek.
- Zpětný zápis rozvrhu. Webová služba SOAP objektu Work order publikovaná v GESAWE, s ošetřením chyb a protokolováním.
- Odvádění výroby z provozu. Záznamy z Mobile Confirmations se zapisují do X3 prostřednictvím webové služby Production tracking (GESMTK).
- Testování souběžně se stávajícím plánem. Před přechodem plánovači porovnají oba plány.
- Spuštění ostrého provozu. U příkazů spravovaných ve SkyPlanner vypněte v X3 ruční přeplánování.
Na co si dát pozor v Sage X3
- Návrhy nejsou výrobní příkazy. Návrhy MRP nemají řádky operací MFGOPE, dokud je nepřevedete na plánované nebo potvrzené výrobní příkazy. Do rozvrhu proto zařazujte převedené příkazy, nikoli návrhy.
- Mezery v kalendářích. Pro pracovní den bez časového rozvrhu se použije výchozí schéma DEFDIH. Prázdný den bez výchozího schématu vede k chybným termínům a vytížení. Před exportem kalendářů přiřaďte časový rozvrh každému pracovnímu dni v každé týdenní struktuře.
- Neaktuální vytížení v časových intervalech. Po změně kapacity nebo kalendáře se stávající vytížení v časových intervalech X3 neaktualizuje, dokud neprovedete přeplánování a nespustíte Recalculate loads (FUNMIWL). Výsledky SkyPlanner neověřujte podle neaktuálního přehledu Loads inquiry (CONSMWK).
- No. of resources znamená počet pracovníků obsluhy. WSTNBR udává počet zdrojů, které operace na pracovišti vyžaduje, například tři osoby na ručním pracovišti. Namapujte jej na počet operátorů na pracovišti ve SkyPlanner, který umožňuje naplánovat několik lidí na jednu operaci současně. V závodech, které používaly rozhraní GFS advanced interface, je tato hodnota nastavena na 1, jak vyžaduje Sage. Ověřte proto, kde je uložen skutečný počet pracovníků obsluhy.
- Operace technologického postupu bez přiřazeného pracoviště nelze umístit na pracoviště ve SkyPlanner. Při mapování se takové operace označí.
- Časové jednotky a náhradní pracoviště. Časy v technologických postupech mají vlastní časovou jednotku (TIMUOMCOD) a náhradní pracoviště mají přiřazenou prioritu. Obojí výslovně namapujte a po každém upgradu X3 znovu spusťte kontrolu mapování.
- Zamčené příkazy. Pokud závod používal také Production Scheduler, příkazy předané do tohoto nástroje mají stav Being optimized a nelze je měnit, dokud je nevyřadíte z rozvrhování (PSOPTFREE). Uvolněte je před přechodem na nový systém.
Kdo nastavuje integraci se Sage X3
Součástí práce je mapování vašich složek, pravidel pro technologické postupy, struktury pracovišť a zakázkových úprav do SkyPlanner. Zahrnuje také omezení, která X3 neuchovává jako data použitelná pro rozvrhování: matici seřizovacích časů, nástroje, počty operátorů a alternativní výrobní zdroje.
- Tým SkyPlanner integraci nastaví při zavádění a po spuštění ostrého provozu pro ni poskytuje podporu. Každý závod používá X3 jinak a právě při této práci se tyto znalosti uplatní. Tým připojí váš endpoint X3, ať už v cloudu, nebo v místní instalaci, při mapování ověří kmenová data a zaznamená požadavky odmítnuté systémem X3 k dalšímu řešení. Od prvního dne je jasné, kdo za integraci odpovídá, a nepotřebujete vlastního vývojáře integrací.
- Zapojit se může i váš partner Sage. Zná vaše složky, kódy aktivit a zakázkové úpravy a může společně s týmem zkontrolovat připojenou aplikaci, uživatele Syracuse a publikované služby v GESAWE.
- Vaši vývojáři mohou integraci dále rozvíjet. REST API systému SkyPlanner umožňuje číst a zapisovat zakázky, produkty, materiály, kroky procesu a časové záznamy. Používá autentizaci JWT a má dokumentaci Swagger/OpenAPI (referenční dokumentace API). Pro začátek stačí klíč API a průvodce integrací vás provede prvními voláními. Tým SkyPlanner v případě potřeby pomůže. Dokumentace SkyPlanner popisuje produkty a materiály i nákupní objednávky. Ve společnosti Laboratory & Allied propojil interní IT tým SkyPlanner se SAP Business One převážně vlastními silami, s pomocí týmu SkyPlanner.
Proč týmy pracující s X3 volí SkyPlanner pro rozvrhování výroby
Zvolte SkyPlanner, pokud chcete spustit ostrý provoz během týdnů, ne až po mnohaměsíčním projektu zavádění APS.
Zvolte SkyPlanner, pokud chcete začít rozvrhovat výrobu ještě před dokončením integrace.
Během zkušebního období mohou plánovači rozvrhovat výrobu z dat CSV, zatímco se nastavuje čtení z X3 a zpětný zápis. Jakmile se integrace spustí, nahradí import souborů.
Zvolte SkyPlanner, pokud chcete integraci s minimálními nároky na infrastrukturu.
Webhooky odesílají změny rozvrhu a stavů v reálném čase, takže middleware musí pravidelně zasílat dotazy pouze systému X3. Arcturus AI sestaví rozvrh během sekund a Autopilot jej při změnách ve výrobě automaticky přeplánuje.
Zvolte SkyPlanner, pokud mají vaše data z X3 sloužit jako základ modelu skutečných výrobních omezení.
Počty pracovníků obsluhy se převedou na několik operátorů na jednom pracovišti a náhradní pracoviště na alternativní stroje. Matice seřizovacích časů doplní časy přestaveb mezi produkty podle jejich pořadí. Nástroje mají omezenou kapacitu, takže přípravek používaný na jednom stroji se nikdy současně nezarezervuje na jiném.
Zvolte SkyPlanner, pokud má sledování výroby začínat přímo v provozu.
Operátoři zaznamenávají práci na telefonu nebo tabletu pomocí funkcí Mobile Confirmations, Production Timer a Quick Log Mode. Stejné časové záznamy se odesílají do X3 jako odvádění výroby.
Cena začíná na 199 € měsíčně a zahrnuje 5 pracovišť, s měsíční fakturací. Cenovou nabídku integrace připravíme předem podle vašich procesů a potřeb společně s cenou tarifu, takže celkové náklady znáte ještě před zahájením. Podívejte se na ceník a funkce nebo si spusťte bezplatné zkušební období na 30 dní až pro 20 pracovišť, bez platební karty.
Jak výrobní firmy hodnotí SkyPlanner
2 húspory každý týden
„Díky SkyPlanner jsme v plánování výroby přešli od tabulek v Excelu k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozvaděče a spínací zařízení
Plánování výroby šetří každý týden 2 hodiny práce a nová fronta operací se dostane na linku během sekund.
+90%efektivity výroby
„Efektivita výroby vzrostla o 90 %.“
Abdul Rucyinga, vedoucí IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrostla o 90 % a vytvoření optimalizovaného plánu na tři měsíce pro všechna pracoviště trvá méně než 30 minut.
98%včasnost dodávek, nárůst z přibližně 50 %
„SkyPlanner hraje rozhodující roli v udržování včasnosti našich dodávek.“
Hannu Lahtinen, výkonný ředitel
KJH-Comp · Zpracování plechů a zakázková výroba
Včasnost dodávek vzrostla z přibližně 50 % až na 98 % a rozvrhování nyní zvládne jeden mistr místo dvou.
99,2%včasnost dodávek
„Díky SkyPlanner lépe vidíme úzká místa a řízení výroby je přehlednější.“
Toni Tuori, vedoucí výroby
Piristeel · Střešní bezpečnostní prvky a okapové systémy
Včasnost dodávek letos dosáhla 99,2 % a rozvrhování šetří až čtyři hodiny práce denně.
Časté dotazy
Jak je SkyPlanner APS propojen se Sage X3?
Obousměrně, prostřednictvím GraphQL, REST api1, webových služeb SOAP a šablon. Do SkyPlanner se načítají výrobní příkazy, technologické postupy a pracoviště. Zpět se zapisují plánované termíny operací a vykázané hodiny, které při změnách rozvrhu odesílají webhooky. Integraci nastaví tým SkyPlanner při zavádění, případně ji váš partner Sage X3 nebo vývojáři vytvoří s využitím REST API systému SkyPlanner.
Jak se termíny operací zapisují zpět do Sage X3?
Prostřednictvím objektu Work order (GESMFG), publikovaného jako webová služba SOAP ve funkci Web services (GESAWE). Jeho operace modify aktualizuje u každé výrobní operace pole Start (OPESTR), End (OPEEND) a pracoviště. Pro hromadné aktualizace se přes AOWSIMPORT spouští šablona pro import výrobních příkazů. Hodiny a množství se zapisují prostřednictvím objektu Production tracking (GESMTK).
Máme použít GraphQL, nebo webové služby SOAP?
Obojí, každé tam, kde má největší přednosti. GraphQL je API doporučované společností Sage a umožňuje číst produkty, závody, nákupy a skladové zásoby v cloudu i v místní instalaci. Objektové webové služby SOAP zapisují rozvrh a údaje o odvádění výroby. SOAP Template Services spouštějí importní a exportní šablony pro hromadné načítání dat.
Jak zabránit duplicitním zápisům nebo ztrátě změn?
Jako klíč každého zápisu do Production tracking použijte ID časového záznamu ze SkyPlanner a uchovejte číslo záznamu odvádění vrácené systémem X3. Opakovaný webhook tak lze rozpoznat a přeskočit. Dokud je X3 nedostupný, ukládejte změny do fronty a po obnovení dostupnosti je zapište ve správném pořadí. Odmítnuté zápisy, například odvádění na výrobní příkaz, který nemá stav Firm, protokolujte spolu s chybovou zprávou X3.
Potřebujeme pro SkyPlanner kódy aktivit POPS nebo GFS?
Ne. Tyto kódy aktivují vlastní nástroj Production Scheduler společnosti Sage a obecné rozhraní pro Web Scheduling. SkyPlanner načítá výrobní příkazy prostřednictvím GraphQL, REST api1 nebo šablon a zapisuje zpět prostřednictvím webových služeb SOAP Work order a Production tracking.
Jak SkyPlanner načítá nové výrobní příkazy ze Sage X3?
Integrace načítá data z X3 v krátkých intervalech přes GraphQL, REST api1 nebo exporty pomocí šablon, v cloudu také přes Sync API. V opačném směru odesílají webhooky SkyPlanner změny rozvrhu ihned, jakmile nastanou.
Můžeme si vše vyzkoušet s daty ze Sage X3, než začneme vytvářet integraci?
Ano. Během 30denní zkušební doby importujte CSV exporty pracovišť, technologických postupů a otevřených výrobních příkazů. Pokud chcete vymezit rozsah samotné integrace s X3, kontaktujte obchodní oddělení.
