Konstruktor reguł

Wstęp

Konstruktor reguł pozwala dodawać logikę warunkową do formularzy w szybki i intuicyjny sposób, bez użycia ani jednej linii kodu. Wystarczy dodać szereg warunków do spełnienia, aby zaimplementować szereg działań, takich jak ukrywanie/pokazywanie elementów HTML, włączanie/wyłączanie pól, kopiowanie wartości pól, pomijanie stron i wykonywanie obliczeń.

Aby uzyskać dostęp do Konstruktora reguł należy przejść do Menedżera formularzy , kliknąć Akcje odpowiadający formularzowi, z którym będziesz pracować, a następnie Reguły warunkowe .

Wymagania

Przed użyciem Konstruktora reguł formularz musi zawierać co najmniej jedno pole. W przeciwnym razie zostanie wyświetlony komunikat ostrzegawczy.

Żadnych ograniczeń

Nie masz żadnych ograniczeń w tworzeniu reguł warunkowych. Możesz utworzyć dowolną liczbę reguł, warunków, warunków podrzędnych i akcji.

Dodaj swoją pierwszą regułę

W tym przykładzie powinieneś utworzyć formularz kontaktowy z czterema polami:

• Nazwa (pole tekstowe)
• E-mail (pole e-mail)
• Wiadomość (obszar tekstowy)
• Przycisk (z tekstem Prześlij)

Następnie przejdź do Menedżera formularzy, znajdź swój formularz, kliknij przycisk Akcje, a następnie kliknij Reguły warunkowe.

1. Pierwszą rzeczą, którą zauważysz po wejściu do Kreatora reguł formularza, jest pusty panel z przyciskiem Dodaj regułę. Kliknij ten przycisk, aby utworzyć pierwszą regułę.
2. Następnie zobaczysz dwie linie, pierwsza odnosi się do warunków, a druga do działań.
3. Po kliknięciu przycisku Dodaj warunek pojawi się pierwsze pole formularza, a za nim zestawienie. W naszym przykładzie pierwszym polem formularza jest pole tekstowe z etykietą „Nazwa”, więc Konstruktor reguł wyświetli warunek'Name' 'is present' .
4. Teraz kliknij przycisk Dodaj akcję i zwróć uwagę, że pojawia się kilka list wyboru. Pierwsza lista pokazuje akcję do wykonania (w tym przykładzie pozostaw opcję „Pokaż”); druga pokazuje Typ wyniku (w tym przykładzie zostaw „Pole”), a trzecia, pierwsza etykieta pola: „Nazwa”. W tym przykładzie zmienisz to na „Prześlij” (tekst „Prześlij” odnosi się do przycisku).
5. Wreszcie, w prawym górnym rogu tej reguły zobaczysz małe pomarańczowe ostrzeżenie „Niezapisane zmiany”, a następnie zielony przycisk z ikoną Sprawdź. Kliknij ten przycisk, aby zapisać tę regułę. Ostrzeżenie zniknie.

Utworzyłeś swoją pierwszą regułę.

Jeśli zobaczysz swój formularz, zauważysz, że przycisk zniknął, ale jeśli wpiszesz tekst w polu „Nazwa”, przycisk się pojawi.

Należy mieć świadomość, że niektóre zasady spełniają się dwukierunkowo; oznacza to, że jeśli warunek został spełniony, akcja zostanie wykonana. Jeśli jednak warunek nie zostanie spełniony, zostanie wykonana akcja odwrotna (Pokaż <=> Ukryj, Włącz <=> Wyłącz, Matematyka <=> Resetuj do O).

Możesz dodać dodatkowe reguły, klikając przycisk „Dodaj regułę”, ale nie zostanie to zapisane, dopóki nie naciśniesz zielonego przycisku. Pamiętaj, że każda reguła będzie przechowywana osobno.

Uwaga: Aby usunąć regułę , kliknij czerwony przycisk z ikoną Kosza. Ponadto, jeśli chcesz przerwać wykonywanie reguły na określony czas, możesz ją wyłączyć, a następnie włączyć, gdy będzie potrzebna.

