Vlastní formulář pro schválení požadavku

Systémový formulář pro schválení/zamítnutí požadavku na ALVAO WebApp lze nahradit vlastním formulářem se specifickým obsahem a chováním. Vlastní formulář umožňuje schvalovateli nastavit některé položky požadavku a tím umožňuje podporu složitějších schvalovacích schémat.

Šablony pro tvorbu vlastních formulářů najdete v adresáři \Custom\Templates v instalační složce ALVAO WebApp. Soubory Approval_Template.cshtml a Approval_Template.cs slouží jako šablona.

Příprava nového formuláře

Překopírujte si vzorový formulář – soubor Approval_Template.cshtml do složky Custom\<název firmy> a soubor Approval_Template.cs do složky Custom\<název firmy>\Code. Oba soubory přejmenujte tak, aby název odpovídal významu formuláře.

Poznámka:

Obecný popis pro nastavení vlastních formulářů je popsán v návodu pro Vlastní formulář pro podání nového požadavku.

Definice chování formuláře

Popis chování se nachází v souboru .cs. V první části kódu je komentáři označena oblast, která je určena pro úpravy. Nezasahujte do ostatních částí kódu! Nejdůležitější je zde schvalování požadavků. V souboru je již příklad schválení i zamítnutí požadavku, podle kterého můžete udělat vlastní úpravu.
Základní struktura příkazů pro schválení/zamítnutí požadavku je následující:

TicketApprovalAccept(iHdTicketId, "Požadavek byl schválen:"+ MessageBody);
TicketApprovalReject(iHdTicketId, "Požadavek byl zamítnut:"+ MessageBody);

Kde MessageBody je již připravený text schválení/zamítnutí požadavku, který vznikl převodem obsahu formuláře na text. V případě potřeby lze ve všech položkách využít zřetězení textů tak, jak je ukázáno v příkladu. Chcete-li vložit do vlastního textu odřádkování, použijte značku \n.

Poznámka:

Pokud je na formuláři použit prvek „StringField“, do kterého lze zadat text v HTML formátu, použijte pro odřádkování řetězec „<br>".
Pro přístup k hodnotám vlastních položek použijte následující strukturu (příklad pro položky "NewName" a "NewNumber"):

string NewName = ((ColumnsControl)Model.ColumnsControl["ColumnsControl0"]).Values.Find(Col => Col.Column.sColumn == "NewName").Value as string;
int NewNumber = (int)((ColumnsControl)Model.ColumnsControl["ColumnsControl0"]).Values.Find(Col => Col.Column.sColumn == "NewNumber").Value;

Připojení formuláře k aplikaci

V ALVAO Admin – Schvalování – Schvalovací schémata dvojklikem otevřete okno pro úpravu schvalovacího kroku. Do položky Vlastní formulář (URL) zadejte URL vytvořeného formuláře (ve stejném formátu, jaký je použit ve Služba – Katalog služeb).