Integracje / ERP / QAD Adaptive ERP
Przewodnik po integracji QAD Adaptive ERP na potrzeby planowania produkcji w SkyPlanner APS
Ten przewodnik pokazuje partnerom i zespołom IT, jak połączyć QAD Adaptive ERP ze SkyPlanner APS. Obejmuje również starsze instalacje QAD Enterprise Edition i MFG/PRO. Integracja SkyPlanner z QAD Adaptive ERP działa w obu kierunkach i korzysta z interfejsów QAD:
- Do SkyPlanner trafiają zlecenia produkcyjne wraz z operacjami, indeksy, struktury produktów, marszruty technologiczne, gniazda produkcyjne, kalendarze zakładowe, stany magazynowe i zamówienia zakupu.
- Wyznaczone w harmonogramie daty uruchomienia i terminy realizacji wracają do Work Order Maintenance (16.1).
- Zapisy czasu pracy operatorów wracają do QAD przez Labor Feedback by Work Order (16.20.1), a wykonane ilości — przez Work Order Receipt (16.11).
- Webhooki SkyPlanner przesyłają zmiany w harmonogramie na bieżąco.
Podczas wdrożenia zespół SkyPlanner konfiguruje integrację zgodnie z konfiguracją QAD i zapewnia jej wsparcie po uruchomieniu produkcyjnym. Ten przewodnik jest przeznaczony dla partnerów i programistów, którzy chcą uczestniczyć w tych pracach lub samodzielnie tworzyć rozwiązania korzystające z udokumentowanego REST API SkyPlanner (dokumentacja API).
Interfejsy integracyjne QAD
QAD udostępnia zewnętrznemu systemowi harmonogramowania trzy ścieżki integracji:
- QAD QXtend Inbound (QXI). QAD opisuje go jako „a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.” (platformę XML opartą na usługach sieciowych, zgodną z SOAP i zapewniającą pełny, niezależny od platformy dostęp do funkcji biznesowych QAD Enterprise Applications). Każde żądanie ma postać QDoc i uruchamia program QAD z taką samą walidacją jak na jego ekranie. Każde zwraca też odpowiedź w postaci QDoc. Udostępnione QDoc obejmują
maintainItemMaster,maintainRoutingimaintainPurchaseOrder. W przypadku programów bez udostępnionego QDoc narzędzie QGen firmy QAD mapuje program dostępny z menu: „QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.” (QGen służy do mapowania programów niestandardowych lub programów QAD Enterprise Applications, dla których nie udostępniono schematów QDoc ani plików zdarzeń). Sam QAD również korzysta z tej ścieżki: „QAD Production Scheduler uses QAD QXtend to update work orders.” (QAD Production Scheduler używa QAD QXtend do aktualizacji zleceń produkcyjnych). (Przewodnik po QXtend) - QAD QXtend Outbound (QXO). QXO „exports user-configurable business objects as XML QDocs out of QAD products.” (eksportuje z produktów QAD obiekty biznesowe konfigurowane przez użytkownika w postaci dokumentów QDoc w formacie XML). Standardowe obiekty biznesowe to między innymi Item, Product Structure, Routing, Work Center, Department, Inventory Transaction i Inventory Status.
- REST API dokumentów biznesowych. Od wersji Adaptive ERP 2022.1 „Query REST APIs are now available for business documents,” (dla dokumentów biznesowych dostępne są interfejsy REST API do odczytu danych). Obsługują filtrowanie, sortowanie, stronicowanie i pobieranie części danych. Ich dokumentacja jest dostępna w Swagger w danej instancji (informacje o wersji).
QXtend obsługuje zapis danych. QXO i interfejsy REST API do zapytań obsługują odczyt.
Uwierzytelnianie i licencje
- QXtend Inbound. Gdy w odbiorniku włączono Require Authentication, każdy QDoc zawiera Session ID lub nazwę użytkownika i hasło QAD. Przed uruchomieniem programu QXI sprawdza uprawnienia użytkownika do dostępu do danej pozycji menu.
- Użytkownik integracji. Utwórz osobne konto użytkownika QAD z dostępem wyłącznie do programów wywoływanych przez integrację: Work Order Maintenance, Labor Feedback by Work Order, Work Order Receipt oraz programów obsługujących dane podstawowe.
- Licencja QXtend. Licencjonowanie QXtend zależy od liczby agentów i odbiorników. W przewodniku QAD komunikacja przez usługi sieciowe z aplikacją zewnętrzną w obu kierunkach jest oznaczona jako płatna. Dlatego przed rozpoczęciem projektu sprawdź licencję QXtend.
Po stronie SkyPlanner REST API korzysta z uwierzytelniania tokenem API w nagłówku Authorization-Token (SkyPlanner Settings > API). Dokumentacja jest dostępna w Swagger/OpenAPI. Samouczek integracji pokazuje, jak wykonać pierwsze wywołania.
Zdarzenia i dane o zmianach
QXtend Outbound to mechanizm QAD służący do przekazywania danych o zmianach. „A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.” (Gdy monitorowane dane w QAD Enterprise Applications ulegają zmianie, powiadomienia o zmianach są zapisywane w bazie qxevents). Następnie QXO tworzy QDoc i dostarcza je „to a directory location where the subscriber polls for and picks up new QDocs,” (do katalogu, który subskrybent okresowo sprawdza i z którego pobiera nowe QDoc) lub do usługi sieciowej nasłuchującej pod adresem URL.
SkyPlanner subskrybuje dane publikowane przez QXO jako usługa sieciowa, a dane nieobjęte QXO pobiera przez cykliczne zapytania do REST API. Work Order nie należy do standardowych obiektów biznesowych QXO. Dlatego integracja albo dodaje obiekt biznesowy QXO oparty na tabelach zleceń produkcyjnych (wo_mstr, wr_route), albo co kilka minut odpytuje REST API o zlecenia produkcyjne.
SkyPlanner wysyła webhooki po zmianie stanu lub harmonogramu, więc zapis zwrotny jest wyzwalany zdarzeniami.
Mapowanie danych
| Obiekt QAD (program, interfejs) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
| Indeksy (Item Master Maintenance 1.4.1; QXO Item) | Produkty i materiały | QAD → SkyPlanner | Import początkowy, następnie przy zmianach przez QXO |
| Struktury produktów (13.5; QXO Product Structure) | Struktura produktu, półprodukty, materiały dla każdego produktu | QAD → SkyPlanner | Import początkowy, następnie przy zmianach przez QXO |
| Marszruty technologiczne (14.13.1; QXO Routing): czasy kolejki, przygotowania, wykonania, oczekiwania i transportu | Operacje z czasem trwania oraz czasami przygotowania i czynności zakończeniowych | QAD → SkyPlanner | Import początkowy, następnie przy zmianach przez QXO |
| Gniazda produkcyjne (14.5) i działy (14.1; QXO Work Center, Department) | Stanowiska robocze, grupy stanowisk roboczych, wskaźniki wydajności | QAD → SkyPlanner | Import początkowy, później sporadycznie |
| Kalendarze zakładowe i kalendarze gniazd produkcyjnych | Zmiany i dni wolne od pracy | QAD → SkyPlanner | Codziennie lub niezależne zarządzanie zmianami w SkyPlanner |
| Zlecenia produkcyjne (16.1) wraz z marszrutami technologicznymi zleceń (16.13.13) i komponentami | Zlecenia i operacje z terminami realizacji i zapotrzebowaniem materiałowym | QAD → SkyPlanner | Niestandardowy obiekt QXO lub odpytywanie REST API co kilka minut |
| Zapasy (QXO Inventory Status, Inventory Transaction) | Stany magazynowe | QAD → SkyPlanner | Przy zmianie lub co godzinę |
| Zamówienia zakupu z terminami dostawy | Zamówienia zakupu, oczekiwane materiały według daty dostawy | QAD → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Daty uruchomienia i terminy realizacji zleceń produkcyjnych (Work Order Maintenance 16.1, QXtend Inbound QDoc) | Planowany początek i koniec każdego zlecenia | SkyPlanner → QAD | Przy zmianie harmonogramu, przez webhook SkyPlanner |
| Labor Feedback by Work Order (16.20.1): czas przygotowania i wykonania każdej operacji | Rejestry czasu pracy i potwierdzenia operatorów | SkyPlanner → QAD | Po każdym potwierdzeniu lub po każdej zmianie, jeśli wybrano tę opcję |
| Work Order Receipt (16.11) | Wykonane ilości | SkyPlanner → QAD | Po każdym potwierdzeniu, jeśli wybrano tę opcję |
| Brak w QAD | Macierz czasów przezbrojeń, narzędzia jako zasoby o ograniczonej dostępności, alternatywne maszyny i pracownicy | Zarządzane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Pobierz indeksy, struktury produktów, marszruty technologiczne, gniazda produkcyjne i kalendarze przez QXO lub interfejsy REST API do zapytań. Świadomie dobierz sposób mapowania gniazd produkcyjnych: gniazdo z czterema maszynami staje się jedną grupą stanowisk roboczych lub czterema stanowiskami roboczymi. Linie produkcji powtarzalnej z Production Line Maintenance również mogą stać się stanowiskami roboczymi.
2. Synchronizacja zleceń produkcyjnych. Pobierz zatwierdzone planowane i uruchomione zlecenia produkcyjne wraz z ich marszrutami technologicznymi i komponentami, a także otwarte zamówienia zakupu. SkyPlanner uznaje zamówiony materiał za dostępny w dniu dostawy wskazanym w zamówieniu zakupu i aktualizuje stan magazynowy po oznaczeniu zamówienia statusem Delivered.
Harmonogramuj zlecenia produkcyjne, a nie zlecenia planowane MRP. Zlecenia planowane muszą najpierw stać się w QAD zatwierdzonymi planowanymi lub uruchomionymi zleceniami produkcyjnymi.
3. Zapis harmonogramu do QAD. Gdy silnik umieszcza zlecenie w harmonogramie lub je przesuwa, webhook SkyPlanner wyzwala QDoc QXtend Inbound dla Work Order Maintenance (16.1). Ustawia on datę uruchomienia na datę pierwszej zaplanowanej operacji, a termin realizacji — na datę ostatniej. QXtend uruchamia program z walidacją QAD i zwraca odpowiedź QDoc, którą sprawdza integracja.
Kolejność operacji na każdej maszynie pozostaje w SkyPlanner i trafia do operatorów przez Mobile Confirmations. Dzięki temu integracja nie koliduje z blokadą zmian marszrut technologicznych, którą QAD stosuje do uruchomionych zleceń.
4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę w SkyPlanner Mobile Confirmations lub Production Timer, a zapisy czasu pracy pozwalają na bieżąco aktualizować harmonogram. Ty decydujesz, czy rzeczywiste czasy mają wracać do QAD. Jeśli tak, czasy przygotowania i wykonania każdej operacji trafiają do Labor Feedback by Work Order, a wykonane ilości — do Work Order Receipt. Jeśli nie, czas pracy jest wprowadzany w QAD tak jak dotychczas.
5. Odpowiedzialność za dane i reguły rozstrzygania konfliktów. Zapisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Indeksy, struktury produktów, marszruty technologiczne, ilości, status zlecenia produkcyjnego | QAD |
| Kolejność operacji, czasy rozpoczęcia i zakończenia, przydział maszyn | SkyPlanner |
| Daty uruchomienia i terminy realizacji zleceń produkcyjnych | SkyPlanner zapisuje, QAD przechowuje |
| Macierz czasów przezbrojeń, wymagania dotyczące narzędzi i operatorów, zasoby alternatywne | SkyPlanner |
| Zmiany robocze i dni wolne od pracy | Jeden system wybrany podczas określania zakresu |
| Czas pracy, wydania komponentów i przyjęcia | QAD — dane wprowadzane bezpośrednio lub przekazywane z zapisów czasu pracy SkyPlanner |
Wybierz jeden system, który będzie zapisywał daty zleceń produkcyjnych. SkyPlanner nie wymaga modułu harmonogramowania QAD, więc dla harmonogramowanych przez siebie zleceń przejmuje zapis dat od narzędzi harmonogramowania QAD lub innych systemów harmonogramowania.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od jego rozpoczęcia. Wcześniej sprawdź harmonogram w ramach 30-dniowego bezpłatnego okresu próbnego, korzystając z gniazd produkcyjnych, marszrut technologicznych i otwartych zleceń produkcyjnych wyeksportowanych z QAD do CSV lub Excela.
- Mapowanie. Ustal tabelę mapowania, odpowiedzialność za dane, zakłady i domeny objęte zakresem, częstotliwość synchronizacji oraz to, czy czas pracy ma wracać do QAD.
- Dostęp do QAD. Utwórz konto użytkownika integracji, potwierdź licencję QXtend, skonfiguruj odbiornik QXtend i subskrybenta QXO. Najpierw przeprowadź testy w domenie testowej.
- Konfiguracja QDoc. Korzystaj z udostępnionych QDoc tam, gdzie są dostępne. W razie potrzeby wygeneruj za pomocą QGen QDoc dla Work Order Maintenance, Labor Feedback by Work Order i Work Order Receipt.
- Import początkowy. Indeksy, struktury produktów, marszruty technologiczne, gniazda produkcyjne, kalendarze.
- Synchronizacja zleceń produkcyjnych i zamówień zakupu. Zdarzenia QXO lub cykliczne odpytywanie REST API z filtrowaniem, stronicowaniem i ponawianiem prób.
- Konfiguracja ograniczeń w SkyPlanner. Macierz czasów przezbrojeń, narzędzia, liczba operatorów potrzebnych do każdej operacji oraz alternatywne maszyny lub pracownicy.
- Zapis harmonogramu w ERP i testy równoległe. Zapisuj terminy przekazywane przez webhooki SkyPlanner, testuj nowy harmonogram równolegle z dotychczasowym planem, porównuj terminy i poprawiaj dane podstawowe.
- Uruchomienie produkcyjne. Włącz zapis do ERP, gdy dane będą zgodne.
Co uwzględnić przy integracji z QAD Adaptive ERP
- Ponowne uruchamianie CRP. CRP przelicza terminy wszystkich otwartych operacji w wybranych zleceniach produkcyjnych. QAD zachowuje terminy wprowadzone ręcznie tylko pod warunkiem: „you also adjusted the work order release and due date to match,” (dostosowano również datę zwolnienia i termin realizacji zlecenia produkcyjnego) — a właśnie te daty zapisuje SkyPlanner. Uruchamiaj CRP po zapisie do ERP lub wyklucz zlecenia, które planuje SkyPlanner.
- Marszruty po zwolnieniu zlecenia są zablokowane. „Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.” (Gdy zlecenie produkcyjne ma status Exploded, Allocated lub Released, nie można już zmieniać marszruty technologicznej). Odczytuj marszrutę przy zwalnianiu zlecenia, a zmiany wprowadzaj tylko w zleceniach o statusie Planned lub Firm Planned.
- Jednostki czasu w marszrucie technologicznej. Czas przezbrojenia i czas wykonania obciążają zasoby, natomiast „queue, wait, and move times are excluded from load calculations.” (czasy kolejkowania, oczekiwania i transportu nie są uwzględniane przy obliczaniu obciążenia). Modeluj je w SkyPlanner jako etapy, które zajmują wyłącznie czas, i sprawdź, czy czas wykonania jest podany na sztukę, czy na zlecenie.
- Przepustowość QXtend. QAD ostrzega: „UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.” (Wydajność adaptera UI API może być niewystarczająca przy przetwarzaniu dużych ilości danych lub transakcji w czasie rzeczywistym). Wysyłaj partiami tylko zmienione zlecenia i korzystaj z natywnych QDocs tam, gdzie są dostępne.
- Domeny i zakłady. W instalacjach QAD z wieloma domenami gniazda produkcyjne i zlecenia produkcyjne są przypisane do domen i zakładów. Każdemu zakładowi objętemu integracją przypisz osobną grupę stanowisk roboczych.
- Łączenie produkcji powtarzalnej i dyskretnej. Linie obsługiwane przez Advanced Repetitive korzystają z harmonogramów produkcji powtarzalnej, a nie ze zleceń produkcyjnych. Podczas określania zakresu ustal, które linie będzie planować SkyPlanner.
Kto konfiguruje i wspiera integrację z QAD
- Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Obejmuje ono uzgodnione QDocs, subskrypcje QXO i zapytania REST. Każdy zakład korzysta z QAD inaczej — właśnie tutaj wykorzystujemy tę wiedzę.
- Twój partner QAD może uczestniczyć we wdrożeniu. Zna Twoje domeny, modyfikacje i warunki licencyjne. Wspólnie z zespołem SkyPlanner może skonfigurować QXtend, QGen QDocs i konto użytkownika integracji.
- Twoi programiści mogą rozbudowywać integrację, korzystając z REST API SkyPlanner i tokenu API. Na początek wystarczy token API, a zespół SkyPlanner służy pomocą w razie potrzeby. Szczegóły znajdziesz w dokumentacji integracji SkyPlanner.
SkyPlanner kosztuje od 199 € miesięcznie za 5 stanowisk roboczych, przy rozliczeniu miesięcznym. Integrację wyceniamy z góry wraz z wybranym planem, uwzględniając Twój proces i potrzeby. Zobacz cennik, informacje o harmonogramowaniu produkcji z QAD Adaptive ERP, stronę QAD Adaptive ERP oraz przegląd integracji z ERP.
Opinie firm produkcyjnych o SkyPlanner
2 hoszczędności co tydzień
„Dzięki SkyPlanner przeszliśmy od planowania produkcji w arkuszach Excel do jej optymalizacji w czasie rzeczywistym.”
Kalle Kalliomäki, specjalista ds. łańcucha dostaw
UTU · Rozdzielnice i aparatura łączeniowa
Planowanie produkcji pozwala zaoszczędzić 2 godziny pracy tygodniowo, a nowa kolejka operacji trafia na linię w kilka sekund.
+90%wydajności produkcji
„Wydajność produkcji wzrosła o 90%.”
Abdul Rucyinga, szef działu IT
Laboratory & Allied · Produkcja farmaceutyczna
Wydajność produkcji wzrosła o 90%, a przygotowanie zoptymalizowanego planu na trzy miesiące dla wszystkich stanowisk roboczych zajmuje mniej niż 30 minut.
1 000+zleceń produkcyjnych planowanych automatycznie
„Teraz kontrolujemy produkcję w inny sposób, a nasza wiedza o zdolnościach produkcyjnych jest na całkiem innym poziomie.”
Hannu Ryynänen, dyrektor generalny
Mamec · Mieszalniki przemysłowe, pompy i zaawansowana technologicznie produkcja kontraktowa
Tysiące zleceń produkcyjnych są planowane automatycznie, a cała organizacja ma wgląd w produkcję w czasie rzeczywistym.
99,2%terminowości dostaw
„SkyPlanner zapewnił nam wgląd potrzebny do wykrywania wąskich gardeł i uporządkował zarządzanie produkcją.”
Toni Tuori, kierownik produkcji
Piristeel · Zabezpieczenia dachowe i systemy odprowadzania wody deszczowej
Terminowość dostaw osiągnęła w tym roku 99,2%, a harmonogramowanie pozwala zaoszczędzić do czterech godzin pracy dziennie.
Najczęściej zadawane pytania
Czy QAD Adaptive ERP udostępnia API do obsługi zleceń produkcyjnych?
Tak. QXtend Inbound uruchamia Work Order Maintenance i programy obsługi hali produkcyjnej przez SOAP i QDocs w formacie XML. Gdy nie ma gotowego, udostępnionego QDoc, generuje się go za pomocą QGen. REST API dokumentów biznesowych umożliwiają dodatkowo odczyt danych z filtrowaniem i stronicowaniem.
Czy QAD obsługuje webhooki?
W QAD za przekazywanie zmian danych odpowiada QXtend Outbound: wyzwalacze tabel rejestrują zmiany, a QXO dostarcza QDocs pod adres URL usługi sieciowej lub do okresowo sprawdzanego katalogu. Własne webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco.
Jak zaplanowane terminy są zapisywane z powrotem w QAD?
Za pomocą QDoc przesyłanego przez QXtend Inbound do Work Order Maintenance (16.1). Ustawia on datę zwolnienia i termin realizacji zlecenia produkcyjnego zgodnie z harmonogramem SkyPlanner. QAD sprawdza poprawność QDoc według tych samych reguł co dane wprowadzane na ekranie i zwraca odpowiedź w postaci QDoc.
Jak potwierdzenia operatorów trafiają do QAD?
Czas przezbrojenia i wykonania jest zapisywany przez Labor Feedback by Work Order (16.20.1), a wykonane ilości — przez Work Order Receipt (16.11). W obu przypadkach służą do tego QDocs przesyłane przez QXtend Inbound. Decyzję o zapisie zwrotnym podejmuje się podczas określania zakresu.
Czy partner QAD powinien zaproponować QAD Advanced Scheduling, czy SkyPlanner?
SkyPlanner — gdy klient korzysta ze zleceń produkcji dyskretnej i chce w ciągu kilku tygodni uzyskać działający plan uwzględniający rzeczywiste zdolności produkcyjne. QAD opisuje Advanced Scheduling jako harmonogram dla poszczególnych linii w każdym zakładzie i przedstawia go wraz z DSCP Production Planning oraz Redzone (QAD). SkyPlanner łączy się przez QXtend, planuje wykorzystanie każdej maszyny, operatora, narzędzia i materiału, automatycznie przelicza plan i nie ogranicza liczby użytkowników — od 199 € miesięcznie.
Czy możemy przetestować SkyPlanner przed zbudowaniem integracji?
Tak. Bezpłatny 30-dniowy okres próbny pozwala korzystać z maksymalnie 20 stanowisk roboczych i importować dane z QAD w plikach CSV lub Excel. Karta kredytowa nie jest wymagana. Rozpocznij okres próbny lub skontaktuj się z działem sprzedaży, aby określić zakres integracji.