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 (jedinečné)
• name – název příkazu, který se bude zobrazovat v aplikacích
• position – pozice, na které se příkaz zobrazí 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í
• Icon (řetězec) – název ikony příkazu; použijte Microsoft fluent library viewer se zapnutým filtrem „20 Regular“. Po nalezení nejvhodnější ikony zkopírujte její název bez „fluent:“ a nahraďte znaky „-“ znakem „_“.
  • Příklad: Ikonu fluent:edit-20-regular použijte ve svém kódu jako edit_20_regular.

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.