Dowiedz się, jak weryfikować dane w Tulip za pomocą widżetów, przycisków i wyzwalaczy.
Wykorzystanie walidacji danych wprowadzanych przez operatorów ogranicza problemy związane z jakością i standaryzuje formularze stosowane w procesie. Jeśli użytkownik wprowadzi wartość danych, która nie spełnia wymagań walidacji, pojawi się komunikat o błędzie. Ponadto można zastosować logikę wyzwalaczy, aby uniemożliwić operatorowi kontynuowanie pracy z aplikacją, jeśli wprowadzone dane nie spełniają wymagań.
Walidacja danych sprawia, że tworzenie aplikacji przebiega znacznie płynniej, zapewniając następujące korzyści:
- Uproszczenie zarządzania wyzwalaczami – zmniejszenieliczby i złożoności wyzwalaczy w celu usprawnienia tworzenia i utrzymania aplikacji. Poświęcaj mniej czasu na tworzenie aplikacji.
- Tworzenie dynamicznych kroków: Dodajdynamiczną kontrolę do aplikacji dzięki funkcji włączania/wyłączania przycisków, co zapewnia większą interaktywność i elastyczność.
- Mniejsze nakłady na konserwację aplikacji: Poświęćmniej czasu na przeglądanie i zrozumienie aplikacji. Kopiuj i wklejaj widżety bez obaw o konsekwencje związane z wyzwalaczami.
Możesz również zapewnić intuicyjną obsługę aplikacji dzięki dynamicznie włączanym i wyłączanym przyciskom.
Reguły walidacji dostępne dla poszczególnych widżetów wejściowych
Chociaż do walidacji danych można używać każdego widżetu wejściowego, niektóre z nich posiadają reguły walidacji służące do ustawiania parametrów danych. Poniższa tabela przedstawia reguły walidacji dostępne dla każdego Input Widget.
| Widżet wprowadzania danych | Reguły walidacji |
|---|---|
| Pole wyboru | Nie dotyczy |
| Tekst | Zawiera, Nie zawiera, Zaczyna się od, Kończy się na, Maksymalna liczba znaków, Minimalna liczba znaków, Jest adresem e-mail, Jest adresem URL (zgodnie z tym) |
| Wielowierszowy | Zawiera, Zaczyna się od, Kończy się na, Maksymalna liczba znaków, Minimalna liczba znaków, Nie zawiera |
| Plik | Nie dotyczy |
| Liczba | Równa się, Nie równa się, Większa niż, Większa lub równa, Mniejsza niż, Mniejsza lub równa, W przedziale (włącznie), Poza przedziałem (wyłącznie), Dokładna liczba miejsc po przecinku |
| Wybór pojedynczy | Nie dotyczy |
| Wybór wielokrotny | Minimalna liczba wybranych, Maksymalna liczba wybranych |
| Selektor dat | Jest, Przed, Po, W zakresie (włącznie), Poza zakresem (wyłącznie), W dniu lub wcześniej, W dniu lub później |
| Obraz | Nie dotyczy |
| Podpis elektroniczny | Nie dotyczy |
Utwórz regułę walidacji
- Wybierz widżet wejściowy, dla którego dostępne są reguły walidacji (patrz tabela powyżej).
- W panelu kontekstowym kliknij ikonę + obok pozycji „Reguły walidacji”.
- Wybierz regułę, którą chcesz dodać do widżetu wprowadzania danych.

- Wybierz źródło danych, które ma być sprawdzane przez regułę. Może to być wartość statyczna lub zmienna.

- Kliknij przycisk „+”, aby dodać kolejne reguły.
Zmiana kolejności reguł walidacji
Kolejność reguł walidacji odpowiada kolejności wyświetlania komunikatów o błędach w przypadku nieprawidłowości wprowadzonych danych.
W poniższych przykładach wprowadzone dane nie spełniają obu reguł walidacji. Wyświetlany komunikat o błędzie odnosi się jednak do pierwszej skonfigurowanej reguły.
Przykład 1: „Zawierasłowo Tulip” jest pierwszą regułą, której nie spełniono, więc pojawia się odpowiedni komunikat o błędzie.

Przykład 2: „Zaczyna sięod Hello” jest pierwszą regułą, której nie spełniono, więc pojawia się odpowiedni komunikat o błędzie.

Dzięki temu twórcy aplikacji mogą określić priorytet komunikatów o błędach wyświetlanych operatorowi. Aby zmienić kolejność reguł walidacji, kliknij ikonę z sześcioma kropkami i przeciągnij ją przed lub za daną regułą.

