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 použít ihned.

Pokud jste členem skupiny Administrátoři nebo Administrátoři aplikací, můžete spravovat aplikace v Administraci - Aplikace. Pro možné rozšíření dostupné v tomto modulu se podívejte na seznam skriptových šablon.

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 C#, Alvao.API a Alvao databáze.

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 požadavku, použijte metodu QueueMailMessage.

Poznámka

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

Transakce databáze

Pokud potřebujete provádět operace Alvao ve vaší aplikaci, doporučujeme, abyste nejlépe používali připravené Alvao.API metody, což znamená, že se nebudete muset zabývat připojeními k databázi a transakcemi.

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

Poznámka

Většina metod aplikace také přijímá připojení k databázi a otevřenou transakci jako vstupní parametry, 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ší.

V aplikaci můžete také zahájit vlastní transakci voláním metody ConnectionScope.BeginTransaction().

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

Pokud vlastní příkaz nebo vlastní karta má otevřít jinou stránku Alvao WebApp, použijte vlastnost Alvao.API.Common.DbProperty.WebAppUrl z Alvao.API pro získání kořenové URL 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.