Skip Navigation LinksALVAO 11.0Rozšiřující modulyALVAO Service Desk Custom AppsVlastní formulář pro podání nového požadavku Skip Navigation Links.


Vlastní formulář pro podání nového požadavku

Systémový formulář pro podání nového požadavku na ALVAO WebApp lze nahradit vlastním formulářem se specifickým obsahem a chováním. Vlastní formulář může založit i více požadavků současně a tím může sloužit i pro podporu složitých firemních procesů, jako je například nástup nového zaměstnance.

Tip:
Místo vlastních formulářů doporučujeme používat kombinaci standardního formuláře pro podání nového požadavku do služby a Vlastního javascriptu na formuláři pro podání nového požadavku.
Poznámka:
Vlastní formulář může představovat také obecnou stránku ALVAO WebApp, která neslouží vytváření požadavků. Vytvoření takové stránky vyžaduje pokročilé znalosti programování.
Tip:
Ve vlastním formuláři je můžete využít rozhraní Alvao.API pro práci s požadavky, nicméně použití API vyžaduje pokročilé znalosti programování.

Šablony pro tvorbu vlastních formulářů najdete ve složce \Custom\Templates\ v instalační složce ALVAO WebApp.

Seznam standardních šablon:

Název Popis
NewTicket Příklad formuláře pro vytvoření více požadavků ve vzájemné vazbě. Zároveň ukazuje, jak používat některé ovládací prvky a jak pracovat s prvkem pro vykázání času k zakládanému požadavku.
EmptyPage Prázdná šablona. Používá se pro stránky, které nejsou určené k vytváření požadavků. Tento typ stránek slouží pouze pro speciální účely, jako je třeba obsah vlastních záložek na požadavku.

Soubor s příponou .cshtml definuje vzhled formuláře, soubor .cs, nacházející se ve složce \Code, popisuje logiku odeslání údajů z vyplněného formuláře.

Příprava nového formuláře

Ve složce \Custom nejprve vytvořte složku pro funkčnost, které se bude nový vlastní formulář týkat, např. HrProcessAutomation (pro automatizaci HR procesů). Ve složce jedné funkčnosti může být umístěno i několik formulářů.

Poté si ve složce \Custom\Templates vyberte šablonu formuláře, která se co nejvíce blíží vašemu záměru. Obsah složky se šablonou zkopírujte do složky Custom\<název funkčnosti>. Soubory .cshtml a .cs vhodně přejmenujte. Oba soubory (.cshtml i .cs) pojmenujte stejně. Název formuláře doporučujeme začínat názvem funkčnosti, potom uvést název služby, pro kterou je určen, a nakonec operaci, např. HrProcessAutomation_Onboarding_NewTicket, kde HrProcessAutomation je název funkčnosti, Onboarding je název služby a NewTicket je název operace.

Upozornění:
Názvy všech používaných formulářů napříč všemi funkčnostmi musí být unikátní.

Nyní je třeba upravit také vnitřek formuláře podle nového názvu:

  • V souboru .cs, na začátku souboru za slovem namespace, uveďte název jmenného prostoru Alvao.ServiceDesk.ServiceDeskWebApp.Custom.<název_funkčnosti>. Jako název funkčnosti uveďte název složky na disku, ve které je formulář umístěn, např. Alvao.ServiceDesk.ServiceDeskWebApp.Custom.HrProcessAutomation.
  • V souboru .cs na začátku souboru u klíčového slova class změňte název třídy. Název třídy musí být <název cshtml stránky>Controller, např. ve formuláři HrProcessAutomation_Onboarding_NewTicket.cshtml se bude třída jmenovat HrProcessAutomation_Onboarding_NewTicketController.

Definice vzhledu formuláře

Soubor .cshtml obsahuje popis vzhledu formuláře a určuje zobrazené prvky. Při odeslání dat uživatelem se pak data zadaná do zobrazených prvků převádí na text a tento text pak můžete použít dále v definici chování.

