CacheData
Osztály: TXMLTransformProvider
property CacheData: Boolean;
Ha ennek a property-nek az értéke igaz, akkor a komponens az XML dokumentum első beolvasása után az adatcsomagokat a memóriában tárolja. Ha a property értéke hamis, akkor minden alkalommal, amikor a Data property kiolvasása kerül, a GetRecords metódus meghívásakor, illetve az adatok véglegesítésekor minden alkalommal az XMLDataFile property-ben megadott fájlból újra be kell olvasni az adatokat.
TransformRead
Osztály: TXMLTransformProvider
property TransformRead: TXMLTransform;
Ebben a property-ben adhatjuk meg azt a transzformációs fájlt, ami az XML dokumentumot konvertálja az adatkészletté. Ha az XMLTransformProvider komponenst egy ClientDataSet komponenshez kapcsoljuk, akkor az adatok ugyanúgy megjeleníthetők és szerkeszthetők lesznek, mint bármilyen más adatkészlet (adatbázis) esetén.
TransformWrite
Osztály: TXMLTransformProvider
property TransformWrite: TXMLTransform;
Ha az adatokat egy kliens adatkészleten keresztül szerkesztettük (ClientDataSet), akkor a módosításokat visszaírhatjuk az eredeti XML dokumentumba. Ehhez viszont szintén meg kell adni egy transzformációs fájlt, ami az adatkészletet konvertálja megfelelő formátumú XML dokumentummá. Ezt a transzformációs fájlt ebben a property-ben adhatjuk meg.
XMLDataFile
Osztály: TXMLTransformProvider
property XMLDataFile: string;
Ebben a property-ben adhatjuk meg az adatokat tartalmazó XML dokumentumot. A dokumentum szerkezetét saját magunk alakíthatjuk ki, tetszés szerinti struktúrát létrehozva. Miután a struktúrát kialakítottuk az XML Mapper segédprogrammal elkészíthetjük a szükséges transzformációs fájlokat ahhoz, hogy a dokumentumot, mint adatkészletet tudjuk alkalmazni programunkban. Ha csak megjeleníteni szeretnénk az adatokat, akkor csak egy transzformációs fájlt kell előállítanunk, azt amelyik az XML dokumentumból előállít egy XML adatcsomagot. Ha a módosításokat el szeretnénk tárolni, akkor a másik transzformációs fájlt is el kell készíteni, ami az adatcsomagokat konvertálja az XML dokumentumnak megfelelő formátumra.
AfterApplyUpdates
Osztály: TXMLTransformProvider
property AfterApplyUpdates: TRemoteEvent;
Ez az esemény azután jön létre, miután a provider aktualizálta a módosításokat.
Amikor a kliens adatkészlet meghívja az IAppServer interfész AS_ApplyUpdates metódusát, akkor a következő események zajlanak le:
- a provider fogadja a BeforeApplyUpdates eseményt, és módosíthatja, vagy feldolgozhatja a paraméterként megkapott információkat, amelyeket a kliens adatkészlet küldött;
- megtörténik az adatok véglegesítése (frissítése);
- létrejön az AfterApplyUpdates esemény, amiben szintén feldolgozhatjuk az OwnerData paraméterben kapott adatokat, vagy akár küldhetünk is ezen keresztül információkat a kliens adatkészletnek;
- létrejön a kliens adatkészlet AfterApplyUpdates eseménye is, amiben megkapja az általunk megadott információkat.
AfterGetRecords
Osztály: TXMLTransformProvider
property AfterGetRecords: TRemoteEvent;
Ez az esemény akkor jön létre, amikor a provider létrehozott egy adatcsomagot, amit elküldött a kliens adatkészletnek. Az események a következő sorrendben követik egymást:
- a provider fogadja a BeforeGetRecords eseményt, amiben megkaphatja a kliens adatkészlet által küldött információkat (OwnerData paraméter);
- a provider létrehozza a küldendő adatcsomagot;
- a provider fogadja az AfterGetRecords eseményt, amiben szintén információkat kaphat, illetve küldhet, amit a kliens adatkészlet a saját AfterGetRecords eseményében kap meg;
AfterRowRequest
Osztály: TXMLTransformProvider
property AfterRowRequest: TRemoteEvent;
Ez az esemény azután jön létre, miután a provider fogadta az aktuális rekord új információit.
Amikor a kliens adatkészlet meghívja az IAppServer interfész AS_RowRequest metódusát, akkor a következő események követik egymást:
- a provider fogadja a BeforeRowRequest eseményt, amiben megkaphatja a kliens adatkészlet által küldött információkat (OwnerData paraméter);
- a provider elkészíti a Delta adatcsomagot, ami a lekérdezett információkat tartalmazza;
- a provider fogadja az AfterRowRequest eseményt, amiben szintén információkat kaphat, illetve küldhet, amit a kliens adatkészlet a saját AfterRowRequest eseményében kap meg;
BeforeApplyUpdates
Osztály: TXMLTransformProvider
property BeforeApplyUpdates: TRemoteEvent;
Az adatok véglegesítése előtt jön létre ez az esemény (részletesen lásd AfterApplyUpdates esemény).
BeforeGetRecords
Osztály: TXMLTransformProvider
property BeforeGetRecords: TRemoteEvent;
Ez az esemény akkor jön létre, amikor a provider létrehozott egy adatcsomagot, amit el fog küldeni a kliens adatkészletnek (részletesen lásd AfterGetRecords esemény).
BeforeRowRequest
Osztály: TXMLTransformProvider
property BeforeRowRequest: TRemoteEvent;
Ez az esemény azelőtt jön létre, mielőtt a provider fogadná az aktuális rekord új információit (részletesen lásd AfterRowRequest esemény).
OnDataRequest
Osztály: TXMLTransformProvider
property OnDataRequest: TDataRequestEvent;
Ez az esemény akkor jön létre, amikor a provider meghívja a DataRequest metódust. Az eseményben a kapott Input paraméter alapján meghatározhatjuk az adatkészletet, például a kliens által megadott szűrési feltételt alkalmazhatjuk az adatkészletre. Az esemény egy függvény, aminek visszatérési értéke a feldolgozott (pl. szűrt) adatkészlet XML adatcsomag formátumban (Data property).