Operation addSlaves is used to add new slaves.
If WUI is working in master mode (more info in How to run? page), we can add new slave (station which can copy of user application can be run) to vui master using addSlaves request.
Request should contain pair of network addresses – internal WUI application address and SOAP address – usually ip addresses will be the same, and ports will differ.
Operation progress and result can be checked using getTaskStatus request. When slave is successfully added, user is able to run copy of his Billon application on it.
Example SOAP request:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="ns1">
<soapenv:Header/>
<soapenv:Body>
<ns1:addSlaves soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<newSlaves xsi:type="ns1:slaveLocationList">
<!--Zero or more repetitions:-->
<item xsi:type="ns1:slaveLocation">
<soapAddress xsi:type="ns1:ipLocation">
<ip xsi:type="xsd:string">192.168.3.192</ip>
<port xsi:type="xsd:unsignedShort">9600</port>
</soapAddress>
<applicationAddress xsi:type="ns1:ipLocation">
<ip xsi:type="xsd:string">192.168.3.192</ip>
<port xsi:type="xsd:unsignedShort">30200</port>
</applicationAddress>
</item>
</newSlaves>
</ns1:addSlaves>
</soapenv:Body>
</soapenv:Envelope>
Example SOAP response:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ns1="ns1">
<SOAP-ENV:Header/>
<SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<ns1:addSlavesResponse>
<return xsi:type="ns1:vuiSoapTaskIdResponse">
<requestStatus>SUCCESS</requestStatus>
<requestStatusDescription>Request succeeded.</requestStatusDescription>
<taskId>0B3LCA6254A12E5GEB0MF4F6LH</taskId>
</return>
</ns1:addSlavesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Request parameters:
| parameter | type | description |
|---|---|---|
| newSlaves | slaveLocationList | list of slaves to be added |
Response parameters:
| name | type | description |
|---|---|---|
| taskId | string | id of created task |
| requestStatus | string | result of request |
| requestStatusDescription | string | status description |