Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface UAYArrayItem

Hierarchy

  • UAVariable
    • UAYArrayItem

Properties

accessLevel

accessLevel: number

The AccessLevel Attribute is used to indicate how the Value of a Variable can be accessed (read/write) and if it contains current and/or historic data.

The AccessLevel does not take any user access rights into account, i.e. although the Variable is writable this may be restricted to a certain user / user group.

The {{link:AccessLevelType}}

Readonly addressSpace

addressSpace: AddressSpace

arrayDimensions

arrayDimensions: UInt32[] | null

This Attribute specifies the length of each dimension for an array value.

  • The Attribute is intended to describe the capability of the Variable, not the current size.
  • The number of elements shall be equal to the value of the valueRank Attribute.
  • Shall be null if valueRank <=0.
  • A value of 0 for an individual dimension indicates that the dimension has a variable length.

example

For example, if a Variable is defined by the following javascript array with 346 Int32 elements:

const myArray = new Array(346).fill(0);

then:

  • DataType would point to an Int32

  • the Variable's valueRank has the value 1 and,

  • the arrayDimensions is an array with one entry having the value 346.

    {
    dataType: "Int32",
    valueRank: 1,
    arrayDimensions: [346]
    }

Note: the maximum length of an array transferred on the wire is 2147483647 (max Int32) and a multidimensional array is encoded as a one dimensional array.

axisScaleType

axisScaleType: UAVariableT<Int32, Int32>

Readonly browseName

browseName: QualifiedName

dataType

dataType: NodeId

Readonly dataTypeObj

dataTypeObj: UADataType

Readonly description

description: LocalizedText

Readonly displayName

displayName: LocalizedText[]

euRange

euRange: UAVariableT<Range, ExtensionObject>

historizing

historizing: boolean

The historizing attribute indicates whether the server is actively collecting data for the history of the variable.

This differs from the accessLevel Attribute which identifies if the variable has any historical data.

A value of true indicates that the server is actively collecting data.

A value of false indicates the server is not actively collecting data.

Default value is false.

instrumentRange

instrumentRange: UAVariable

minimumSamplingInterval

minimumSamplingInterval: number

The MinimumSamplingInterval Attribute indicates how 'current' the Value of the Variable will be kept.

It specifies (in milliseconds) how fast the Server can reasonably sample the value for changes (see Part 4 for a detailed description of sampling interval).

A MinimumSamplingInterval of 0 indicates that the Server is to monitor the item continuously.

A MinimumSamplingInterval of -1 means indeterminate.

Optional Readonly modellingRule

modellingRule: ModellingRuleType

Readonly namespace

namespace: Namespace

Readonly namespaceIndex

namespaceIndex: number

Readonly namespaceUri

namespaceUri: string

Readonly nodeClass

nodeClass: Variable

Readonly nodeId

nodeId: NodeId

Optional onFirstBrowseAction

onFirstBrowseAction: function

Type declaration

    • (this: BaseNode): Promise<void>
    • Parameters

      • this: BaseNode

      Returns Promise<void>

Readonly parent

parent: BaseNode | null

Optional Readonly parentNodeId

parentNodeId: NodeId

Readonly semantic_version

semantic_version: number

title

title: UAVariableT<LocalizedText, LocalizedText>

typeDefinition

typeDefinition: NodeId

typeDefinitionObj

typeDefinitionObj: UAVariableType

userAccessLevel

userAccessLevel: number

The UserAccessLevel Attribute is used to indicate how the Value of a Variable can be accessed (read/write) and if it contains current or historic data taking user access rights into account.

The AccessLevelType is defined in 8.57.

valueRank

valueRank: number

This Attribute indicates whether the Value Attribute of the Variable is an array and how many dimensions the array has. It may have the following values:

  • n > 1 : the Value is an array with the specified number of dimensions.

  • OneDimension (1): The value is an array with one dimension.

  • OneOrMoreDimensions (0): The value is an array with one or more dimensions.

  • Scalar (-1): The value is not an array.

  • Any (-2): The value can be a scalar or an array with any number of dimensions.

  • ScalarOrOneDimension (-3): The value can be a scalar or a one dimensional array.

    NOTE:

  • All DataTypes are considered to be scalar, even if they have array-like semantics like ByteString and String.

xAxisDefinition

xAxisDefinition: UAVariableT<AxisInformation, ExtensionObject>

Methods

addListener

  • addListener(event: string | symbol, listener: function): this
  • Parameters

    • event: string | symbol
    • listener: function
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

addReference

allReferences

asyncRefresh