V souboru .cshtml upravujte pouze část ohraničenou mezi řádkem <div id="CustomFormContent"> a </div>, prvky formuláře se do textu převádějí pouze v této části. Prvky mimo CustomFormContent se do textu požadavku nepřevedou, ale ve formuláři budou zobrazeny.

Do textu požadavku se převádí tyto prvky formuláře:

Název prvku Způsob převodu Odřádkování
<label> Do textu požadavku se vloží zobrazený text a za něj se doplní dvojtečka. Ne
Editor "StringField" Do textu požadavku se vloží text, který uživatel napíše do vstupního řádku. Pokud do parametru prvku přidáte hodnotu „UniquedId = Model.TicketBodyGuid“, bude možné zadávat formátovaný text (HTML).
Poznámka:
Na jednom formuláři může být nejvýše jeden prvek v HTML formátu.
Ano
Editor "BoolField" Do textu požadavku se vloží zobrazený text a za něj se doplní Ano nebo Ne podle výběru uživatele. Ano
Editor "DateTimeField" Do textu požadavku se vloží uživatelem zadané datum. Ano
Editor "DropDownListField" Do textu požadavku se vloží vybraná položka. Ano
Editor "RadioButtonList" Do textu požadavku se vloží vybraná položka. Ano
Editor "CheckBoxList" Do textu požadavku se postupně vloží všechny vybrané položky. Ano
Editor "DoubleField" Do textu požadavku se vloží celé nebo desetinné číslo, které zadal uživatel. Ano
Editor "ColumnsControl" Do textu požadavku se postupně vloží všechny zobrazené položky. Také hodnoty vloží přímo do vlastností založeného požadavku. Ano
Editor "AttachmentField" K zakládací zprávě požadavku se vloží přílohy. Ne

Prvky nevyjmenované v tabulce se do textu nevkládají. Příklady použití všech prvků najdete v šabloně NewTicket.

V souboru .cshtml přidáním třídy "btn-command" k tlačítku zajistíte, že se tlačítko zkopíruje jako příkaz do panelu příkazů.

Poznámka:
Formát čísla v poli DoubleField se při odeslání formuláře kontroluje a pokud není v pořádku, označí se červeně a vypíše se zadejte číslo ve správném formátu.
Správný český formát zápisu desetinného čísla je s desetinnou čárkou.

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 vytváření požadavků. V souboru je již příklad vytvoření požadavku, podle kterého můžete udělat vlastní úpravu.

Základní struktura příkazu pro tvoření požadavku je následující:

CreateTicket("Název služby", "Název požadavku", "Vlastní text požadavku\n" + TicketBody);

Kde TicketBody je již připravený text požadavku, který vzniknul převodem obsahu formuláře na text. V případě potřeby lze ve všech položkách použít sčítání textů tak, jak je ukázáno. 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>"

Název služby musí být vyplněn přesně tak, jak se zobrazuje název služby ve Správě. Podslužby se oddělují pomocí znaku /, tedy například "Interní/Personalistika/Nástup zaměstnance". Musíte zadat celou cestu od kořenové služby.

Dostupná je i verze příkazu pro vytvoření požadavku rozšířená o vytváření vazeb:

CreateTicket("Název služby", "Název požadavku", "Vlastní text požadavku\n" + TicketBody, MainTicketId, TicketRelationType. SystemTicketRelationType.IsChildOf);

Kde MainTicketId je číslo navázaného požadavku. Příklad získání ID z hlavního požadavku je rovněž součástí šablony. Hodnota TicketRelationType.SystemTicketRelationType.IsChildOf definuje typ vazby:

Hodnota Typ vazby
RelatesTo Souvisí s
IsParentOf Je nadřazený nad
IsChildOf Je podřazený pod
PrecedesBefore Předchází před
FollowsAfter Následuje po
Blocks Blokuje
IsBlockedBy Je blokován
IsDuplicatedBy Je duplikován
Duplicates Duplikuje

Např. v případě hodnoty TicketRelationType.SystemTicketRelationType.IsChildOf bude aktuálně vytvořený požadavek podřazený a požadavek s číslem předaným v MainTicketId bude nadřazený.

