SKLEPINTERNETOWY.BIZPoradniki i wiedza e-commerce
Poradnik›BŁĘDY›Shopware – Flow Builder nie wyświetla akcji automatyzacji…
BŁĘDY

Shopware – Flow Builder nie wyświetla akcji automatyzacji po aktualizacji

17 listopada 202611 min czytanianetpoint

W Shopware 6.7.16.0 wykryto błąd panelu administracyjnego, który uniemożliwia prawidłowe wyświetlanie i edytowanie działań w narzędziu Flow Builder. Problem dotyczy instalacji korzystających z rozszerzenia Shopware Commercial 7.16.0 i występuje podczas otwierania automatyzacji zawierających warunki lub opóźnienia.

Administrator widzi strukturę przepływu, ale akcje przypisane do określonych gałęzi pozostają niewidoczne. W konsoli przeglądarki pojawia się komunikat JavaScript:

TypeError: this.getLicense is not a function

Błąd zgłoszono 16 listopada 2026 roku w oficjalnym repozytorium Shopware na GitHubie. Autor wskazał konkretny komponent rozszerzenia Commercial odpowiedzialny za problem i potwierdził lokalne obejście przywracające wyświetlanie akcji.

Istotne jest rozróżnienie dwóch elementów działania sklepu. Według zgłoszenia automatyzacje pozostają prawidłowo zapisane i nadal wykonują się po stronie serwera. Awaria dotyczy interfejsu administracyjnego, który nie potrafi pokazać i udostępnić do edycji części skonfigurowanych działań.

Na czym polega błąd Flow Builder w Shopware 6.7.16?

Flow Builder jest narzędziem Shopware pozwalającym automatyzować procesy zachodzące w sklepie internetowym. Administrator może tworzyć reguły uruchamiane przez określone zdarzenia, takie jak złożenie zamówienia, zmiana statusu płatności czy rejestracja klienta.

Automatyzacje mogą obejmować wysyłanie wiadomości e-mail, zmianę statusów zamówień, uruchamianie webhooków oraz wykonywanie działań zależnych od zdefiniowanych warunków.

W Shopware 6.7.16.0 z Commercial 7.16.0 zgłoszono problem z renderowaniem list akcji znajdujących się wewnątrz bardziej rozbudowanych przepływów.

Dotyczy to przede wszystkim dwóch typów konstrukcji:

  • IF → TRUE/FALSE – działań wykonywanych w zależności od spełnienia warunku.
  • WAIT → THEN – działań wykonywanych po określonym opóźnieniu.

Po otwarciu przepływu administrator widzi warunek lub blok opóźnienia, ale nie widzi akcji, które powinny znajdować się pod nim.

Strzałki prowadzące do dalszych działań pozostają widoczne, jednak lista akcji jest pusta.

Shopware nie pokazuje akcji automatyzacji mimo ich zapisania

Problem jest szczególnie mylący, ponieważ może sugerować, że wcześniej skonfigurowane akcje zostały usunięte.

Administrator otwiera Flow Builder, wybiera istniejący przepływ i przechodzi do zakładki Flow. Widzi zapisane warunki, lecz przypisane do nich działania nie są wyświetlane.

Może to sprawiać wrażenie uszkodzenia automatyzacji po aktualizacji Shopware.

W rzeczywistości opisany przypadek ma inny charakter. Według zgłoszenia:

  • Definicje przepływów pozostają zapisane.
  • Akcje nadal istnieją w konfiguracji.
  • Mechanizm wykonywania przepływów po stronie serwera działa prawidłowo.
  • Panel administracyjny nie potrafi wyrenderować zagnieżdżonych list akcji.
  • Administrator nie może prawidłowo przeglądać i edytować niewidocznych działań.

Nie należy więc automatycznie uznawać, że problem spowodował usunięcie automatyzacji z bazy danych.

Takie rozróżnienie jest istotne również podczas przywracania działania sklepu. Niepotrzebne odtwarzanie przepływów od początku może doprowadzić do dodatkowych błędów lub zdublowania działań.

Problem dotyczy także domyślnego przepływu produktów cyfrowych

Autor zgłoszenia wskazał, że błąd występuje również w domyślnej automatyzacji Shopware:

Deliver ordered product downloads

Przepływ ten odpowiada za działania związane z dostarczeniem klientowi produktów cyfrowych po złożeniu odpowiedniego zamówienia.

W przykładowej konfiguracji znajduje się warunek sprawdzający, czy zamówienie zawiera produkty cyfrowe.

Po jego spełnieniu Shopware może uruchomić działania służące przyznaniu dostępu do pobierania oraz wysłaniu odpowiedniej wiadomości.

