RegisterCallback

From
(Difference between revisions)
Jump to: navigation, search
 
Line 1: Line 1:
******************Basic template for method description********************
 
 
== Method ==
 
== Method ==
Method
+
[[RegisterCallbackResult]] registerCallback([[UserIDBean]] userID, String url, [[UserIDBean]] callbackUserID, long updatePeriod, [[CallbackVersion]] version)
  
 
== Description ==
 
== Description ==
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 ==
 
== Parameters ==
Line 16: Line 17:
 
|The admin username and password.
 
|The admin username and password.
 
|---- bgcolor=#EDEDFF
 
|---- bgcolor=#EDEDFF
|[[Type]]
+
|String
|Name
+
|url
|Description.
+
|The URl location of the callback interface instance.
 +
|---- bgcolor=#EDEDFF
 +
|[[UserIDBean]]
 +
|callbackUserID
 +
|The username and password required for Eservice to be able to access methods on the callback instance.
 +
|---- bgcolor=#EDEDFF
 +
|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.
 +
|---- bgcolor=#EDEDFF
 +
|[[CallbackVersion]]
 +
|version
 +
|The particular version of the callback interface that has been implemented.
 
|}
 
|}
  
 
== Return Value ==
 
== Return Value ==
[[ReturnValue]]
+
[[RegisterCallbackResult]]

Revision as of 05:58, 10 June 2005

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.
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.
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.

Return Value

RegisterCallbackResult

Personal tools
MediaWiki Appliance - Powered by TurnKey Linux