Skip Navigation LinksALVAO 11.1Rozšiřující modulyALVAO Asset Management Custom AppsAplikaceIEntityCommand Skip Navigation Links.


IEntityCommand

Implementací tohoto rozhraní můžete definovat vlastní příkazy pro objekt nebo požadavek. Příklad naleznete v šabloně aplikace CostsCalculation

V aplikaci vytvořte nový skript pomocí šablony IEntityCommand a vhodně jej pojmenujte podle funkčnosti vlastního příkazu
V nově vytvořeném skriptu nastavte v konstruktoru třídy následující vlastnosti

  • Id - jedinečný identifikátor příkazu (řetězec)
  • Entita - typ entity, pro kterou bude příkaz zobrazen (Entity.Request nebo Entity.Object).

Metody rozhraní

Metoda Popis
Show Zobrazení příkazu v nabídkách příkazů.
Run Spustit příkaz.

Show

Tato metoda řídí zobrazení příkazu v nabídkách příkazů
  • Syntaxe: EntityCommandShowResult Show(int entityId, int personId)
  • Parametry
    • entityId - iD entity (tblNode.intNodeId nebo tHdTicket.iHdTicketId), pro kterou se má příkaz zobrazit.
    • personId - iD uživatele (tPerson.iPersonId), kterému má být příkaz zobrazen.
  • Vrácené hodnoty: instance třídy EntityCommandShowResult s vlastnostmi:
    • Name (řetězec) - zobrazený název příkazu
    • Show (bool) - true = příkaz bude zobrazen, false = příkaz nebude zobrazen.
    • Position (int) - pozice v uživatelském rozhraní, na které bude příkaz zobrazen:
      • 1 = první pozice hlavní nabídky entity
      • 2 = poslední pozice hlavní nabídky subjektu
      • 3 = první pozice vnořené nabídky v hlavní nabídce entity
      • 4 = poslední pozice vnořené nabídky v hlavní nabídce subjektu
    • Icon (řetězec) - název ikony příkazu; viz Ikony Fluent UI - Dostupné ikony v dolní části stránky - pro zobrazení názvů ikon najeďte na ikony myší. Pokud nezadáte žádnou ikonu, bude použita ikona LightningBolt.
Tip:
Zavoláním této metody v metodě Spustit můžete zkontrolovat, zda se podmínky pro zobrazení příkazu nezměnily v době mezi zobrazením příkazu a jeho spuštěním

Run

Tato metoda implementuje samotný příkaz

  • Syntaxe: Tuple<bool, string, string> Run(SqlConnection con, int ticketId, int personId)
  • Parametry
    • entityId - iD entity (tblNode.intNodeId nebo tHdTicket.iHdTicketId), pro kterou byl příkaz spuštěn.
    • personId - iD uživatele (tPerson.iPersonId), který příkaz spustil.
  • Vrácené hodnoty: instance třídy CommandResult obsahující roperties
    • MessageType (MessageType) - určuje, zda se má uživateli zobrazit zpráva jako výsledek provedení příkazu:
      • None - nezobrazí se žádná zpráva
      • Info - zobrazí se informační zpráva
      • Warning - zobrazí se varovná zpráva
      • Error - zobrazí se chybová zpráva
    • MessageText (string) - zadejte text zprávy, která se zobrazí uživateli.
    • NavigateToUrl (string) - volitelně zadejte adresu URL, na kterou se bude přecházet po provedení příkazu.
Tip:
Pokud má vlastní příkaz otevřít jinou stránku aplikace ALVAO WebApp, použijte vlastnost Alvao.API.Common.DbProperty.WebAppUrl z adresy Alvao.API pro získání kořenové adresy URL aplikace WebApp.

 

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