W uszkodzonym interfejsie administrator widzi warunek dotyczący produktów cyfrowych, ale gałąź TRUE wygląda na pustą.

Nie oznacza to, że klienci przestali automatycznie otrzymywać zakupione pliki. W zgłoszonym środowisku istniejące przepływy działały poprawnie po stronie serwera.

Problem polega na braku możliwości ich prawidłowego wyświetlenia i modyfikowania w panelu administracyjnym.

Co oznacza błąd „this.getLicense is not a function”?

W konsoli przeglądarki pojawia się wyjątek JavaScript związany z rozszerzeniem WebhookFlowAction.

Fragment komunikatu wygląda następująco:

An error was captured in current module:
TypeError: this.getLicense is not a function

at .../bundles/webhookflowaction/administration/assets/index-Bs2a5JeD.js
at Proxy.sequenceData
at Proxy.$super
at Proxy.showAddAction

Komunikat wskazuje, że kod próbuje wywołać metodę getLicense(), która nie jest dostępna w danym kontekście wykonania.

Nie jest to typowy błąd połączenia z bazą danych ani awaria serwera PHP. Problem dotyczy kodu JavaScript odpowiedzialnego za renderowanie interfejsu administracyjnego.

Przyczyna znajduje się w rozszerzeniu Commercial

Według analizy przedstawionej w zgłoszeniu przyczyną jest nadpisanie komponentu sw-flow-sequence-action przez mechanizm WebhookFlowAction należący do Shopware Commercial.

Rozszerzenie wprowadza dodatkową logikę sprawdzającą uprawnienia licencyjne określonych funkcji Flow Builder.

W problematycznej implementacji metoda getLicense() została zdefiniowana w sekcji metod komponentu, ale kod wywołujący ją podczas obliczania sequenceData nie zawsze ma do niej dostęp.

W szczególności problem pojawia się, gdy właściwość jest obliczana przez łańcuch wywołań wykorzystujący $super.

Rezultatem jest wyjątek JavaScript, który przerywa renderowanie całej listy działań.

Dlaczego błąd licencji ukrywa również zwykłe akcje?

Mechanizm odpowiedzialny za sprawdzanie licencji jest częścią komponentu obsługującego listy akcji.

Jeżeli podczas przetwarzania tej listy wystąpi wyjątek JavaScript, renderowanie może zostać przerwane, zanim interfejs pokaże poszczególne elementy.

W konsekwencji problem związany z kontrolą dostępności jednej funkcji może uniemożliwić wyświetlenie także działań niezwiązanych bezpośrednio z webhookami.

To wyjaśnia, dlaczego błąd dotyczący getLicense() wpływa na rozbudowane przepływy zawierające warunki i opóźnienia.

Których wersji Shopware dotyczy problem?

Zgłoszenie dotyczy następującej konfiguracji:

  • Shopware 6.7.16.0.
  • Shopware Commercial 7.16.0.
  • Instalacja self-hosted.
  • Aktywne funkcje Flow Builder dostępne w ramach odpowiedniej licencji.
  • Rozszerzenie WebhookFlowAction.

Nie opublikowano kompletnej listy wszystkich wersji Shopware i Commercial, w których występuje identyczny problem.

Nie ma również podstaw, aby przypisywać tę usterkę wszystkim instalacjom Shopware 6.7, szczególnie tym, które nie korzystają z tego samego zestawu rozszerzeń.

Warto jednocześnie pamiętać, że w Shopware 6.7.16.0 zgłaszano także inne, niezależne nieprawidłowości. Jedną z nich jest błąd migracji klientów B2B prowadzący do nieprawidłowego naliczania VAT. Dotyczy on jednak danych klientów i podatków, a nie interfejsu Flow Builder.

Jak zdiagnozować błąd Flow Builder w Shopware?

1. Sprawdź wersję Shopware i Commercial

W pierwszej kolejności ustal wersję rdzenia Shopware oraz zainstalowanego pakietu Commercial.

Porównaj je z konfiguracją opisaną w zgłoszeniu. Sama zgodność numeru wersji Shopware nie oznacza jeszcze, że źródłem problemu jest WebhookFlowAction.

2. Otwórz przepływ zawierający warunek IF

Przejdź do panelu administracyjnego i otwórz Flow Builder.

Wybierz istniejący przepływ zawierający rozgałęzienie warunkowe.

Sprawdź, czy po otwarciu zakładki Flow prawidłowo wyświetlane są akcje przypisane do gałęzi TRUE oraz FALSE.

Jeżeli warunek pozostaje widoczny, ale działania znikają, objaw może odpowiadać zgłoszonemu błędowi.

