IsValidFieldValue

Zastosowanie

Funkcja IsValidFieldValue sprawdza, czy bieżąca wartość pola jest poprawna albo czy podaną wartość można przypisać do wskazanego pola sprawy. Sprawdzenie nie zmienia wartości pola.

Składnia

IsValidFieldValue("fieldName",["fieldValue"]);

Argumenty

Argument	Typ	Wymagany	Opis
`fieldName`	tekst	Tak	Nazwa pola do sprawdzenia.
`fieldValue`	tekst	Nie	Wartość testowa dla pola. Jeżeli jej nie podasz, funkcja sprawdza bieżącą wartość pola.

Zwracana wartość

Funkcja zwraca wartość logiczną: true, jeżeli wartość można przypisać do pola (albo bieżąca wartość pola jest poprawna), w przeciwnym razie false.

Przykłady

Przykład 1: bieżąca wartość pola

Funkcja sprawdza, czy wartość w polu Customers jest poprawna dla tego rodzaju pola.

isValid = IsValidFieldValue("Customers");

Przykład 2: wartość testowa

Funkcja sprawdza, czy tekst „Datacom” jest poprawną wartością dla pola Customers, i zapisuje wynik w zmiennej isValid.

isValid = IsValidFieldValue("Customers", "Datacom");

Przykład 3: warunek

Funkcja sprawdza, czy „ABC” jest poprawną wartością dla pola Amount. Jeżeli tak, reguła wykonuje kod w bloku warunku.

if(IsValidFieldValue("Amount","ABC")){
//do something
}

Dobre praktyki

Podawaj nazwę pola, które istnieje w sprawie.
Używaj funkcji do sprawdzenia danych przed przypisaniem ich do pola.

Typowe błędy

Nazwa pola, które nie istnieje. Reguła zakończy się błędem. Sprawdź nazwę pola przed wywołaniem funkcji.
Wartość niepasująca do typu pola, np. tekst dla pola liczbowego. Funkcja zwróci false. Przekaż wartość zgodną z typem i formatem pola.
Nazwa funkcji zapisana inną wielkością liter, np. isValidFieldValue. Reguła zakończy się błędem, bo nazwy funkcji rozróżniają wielkość liter. Zapisuj IsValidFieldValue.