Skip Navigation LinksALVAO 11.1Rozš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

ColumnsControl elementl

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

ColumnsControl generuje 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 ColumnsControl0 použijte název vašeho 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 nastavit ovládací prvek 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í získat SectionIdautomaticky ze zadané webové adresy. Pokud webová adresa obsahuje parametr adresy iHdSectionId=cislo, použije se "cislo" jako ID vybrané služby, pokud není nastaveno jinak. ( Např.http://www.servicedesk.cz/Custom/ALVAO/NewTicket_Template/?iHdSectionId=11 obsahuje 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 nastaveno TicketId, musí mít přihlášený uživatel možnost tento požadavek zobrazit, jinak je uživatel 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ů:

  • sloupce - 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:
    table.column Položka požadavku Poznámky
    tHdTicket.mHdTicketNotice Poznámky
    tHdTicket.sHdTicketGroup Skupina Povoluje jiné než předdefinované hodnoty
    .
    tHdTicket
    .
    sHdTicketDeviceCode
    Číslo zařízení
  • Místo hvězdičky zadejte název konkrétního sloupce.
  • sectionId- id služby
  • sectionName- úplný název služby včetně cesty (
    • např.
  • "Helpdesk/Problems
    • ")
  • mode- jedna z možností Edit(výchozí) a View
  • msg- řetězec obsahující text zobrazený pro nevyplněnou požadovanou položku
  • ticketId- číslo požadavku k zobrazení/uložení

Atributy v cshtml

  • ShowColumns= sloupce- sloupce, které se generují na formulář a ukládají do db. Sloupce se zobrazí v zadaném pořadí shora dolů.
  • RequiredColumns= sloupce - sloupce, které musí být vyplněny, aby bylo umožněno uložení. Tyto sloupce musí být rovněž 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= režim - nastavuje režim zobrazení.
  • TicketId= ticketId- nastavuje ID požadavku, který se má upravit/zobrazit/uložit.
  • CssClass- třída stylu css.
  • IgnoreColumns = sloupce - sloupce, které se nebudou zobrazovat.
  • IncludeServiceColumns- příznak, zda se mají zobrazit 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 v požadavku, jehož id je nastaveno atributem TicketId.
  • UpdateColumns(int ticketId) - uloží vyplněné hodnoty v db k požadavku číslo ticketId.

Příklad použití

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

  • .cshml + automatické uložení (pomocí volání funkce CreateTicket )

    .... Obsah vašeho formuláře....

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

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.