Objekt datových služeb – konstruktor DATServices()

Sdružuje metody pro komunikaci s aplikací na serveru a potažmo i s databází. Nabízí vedle obecné metody pro předání požadavku a převzetí odpovědi také pomocné metody pro vybrané, nejčastěji používané, požadavky.


Metody

dats.getResponse(requestNode, purpose, getAll) Obecně použitelná metoda pro komunikaci se serverem, jejíž první argument obsahuje objekt s uzlem XML požadavku odesílaného na server. Výsledkem funkce je opět XML objekt s uzlem odpovědi. Je-li getAll nastaveno na true, pak je vracen kmenový uzel odpovědi (response), jinak jen jeho první potomek – využíváno častěji.

dats.doEmailSync(fullInitSync) Tato funkce spřístupňuje provedení aktualizační nebo plné synchronizace s poštovní schránkou aktuálně přihlášeného uživatele. Funkce pouze vyvolá požadavek na synchronizaci a ihned vrací true či false podle toho, zda se podařilo požadavek předat. Výsledek však nehovoří o tom, zda již k syncu došlo či nikoli. Aktualizační sync (fullInitSync == false) však trvá většinou pouze zlomky vteřin a často tak není třeba na výsledky čekat.

dats.getQueryRes(selStr/selStrArr, selType/selTypeArr) Metoda vrací výsledek z jednoho nebo více dotazů. Pokud jsou argumenty zadány formou prostého řetězce, pak vrací jeden výsledek. Pokud formou řetězcového pole, pak vrací výsledek s více potomky result nastavené na odpovídající typy. Vracený uzel je vždy sql-query-result.

dats.saveSetting(typeName, tbID, settsNd, lockIt, loginID) Metoda zpřístupňuje nástroj ukládání samostatných XML jako nastavení tabulek do databáze. Každé takové nastavení má přidělen typ. Typ se skládá ze dvou slov oddělenýc pomlčkou. První slovo nabývá hodnot manual / user / corporate / public. Druhé slovo pak označuje zda se jedná o dílčí nastavení table či kmen celých nastavení root. Např. tedy user-table (nejčastější). Upozornění – do oblasti manual (příručka) nelze ukládat – jde o soubory webu a nikoli záznamy v databázi. V případě nastavení typu table je zapotřebí udat též tbID (celé číslo – většinou čtyřmístné). Jako třetí argument je předáván uzel XML nastavení pro uložení (tag table). Pokud bude tento uzel nastaven na null, bude to chápáno jako požadavek na výmaz nastavení pod daným tbID. Nastavení zámku lockIt zde nemá význam. Argument loginID není povinný – udává číslo aktuálního uživatele.

dats.getSetting(typeName, tbID, lockIt, loginID) Tato metoda je získává z databáze to, co metoda saveSetting() uložila. Význam argumentu je stejný. Argument lockIt=true zde zapříčiní zamčení položky v databázi proti změně jinými uživateli až do okamžiku provedení uložení. Pokud toto uložení neproběhne do dvaceti minut, odblokuje se zámek automaticky.

dats.prepReqNd(sName) Metoda vrací objekt XML elementu daného jména, jež není zařazen v žádném dokumentu. Metoda je využívána pro sestavování požadavku. Většinou se jedná o vytvoření uzlu request, jakožto rodičovského pro sestavení a odeslání speciálního požadavku.

dats.setTemp(contentNode) Metoda pro nastavení dočasného obsahu přihlášenoho uživatele na serveru (požadavek set-temp). Tento obsah je možné v krátké době opět získat požadavkem get-temp. Tento mechanizmus se využívá zejm. při komunikaci s příp. dialogovými okny speciální stránky, kde může takto docházet k předávání i větších XML dokumentů. Metoda vrací true nebo false dle úspěšnosti nastavení dočasného obsahu.

dats.getTemp() Opak metody setTemp(). Vrací uzle contentNode dočasného obsahu na serveru (požadavek get-temp). Zároveň tento obsah na serveru maže.

dats.getParKey() v případě, že spec. přehled je jako podpřehled jiného, vrací číselný údaj o klíči vybrané položky nadřazeného přehledu.

dats.getParType() podobně jako předchozí - v případě, že spec. přehled je jako podpřehled jiného, vrací řetězec s údajem o typu dokumentu vybrané položky nadřazeného přehledu.


Vlastnosti

dats.reqDoc – objekt DOM pro tvorbu požadavků

dats.serverURL – nabízí aktuální http odkaz z okna prohlížeče (umístění web-rootu)


Speciální nastaveníPoužití souborů skriptů v běžných a speciálních přehledechObjekt speciálních služeb plochy – konstruktor SPCServices()Objekt obecných metod – konstruktor GENServices()Objekt datových služeb – konstruktor DATServices()Objekt rychlého menu – konstruktor FMNMenu(oWin, oSpcs)