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.