ToggleField

Zastosowanie

Funkcja ToggleField pokazuje albo ukrywa wskazane pole w formularzu bieżącej sprawy, zależnie od wartości drugiego argumentu.

Efekt działania

Dla true pole jest widoczne, dla false pole jest ukryte. Jeżeli użytkownik ma do pola tylko prawo odczytu, pokazane pole jest widoczne, ale nieedytowalne.

Zmiana widoczności jest tymczasowym efektem interfejsu. Nie zapisuje się w bazie danych i może zmienić się po odświeżeniu strony, ponownym otwarciu sprawy albo ponownym przeliczeniu reguł. Jeżeli efekt ma się utrzymywać podczas edycji, używaj funkcji w regule automatycznej, która przelicza się w trakcie pracy z formularzem.

Składnia

ToggleField("fieldName",visible);

Argumenty

Argument	Typ	Wymagany	Opis
`fieldName`	tekst	Tak	Nazwa pola, które ma zostać pokazane albo ukryte.
`visible`	wartość logiczna	Tak	`true` pokazuje pole, `false` je ukrywa. Pusta wartość działa jak `false`.

Zwracana wartość

Funkcja zawsze zwraca true.

Przykłady

Przykład 1: widoczność zależna od pola

Pole Quantity jest widoczne, gdy pole show ma wartość true. W przeciwnym razie jest ukryte.

ToggleField("Quantity",[show]);

Dobre praktyki

Podawaj nazwę pola, które istnieje w formularzu.
Jako drugi argument przekazuj pole typu Tak/Nie, zmienną albo warunek, który daje wartość logiczną.

Typowe błędy

Nazwa pola z błędem. Jeżeli nazwa jest wpisana wprost, walidacja reguły zgłosi nieistniejące pole. Jeżeli nazwa pochodzi ze zmiennej, widoczność pola się nie zmieni. Sprawdź nazwę pola w konfiguracji formularza.
Drugi argument, który nie jest wartością logiczną, np. tekst "tak". Reguła zakończy się błędem. Przekaż true, false albo wartość pola typu Tak/Nie.