| URL | (String) The URL address of the data Web server where the XML data are stored. The PROMOTIC application as the Web server offers the data by default on the path (see the "PmaData > Web server" tab): http://ComputerName:Port/ComponentId/data.xml?fmt=purevalueCaution! Head of the address ("http:") must be entered! If you want to enter the address of the local computer, then it is possible to enter the localhost word as the ComputerName. The Port needn't be entered if the Web server is on the standard port 80. The communication also works on secured WEB server on address https://.... |
|---|---|
| sUser | [optional] (String) User name for the authentication. See "WebRead" permission on the server. If not set and the site requires the authentication, then the onEndOfTransfer event is triggered with the pEvent.Error=62. |
| sPassword | [optional] (String) Password of the user for the authentication. This parameter is ignored if the sUser parameter is missing. |
This method is not functional for PmFree.
The method only activates the data transfer but there is no assurance that data are already transferred after ending this method. The data transfer termination is announced by the the onEndOfTransfer event. During the data transfer (i.e. in the time after calling the ReadFromWeb method and before the onEndOfTransfer event is triggered) the ReadFromWeb nor the WriteToWeb method cannot be called over the object again - then the method returns the false value. By means of the WebClientIsReady property it can be found out if the object is ready for the next transfer.
Variables on the "Data" tab of this object are filled up by the incoming data.
var oData = pMe.Pm("Data/Param1");
if (oData.WebClientIsReady)
oData.ReadFromWeb("http://localhost/param/data.xml?fmt=purevalue", "Johny", "abcd");
else
Pm.Debug("Web client PARAM is not ready (is still active)");