3. Sprawdź przepływy z opóźnieniem

W podobny sposób przeanalizuj automatyzacje korzystające z opóźnionych działań.

Sprawdź, czy akcje wykonywane po bloku WAIT są widoczne i dostępne do edycji.

Jeżeli problem występuje wyłącznie w przepływach zagnieżdżonych pod warunkami lub opóźnieniami, stanowi to istotną wskazówkę diagnostyczną.

4. Otwórz konsolę JavaScript przeglądarki

W narzędziach deweloperskich przeglądarki przejdź do zakładki Console.

Następnie ponownie otwórz problematyczny przepływ i sprawdź, czy pojawia się komunikat:

TypeError: this.getLicense is not a function

Sprawdź również, czy stos wywołań wskazuje na zasoby:

bundles/webhookflowaction/administration/assets/

Jeżeli oba elementy występują jednocześnie, istnieje mocna przesłanka, że problem odpowiada usterce opisanej w zgłoszeniu Shopware.

5. Sprawdź rzeczywiste wykonywanie automatyzacji

Należy odróżnić nieprawidłowy wygląd panelu od faktycznego zatrzymania działania przepływu.

Na środowisku testowym uruchom zdarzenie, które powinno wywołać konkretną automatyzację, i sprawdź jej rzeczywisty wynik.

W zależności od przeznaczenia przepływu może to być wygenerowanie wiadomości, aktualizacja statusu zamówienia albo wykonanie innej skonfigurowanej operacji.

Nie wykonuj niekontrolowanych prób na rzeczywistych zamówieniach klientów. Testy powinny wykorzystywać bezpieczne dane i środowisko stagingowe.

Jak przywrócić wyświetlanie akcji Flow Builder?

Autor zgłoszenia przedstawił lokalne obejście polegające na zmianie sposobu sprawdzania licencji w problematycznym komponencie.

W pierwotnej implementacji kod wywołuje:

this.getLicense()

W przetestowanym obejściu zastąpiono to bezpośrednim wywołaniem:

Shopware.License.get()

Zmiana została przeprowadzona w zasobach JavaScript rozszerzenia WebhookFlowAction, zarówno w pakiecie Commercial, jak i w odpowiadającej mu publicznej kopii zasobów administracyjnych.

Po zastosowaniu obejścia autor potwierdził ponowne wyświetlanie zagnieżdżonych list akcji.

Nie należy jednak traktować takiej modyfikacji jako oficjalnej, trwałej poprawki Shopware.

Ręczna edycja skompilowanych plików JavaScript może zostać utracona podczas aktualizacji pakietu, przebudowy zasobów lub ponownego wdrożenia aplikacji.

W sklepie produkcyjnym bezpieczniejszym rozwiązaniem jest najpierw sprawdzenie dostępności oficjalnej poprawki Commercial, przygotowanie kopii zapasowej i odtworzenie problemu na stagingu.

Każda własna poprawka powinna być kontrolowana w systemie wdrożeniowym i testowana po zmianach wersji Shopware.

Czy błąd Flow Builder może zatrzymać realizację zamówień?

W udokumentowanym przypadku nie potwierdzono zatrzymania wykonywania istniejących automatyzacji.

Autor wyraźnie zaznaczył, że przepływy pozostają zapisane i wykonują się prawidłowo po stronie serwera.

Nie oznacza to jednak, że awaria interfejsu jest nieistotna z punktu widzenia sprzedaży.

Właściciel lub administrator sklepu może stracić możliwość szybkiego wprowadzania zmian w procesach obsługi zamówień.

Jeżeli konieczna jest pilna aktualizacja warunku, sposobu wysyłania powiadomień lub reguły realizacji produktu cyfrowego, niewidoczne akcje utrudniają wykonanie takiej operacji.

Potencjalne konsekwencje obejmują opóźnienia we wdrażaniu zmian, utrudnioną diagnostykę automatyzacji i ryzyko niepotrzebnego odtwarzania poprawnie zapisanych przepływów.

Jest to inny rodzaj zagrożenia niż błąd eksportu produktów Shopware, który w określonych warunkach może prowadzić do wyczerpania pamięci RAM i zatrzymania MySQL. W przypadku Flow Builder potwierdzony problem dotyczy interfejsu zarządzania automatyzacjami.

Jak zabezpieczyć automatyzacje Shopware przed problemami po aktualizacji?

Flow Builder może odpowiadać za istotne operacje wykonywane po złożeniu zamówienia. Dlatego jego działanie warto uwzględniać w testach aktualizacji sklepu.

