IGeneralCommand

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

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í tiket v rámci funkce 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 Administrace
  • 4 = v uživatelském menu nad systémovým příkazem Nastavení
• ikona - název ikony příkazu
  • Používejte název ikony z Microsoft Fabric jako název ikony (název ikony se zobrazí na stránce když přejdete 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	L 343, 22.12.2009, s. 1).
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.

Příklad případu použití naleznete v šabloně aplikace ProblemReporting.

Spustit

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

Tip

Pokud má vlastní příkaz otevřít jinou stránku z aplikace Alvao WebApp, použijte vlastnost Alvao.API.Common.DbProperty.WebAppUrl z rozhraní Alvao.API pro získání kořenové adresy 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.

Příklad případu použití naleznete v šabloně aplikace ProblemReporting.