Language Reference - IO - DPWS Object


Icon

A DPWS Object is used to communicate with a DPWS server. Each DPWS Object needs a binding to a service porttype.

DPWS Eventing

To enable eventing for an application you need to configure the network interface and port to use for event callback. This is done in the Application Properties. To start a subscription use dpwsSubscribe. Incoming events are stored in a separate list for each Notification operation. To check if there are any events for any operation, use the event expression /obj. To check if there are any events for a specific operation, use dpwsHasEvent. To get the next event in the list for a specific operation, use dpwsGetEvent. The return value from dpwsGetEvent works the same as the return value for Request Response operations.

DPWS Faults

Faults that occur when making DPWS calls are stored in a list. To check if there are any stored faults, use dpwsHasFault. To get the next fault in the list, use dpwsGetFault.

Text Methods

The text methods available on a DPWS Object are the operations in its bound porttype of type One Way and Request Response.

The root element is created automatically and for convenience it specifies the targetNamespace of the wsdl:definitions with prefix tns (if specified).

The allowed arguments depend on the operation:

Request Response operations return the root element's contents as a string.
Hint: xmlFetch can be used to extract information from the returned string.

Context Menu

Note: Edit is chosen automatically instead of showing a context menu with only one choice.