URL | (String) URL adresa dat Web serveru, kde jsou umístěna XML data. Aplikace PROMOTIC jako Web server tato data standardně nabízí na cestě (viz karta "PmaData > Web server"): http://NázevPočítače:Port/IdKomponenty/data.xml?fmt=purevalue Upozornění! Začátek adresy ("http:") se musí zadat! Pokud chcete zadat adresu lokálního počítače, pak jako NázevPočítače lze zadat slovo localhost. Port není potřeba zadávat, pokud je Web server na standardním portu 80. Komunikace funguje i se zabezpečeným WEB serverem na adrese https://.... |
---|---|
sUser | [nepovinné] (String) Jméno uživatele pro autentizaci. Viz oprávnění "WebRead" na serveru. Pokud není nastaveno a je vyžadována autentizace, pak je vyvolána událost onEndOfTransfer s chybou pEvent.Error=62. |
sPassword | [nepovinné] (String) Heslo uživatele pro autentizaci. Tento parametr je ignorován, pokud není zadán parametr sUser. |
Tato metoda není funkční pro PmFree.
Metoda dá jen podnět k přenosu dat, ale není vůbec zaručeno že po ukončení této metody jsou již data přenesena. Konec přenosu dat však způsobí že se vyvolá událost onEndOfTransfer. V době přenášení dat (tzn. v době po volání metody ReadFromWeb a předtím než je vyvolána událost onEndOfTransfer) nelze nad objektem znovu volat metodu ReadFromWeb ani metodu WriteToWeb - tehdy metoda vrací hodnotu false. Pomocí vlastnosti WebClientIsReady lze zjistit, zda je objekt připraven na další přenášení.
Příchozími daty budou naplněny proměnné v kartě "Data" tohoto objektu.
var oData = pMe.Pm("Data/Param1");
if (oData.WebClientIsReady)
oData.ReadFromWeb("http://localhost/param/data.xml?fmt=purevalue", "Johny", "abcd");
else
Pm.Debug("Web klient PARAM is not ready (is still active)");