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 sekci šablony aplikací najdete příklady hotových užitečných aplikací, které můžete ihned použít.

Pokud jste členem skupiny Administrators nebo Application Administrators, můžete spravovat aplikace v části Administration - Applications. Pro možné rozšíření dostupné v tomto modulu viz seznam skriptové šablony.

Programování aplikací

Varování

Špatně definovaná aplikace může nevratně 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 Alvao database.

Lokalizace jazyka

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

Odesílání zprávy v automatické akci

Pokud potřebujete odeslat nějakou zprávu jako součást automatické akce, použijte metodu SendMessage. Pokud nechcete, aby se odeslaná zpráva zapsala do protokolu tipu, použijte metodu QueueMailMessage.

Poznámka

Metody lze použít pro jakýkoli typ rozšíření.

Transakce databáze

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

Pokud potřebujete přístup k databázi Alvao přímo ve vaší aplikaci, použijte ConnectionScope pro připojení k databázi, kterou dostanete zavoláním AlvaoContext. etConnectionScope() metoda. Objekt ConnectionScope má vlastnost Connection, která obsahuje několik metod pro dotazování a úpravu databáze (viz Dokumentace Dapper). Příklad použití najdete v šabloně aplikace TicketCostsCalculation.

Poznámka

Většina metod aplikace 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 použít i tyto parametry. Doporučujeme však, abyste k nim raději přistupovali prostřednictvím třídy ConnectionScope.

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

Můžete také začít svou vlastní transakci v aplikaci voláním metody ConnectionScope.BeginTransaction().

Získávání kořenové URL WebApp

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 Alvao.API pro získání kořenové adresy URL aplikace WebApp.

Automaticky odeslat oznámení týmu členského státu

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