Przed wdrożeniem nowych wersji Shopware i Commercial należy:

  1. Wykonać kopię zapasową bazy danych oraz plików aplikacji.
  2. Ustalić, które automatyzacje odpowiadają za krytyczne procesy sprzedażowe.
  3. Sprawdzić wyświetlanie warunków, opóźnień i zagnieżdżonych akcji.
  4. Przetestować faktyczne wykonywanie przepływów w środowisku stagingowym.
  5. Sprawdzić konsolę JavaScript panelu administracyjnego.
  6. Porównać wersje rdzenia, pakietu Commercial i pozostałych rozszerzeń.

Ważne jest również dokumentowanie najbardziej istotnych automatyzacji. W przypadku awarii panelu pozwala to zweryfikować ich oczekiwane działanie bez konieczności odtwarzania konfiguracji z pamięci.

Oficjalna dokumentacja Shopware Flow Builder opisuje mechanizm wyzwalaczy, warunków i akcji. Przydatne są również informacje o działaniach wykonywanych z opóźnieniem.

Sprawne automatyzacje mają szczególne znaczenie wtedy, gdy sklep internetowy wykorzystuje wiele integracji, obsługuje produkty cyfrowe lub realizuje zamówienia z wykorzystaniem zaawansowanych reguł biznesowych.

Najczęściej zadawane pytania

Dlaczego akcje w Shopware Flow Builder są niewidoczne?

Jedną z potwierdzonych przyczyn jest błąd JavaScript w Shopware Commercial 7.16.0. Mechanizm WebhookFlowAction wywołuje metodę getLicense() w kontekście, w którym nie jest ona dostępna. Powoduje to przerwanie renderowania zagnieżdżonych list akcji.

Czy niewidoczne akcje zostały usunięte?

W opisanym zgłoszeniu nie. Akcje pozostają zapisane i wykonują się po stronie serwera. Uszkodzony jest mechanizm ich wyświetlania w panelu administracyjnym.

Czy problem dotyczy wszystkich sklepów Shopware 6.7?

Nie ma takiego potwierdzenia. Błąd został udokumentowany w Shopware 6.7.16.0 z Commercial 7.16.0. Znaczenie ma również obecność odpowiednich funkcji Flow Builder oraz problematycznego rozszerzenia.

Czy wystarczy wyczyścić pamięć podręczną przeglądarki?

Nie ma potwierdzenia, że samo wyczyszczenie pamięci podręcznej usuwa opisany błąd. Przyczyna została zlokalizowana w kodzie JavaScript rozszerzenia Commercial. Czyszczenie cache może być elementem diagnostyki po wdrożeniu poprawki, ale nie zastępuje naprawienia problematycznego wywołania.

Czy można bezpiecznie ponownie utworzyć niewidoczne akcje?

Nie należy tego robić bez wcześniejszego sprawdzenia, czy akcje nadal istnieją w zapisanej konfiguracji. W zgłoszonym przypadku pozostawały aktywne. Ich ponowne dodanie mogłoby prowadzić do zdublowania wykonywanych operacji.

Czy istnieje oficjalna poprawka Shopware Commercial?

Według stanu zgłoszenia na 17 listopada 2026 roku udokumentowano skuteczne lokalne obejście, ale nie wskazano oficjalnego wydania z zatwierdzoną poprawką. Przed wprowadzaniem zmian należy sprawdzić aktualne informacje producenta.

Co powinni zrobić administratorzy sklepów Shopware?

Błąd Flow Builder w Shopware 6.7.16.0 pokazuje, że awaria panelu administracyjnego nie musi oznaczać awarii mechanizmu wykonującego automatyzacje.

W tym przypadku akcje mogą nadal działać prawidłowo, mimo że administrator nie widzi ich w edytorze.

Najważniejsze jest potwierdzenie wersji Shopware i Commercial, sprawdzenie komunikatu TypeError: this.getLicense is not a function oraz zweryfikowanie, czy istniejące przepływy wykonują oczekiwane działania.

Nie należy usuwać ani odtwarzać automatyzacji wyłącznie dlatego, że ich lista jest pusta w panelu. Najpierw trzeba ustalić, czy problem dotyczy zapisu konfiguracji, czy tylko jej prezentacji.

W udokumentowanym przypadku przyczyną był kod WebhookFlowAction odpowiedzialny za sprawdzanie licencji. Lokalna modyfikacja wywołania getLicense() przywróciła wyświetlanie akcji, jednak trwałe rozwiązanie powinno zostać zweryfikowane w ramach oficjalnej aktualizacji rozszerzenia Shopware Commercial.

Źródła

netpoint

Materiały o e-commerce, sprzedaży i technologii dla sklepów internetowych.

Czytaj dalej

Powiązane materiały