Інтеграції / ERP / Oracle Fusion Cloud
Посібник з інтеграції Oracle Fusion Cloud зі SkyPlanner APS для календарного планування виробництва
Цей посібник пояснює партнерам та ІТ-командам, як підключити Oracle Fusion Cloud Manufacturing до SkyPlanner APS. SkyPlanner обмінюється даними з Oracle Fusion Cloud в обох напрямках через власні REST-ресурси Oracle:
- До SkyPlanner надходять виробничі замовлення та їхні технологічні операції, визначення виробничих процесів, робочі центри, виробничі ресурси, календарі, номенклатура, структури виробів, наявні залишки та замовлення на закупівлю.
- Планові дати початку й завершення передаються назад для кожної технологічної операції виробничого замовлення.
- Підтвердження операторів передаються назад як транзакції технологічних операцій і ресурсів.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Oracle Fusion Cloud, а після запуску в експлуатацію підтримує її. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до інтеграції або самостійно розробляти рішення на основі документованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції Oracle Fusion Cloud
Oracle Fusion Cloud пропонує зовнішній системі календарного планування три способи обміну даними:
- REST API для Oracle Fusion Cloud SCM. Базовий шлях —
/fscmRestApi/resources/11.13.18.05/. Система календарного планування використовує ресурсиworkOrders(з дочірніми ресурсамиWorkOrderOperation,WorkOrderOperationResourceіWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructuresтаinventoryOnhandBalances. Дані про хід виконання передаються доoperationTransactions,resourceTransactionsіmaterialTransactions. Замовлення на закупівлю надходять ізpurchaseOrdersчерез Procurement REST API. (Кінцеві точки REST) - File-Based Data Import (FBDI). Процес Import Work Orders створює або оновлює виробничі замовлення разом із технологічними операціями та їхніми ресурсами на основі шаблону, а Import Work Order Resource Transactions завантажує записи про використання ресурсів. Oracle чітко визначає обмеження щодо оперативності: “This option isn’t suitable for importing manufacturing data on a real-time basis.” (Цей варіант не підходить для імпорту виробничих даних у реальному часі.) (Джерело)
- Oracle Integration (OIC). Інтеграційна платформа Oracle забезпечує потоки даних між Fusion та іншими системами. Готовий сценарій Oracle Integration відстежує подію Work Order Status Change в Oracle Fusion Cloud Manufacturing (джерело). Використовуйте цей варіант, якщо ваша компанія вже працює з OIC.
Для календарного планування в реальному часі основним способом обміну є REST. FBDI підходить для початкового завантаження основних даних.
Автентифікація та доступ
- Безпека Oracle REST. “Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (REST API Fusion Applications використовують глобальну політику безпеки Oracle Web Services Manager (OWSM) під назвою Multi Token Over SSL RESTful Service Policy.) Вона підтримує автентифікацію Basic через SSL та автентифікацію на основі токенів, зокрема токена пред’явника SAML 2.0. (Швидкий старт)
- Користувач для інтеграції. Створіть в Oracle окремого користувача для інтеграції. Призначте йому посадові ролі з потрібними правами доступу до виробничих замовлень, визначень виробничих процесів, запасів і транзакцій. Обмежте доступ виробничими організаціями, які входять до обсягу проєкту.
- Посторінкове отримання даних. Oracle обмежує кількість записів, які повертає один виклик SCM REST. Тому зчитуйте дані з параметрами
limitіoffsetта фільтруйте їх за організацією і статусом (джерело)
На боці SkyPlanner REST API використовує для автентифікації токен API в заголовку Authorization-Token (SkyPlanner Settings > API). Документацію наведено у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково описано перші виклики.
Події та періодичне опитування
Дані з Oracle отримуються шляхом періодичного опитування. REST-запити з фільтрами зчитують нові та змінені виробничі замовлення, переходи до статусу випуску у виробництво, наявні залишки й замовлення на закупівлю. Частоту налаштовують окремо для кожного заводу: від кількох хвилин для виробничих замовлень до години для запасів. Якщо ви використовуєте Oracle Integration, подія Work Order Status Change може запускати негайне зчитування.
SkyPlanner надсилає вебхуки, коли змінюється стан або розклад, тому зворотний запис даних запускається подіями.
Зіставлення даних
| Об’єкт Oracle Fusion Cloud (REST-ресурс) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Номенклатура (itemsV2), одиниці виміру | Продукція та матеріали | Oracle → SkyPlanner | Початкове завантаження, далі — періодичне опитування |
Структури виробів (itemStructures) | Структура виробу, складові вироби, матеріали для кожного виробу | Oracle → SkyPlanner | Початкове завантаження, далі — у разі змін |
Визначення виробничих процесів (workDefinitions): технологічні операції, їхні ресурси, норми використання, Basis Type | Етапи процесу із зазначенням тривалості, підготовчого та завершального часу | Oracle → SkyPlanner | Початкове завантаження, далі — у разі змін |
Робочі центри (workCenters), виробничі ресурси (productionResources) для обладнання та персоналу | Робочі центри, групи робочих центрів, персонал, коефіцієнти ефективності | Oracle → SkyPlanner | Початкове завантаження, надалі — зрідка |
Календарі та зміни (calendars, винятки для змін) | Зміни та неробочі дні | Oracle → SkyPlanner | Щодня або окреме ведення змін у SkyPlanner |
| Виробничі організації | Групи робочих центрів для кожного заводу | Oracle → SkyPlanner | Початкове завантаження |
Виробничі замовлення (workOrders, processWorkOrders) з WorkOrderOperation та WorkOrderOperationMaterial | Замовлення та виробничі завдання з термінами виконання й потребами в матеріалах | Oracle → SkyPlanner | Опитування кожні кілька хвилин |
Наявні залишки (inventoryOnhandBalances) | Складські залишки | Oracle → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
Замовлення на закупівлю (purchaseOrders) з обіцяними датами поставки | Замовлення на закупівлю, очікувані матеріали за датами поставки | Oracle → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Планові початок і завершення кожного виробничого завдання | SkyPlanner → Oracle | У разі зміни розкладу, через вебхук SkyPlanner |
Дати WorkOrderOperationResource (PATCH) | Призначення виробничих ресурсів для кожного завдання | SkyPlanner → Oracle | У разі зміни розкладу, якщо вибрано цей варіант |
operationTransactions (POST) | Виконана кількість за кожною технологічною операцією | SkyPlanner → Oracle | Після кожного підтвердження |
resourceTransactions (POST) | Записи обліку часу: робочий час персоналу та машинний час | SkyPlanner → Oracle | Після кожного підтвердження або за кожну зміну, якщо вибрано цей варіант |
| Відсутні в Oracle Fusion Cloud | Матриця часу переналагодження, інструменти як виробничі ресурси з обмеженою доступністю, альтернативне обладнання та персонал | Ведуться в SkyPlanner | Налаштовуються під час впровадження |
Сценарії інтеграції
1. Початкове завантаження основних даних. Зчитайте номенклатуру, структури виробів, визначення виробничих процесів, робочі центри, виробничі ресурси й календарі через REST або одноразово завантажте їх із вивантажень FBDI. Продумайте зіставлення робочих центрів: робочому центру з чотирма верстатами, що належать до одного виробничого ресурсу, відповідатиме одна група робочих центрів або чотири робочі центри. Кожна виробнича організація стає групою робочих центрів, тож усі заводи потрапляють до єдиного плану.
2. Синхронізація виробничих замовлень. Зчитайте випущені й невипущені у виробництво замовлення з їхніми технологічними операціями та матеріалами, а також відкриті замовлення на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки за замовленням на закупівлю та оновлює залишки, коли це замовлення отримує статус Delivered.
Включайте до розкладу виробничі замовлення, а не планові замовлення Supply Planning. Спочатку планові замовлення мають стати виробничими замовленнями в Oracle.
3. Зворотний запис розкладу. Коли алгоритм розміщує або переміщує виробниче завдання, вебхук SkyPlanner запускає запит PATCH до workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} з полями PlannedStartDate і PlannedCompletionDate. Діє правило Oracle: “The planned start date must not occur before the start date of the work order or after the finish date of the work order.” (Планова дата початку не може бути ранішою за дату початку виробничого замовлення або пізнішою за дату його завершення.) (Джерело) Тому, якщо новий розклад виходить за ці межі, інтеграція спочатку оновлює дати в заголовку виробничого замовлення, а потім — у технологічних операціях.
4. Підтвердження з цеху. Оператори реєструють виконану роботу за допомогою SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують розклад в актуальному стані. Виконана кількість передається до operationTransactions, а робочий час персоналу та машинний час — до resourceTransactions. Якщо ваш завод уже звітує в Oracle, SkyPlanner натомість зчитує звідти дані про хід виконання.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, структури виробів, визначення виробничих процесів, кількості, статус виробничого замовлення | Oracle Fusion Cloud |
| Послідовність технологічних операцій, час початку й завершення, призначення виробничих ресурсів | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів та операторів, альтернативні виробничі ресурси | SkyPlanner |
| Зміни та неробочі дні | Одна система, обрана під час визначення обсягу проєкту |
| Транзакції ресурсів, технологічних операцій і матеріалів | Oracle: дані вводяться безпосередньо або передаються із записів обліку часу SkyPlanner |
Визначте одну систему, яка записуватиме дати технологічних операцій. SkyPlanner не потребує робочої області календарного планування Oracle, тому саме він записуватиме планові дати замість Production Scheduling. Якщо Production Scheduling і далі публікує графіки, не використовуйте його для тих організацій, які планує SkyPlanner.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку підключення, навіть у великих компаніях. Перед цим перевірте графік протягом 30-денного безкоштовного пробного періоду, використовуючи робочі центри, визначення виробничих процесів і відкриті виробничі замовлення, експортовані з Oracle у форматі CSV або Excel.
- Зіставлення даних. Узгодьте таблицю зіставлення, правила відповідальності за дані, перелік охоплених організацій, частоту синхронізації та потребу в передаванні транзакцій назад.
- Доступ до Oracle. Створіть користувача та ролі для інтеграції. Спочатку проведіть тестування в непродуктивному середовищі Oracle.
- Початкове завантаження. Номенклатура, структури виробів, визначення виробничих процесів, робочі центри, виробничі ресурси, календарі.
- Синхронізація виробничих замовлень і замовлень на закупівлю. Налаштуйте періодичне опитування з фільтрами, посторінковим отриманням даних і повторними спробами.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні верстати або працівники.
- Запис графіка назад до Oracle. Виконуйте PATCH за подіями вебхуків SkyPlanner, а також передавайте транзакції, якщо це передбачено.
- Паралельне тестування. Використовуйте SkyPlanner паралельно з поточним планом, порівнюйте дати та виправляйте основні дані.
- Запуск в експлуатацію. Коли дані збігатимуться, вмикайте зворотний запис почергово для кожного заводу.
Що врахувати під час інтеграції з Oracle Fusion Cloud
- Стандартна поведінка планувальника. Механізм Oracle, який не враховує обмежень потужності, запускається під час створення та «certain update actions» (певних дій оновлення). Перевірте у своєму середовищі, які оновлення спричиняють перерахунок дат, і забезпечте, щоб SkyPlanner записував дати технологічних операцій останнім.
- Часові межі виробничих замовлень. Дати технологічних операцій мають бути в межах дат початку й завершення виробничого замовлення. Спочатку оновіть заголовок через PATCH.
- Basis Type. Використання ресурсу задається на одиницю продукції лише тоді, коли Basis Type має значення Variable. Значення Fixed означає фіксований час на технологічну операцію. Виконуйте перерахунок під час імпорту, інакше всі значення тривалості будуть неправильними.
- Дискретне та процесне виробництво. Заводи з дискретним виробництвом використовують
workOrders, а з процесним —processWorkOrders. Якщо у вас є обидва типи виробництва, налаштуйте зіставлення для обох. - Посторінкове отримання даних. Oracle обмежує кількість записів на один REST-виклик. Отримуйте результати кожного запиту посторінково та фільтруйте їх за організацією і статусом.
- Щоквартальні оновлення. Oracle оновлює Fusion щокварталу. Зафіксуйте версію REST у шляху та повторюйте тестування після кожного оновлення.
- Правила для статусів. Виробничим замовленням зі статусом Pending Approval або закритим замовленням не слід призначати нові дати. Відфільтровуйте їх під час читання даних.
Хто налаштовує та підтримує інтеграцію з Oracle Fusion Cloud
- Команда SkyPlanner налаштовує інтеграцію під час підключення та підтримує її після запуску в межах узгоджених REST-ресурсів і організацій. Кожен завод використовує Oracle Fusion Cloud по-своєму, і під час налаштування цей досвід враховується.
- Ваш партнер Oracle може долучитися. Він знає ваші організації, ролі та розширення й разом із командою SkyPlanner може налаштувати користувача інтеграції, ролі та потрібні потоки Oracle Integration.
- Ваші розробники можуть розширювати інтеграцію через REST API SkyPlanner, використовуючи API-токен. Для початку достатньо API-токена, а команда SkyPlanner допоможе за потреби. Докладніше — у документації з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць за щомісячної оплати, з 5 робочими центрами в комплекті. Вартість інтеграції розраховується заздалегідь разом із вашим тарифним планом з урахуванням ваших процесів і потреб. Перегляньте ціни, сторінку про планування виробництва з урахуванням реальних потужностей обладнання та персоналу для Oracle Fusion Cloud, сторінку Oracle Fusion Cloud та розділ інтеграцій з ERP. Працюєте з NetSuite? Перегляньте посібник з інтеграції NetSuite.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до його оптимізації в реальному часі».
Калле Калліомякі, фахівець із ланцюгів постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Абдул Русіїнга, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
99,2%надійності поставок
«SkyPlanner допоміг нам бачити вузькі місця та зробив управління виробництвом зрозумілішим».
Тоні Туорі, керівник виробництва
Piristeel · Системи безпеки для покрівель і водостічні системи
Цього року надійність поставок досягла 99,2%, а календарне планування заощаджує до чотирьох годин робочого часу на день.
Понад 1 000 виробничих замовлень плануються автоматично
«Ми тепер зовсім інакше контролюємо виробництво, а наше розуміння потужностей вийшло на цілком інший рівень».
Ганну Рююнянен, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся організація бачить стан виробництва в реальному часі.
Поширені запитання
Чи є в Oracle Fusion Cloud API для виробничих замовлень?
Так. REST API Oracle Fusion Cloud SCM містить workOrders із дочірніми об’єктами технологічних операцій, ресурсів і матеріалів, а також processWorkOrders для процесного виробництва. Підтримуються GET, POST і PATCH.
Як планові дати записуються назад до Oracle Fusion Cloud?
За допомогою запиту PATCH до дочірнього об’єкта WorkOrderOperation виробничого замовлення, який задає значення PlannedStartDate і PlannedCompletionDate. Дати технологічних операцій мають залишатися в межах дат виробничого замовлення, тому за потреби спочатку оновлюється заголовок через PATCH.
Як підтвердження від операторів надходять до Oracle?
Кількість виготовленої продукції передається до operationTransactions, а робочий і машинний час — до resourceTransactions. Обидва ресурси підтримують REST POST у Fusion Manufacturing.
Чи підтримує Oracle Fusion Cloud вебхуки?
Fusion публікує бізнес-події, як-от Work Order Status Change, на які може підписуватися Oracle Integration. Без Oracle Integration інтеграція опитує REST API за розкладом, установленим для кожного заводу. Власні вебхуки SkyPlanner передають зміни графіка відразу, щойно вони відбуваються.
Що партнеру Oracle варто запропонувати: Oracle Production Scheduling чи SkyPlanner?
SkyPlanner — якщо клієнту потрібен єдиний графік для всіх заводів, який враховує реальні виробничі потужності й автоматично підтримується в актуальному стані. Production Scheduling вмикається в складі Supply Chain Planning, розраховує графік окремо для кожної організації планування та застосовує правила переналагодження лише до обладнання типу single-unit (документація Oracle). SkyPlanner підключається через SCM REST API, автоматично переплановує, враховує переналагодження, інструменти, бригади та матеріали й не обмежує кількість користувачів — від 199 € на місяць.
Чи можна випробувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати дані з Oracle у форматі CSV або Excel. Кредитна картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
