Інтеграції / ERP / QAD Adaptive ERP
Посібник з інтеграції QAD Adaptive ERP для календарного планування виробництва в SkyPlanner APS
Цей посібник з інтеграції QAD Adaptive ERP пояснює партнерам та ІТ-командам, як підключити QAD Adaptive ERP до SkyPlanner APS, зокрема й у разі використання попередніх версій QAD Enterprise Edition та MFG/PRO. SkyPlanner забезпечує двосторонню інтеграцію з QAD Adaptive ERP через власні інтерфейси QAD:
- До SkyPlanner надходять виробничі замовлення та їхні технологічні операції, номенклатура, структури виробів, технологічні маршрути, робочі центри, виробничі календарі, запаси й замовлення на закупівлю.
- Заплановані дати запуску та завершення передаються назад у Work Order Maintenance (16.1).
- Записи обліку робочого часу операторів передаються назад через Labor Feedback by Work Order (16.20.1), а виготовлені кількості — через Work Order Receipt (16.11).
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час початкового налаштування команда SkyPlanner адаптує інтеграцію до вашої конфігурації QAD та підтримує її після запуску в експлуатацію. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно розробляти рішення на основі документованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції QAD
QAD надає зовнішній системі календарного планування три способи підключення:
- QAD QXtend Inbound (QXI). QAD описує його як “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.” (XML-платформа на основі вебсервісів із підтримкою SOAP, що забезпечує повний доступ до бізнес-функцій QAD Enterprise Applications незалежно від платформи). Кожен запит — це QDoc, який запускає програму QAD з тими самими перевірками, що й під час роботи через її екранну форму. На кожен запит повертається QDoc із відповіддю. Серед готових QDoc —
maintainItemMaster,maintainRoutingіmaintainPurchaseOrder. Для програм без готового QDoc інструмент QGen від QAD створює зіставлення з програмою меню: “QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.” (QGen використовують для зіставлення користувацьких програм або програм QAD Enterprise Applications, для яких немає готових схем QDoc і файлів подій). Сама QAD також використовує цей спосіб: “QAD Production Scheduler uses QAD QXtend to update work orders.” (QAD Production Scheduler використовує QAD QXtend для оновлення виробничих замовлень). (Посібник QXtend) - QAD QXtend Outbound (QXO). QXO “exports user-configurable business objects as XML QDocs out of QAD products.” (експортує з продуктів QAD бізнес-об’єкти, які налаштовує користувач, у форматі XML QDoc). До стандартних бізнес-об’єктів належать Item, Product Structure, Routing, Work Center, Department, Inventory Transaction та Inventory Status.
- REST API для бізнес-документів. Починаючи з Adaptive ERP 2022.1, “Query REST APIs are now available for business documents,” (для бізнес-документів доступні REST API для виконання запитів) із фільтрацією, сортуванням, посторінковим отриманням і вибіркою частини даних. Їхню документацію наведено у Swagger у вашому екземплярі системи (примітки до випуску).
Запис даних виконується через QXtend. Для читання використовуються QXO та REST API для виконання запитів.
Автентифікація та ліцензування
- QXtend Inbound. Якщо для приймача ввімкнено Require Authentication, кожен QDoc містить Session ID або ім’я користувача й пароль QAD. Перш ніж запустити програму, QXI перевіряє права користувача на доступ до меню.
- Користувач для інтеграції. Створіть окремого користувача QAD з доступом лише до тих програм меню, які викликає інтеграція: Work Order Maintenance, Labor Feedback by Work Order, Work Order Receipt і програм роботи з основними даними.
- Ліцензія QXtend. Ліцензування QXtend залежить від агентів і приймачів. У посібнику QAD обмін даними із зовнішнім застосунком через вебсервіси в обох напрямках позначено як платний, тому перевірте умови ліцензії QXtend до початку проєкту.
На боці SkyPlanner автентифікація REST API виконується за допомогою токена API в заголовку Authorization-Token (SkyPlanner Settings > API). API задокументовано у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково описано перші виклики.
Події та дані про зміни
QXtend Outbound — це механізм QAD для передавання даних про зміни. “A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.” (Коли в QAD Enterprise Applications змінюються відстежувані дані, сповіщення про зміни записуються до бази даних qxevents). Далі QXO формує QDoc і передає їх “to a directory location where the subscriber polls for and picks up new QDocs,” (до каталогу, який підписник періодично перевіряє та з якого забирає нові QDoc) або до вебсервісу, що приймає запити за певною URL-адресою.
SkyPlanner підписується як вебсервіс на публікації QXO, а дані, яких QXO не охоплює, отримує шляхом періодичних запитів до REST API. Work Order не належить до стандартних бізнес-об’єктів QXO, тому інтеграція або додає бізнес-об’єкт QXO на основі таблиць виробничих замовлень (wo_mstr, wr_route), або запитує виробничі замовлення через REST API кожні кілька хвилин.
SkyPlanner надсилає вебхуки в разі зміни стану або розкладу, тож зворотний запис даних працює на основі подій.
Зіставлення даних
| Об’єкт QAD (програма, інтерфейс) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|
| Номенклатура (Item Master Maintenance 1.4.1; QXO Item) | Вироби та матеріали | QAD → SkyPlanner | Початкове завантаження, далі — у разі змін через QXO |
| Структури виробів (13.5; QXO Product Structure) | Структура виробу, складові вироби, матеріали для кожного виробу | QAD → SkyPlanner | Початкове завантаження, далі — у разі змін через QXO |
| Технологічні маршрути (14.13.1; QXO Routing): черга, налагодження, виконання, очікування, переміщення | Етапи процесу з тривалістю, часом налагодження та завершальних робіт | QAD → SkyPlanner | Початкове завантаження, далі — у разі змін через QXO |
| Робочі центри (14.5) і підрозділи (14.1; QXO Work Center, Department) | Робочі центри, групи робочих центрів, показники ефективності | QAD → SkyPlanner | Початкове завантаження, надалі — зрідка |
| Виробничі календарі та календарі робочих центрів | Зміни та неробочі дні | QAD → SkyPlanner | Щодня або ведення робочих змін у SkyPlanner |
| Виробничі замовлення (16.1) з технологічними маршрутами замовлень (16.13.13) і компонентами | Замовлення та виробничі завдання з термінами виконання й потребами в матеріалах | QAD → SkyPlanner | Користувацький об’єкт QXO або опитування REST API кожні кілька хвилин |
| Запаси (QXO Inventory Status, Inventory Transaction) | Складські залишки | QAD → SkyPlanner | У разі змін або щогодини |
| Замовлення на закупівлю з термінами поставки | Замовлення на закупівлю, очікувані матеріали за датами поставки | QAD → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
| Дати запуску й завершення виробничого замовлення (Work Order Maintenance 16.1, QXtend Inbound QDoc) | Заплановані початок і завершення кожного замовлення | SkyPlanner → QAD | У разі зміни розкладу, через вебхук SkyPlanner |
| Labor Feedback by Work Order (16.20.1): час налагодження та виконання кожної технологічної операції | Записи обліку робочого часу та підтвердження операторів | SkyPlanner → QAD | За кожним підтвердженням або за зміну, якщо вибрано цю функцію |
| Work Order Receipt (16.11) | Виготовлена кількість | SkyPlanner → QAD | За кожним підтвердженням, якщо вибрано цю функцію |
| Немає в QAD | Матриця часу переналагодження, інструменти як обмежені ресурси, альтернативні верстати та персонал | Ведеться у SkyPlanner | Налаштовується під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Зчитайте номенклатуру, структури виробів, технологічні маршрути, робочі центри й календарі через QXO або REST API для виконання запитів. Продумайте зіставлення робочих центрів: робочий центр із чотирма верстатами може стати однією групою робочих центрів або чотирма окремими робочими центрами. Лінії повторюваного виробництва з Production Line Maintenance також можуть стати робочими центрами.
2. Синхронізація виробничих замовлень. Зчитайте твердо заплановані та запущені виробничі замовлення разом із їхніми технологічними маршрутами й компонентами, а також відкриті замовлення на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки за замовленням на закупівлю та оновлює залишки, коли це замовлення отримує статус Delivered.
Включайте до розкладу виробничі замовлення, а не планові замовлення MRP. Спочатку планові замовлення мають стати в QAD твердо запланованими або запущеними виробничими замовленнями.
3. Зворотний запис розкладу. Коли механізм планування розміщує або переміщує замовлення, вебхук SkyPlanner запускає QXtend Inbound QDoc для Work Order Maintenance (16.1). Він встановлює дату запуску за першою запланованою технологічною операцією, а дату завершення — за останньою. QXtend виконує програму зі штатними перевірками QAD і повертає QDoc із відповіддю, яку перевіряє інтеграція.
Послідовність технологічних операцій на кожному верстаті залишається в SkyPlanner і передається операторам через Mobile Confirmations. Завдяки цьому інтеграція не зачіпає заблоковані в QAD технологічні маршрути запущених замовлень.
4. Підтвердження виконання в цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують розклад в актуальному стані. Ви самі обираєте, чи передавати фактичний час назад у QAD. Якщо так, час налагодження та виконання кожної технологічної операції надходить у Labor Feedback by Work Order, а виготовлені кількості — у Work Order Receipt. Якщо ні, трудовитрати, як і раніше, вносять у QAD.
5. Правила відповідальності за дані та розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, структури виробів, технологічні маршрути, кількості, статус виробничого замовлення | QAD |
| Послідовність технологічних операцій, час початку й завершення, призначення верстатів | SkyPlanner |
| Дати запуску й завершення виробничого замовлення | SkyPlanner записує, QAD зберігає |
| Матриця часу переналагодження, вимоги до інструментів і операторів, альтернативні ресурси | SkyPlanner |
| Зміни та неробочі дні | Одна система, обрана під час визначення обсягу проєкту |
| Трудовитрати, відпуск компонентів і оприбуткування | QAD: дані вводять безпосередньо або передають із записів обліку часу SkyPlanner |
Визначте одну систему, яка записуватиме дати виробничих замовлень. SkyPlanner не потребує модуля календарного планування QAD, тому для замовлень, які він планує, саме він записує дати замість робочих панелей календарного планування чи інших систем планування.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку налаштування. Перед цим перевірте розклад під час 30-денного безкоштовного пробного періоду, використовуючи робочі центри, технологічні маршрути й відкриті виробничі замовлення, експортовані з QAD у форматі CSV або Excel.
- Зіставлення даних. Узгодьте таблицю зіставлення, правила відповідальності за дані, майданчики й домени в межах проєкту, частоту синхронізації та те, чи передаватимуться трудовитрати назад у QAD.
- Доступ до QAD. Створіть користувача для інтеграції, перевірте ліцензію QXtend, налаштуйте приймач QXtend і підписника QXO. Спочатку виконайте перевірку в тестовому домені.
- Налаштування QDoc. Використовуйте готові QDoc там, де вони є, а за потреби створіть QDoc за допомогою QGen для Work Order Maintenance, Labor Feedback by Work Order і Work Order Receipt.
- Початкове завантаження. Номенклатура, структури виробів, технологічні маршрути, робочі центри, календарі.
- Синхронізація виробничих замовлень і замовлень на закупівлю. Події QXO або опитування REST API з фільтрацією, посторінковим отриманням даних і повторними спробами.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів на кожне виробниче завдання та альтернативні верстати або працівники.
- Зворотний запис розкладу й паралельне тестування. Передавайте дати за вебхуками SkyPlanner, виконуйте планування паралельно з поточним планом, порівнюйте дати та виправляйте основні дані.
- Запуск у роботу. Увімкніть зворотний запис, коли дані збігатимуться.
Що врахувати під час інтеграції з QAD Adaptive ERP
- Повторні запуски CRP. CRP переплановує всі відкриті технологічні операції вибраних виробничих замовлень. QAD зберігає дати, задані вручну, лише за умови: “you also adjusted the work order release and due date to match,” (ви також відповідно скоригували дати запуску та завершення виробничого замовлення). Саме ці дати й записує SkyPlanner. Запускайте CRP після зворотного запису або виключайте замовлення, які планує SkyPlanner.
- Після запуску технологічні маршрути фіксуються. “Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.” (Щойно виробниче замовлення набуває статусу Exploded, Allocated або Released, змінювати технологічний маршрут більше не можна.) Зчитуйте маршрут під час запуску замовлення, а змінюйте маршрути лише в планових або затверджених планових замовленнях.
- Одиниці часу в технологічному маршруті. Час налагодження та виконання враховується в завантаженні, тоді як “queue, wait, and move times are excluded from load calculations.” (час у черзі, очікування та переміщення не враховується в розрахунках завантаження). У SkyPlanner моделюйте чергу, очікування та переміщення як етапи, що враховують лише час. Перевірте також, чи задано час виконання на одиницю продукції, чи на все замовлення.
- Пропускна здатність QXtend. QAD попереджає: “UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.” (Продуктивність адаптера UI API може бути неприйнятною під час обробки великих обсягів даних або транзакцій у реальному часі.) Надсилайте пакетами лише змінені замовлення та використовуйте штатні QDocs, якщо вони доступні.
- Домени та майданчики. У багатодоменних інсталяціях QAD робочі центри й виробничі замовлення зберігаються окремо для кожного домену та майданчика. Зіставте кожен майданчик, охоплений інтеграцією, з окремою групою робочих центрів.
- Поєднання повторюваного та дискретного виробництва. Лінії Advanced Repetitive працюють за графіками повторюваного виробництва, а не за виробничими замовленнями. Під час визначення обсягу проєкту вирішіть, які лінії плануватиме SkyPlanner.
Хто налаштовує та підтримує інтеграцію з QAD
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску в межах узгоджених QDocs, підписок QXO та запитів REST. Кожне підприємство використовує QAD по-своєму, і саме тут цей досвід стає в пригоді.
- Ваш партнер QAD також може долучитися. Він знає ваші домени, доопрацювання та умови ліцензування й може разом із командою SkyPlanner налаштувати QXtend, QGen QDocs та обліковий запис користувача інтеграції.
- Ваші розробники можуть розширювати інтеграцію через REST API SkyPlanner, використовуючи токен API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Докладні інструкції наведено в документації з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць із щомісячною оплатою; у тариф включено 5 робочих центрів. Вартість інтеграції розраховують заздалегідь разом із тарифом, з урахуванням ваших процесів і потреб. Перегляньте тарифи, матеріал про планування виробництва з урахуванням реальних потужностей у QAD Adaptive ERP, сторінку QAD Adaptive ERP та розділ інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до його оптимізації в реальному часі».
Kalle Kalliomäki, фахівець із ланцюгів постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
1 000 і більше виробничих замовлень плануються автоматично
«Тепер ми по-іншому контролюємо виробництво, а наше розуміння виробничих потужностей вийшло на зовсім інший рівень».
Hannu Ryynänen, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся організація бачить стан виробництва в реальному часі.
99,2%надійність поставок
«Завдяки SkyPlanner стало легше виявляти вузькі місця, а управління виробництвом стало зрозумілішим».
Toni Tuori, керівник виробництва
Piristeel · Системи безпеки покрівлі та водостічні системи
Цього року надійність поставок досягла 99,2%, а календарне планування виробництва заощаджує до чотирьох годин робочого часу на день.
Поширені запитання
Чи є в QAD Adaptive ERP API для виробничих замовлень?
Так. QXtend Inbound викликає Work Order Maintenance та цехові програми через SOAP і XML QDocs. Якщо готового QDoc немає, його генерують за допомогою QGen. REST API бізнес-документів додатково дають змогу запитувати дані з фільтрацією та посторінковим отриманням.
Чи підтримує QAD вебхуки?
Для передавання змін у даних QAD використовує QXtend Outbound: тригери таблиць фіксують зміни, а QXO надсилає QDocs на URL вебсервісу або до каталогу, який періодично опитують. Власні вебхуки SkyPlanner надсилають зміни графіка одразу після їх внесення.
Як заплановані дати записуються назад у QAD?
Через QDoc QXtend Inbound для Work Order Maintenance (16.1), який установлює дати запуску та завершення виробничого замовлення за графіком SkyPlanner. QAD перевіряє QDoc за тими самими правилами, що й дані в екранній формі, та повертає QDoc із відповіддю.
Як підтвердження операторів надходять у QAD?
Час налагодження та виконання передається через Labor Feedback by Work Order (16.20.1), а кількість виготовленої продукції — через Work Order Receipt (16.11). В обох випадках використовуються QDocs QXtend Inbound. Рішення про зворотний запис ухвалюють під час визначення обсягу проєкту.
Що партнеру QAD варто пропонувати: QAD Advanced Scheduling чи SkyPlanner?
SkyPlanner — якщо клієнт працює з дискретними виробничими замовленнями й хоче за кілька тижнів отримати робочий графік з урахуванням реальних потужностей. QAD описує Advanced Scheduling як графік для кожної лінії кожного заводу та представляє його разом із DSCP Production Planning і Redzone (QAD). SkyPlanner підключається через QXtend, планує використання кожного верстата, оператора, інструмента та матеріалу, автоматично переплановує виробництво й не обмежує кількість користувачів. Вартість — від 199 € на місяць.
Чи можна випробувати SkyPlanner до розробки інтеграції?
Так. Безкоштовний 30-денний пробний період дає змогу працювати з максимум 20 робочими центрами та імпортувати дані з QAD у форматі CSV або Excel. Банківська картка не потрібна. Почніть пробний період або зверніться до відділу продажів, щоб визначити обсяг інтеграції.