Skip Navigation LinksALVAO 11.2Rozšiřující modulyALVAO Service Desk Custom AppsVlastní formulář pro odeslání nového požadavkuPrvek ColumnsControl Skip Navigation Links.


Přepnout verzi Alvao
Změnit jazyk
Skip Navigation LinksALVAO 11.2 / Rozšiřující moduly / ALVAO Service Desk Custom Apps / Vlastní formulář pro odeslání nového požadavku / Prvek ColumnsControl

Prvek ColumnsControl

Ovládací prvek ColumnsControl zobrazuje na formuláři vstupní pole pro zadávání hodnot přímo do položek požadavku.

ColumnsControl vygeneruje celé vstupní pole formuláře s popisem. Pro základní funkčnost je třeba nastavit zobrazované položky (např. ShowColumns = "tHdTicket.mHdTicketNotice"), případně povinné položky (např. RequiredColumns="tHdTicket.mHdTicketNotice"). Položky se zobrazují v zadaném pořadí shora dolů

Každý prvek ColumnControl je třeba inicializovat. V souboru .cs ve funkci ConfigControls() použijte pro každý prvek ColumnsControl použitý ve formuláři následující řádek:
((DynamicModel)Model).GetControl<ColumnsControl>("ColumnsControl0");
Místo adresy ColumnsControl0 použijte název prvku

Pokud tento ovládací prvek vložíte do formuláře mezi <div id="CustomFormContent" a </div>, hodnoty se automaticky uloží při volání funkce CreateTicket. Tento ovládací prvek lze na jedné stránce použít vícekrát. Možné další nastavení a příklad naleznete níže.

Tip:
Doporučujeme konfigurovat ColumnsControl pomocí atributů na stránce (.cshml). ColumnsControl lze konfigurovat také v kódu (.cs)
Poznámka:
Aby se tyto položky nepřidávaly do textu požadavku, je třeba je umístit mimo <div id="CustomFormContent" a </div>, ale pak je třeba ručně uložit vyplněné hodnoty voláním funkce UpdateColumns(...) pro každý ColumnsControla každý vytvořený požadavek
Poznámka:
Při zobrazení stránky se ColumnsControl pokusí automaticky získat SectionIdze zadané webové adresy. Pokud webová adresa obsahuje parametr adresy iHdSectionId=číslo, použije se "number" jako ID vybrané služby, pokud není nastaveno jinak. (Např. http://app.contoso.com/Custom/ALVAO/NewTicket_Template/?iHdSectionId=11obsahuje ID služby č. 11. To se automaticky nastaví jako SectionId.)
Tuto funkci lze vypnout nastavením SectionId="0" nebo nastavením konkrétní služby
Poznámka:

ColumnsControl provádí základní kontrolu práv:

  • Pokud je nastavena hodnota TicketId, musí mít přihlášený uživatel možnost tento požadavek zobrazit, jinak bude přesměrován na chybovou stránku.

Formát parametru

V popisech atributů a funkcí se používají následující formáty parametrů:

  • columns - seznam sloupců ve formátu "table1.column1, table1.column2, ...". Tímto způsobem lze definovat jeden nebo více sloupců pro aktuální ColumnsControl.
    Povolené sloupce:
    tabulka.sloupec Položka požadavku Poznámky
    tHdTicket.mHdTicketNotice Poznámky
    tHdTicket.sHdTicketGroup Skupina Povoluje jiné než předdefinované hodnoty.
    tHdTicket.sHdTicketDeviceCode Číslo zařízení
    tHdTicket.FeedbackSolveSpeed Rychlost řešení
    tHdTicket.FeedbackProfessionality Profesionalita
    tHdTicket.FeedbackExpertise Excelence
    tHdTicket.FeedbackComment Komentáře a poznámky
    tHdTicket.RelatedAccountId Související organizace
    tHdTicketCust.* vlastní pole Jednotlivé sloupce v tabulce tHdTicketCust, které představují vlastní pole. Místo hvězdičky uveďte název konkrétního sloupce.
  • sectionId - service id
  • sectionName - úplný název služby včetně cesty (např. "Helpdesk/Problems")
  • mode - jednu z možností Upravit (výchozí) a Zobrazit
  • msg - řetězec obsahující text zobrazený pro nevyplněnou požadovanou položku
  • ticketId - číslo požadavku, který se má zobrazit/uložit

Atributy v cshtml

  • ShowColumns = columns - sloupce, které se generují na formulář a ukládají do db. Sloupce se zobrazují v zadaném pořadí shora dolů.
  • RequiredColumns = columns - sloupce, které musí být vyplněny, aby bylo umožněno uložení. Tyto sloupce musí být také v atributu ShowColumns. Na pořadí nezáleží.
  • SectionId = sectionId - nastavuje ID a název služby. To ovlivňuje hodnoty, které se mají vybrat pro položky číselníku (pokud jsou hodnoty definovány pro konkrétní službu).
  • SectionName = sectionName - nastavuje ID a název služby. To ovlivňuje hodnoty, které se mají vybrat pro položky číselníku (pokud jsou hodnoty definovány pro konkrétní službu).
  • Mode = mode - nastavuje režim zobrazení.
  • TicketId = ticketId - nastavuje ID požadavku pro editaci/zobrazení/uložení.
  • CssClass - třída stylu css.
  • IgnoreColumns = columns - sloupce, které se nebudou zobrazovat.
  • IncludeServiceColumns - příznak, zda se mají zobrazovat sloupce podle procesu služby zadaného v SectionId
  • IncludeRequiredColumns - příznak, zda se mají zobrazit požadované sloupce podle servisního procesu zadaného v SectionId.

Funkce

Poznámka:
Pro základní funkčnost prvku ColumnsControl není nutné tyto funkce používat
  • UpdateColumns() - uloží vyplněné hodnoty do db do požadavku, jehož id je nastaveno atributem TicketId.
  • UpdateColumns(int ticketId) - uloží vyplněné hodnoty v db do požadavku číslo ticketId.

Příklad použití

Příklad zobrazení prvků Skupina (tHdTicket.sHdTicketGroup) a Poznámky (tHdTicket.mHdTicketNotes). Položka Skupina je povinná:

  • .cshml + automatické ukládání (pomocí volání funkce CreateTicket )

    .... Your form content....

    @Html.EditorFor(m=> m["ColumnsControl0"], "ColumnsControl", new { ShowColumns="tHdTicket.sHdTicketGroup,tHdTicket.mHdTicketNotice",RequiredColumns="tHdTicket.sHdTicketGroup" })
    .... Rest of form....

Další příklad použití naleznete na adrese "~/Custom/Templates/NewTicket_Template.cshtml"a z ní odvozených

 

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