Pro přístup k hodnotám vlastních položek použijte následující strukturu (příklad pro položky "NoveJmeno" a "NoveCislo"):

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

Připojení formuláře k aplikaci

Pokud v nastavení služby zadáte cestu k formuláři, bude se tento formulář zobrazovat na ALVAO WebApp místo běžného formuláře pro podání nového požadavku. Viz také nastavení služeb Service Desku.

  1. Ve WebApp - Správa - Service Desk - Služby vyberte službu, ve které chcete zobrazovat vlastní formulář.
  2. V sekci Formulář pro podání nového požadavku v panelu příkazu přepněte režim ze systémového návrhu formuláře do režimu Vlastní formulář (URL).
  3. Zadejte cestu k vlastnímu formuláři ve tvaru ~/Custom/<název funkčnosti>/<název formuláře bez přípony .cshtml>.

Dynamické přepínání jazyků formuláře

Při úpravě .cs a .cshtml souborů lze využívat souborů .resx, které obsahují lokalizované řetězce pro jednotlivé jazyky. Každému uživateli se pak zobrazují tyto řetězce načtené ze souboru dle jeho preferovaného jazyka. Pokud pro nějaký jazyk není vytvořen .resx soubor, použije se .resx soubor pro angličtinu.

Vytvoření .resx souboru pro jazyk

Napřed vytvoříme .resx soubor pro angličtinu. Ze složky Custom\Templates\Resources zkopírujte soubor SampleController.resx do složky Custom\<název funkčnosti>\Resources a přejmenujte ho na <název cshtml stránky>Controller.resx.

Otevřete tento soubor v textovém editoru. Za řádek "<!-- Insert --!>" vložte řádky:

<data name="name" xml:space="preserve">
<value>Name</value>
</data>

Výsledek by měl být následující:

<!-- Insert --!>
<data name="name" xml:space="preserve">
<value>Name</value>
</data>
<!-- Do not change --!>
</root>

Řádky:

<data name="name" xml:space="preserve">
<value>Name</value>
</data>

lze znovu zkopírovat a upravit tak, aby se vytvořilo více lokalizovaných řetězců. Každá hodnota "<data name="name" musí být jedinečná v rámci souboru.

<data name="name" udává název, který se používá jako parametr ve funkci GetResources(), popsané v Použití .resx souboru v .cs a .cshtml souborech. <value>Name</value> udává hodnotu, jakou tato funkce vrací.

Vytvoříme teď .resx soubor pro český jazyk. Zkopírujte upravený soubor <název cshtml stránky>Controller.resx. do stejné složky a pojmenujte ho <název cshtml stránky>Controller.cs.resx. Upravte v této kopii položky <value>Name</value> tak, aby byl v tomto souboru následující text:

<!-- Insert --!>
<data name="name" xml:space="preserve">
<value>Jméno</value>
</data>
<!-- Do not change --!>
</root>

Upozornění:
Žádné ostatní části resx souborů neměňte.

Stejně jako se zkopíroval a upravil soubor <název cshtml stránky>Controller.cs.resx, tak lze zkopírovat a upravit i soubory pro ostatní jazyky, které lze nastavit jako preferované jazyky uživatele. Tyto soubory se vždy jmenují <název cshtml stránky>Controller.<zkratka jazyka>.resx (například <název cshtml stránky>Controller.de.resx). Zkratky jazyka, které lze použít jsou definovány na:

http://msdn.microsoft.com/cs-cz/goglobal/bb896001

Použití .resx souboru v .cs a .cshtml souborech

Jednotlivé položky, které se vytvořily v .resx soborech lze použít v .cs i .cshtml souborech.

V .cshtml souboru použijte místo řetězce label = "Jméno" řetězec label = Model.GetResource("name"). Uživateli, který má nastavený jako preferovaný jazyk češtinu, se zobrazí popisek pole Jméno. Ostatním uživatelům se zobrazí Name.

Při použití v .cs souboru by se dosáhlo stejné funkce použitím funkce GetResource("name"), místo řetězce.

 

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