Walidacja danych dla widżetów wprowadzania danych

Prev Next

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

  1. Wybierz widżet wejściowy, dla którego dostępne są reguły walidacji (patrz tabela powyżej).
  2. W panelu kontekstowym kliknij ikonę + obok pozycji „Reguły walidacji”.
  3. Wybierz regułę, którą chcesz dodać do widżetu wprowadzania danych.

Validation Rules side pane ex

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

Validation rules configuration ex

  1. 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.

Validation Rule Order Ex1

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

Validation Rule Order Ex2

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łą.

Reorder Validation Rules

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.

Validation rules mark required

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.

Validation rules error formatting

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ąć.

Enabled vs disabled buttons

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

Enabled vs disabled eSignature

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”.

button side pane enabled state yes

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

Button side pane enabled state all widgets

  1. 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.

enable-disable buttons expressions ex1(1)

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.

enable-disable buttons expressions ex2(1)

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.

enable-disable buttons expressions ex2 invalid input

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.

enable-disable buttons expressions ex2 valid input

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.

Input validation trigger ex1

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

Input validation trigger ex2


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!