9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
320 lines
12 KiB
Plaintext
320 lines
12 KiB
Plaintext
---
|
|
title: Funkcje przepływu pracy
|
|
info: Pełna referencja do wszystkich dostępnych wyzwalaczy przepływu pracy, akcji i funkcji zarządzania.
|
|
image: /images/user-guide/workflows/robot.png
|
|
sectionInfo: Automatyzuj procesy i integruj się z zewnętrznymi narzędziami
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/workflows/robot.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## Wyzwalacze przepływu pracy
|
|
|
|
Przepływy pracy zawsze zaczynają się od pojedynczego wyzwalacza, który określa, kiedy automatyzacja powinna się uruchomić.
|
|
|
|
### Rekord jest tworzony
|
|
|
|
Uruchamia przepływ pracy, gdy nowy rekord jest tworzony w wybranym obiekcie (Ludzie, Firmy, Możliwości lub dowolny obiekt niestandardowy).
|
|
|
|
**Konfiguracja**: Wybierz typ obiektu, aby monitorować nowe rekordy.
|
|
|
|
### Rekord jest aktualizowany
|
|
|
|
Uruchamia przepływ pracy, gdy zmiany są wprowadzane do istniejącego rekordu.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz typ obiektu
|
|
- Opcjonalnie określ, które pola monitorować pod kątem zmian
|
|
|
|
### Rekord jest aktualizowany lub tworzony
|
|
|
|
Uruchamia przepływ pracy, gdy rekord jest tworzony lub aktualizowany w wybranym obiekcie.
|
|
|
|
**Dlaczego to ma znaczenie**: Ten wyzwalacz jest szczególnie pomocny, ponieważ rekordy tworzone różnymi metodami zachowują się inaczej:
|
|
|
|
- **API/CSV importy**: Rekordy są tworzone z wszystkimi polami wypełnionymi natychmiastowo
|
|
- **Ręczne tworzenie**: Rekordy są najpierw tworzone, potem pola są dodawane w kolejnych aktualizacjach
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz typ obiektu do monitorowania
|
|
- Opcjonalnie określ, które pola monitorować pod kątem zmian
|
|
- Przepływ pracy zostanie uruchomiony zarówno przy początkowym tworzeniu, jak i przy wszystkich kolejnych aktualizacjach
|
|
|
|
### Rekord jest usuwany
|
|
|
|
Uruchamia przepływ pracy, gdy rekord jest usuwany z obiektu.
|
|
|
|
**Konfiguracja**: Wybierz typ obiektu do monitorowania usunięć.
|
|
|
|
### Uruchom ręcznie
|
|
|
|
Uruchamia przepływ pracy, gdy jest wyzwalany przez akcję użytkownika. Ten wyzwalacz można uzyskać przez menu Cmd+K lub za pośrednictwem niestandardowego przycisku na górnym pasku nawigacji.
|
|
|
|
**Konfiguracja dostępności**: Wybierz, jak przepływ pracy powinien obsługiwać wybór rekordu:
|
|
|
|
- **Globalnie**: Nie jest wymagany żaden rekord do uruchomienia tego przepływu pracy. Przepływ pracy jest uruchamiany z dowolnego miejsca (z dowolnego obiektu) i nie używa rekordu(ów) jako wejścia.
|
|
|
|
- **Pojedynczy**: Wybrane rekordy zostaną przekazane do twojego przepływu pracy. Zostało skonfigurowane dla danego obiektu. Przed uruchomieniem przepływu pracy można wybrać kilka rekordów. Przepływ pracy zostanie uruchomiony tyle razy, ile rekordów zostało wybranych.
|
|
|
|
<Warning>
|
|
You cannot run more than 100 workflows in parallel at any given time.
|
|
</Warning>
|
|
|
|
- **Zbiorcze**: Wybrane rekordy zostaną przekazane do twojego przepływu pracy. Zostało skonfigurowane dla danego obiektu. Przed uruchomieniem przepływu pracy można wybrać kilka rekordów. Przepływ pracy zostanie uruchomiony raz, dostarczając całą listę rekordów jako dane wejściowe. Oznacza to, że przepływ pracy musi zawierać akcję Iteratora. To najlepsze dla ludzi, którzy chcą zoptymalizować/ograniczyć ilość uruchomień przepływu pracy.
|
|
|
|
**Dodatkowa konfiguracja**:
|
|
|
|
- Wybierz obiekt docelowy (dla Pojedynczego i Zbiorczego dostępu)
|
|
- Wybierz ikonę polecenia dla wyzwalacza przepływu pracy
|
|
- Skonfiguruj pozycję na pasku nawigacyjnym (Przypięty lub Nieprzypięty)
|
|
|
|
**Metody dostępu**:
|
|
|
|
- Menu Cmd+K do znalezienia i uruchomienia ręcznych przepływów pracy
|
|
- Niestandardowy przycisk na górnym pasku nawigacyjnym (jeśli skonfigurowane)
|
|
|
|
### On a Schedule
|
|
|
|
Starts the workflow on a recurring basis you define.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz jednostkę czasu (minuty, godziny, dni)
|
|
- Enter a value or use custom cron expressions for advanced scheduling
|
|
|
|
### Webhook
|
|
|
|
Uruchamia przepływ pracy, gdy zostanie odebrane żądanie GET lub POST z zewnętrznej usługi.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Otrzymaj unikalny URL webhooka
|
|
- Dla żądań POST, zdefiniuj oczekiwaną strukturę ciała
|
|
- Skonfiguruj uwierzytelnianie w razie potrzeby
|
|
|
|
## Akcje Przepływu Pracy
|
|
|
|
Akcje określają, co się dzieje po uruchomieniu wyzwalacza. Możesz łączyć ze sobą wiele akcji.
|
|
|
|
### Utwórz Rekord
|
|
|
|
Dodaje nowy rekord do wybranego obiektu.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz obiekt docelowy
|
|
- Wypełnij wymagane i opcjonalne pola
|
|
- Użyj danych z poprzednich kroków do wypełnienia pól
|
|
|
|
**Wynik**: Dane nowo utworzonego rekordu są dostępne do użycia w kolejnych krokach.
|
|
|
|
### Zaktualizuj Rekord
|
|
|
|
Modyfikuje istniejący rekord w wybranym obiekcie.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz obiekt docelowy
|
|
- Wybierz konkretny rekord do zaktualizowania
|
|
- Wybierz pola do modyfikacji i wprowadź nowe wartości
|
|
|
|
**Wynik**: Zaktualizowane dane rekordu są dostępne do użycia w kolejnych krokach.
|
|
|
|
### Usuń Rekord
|
|
|
|
Usuwa rekord z wybranego obiektu.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz obiekt docelowy
|
|
- Wybierz konkretny rekord do usunięcia
|
|
|
|
**Wynik**: Usunięte dane rekordu pozostają dostępne do użycia w kolejnych krokach.
|
|
|
|
### Przeszukaj Rekordy
|
|
|
|
Znajduje rekordy w wybranym obiekcie za pomocą warunków filtrów.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz obiekt do przeszukania
|
|
- Ustaw kryteria filtra, aby zawęzić wyniki
|
|
- Skonfiguruj sortowanie i limity
|
|
|
|
**Wynik**: Zwraca rekordy pasujące do określonych warunków filtra, które można wykorzystać w kolejnych krokach.
|
|
|
|
**Najlepsza Praktyka**: Używaj gałęzi po Przeszukaniu Rekordów, aby obsłużyć scenariusze "znalezione" vs "nieznalezione".
|
|
|
|
### Iterator
|
|
|
|
Przechodzi przez tablicę rekordów zwróconych z poprzedniego kroku, pozwalając na wykonanie akcji na każdym rekordzie indywidualnie.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz tablicę rekordów z poprzedniego kroku (np. wyniki z Przeszukania Rekordów)
|
|
- Określ akcje do wykonania na każdym rekordzie w pętli
|
|
- Skonfiguruj nazwę zmiennej, aby odwołać się do każdego rekordu w iteracji
|
|
|
|
**Przykład**: Przeszukanie Rekordów zwraca 5 osób, następnie użyj Iteratora, aby wysłać e-mail do każdej osoby lub zaktualizować każdy rekord indywidualnie.
|
|
|
|
**Uwaga**: Iterator jest obecnie w wersji beta. Aktywuj go w Ustawienia → Wydania → Lab.
|
|
|
|
### Filtruj
|
|
|
|
Filtruje tablicę rekordów na podstawie określonych warunków, dopuszczając tylko te rekordy, które spełniają kryteria.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wybierz tablicę rekordów do przefiltrowania
|
|
- Zdefiniuj warunki i kryteria filtra
|
|
- Skonfiguruj, które rekordy powinny przejść dalej do kolejnych kroków
|
|
|
|
**Wynik**: Zwraca tylko rekordy, które pasują do określonych warunków filtra.
|
|
|
|
### Wyślij e-mail
|
|
|
|
Wysyła e-mail z twojego przepływu pracy.
|
|
|
|
**Wymagania wstępne**: Dodaj konto e-mail w Ustawienia > Konta
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wprowadź adres e-mail odbiorcy
|
|
- Ustaw temat wiadomości
|
|
- Napisz treść wiadomości
|
|
- Odwołaj się do zmiennych z poprzednich kroków dla personalizacji
|
|
|
|
**Uwaga**: Załączniki e-mail będą dostępne w Q1 2026.
|
|
|
|
### Kod
|
|
|
|
Uruchamia niestandardowy JavaScript w twoim przepływie pracy.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Napisz kod JavaScript w edytorze
|
|
- Dostęp do zmiennych z poprzednich kroków
|
|
- Zwróć zmienne do wykorzystania w kolejnych krokach
|
|
- Testuj kod bezpośrednio w kroku
|
|
|
|
**Access**: Manage API keys in Settings → API & Webhooks
|
|
|
|
### Formularz
|
|
|
|
Prezentuje formularz podczas wykonywania przepływu pracy w celu zbierania danych od użytkownika.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Zdefiniuj pola wejściowe z typami, etykietami i tekstami domyślnymi
|
|
- Skonfiguruj reguły walidacji
|
|
- Ustaw tytuł i opis formularza
|
|
|
|
**Wynik**: Odpowiedzi formularza są dostępne do użycia w kolejnych krokach.
|
|
|
|
<Warning>
|
|
Formularze są obecnie projektowane tylko dla wyzwalaczy manualnych. Dla przepływów pracy z innymi wyzwalaczami (Rekord utworzony, Zaktualizowany itd.), formularze są dostępne tylko poprzez interfejs uruchomienia przepływu pracy, co nie jest oczekiwanym doświadczeniem użytkownika. Centrum powiadomień zostanie wprowadzone w 2026 roku, aby odpowiednio wspierać formularze w zautomatyzowanych przepływach pracy.
|
|
</Warning>
|
|
|
|
### Żądanie HTTP
|
|
|
|
Wysyła żądanie do zewnętrznego API jako część twojego przepływu pracy.
|
|
|
|
**Konfiguracja**:
|
|
|
|
- Wprowadź URL punktu końcowego API
|
|
- Wybierz metodę HTTP (GET, POST, PUT, PATCH, DELETE)
|
|
- Dodaj wymagane nagłówki i wartości
|
|
- Dołącz ciało żądania dla żądań POST/PUT/PATCH
|
|
- Podaj przykładową odpowiedź do podglądu struktury
|
|
|
|
## Zarządzanie Przepływem Pracy
|
|
|
|
### Tworzenie Przepływów Pracy
|
|
|
|
1. Kliknij "+ Dodaj przepływ pracy", aby rozpocząć
|
|
2. Kliknij "Bez nazwy", aby nazwać swój przepływ pracy
|
|
3. Wybierz i skonfiguruj wyzwalacz swojego przepływu pracy
|
|
4. Dodaj akcje do swojego przepływu pracy
|
|
5. Testuj i iteruj
|
|
6. Aktywuj swój przepływ pracy (obecnie w trybie roboczym) po zakończeniu edycji
|
|
|
|
**Note**: If you don't see the Workflows section, this is due to a permissions issue. Skontaktuj się z administratorem przestrzeni roboczej, aby uzyskać dostęp do przepływów pracy.
|
|
|
|
### Statusy Przepływów Pracy
|
|
|
|
- **Wersja Robocza**: W trakcie edytowania, jeszcze nie opublikowana
|
|
- **Aktywny**: Wersja na żywo, odpowiada na wyzwalacze
|
|
- **Dezaktywowany**: Poprzednio aktywny, ale zatrzymany ręcznie
|
|
- **Archiwalny**: Przeszłe wersje zachowane dla historii
|
|
|
|
### Aktywacja Przepływów Pracy
|
|
|
|
Kliknij **Aktywuj**, aby opublikować swoją wersję roboczą jako nową wersję. To sprawia, że przepływ pracy jest gotowy do uruchomienia po wyzwoleniu, ale nie uruchamia go natychmiast.
|
|
|
|
### Testowanie Przepływów Pracy
|
|
|
|
Testuj przepływy pracy przed aktywacją za pomocą:
|
|
|
|
- Ręcznych wyzwalaczy (gdy nie wybrano rekordu)
|
|
- Indywidualne testowanie akcji (zwłaszcza akcji kodu)
|
|
- Testowanie w trybie roboczym, które nie aktywuje przepływu pracy
|
|
|
|
### Wykonania przepływu pracy
|
|
|
|
**Wykonanie** to zapis wykonania przepływu pracy zawierający:
|
|
|
|
- Status (success, failed, running)
|
|
- Dane wyjściowe z każdego kroku
|
|
- Autor i znaczniki czasowe
|
|
- Komunikaty o błędach, jeśli dotyczy
|
|
|
|
**Wyświetlanie Wykonań**:
|
|
|
|
- Sprawdź panel **Wykonania** w edytorze przepływu pracy
|
|
- Otwórz widok **Wykonania Przepływu Pracy** do monitorowania wszystkich przepływów pracy
|
|
|
|
**Wskazówka dotycząca wydajności**: Ukryj wykonania przepływu pracy z strony "Wszystkie przepływy pracy" i innych stron przepływów pracy, aby poprawić wydajność ładowania, ponieważ duże liczby wykonań mogą spowolnić ładowanie stron.
|
|
|
|
### Historia Wersji
|
|
|
|
- Zobacz wszystkie wersje w polu **Wersje**
|
|
- Kliknij dowolną wersję, aby zobaczyć szczegóły
|
|
- Use **Use as draft** to restore previous versions
|
|
- Obsługuj konflikty wersji roboczej za pomocą opcji nadpisania lub zwrotu
|
|
|
|
## Najlepsze Praktyki
|
|
|
|
### Organizacja Przepływów Pracy
|
|
|
|
- **Descriptive Names**: Use clear, specific workflow names
|
|
- **Nazewnictwo Kroków**: Zmień nazwę kroków, aby opisać ich funkcję
|
|
- **Dokumentacja**: Dodawaj komentarze w akcjach Kodowych
|
|
- **Kategoryzacja**: Grupuj powiązane przepływy pracy logicznie
|
|
- **Pola Niestandardowe**: Dodaj pola do obiektu Przepływ pracy w twoim modelu danych (podobnie jak inne obiekty), aby organizować i kategoryzować przepływy pracy za pomocą niestandardowych właściwości
|
|
|
|
### Optymalizacja Wydajności
|
|
|
|
- **Minimalizuj Wywołania API**: Grupuj operacje, gdy to możliwe
|
|
- **Efficient Searches**: Use specific filter criteria
|
|
- **Obsługa Błędów**: Planowanie scenariuszy awarii
|
|
- **Ograniczenia Szybkości**: Przestrzegaj limitów zewnętrznych API
|
|
|
|
### Zarządzanie Przepływem Danych
|
|
|
|
- **Logika Gałęzi**: Używaj gałęzi po Przeszukaniu Rekordów
|
|
- **Wykorzystanie Zmiennych**: Wykorzystuj dane z poprzednich kroków
|
|
- **Walidacja Danych**: Waliduj dane wejściowe w akcjach kodowych
|
|
- **Mapowanie Pól**: Zaplanuj transformacje danych starannie
|
|
|
|
### Monitorowanie i Utrzymanie
|
|
|
|
- **Regular Monitoring**: Check workflow runs for errors
|
|
- **Performance Review**: Analyze execution times and success rates
|
|
- **Zarządzanie Aktualizacjami**: Testuj zmiany w wersji roboczej przed aktywacją
|
|
- **Koordynacja Zespołowa**: Dokumentuj przepływy pracy dla członków zespołu
|
|
|
|
Zobacz [Automatyzacje wewnętrzne](/l/pl/user-guide/workflows/internal-automations) i [Integrację narzędzi zewnętrznych](/l/pl/user-guide/workflows/external-tool-integration) dla przykładów
|