MENU
    Sprawdzanie poprawności danych za pomocą widżetów wejściowych
    • 23 Jan 2025
    • 4 Minuty do przeczytania
    • Współtwórcy

    Sprawdzanie poprawności danych za pomocą widżetów wejściowych


    Streszczenie artykułu

    Dowiedz się więcej o sposobach walidacji danych w Tulip przy użyciu widżetów, przycisków i wyzwalaczy.

    Korzystanie z walidacji danych dla danych wejściowych operatora zmniejsza kwestie jakości i standaryzuje formularze używane 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 użyć logiki wyzwalania, aby uniemożliwić operatorowi kontynuowanie aplikacji, jeśli wprowadzone dane nie spełniają wymagań.

    Walidacja danych sprawia, że tworzenie aplikacji jest znacznie bardziej płynne i ma następujące zalety:

    • Uproszczenie zarządzania wyzwalaczamiZmniejszenieilości i złożoności wyzwalaczy w celu usprawnienia tworzenia i obsługi aplikacji. Poświęcaj mniej czasu na tworzenie aplikacji.
    • Tworzenie dynamicznych krokówDodajdynamiczną kontrolę do aplikacji poprzez włączanie/wyłączanie funkcji przycisków, umożliwiając większą interaktywność i elastyczność.
    • Mniej konserwacji aplikacjiSpędzajmniej czasu na przeglądaniu i zrozumieniu aplikacji. Kopiuj i wklejaj widżety bez obawy o konsekwencje wyzwalania.

    Możesz także zapewnić intuicyjną obsługę aplikacji dzięki dynamicznie włączanym i wyłączanym przyciskom.

    Reguły walidacji dostępne dla widżetów wejściowych

    Podczas gdy można użyć każdego widżetu wejściowego do walidacji danych, niektóre dane wejściowe mają reguły walidacji do ustawiania parametrów danych. Poniższa tabela przedstawia reguły walidacji dostępne dla każdego Input Widget.

    Widżet danych wejściowychReguły walidacji
    Pole wyboruNIE DOTYCZY
    TekstZawiera, Zaczyna się od, Kończy się na, Maksymalny limit znaków, Minimalny limit znaków, Jest adresem e-mail, Jest adresem URL, Nie zawiera
    WielowierszoweZawiera, Zaczyna się od, Kończy się na, Maksymalny limit znaków, Minimalny limit znaków, Nie zawiera
    PlikNIE DOTYCZY
    LiczbaRówna, Nie równa się, Większa niż, Większa niż lub równa, Mniejsza niż, Mniejsza niż lub równa, Wewnątrz zakresu (włącznie), Poza zakresem (wyłącznie)
    Pojedynczy wybórNIE DOTYCZY
    Wielokrotny wybórWybrane minimum, Wybrane maksimum
    DatapickerJest, Przed, Po, Wewnątrz zakresu (włącznie), Poza zakresem (wyłącznie), Na lub przed, Na lub po
    ObrazNIE DOTYCZY
    ePodpisNIE DOTYCZY

    Tworzenie reguły walidacji

    1. Wybierz widżet wejściowy, który ma dostępne reguły walidacji (patrz tabela powyżej).
    2. W okienku kontekstowym kliknij ikonę + obok pozycji Reguły walidacji.
    3. Wybierz regułę, którą chcesz dodać do widżetu wejściowego.

    Validation Rules side pane ex

    1. Wybierz źródło danych dla walidacji reguły. Może to być wartość statyczna lub zmienna.

    Validation rules configuration ex

    1. Kliknij przycisk +, aby dodać dodatkowe reguły.

    Zmiana kolejności reguł walidacji

    Kolejność reguł walidacji odpowiada pierwszemu komunikatowi o błędzie wyświetlanemu w przypadku niepowodzenia wprowadzonej wartości danych.

    W poniższych przykładach wprowadzone dane nie spełniają obu reguł walidacji. Jednak wyświetlany komunikat o błędzie odnosi się do pierwszej skonfigurowanej reguły.

    Przykład 1"Contains Tulip" jest pierwszą regułą, która nie powiodła się, więc komunikat o błędzie pojawia się odpowiednio.

    Validation Rule Order Ex1

    Przykład 2"Zaczyna się od Hello" jest pierwszą regułą, która nie powiodła się, więc komunikat o błędzie pojawia się odpowiednio.

    Validation Rule Order Ex2

    Aby zmienić kolejność reguł walidacji, kliknij ikonę sześciu kropek i przeciągnij ją przed lub za regułę.

    Reorder Validation Rules

    Wymagaj danych wejściowych

    Oznaczenie reguł walidacji jako wymaganych dodaje regułę, że dane wejściowe muszą zostać uzupełnione przez operatora, aby dane wejściowe zostały uznane za prawidłowe. Można tego użyć dla wszystkich typów widżetów wejściowych. Gdy widżet wejściowy jest oznaczony jako wymagany, obok widżetu wejściowego w aplikacji pojawi się czerwona gwiazdka. Aby to zrobić, przełącz suwak Oznacz wymagane znajdujący się pod nagłówkiem sekcji Reguły walidacji w panelu bocznym.

    Validation rules mark required

    Podpowiedzi błędów walidacji danych wejściowych

    Rozwijane menu Formatowanie błędów w sekcji Reguły walidacji panelu bocznego oferuje opcje wyświetlania błędu z danymi wejściowymi operatorowi, gdy aplikacja jest uruchomiona 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 wejściowe na czerwono i przedstawia operatorowi komunikat o błędzie2. Obrysuj tylko pole wejściowe * Obrysowuje pole wejściowe na czerwono3. Ukryj błąd * Brak wizualnego wskazania

    Dynamiczne włączanie i wyłączanie przycisków

    Zdecyduj, kiedy operator może nacisnąć przycisk za pomocą dynamicznych elementów sterujących. Gdy przycisk jest wyłączony, jest wyświetlany w wyciszonych kolorach i operator nie będzie mógł go nacisnąć.

    Enabled vs disabled buttons

    Możesz nawet użyć tej kontrolki w widżetach podpisu elektronicznego.

    Enabled vs disabled eSignature

    Przyciski mogą być dynamicznie włączane lub wyłączane poprzez ustawienie stanu Enabled w sekcji Interaction panelu bocznego dla wybranego przycisku. Domyślnie stan włączenia przycisku jest ustawiony na Tak.

    button side pane enabled state yes

    Istnieje kilka sposobów na dodanie dynamicznej kontroli w celu określenia włączonego stanu przycisku:1. Określenie zmiennej logicznej2. Sprawdzanie poprawności danych wprowadzonych przez użytkownika w kroku z widżetami wejściowymi, które mają reguły sprawdzania poprawności3. Opcja Wszystkie widżety, która sprawdza, czy wszystkie wprowadzone dane wejściowe spełniają reguły walidacji

    Button side pane enabled state all widgets

    1. Użyj wyrażenia

    Używanie 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ć niestandardowy warunek.

    Musisz napisać wyrażenie, którego wynikiem będzie 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 1Poniższyprzykład wykorzystuje operację modulo do określenia, czy wartość wprowadzona do widżetu 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)

    W poniższymprzykładzie, aby przycisk został włączony, wartość musi być nieparzysta i spełniać warunki walidacji ustawione na widżecie wprowadzania liczb.

    enable-disable buttons expressions ex2(1)

    Poniższa wartość wejściowa powoduje wyłączenie przycisku. Mimo że wprowadzona wartość jest nieparzysta, nie spełnia reguł walidacji widżetu wejściowego.

    enable-disable buttons expressions ex2 invalid input

    Poniższa wartość wejściowa powoduje włączenie przycisku, ponieważ wprowadzona wartość jest zarówno nieparzysta, jak i spełnia reguły walidacji widżetu wejściowego.

    enable-disable buttons expressions ex2 valid input

    Walidacja widżetów wejściowych w wyzwalaczach

    Walidacji widżetów wejściowych można używać jako części 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 ważności tych wartości.

    Input validation trigger ex1

    Informacje o ważności widżetów mogą być również przechowywane w zmiennych i rekordach tabeli za pomocą wyzwalaczy.

    Input validation trigger ex2


    Czy znalazłeś to, czego szukałeś?

    Możesz również udać się na stronę community.tulip.co, aby opublikować swoje pytanie lub sprawdzić, czy inni mieli do czynienia z podobnym pytaniem!


    Czy ten artykuł był pomocny?