SetUserFieldSettings

Zastosowanie

Funkcja SetUserFieldSettings ustawia, kogo można wybrać w polu użytkownika: użytkowników wewnętrznych, użytkowników zewnętrznych, grupy i użytkowników systemowych. Pole użytkownika musi mieć ustawienie „dla wszystkich użytkowników”.

Efekt działania

Na liście wyboru pola użytkownika są dostępne tylko te rodzaje pozycji, dla których podasz true.

Zmiana 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

SetUserFieldSettings("FieldTitle", InternalUsers, ExternalUsers, Groups, SystemUsers);

Argumenty

Argument	Typ	Wymagany	Opis
FieldTitle	tekst	Tak	Nazwa pola użytkownika.
InternalUsers	wartość logiczna	Tak	true pozwala wybrać użytkowników wewnętrznych.
ExternalUsers	wartość logiczna	Tak	true pozwala wybrać użytkowników zewnętrznych.
Groups	wartość logiczna	Tak	true pozwala wybrać grupy.
SystemUsers	wartość logiczna	Tak	true pozwala wybrać użytkowników systemowych.

Zwracana wartość

Funkcja zwraca wartość logiczną: false, jeżeli pole użytkownika nie ma ustawienia „dla wszystkich użytkowników”, w przeciwnym razie true.

Przykłady

Przykład 1: tylko grupy

W polu Customer można wybrać tylko grupy.

SetUserFieldSettings("Customer", false, false, true, false);

Dobre praktyki

• Przed użyciem funkcji sprawdź, czy pole użytkownika ma ustawienie „dla wszystkich użytkowników”.
• Podawaj nazwę pola dokładnie tak, jak w konfiguracji formularza.

Typowe błędy

• Nazwa pola z błędem. Reguła zakończy się błędem, bo funkcja nie znajdzie pola. Sprawdź nazwę pola użytkownika w sprawie.
• Pole z innym ustawieniem niż „dla wszystkich użytkowników”. Funkcja niczego nie zmieni i zwróci false. Ustaw w konfiguracji pola opcję „dla wszystkich użytkowników”.
• Argumenty, które nie są wartościami logicznymi, np. tekst "tak". Reguła zakończy się błędem. Przekaż true albo false.

Powiązane funkcje

• SetUserFilter