Widżety

Podsumowanie:

Widżety to elementy interfesju użytkownika wyświetlane w aplikacji FrontSPA na pulpitach (dashboard), na stronie startowej. Dostępnych jest kilka rodzajów widżetów: uproszczona lista, sekcja HTML, wykres, raport i formularz. Konfiguracja widżetów (oprócz widżetu formularza) jest identyczna jak konfiguracja odpowiadających im sekcji formularza. Dodatkowo, w konfiguracji widżetów można zdefiniować parametry, zarówno lokalne, jak i globalne dla widżetów

☛ (AdminSPA) INTERFEJS UŻYTKOWNIKA > Widżety

W tym temacie

• Zarządzanie widżetami
• Konfigurowanie widżetów
• Parametry widżetów

Zarządzanie widżetami

Przyciski obok definicji każdego widżetu pozwalają edytować widżety lub je usuwać. Aby utworzyć nowy widżet kliknij przycisk Nowy widget i uzupełnij podstawowe właściwości widżetu.

• Kod: kod widżetu.
• Nazwa: nazwa widżetu.
• Aplikacja: aplikacja, z którą jest powiązany widżet.
• Moduł: moduł aplikacji , z którą jest powiązany widżet.
• Opis: opis widżetu.
• Typ: rodzaj widżetu; dostępne wartości:
  • Uproszczona lista
  • Sekcja HTML
  • Wykres
  • Raport
  • Formularz
• Dostępny dla roli: lista wielowyboru ról biznesowych; po wybraniu ról widżet będzie dostępny do ustawienia na pulpicie tylko dla użytkowników, którzy mają przypisaną co najmniej jedną z wybranych ról; domyślnie widżety są dostępne dla wszystkich użytkowników; te ustawienia są zapisywane w tabeli core.WidgetRoles.
• Minimalna wysokość widżetu w unitach: dostępne wartości 1 unit, 2 unity, bez ograniczeń. 1 unit odpowiada mniej więcej 1/3 wysokości obszaru pulpitu w aplikacji FrontSPA dla rozdzielczości FullHD.
• Pokazuj toolbar widżetu: pozwala wyłączyć pasek z nazwą widżetu i ikoną do zmiany parametrów (o ile widżet ma zdefiniowane parametry); w przypadku widżetu formularz jest to sekcja toolbar.
• Aktywny: widżetów nieaktywnych nie można ustawiać na pulpiciew aplikacji FrontSPA.
• Autoodświeżanie: po włączeniu powoduje automatyczne odświeżanie danych wyświetlanych przez widżet z podanym interwałem.
• Interwał autoodświeżania: okres w sekundach, z jakim dane wyświetlane w widżecie będą odświeżane.

Karty Ustawienia i Parametry są wyświetlane dopiero po wybraniu rodzaju widżetu (dla raportu karta Parametry nie jest dostępna).

Definicje widżetów są zapisywane w tabeli core.Widgets.

Konfigurowanie widżetów

Po zdefiniowaniu nowego widżetu należy przejść do jego konfiguracji na karcie Ustawienia. W większości przypadków ta konfiguracja jest taka sama jak w przypadku analogicznych sekcji formularza:

• widżet uproszczona lista odpowiada sekcji typu prosta lista,
• widżet sekcja HTML odpowiada sekcji HTML; w tym widżecie obsługiwana jest bibliotek chart.js, przy użyciu której można definiować wykresy, została ona opisana w kolejnym temacie: Obsługa biblioteki chart.js .
• widżet wykres odpowiada sekcji wykres,
• widżet raport odpowiada sekcji podgląd raportu,

• widżet formularz wymaga jedynie wybrania formularza z listy oraz utworzenia zapytania wybierającego identyfikator dokumentu, który ma zostać otwarty w formularzu (podobnie jak w akcji otwierania formularza).

  

Parametry widżetów

Prawie wszystkie rodzaje widżetów (wyjątkiem jest raport) umożliwiają definiowanie parametrów, które można ustawiać w aplikacji FrontSPA, aby wpływać na zakres danych wyświetlanych w widżetach. Parametry definiuje się na karcie Parametry po klimnięciu przycisku Nowy parametr. Należy kolejno określić:

• Kod: kod parametru; w zapytaniu źródłowym dla widżetu odwołanie do parametru ma składnię {@UserPAram_kod}.
• Nazwa: zrozumiała dla użytkownika nazwa parametru.
• Typ parametru: wybierz z listy kontrolkę, która będzie wyświetlana w oknie dialogowym w celu określenia wartości parametru; dostępne pozycje:
  • Pole tekstowe
  • Lista wyboru SQL: należy skonfigurować zapytanie SQL dla listy wyboru; zapytanie musi zwrócić kolumny [Key] (wartość parametru) i [Value] (wartość wyświetlana na liście)
  • Pole daty
  • Datepicker i pole czasu
  • Pole numeryczne
  • Checkbox (pojedynczy)
• Wymagany: określa, czy podanie wartości dla parametru jest wymagane.

• Globalny: określa, czy wartość parametru ustawione dla dane widżetu ma obowiązywać również w innych widżetach, w których zdefiniowano taki sam parametr.

  

Definicje parametrów widżetów są zapisywane w tabeli core.WidgetParameters

Powiązane tematy:

• Sekcje formularza, prosta lista
• Sekcje formularza, HTML
• Sekcje formularza, wykres
• Sekcje formularza, raport
• Pulpity w aplikacji FrontSPA

---