NodeOPCUA API Documentation
    Preparing search index...

    Interface InstantiateOffNormalAlarmOptions

    interface InstantiateOffNormalAlarmOptions {
        addInOf?: NodeId | BaseNode<BaseNodeEvents>;
        browseName: QualifiedNameLike;
        componentOf?: NodeIdLike | BaseNode<BaseNodeEvents>;
        conditionClass?:
            | NodeId
            | BaseNode<BaseNodeEvents>
            | UAObject<UAObjectEvents>
            | null;
        conditionName?: string;
        conditionOf?:
            | NodeId
            | BaseNode<BaseNodeEvents>
            | UAObject<UAObjectEvents>
            | null;
        conditionSource?: NodeId | BaseNode<BaseNodeEvents> | null;
        copyAlsoAllOptionals?: boolean;
        copyAlsoModellingRules?: boolean;
        description?: LocalizedTextLike;
        displayName?: LocalizedTextLike | null;
        encodingOf?: NodeId | BaseNode<BaseNodeEvents>;
        eventNotifier?: EventNotifierFlags;
        eventSourceOf?: NodeIdLike | BaseNode<BaseNodeEvents>;
        inputNode: NodeId | UAVariable<UAVariableEvents>;
        maxTimeShelved?: number;
        modellingRule?: ModellingRuleType;
        namespace?: INamespace;
        nodeId?: NodeIdLike;
        normalState?: NodeIdLike | UAVariable<UAVariableEvents> | null;
        notifierOf?: NodeIdLike | BaseNode<BaseNodeEvents>;
        optionals?: string[];
        organizedBy?: NodeIdLike | BaseNode<BaseNodeEvents>;
        parentNodeId?: NodeIdLike | BaseNode<BaseNodeEvents>;
        references?: AddReferenceOpts[];
    }

    Hierarchy (View Summary)

    Index

    note

    • when addInOf is specified, organizedBy nor componentOf must not be defined
    browseName: QualifiedNameLike

    the browse name of the new node to instantiate

    the parent Object holding this object note

    • when componentOf is specified, organizedBy nor addInOf must not be defined
    conditionClass?:
        | NodeId
        | BaseNode<BaseNodeEvents>
        | UAObject<UAObjectEvents>
        | null
    conditionName?: string
    conditionOf?:
        | NodeId
        | BaseNode<BaseNodeEvents>
        | UAObject<UAObjectEvents>
        | null
    conditionSource?: NodeId | BaseNode<BaseNodeEvents> | null
    copyAlsoAllOptionals?: boolean
    copyAlsoModellingRules?: boolean

    shall we also replicate the HasModelling rule reference ?

    description?: LocalizedTextLike

    an optional description

    if not provided the default description of the corresponding Type will be used.

    displayName?: LocalizedTextLike | null

    an optional displayName

    if not provided the default description of the corresponding browseName will be used.

    eventNotifier?: EventNotifierFlags
    maxTimeShelved?: number
    modellingRule?: ModellingRuleType

    modellingRule

    namespace?: INamespace

    the namespace in which the node shall be instantiated (if not specified, the default instance namespace (own namespace) of the addressSpace will be used)

    nodeId?: NodeIdLike

    a (optional) predefined nodeId to assigned to the instance If not specified, a default nodeid will be created.

    normalState?: NodeIdLike | UAVariable<UAVariableEvents> | null

    https://reference.opcfoundation.org/v105/Core/docs/Part9/5.8.23/#5.8.23.2

    The NormalState Property is a Property that points to a Variable which has a value that corresponds to one of the possible values of the Variable pointed to by the InputNode Property where the NormalState Property Variable value is the value that is considered to be the normal state of the Variable pointed to by the InputNode Property.

    When the value of the Variable referenced by the InputNode Property is not equal to the value of the NormalState Property the Alarm is Active. If this Variable is not in the AddressSpace, a NULL NodeId shall be provided.

    optionals?: string[]

    a list of components and properties names that have a HasModellingRule of Optional in the type definition that we want to instantiate. Note:

    • the name must follow the OPCUA naming convention and match the browse name of the property (same case)
    • the name can be composed to represent a path to a property or component
      optionals: ["MyOptionalVariable", "MyOptionalMethod", "MyOptionalComponent.MyProperty"];
    

    @default: []

    the parent Folder holding this object

    note

    • when organizedBy is specified, componentOf nor addInOf must not be defined

    the declared parent, as ParentNodeId in a NodeSet: the instance's parent and what its symbolic name is built from, even when the only reference between the two is Organizes (a folder a type organizes is <Type>_<Folder> in the ModelCompiler's NodeIds.csv). See AddBaseNodeOptions.parentNodeId.

    references?: AddReferenceOpts[]

    additional references to create on the new node at construction time.

    Use it to link the instance to a parent through an aggregate reference that has no dedicated option (HasOrderedComponent, HasPhysicalComponent, HasContainedComponent, HasAttachedComponent ...):

      references: [{ referenceType: "HasOrderedComponent", isForward: false, nodeId: listNode }]
    

    Because the reference exists when the node is created, the NodeIdManager derives the symbolic name from that parent (List_First), exactly as it does for componentOf; adding the reference afterwards would leave the node named without its parent. Such a parent also counts when deciding whether modelling rules are copied (an instance declared inside a type).