Anatomia reguły

Reguła warunkowa składa się z trzech części: nazwy/opisu, warunków i akcji.

Nazwa/Opis

Pierwsza część pozwala nam opisać logikę warunkową. Po prostu użyj kilku słów, aby nazwać lub opisać, co chcesz osiągnąć za pomocą tej reguły. (Opcjonalnie. Maksymalna długość: 255)

Warunki

Jest to druga część reguły, znajdująca się na początku i pozwalająca określić pole lub pola, które mają zostać poddane ocenie, jako rodzaj oceny.

• Typ warunku : Typ warunku wskazuje, ile warunków musi zostać spełnionych, aby akcja została wykonana. Może to być: Wszystko, Dowolne lub Żadne. Wartość domyślna to Wszystkie.
• Stan: Czy oświadczenie odnosi się do pola formularza i musi zostać wypełnione. Składa się z 3 części.
  • Nazwa : Nazwa pola formularza, na którym opiera się warunek.
  • Operator : Operator porównania używany do oceny warunku.
  • Wartość : Jest to dowolna wartość, którą użytkownik musi wprowadzić w Formularzu. Sposób definiowania wartości będzie się różnić w zależności od typu pola i typu operatora.
• Wiele warunków : do reguły możesz dodać wiele warunków. Rodzaj warunku wskaże, czy wszystkie muszą zostać spełnione (AND), czy jakiś warunek (OR) czy żaden.
• Grupa warunków : oprócz warunków reguła może zawierać grupę warunków. Grupa warunków różni się od warunku umożliwiającego zmianę typu warunku. Zatem reguła może być typu All (AND), ale grupa może być typu Any (OR).
• Proces oceny : Proces oceny warunków odbywa się od góry do dołu. Oznacza to, że warunki na początku zostaną ocenione przed tymi, które znajdują się na końcu, w kolejności malejącej.

Uwaga: Warunki „ Należy do ” i „ Nie należy do ” mogą analizować wiele wartości oddzielonych znakiem „|”, pozwala to na porównanie wartości pola z wieloma wartościami, jeśli jedna z nich pasuje, akcja zostanie wykonana.

Działania

Ostatnia część reguły wskazuje akcję, która ma zostać wykonana, jeśli zostaną spełnione warunki. Jako warunki działania można łatwo zrozumieć w deklaratywny sposób.

Akcja składa się zasadniczo z trzech części:

