Edytor reguł transformacji

Spis treści

• Czym są reguły i jak działają (pipeline przetwarzania)
• Typy reguł — akcje transformacji
  • Tekstowe — modyfikacja zawartości pola
  • Tekstowe — zmiana wielkości liter
  • Numeryczne — operacje matematyczne
  • Zaawansowane — budowanie nowych wartości
• Warunki — kiedy reguła się stosuje (if/then)
  • Operatory logiczne między warunkami
  • Dostępne operatory warunków
• Wyrażenia regularne i funkcje tekstowe
• Kolejność reguł — dlaczego ma znaczenie
• Tworzenie reguły — krok po kroku
• Testowanie reguły na próbce produktów
• Włączanie i wyłączanie reguł
• Kopiowanie reguł między feedami

---

Czym są reguły i jak działają (pipeline przetwarzania)

Reguły to instrukcje, które Sembot wykonuje na danych produktowych po pobraniu pliku źródłowego, a przed wygenerowaniem pliku wyjściowego. Pozwalają modyfikować, uzupełniać, filtrować i transformować atrybuty produktów bez dotykania sklepu ani pliku źródłowego.

Przykłady zastosowań:

• Dodaj markę na początku tytułu każdego produktu, jeśli tytuł jej nie zawiera
• Zastąp wszystkie ceny w kategorii "Wyprzedaż" ceną obniżoną o 20%
• Wyklucz z pliku wyjściowego produkty bez zdjęcia lub z ceną poniżej 5 zł
• Zamień skrót "szt." na "sztuka" we wszystkich opisach

Reguły działają sekwencyjnie — jedna po drugiej, w ustalonej kolejności. Wynik działania jednej reguły staje się wejściem dla następnej. Sembot sygnalizuje to na stronie Reguły układem:

Produkt wejściowy
       ↓
  Reguła nr 1
       ↓
  Reguła nr 2
       ↓
  Reguła nr 3
       ↓
Produkt wyjściowy

Informacja wyświetlana w interfejsie: "Zawartość tabeli produktów jest wynikiem ustanowionych reguł. Reguły działają zależnie. Oznacza to, że wynik działania reguły może być użyty w filtrze kolejnej reguły."

Aby przejść do reguł, wybierz projekt, a następnie w lewym menu kliknij Ustawienia reguł.

---

Typy reguł — akcje transformacji

W Sembocie nie ma sztywnych "typów reguł" — każda reguła ma ten sam schemat: warunki (filtry) + akcja (co zrobić z atrybutem). Rodzaj transformacji określa wybrana akcja. Poniżej zestawienie dostępnych akcji pogrupowanych według zastosowania.

Tekstowe — modyfikacja zawartości pola

Akcja	Co robi
nadpisz	Zastępuje całą wartość pola podanym tekstem
Zamień	Szuka podanego tekstu w polu i zastępuje go innym tekstem
Zamień wyrażenie regularne	Jak "Zamień", ale wzorzec wyszukiwania to wyrażenie regularne (regex)
na początek	Dodaje tekst przed istniejącą wartością pola
na koniec	Dodaje tekst po istniejącej wartości pola
ustaw puste	Czyści wartość pola (ustawia je jako puste)
Podmień duże litery	Wyszukuje wyrazy zapisane WIELKIMI LITERAMI i podmienia je na podaną wartość

Tekstowe — zmiana wielkości liter

Akcja	Efekt
Domyślna czcionka	Pierwsza litera duża, pozostałe małe
Wielkie Litery	Pierwsza litera każdego wyrazu duża
mała czcionka	Cały tekst małymi literami
DUŻA CZCIONKA	Cały tekst wielkimi literami

Numeryczne — operacje matematyczne

Akcja	Co robi
dodaj	Dodaje podaną liczbę do wartości pola
odejmij	Odejmuje podaną liczbę od wartości pola
pomnóż	Mnoży wartość pola przez podany współczynnik
podziel	Dzieli wartość pola przez podany dzielnik

Akcje numeryczne są przydatne np. do automatycznego naliczania marży, przeliczania cen między rynkami czy zaokrąglania wartości.

Zaawansowane — budowanie nowych wartości

Akcja	Co robi
generowanie wartości	Buduje nową wartość pola ze sklejenia kilku innych atrybutów i dowolnego tekstu
dodaj wartość znalezioną w polu	Wyszukuje wartość w jednym polu i kopiuje ją do innego
wyszukiwanie wielokrotne	Szuka wielu wzorców jednocześnie — przydatne do masowych zamian słownikowych
Modyfikuj link	Dodaje, usuwa lub modyfikuje parametry w adresie URL (np. parametry UTM)
Ustaw główne zdjęcie	Ustawia jako zdjęcie główne produktu zdjęcie z wybranej pozycji (pierwsze, ostatnie lub o podanym indeksie)

---

Warunki — kiedy reguła się stosuje (if/then)

Każda reguła może mieć zestaw warunków (filtrów), które określają na jakich produktach zostanie wykonana. Jeśli produkt nie spełnia warunków — reguła go pomija.

