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.