Integracje / ERP / SAP Business ByDesign
Przewodnik po integracji SAP Business ByDesign — planowanie produkcji ze SkyPlanner APS
Ten przewodnik po integracji SAP Business ByDesign pokazuje partnerom i zespołom IT, jak połączyć ByDesign ze SkyPlanner APS. Integracja SkyPlanner z ByDesign działa w obu kierunkach i korzysta z udostępnionych przez SAP usług sieciowych:
- Do SkyPlanner trafiają zwolnione zlecenia produkcyjne wraz z operacjami, Production Models, Bills of Material i Bills of Operations, zasoby maszynowe i pracownicze, materiały, stany magazynowe oraz zamówienia zakupu.
- Do ByDesign wracają planowany termin rozpoczęcia każdego zlecenia produkcyjnego oraz główny zasób każdej operacji.
- Potwierdzone ilości, braki i zakończone zadania mogą być zapisywane zwrotnie w partiach produkcyjnych.
- Webhooki SkyPlanner przesyłają zmiany w harmonogramie na bieżąco.
Podczas wdrożenia zespół SkyPlanner konfiguruje przez REST API integrację z Twoją instancją ByDesign 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 SAP ByDesign
Dla każdej wersji ByDesign publikuje udostępnione usługi sieciowe A2X SOAP na liście API usług sieciowych. Integracja służąca do harmonogramowania produkcji korzysta z następujących usług:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER zwraca żądane, najwcześniejsze i najpóźniejsze terminy rozpoczęcia i zakończenia, zasoby wraz z planowanym i rzeczywistym czasem trwania, priorytet, status realizacji oraz status harmonogramowania. MAINTAIN_BUNDLE_V2 aktualizuje EarliestStartPeriod lub LatestEndPeriod oraz MainResourceID operacji (pomoc SAP).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle tworzy lub aktualizuje zadania produkcyjne. Obsługuje potwierdzoną ilość, braki i znacznik zakończenia potwierdzania dla każdego punktu raportowania, zakończenie zadania wraz z danymi pracownika wykonującego zadanie i czasem wykonania oraz wykorzystanie zasobów (pomoc SAP).
- Usługi Query. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (również według zasobu), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks oraz Determine Availability of Products.
- OData. Własne usługi OData dla obiektów biznesowych oraz OData dla źródeł danych i raportów analitycznych. SAP podaje, że firmy decydują o udostępnianych obiektach biznesowych: „companies are fully empowered to decide which business objects” (firmy mają pełną swobodę decydowania, które obiekty biznesowe udostępnić) (scenariusze integracji SAP).
Do odczytu używaj usług Query lub OData, a do każdego zapisu — odpowiedniej z dwóch usług Manage.
Uwierzytelnianie i licencjonowanie
Po stronie ByDesign utwórz system komunikacyjny dla SkyPlanner oraz konfigurację komunikacji dla używanych usług. Każda konfiguracja ma własnego użytkownika technicznego. Przewodnik bezpieczeństwa SAP opisuje uwierzytelnianie integracji aplikacji za pomocą „user ID plus password, and the X.509 client certificate” (identyfikatora użytkownika z hasłem oraz certyfikatu klienta) (przewodnik bezpieczeństwa). Dla OData można skonfigurować OAuth 2.0. Plik WSDL każdej usługi pobierzesz z konfiguracji komunikacji lub z Service Explorer.
Po stronie SkyPlanner każde wywołanie zawiera token API w nagłówku Authorization-Token. Token utworzysz w SkyPlanner w sekcji Settings > API. Sam token API wystarczy, aby rozpocząć prace nad integracją.
Zdarzenia i cykliczne odpytywanie
SkyPlanner wysyła webhook przy każdej zmianie harmonogramu, dzięki czemu zapis zwrotny do ByDesign odbywa się na bieżąco wraz ze zmianami planu.
Aby wykrywać zmiany w ByDesign, cyklicznie odpytuj usługi Query. Zwolnione zlecenia produkcyjne i partie produkcyjne odczytuj co kilka minut, a materiały, stany magazynowe i zamówienia zakupu — rzadziej. Wyniki zapytań są stronicowane przy użyciu QueryHitsMaximumNumberValue i LastReturnedObjectID. Domyślny rozmiar strony SAP opisuje na stronie poświęconej usługom sieciowym.
Mapowanie danych
| Obiekt ByDesign (interfejs) | Obiekt w SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
| Materiały (Query Materials) | Produkty i materiały | ByDesign → SkyPlanner | Import początkowy, następnie cykliczne odpytywanie |
| Production Bill of Material (Query Production Bill of Materials) | Struktura produktu, materiały przypisane do produktu | ByDesign → SkyPlanner | Wczytanie początkowe, następnie po zmianach |
| Production Bill of Operations: operacje, czynności Setup, Produce i Tear down (Query Production Bill of Operations) | Etapy procesu wraz z czasem trwania oraz czasem czynności przygotowawczych i końcowych | ByDesign → SkyPlanner | Import początkowy, następnie po zmianie |
| Production Model (Query Production Model) | Marszruta technologiczna produktu dla danego zakładu | ByDesign → SkyPlanner | Import początkowy, następnie po zmianie |
| Zasoby maszynowe i grupy zasobów (Read Equipment Resources) | Stanowiska robocze, grupy stanowisk roboczych, narzędzia | ByDesign → SkyPlanner | Import początkowy, później sporadycznie |
| Zasoby pracownicze, godziny pracy (Query Labour Resource) | Personel i zmiany robocze | ByDesign → SkyPlanner | Codziennie lub definiowanie zmian roboczych bezpośrednio w SkyPlanner |
| Zwolnione zlecenia produkcyjne i operacje (Query Production Orders, READ_PROD_ORDER) | Zlecenia i operacje wraz z terminami realizacji i zapotrzebowaniem materiałowym | ByDesign → SkyPlanner | Odpytywanie co kilka minut |
| Partie produkcyjne i zadania (Query Production Lots) | Postęp realizacji operacji | ByDesign → SkyPlanner | Odpytywanie co kilka minut |
| Zidentyfikowane zapasy, dostępność produktów (Query Identified Stocks, Determine Availability of Products) | Stany magazynowe | ByDesign → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Zamówienia zakupu (Query Purchase Orders) | Zamówienia zakupu, oczekiwane dostawy materiałów według daty dostawy | ByDesign → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| EarliestStartPeriod, MainResourceID operacji (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Planowany termin rozpoczęcia, przypisane stanowisko robocze | SkyPlanner → ByDesign | Po zmianie harmonogramu, przez webhook SkyPlanner |
| Potwierdzona ilość, braki, zakończenie zadania (Manage Production Lots, MaintainBundle) | Rejestry czasu pracy i potwierdzenia operatorów | SkyPlanner → ByDesign | Przy każdym potwierdzeniu lub raz na zmianę roboczą, jeśli wybrano tę opcję |
| Brak w ByDesign | Macierz czasów przygotowawczo-zakończeniowych, wymagania dotyczące wielu operatorów, alternatywne maszyny i personel | Utrzymywane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Odczytaj materiały, Production Models, Bills of Material i Bills of Operations oraz zasoby maszynowe i pracownicze. Świadomie określ mapowanie zasobów: grupa zasobów obejmująca cztery maszyny staje się jedną grupą stanowisk roboczych lub czterema stanowiskami roboczymi. Zasoby sprzętowe będące narzędziami stają się w SkyPlanner narzędziami o ograniczonej dostępności.
2. Synchronizacja zleceń produkcyjnych. Odczytaj zwolnione 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. Propozycje produkcji pozostają w ByDesign Supply Planning, dopóki nie staną się zleceniami produkcyjnymi.
3. Zapis zwrotny harmonogramu. Gdy silnik umieszcza zlecenie w harmonogramie lub je przesuwa, webhook SkyPlanner wywołuje MAINTAIN_BUNDLE_V2 w usłudze Manage Production Orders. Ustawia EarliestStartPeriod oraz MainResourceID operacji wybranej przez SkyPlanner.
4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer, a rejestry czasu pracy pozwalają utrzymywać aktualny harmonogram. To Ty decydujesz, czy dane rzeczywiste są zapisywane zwrotnie. Jeśli tak, MaintainBundle w usłudze Manage Production Lots zapisuje potwierdzoną ilość, braki i zakończone zadanie wraz z danymi pracownika, który je wykonał. Jeśli nie, potwierdzenia są wprowadzane w ByDesign tak jak dotychczas.
5. Odpowiedzialność za dane i zasady rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Materiały, Production Models, ilości, status zlecenia i partii | ByDesign |
| Kolejność operacji, terminy rozpoczęcia i zakończenia, przydział zasobów | SkyPlanner |
| Macierz czasów przygotowawczo-zakończeniowych, wymagania dotyczące narzędzi i operatorów, zasoby alternatywne | SkyPlanner |
| Zmiany i dni wolne od pracy | Jeden system, wybrany podczas określania zakresu |
| Potwierdzenia, ruchy materiałowe, kalkulacja kosztów | ByDesign — dane wprowadzane bezpośrednio lub przesyłane z rejestrów czasu pracy SkyPlanner |
Wybierz jeden system odpowiedzialny za zapis terminów zleceń. Nie uruchamiaj Load Leveling dla zasobów, które harmonogramuje SkyPlanner, i sprawdź, czy przebieg planowania nie przesuwa zwolnionych zleceń zarządzanych przez SkyPlanner.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od rozpoczęcia prac. Wcześniej zweryfikuj harmonogram podczas 30-dniowego bezpłatnego okresu próbnego, korzystając z zasobów, Bills of Operations i otwartych zleceń produkcyjnych wyeksportowanych z ByDesign do plików CSV lub Excel.
- Mapowanie. Ustal tabelę mapowania, zasady odpowiedzialności za dane, częstotliwość synchronizacji oraz to, czy potwierdzenia będą zapisywane zwrotnie.
- Dostęp do ByDesign. Utwórz system komunikacyjny i konfiguracje komunikacji oraz pobierz pliki WSDL. Najpierw przeprowadź testy w testowej instancji ByDesign.
- Import początkowy. Materiały, Production Models, Bills of Material i Bills of Operations, zasoby, godziny pracy.
- Synchronizacja zleceń i zamówień zakupu. Cykliczne odpytywanie ze stronicowaniem, filtrami i ponawianiem prób.
- Konfiguracja ograniczeń w SkyPlanner. Macierz czasów przygotowawczo-zakończeniowych, narzędzia, liczba operatorów na operację oraz alternatywne maszyny lub pracownicy.
- Zapis harmonogramu w ByDesign. Wywołania MAINTAIN_BUNDLE_V2 uruchamiane przez webhooki SkyPlanner oraz, opcjonalnie, potwierdzenia partii produkcyjnych.
- Testy równoległe. Uruchom SkyPlanner równolegle z bieżącym planem, porównaj terminy i popraw dane podstawowe.
- Uruchomienie produkcyjne. Włącz zapis zwrotny, gdy dane będą zgodne.
Co uwzględnić przy integracji z SAP ByDesign
- Jedna data na wywołanie. „The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (Nie można jednocześnie aktualizować EarliestStartPeriod i LatestEndPeriod). Przy zapisie do ByDesign używaj daty rozpoczęcia jako punktu odniesienia.
- Brak blokad. Usługi A2X są bezstanowe, więc według SAP nie można wymusić blokad transakcyjnych ani logicznych. Przed każdym zapisem ponownie odczytaj zlecenie i obsłuż konflikty.
- Zakończenie jest nieodwracalne. „Confirmation Finished Indicator cannot be unchecked once it is set.” (Po zaznaczeniu Confirmation Finished Indicator nie można go odznaczyć). Zapisuj zakończenie dopiero wtedy, gdy operator zamknie zadanie.
- Zasoby główne i dodatkowe. Harmonogramowanie w ByDesign uwzględnia zasoby główne. Operatorów i narzędzia z zasobów dodatkowych odwzoruj w SkyPlanner jako zasoby o ograniczonej dostępności, aby harmonogram uwzględniał także ich ograniczenia.
- Przygotowanie i zakończenie pracy. Bills of Operations zawierają czynności przygotowawcze i końcowe. Czasy przezbrojeń zależne od kolejności operacji przenieś do macierzy czasów przygotowawczo-zakończeniowych.
Kto konfiguruje i wspiera integrację z SAP ByDesign
- Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Obejmuje to uzgodnione usługi sieciowe i zapytania OData. Każda firma korzysta z ByDesign inaczej — konfiguracja uwzględnia tę specyfikę.
- Twój partner SAP ByDesign może uczestniczyć w pracach. Zna Twoją instancję, jej zakres funkcjonalny i rozszerzenia, dlatego może wspólnie z zespołem SkyPlanner skonfigurować uzgodnienia komunikacyjne.
- Twoi programiści mogą rozbudowywać integrację, korzystając z REST API SkyPlanner i tokenu API w nagłówku
Authorization-Token. W razie potrzeby zespół SkyPlanner służy pomocą. Szczegóły znajdziesz w dokumentacji integracji SkyPlanner.
Cena SkyPlanner zaczyna się od 199 € miesięcznie za 5 stanowisk roboczych, przy rozliczeniu miesięcznym. Wycenę integracji otrzymasz z góry, razem z ofertą abonamentu, z uwzględnieniem Twoich procesów i potrzeb. Zobacz cennik, harmonogramowanie produkcji z SAP ByDesign, stronę SAP Business ByDesign oraz przegląd integracji z ERP. Osobne przewodniki opisują pozostałe systemy SAP: SAP Business One i SAP S/4HANA.
Opinie producentów o SkyPlanner
2 hoszczędności co tydzień
„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 rozdzielcza
Planowanie produkcji pozwala zaoszczędzić 2 godziny pracy tygodniowo, a nowa kolejka operacji trafia na linię w ciągu kilku 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.
100%terminowości dostaw od 2021 roku
„SkyPlanner daje nam wgląd w zdolności produkcyjne i sprawia, że planowanie jest przewidywalne.”
Dan Berglund, dyrektor operacyjny i finansowy (COO/CFO)
Opes Corporation · Produkcja chemiczna i spożywcza
Terminowość dostaw wynosi 100% przez cały okres korzystania ze SkyPlanner, od 2021 roku.
Mniejprzestojów z powodu braków materiałowych
„Wartość SkyPlanner polega dla nas na tym, że sprawdza się w codziennej pracy, zwłaszcza przy ustalaniu terminów dostaw.”
Tommi Männistö, kierownik planowania produkcji
Eskomatic · Usługowa obróbka skrawaniem
Automatyczne harmonogramowanie obciążenia pozwala dokładniej ustalać terminy dostaw, a liczba przestojów produkcji spowodowanych brakami materiałowymi znacznie spadła.
Najczęściej zadawane pytania
Z których API SAP ByDesign korzysta SkyPlanner?
Z udostępnionych przez SAP usług sieciowych A2X. Odczyt odbywa się przez usługi Query, takie jak Query Production Orders i Query Purchase Orders, lub przez niestandardowe usługi OData. Do zapisu służą Manage Production Orders i Manage Production Lots.
Co SkyPlanner zapisuje w ByDesign?
EarliestStartPeriod oraz MainResourceID operacji w każdym zleceniu produkcyjnym. Opcjonalnie do partii produkcyjnej zapisywane są również potwierdzone ilości, braki i zakończone zadania.
Czy ByDesign wysyła zdarzenia do SkyPlanner?
SkyPlanner co kilka minut odpytuje usługi Query w ByDesign o zlecenia i partie produkcyjne. Sam SkyPlanner wysyła webhooki przy każdej zmianie harmonogramu, uruchamiając zapis do ByDesign.
Jak SkyPlanner uwierzytelnia się w ByDesign?
Przez system komunikacyjny i uzgodnienie komunikacyjne z użytkownikiem technicznym, zgodnie z opisem w przewodniku bezpieczeństwa SAP. Własne API SkyPlanner korzysta z tokenu API w nagłówku Authorization-Token.
Czy propozycje produkcji trafiają do SkyPlanner?
SkyPlanner planuje produkcję na podstawie zwolnionych zleceń produkcyjnych. Propozycje pozostają w ByDesign Supply Planning, dopóki nie staną się zleceniami produkcyjnymi.
Kto tworzy integrację?
Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Twój partner SAP ByDesign lub Twoi programiści mogą ją również rozbudowywać, korzystając z REST API SkyPlanner i tokenu API.