bindExtensionObject

  • bindExtensionObject(optionalExtensionObject?: ExtensionObject): ExtensionObject | null
  • Parameters

    • Optional optionalExtensionObject: ExtensionObject

    Returns ExtensionObject | null

bindVariable

browseNode

  • browseNode(browseDescription: BrowseDescriptionOptions, session?: SessionContext): ReferenceDescription[]
  • browse the node to extract information requested in browseDescription

    method

    browseNode

    Parameters

    • browseDescription: BrowseDescriptionOptions
    • Optional session: SessionContext

    Returns ReferenceDescription[]

clone

  • clone(options?: any, optionalFilter?: any, extraInfo?: any): UAVariable
  • Parameters

    • Optional options: any
    • Optional optionalFilter: any
    • Optional extraInfo: any

    Returns UAVariable

emit

  • emit(event: string | symbol, ...args: any[]): boolean
  • Parameters

    • event: string | symbol
    • Rest ...args: any[]

    Returns boolean

eventNames

  • eventNames(): Array<string | symbol>
  • Returns Array<string | symbol>

findReference

  • findReference(strReference: string, isForward?: boolean): UAReference | null
  • Parameters

    • strReference: string
    • Optional isForward: boolean

    Returns UAReference | null

findReferences

  • findReferences(referenceType: string | NodeId | UAReferenceType, isForward?: boolean): UAReference[]
  • Parameters

    • referenceType: string | NodeId | UAReferenceType
    • Optional isForward: boolean

    Returns UAReference[]

findReferencesAsObject

  • findReferencesAsObject(strReference: string, isForward: boolean): BaseNode[]
  • Parameters

    • strReference: string
    • isForward: boolean

    Returns BaseNode[]

findReferencesEx

findReferencesExAsObject

  • findReferencesExAsObject(strReference: string, browseDirection?: BrowseDirection): BaseNode[]

fullName

  • fullName(): string
  • return a complete name of this object by pre-pending name of its parent(s) to its own name

    Returns string

getAggregates

  • getAggregates(): BaseNode[]
  • Returns BaseNode[]

getChildByName

  • getChildByName(browseName: string | QualifiedName): BaseNode | null
  • Parameters

    • browseName: string | QualifiedName

    Returns BaseNode | null

getComponentByName

  • getComponentByName(componentName: QualifiedNameLike, namespaceIndex?: number): UAObject | UAVariable | null

getComponents

  • getComponents(): BaseNode[]
  • Returns BaseNode[]

getEventSourceOfs

  • getEventSourceOfs(): BaseNode[]
  • return a array of the objects for which this node is an EventSource nodes = HasEventSource => self

    Returns BaseNode[]

getEventSources

  • getEventSources(): BaseNode[]
  • return a array with the event source of this object. self = HasEventSource => nodes

    Returns BaseNode[]

getMaxListeners

  • getMaxListeners(): number

getNotifiers

  • getNotifiers(): BaseNode[]
  • Returns BaseNode[]

getProperties

  • getProperties(): BaseNode[]
  • Returns BaseNode[]

getPropertyByName

  • getPropertyByName(browseName: string, namespaceIndex?: number): UAVariable | null
  • Parameters

    • browseName: string
    • Optional namespaceIndex: number

    Returns UAVariable | null

historyRead

install_extra_properties

  • install_extra_properties(): void

isEnumeration

  • isEnumeration(): boolean

isExtensionObject

  • isExtensionObject(): boolean

isReadable

  • returns true if the accessLevel flag allows the variable to be readable in the specified context.

    Parameters

    Returns boolean

isUserReadable

  • returns true if the userAccessLevel flag allows the variable to be readable in the specified context.

    Parameters

    Returns boolean

isUserWritable

  • returns true if the userAccessLevel flag allows the variable to be writeable in the specified context.

    Parameters

    Returns boolean

isWritable

  • returns true if the accessLevel flag allows the variable to be writeable in the specified context.

    Parameters

    Returns boolean

listenerCount

  • listenerCount(event: string | symbol): number
  • Parameters

    • event: string | symbol

    Returns number

listeners

  • listeners(event: string | symbol): Function[]
  • Parameters

    • event: string | symbol

    Returns Function[]

off

  • off(event: string | symbol, listener: function): this
  • Parameters

    • event: string | symbol
    • listener: function
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

on

  • on(eventName: "semantic_changed", eventHandler: function): this
  • on(eventName: "value_changed", eventHandler: function): this
  • Parameters

    • eventName: "semantic_changed"
    • eventHandler: function
        • (): void
        • Returns void

    Returns this

  • Parameters

    • eventName: "value_changed"
    • eventHandler: function
        • (dataValue: DataValue): void
        • Parameters

          • dataValue: DataValue

          Returns void

    Returns this

