write-flow

Skill write-flow to niezbędny przewodnik do tworzenia przepływów w Windmill. Zawiera reguły nazewnictwa modułów, schemat OpenFlow, obsługę transformacji danych między krokami oraz listę częstych błędów. Dowiesz się, jak poprawnie strukturyzować pliki flow.yaml, korzystać z inline scriptów TypeScript, odwoływać się do wyników poprzednich kroków oraz zarządzać parametrami wejściowymi. Skill wyjaśnia zarezerwowane identyfikatory modułów (failure, preprocessor, Input) i pokazuje, jak unikać duplikatów ID oraz błędów w transformacjach danych.

1. Utwórz folder kończący się na __flow w swoim projekcie Windmill. W tym folderze dodaj plik flow.yaml, który będzie zawierać definicję przepływu zgodnie ze schematem OpenFlow.
2. Dla modułów rawscript umieść zawartość skryptu TypeScript za pomocą !inline ścieżka/do/skryptu.ts. Pamiętaj, aby nazwy plików inline nie zawierały .inline_script. (np. użyj a.ts zamiast a.inline_script.ts).
3. Nadaj każdemu modułowi unikatowy identyfikator (module ID) używając podkreśleń zamiast spacji, np. fetch_data. Unikaj zarezerwowanych nazw: failure, preprocessor i Input.
4. Skonfiguruj transformacje danych między krokami. Aby odwołać się do danych, użyj flow_input.property dla parametrów wejściowych lub results.step_id dla wyników poprzednich kroków. W pętlach for dostępne są flow_input.iter.value i flow_input.iter.index.
5. Upewnij się, że każdy moduł rawscript ma zdefiniowany input_transforms, inaczej parametry nie otrzymają wartości. Nie odwoływaj się do kroków, które jeszcze się nie wykonały.
6. Po zapisaniu pliku flow.yaml uruchom w terminalu wmill flow generate-locks ścieżka/do/folderu__flow --yes, aby wygenerować pliki blokad, a następnie wmill sync push, aby wdrożyć przepływ do Windmill.