Přeskočit na hlavní obsah

Příkaz (zastaralý)

Varování

Toto rozhraní je zastaralé. Namísto tohoto rozhraní použijte rozhraní IEntityCommand.

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

V aplikaci vytvořte nový skript pomocí šablony ICommand a pojmenujte jej vhodně 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 = na první pozici hlavního menu požadavku
    • 2 = na poslední pozici hlavního menu požadavku
    • 3 = na první pozici vnořeného menu v hlavním menu požadavku
    • 4 = poslední pozice vnořené nabídky v hlavní nabídce požadavku
  • ikona - název ikony příkazu

Použijte zobrazení knihovny Microsoft Fluent s filtrem “20 Regular“. Po nalezení nejvhodnější ikony zkopírujte její název bez "fluent:" a nahraďte znaky "-" za "_". - Příklad: Ikona s názvem “fluent:edit-20-regular“ se používá ve vašem 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í​

MetodaPopis
ZobrazitZobrazit příkaz v nabídce požadavku.
SpustitSpustit příkaz.

Zobrazit​

Tato metoda kontroluje definované podmínky pro zobrazení příkazu.

Tip

Voláním této metody metodou Run můžete zkontrolovat, zda se podmínky pro zobrazení dotazu změnily mezi okamžikem, kdy byl dotaz zobrazen, a okamžikem spuštění dotazu.

  • Syntaxe: **(SqlConnection con, int ticketId, int personId)
  • Parametry:
    • con - SqlConnection k databázi.
    • ticketId - ID požadavku (tHdTicket.iHdTicketId), pro které bude příkaz zobrazen.
    • personId - ID uživatele (tPerson.iPersonId), kterému by měl být příkaz zobrazen.
  • Vrácená hodnota:
    • bool - hodnota pravdy, zda má být příkaz zobrazen uživateli na zadaném požadavku.

Můžete najít příklad použití v CostsCalculation šabloně aplikace.

Spustit​

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

Tip

Pokud má vlastní příkaz otevřít jinou stránku než Alvao WebApp, použijte vlastnost Alvao.API.Common.DbProperty.WebAppUrl z Alvao.API rozhraní pro získání kořenové URL.

  • Syntaxe:< bool, string, string> Run(SqlConnection con, int ticketId, int personId)
  • Parametry:
    • con - SqlConnection k databázi.
    • ticketId - ID požadavku (tHdTicket.iHdTicketId), na kterém je příkaz spuštěn.
    • 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.

Můžete najít příklad použití v CostsCalculation šabloně aplikace.