Zaawansowana automatyzacja z n8n 3/3 #EN74

TL;DR:

Obsługa plików w n8n umożliwia przetwarzanie obrazów, dokumentów i innych typów plików dzięki specjalnemu widokowi binarnemu
Węzły do kompresji/dekompresji plików pozwalają na efektywne zarządzanie wieloma plikami w jednym cyklu pracy
W wersji Enterprise dostępne są trzy poziomy użytkowników: Owner, Admin i Member – każdy z różnymi uprawnieniami
Zapisywanie danych wykonania ułatwia wyszukiwanie konkretnych przebiegów według istotnych identyfikatorów (np. ID zamówienia)
Kontrola wersji oparta na Git umożliwia tworzenie oddzielnych środowisk (deweloperskie i produkcyjne)
Zmienne niestandardowe pozwalają na używanie różnych wartości w różnych środowiskach bez konieczności modyfikacji przepływów
Dodatkowe funkcje bezpieczeństwa obejmują zewnętrzne przechowywanie wrażliwych informacji i strumieniowanie logów

Wprowadzenie do zaawansowanych funkcji n8n

n8n to potężne narzędzie do automatyzacji procesów, które w zaawansowanych zastosowaniach oferuje znacznie więcej niż podstawowe łączenie aplikacji. W ramach kursu zaawansowanego n8n (odcinki 7 i 8) przedstawione zostały dwie kluczowe funkcjonalności: obsługa plików oraz funkcje dostępne w wersji Enterprise, które mogą znacząco zwiększyć efektywność i bezpieczeństwo automatyzacji, ponieważ wprowadzają nowy poziom kontroli nad przepływami pracy.

Obsługa plików w n8n

Czym jest widok binarny i jakie daje korzyści?

Podczas pracy z plikami w n8n, wynik działania węzła oferuje nową opcję zwaną „widokiem binarnym” (Binary view), dostępną obok standardowych widoków JSON, tabela i schemat.

Najważniejsze cechy widoku binarnego:

Podgląd zawartości plików bezpośrednio w interfejsie n8n
Możliwość pobierania plików na dysk komputera
Dostęp do dodatkowych informacji o pliku (nazwa, katalog, typ, rozmiar)
Wsparcie dla podglądu różnych formatów (np. SVG)

Co ważne, przy pracy wyłącznie z plikami binarnymi, pozostałe widoki (tabela, JSON i schemat) będą puste, dlatego widok binarny staje się kluczowym elementem zarządzania plikami.

Kluczowe węzły do pracy z plikami

Wszystkie węzły związane z obsługą plików znajdują się w kategorii „File”, a wśród nich znajdziemy funkcje:

✅ Kompresowania i dekompresowania plików (format ZIP) ✅ Odczytywania i zapisywania plików z/na dysk ✅ Konwertowania obiektów JSON do/z formatu plików

Funkcje te są szczególnie przydatne, jeśli samodzielnie hostujesz n8n, ponieważ umożliwiają efektywną pracę z lokalnymi zasobami.

Praktyczne przykłady obsługi plików

Pobieranie i kompresowanie plików:

Użyj węzła HTTP Request do pobrania logo n8n (format odpowiedzi: plik)
Następnie dodaj kolejny węzeł HTTP Request dla innego obrazu
Zauważ, jak elementy binarne są dodawane obok siebie (nie zamieniają się)
Teraz zastosuj węzeł Compress Files
Na koniec ustaw format wyjściowy jako ZIP i nadaj nazwę (np. „compressed.zip”)

Dekompresowanie i przetwarzanie plików ZIP:

Najpierw pobierz plik ZIP przez węzeł HTTP Request
Następnie użyj węzła Decompress do rozpakowania zawartości (w przykładzie były trzy pliki JPEG)
Później zastosuj węzeł Code do rozdzielenia plików na oddzielne elementy binarne
W końcu buduj dalszy przepływ, przetwarzając każdy plik osobno

Funkcje Enterprise w n8n

Zarządzanie użytkownikami i poziomy dostępu

W wersji Enterprise n8n dostępne są trzy poziomy użytkowników, przy czym każdy z nich posiada różne uprawnienia:

Owner (Właściciel):

Może dodawać i usuwać użytkowników
Ma dostęp do wszystkich przepływów pracy i poświadczeń
Może konfigurować i używać kontroli źródła
Jest tylko jeden właściciel dla każdej instancji n8n
Nie można przenieść własności instancji

Ważne: Nawet właściciel nie może odczytać wrażliwych informacji w poświadczeniach (np. kluczy API), lecz może je tylko używać i udostępniać.

Admin (Administrator):

Ma podobne uprawnienia do właściciela
Mimo to nie ma dostępu do panelu głównego
Ponadto nie może zarządzać rolą właściciela

Member (Członek):

Podstawowy poziom użytkownika
Zarządza jedynie własnymi kontami i przepływami pracy

Zapisywanie i wyszukiwanie danych wykonania

Funkcja Execution Data znacząco ułatwia znajdowanie konkretnych przebiegów wśród setek czy tysięcy wykonań, dzięki czemu oszczędzasz czas na przeglądaniu historii wykonania.

