Přeskočit na hlavní obsah

IEntityCommand

Zavedením tohoto rozhraní můžete definovat vlastní příkazy pro objekt nebo tiket. Například viz šablonu aplikace CostsCalculation .

V application vytvořte nový skript pomocí šablony IEntityCommand a pojmenujte jej odpovídajícím způsobem podle funkčnosti vlastního příkazu. V nově vytvořeném skriptu nastavte následující vlastnosti v konstruktoru třídu:

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

Metody rozhraní​

MetodaL 343, 22.12.2009, s. 1).
ZobrazitZobrazit příkaz v menu příkazu.
SpustitSpusťte příkaz.

Zobrazit​

Tato metoda ovládá zobrazení příkazu v menu příkazu.

Syntaxe:

 EntityCommandShowResult seriál (int entity Id, int person)

Parametry:

  • entityId - ID entity (tblNode.intNodeId nebo tHdTicket.iHdTicketId), pro které má být příkaz zobrazen.
  • personId - ID uživatele (tPerson.iPersonId), kterému by měl být příkaz zobrazen.

Vrácená hodnota:

Instance třídy EntityCommandShowResult s vlastnostmi:

  • Název (string) - zobrazený název příkazu
  • Zobrazit (bool) - true = příkaz bude zobrazen, false = příkaz nebude zobrazen.
  • Pozice (int) - pozice v uživatelském rozhraní, na které bude příkaz zobrazen:
  • 1 = první pozice hlavního menu entity
  • 2 = poslední pozice hlavního menu entity
  • 3 = první pozice vnořeného menu v hlavním menu entity
  • 4 = poslední pozice vnořeného menu v hlavním menu entity
  • Ikona (string) - název ikony příkazu; Používejte Microsoft fluent library viewer s "20 Pravidelnými" filtrem. Po nalezení nejvhodnější ikony zkopírujte její název bez „fluent:“ a nahradte „-“ znaky „_“.
  • Příklad: Ikona fluent:edit-20-regular používá ve vašem kódu jako edit_20_regular.
Tip

Voláním této metody v metodě Spustit můžete zkontrolovat, zda se podmínky pro zobrazení příkazu nezměnily mezi zobrazením a spuštěním příkazu.

Spustit​

Tato metoda implementuje příkaz samotný.

Syntaxe:

Run(int entity Id, int personId);

Parametry:

  • entity Id - ID entity (tblNode.intNodeId nebo tHdTicket.iHdTicketId), pro které byl příkaz spuštěn.
  • personId - ID uživatele (tPerson.iPersonId), který příkaz řídil.

Vrácená hodnota:

Instance CommandResult třídy obsahující vlastnosti:

  • MessageType (MessageType) - upřesněte, zda má být zpráva uživateli zobrazena v důsledku provedení příkazu:
  • Žádný – žádná zpráva se nezobrazí
  • Info - bude zobrazena informační zpráva
  • Varování - zobrazí se varovná zpráva
  • Chyba - zobrazí se chybová zpráva
  • Text zprávy (řetězec) - zadejte text zprávy, který bude zobrazen uživateli.
  • NavigateToUrl (řetězec) - volitelně zadejte URL, na kterou chcete přejít po provedení příkazu.
Tip

Pokud je vlastní příkaz otevřen další stránku Alvao WebApp, použijte Alvao.API.Common.DbProperty. ebAppUrl vlastnost z Alvao.API pro získání kořenové URL webové aplikace.