Funkcja Validate

Dotyczy: Aplikacje kanwy oparte na modelu

Funkcja Validate sprawdza, czy wartość pojedynczej kolumny lub pełnego rekordu jest prawidłowa dla źródła danych.

Opis

Zanim użytkownik prześle zmianę danych możliwe jest natychmiastowe udostępnienie opinii dotyczącej poprawności tego przesyłania, co pozytywnie wpływa na środowisko pracy użytkownika.

Źródła danych mogą dostarczać informacje o sposobie definiowania prawidłowych wartości w rekordzie. Te informacje mogą obejmować wiele ograniczeń, takie jak w następujących przykładach:

• czy kolumna wymaga podania wartości
• jak długi może być ciąg tekstowy
• jaka może być największa, a jaka najmniejsza wartość liczbowa
• jaka może być najwcześniejsza, a jaka najpóźniejsza data

Funkcja Validate używa tych informacji, aby określić, czy wartość jest prawidłowa, i zwracać odpowiedni komunikat o błędzie, jeśli nie. Możesz użyć funkcji DataSourceInfo , aby wyświetlić te same informacje, które Validate używają.

Źródła danych różnią się w zakresie ilości udostępnianych informacji dotyczących weryfikacji. Czasami nie udostępniają ich w ogóle. Validate może tylko zweryfikować wartości na podstawie tych informacji. Nawet jeśli Validate nie znajdziesz problemu, zastosowanie zmiany danych może nadal zakończyć się niepowodzeniem. Aby uzyskać informacje o niepowodzeniu, możesz użyć funkcji Errors.

W przypadku Validate znalezienia problemu funkcja zwraca komunikat o błędzie, który można wyświetlić użytkownikowi aplikacji. Jeśli wszystkie wartości są prawidłowe, Validate zwraca wartość pustą. Podczas pracy z kolekcją, która nie zawiera żadnych informacji dotyczących weryfikacji, wartości są zawsze prawidłowe.

Składnia

Validate( Źródło danych, kolumna, wartość )

• DataSource – wymagane. Źródło danych, za pomocą którego ma zostać przeprowadzona weryfikacja.
• Kolumna – wymagane. Kolumna do zweryfikowania.
• Wartość – wymagane. Wartość dla wybranej kolumny, która ma zostać zweryfikowana.

Validate( Źródło danych, OryginalnyRekord, Aktualizacje )

• DataSource – wymagane. Źródło danych, za pomocą którego ma zostać przeprowadzona weryfikacja.
• OriginalRecord - Wymagane. Rekord, którego aktualizacje mają zostać zweryfikowane.
• Aktualizacje - Wymagane. Zmiany, które mają zostać zastosowane względem oryginalnego rekordu.

Przykłady

W poniższych przykładach wartości w kolumnie Wartość procentowa źródła danych Wyniki muszą należeć do zakresu od 0 do 100 (włącznie). Jeśli dane pozytywnie przejdą weryfikację, funkcja zwraca wartość pustą. W przeciwnym razie funkcja zwraca komunikat o błędzie.

Validate z jedną kolumną

Validate z pełnym rekordem