SetUserFilter

Zastosowanie

Funkcja SetUserFilter ustawia filtr dla wskazanego pola użytkownika. Filtr ogranicza wybór do użytkowników z podanych działów albo grup, do podanej listy użytkowników albo zdejmuje ograniczenie.

Uwaga: jeżeli używasz tej funkcji w regule automatycznej, a w procesie używasz też funkcji ForwardCase, zresetuj filtr.

Efekt działania

W polu użytkownika można wybrać tylko osoby, które spełniają filtr.

Zmiana filtra 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

SetUserFilter("FieldTitle");

SetUserFilter("FieldTitle", "FilterType");

SetUserFilter("FieldTitle", "FilterType", "FilterValues");

SetUserFilter("FieldTitle", "FilterType", "FilterValues", SubDepartments);

Argumenty

Argument	Typ	Wymagany	Opis
`FieldTitle`	tekst	Tak	Nazwa pola użytkownika.
`FilterType`	tekst	Nie	Rodzaj filtra: `department` (działy), `group` (grupy), `users` (lista użytkowników) albo `allusers` (wszyscy użytkownicy). Wielkość liter nie ma znaczenia. Wartość `clear` także zdejmuje filtr. Pominięty działa jak `allusers`.
`FilterValues`	tekst	Nie	Nazwy albo identyfikatory działów lub grup albo loginy, identyfikatory lub adresy e-mail użytkowników, rozdzielone znakiem `,` albo `;`. Niepotrzebne dla `allusers` i `clear`.
`SubDepartments`	wartość logiczna	Nie	`true` dołącza działy podrzędne. Działa tylko dla rodzaju filtra `department`. Domyślnie `false`.

Zwracana wartość

Funkcja zwraca true.

Przykłady

Przykład 1: użytkownicy z grup

W polu Employees można wybrać tylko użytkowników z grup Administrators i Programmers.

SetUserFilter("Employees", "Group", "Administrators, Programmers");

Przykład 2: użytkownicy z działów i działów podrzędnych

W polu Employees można wybrać użytkowników z działów Administrators (identyfikator 1) i Programmers (identyfikator 2) oraz z ich działów podrzędnych.

SetUserFilter("Employees", "Department", "1, 2", true);

Przykład 3: lista użytkowników

W polu Employees można wybrać tylko użytkowników z podanej listy.

SetUserFilter("Employees", "Users", "login1, login2@amodit.pl");

Przykład 4: wszyscy użytkownicy

W polu Employees można wybrać dowolnego użytkownika.

SetUserFilter("Employees", "AllUsers");

Dobre praktyki

Podawaj nazwę pola użytkownika dokładnie tak, jak w konfiguracji formularza.
Do zdjęcia filtra używaj rodzaju allusers albo clear.

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.
Nieobsługiwany rodzaj filtra. Filtr się nie zmieni, a funkcja i tak zwróci true. Używaj tylko wartości department, group, users, allusers albo clear.
Brak resetu filtra w regule automatycznej przy użyciu ForwardCase. Filtr może działać w kolejnych krokach niezgodnie z oczekiwaniem. Zresetuj filtr rodzajem allusers albo clear.