The NodeOPCUA API The NodeOPCUA API

  • API Docs for Version: 0.1.0-pre

    • APIs

    Show:

    Subscription Class

    Defined in: packages\node-opcua-server\src\subscription.js:158
    Module: opcua.server

    The Subscription class used in the OPCUA server side.

    Constructor

    Subscription

    (
    • options
    )

    Defined in packages\node-opcua-server\src\subscription.js:158

    Parameters:

    • options Object
      • id Integer
        • a unique identifier
      • publishingInterval Integer
      • maxKeepAliveCount Integer
      • lifeTimeCount Integer
      • publishingEnabled Boolean
      • sessionId NodeId
        • [optional]
      • maxNotificationsPerPublish Integer
      • priority Byte

    Methods

    _addNotificationMessage

    (
    • notificationData
    )

    Defined in packages\node-opcua-server\src\subscription.js:812

    Parameters:

    • notificationData ArrayEventNotificationList | StatusChangeNotification>

    _createMonitoredItemStep2

    (
    • timestampsToReturn
    • monitoredItemCreateRequest
    • node
    )
    subscription_service.MonitoredItemCreateResult private

    Defined in packages\node-opcua-server\src\subscription.js:1229

    Parameters:

    Returns:

    subscription_service.MonitoredItemCreateResult:

    _popNotificationToSend

    () NotificationMessage

    Defined in packages\node-opcua-server\src\subscription.js:866

    Extract the next Notification that is ready to be sent to the client.

    Returns:

    NotificationMessage:

    the Notification to send._pending_notifications

    _publish_pending_notifications *

    () private

    Defined in packages\node-opcua-server\src\subscription.js:408

    _publish_pending_notifications send a "notification" event:

    _sendKeepAliveResponse

    () private

    Defined in packages\node-opcua-server\src\subscription.js:630

    _tick

    () private

    Defined in packages\node-opcua-server\src\subscription.js:551

    acknowledgeNotification

    (
    • sequenceNumber
    )
    StatusCode

    Defined in packages\node-opcua-server\src\subscription.js:949

    Parameters:

    • sequenceNumber Number

    Returns:

    StatusCode:

    adjustSamplingInterval

    (
    • samplingInterval
    • node
    )
    Number | private

    Defined in packages\node-opcua-server\src\subscription.js:1048

    adjust monitored item sampling interval

    • an samplingInterval ===0 means that we use a event-base model ( no sampling)
    • otherwise the sampling is adjusted

    Parameters:

    • samplingInterval Object
    • node Object

    Returns:

    Number | :

    discardOldSentNotifications

    () private

    Defined in packages\node-opcua-server\src\subscription.js:893

    discardOldSentNotification find all sent notification message that have expired keep-alive and destroy them.

    getAvailableSequenceNumbers

    () Integer

    Defined in packages\node-opcua-server\src\subscription.js:934

    returns in an array the sequence numbers of the notifications that haven't been acknowledged yet.

    Returns:

    Integer:

    getMonitoredItem

    (
    • monitoredItemId
    )
    MonitoredItem

    Defined in packages\node-opcua-server\src\subscription.js:1296

    get a monitoredItem by Id.

    Parameters:

    • monitoredItemId Number

      the id of the monitored item to get.

    Returns:

    MonitoredItem:

    getMonitoredItems

    (
    • result.serverHandles
    )

    Defined in packages\node-opcua-server\src\subscription.js:1308

    getMonitoredItems is used to get information about monitored items of a subscription.Its intended use is defined in Part 4. This method is the implementation of the Standard OPCUA GetMonitoredItems Method.

    Parameters:

    • result.serverHandles Int32

      Array of serverHandles for all MonitoredItems of the subscription identified by subscriptionId. result.clientHandles {Int32[]} Array of clientHandles for all MonitoredItems of the subscription identified by subscriptionId. result.statusCode {StatusCode} from spec: This method can be used to get the list of monitored items in a subscription if CreateMonitoredItems failed due to a network interruption and the client does not know if the creation succeeded in the server.

    increaseKeepAliveCounter

    () private

    Defined in packages\node-opcua-server\src\subscription.js:675

    increaseLifeTimeCounter

    () private

    Defined in packages\node-opcua-server\src\subscription.js:710

    modify

    (
    • param
    )

    Defined in packages\node-opcua-server\src\subscription.js:300

    Parameters:

    • param Object
      • requestedPublishingInterval Duration

        requestedPublishingInterval =0 means fastest possible

      • requestedLifetimeCount Counter

        requestedLifetimeCount ===0 means no change

      • requestedMaxKeepAliveCount Counter

        requestedMaxKeepAliveCount ===0 means no change

      • maxNotificationsPerPublish Counter
      • priority Byte

    notificationHasExpired

    (
    • notification
    )
    Boolean

    Defined in packages\node-opcua-server\src\subscription.js:879

    returns true if the notification has expired

    Parameters:

    • notification Object

    Returns:

    Boolean:

    removeMonitoredItem

    (
    • monitoredItemId
    )

    Defined in packages\node-opcua-server\src\subscription.js:1362

    remove a monitored Item from the subscription.

    Parameters:

    • monitoredItemId Number

      the id of the monitored item to get.

    resetKeepAliveCounter

    () private

    Defined in packages\node-opcua-server\src\subscription.js:659

    resetLifeTimeAndKeepAliveCounters

    ()

    Defined in packages\node-opcua-server\src\subscription.js:746

    the server invokes the resetLifeTimeAndKeepAliveCounters method of the subscription when the server has send a Publish Response, so that the subscription can reset its life time counter.

    resetLifeTimeCounter

    () private

    Defined in packages\node-opcua-server\src\subscription.js:700

    Reset the Lifetime Counter Variable to the value specified for the lifetime of a Subscription in the CreateSubscription Service( 5.13.2).

    terminate Calling this method will also remove any monitored items.

    ()

    Defined in packages\node-opcua-server\src\subscription.js:761

    Terminates the subscription.

    Properties

    disabledMonitoredItemCount

    Number

    Defined in packages\node-opcua-server\src\subscription.js:1017

    number of disabled monitored items.

    hasMonitoredItemNotifications true if monitored Item have uncollected Notifications

    Boolean

    Defined in packages\node-opcua-server\src\subscription.js:1397

    hasPendingNotifications

    Boolean

    Defined in packages\node-opcua-server\src\subscription.js:988

    return True is there are pending notifications for this subscription. (i.e moreNotifications)

    keepAliveCounterHasExpired

    Boolean true if the keep alive counter has reach its limit. private

    Defined in packages\node-opcua-server\src\subscription.js:689

    lifeTimeCount

    Number

    Defined in packages\node-opcua-server\src\subscription.js:211

    The life time count defines how many times the publish interval expires without having a connection to the client to deliver data. If the life time count reaches maxKeepAliveCount, the subscription will automatically terminate. OPCUA Spec: The life-time count shall be a minimum of three times the keep keep-alive count.

    Note: this has to be interpreted as without having a PublishRequest available

    Default: 1

    lifeTimeHasExpired

    boolean - true if the subscription life time has expired.

    Defined in packages\node-opcua-server\src\subscription.js:719

    True if the subscription life time has expired.

    maxKeepAliveCount

    Number

    Defined in packages\node-opcua-server\src\subscription.js:197

    The keep alive count defines how many times the publish interval need to expires without having notifications available before the server send an empty message. OPCUA Spec says: a value of 0 is invalid.

    Default: 10

    maxNotificationsPerPublish

    Number #default 0

    Defined in packages\node-opcua-server\src\subscription.js:226

    The maximum number of notifications that the Client wishes to receive in a single Publish response. A value of zero indicates that there is no limit. The number of notifications per Publish is the sum of monitoredItems in the DataChangeNotification and events in the EventNotificationList.

    monitoredItemCount

    Number

    Defined in packages\node-opcua-server\src\subscription.js:1008

    number of monitored items.

    monitoredItemIdCounter

    Number

    Defined in packages\node-opcua-server\src\subscription.js:255

    number of monitored Item

    pendingNotificationsCount - number of pending notifications

    Number

    Defined in packages\node-opcua-server\src\subscription.js:979

    publishingInterval

    Number

    Defined in packages\node-opcua-server\src\subscription.js:189

    the Subscription publishing interval

    Default: 1000

    sentNotificationsCount

    Number

    Defined in packages\node-opcua-server\src\subscription.js:999

    number of sent notifications

    timeToExpiration

    Number

    Defined in packages\node-opcua-server\src\subscription.js:731

    number of milliseconds before this subscription times out (lifeTimeHasExpired === true);

    unacknowledgedMessageCount

    Number

    Defined in packages\node-opcua-server\src\subscription.js:1030

    The number of unacknowledged messages saved in the republish queue.

    Events

    "terminated"

    Defined in packages\node-opcua-server\src\subscription.js:797

    notify the subscription owner that the subscription has been terminated.

    expired

    Defined in packages\node-opcua-server\src\subscription.js:579

    notify the subscription owner that the subscription has expired by exceeding its life time.

    keepalive

    Defined in packages\node-opcua-server\src\subscription.js:645

    notify the subscription owner that a keepalive message has to be sent.

    removeMonitoredItem

    Defined in packages\node-opcua-server\src\subscription.js:1381

    notify that a monitored item has been removed from the subscription

    Event Payload: