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 zpřístupnit často používané stránky a operace, které nejsou vázané na konkrétní požadavek v ALVAO Service Desk.
Příkazy se zobrazují v hlavní nabídce aplikací ALVAO WebAp.

Tip:

Pro nahrazení systémového příkazu v hlavní nabídce ALVAO WebApp vlastním, skryjte systémový příkaz.

V aplikaci vytvořte nový skript podle š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ří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 = v hlavní nabídce pod systémovými příkazy
- 2 = v hlavní nabídce nad nabídkou Více
- 3 = v hlavní nabídce v nabídce Více nad systémovým příkazem Správa
- 4 = v nabídce uživatele nad systémovým příkazem Nastavení
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 hlavní nabídce aplikace.
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 příkazu kontrolovat, jestli se nezměnily podmínky pro jeho zobrazení v době mezi zobrazením a spuštěním příkazu.

Syntaxe: bool Show(SqlConnection Con, int personId)
Parametry:
- Con – SqlConnection do databáze.
- 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 zobrazit v hlavní nabídce aplikace.

Příklad použití najdete v šabloně aplikace ProblemReporting.

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 personId)
Parametry:
- Con – SqlConnection do databáze.
- 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 ProblemReporting.

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