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.