Wymagane dane wejściowe
Oznaczenie reguł walidacji jako wymaganych powoduje dodanie reguły, zgodnie z którą operator musi wypełnić dane wejściowe, aby dane te zostały uznane za prawidłowe. Można to zastosować do wszystkich typów widżetów wprowadzania danych. Gdy widżet wprowadzania danych zostanie oznaczony jako wymagany, obok niego w aplikacji pojawi się czerwona gwiazdka. Aby to zrobić, przełącz suwak „Oznacz jako wymagane ” znajdujący się poniżej nagłówka sekcji „Reguły walidacji” w panelu bocznym.

Komunikaty o błędach walidacji danych wejściowych
Menu rozwijane „Formatowanie błędów ” w sekcji „Reguły walidacji ” na panelu bocznym oferuje opcje określające sposób wyświetlania błędów dotyczących danych wprowadzanych operatorowi podczas działania aplikacji w odtwarzaczu.

Trzy opcje wizualizacji błędów dla operatora: 1. Pokaż komunikat o błędzie reguły walidacji * Obrysowuje pole wprowadzania danymi na czerwono i wyświetla komunikat o błędzie dla operatora 2. Tylko obrys pola wprowadzania danymi * Obrysowuje pole wprowadzania danymi na czerwono 3. Ukryj błąd * Brak wizualnego wskazania
Dynamiczne włączanie i wyłączanie przycisków
Za pomocą dynamicznych elementów sterujących można określić, kiedy operatorzy mogą naciskać przyciski. Gdy przycisk jest wyłączony, jest wyświetlany w stonowanych kolorach, a operator nie może go nacisnąć.

Możesz nawet używać tego elementu sterującego w widżetach podpisu elektronicznego.

Przyciski można dynamicznie włączać lub wyłączać, ustawiając stan „Włączone ” w sekcji „Interakcja ” w panelu bocznym dla wybranego przycisku. Domyślnie stan przycisku jest ustawiony na „Tak”.

Istnieje kilka sposobów dodania dynamicznej kontroli w celu określenia stanu aktywacji przycisku: 1. Określenie zmiennej logicznej 2. Prawidłowość danych wprowadzonych przez użytkownika w kroku zawierającym widżety z regułami walidacji 3. Opcja „Wszystkie widżety”, która sprawdza, czy wszystkie wprowadzone dane spełniają reguły walidacji

- Użyj wyrażenia
Użyj wyrażeń do włączania/wyłączania przycisków
Jeśli chcesz włączyć lub wyłączyć przycisk na podstawie podzbioru widżetów, wybierz opcję „Użyj wyrażenia”, aby napisać własny warunek.
Należy napisać wyrażenie, którego wynikiem jest warunek logiczny (prawda lub fałsz). Jeśli poprawnie skonstruujesz prawidłowe wyrażenie, edytor wyrażeń wskaże to w lewym dolnym rogu.
Przykład 1 Wponiższym przykładzie wykorzystano operację modulo do ustalenia, czy wartość wprowadzona w widżecie do wprowadzania liczb jest nieparzysta czy parzysta. Jeśli wartość jest nieparzysta, przycisk zostanie włączony. Jeśli wartość jest parzysta, przycisk zostanie wyłączony.

Przykład 2: Korzystanie zwyrażeń pozwala również na łączenie dodatkowych warunków. W poniższym przykładzie, aby przycisk został włączony, wartość musi być nieparzysta i spełniać warunki walidacji ustawione dla widżetu wprowadzania liczby.

Poniższa wartość wprowadzona powoduje, że przycisk jest wyłączony. Mimo że wprowadzona wartość jest nieparzysta, nie spełnia ona reguł walidacji widżetu wprowadzania danych.

Poniższa wartość powoduje, że przycisk jest aktywny, ponieważ wprowadzona wartość jest nie tylko nieparzysta, ale również spełnia reguły walidacji widżetu wprowadzania danych.

Walidacja widżetu wprowadzania danych w wyzwalaczach
Walidację widżetu wprowadzania danych można wykorzystać jako część warunku „If” w wyzwalaczu. Pozwala to twórcom aplikacji na szybkie tworzenie logiki, która nie zależy od konkretnych wartości wprowadzonych przez operatorów, ale od poprawności tych wartości.

Informacje o poprawności elementów interfejsu użytkownika można również zapisywać w zmiennych i rekordach tabeli za pomocą wyzwalaczy.

Czy znalazłeś to, czego szukałeś?
Możesz również przejść na stronę community.tulip.co, aby zadać pytanie lub sprawdzić, czy inni mieli podobny problem!

