Adapter Development Kit 6.5 | webMethods Adapter Development Kit Documentation | webMethods Adapter Development Kit Installation and User’s Documentation | Using the Services for Managing Namespace Nodes | Polling Notification Services | wm.art.dev.notification:updatePollingNotificationNode
 
wm.art.dev.notification:updatePollingNotificationNode
This service alters the characteristics of an existing polling notification. You must populate the input pipeline according to the table below before calling this service. To obtain a list of supported template and schedule properties, call the service wm.art.dev.notification:fetchPollingNotificationTemplateMetadata. You must disable a polling notification before updating its properties, using the disablePollingNotification service. For more information, see the webMethods Integration Server Built-In Services Reference for your release.
You might want to modify the following items:
*The underlying connection resource used by the notification
*Its metadata property values
*Its schedule
*The signature of its publishable output document
These items are represented, respectively in the input pipeline as connectionAlias, notificationSettings, scheduleSettings,and publishableRecordDef.You may provide values in any or all of these parameters when calling this service. For the first three of these parameters, the service attempts to overlay the given values onto the notification's current values. The resulting set of merged property values are used to reconfigure the polling notification.
For instance, you can change the connection resource that the polling notification uses by providing a new connectionAliasinput parameter. If you omit this parameter, the notification continues to use its current connection resource. If you are changing only the connection resource, it is not necessary to provide the notificationSettings,scheduleSettings,or publishableRecordDefinput parameters.
For an example of setting values within the pipeline, see wm.art.dev.notification:createPollingNotificationNode. In particular, note that when constructing the notificationSettingsparameter, the value of the systemName metadata attribute is the adapter-specific internal name of a property. You should substitute the actual internal system property name for the systemName placeholder. (You can fetch the name using wm.art.dev.notification:fetchPollingNotificationTemplateMetadata.)
Unlike notificationSettingsand scheduleSettings, with publishableRecordDefyou must provide values defining the entire document; the service does not attempt to merge these values into the current publishable record definition. The values in publishableRecordDefwill replace the current definition values. You populate the publishableRecordDefparameter in much the same manner that you populate notificationSettings (as described above). The difference is that the fieldNamesand fieldTypesproperties view an array of String. There is a one-to-one correspondence between the elements in these two arrays.
When specifying property values, you must provide values that conform to the underlying data types of those properties.
Be aware of any resource domains registered by the notification, and set the notification's properties according to the interdependencies between resource domains. Knowledge of these interdependencies is adapter-specific, and beyond the scope of this service. This service does not interpret resource domains.
Input Parameters
notificationName
String. Required. The namespace folder:node name of an existing polling notification.
connectionAlias
String. The namespace folder:node name of the connection to use.
notificationSettings
IData. The structure for passing notification property values.
.systemName
The value of the systemName property; see notes 1 and 2.
scheduleSettings
IData. The notification's schedule settings.
.notificationInterval
Integer. The polling frequency; see note 2.
.notificationOverlap
Boolean. Specifies whether the notifications can overlap; see note 2.
.notificationImmediate
Boolean. Specifies whether to fire the notification immediately; see note 2.
publishableRecordDef
IData. The output document definition.
.fieldNames
String[]. The names of the fields used in the notification's output document; see note 3.
.fieldTypes
String[]. The data types of the fields used in the notification's output document; see notes 1 and 3.
Note: 
1. The following Java data types are supported for adapter services: char, short, int, long, float, double, boolean, java.lang.String, java.lang.Character, java.lang.Short, java.lang.Integer, java.lang.Long, java.lang.Float, java.lang.Double, java.lang.Boolean. Arrays of all the above data types are also supported.
2. Set only those properties that you want to change. If a property's data type is non-primitive (that is, derived from java.lang.Object) you may "undefined" its current value by setting it to null. There is no way to do this for Java primitives; they may only be redefined.
3. Values inserted into fieldNames must correspond in number and order to the values inserted into fieldTypes. Additionally, you must provide values defining the entire document; the service does not attempt to merge these values into the current publishable record definition.
Output Parameters
None.