- Strona główna
- Blog
Medusa.js: Czym jest funkcjonalność Workflows
E-commerce
Medusa.js: Czym jest funkcjonalność Workflows
- 5 minut czytania
- 22.01.2025
- Krzysztof Polak
Medusa.js w wersji 2.x wprowadziła nową funkcjonalność jaką jest Workflows.
Wprowadzona w celu zarządzania bardziej złożonymi i powtarzalnymi procesami w projekcie e-commerce.
Z tego wpisu dowiesz się:
- Czym jest funkcjonalność Workflows
- W jaki sposób go definiujemy po stronie back-endu
- W jaki sposób możesz monitorować każdy krok
Wprowadzenie
We wpisie tutaj opisałem czym jest framework Medusa.js oraz dlaczego staje się coraz bardziej popularny.
W tym wpisie chciałbym napisać o nowej funkcjonalności: Workflows.
Kiedy pierwszy raz przeczytałem o tym co to będzie to pierwszą myślą było: porządek.
Jako programista bardzo mocno zwracam uwagę na to aby każdy projekt był uporządkowany i ułożony (na tyle, na ile pozwala czas projektu).
Czym jest funkcjonalność Workflows?
Workflows umożliwiają definiowanie sekwencji zadań (tzw. kroki), które mogą być automatycznie wykonywane na podstawie ustalonych reguł.
Dzięki nim możesz łatwo organizować procesy, a to podejście z mojego punktu widzenia wprowadza duży porządek w kodzie i przyśpiesza prace.
W jaki sposób definiujemy Workflow?
Workflows są definiowane w backendzie Medusa.js.
Każdy z nich składa się z serii kroków, które reprezentują zadania do wykonania.
Kroki
Każdy krok w workflow definiuje pojedyncze zadanie lub akcję, którą należy wykonać. Przykładem może być: wysłanie e-maila do użytkownika czy zewnętrznego systemu, aktualizacja stanu zamówienia albo dodanie produktu do ulubionych.
Automatyzacja
Workflows można skonfigurować tak, aby były wyzwalane ręcznie albo automatycznie na podstawie zdarzeń w Medusa.js np. utworzenia zamówienia, zmiany statusu płatności lub przesyłki.
Modularność
Dzięki temu, że kroki są modularne, to każdy z nich można łatwo dostosować i rozszerzać w zależności od wymagań. Na każdym etapie można uruchomić kompletnie co innego.
Monitorowanie
Postęp Workflow można w łatwy sposób śledzić. Dzięki temu wiesz, które kroki zostały ukończone, a które jeszcze czekają na wykonanie. Wówczas można odpowiednio reagować w momencie gdy coś nie zadziałało.
Możemy je monitorować na kilka sposobów m.in:
- Za pomocą panelu:
W panelu w sposób wizualny, a jednocześnie bardzo przejrzysty, możesz zobaczyć wszystkie uruchomione Workflows w formie listy. Do każdego z nich możesz wejdź i sprawdzić wszystkie szczegóły.
W jaki sposób się tam dostać?- zaloguj się do panelu w back-endzie,
- wejdź do podstrony “Settings” (lewy dolny róg),
- po lewej stronie znajdź sekcję Developer, a w niej wejdź do podstrony Workflows
- Za pomocą API:
Medusa.js udostępnia API które można użyć by pobrać listę Workflows wraz ze szczegółami.
Umożliwia to metoda “WorkflowService”.import { WorkflowService } from "@medusajs/workflows";
Podsumowując…
Medusa.js wprowadzając tę funkcjonalność wprowadziła nowe możliwości we frameworku.
Możemy w wygodny sposób kontrolować przepływ uruchamianych akcji które chcielibyśmy użyć w sklepie. Dodatkowo bardzo podoba mi się pomysł przedstawienia wszystkich szczegółów w wizualny sposób. Możemy dzięki temu w szybki sposób sprawdzić stan każdego kroku.
Porozmawiajmy o współpracy!
Wysokiej jakości kod i partnerskie warunki współpracy. Wdrażaj projekty bez problemu!

Krzysztof Polak
właściciel Codee, programista z wieloletnim doświadczeniem