Adatok szerkesztése

Egy adat új felvitelének folyamata a kliensoldalról indul, az entitás és a környezet meghatározásával, majd az alábbi szerveroldali folyamatok kerülnek végrehajtásra, illetve a felsorolt belépési pontokra van lehetőség:

1. Az OnInitNewRec(TEntity, RecroGridRGServiceParams) metódus segítségével az új entitás inicializálása van lehetőség. Paraméterben az új entitás és a kliensről érkező környezet kerül átadásra. Alapértelmezés szerint az entitás esetleges parent-hez kapcsolása, és ha az entitás megvalósította az IRecroGridInitNew interface-t, akkor a RecroGridInitNew(IRGDataContext, RGClientParam) metódusa is végrehajtásra kerül.

   C#

   Copy

   protected override void OnInitNewRec(ref Person newRec, RGServiceParams arg)
   {
       //IRecroGridInitNew végrehajtás
       base.OnInitNewRec(ref newRec, arg);
   }

2. Az inicializált új entitás és az aktuális RecroGrid-hez tartozó template alapján elkészül a HTML kimenet, amit a kliens megjelenít a felhasználónak szerkesztésre. Miután felhasználó jóváhagyja új felvitelét a kliensoldali ellenőrzéseket követően a rendszer visszaküldi a rögzített adatokat szerveroldalra.

3. Szerveroldalon ismételten lefut az OnInitNewRec(TEntity, RecroGridRGServiceParams) metódus, és ha a jogosultságok az új felvitelt lehetővé teszik, akkor elindul egy SQL tranzakció és az OnDataExchange(UTP, DictionaryString, Object) metódus feltölti a rekordot a kliensről kapott adatokkal.

   C#

   Copy

   protected override async Task OnDataExchangeAsync(Person dataRec, Dictionary<string, object> clientData, RGUIMessages messages)
   {
       //dataRec feltöltése a kliensről kapott adatokkal
       await base.OnDataExchangeAsync(dataRec, clientData, messages);
   
       object data;
       if (clientData.TryGetValue("MyCustomValue", out data))
       {
           //kliensoldalról visszakapott egyéni adat
       }
   }

4. OnUpdateRec(RecroTrack, UTP, RGClientParam, RGUIMessages) virtuális metódus felülírásával szerveroldali ellenőrzések és egyéni adatmódosítások hajthatók végre. Alapértelmezés szerint ha az entitás megvalósította az IRecroGridUpdate interface-t, akkor a RecroGridUpdate(IRGDataContext, RGClientParam, RGUIMessages) metódusa is végrehajtásra kerül. A szerveroldali ellenőrzéseket itt javasolt elvégezni, az esetleges hibaüzeneteket mezőkhöz kapcsolva vissza lehet adni. Ha a visszatérési érték True, akkor a tranzakció jóváhagyásra kerül, az esetleges figyelmeztető üzenetek megjelenítésre kerülnek, ellenkező esetben a tranzakció visszavonásra kerül és megjelennek a hibaüzenetek.

   C#

   Copy

   protected override async Task<bool> OnUpdateRecAsync(RecroTrack tracking, Person dataRec, RGClientParam arg, RGUIMessages messages)
   {
       if (arg.IsNewEntity)
       {
           //új felvitel egyéni kiegészítés
       }
       else
       {
           //módosítás egyéni kiegészítés
       }
   
       //IRecroGridUpdate végrehajtás
       if (!await base.OnUpdateRecAsync(tracking, dataRec, arg, messages))
       {
           return false;
       }
   
       if (string.IsNullOrEmpty(dataRec.FirstName))
       {
           //mezőhöz kapcsolt hibaüzenet RecroDict szótárból
           messages.AddError(RecroDict.Get(this.RecroGridContext.HttpContext, "Person.Validation", "FirstName"), this.Alias2ClientName("FirstName"));
       }
       if (!ExternalValidation(dataRec))
       {
           messages.AddError("Egyéni dialog hibaüzenet!");
       }
       return messages.ErrorCount == 0;
   }

A módosítás folyamata az új felviteltől két ponton tér el. Módosítás esetén az OnInitNewRec metódus nem kerül meghívásra, illetve a kulcs módosítása esetén az SQL tranzakció indítását követően a kulcs direkt SQL update segítségével módosításra kerül.

Törlés esetén az OnDeleteRec(RecroTrack, UTP, RGClientParam, RGUIMessages) metódus kerül végrehajtásra, ami alapértelmezés szerint, ha az entitás megvalósította az IRecroGridDelete interface-t, akkor a RecroGridDelete(IRGDataContext, RGClientParam, RGUIMessages) metódusa is végrehajtásra kerül. Kliensoldalon a felhasználó számára figyelmeztető üzenet jelenik meg. A rekord könnyebb azonosítására az RGO_FriendlyKey opciós paraméterben azon mezők ClientName azonosítóját lehet felsorolni, amik értékei az üzenetben megjelennek.

Ellenőrzéseket javasolt már kliensoldalon is elhelyezni, amiben a kliensoldali osztály létrehozása nélkül, a következő opciós paraméterek segítenek.

• RGO_Nullable opciós beállításban false paraméter esetén a mezőt kötelező kitölteni, ellenkező esetben a \NULL megadásával lehet null értéket beállítani.

• RGO_MaxLength opciós paraméter meghatározza egy karakteres mező maximális hosszát a kliensoldali bevitel esetén.

• RGO_JSValidator opciós beállításban egy kliensoldali JavaScript ellenőrzést lehet végrehajtani. A függvény egy args nevű paramétert kap, ami tartalmaz egy ClientRec tömböt az adatrögzítés során elérhető összes mező definíciójával és értékével. Az egyes mezőkre a ClientName használatával lehet hivatkozni, ami megadja a RecroGridColumnDefs adatokat és a Value-ban az oszlop értékét. Az aktuális mező értéke közvetlenül az args.Value-ból is kinyerhető. Hiba esetén a visszatérési érték false az args.Error-ban pedig a hibaüzenetet lehet megadni.

• RGO_NoKeyUpdate opciós paraméter beállításával letiltható a kulcs módosítása.

//RegExp érték vizsgálat
var patt = new RegExp('^[\$0-9a-zA-Z]+$');
if (!patt.test(args.Value)) {
    args.Error = 'A mező értéke csak betűket és számokat tartalmazhat!';
    return false;
}

//Másik mezőtől függés
if (args.Value < args.ClientRec['rg-col-112'].Value) {
    //args.Error = get_RecroDictStr('Scope', 'Id');// Üzenet RecroDict szótárból
    args.Error = 'Az AB nem lehet kisebb mint a XY!';
    return false;
}

A szerveroldali ellenőrzések az előző szekcióban bemutatott interfészek és virtuális metódusok használatával végezhető. A RGUIMessages paraméterben hiba és figyelmeztető üzeneteket lehet megadni, ami kliensoldalon a adott mezőhöz kapcsoltan megjelenik.