RegisterCallback
From
(Difference between revisions)
(→Parameters) |
|||
Line 23: | Line 23: | ||
|[[UserIDBean]] | |[[UserIDBean]] | ||
|callbackUserID | |callbackUserID | ||
− | |The username and password required for | + | |The username and password required for EService to be able to access methods on the callback instance (that implements callback API). |
|---- bgcolor=#EDEDFF | |---- bgcolor=#EDEDFF | ||
|long | |long |
Revision as of 21:43, 10 September 2015
Contents |
Method
RegisterCallbackResult registerCallback(UserIDBean userID, String url, UserIDBean callbackUserID, long updatePeriod, CallbackVersion version)
Description
Registers an instance of the callback interface for receiving events related to field devices and jobs. Each user may register only once, if more than one callback interface must be registered, a user for each must be created in the NADS system.
As part of the registration process, getVersion will be called on the interface to ensure that the version is supported and the interface is up. If this test fails, an failure will be returned by this method.
Parameters
Type | Name | Description |
---|---|---|
UserIDBean | userID | The admin username and password used by your application to communicate with EService. |
String | url | The URl location of the callback interface instance. |
UserIDBean | callbackUserID | The username and password required for EService to be able to access methods on the callback instance (that implements callback API). |
long | updatePeriod | The period in seconds between calls to the callback interface. The minimum period between updates is 10 seconds, and the recommended value is 60 seconds. |
CallbackVersion | version | The particular version of the callback interface that has been implemented. |