Logika działania:

• Bez warunków — reguła stosuje się do wszystkich produktów
• Z warunkami — reguła stosuje się tylko do produktów spełniających wszystkie (lub dowolne) warunki

Operatory logiczne między warunkami

Operator	Znaczenie
oraz	Produkt musi spełnić WSZYSTKIE warunki jednocześnie
lub	Wystarczy, że produkt spełni JEDEN z warunków

Warunki można grupować — każda grupa ma własny operator logiczny, a grupy łączy kolejny operator. Daje to pełną elastyczność budowania złożonych kryteriów.

Dostępne operatory warunków

Dla pól tekstowych

Operator	Znaczenie
Jest pusty	Pole nie ma żadnej wartości
nie jest pusty	Pole posiada jakąkolwiek wartość
równy	Wartość pola dokładnie odpowiada podanemu tekstowi
Zawiera	Pole zawiera podany ciąg znaków (gdziekolwiek)
Nie zawiera	Pole nie zawiera podanego ciągu znaków
rozpoczyna się	Wartość pola zaczyna się od podanego tekstu
zakończony	Wartość pola kończy się podanym tekstem
Zawiera jedną z wartości	Pole zawiera przynajmniej jedną z podanych wartości
Istnieje w	Wartość pola należy do podanej listy wartości
Nie istnieje w	Wartość pola nie należy do podanej listy wartości
regexp	Wartość pola pasuje do wyrażenia regularnego
CAPSLOCK użyty	Wartość pola jest zapisana wielkimi literami
zawiera zmiany ręczne	Produkt był ręcznie edytowany w Sembocie

Dla pól numerycznych

Operator	Znaczenie
=	Liczba równa podanej wartości
>	Liczba większa niż podana wartość
>=	Liczba większa lub równa podanej wartości
<	Liczba mniejsza niż podana wartość
<=	Liczba mniejsza lub równa podanej wartości
Top N	N produktów o najwyższej wartości (np. 10 najdroższych)
Bottom N	N produktów o najniższej wartości (np. 10 najtańszych); maks. 1000 produktów

---

Wyrażenia regularne i funkcje tekstowe

Akcja Zamień wyrażenie regularne oraz operator warunków regexp pozwalają używać wyrażeń regularnych (regex) do precyzyjnego dopasowania wzorców w tekście.

Wyrażenia regularne sprawdzają się gdy:

• Chcesz usunąć wszystkie liczby z tytułu produktu
• Chcesz znaleźć produkty, których EAN ma nieprawidłowy format (nie 13 cyfr)
• Chcesz zamienić dowolny tekst w nawiasach na pusty ciąg
• Chcesz dopasować wzorzec kodu produktu (np. [A-Z]{2}\d{4})

Pole regex nie ma wbudowanego testera — zalecane jest wcześniejsze przetestowanie wzorca w zewnętrznym narzędziu (np. regex101.com), a następnie wklejenie gotowego wyrażenia do formularza.

Opcje dodatkowe przy akcjach tekstowych

Przy akcjach Zamień i Zamień wyrażenie regularne dostępne są opcje precyzujące działanie:

Opcja	Co robi
dopasuj rozmiar czcionki	Rozróżnia wielkość liter — "Nike" i "nike" to różne wzorce
Pełne dopasowanie słów	Dopasowuje tylko całe wyrazy, nie fragmenty słów

Przy akcji Modyfikuj link dostępne są:

Opcja	Co robi
Dodaj parametr	Dodaje nowy parametr do URL (np. ?utm_source=sembot)
Usuń parametr	Usuwa wskazany parametr z URL
Pomiń istniejące	Nie nadpisuje parametru, jeśli już istnieje w URL

---

Kolejność reguł — dlaczego ma znaczenie

Reguły wykonywane są w kolejności od góry do dołu — reguła nr 1 jako pierwsza, reguła nr 2 na jej wyniku, itd. Kolejność ma krytyczne znaczenie, ponieważ każda reguła "widzi" dane już przetworzone przez poprzednie.

Przykład wpływu kolejności:

Masz dwie reguły:

1. Dodaj na początku tytułu: "Nike — "
2. Zamień w tytule: "Nike" → "NIKE"

Jeśli reguła 1 jest przed regułą 2: tytuł "Buty sportowe" → "Nike — Buty sportowe" → "NIKE — Buty sportowe" ✓

Jeśli reguła 2 jest przed regułą 1: tytuł "Buty sportowe" → "Buty sportowe" (brak słowa "Nike", więc nic nie zmienione) → "Nike — Buty sportowe" (słowo "Nike" dodane, ale nie NIKE) ✗

Zmiana kolejności reguł

Na liście reguł każdy wiersz ma uchwyt do przeciągania (ikona po lewej stronie). Chwyć wiersz i przeciągnij go na docelową pozycję — Sembot automatycznie zapisze nową kolejność. Numer porządkowy w kolumnie po lewej aktualizuje się na bieżąco.

---

Tworzenie reguły — krok po kroku

Kliknij Dodaj regułę na stronie Ustawienia reguł. Otworzy się dwuetapowy kreator.

