Lista wyboru (interesariusz)

Podsumowanie:
Lista wyboru interesariuszy to lista wielowyboru służąca do wyboru konkretnych osób jako członków grupy interesariuszy. Grupy interesariuszy definiuje się w definicji dokumentu. Grupa użytkowników na liście wyboru interesariuszy może być ograniczona przez rolę lub kombinację ról albo przez konfigurację zapytania SQL zwracającego dane do listy.

W aplikacji FrontSPA w kontrolce wyświetlane są także role i role w jednostkach przypisane do grupy interesariuszy, a także użytkownicy dodani za pomocą akcji, których nie ma na rozwijanej liście kontrolki. Kontrolka pozwala na ich usuwanie z grupy interesariuszy, ale ich dodawanie jest możliwe wyłącznie przy użyciu odpowiednich akcji.

Oprócz właściwości typowych dla większości kontrolek, lista wyboru interesariuszy wymaga ustawienia właściwości:

Interesariusz: nazwa grupy interesariuszy określonej w definicji dokumentu.
Minimalna liczba użytkowników: minimalna liczba osób, które trzeba wybrać na liście; jeśli zostanie ustawiono, nie będzie można zapisać formularza bez spełnienia tego warunku, nawet jeśli dla kontrolki będzie wyłączona wymagalność.
Maksymalna liczba użytkowników: maksymalna liczba osób, które można wybrać na liście.
Wymagane role globalne: jedna lub kilka ról biznesowych, które muszą mieć użytkownicy, aby byli dostępni na liście; w przypadku kilku ról wyświetlane będą osoby, które maję przypisane wszystkie role; ustawienie tej właściwości powoduje modyfikację zapytania SQL zwracającego dane do listy.
Jako opis jednostki organizacyjnej wyświetlaj: określa sposób wyświetlania jednostek organizacyjnych, które mogą należeć do grupy interesariuszy; dostępne wartości:
- Kod JO: wyświetla kod jednostki organizacyjnej.
- Nazwę JO: wyświetla nazwę jednostki organizacyjnej.
Wartość domyślna dla użytkowników: można wpisać identyfikator GUID dowolnego użytkownika lub zapytanie, które zwróci listę identyfikatorów użytkowników, na przykład:
```
SELECT [UserProfileId]
FROM [core].[OUInstanceUsers]
WHERE [OUInstanceId] = 17
```
Próba ustawienia wartością domyślną użytkownika, którego nie ma na liście wyboru, nie powiedzie się bez zgłaszania błędu.
Zaznacz/odznacz wszystko: po włączeniu dodaje do listy polecenie, która pozwala zaznaczyć wszystkie pozycje na liście lub anulować zaznaczenie wszystkich pozycji.
Szerokość wybranego elementu: określa szerokość listy w jednostkach rem, a w przypadku listy wielowyboru, szerokość wybranej pozycji listy.
Ustawienia: kliknięcie przycisku Konfiguracja listy wyboru otwiera okno dialogowe, o tej samej nazwie.
SQL: zapytanie SQL zwracające wartości identyfikatorów użytkowników z tabeli [core].[UserProfiles]; to zapytanie musi zwracać co najmniej dwie kolumny o nazwach [key] i [value]; wartości z pola Id mają być zwracane w kolumnie [key], a w kolumnie [value] mogą być zwracane na przykład wartości z kolumny UserName (muszą to być wartości typu tekstowego); wartość zwrócona w kolumnie [value] jest wartością wyświetlaną w kontrolce; nazwy kolumn należy podać w nawiasach prostokątnych. Przykład:
```
SELECT [Id] as [key], [UserName] as [value] FROM [core].[UserProfiles]
```

Ustawiony dla kontrolki warunek wymagalności będzie spełniony także wtedy, gdy w kontrolce będzie wyświetlana rola lub rola w jednostce przypisane do danej grupy interesariuszy. Aby wymusić na użytkowniku końcowym dodanie indywidualnej osoby do grupy przy użyciu kontrolki, należy ustawić właściwość Minimalna liczba użytkowników.

Informacje o wartościach kontrolki wyboru interesariuszy są przechowywane w kontekście formularza w tablicy StakeholdersData z identyfikatorami obiektów przypisanych do grupy interesariuszy podzielonymi na kategorie: UserIds, GlobalRoleIds i OrgUnitRoleIds.

Tablica StakeholdersData w kontekście formularza

|← Lista wielowyboru (SQL) |↑ Do góry |→ Lista wyboru (słownik) |