Skip to content

Reference

OpcShelvedStateMachineNode Class

Defines a specialization of the OpcFiniteStateMachineNode which implements a sub-state machine that represents an advanced alarm filtering model.

Reference

OpcShelvedStateMachineNode Class ​

Namespace
Opc.UaFx
Assembly
Opc.UaFx.Advanced.dll
Package
Opc.UaFx.Advanced v2.59.0
Members
OpcShelvedStateMachineNode Members

Defines a specialization of the OpcFiniteStateMachineNode which implements a sub-state machine that represents an advanced alarm filtering model.

Syntax ​

csharp
public class OpcShelvedStateMachineNode : OpcFiniteStateMachineNode
vbnet
Public Class OpcShelvedStateMachineNode
    Inherits OpcFiniteStateMachineNode

Inheritance ​

Object → OpcNode → OpcInstanceNode → OpcObjectNode → OpcStateMachineNode → OpcFiniteStateMachineNode → OpcShelvedStateMachineNode

Implements ​

Remarks ​

The state model supports two types of Shelving: OneShotShelving and TimedShelving. This includes the allowed transitions between the various sub-states. Shelving is an operator initiated activity.

In OneShotShelving, a user requests that an alarm be shelved for its current active state. This type of shelving is typically used when an alarm is continually occurring on a boundary (i.e. a condition is jumping between high alarm and high high alarm, always in the active state). The one shot shelving will automatically clear when an alarm returns to an inactive state. Another use for this type of shelving is for a plant area that is shutdown i.e. a long running alarm such as a low level alarm for a tank that is not in use. When the tank starts operation again the shelving state will automatically clear.

In TimedShelving, a user specifies that an alarm be shelved for a fixed time period. This type of shelving is quite often used to block nuisance alarms. For example, an alarm that occurs more than 10 times in a minute may get shelved for a few minutes.

In all states, the Unshelve can be called to cause a transition to the unshelve state; this includes un-shelving an alarm that is in the timed shelve state before the time has expired and the one shot shelve state without a transition to an inactive state.

The 'Time Expired' transition is simply a system generated transition that occurs when the time value defined as part of the 'Timed Shelved Call' has expired. The 'Any Transition Occurs' transition is also a system generated transition; this transition is generated when the condition goes to an inactive state.

Constructors ​

NameDescription
OpcShelvedStateMachineNode6 overloadsInitializes a new instance of the OpcShelvedStateMachineNode class accessible by the name specified.

Properties ​

NameDescription
DefaultTypeDefinitionIdprotected · overrideGets the default identifier which identifies the node that defines the underlying node type from that this OpcInstanceNode has been created.
OneShotShelveCallbackGets or sets a callback used to shelve the condition node once.
OneShotShelveNodeGets the OpcActionMethodNode used to handle 'OneShotShelve' method calls to shelve a condition node once.
TimedShelveCallbackGets or sets a callback used to shelve the condition node for a specific amount of time.
TimedShelveNodeGets the OpcTimedShelveMethodNode used to handle 'TimedShelve' method calls to shelve a condition node for a specific amount of time.
UnshelveCallbackGets or sets a callback used to unshelve the condition node.
UnshelveNodeGets the OpcActionMethodNode used to handle 'Unshelve' method calls to unshelve a condition node.
UnshelveTimeGets the remaining time in milliseconds until the alarm automatically transitions into the un-shelved state.
UnshelveTimeNodeGets the OpcPropertyNode<T> of the UnshelveTime property.

Methods ​

NameDescription
OneShotShelveShelves a condition node once using the context specified.
OneShotShelveCoreprotected · virtualShelves a condition node once using the context specified.
TimedShelveShelves a condition node for specific amount of time using the context and duration specified.
TimedShelveCoreprotected · virtualShelves a condition node using the context and duration information specified.
UnshelveUnshelves a condition node using the context specified.
UnshelveCoreprotected · virtualUnshelves a condition node using the context specified.

Inherits members from OpcFiniteStateMachineNode, OpcObjectNode, OpcInstanceNode, OpcNode.

Extension methods ​

NameDescription
OpcStateMachineNodeExtension.ChangeStateChanges the current state of the stateMachineNode specified using the further specified context.

Applies to ​

PackageVersions
Opc.UaFx.Advancedv2.5–v2.59