Integracje / ERP / Oracle Fusion Cloud
Integracja Oracle Fusion Cloud — przewodnik po planowaniu produkcji z SkyPlanner APS
Ten przewodnik po integracji Oracle Fusion Cloud pokazuje partnerom i zespołom IT, jak połączyć Oracle Fusion Cloud Manufacturing z SkyPlanner APS. SkyPlanner wymienia dane z Oracle Fusion Cloud w obu kierunkach, korzystając z zasobów REST udostępnianych przez Oracle:
- Do SkyPlanner trafiają zlecenia produkcyjne wraz z operacjami, definicje pracy, gniazda produkcyjne, zasoby produkcyjne, kalendarze, pozycje asortymentowe i ich struktury, stany magazynowe oraz zamówienia zakupu.
- Planowane daty rozpoczęcia i zakończenia są zapisywane z powrotem w każdej operacji zlecenia produkcyjnego.
- Potwierdzenia operatorów są przesyłane z powrotem jako transakcje operacji i transakcje zasobów.
- Webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco.
Podczas wdrożenia zespół SkyPlanner dostosowuje integrację do konfiguracji Oracle Fusion Cloud 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 oparte na udokumentowanym REST API SkyPlanner (dokumentacja API).
Interfejsy integracyjne Oracle Fusion Cloud
Oracle Fusion Cloud udostępnia zewnętrznemu systemowi harmonogramowania trzy sposoby wymiany danych:
- REST API dla Oracle Fusion Cloud SCM. Ścieżka bazowa to
/fscmRestApi/resources/11.13.18.05/. System harmonogramowania korzysta z zasobówworkOrders(wraz z zasobami podrzędnymiWorkOrderOperation,WorkOrderOperationResourceiWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructuresiinventoryOnhandBalances. Dane o postępie prac są zapisywane woperationTransactions,resourceTransactionsimaterialTransactions. Zamówienia zakupu są pobierane zpurchaseOrdersw Procurement REST API. (Endpointy REST) - File-Based Data Import (FBDI). Proces Import Work Orders tworzy lub aktualizuje zlecenia produkcyjne wraz z operacjami i przypisanymi do nich zasobami na podstawie szablonu, a Import Work Order Resource Transactions wczytuje zapisy transakcji zasobów. Oracle jasno określa ograniczenia dotyczące czasu importu: „This option isn’t suitable for importing manufacturing data on a real-time basis.” (Ta opcja nie nadaje się do importowania danych produkcyjnych w czasie rzeczywistym). (źródło)
- Oracle Integration (OIC). Platforma integracyjna Oracle obsługuje przepływy danych między Fusion a innymi systemami. Gotowy scenariusz Oracle Integration nasłuchuje zdarzenia Work Order Status Change w Oracle Fusion Cloud Manufacturing (źródło). Skorzystaj z tego rozwiązania, jeśli Twoja firma używa już OIC.
Do bieżącego harmonogramowania służy przede wszystkim REST. FBDI sprawdza się przy pierwszym wczytywaniu danych podstawowych.
Uwierzytelnianie i dostęp
- Bezpieczeństwo Oracle REST. „Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (Interfejsy REST API Fusion Applications korzystają z globalnej polityki bezpieczeństwa Oracle Web Services Manager (OWSM) o nazwie Multi Token Over SSL RESTful Service Policy). Obsługuje ona uwierzytelnianie Basic przez SSL oraz uwierzytelnianie oparte na tokenach, takich jak token typu bearer SAML 2.0. (Szybki start)
- Użytkownik integracyjny. Utwórz w Oracle osobne konto użytkownika do integracji. Przypisz mu role nadające niezbędne uprawnienia do zleceń produkcyjnych, definicji pracy, zapasów i transakcji, ograniczając dostęp do organizacji produkcyjnych objętych zakresem integracji.
- Stronicowanie. Oracle ogranicza liczbę rekordów zwracanych przez pojedyncze wywołanie SCM REST. Pobieraj więc dane za pomocą
limitioffsetoraz filtruj je według organizacji i statusu (źródło)
Po stronie SkyPlanner REST API korzysta do uwierzytelniania z tokenu API w nagłówku Authorization-Token (SkyPlanner Settings > API). Dokumentacja jest dostępna w Swagger/OpenAPI. Samouczek integracji prowadzi przez pierwsze wywołania.
Zdarzenia i cykliczne odpytywanie
Dane z Oracle są pobierane przez cykliczne odpytywanie. Filtrowane zapytania REST pobierają nowe i zmienione zlecenia produkcyjne, zmiany statusu zwolnienia do produkcji, stany magazynowe i zamówienia zakupu. Częstotliwość ustala się dla każdego zakładu: od co kilku minut dla zleceń produkcyjnych do co godziny dla zapasów. Jeśli korzystasz z Oracle Integration, zdarzenie Work Order Status Change może wywołać natychmiastowy odczyt.
SkyPlanner wysyła webhooki po zmianie stanu lub harmonogramu, więc zapis zwrotny jest sterowany zdarzeniami.
Mapowanie danych
| Obiekt Oracle Fusion Cloud (zasób REST) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
Pozycje asortymentowe (itemsV2), jednostki miary | Produkty i materiały | Oracle → SkyPlanner | Pierwsze wczytanie, następnie cykliczne odpytywanie |
Struktury pozycji asortymentowych (itemStructures) | Struktura produktu, podprodukty, materiały przypisane do produktu | Oracle → SkyPlanner | Pierwsze wczytanie, następnie po zmianie |
Definicje pracy (workDefinitions): operacje, zasoby operacji, zużycie, Basis Type | Etapy procesu wraz z czasami trwania oraz czasami przygotowania i czynności końcowych | Oracle → SkyPlanner | Pierwsze wczytanie, następnie po zmianie |
Gniazda produkcyjne (workCenters), zasoby produkcyjne (productionResources) obejmujące maszyny i pracowników | Stanowiska robocze, grupy stanowisk roboczych, personel, wskaźniki wydajności | Oracle → SkyPlanner | Pierwsze wczytanie, później sporadycznie |
Kalendarze i zmiany robocze (calendars, wyjątki w harmonogramie zmian) | Zmiany robocze i dni wolne od pracy | Oracle → SkyPlanner | Codziennie lub własne zmiany robocze w SkyPlanner |
| Organizacje produkcyjne | Grupy stanowisk roboczych dla poszczególnych zakładów | Oracle → SkyPlanner | Pierwsze wczytanie |
Zlecenia produkcyjne (workOrders, processWorkOrders) wraz z WorkOrderOperation i WorkOrderOperationMaterial | Zlecenia i operacje wraz z terminami realizacji i zapotrzebowaniem materiałowym | Oracle → SkyPlanner | Odpytywanie co kilka minut |
Stany magazynowe (inventoryOnhandBalances) | Stany magazynowe | Oracle → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
Zamówienia zakupu (purchaseOrders) z potwierdzonymi terminami dostaw | Zamówienia zakupu, oczekiwane materiały według dat dostawy | Oracle → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Planowany początek i koniec każdej operacji | SkyPlanner → Oracle | Po zmianie harmonogramu, przez webhook SkyPlanner |
Daty WorkOrderOperationResource (PATCH) | Przypisanie zasobów do każdej operacji | SkyPlanner → Oracle | Po zmianie harmonogramu, jeśli wybrano tę opcję |
operationTransactions (POST) | Ilości wykonane w każdej operacji | SkyPlanner → Oracle | Przy każdym potwierdzeniu |
resourceTransactions (POST) | Rejestry czasu: czas pracy ludzi i maszyn | SkyPlanner → Oracle | Przy każdym potwierdzeniu lub raz na zmianę roboczą, jeśli wybrano tę opcję |
| Brak w Oracle Fusion Cloud | Macierz czasów przygotowawczych, narzędzia jako zasoby o ograniczonej dostępności, alternatywne maszyny i personel | Utrzymywane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Pierwsze wczytanie danych podstawowych. Pobierz pozycje asortymentowe, ich struktury, definicje pracy, gniazda produkcyjne, zasoby produkcyjne i kalendarze przez REST lub wczytaj je jednorazowo z eksportów FBDI. Świadomie dobierz sposób mapowania gniazd produkcyjnych: gniazdo z czterema maszynami przypisanymi do tego samego zasobu staje się jedną grupą stanowisk roboczych albo czterema stanowiskami roboczymi. Każda organizacja produkcyjna staje się grupą stanowisk roboczych, dzięki czemu wszystkie zakłady są ujęte w jednym planie.
2. Synchronizacja zleceń produkcyjnych. Odczytuj zwolnione i niezwolnione zlecenia produkcyjne wraz z operacjami i materiałami oraz otwarte zamówienia zakupu. SkyPlanner traktuje zamówiony materiał jako dostępny w dniu dostawy wskazanym w zamówieniu zakupu i aktualizuje stan magazynowy, gdy zamówienie otrzyma status Delivered.
Harmonogramuj zlecenia produkcyjne, a nie zlecenia planowane z Supply Planning. Zlecenia planowane muszą najpierw zostać przekształcone w zlecenia produkcyjne w Oracle.
3. Zapis harmonogramu w Oracle. Gdy silnik umieszcza operację w harmonogramie lub ją przesuwa, webhook SkyPlanner wywołuje PATCH na workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} z polami PlannedStartDate i PlannedCompletionDate. Obowiązuje reguła 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.” (Planowana data rozpoczęcia nie może przypadać przed datą rozpoczęcia zlecenia produkcyjnego ani po dacie jego zakończenia.) (źródło) Dlatego gdy nowy harmonogram wykracza poza te daty, integracja najpierw aktualizuje daty w nagłówku zlecenia produkcyjnego, a następnie daty operacji.
4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer, a wpisy czasu pracy zapewniają aktualność harmonogramu. Wykonane ilości trafiają do operationTransactions, a czas pracy ludzi i maszyn do resourceTransactions. Jeśli zakład już raportuje postępy w Oracle, SkyPlanner odczytuje je z tego systemu.
5. Odpowiedzialność za dane i zasady rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Pozycje, struktury pozycji, definicje pracy, ilości, status zlecenia produkcyjnego | Oracle Fusion Cloud |
| Kolejność operacji, terminy rozpoczęcia i zakończenia, przydział zasobów produkcyjnych | SkyPlanner |
| Macierz czasów przygotowawczych, wymagania dotyczące narzędzi i operatorów, alternatywne zasoby produkcyjne | SkyPlanner |
| Zmiany robocze i dni wolne od pracy | Jeden system, wybrany podczas określania zakresu |
| Transakcje dotyczące zasobów produkcyjnych, operacji i materiałów | Oracle — dane wprowadzane bezpośrednio lub przesyłane z rejestrów czasu pracy SkyPlanner |
Wybierz jeden system zapisujący daty operacji. SkyPlanner nie wymaga obszaru roboczego harmonogramowania w Oracle, dlatego zastępuje Production Scheduling jako system zapisujący planowane daty. Jeśli Production Scheduling nadal publikuje harmonogramy, przypisz mu inne organizacje niż te, dla których harmonogramy tworzy SkyPlanner.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od rozpoczęcia onboardingu, nawet w dużych firmach. Wcześniej zweryfikuj harmonogram w ramach 30-dniowego bezpłatnego okresu próbnego, korzystając z gniazd produkcyjnych, definicji produkcji i otwartych zleceń produkcyjnych wyeksportowanych z Oracle do plików CSV lub Excel.
- Mapowanie. Ustal tabelę mapowania, zasady odpowiedzialności za dane, organizacje objęte zakresem, częstotliwość synchronizacji oraz to, czy transakcje mają być zapisywane z powrotem w Oracle.
- Dostęp do Oracle. Utwórz użytkownika integracyjnego i role. Najpierw przeprowadź testy w nieprodukcyjnym środowisku Oracle.
- Początkowe ładowanie danych. Indeksy, struktury indeksów, definicje produkcji, gniazda produkcyjne, zasoby produkcyjne, kalendarze.
- Synchronizacja zleceń produkcyjnych i zamówień zakupu. Cykliczne odpytywanie z filtrowaniem, stronicowaniem i ponawianiem prób.
- Konfiguracja ograniczeń w SkyPlanner. Macierz czasów przygotowawczych, narzędzia, liczba operatorów na operację oraz alternatywne maszyny lub pracownicy.
- Zapis harmonogramu w Oracle. Żądania PATCH wyzwalane przez webhooki SkyPlanner oraz transakcje, jeśli uwzględniono je w zakresie.
- Testy równoległe. Twórz harmonogram w SkyPlanner równolegle z bieżącym planem, porównaj daty i popraw dane podstawowe.
- Uruchomienie produkcyjne. Gdy dane będą zgodne, włączaj zapis do Oracle kolejno w poszczególnych zakładach.
Co uwzględnić przy integracji z Oracle Fusion Cloud
- Domyślne działanie harmonogramowania. Silnik Oracle nieuwzględniający ograniczeń uruchamia się przy tworzeniu oraz przy „certain update actions.” (określonych działaniach aktualizacyjnych). Sprawdź w swoim środowisku, które aktualizacje powodują ponowne przeliczenie dat, i zadbaj, aby SkyPlanner zapisywał daty operacji jako ostatni.
- Ramy czasowe zleceń produkcyjnych. Daty operacji muszą mieścić się między datą rozpoczęcia a datą zakończenia zlecenia produkcyjnego. Najpierw zaktualizuj nagłówek.
- Basis Type. Zużycie zasobu jest określane na jednostkę tylko wtedy, gdy Basis Type ma wartość Variable. Wartość Fixed oznacza stały czas na operację. Przelicz te wartości podczas importu, inaczej wszystkie czasy trwania będą błędne.
- Produkcja dyskretna i procesowa. Zakłady z produkcją dyskretną korzystają z
workOrders, a zakłady z produkcją procesową zprocessWorkOrders. Jeśli prowadzisz oba rodzaje produkcji, zmapuj oba zasoby. - Stronicowanie. Oracle ogranicza liczbę rekordów zwracanych w jednym wywołaniu REST. Stosuj stronicowanie w każdym zapytaniu i filtruj według organizacji oraz statusu.
- Aktualizacje kwartalne. Oracle aktualizuje Fusion co kwartał. Wskaż na stałe wersję REST w ścieżce i ponawiaj testy po każdej aktualizacji.
- Reguły dotyczące statusów. Zlecenia produkcyjne ze statusem Pending Approval lub zamknięte nie powinny otrzymywać nowych dat. Wyklucz je za pomocą filtrów przy odczycie.
Kto konfiguruje i wspiera integrację z Oracle Fusion Cloud
- Zespół SkyPlanner konfiguruje integrację podczas onboardingu i zapewnia wsparcie po uruchomieniu produkcyjnym, w zakresie uzgodnionych zasobów REST i organizacji. Każdy zakład korzysta z Oracle Fusion Cloud inaczej — tę wiedzę uwzględniamy w konfiguracji.
- Twój partner Oracle może uczestniczyć w projekcie. Zna Twoje organizacje, role i rozszerzenia, więc może wspólnie z zespołem SkyPlanner skonfigurować użytkownika integracyjnego, role oraz potrzebne przepływy Oracle Integration.
- Twoi programiści mogą rozbudowywać integrację, korzystając z REST API SkyPlanner i tokenu API. Do rozpoczęcia pracy wystarczy token API, a zespół SkyPlanner pomaga w razie potrzeby. Dokumentację znajdziesz na stronie dokumentacji integracji SkyPlanner.
Cena SkyPlanner zaczyna się od 199 € miesięcznie i obejmuje 5 stanowisk roboczych, z rozliczeniem co miesiąc. Integrację wyceniamy z góry wraz z wybranym planem, zgodnie z Twoim procesem i potrzebami. Zobacz cennik, harmonogramowanie produkcji z Oracle Fusion Cloud, stronę Oracle Fusion Cloud oraz centrum integracji ERP. Korzystasz z NetSuite? Zobacz przewodnik po integracji z NetSuite.
Opinie firm produkcyjnych o SkyPlanner
2 hoszczędności tygodniowo
„Dzięki SkyPlanner przeszliśmy od planowania produkcji w arkuszach Excel do optymalizacji produkcji 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 zadań trafia na linię w kilka sekund.
+90%wydajności produkcji
„Wydajność produkcji wzrosła o 90%.”
Abdul Rucyinga, dyrektor 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.
99,2%terminowości dostaw
„SkyPlanner ułatwił identyfikację wąskich gardeł i uporządkował zarządzanie produkcją.”
Toni Tuori, kierownik produkcji
Piristeel · Systemy bezpieczeństwa dachowego i systemy rynnowe
Terminowość dostaw osiągnęła w tym roku 99,2%, a harmonogramowanie pozwala zaoszczędzić do czterech godzin pracy dziennie.
1 000+zleceń produkcyjnych harmonogramowanych automatycznie
„Mamy teraz zupełnie inną kontrolę nad produkcją, a nasza wiedza o zdolnościach produkcyjnych jest na całkiem innym poziomie.”
Hannu Ryynänen, prezes
Mamec · Mieszalniki przemysłowe, pompy i zaawansowana technologicznie produkcja kontraktowa
Tysiące zleceń produkcyjnych są harmonogramowane automatycznie, a cała organizacja ma wgląd w produkcję w czasie rzeczywistym.
Najczęściej zadawane pytania
Czy Oracle Fusion Cloud udostępnia API do zleceń produkcyjnych?
Tak. REST API Oracle Fusion Cloud SCM udostępnia workOrders z zasobami podrzędnymi dla operacji, zasobów produkcyjnych i materiałów, a także processWorkOrders dla produkcji procesowej. Obsługuje metody GET, POST i PATCH.
Jak planowane daty są zapisywane z powrotem w Oracle Fusion Cloud?
Za pomocą żądania PATCH do zasobu podrzędnego WorkOrderOperation zlecenia produkcyjnego, które ustawia PlannedStartDate i PlannedCompletionDate. Daty operacji muszą mieścić się w ramach czasowych zlecenia produkcyjnego, dlatego w razie potrzeby najpierw aktualizowany jest nagłówek.
Jak potwierdzenia operatorów trafiają do Oracle?
Wykonane ilości trafiają do operationTransactions, a czas pracy ludzi i maszyn do resourceTransactions. Oba zasoby w Fusion Manufacturing obsługują metodę REST POST.
Czy Oracle Fusion Cloud obsługuje webhooki?
Fusion publikuje zdarzenia biznesowe, takie jak Work Order Status Change, które można subskrybować w Oracle Integration. Bez Oracle Integration integracja odpytuje REST API z częstotliwością ustaloną dla każdego zakładu. Webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco.
Co partner Oracle powinien zaproponować: Oracle Production Scheduling czy SkyPlanner?
SkyPlanner, jeśli klient potrzebuje jednego, samoczynnie aktualizowanego harmonogramu dla wielu zakładów, uwzględniającego dostępne zdolności produkcyjne. Production Scheduling włącza się w ramach oferty Supply Chain Planning. Tworzy harmonogram oddzielnie dla każdej organizacji planowania, a reguły przezbrojeń stosuje tylko do urządzeń obsługujących jedną jednostkę naraz (dokumentacja Oracle). SkyPlanner łączy się przez SCM REST API, automatycznie aktualizuje plan i uwzględnia przezbrojenia, narzędzia, zespoły pracowników oraz materiały. Jest dostępny od 199 € miesięcznie, bez limitu użytkowników.
Czy możemy przetestować SkyPlanner przed zbudowaniem integracji?
Tak. Bezpłatna 30-dniowa wersja próbna obsługuje do 20 stanowisk roboczych i umożliwia import danych z Oracle w formacie CSV lub Excel. Nie wymaga karty kredytowej. Rozpocznij okres próbny lub porozmawiaj z działem sprzedaży, aby określić zakres integracji.
