Menu użytkownika

Podsumowanie:

Menu użytkownika to menu poleceń dostępne w aplikacji FrontSPA, za pomocą którego użytkownicy końcowi mogą korzystać z aplikacji biznesowych budowanych w nAxiom. Po zdefiniowaniu sekcji menu i dostępnych w nim poleceń należy nadać rolom biznesowym uprawnienia do tych poleceń. Zdefiniowane polecenia menu użytkownika są widoczne tylko dla użytkowników z przypisaną rolą uprawnioną do tego polecenia.

Menu może mieć strukturę wielopoziomową i dzieli się na sekcje, które zawierają pozycje menu. W nAxiom można wyróżnić dwa rodzaje pozycji menu: zwykłe (domyślne) i nadrzędne (wymagane włączenie przełącznika Pozycja nadrzędna). Zarówno sekcje, jak i nadrzędne oraz zwykłe pozycje menu służą do wyświetlania przypisanych formularzy lub widoków listy.

Zawartość menu we FrontSPA można filtrować według aplikacji, do których są przypisywane sekcje menu. Jest to tzw. tryb pojedynczej aplikacji. Oprócz menu wybranej aplikacji, w menu użytkownika wyświetlane są sekcje USTAWIENIA SYSTEMOWE z pozycjami menu zależnymi od uprawnień PBA użytkownika, oraz tzw. sekcja współdzielona, w której wyświetlane są pozycje menu z włączonym ustawieniem Wyświetlaj w sekcji współdzielonej.

☛ AdminSPA > INTERFEJS UŻYTKOWNIKA > Menu użytkownika

Na listach sekcji/pozycji menu w każdym wierszu znajdują się przyciski:

• Edytuj: otwiera okno dialogowe z właściwościami i pozycjami sekcji/pozycji;
• Kopiuj: tworzy nową sekcję o tej samej nazwie i z tymi samymi pozycjami menu;
• Usuń: usuwa sekcję wraz z jej pozycjami lub usuwa pojedynczą pozycję.

Ponadto, w kolumnie Kolejność znajdują się przyciski   , za pomocą których można zmieniać kolejność wyświetlania sekcji w menu użytkownika.

Sekcje menu

Kliknięcie przycisku Dodaj sekcję menu z lewej strony u góry otwiera okno dialogowe Dodanie sekcji menu.

W tym oknie należy określić następujące właściwości:

• Kod: wpisz dowolny ciąg znaków, który będzie identyfikował sekcję menu.
• Nazwa: wpisz nazwę sekcji menu; nazwa sekcji będzie wyświetlana w menu użytkownika.
• Aplikacja: wybierz aplikację, do której zostanie przypisana sekcja menu.
• Moduł: wybierz moduł aplikacji, do którego zostanie przypisana sekcja menu.
• Kolejność: pole tylko do odczytu, które informuje o tym, w jakiej kolejności (licząc od góry) będzie wyświetlana dana sekcja menu; wartość auto wyświetlana dla nowej sekcji oznacza, że będzie ona domyślnie wyświetlana jako ostatnia, co można zmienić, patrz .
• Zwijanie sekcji: włącza możliwość zwijania sekcji menu.
• Domyślnie rozwiń pozycje: jeśli włączono zwijanie sekcji, ten przełącznik pozwala określić, czy sekcja ma być domyślnie rozwinięta.
• Kod formatki: kliknij przycisk Utwórz, aby wyświetlić okno dialogowe Generowanie kodu formatki... i wybrać formularz lub widok listy, który będzie wyświetlany po kliknięciu danej pozycji menu; elementy dostępne w tym oknie opisano poniżej.
• Wyświetlanie nazw elementów menu: określa sposób wyświetlania nazw pozycji menu, które są zbyt długie, aby w całości zmieścić się na panelu menu; dostępne opcje:
  • Wyświetlaj jeden wiersz i dopisuj wielokropek (...)
  • Zawijaj na białym znaku
• Wyświetlana etykieta: zapytanie SQL, które musi zwrócić trzy parametry etykiety wyświetlanej w menu, z prawej strony danego elementu menu:
  • LabelText (nvarchar): tekst wyświetlany na etykiecie.
  • LabelTextColor: szesnastkowy kod koloru tekstu na etykiecie.
  • LabelBackground: szesnastkowy kod koloru tła etykiety.

Info

W zapytaniu są obsługiwane zmienne systemowe (@_UserId, @_LangId, @_TenantId i @_TenantBaseUrl), zmienne aplikacji oraz składnia smart numbers.

Wyboru obiektu wyświetlanego po kliknięciu danej pozycji/sekcji menu dokonuje sie w oknie wyświetlanym po kliknięciu przycisku Utwórz obok właściwości Kod formatki.

1. Wybierz z listy formularz, który ma być otwierany po kliknięciu definiowanej pozycji menu, i kliknij przycisk Utwórz.
   W polu Kod formatki zostanie wpisany kod formularza w formie ciągu /n/0, gdzie n to identyfikator GUID formularza, a 0 oznacza nowy rekord.
2. Aby kliknięcie definiowanej pozycji menu powodowało wyświetlenie widoku listy, w oknie Generowanie kodu formatki... włącz przełącznik Wybieraj wśród zdefiniowanych list.
   Zostanie wyświetlona lista widoków list zdefiniowanych w nAxiom.
3. Wybierz z listy widok listy, który ma być otwierany po kliknięciu definiowanej pozycji menu.
4. (Opcjonalnie) Z listy Filtr wybierz predefiniowany filtr, który będzie stosowany po wyświetleniu listy. Z listy Konfiguracja wybierz konfigurację wyświetlania listy.
5. Kliknij przycisk Utwórz.
   W polu Kod formatki zostanie wpisany kod widoku listy w formie ciągu /grid/edit/n, gdzie n to identyfikator widoku listy.

Pozycje menu

Aby zarządzać pozycjami menu, należy przejść do edycji wybranej sekcji. W oknie dialogowym Edycja sekcji menu u dołu jest wyświetlana lista pozycji menu zdefiniowanych dla tej sekcji.

W ogólności pozycje mają takie same właściwości jak sekcje menu i tak samo się nimi zarządza. Jedna z różnic dotyczy możliwości definiowania zagnieżdżonych pozycji menu. Wymaga to skonfigurowania następujących właściwości:

• Pozycja nadrzędna: włączenie tego przełącznika powoduje, że dana pozycja menu może zostać wskazana jako nadrzędna dla innych pozycji w tej sekcji menu.
• Menu nadrzędne: lista wyboru pozycji nadrzędnej dla pozycji menu.

• Domyślnie rozwiń pozycje: po włączeniu wyświetla pozycje nadrzędne z widocznymi pozycjami podrzędnymi; domyślnie pozycje nadrzędne są zwinięte.

  

• Wyświetlaj w sekcji współdzielonej: (domyślnie wyłączone) pozwala zdecydować, że dana pozycja będzie wyświetlana w sekcji współdzielonej menu, która jest dostępna niezależnie od ustawień trybu pojedynczej aplikacji. W przypadku jeśli w trybie pojedynczej aplikacji będzie wybrana aplikacja macierzysta danej pozycji menu, ta pozycja będzie wyświetlana w „normalnej” sekcji menu, a nie w sekcji współdzielonej. Sekcja współdzielona nie ma wyświetlonej nazwy.

Powiązane tematy:

• Role biznesowe
• Tryb pojedynczej aplikacji

---