Węzeł Execution Data pozwala zapisać określone pola lub wartości (np. ID zamówienia, ID użytkownika)
Zapisane dane można później łatwo wyszukiwać w zakładce Executions
Ta funkcjonalność jest szczególnie przydatna przy śledzeniu zamówień, transakcji, produktów czy innych obiektów z identyfikatorami

Kontrola wersji i środowiska oparte na Git

n8n w wersji Enterprise wykorzystuje kontrolę wersji opartą na Git, co umożliwia łatwiejsze zarządzanie zmianami w przepływach pracy. Dzięki temu możesz:

Połączyć instancję n8n z repozytorium Git
Tworzyć wiele środowisk n8n powiązanych z gałęziami Git
Implementować typowy wzorzec: środowisko deweloperskie (do testów i zmian) oraz produkcyjne (dla działających procesów biznesowych)

Takie podejście pozwala wprowadzać zmiany w przepływach pracy bez ryzyka uszkodzenia już działających procesów, co jest kluczowe zwłaszcza dla automatyzacji krytycznych dla biznesu.

Kontrola wersji jest szczególnie rekomendowana dla instancji obsługujących przepływy pracy, od których zależy działanie biznesu, dlatego warto ją rozważyć, jeśli tworzysz automatyzacje skierowane do klientów lub zarządzasz zapasami, które bezpośrednio wpływają na biznes w przypadku awarii po aktualizacji.

Zmienne niestandardowe

Zmienne niestandardowe to funkcja, która umożliwia bardziej elastyczne zarządzanie przepływami pracy, ponieważ możesz:

Przechowywać i ponowne wykorzystywać wartości w różnych przepływach pracy
Konfigurować różne wartości dla różnych środowisk
Przechowywać często używane informacje (adresy IP, URL-e)

Na przykład, można mieć zmienną o nazwie „database” z różnymi wartościami w środowiskach produkcyjnym i deweloperskim, a więc ten sam przepływ pracy będzie korzystał z odpowiedniej bazy danych w zależności od środowiska – bez konieczności ręcznej zmiany nazw zmiennych przy wdrażaniu.

Zmienne można tworzyć na stronie Variables, gdzie przypisujesz im pary klucz-wartość (klucze poniżej 50 znaków, wartości poniżej 220). Dostęp do wartości zmiennej uzyskasz za pomocą wyrażenia $vars w wyrażeniach lub węźle Code.

Zewnętrzne zarządzanie kluczami

Funkcja External Secrets pozwala na zwiększenie bezpieczeństwa, gdyż umożliwia:

Przechowywanie wrażliwych informacji uwierzytelniających w zewnętrznym sejfie
Ładowanie poświadczeń do n8n tylko wtedy, gdy są potrzebne
Centralne zarządzanie poświadczeniami używanymi w wielu środowiskach n8n

Choć funkcja nie obsługuje bezpośrednio używania różnych poświadczeń w różnych instancjach, jednak można to osiągnąć łącząc każdą instancję n8n z innym sejfem lub środowiskiem projektu. Na przykład, możesz mieć dwie instancje n8n (dla rozwoju i produkcji) i wykorzystać HashiCorp Vault, tworząc projekt z dwoma środowiskami i generując token dla każdego środowiska.

Strumieniowanie logów

Log Streaming umożliwia lepszą kontrolę nad monitorowaniem, ponieważ pozwala na:

Wysyłanie zdarzeń z n8n do własnych narzędzi logowania
Zarządzanie monitorowaniem n8n w ramach własnych procesów alertowania i logowania
Wybór typów zdarzeń do strumieniowania (audyty, wykonania węzłów, przepływy pracy AI)
Anonimizację zdarzeń audytu, co jest przydatne dla zgodności z przepisami

Konfigurację znajdziesz w zakładce Log Streaming w ustawieniach, gdzie możesz wybrać typ miejsca docelowego (webhook, Sentry, syslog) oraz skonfigurować odpowiednie parametry.

Przykład praktycznego zastosowania

W webinarze pokazano prosty przepływ pracy, który ilustruje połączenie omawianych funkcji:

Najpierw nasłuchuje webhooków na określonym URL
Następnie odbiera informacje takie jak ID zamówienia, nazwa zamówienia, ID klienta, e-mail klienta
Potem wysyła wiadomość Slack w celach raportowania
W zależności od stanu przepływu, dodaje dane do Google Sheets lub wstawia wiersz do bazy danych SQL
Na końcu wykorzystuje węzeł Execution Data do zapisania ID zamówienia

Dzięki temu rozwiązaniu, nawet przy setkach czy tysiącach wykonań dziennie, możesz łatwo znaleźć konkretne wykonanie filtrując po ID zamówienia, co znacząco usprawnia proces zarządzania przepływami pracy.

Większość funkcji Enterprise można znaleźć w panelu Ustawienia, gdzie dostępne są informacje o użytkownikach, strumieniowaniu logów, środowiskach czy zewnętrznych sekretach, a ponadto zakładka po lewej stronie zawiera zmienne, które można dodawać i używać w różnych środowiskach.

Ten artykuł jest częścią serii notatek z wartościowych webinarów. Przedstawione informacje pochodzą bezpośrednio z kursu zaawansowanego n8n (odcinki 7 i 8), pokazującego zaawansowane funkcje obsługi plików oraz możliwości wersji Enterprise.