Skip Navigation LinksALVAO 11.0Rozšiřující modulyALVAO Service Desk Custom AppsAplikaceVlastní příkazyICommand Skip Navigation Links.


ICommand

Implementací rozhraní ICommand ve skriptu aplikace můžete definovat vlastní příkazy požadavku.

V aplikaci vytvořte nový skript podle šablony ICommand a vhodně jej pojmenujte podle funkčnosti vlastního příkazu.
V nově vytvořeném skriptu nastavte v konstruktoru třídy příkazu 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 bude příkaz zobrazovat v aplikacích
    • 1 = na prvním místě hlavní nabídky požadavku
    • 2 = na posledním místě hlavní nabídky požadavku
    • 3 = na prvním místě vnořené nabídky v hlavní nabídce požadavku
    • 4 = na posledním místě vnořené nabídky v hlavní nabídce požadavku
  • icon – název ikony příkazu
    • Jako název ikony příkazu použijte název ikony z knihovny Microsoft Fabric (na stránce se název ikony zobrazí po najetí kurzorem myši nad vybranou ikonu). Pokud ikony nezadáte, 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 Knihovna tříd.

Metody rozhraní

Metoda Popis
Show Zobrazení příkazu v nabídce požadavku.
Run Spuštění příkazu.

Show

Tato metoda kontroluje nadefinované podmínky pro zobrazení příkazu.
Tip:
Voláním této metody v metodě Run lze před spuštěním dotazu kontrolovat, jestli se nezměnily podmínky pro jeho zobrazení v době mezi zobrazením a spuštěním dotazu.
  • Syntaxe: bool Show(SqlConnection Con, int ticketId, int personId)
  • Parametry:
    • Con – SqlConnection do databáze.
    • ticketId – ID požadavku (tHdTicket.iHdTicketId), u kterého se příkaz zobrazí.
    • personId – ID uživatele (tPerson.iPersonId), kterému by se měl příkaz zobrazit.
  • Návratové hodnoty:
    • bool – pravdivostní hodnota, zda se má příkaz uživateli na zadaném požadavku zobrazit.
Příklad použití najdete v šabloně aplikace CostsCalculation.

Run

Tato metoda spouští samotný příkaz.
Tip:
Pokud má vlastní příkaz otevřít jinou stránku z ALVAO WebApp, pro zjištění kořenové URL WebApp použijte vlastnost Alvao.API.Common.DbProperty.WebAppUrl z rozhraní Alvao.API.
  • Syntaxe: Tuple<bool, string, string> Run(SqlConnection Con, int ticketId, int personId)
  • Parametry:
    • Con – SqlConnection do databáze.
    • ticketId – ID požadavku (tHdTicket.iHdTicketId), nad kterým se příkaz spouští.
    • personId – ID uživatele (tPerson.iPersonId), který příkaz spouští.
  • Návratové hodnoty:
    • bool – pravdivostní hodnota, zda se příkaz vykonal.
    • string – text, který se může zobrazit v hlášení pro uživatele.
    • string – URL k otevření v prohlížeči.
Příklad použití najdete v šabloně aplikace CostsCalculation.

 

Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.