Przepływy pracy
Przepływy pracy to potoki automatyzacji wielokrotnego użytku, które przetwarzają przechwycony ruch, wykonują aktywne kroki lub przekształcają dane — bez konieczności pisania samodzielnych skryptów.
Typy przepływów pracy
| Typ | Wyzwalany przez | Typowe zastosowanie |
|---|---|---|
| Pasywny | Nowy przechwycony ruch | Oznaczanie interesujących wzorców, tagowanie żądań, automatyczne tworzenie ustaleń. |
| Aktywny | Ręczne uruchomienie | Wysyłanie kolejnych żądań, łączenie działań, wykonywanie wieloetapowych testów. |
| Konwersja | Dane testowe, akcje konwersji lub Dopasowanie i zamiana | Przekształcanie tekstu lub bajtów, na przykład formatowanie JavaScript lub normalizacja JSON. |
Pasywne przepływy pracy działają stale w tle. Aktywne przepływy pracy są uruchamiane na żądanie dla wybranego zbioru żądań.
Obszar projektowania przepływu pracy
Otwórz Przepływy pracy i wybierz przepływ, aby otworzyć jego obszar projektowania.
- Węzły pojawiają się w środkowym panelu. Każdy węzeł ma porty wejściowe i wyjściowe z określonymi typami.
- Połącz port wyjściowy z wejściowym, klikając i przeciągając między nimi.
- Kliknij węzeł, aby otworzyć jego panel konfiguracji po prawej.
- Pasek narzędzi u góry zawiera kontrolki uruchamiania, włączania i wyłączania oraz importu i eksportu.
Typy węzłów
| Węzeł | Opis |
|---|---|
| Początek / koniec | Węzły wejścia i wyjścia odpowiednie dla przepływu pasywnego, aktywnego lub konwersji. |
| Warunki | Jeśli / w przeciwnym razie, Jeśli / w przeciwnym razie JS, Dopasowanie HTTPQL, Dopasowanie zakresu testów, Ciąg zawiera i Dopasowanie wyrażenia regularnego. |
| Kodowanie | Kodowanie i dekodowanie Base64, URL, szesnastkowe i HTML. |
| Formatowanie i skróty | Minifikacja i formatowanie JSON, MD5, SHA-1 i SHA-256. |
| Operacje tekstowe | Usuwanie znaków z końców, Łączenie, Dzielenie, Dopasuj i zamień, Przekształcenie JQ i Wyodrębnianie Grep. |
| JavaScript | Niestandardowa logika korzystająca z SDK przepływów pracy; może odczytywać ruch, operować na plikach i tworzyć ustalenia. |
| Integracja | Zapis do dziennika, Webhook, Wywołanie przepływu pracy, Wysłanie żądania i Reguła Dopasuj i zamień. |
Użyj palety węzłów, aby sprawdzić rzeczywiste porty i konfigurację. Kliknij połączenie, aby pracować nad tym połączeniem zamiast usuwać węzeł w celu ponownego połączenia grafu. Zapisuj za pomocą Zapisz lub Ctrl+S (Command+S w macOS).
Współdzielenie i zakres
Przepływy pracy są domyślnie współdzielone między projektami w tym samym obszarze roboczym. Włącz Dla tego projektu, aby zachować definicję przy jej projekcie. Współdzielone definicje nie oznaczają współdzielenia ruchu, wyników ani notatek wszystkich projektów. Eksportuj i importuj JSON przepływu pracy przy przenoszeniu do innego obszaru roboczego lub instalacji.
Testowanie przed użyciem z bieżącym ruchem
Pasywne i aktywne przepływy pracy mają sekcję Test HTTP z danymi testowymi URL, surowego żądania i surowej odpowiedzi. Włącz przepływ pracy, wypełnij te pola i kliknij Przetestuj przepływ pracy. Test zapisuje zmiany przed wykonaniem. Wartości testowe są zachowywane dla każdego przepływu podczas przechodzenia do innych widoków i powrotu.
Przepływ konwersji ma zamiast tego Dane wejściowe testu i dane wyjściowe. Zacznij od małych, reprezentatywnych danych, a następnie przetestuj zasób o realistycznym rozmiarze. Dane testowe nie czynią dowolnego JavaScript ani węzłów wysyłania żądań nieszkodliwymi: kod przepływu pracy nadal może wykonywać skonfigurowane działania.
JavaScript i pliki
JavaScript przepływów pracy obsługuje SDK Ogma i zgodne importy fs/path. Używaj sdk.fs.readFile, writeFile, appendFile, exists, readDir, mkdir i unlink do operacji na plikach oraz sdk.path do ścieżek uwzględniających platformę. Są to funkcje pomocnicze Ogma, a nie cała biblioteka standardowa Node.js.
Aby utworzyć eksporter zasobów, odczytaj response.getBody().toText(), wybierz miejsce docelowe za pomocą sdk.path.join, utwórz jego katalog nadrzędny i sprawdź sdk.fs.exists, jeśli nie chcesz nadpisać istniejącego pliku. Sprawdź ścieżki systemu plików przed wykonaniem: funkcje pomocnicze systemu plików przepływu pracy działają na hoście Ogma, inaczej niż sdk.fs wtyczki operujące w prywatnym katalogu. Ten odrębny kontekst wykonania opisano w SDK wtyczek.
Importowanie przepływu pracy
- Kliknij Importuj na pasku narzędzi Przepływy pracy.
- Wybierz plik JSON przepływu pracy.
- Przepływ pracy otworzy się w obszarze projektowania. Sprawdź konfigurację węzłów przed jego włączeniem.
- Zapisz przepływ pracy.
Wyeksportowane pliki JSON przepływów pracy można udostępniać między instalacjami Ogma lub przechowywać w systemie kontroli wersji.
Uruchamianie przepływu pracy na przechwyconej historii
Aktywne przepływy pracy można ponownie uruchamiać na wcześniej przechwyconych żądaniach.
- Otwórz przepływ pracy.
- Kliknij Uruchom na historii.
- W oknie skanowania historii wprowadź opcjonalny filtr HTTPQL ograniczający żądania przetwarzane przez przepływ pracy.
- Kliknij Uruchom.
Sprawdź liczbę dopasowań i rozpocznij zadanie. Postęp i błędy pojawiają się w zadaniu skanowania oraz, gdy rejestrowanie jest włączone, w historii jego uruchomień. Pasywne przepływy pracy oferują Skanuj historię i Uruchom ponownie na żądaniu do przetwarzania wcześniejszego ruchu.
Dla kilku interesujących zasobów zaznacz jeden lub więcej wierszy Historii HTTP, kliknij prawym przyciskiem myszy, wybierz Wyślij do > Przepływ pracy i wskaż włączony aktywny przepływ. Przekazuje to wybrane wpisy bez zmiany jego definicji ani przetwarzania całej historii.
Przycisk AI obok pola filtra skanowania historii generuje wyrażenie HTTPQL na podstawie opisu zwykłym językiem.
Uruchomienia i wyniki przepływu pracy
Zaznacz Włącz rejestrowanie w konfiguracji przepływu pracy, gdy potrzebujesz szczegółów wykonania. Dotyczy to przepływów pasywnych, aktywnych i konwersji, w tym konwersji Dopasowanie i zamiana. Po wyłączeniu przetwarzanie nadal działa, ale nie dodaje logów uruchomień ani kroków; włącz je ponownie i powtórz test, aby zdiagnozować problem.
- Kliknij uruchomienie, aby zobaczyć dane wyjściowe kroków poszczególnych węzłów.
- Węzły, które zgłosiły błędy, są wyróżnione.
- Ustalenia utworzone podczas uruchomienia pojawiają się w widoku Ustalenia.
- Zmienne wyodrębnione podczas uruchomienia są widoczne w panelu szczegółów kroku.
Wyczyść wszystko usuwa zapisaną historię uruchomień wybranego przepływu pracy. Pobierz logi przed wyczyszczeniem, jeśli musisz zachować dowody do debugowania. Rejestrowanie może zapisywać duże dane wyjściowe, takie jak całe treści skryptów, więc pozostaw je wyłączone przy masowych konwersjach, chyba że jest potrzebne.
Włączanie pasywnego przepływu pracy
- Otwórz przepływ pracy.
- Sprawdź, czy konfiguracja obszaru projektowania jest kompletna (brak niepołączonych wymaganych portów).
- Użyj przełącznika Włącz na pasku narzędzi.
Włączone pasywne przepływy pracy automatycznie przetwarzają nowy ruch. Wyłącz przepływ pracy, aby go wstrzymać bez usuwania.