• Typ akcji:
  • Pokaż/Ukryj
  • Włącz / wyłącz
  • Kopiuj : umożliwia skopiowanie wartości pola, innego elementu lub wartości statycznej i automatyczne wklejenie jej do innego pola. Świetnym przykładem tego, gdzie jest to przydatne, jest formularz, w którym możesz zbierać adres wysyłki i rozliczeń. Użytkownik końcowy może wprowadzić swój adres wysyłki i zaznaczyć opcję Kopiuj, aby automatycznie wypełnić pola adresu rozliczeniowego tymi samymi danymi. Innym częstym przypadkiem użycia jest użycie statycznej pustej wartości do wyczyszczenia pola za pomocą logiki warunkowej.
  • Matematyka : umożliwia dodawanie / odejmowanie / mnożenie / dzielenie / resztę pól i wyświetlanie wyniku w innym polu lub elemencie HTML.
  • Oceń : umożliwia ocenę wyrażeń matematycznych (wzór) i ustawienie wyniku w innym polu. Jest także kompatybilny z obliczeniami dat. Na przykład, jeśli chcesz obliczyć pomnożenie dwóch pól i podzielić tę wartość przez 10, użyj następującego wzoru:{{number_1}} * {{number_2}} / 100 . Proszę wziąć pod uwagę, że ocena wyrażeń matematycznych nie działa w przypadku działań przeciwnych. Możesz przeczytać pełną listę zaawansowanych obliczeń obsługiwanych przez Rule Builder dzięki doskonałym Math.js i date-fns .
  • Format liczb : umożliwia formatowanie liczb na różne sposoby i bez konieczności kodowania. Na przykład, aby nadać numerowi format waluty: 10130,25, użyj następującego formatu „0,0,00 USD”, a liczba będzie teraz wyświetlana jako 10 130,25 USD. Ponadto domyślnie format przyjmie ustawienia regionalne języka wybranego w konfiguracji formularza, więc na przykład, jeśli naszym językiem formularza jest niemiecki, otrzymamy: €10 130,25. Pełną listę formatów obsługiwanych przez Rule Builder możesz przeczytać dzięki doskonałej bibliotece Numeral.js .
  • Format tekstu : umożliwia wybranie wielu pól w celu utworzenia nowego sformatowanego ciągu tekstowego i ustawienia wyniku w innym polu lub elemencie HTML. Np. Aby automatycznie wygenerować adres e-mail, wybierz pole Nazwa i wprowadź następujący format {{0}} @example.com, a następnie wybierz pole E-mail, w którym będzie wyświetlany adres e-mail. Możesz użyć tokenów liczbowych, aby zidentyfikować pozycję pola na liście pól lub możesz użyć identyfikatora pola lub aliasu pola, w naszym przykładzie: {0}@example.com lub {{text_1234}} @example.com lub {{name}} @example.com powinno działać.
  • Pomiń : Umożliwia zdefiniowanie strony, do której należy przejść, gdy przejdziemy do następnej strony. Tej akcji należy używać wyłącznie w formularzu wieloetapowym.
  • Formularz: Umożliwia ustawienie akcji związanych z formularzem:
    • „Wyślij”: Aby przesłać formularz.
    • „Resetuj”: Aby zresetować formularz.
    • „Następna strona”: aby przejść do następnej strony.
    • „Poprzednia strona”: aby przejść do poprzedniej strony.
• Cel: Będzie się różnić w zależności od rodzaju Akcji. Może być dwojakiego rodzaju:
  • Pole
  • Element
• Nazwa:
  • Jeśli celem jest pole, będzie to nazwa pola.
  • Jeśli obiektem docelowym jest element, będzie to jeden z kilku elementów HTML wybranych przez jQuery. Na przykład:
    • „#abc”: Celem jest element HTML z identyfikatorem „abc”.
    • „.abc”: Celem są wszystkie elementy HTML z „abc” jako klasą CSS.
• Działania przeciwne : Domyślnie włączone są działania przeciwne, ponieważ pomagają w tworzeniu wspólnych reguł warunkowych i czynią je bardziej logicznymi. Przykładowo, jeśli po spełnieniu warunku chcę wyświetlić pole, to wyraźnie nie spełniając warunku, chcę zachować to pole w ukryciu. Są jednak sytuacje, w których pomocne może być wyłączenie przeciwnych działań. Gdy to nastąpi, zostanie wykonana tylko akcja opisana w regule.

Należy pamiętać, że użycie elementów wymaga podstawowej znajomości jQuery, ale oferuje duże korzyści. Na przykład możesz utworzyć akcję ukrywającą wszystkie pola formularza;'Hide' 'Element' '.form-group' .

Uwaga: Możesz zidentyfikować identyfikator i klasę CSS pól formularza, korzystając z karty Kod w Konstruktorze formularzy .

Walidacja warunkowa

Możesz pominąć wymaganą walidację pola, używając reguł warunkowych na dwa sposoby:

1. Gdy pole jest ukryte.
2. Gdy pole należy do strony, która została pominięta.

Na przykład, jeśli pole zostało utworzone za pomocą Kreatora formularzy i w regułach warunkowych zdefiniowano, że to pole powinno być wyświetlane tylko wtedy, gdy inne pole spełnia warunek, a warunek nie jest spełniony, to pierwsze pole nie będzie już wymagane (będzie nie zostanie zweryfikowane przez serwer).

Uwaga: aby móc korzystać z walidacji warunkowej, należy wyłączyć weryfikację po stronie klienta. (Zobacz Ustawienia formularza -> Brak sprawdzania) )