Krok 1 — Ustaw filtry

W tym kroku określasz, których produktów dotyczy reguła. Po prawej stronie formularza wyświetla się na bieżąco tabela produktów — pokazuje tylko te produkty, które aktualnie spełniają ustawione warunki. To wbudowany podgląd testowy.

Jak korzystać z podglądu:

1. Dodaj warunek klikając Dodaj filtr
2. Wybierz pole produktu (np. brand, price, title), operator (np. Zawiera) i wartość (np. "Nike")
3. Tabela po prawej natychmiast filtruje się i pokazuje produkty pasujące do warunku
4. Sprawdź czy lista produktów jest zgodna z oczekiwaniami — jeśli nie, koryguj warunki

Nad tabelą dostępne są szybkie filtry tekstowe: Szukaj po tytule, Szukaj po marce, Szukaj po typie produktu, Szukaj po ID rodzica — ułatwiają szybkie znalezienie konkretnych produktów w podglądzie.

Jeśli chcesz żeby reguła działała na wszystkich produktach, pomiń filtry i od razu kliknij Następny krok.

Krok 2 — Ustaw akcje

W tym kroku określasz co ma się stać z atrybutem produktu. Wybierz:

1. Pole docelowe — który atrybut produktu ma być zmieniony (np. title, price, description)
2. Rodzaj akcji — co zrobić z tym atrybutem (np. na początek, Zamień, pomnóż)
3. Wartość — parametr akcji (np. tekst do dodania, liczba do mnożenia, wzorzec do zamiany)

Po uzupełnieniu kliknij Zapisz — reguła pojawi się na liście i zostanie aktywowana.

---

Testowanie reguły na próbce produktów

Sembot nie posiada osobnego przycisku "Testuj regułę" — testowanie odbywa się przez podgląd w czasie rzeczywistym podczas tworzenia reguły.

W kroku 1 (Ustaw filtry): tabela produktów po prawej stronie pokazuje w czasie rzeczywistym, które produkty spełniają ustawione warunki. Możesz ocenić czy zasięg reguły jest prawidłowy — np. czy obejmuje 200 produktów zamiast wszystkich 5000.

Po zapisaniu reguły: lista reguł na stronie Ustawienia reguł pokazuje skróconą definicję każdej reguły — warunki w kolumnie Filtry i akcję w kolumnie Akcje. Kliknięcie Pokaż więcej przy filtrach rozwinię pełną listę warunków.

Weryfikacja efektu: po zapisaniu reguły jej wynik jest widoczny w tabeli produktów — przejdź do Twoje produkty, znajdź produkt objęty regułą i sprawdź wartości atrybutów.

---

Włączanie i wyłączanie reguł

Każda reguła na liście ma przełącznik aktywności (lewa kolumna). Wyłączona reguła jest pomijana podczas przetwarzania — produkty przechodzą przez nią bez zmian. Wyłączenie nie usuwa reguły ani jej konfiguracji.

• Kliknięcie przełącznika → Reguła została włączona lub Reguła została wyłączona
• Jeśli reguła zawiera błąd konfiguracji, nie można jej włączyć: "Reguła zawiera błąd i nie może zostać włączona."

Wyłączone reguły są wyświetlane szarym tekstem na liście.

---

Kopiowanie reguł między feedami

Sembot nie posiada przycisku "Kopiuj regułę do innego projektu" w interfejsie. Alternatywne metody przenoszenia reguł:

Szablony reguł — gotowe zestawy reguł dla typowych scenariuszy, które można zastosować w dowolnym projekcie jednym kliknięciem. Kliknij Przeglądaj szablony na stronie Reguły.

Szablony są podzielone na kategorie:

Kategoria	Zastosowanie
Czyszczenie	Usuwanie zbędnych znaków, spacji, skrótów
Wzbogacanie	Uzupełnianie brakujących atrybutów z innych pól
SEO	Optymalizacja tytułów i opisów pod wyszukiwarki
Jakość	Weryfikacja i poprawa kompletności danych
Zgodność	Dostosowanie do wymagań kanałów reklamowych
Etykiety	Tagowanie produktów według kryteriów
Wykluczenia	Filtrowanie produktów niespełniających kryteriów
Sezonowe	Reguły aktywne w określonym kontekście czasowym

Szablony można filtrować po kategorii, integracji (np. Google Merchant Center) oraz wyszukiwać po nazwie. Liczba wyników wyświetlana jest jako "X szablonów".

Po wybraniu szablonu kliknij Użyj szablonu — reguła zostanie zaaplikowana do aktualnego projektu z możliwością dostosowania przed zapisem.

Generowanie reguł przez AI — przycisk Generuj przez AI na stronie szablonów pozwala wygenerować zestaw reguł dopasowanych do projektu. Wygenerowane reguły trafiają do ekranu Przejrzyj wygenerowane reguły, gdzie możesz je przejrzeć, edytować kolejność, usunąć zbędne i wybrać czy zapisać je jako aktywne (Zapisz i aktywuj) lub jako szkice (Zapisz jako szkic).