IGeneralCommand

Implementací rozhraní IGeneralCommand ve skriptu aplikace můžete definovat vlastní příkazy hlavního menu.

Umístěním příkazu do hlavní nabídky můžete uživatelům umožnit přístup k často používaným stránkám a operacím, které nejsou vázány na konkrétní požadavek ve funkci ALVAO Service Desk nebo Asset Management. Příkazy jsou zobrazeny v hlavním menu aplikace Alvao WebApp. V aplikaci Service Desk nebo Asset Management vytvořte nový skript pomocí šablony IGeneralCommand a vhodně jej pojmenujte podle funkčnosti vlastního příkazu. V nově vytvořeném skriptu nastavte v konstruktoru třídy příkazů hodnoty vlastností id, name, position a icon:

• ID - číslo příkazu (unikátní)
• jméno - název příkazu, který se zobrazí v aplikacích
• pozice - pozice, na které bude příkaz zobrazen v aplikacích
  • 1 = v hlavním menu pod systémovými příkazy
  • 2 = v hlavním menu nad Více menu
  • 3 = v hlavním menu Více menu nad systémovým příkazem Správa
  • 4 = v uživatelském menu nad systémovým příkazem Nastavení
• ikona - název ikony příkazu
  • Použijte název ikony z knihovny Microsoft Fabric jako název ikony příkazu (název ikony se zobrazí na stránce, když převedete kurzorem nad vybranou ikonou). Pokud nespecifikujete ikonu, použije se ikona LightningBolt.

Tip

Pro uložení vlastností a nastavení příkazu doporučujeme definovat třídu Settings v samostatném skriptu, který vytvoříte ze šablony Class Library.

Metody rozhraní

Metoda	Popis
Zobrazit	Zobrazit příkaz v hlavním menu aplikace.
Spustit	Spustit příkaz.

Zobrazit

Tato metoda kontroluje definované podmínky pro zobrazení příkazu.

Tip

Voláním této metody metodou Run před spuštěním příkazu můžete zkontrolovat, že podmínky jeho zobrazení se nezměnily mezi časem, kdy byl příkaz zobrazen, a časem, kdy byl spuštěn.

• Syntaxe: boolZobrazit (SqlConnection con, int personId)
• Parametry:
  • con - SqlConnection k databázi.
  • personId - ID uživatele (tPerson.iPersonId), kterému má být příkaz zobrazen.
• Vrácená hodnota:
  • bool - skutečná hodnota, zda má být příkaz zobrazen uživateli v hlavním menu aplikace.

Pro příklad použití si prohlédněte šablonu aplikace ProblemReporting.

Spustit

Tato metoda spustí příkaz sám.

Tip

Pokud je vlastním příkazem otevření jiné stránky z ALVAO WebApp, použijte vlastnost Alvao.API.Common.DbProperty.WebAppUrl z rozhraní Alvao.API k získání základní URL.

• Syntaxe: Tuple< bool, string, řetězec> Run(SqlConnection con, int personId)
• Parametry:
  • con - SqlConnection k databázi.
  • personId - ID uživatele (tPerson.iPersonId), které spustí příkaz.
• Vrácená hodnota:
  • bool - hodnota pravdy, zda byl příkaz proveden.
  • řetězec - text, který může být zobrazen ve zprávě pro uživatele.
  • řetězec - URL pro otevření v prohlížeči.

Pro příklad použití si prohlédněte šablonu aplikace ProblemReporting.