1. Modul MultiEdit

    Článek: AN0001821Aktualizováno::

    Modul obsahuje webpart pro hromadnou editaci záznamů. Pomocí jednoduchého skriptování můžete hromadně upravovat více záznamů a zrychlit tak některé operace.

     

    Pomocí skriptů předáte webpartu seznam záznamů, na které má uživatel právo a které může upravit. Webpart je zobrazí ve formě řádků, kde každé pole může změnit. Uživatel zároveň může záznam smazat nebo vytvořit nové záznamy.

    V horní části webpartu jsou zobrazeny informace o nadřazeném záznamu, pokud existuje - např. záznam faktury, kde uživatel může hromadně měnit položky faktury.

    Webpart nezajišťuje kontrolu práv. To je třeba zajistit pomocí skriptů při inicializaci. Při načtení záznamů je třeba načíst jen ty, které uživatel může editovat a při ukládání uložit jen to, co je třeba.

    Konfigurace

    Vlastnost Popis
    Povolit nové záznamy Vlastnost pro vytváření nových záznamů. Povolením může uživatel vytvořit nový záznam.
    Povolit smazání záznamů Vlastnost pro smazání záznamu. Povolením může uživatel smazat záznam.
    Skript pro inicializaci Skript se spustí při zobrazení stránky s webpartem.
    Skript pro načtení záznamů Skript se spustí pro načtení záznamů pro editaci.
    Skript pro zobrazení záznamů Skript se spustí pro každý záznam před jeho zobrazením na stránce.
    Skript pro nový záznam Skript se spustí při vytváření nového záznamu.
    Skript pro uložení záznamů Skript se spustí při uložení všech záznamů.
    Skript pro smazání záznamu Skript se spustí při mazání záznamu.

    Parametry skriptu pro inicializaci

    Ve skriptu ověřte, zda uživatel může něco editovat. Pak načtete třídu, kterou bude uživatel editovat a sloupce, které mají být ve webpartu zobrazeny.

    OGInit - objekt pro inicializaci webpartu.

    OGWebPart - instance tohoto webpartu

    OGWebParts - seznam všech webpartů na stránce. Pro přístup k webpartům použijte jeji kód.

    Vlastnosti objektu OGInit.

    Vlastnost Popis
    bool NewAsPerson Příznak, zda pro nový záznam se má nejprve zobrazit okno pro výběr uživatele, který je v novém záznamu pak vyplněn. Při nezaškrtnutí je rovnou přidán nový záznam.
    ClassDef ClassDef Třída, jejíž záznamy má uživatel editovat.
    Query Query Dotaz, jehož zázmany může uživatel vidět.
    ColumnClassDefList Columns Seznam sloupců ze třídy, které se mají uživateli zobrazit pro editaci.
    string ErrorMessage Při zadání chybového hlášení bude uživatel přesměrován na chybovou stránku. Vlastnost použijte např. při neoprávněném přístupu uživatele na stránku.
    string LinkNavigation Text pro drobečkovou navigaci. Formát je stejný jako u metody OGForm.SetLinkNavigation.
    string BackUrl URL pro tlačítko Zpět.
    bool HorizontalScrollable Příznak, zda se data mají zobrazit v horizontálně skrolovacím panelu - nedochází tak k velkému roztažení stránky.
    void SetColumnWidth(int index, int width) Metoda nastaví pro sloupec šířku buňky.
    void SetColumnCss(int index, string css) Metoda nastaví pro sloupec CSS styl.
    void SetColumnReadOnly(int index, bool readOnly) Metoda nastaví pro sloupec příznak readonly.

    Parametry skriptu pro načtení záznamů

    Ve skriptu načtěte záznamy, které má uživatel vidět a editovat.

    OGInit - objekt z inicializace. Obsahuje třídu, pro kterou se mají záznamy načíst.

    OGWebPart - instance tohoto webpartu

    OGWebParts - seznam všech webpartů na stránce. Pro přístup k webpartům použijte jejich kód.

    Seznam záznamů vraťte pomocí return.

    Parametry skriptu pro zobrazení záznamů

    Skript se spouští pro každý záznam, předtím než je zobrazen na stránce.

    OGRow - konfigurace pro aktuálně zobrazovaný záznam.
    OGClassDef - Třída, které záznam patří.
    OGDataRow - záznam, který se má zobrazit

    OGWebPart - instance tohoto webpartu.

    OGWebParts - seznam všech webpartů na stránce. Pro přístup k webpartům použijte jejich kód.

    Vlastnosti objektu OGRow.

    Název Popis
    bool EnableDelete Příznak pro povolení/zakázání mazání záznamu.
    bool EnableSave Příznak pro povolení/zakázání uložení záznamu.
    ColumnMultiEdit this[string code] Funkce vrátí nastavení pro sloupec dle zadaného kódu.
    ColumnMultiEdit this[int columnId] Funkce vrátí nastavení pro sloupec dle zadaného id.

    Vlastnosti objektu ColumnMultiEdit.

    Název Popis
    ColumnClassDef Column Určení sloupce, jehož se nastavení týká.
    bool ReadOnly Příznak, zda se má sloupec zobrazit v režimu readonly.
    bool Visible Příznak, zda se má sloupec zobrazit.

    Parametry skriptu pro nový záznam

    Skript se spustí po kliknutí na tlačítko Nový.

    OGNewDataRow - dataRow pro nový záznam.
    OGActualMessage - objekt pro nastavení chybového hlášení.
    OGDataRows - seznam záznamů, které jsou již v editaci. Můžete ho použít pro kontrolu, zda uživatel může nový záznam přidat.
    OGPerson - vybraný nový uživatel.

    OGWebPart - instance tohoto webpartu.

    OGWebParts - seznam všech webpartů na stránce. Pro přístup k webpartům použijte jejich kód.

    Při nastavení chybového hlášení pomocí metody OGActualMessage.SetError můžete zrušit přidání nového záznamu. Uživateli se tak zobrazí chybové hlášení.

     

    Pokud je v nastavení webpartu zaškrtnuta vlastnost NewAsPerson, pak je v parametru OGPerson předána osoba, kterou uživatel vybral při vytváření nového záznamu. Ve skriptu si tuto vlastnost načtěte a případně zkontroluje, zda je možné záznam s vybraným uživatelem vytvořit. Vložte jej pak dle potřeby do OGNewDataRow.

    Parametry skriptu pro uložení záznamů

    OGDataRows - seznam záznamů, které se mají uložit. Seznam obsahuje jen záznamy, které byly uživatelem změněny. Zároveň DataRow obsahuje jen sloupce, které nejsou readonly.

    OGOriginalDataRows - kolekce původních záznamů

    OGWebPart - instance tohoto webpartu.

    OGWebParts - seznam všech webpartů na stránce. Pro přístup k webpartům použijte jejich kód.

    Vlastní uložení zajistí webpart. Vy jen proveďte kontroly, zda je vše správně zadáno. Pokud naleznete chybu, pak ve skriptu vyvolejte výjimku (OG.Throw) a ukládání bude zrušeno.

    Parametry skriptu pro smazání záznamu

    OGDataRowId - Id mazaného záznamu

    OGWebPart - instance tohoto webpartu.

    OGWebParts - seznam všech webpartů na stránce. Pro přístup k webpartům použijte jejich kód.

    Pokud při mazání ve skriptu vyvoláte vyjímku (OG.Throw), pak bude mazání zrušeno.

    Metoda SetColumn...

    Metodami SetColumn... můžete pro konkrétní sloupec nastavit určitou vlastnost. Používejte je pouze v inicializačním skriptu.

    Index pro sloupec začíná od 0 pro první sloupec.

    CSS styly nevložíte na stránku pomocí tohoto webpartu, ale můžete je vložit pomocí webpartu Skript.

    Následující skript vloží do konfigurace dotaz a přidá dva sloupce. Následně pro ně nastaví CSS styl. Nakonec zapne horizontální posun.

    var m = OG.Model.GetByCode('it');
    var q = m.Queries['task_multi_edit'];
    OGInit.Query = q;
    OGInit.Columns.Add( q.Columns['t_name']);
    OGInit.Columns.Add( q.Columns['p_name']);
     
    OGInit.SetColumnCss( 0, 'task headcol');
    OGInit.SetColumnCss( 1, 'proj');
     
    OGInit.HorizontalScrollable = true;

    Skripty na stránce

    Pomocí následujícího skriptu můžete na stránce nastavit url pro tlačítko zpět a drobečkovou navigaci. Hodnoty načtete z webpartu MultiEdit s kódem multi-edit. Tyto hodnoty jste předtím nastavili v inicializačním skriptu webpartu.

    function OnPreRender()
    {
        var m = OGWebParts['multi-edit'];

        OGForm.SetLinkNavigation( m.LinkNavigation);

        var b = OGForm.GetControl('backToolbarButton');
        b.Visible = true;
        b.NavigateUrl = m.BackUrl;
    }

    Ukázka spriptů

    Skripty jsou z modelu kapacitního plánování, kdy uživatelé mají možnost hromadně editovat plán kapacit na projektu.

    Skript pro inicializaci

    var cl = OG.ClassDef.GetByCode( 'it', 'project_year_requested_resources_monthly');
    OGInit.ClassDef = cl;
    OGInit.NewAsPerson = true;
    OGInit.Columns.Add(cl.Columns['resource']);
    OGInit.Columns.Add(cl.Columns['requested_resource_status']);
    OGInit.Columns.Add(cl.Columns['m01']);
    OGInit.Columns.Add(cl.Columns['m02']);
    OGInit.Columns.Add(cl.Columns['m03']);
    OGInit.Columns.Add(cl.Columns['m04']);
    OGInit.Columns.Add(cl.Columns['m05']);
    OGInit.Columns.Add(cl.Columns['m06']);
    OGInit.Columns.Add(cl.Columns['m07']);
    OGInit.Columns.Add(cl.Columns['m08']);
    OGInit.Columns.Add(cl.Columns['m09']);
    OGInit.Columns.Add(cl.Columns['m10']);
    OGInit.Columns.Add(cl.Columns['m11']);
    OGInit.Columns.Add(cl.Columns['m12']);

    var zpid = OG.QueryString.GetInt('drId');
    if ( zpid != null)
    {
        var clPR = OG.ClassDef.GetByCode( 'it', 'project_resources');
        var f = OG.DataRow.GetDataRowFilter( clPR.Id, zpid);
        var r = OG.ClassDef.HaveUserRightByClassDef( clPR.Id, OG.ClassDef.ClassDefRoleOperation_Update);
        if ( r == OG.ClassDef.RoleRight_RoleWithOrgStructure)
        {
            f.Filter_AplyOrgStructureForOperation = OG.ClassDef.ClassDefRoleOperation_Update;
        }
        var drl = OG.DataRow.GetDataByFilter(f);

        if ( drl != null && drl.Count == 1)
        {
            var dr = drl[0];
            var drp = dr.GetDR('project');
            var i = OGInit.Detail.CreateItem(clPR.Columns['project'].Name, drp.ShortDescription);
            i.ValueLink = drp.DetailUrl;
            OGInit.Detail.AddRow(i);

            var i1 = OGInit.Detail.CreateItem(clPR.Columns['year'].Name, dr['year']);
            var i2 = OGInit.Detail.CreateItem(clPR.Columns['amount'].Name, dr['amount']);
            OGInit.Detail.AddRow(i1, i2);

            var col = clPR.Columns['cost_type'];
            var i1 = OGInit.Detail.CreateItem(clPR.Columns['cost_type'].Name, dr.GetColumnDataAsString2( col.Id, col.ColumnType));
            var i2 = OGInit.Detail.CreateItem(clPR.Columns['accounting_amount'].Name, dr['accounting_amount']);
            OGInit.Detail.AddRow(i1, i2);

            var col = clPR.Columns['accounting_currency'];
            var i = OGInit.Detail.CreateItem(clPR.Columns['accounting_currency'].Name, dr.GetColumnDataAsString2( col.Id, col.ColumnType));
            OGInit.Detail.AddRow(i);

            OGInit.LinkNavigation = clPR.Model.Name + '|ModelInfo.aspx?Id=' + clPR.Model.Id + '>' + clPR .Name + '|' + dr.ListUrl + '>Záznam ID ' + dr.Id + '|' + dr.DetailUrl + '>Multi edit|WebContentPage.aspx' + OG.QueryString.Query;
            OGInit.BackUrl = dr.DetailUrl;
        }
        else
        {
            OGInit.ErrorMessage = 'Nemáte právo na úpravu zdrojů.';
        }
    }
    else
    {
        OGInit.ErrorMessage = 'Není zadán zdroj pro úpravu.';
    }

    Skript pro načtení záznamů

    var zpid = OG.QueryString.GetInt('drId');
    if ( zpid != null)
    {
        var col = OGInit.ClassDef.Columns['project_resources'];

        var f = OG.DataRow.GetDataRowFilter( OGInit.ClassDef.Id);
        f.Filter_OnlyActive = true;
        f.SetColumnData( col.Id, zpid);
        //seradit
        var drl = OG.DataRow.GetDataByFilter(f);

        var cl = OG.ClassDef.GetByCode( OGInit.ClassDef.Model.Id, 'requested_resource_status');
        var planStatus = OG.DataRow.GetDataRowByCode(null, cl, 'plan');
        var approvedStatus = OG.DataRow.GetDataRowByCode(null, cl, 'approved');
        var forapproveStatus = OG.DataRow.GetDataRowByCode(null, cl, 'for_approve');

        var usIds = ',';
        for( var i = 0; i < drl.Count; ++i)
        {
            var statusId = drl[i]['requested_resource_status'];
            if ( statusId == planStatus.Id || statusId == forapproveStatus.Id)
            {
                usIds += drl[i]['resource'].Id + ',';
            }
        }
        OG.SetItem('users1', usIds);

        return drl;
    }

    return null;

    Skript pro zobrazení záznamů

    OGRow['resource'].ReadOnly = true;
    OGRow['requested_resource_status'].ReadOnly = true;

    var usIds = OG.GetItem('users1');
    if ( usIds != null)
    {
       var cl = OG.ClassDef.GetByCode( OGClassDef.Model.Id, 'requested_resource_status');
       var approvedStatus = OG.DataRow.GetDataRowByCode(null, cl, 'approved');

       if ( OGDataRow['requested_resource_status'] == approvedStatus.Id && usIds.indexOf( ',' + OGDataRow['resource'].Id + ',') >= 0)
       {
          //var planStatus = OG.DataRow.GetDataRowByCode(null, cl, 'plan');
          var ro = true;   //!( OGDataRow['requested_resource_status'] == planStatus.Id);
          OGRow['m01'].ReadOnly = ro;
          OGRow['m02'].ReadOnly = ro;
          OGRow['m03'].ReadOnly = ro;
          OGRow['m04'].ReadOnly = ro;
          OGRow['m05'].ReadOnly = ro;
          OGRow['m06'].ReadOnly = ro;
          OGRow['m07'].ReadOnly = ro;
          OGRow['m08'].ReadOnly = ro;
          OGRow['m09'].ReadOnly = ro;
          OGRow['m10'].ReadOnly = ro;
          OGRow['m11'].ReadOnly = ro;
          OGRow['m12'].ReadOnly = ro;
       }
    }

    Skript pro nový záznam

    var cl1 = OG.ClassDef.GetById( OGNewDataRow.ParentId);
    var cl = OG.ClassDef.GetByCode( cl1.Model.Id, 'requested_resource_status');
    var planStatus = OG.DataRow.GetDataRowByCode(null, cl, 'plan');

    OGNewDataRow['requested_resource_status'] = planStatus .Id;
    OGNewDataRow['resource'] = OGPerson.ToPersonInfo();
    OGNewDataRow['project_resources'] = OG.QueryString.GetInt('drId');

    if ( OGPerson != null && OGDataRows != null)
    {
        for( var i = 0; i < OGDataRows.Count; ++i)
        {
            var p = OGDataRows[i]['resource'];
            if ( p != null && p.Id == OGPerson.Id)
            {
                OGActualMessage.SetError('Tento uživatel je již vybrán. Vyberte prosím jiného.');
            }
        }
    }

    Příklad vzhledu

    V horní části webpartu jsou hodnoty z nadřízeného záznamu. Vlastnosti a hodnoty se plní skriptem pro inicializaci.

    Následují tlačítka pro nový záznam a uložení všech záznamů.

    Poslední částí jsou vlastní záznamy pro editaci. V příkladu jsou první dva sloupce v režimu readonly. Editovat je možné pouze ostatní položky na řádku.

     

    Příklad konfigurace webpartu. Pro každý skript je vlastní textové pole.

×