This Service is used to create and delete triggering links for a triggering item. The triggering item and the items to report shall belong to the same Subscription.
Each triggering link links a triggering item to an item to report. Each link is represented by the MonitoredItem id for the item to report. An error code is returned if this id is invalid.
See 5.12.1.6 for a description of the triggering model.
Table 78 defines the parameters for the Service.
Table 78 – SetTriggering Service Parameters
|
Name |
Type |
Description |
|
Request |
|
|
|
requestHeader |
Request Header |
Common request parameters (see 7.33 for RequestHeader definition). |
|
subscriptionId |
IntegerId |
The Server-assigned identifier for the Subscription that contains the triggering item and the items to report (see 7.19 for IntegerId definition). |
|
triggeringItemId |
IntegerId |
Server-assigned id for the MonitoredItem used as the triggering item. |
|
linksToAdd [] |
IntegerId |
The list of Server-assigned ids of the items to report that are to be added as triggering links. The list of linksToRemove is processed before the linksToAdd. |
|
linksToRemove [] |
IntegerId |
The list of Server-assigned ids of the items to report for the triggering links to be deleted. The list of linksToRemove is processed before the linksToAdd. |
|
|
|
|
|
Response |
|
|
|
responseHeader |
Response Header |
Common response parameters (see 7.34 for ResponseHeader definition). |
|
addResults [] |
StatusCode |
List of StatusCodes for the items to add (see 7.39 for StatusCode definition). The size and order of the list matches the size and order of the linksToAdd parameter specified in the request. |
|
addDiagnosticInfos [] |
Diagnostic Info |
List of diagnostic information for the links to add (see 7.12 for DiagnosticInfo definition). The size and order of the list matches the size and order of the linksToAdd request parameter. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request. |
|
removeResults [] |
StatusCode |
List of StatusCodes for the items to delete. The size and order of the list matches the size and order of the linksToRemove parameter specified in the request. |
|
removeDiagnosticInfos [] |
Diagnostic Info |
List of diagnostic information for the links to delete. The size and order of the list matches the size and order of the linksToRemove request parameter. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request. |
Table 79 defines the Service results specific to this Service. Common StatusCodes are defined in 7.39.
Table 79 – SetTriggering Service Result Codes
|
Symbolic Id |
Description |
|
Bad_NothingToDo |
See Table 182 for the description of this result code. |
|
Bad_TooManyOperations |
See Table 182 for the description of this result code. |
|
Bad_SubscriptionIdInvalid |
See Table 182 for the description of this result code. |
|
Bad_MonitoredItemIdInvalid |
See Table 183 for the description of this result code. |
Table 80 defines values for the results parameters that are specific to this Service. Common StatusCodes are defined in Table 183.
Table 80 – SetTriggering Operation Level Result Codes
|
Symbolic Id |
Description |
|
Bad_MonitoredItemIdInvalid |
See Table 183 for the description of this result code. |