Aplikace

Prostřednictvím aplikací můžete do systému Alvao přidávat vlastní příkazy, přidávat vlastní karty na určité stránky, automaticky provádět další vlastní akce, když uživatelé spustí určité příkazy, atd. V šablonách aplikací najdete příklady hotových užitečných aplikací, které můžete ihned použít.

Pokud jste členem skupiny Administrátoři nebo Administrátoři aplikací, můžete aplikace spravovat v části Správa - Aplikace. Možná rozšíření dostupná v tomto modulu naleznete v seznamu šablon skriptů.

Programování aplikací

Upozornění:

V případě, že se jedná o aplikaci, která je určena k vytváření aplikací, je nutné ji použít: Špatně definovaná aplikace může nenávratně poškodit databázi Alvao. Aplikace vždy vytvářejte a testujte v testovacím prostředí s kopií produkční databáze

Předpokladem pro vytvoření aplikace je dobrá znalost programování v jazyce C#, Alvao.API a databáze Alvao

Jazyková lokalizace

Aplikace mohou být vícejazyčné a komunikovat s uživatelem v jeho preferovaném jazyce, viz příklad MultilingualCommand.

Odeslání zprávy v automatické akci

Pokud potřebujete odeslat nějakou zprávu v rámci automatické akce, použijte metodu SendMessage. Pokud nechcete, aby se odeslaná zpráva zapsala do protokolu požadavku, použijte metodu QueueMailMessage.

Poznámka:

Metody lze použít pro libovolný typ rozšíření

Databázové transakce

Pokud potřebujete ve své aplikaci provádět operace Alvao, doporučujeme k tomu přednostně používat připravené metody Alvao.API, díky kterým se nemusíte zabývat databázovými připojeními a transakcemi.

Pokud potřebujete ve své aplikaci přistupovat přímo k databázi Alvao, použijte pro připojení k databázi objekt ConnectionScope, který získáte voláním metody AlvaoContext.GetConnectionScope(). Objekt ConnectionScope má vlastnost Connection, která obsahuje několik metod pro dotazování a modifikaci databáze (viz dokumentace Dapper). Příklad použití najdete v šabloně aplikace TicketCostsCalculation

Poznámka:

Většina aplikačních metod přijímá jako vstupní parametry také připojení k databázi a otevřenou transakci, např. ITicketAutoAction.OnticketChanged. V takovém případě můžete tyto parametry také použít. Doporučujeme však, abyste k nim raději přistupovali prostřednictvím třídy ConnectionScope

Pokud aplikační metoda běží v externí otevřené transakci a metoda skončí výjimkou, transakce se automaticky zruší.

Vlastní transakci můžete v aplikaci spustit také voláním metody ConnectionScope.BeginTransaction().

Získání kořenové adresy URL webové aplikace

Pokud má vlastní příkaz nebo vlastní karta 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.

Odeslání oznámení MS Teams v automatické akci

Pokud potřebujete odeslat oznámení do MS Teams pomocí aplikace Alvao Bot jako součást automatické akce, použijte metodu Odeslat.

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