once

  • once(eventName: "semantic_changed", eventHandler: function): this
  • once(eventName: "value_changed", eventHandler: function): this
  • Parameters

    • eventName: "semantic_changed"
    • eventHandler: function
        • (): void
        • Returns void

    Returns this

  • Parameters

    • eventName: "value_changed"
    • eventHandler: function
        • (dataValue: DataValue): void
        • Parameters

          • dataValue: DataValue

          Returns void

    Returns this

prependListener

  • prependListener(event: string | symbol, listener: function): this
  • Parameters

    • event: string | symbol
    • listener: function
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

prependOnceListener

  • prependOnceListener(event: string | symbol, listener: function): this
  • Parameters

    • event: string | symbol
    • listener: function
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

propagate_back_references

  • propagate_back_references(): void
  • this methods propagates the forward references to the pointed node by inserting backward references to the counter part node

    Returns void

rawListeners

  • rawListeners(event: string | symbol): Function[]
  • Parameters

    • event: string | symbol

    Returns Function[]

readAttribute

readEnumValue

readValue

  • from OPC.UA.Spec 1.02 part 4 5.10.2.4 StatusCodes Table 51 defines values for the operation level statusCode contained in the DataValue structure of each values element. Common StatusCodes are defined in Table 166.

    Read Operation Level Result Codes

    Symbolic Id Description
    BadNodeIdInvalid The syntax of the node id is not valid.
    BadNodeIdUnknown The node id refers to a node that does not exist in the server address space.
    BadAttributeIdInvalid BadAttributeIdInvalid The attribute is not supported for the specified node.
    BadIndexRangeInvalid The syntax of the index range parameter is invalid.
    BadIndexRangeNoData No data exists within the range of indexes specified.
    BadDataEncodingInvalid The data encoding is invalid. This result is used if no dataEncoding can be applied because an Attribute other than Value was requested or the DataType of the Value Attribute is not a subtype of the Structure DataType.
    BadDataEncodingUnsupported The server does not support the requested data encoding for the node. This result is used if a dataEncoding can be applied but the passed data encoding is not known to the Server.
    BadNotReadable The access level does not allow reading or subscribing to the Node.
    BadUserAccessDenied User does not have permission to perform the requested operation. (table 165)

    Parameters

    Returns DataValue

readValueAsync

removeAllListeners

  • removeAllListeners(event?: string | symbol): this

removeListener

  • removeListener(event: string | symbol, listener: function): this
  • Parameters

    • event: string | symbol
    • listener: function
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

removeReference

setMaxListeners

  • setMaxListeners(n: number): this

setPermissions

setValueFromSource

  • setValueFromSource(value: VariantLike, statusCode?: StatusCode, sourceTimestamp?: Date): void

touchValue

  • touchValue(updateNow?: PreciseClock): void
  • Parameters

    • Optional updateNow: PreciseClock

    Returns void

writeAttribute

  • write a variable attribute (callback version)

    Parameters

    • context: SessionContext
    • writeValue: WriteValueOptions
    • callback: StatusCodeCallback

      example

        const writeValue = {
           attributeId: AttributeIds.Value,
           dataValue: new DataValue({
               statusCode: StatusCodes.Good,
               sourceTimestamp: new Date(),
               value: new Variant({ dataType: DataType.Double, value: 3.14 })
           }),
           nodeId
        };
      myVariable.writeAttribute(context,writeValue,(err, statusCode) => {
         if (err) { console.log("Write has failed"); return; }
         console.log("write statusCode = ",statusCode.toString());
      });

    Returns void

  • write a variable attribute (async/await version)

    Parameters

    • context: SessionContext
    • writeValue: WriteValueOptions

      example

      try {
         const writeValue = {
            attributeId: AttributeIds.Value,
            dataValue: new DataValue({
                statusCode: StatusCodes.Good,
                sourceTimestamp: new Date(),
                value: new Variant({ dataType: DataType.Double, value: 3.14 })
            }),
            nodeId
         };
         const statusCode = await myVariable.writeAttribute(context,writeValue);
      } catch(err) {
        console.log("Write has failed");
        return;
      }
      console.log("write statusCode = ", statusCode.toString());

    Returns Promise<StatusCode>

writeEnumValue

  • writeEnumValue(value: string | number): void
  • precondition

    UAVariable must have a dataType deriving from "Enumeration"

    Parameters

    • value: string | number

    Returns void

writeValue

Generated using TypeDoc