node-opcua-service-filter 2.51.0

package/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2021 Etienne Rossignon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/imports.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @module node-opcua-service-filter
+ */
+export { FilterOperator, AttributeOperand, ElementOperand, FilterOperand, LiteralOperand, SimpleAttributeOperand, MonitoringFilter, ContentFilterElement, ContentFilter, EventFilter, DataChangeFilter, AttributeOperandOptions, ElementOperandOptions, FilterOperandOptions, LiteralOperandOptions, SimpleAttributeOperandOptions, MonitoringFilterOptions, ContentFilterElementOptions, ContentFilterOptions, EventFilterOptions } from "node-opcua-types";

package/dist/imports.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataChangeFilter = exports.EventFilter = exports.ContentFilter = exports.ContentFilterElement = exports.MonitoringFilter = exports.SimpleAttributeOperand = exports.LiteralOperand = exports.FilterOperand = exports.ElementOperand = exports.AttributeOperand = exports.FilterOperator = void 0;
+/**
+ * @module node-opcua-service-filter
+ */
+var node_opcua_types_1 = require("node-opcua-types");
+Object.defineProperty(exports, "FilterOperator", { enumerable: true, get: function () { return node_opcua_types_1.FilterOperator; } });
+Object.defineProperty(exports, "AttributeOperand", { enumerable: true, get: function () { return node_opcua_types_1.AttributeOperand; } });
+Object.defineProperty(exports, "ElementOperand", { enumerable: true, get: function () { return node_opcua_types_1.ElementOperand; } });
+Object.defineProperty(exports, "FilterOperand", { enumerable: true, get: function () { return node_opcua_types_1.FilterOperand; } });
+Object.defineProperty(exports, "LiteralOperand", { enumerable: true, get: function () { return node_opcua_types_1.LiteralOperand; } });
+Object.defineProperty(exports, "SimpleAttributeOperand", { enumerable: true, get: function () { return node_opcua_types_1.SimpleAttributeOperand; } });
+Object.defineProperty(exports, "MonitoringFilter", { enumerable: true, get: function () { return node_opcua_types_1.MonitoringFilter; } });
+Object.defineProperty(exports, "ContentFilterElement", { enumerable: true, get: function () { return node_opcua_types_1.ContentFilterElement; } });
+Object.defineProperty(exports, "ContentFilter", { enumerable: true, get: function () { return node_opcua_types_1.ContentFilter; } });
+Object.defineProperty(exports, "EventFilter", { enumerable: true, get: function () { return node_opcua_types_1.EventFilter; } });
+Object.defineProperty(exports, "DataChangeFilter", { enumerable: true, get: function () { return node_opcua_types_1.DataChangeFilter; } });
+//# sourceMappingURL=imports.js.map

package/dist/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../source/imports.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,qDA6B0B;AA3BtB,kHAAA,cAAc,OAAA;AAEd,oHAAA,gBAAgB,OAAA;AAChB,kHAAA,cAAc,OAAA;AACd,iHAAA,aAAa,OAAA;AACb,kHAAA,cAAc,OAAA;AACd,0HAAA,sBAAsB,OAAA;AAEtB,oHAAA,gBAAgB,OAAA;AAEhB,wHAAA,oBAAoB,OAAA;AACpB,iHAAA,aAAa,OAAA;AACb,+GAAA,WAAW,OAAA;AACX,oHAAA,gBAAgB,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @module node-opcua-service-filter
+ */
+export * from "./imports";
+export * from "./tools_event_filter";

package/dist/index.js

@@ -0,0 +1,50 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module node-opcua-service-filter
+ */
+__exportStar(require("./imports"), exports);
+__exportStar(require("./tools_event_filter"), exports);
+// The SimpleAttributeOperand is a simplified form of the AttributeOperand and all of the rules that
+// apply to the AttributeOperand also apply to the SimpleAttributeOperand. The examples provided in
+// B.1 only use AttributeOperand, however, the AttributeOperand can be replaced by a
+// SimpleAttributeOperand whenever all ReferenceTypes in the RelativePath are subtypes of
+// HierarchicalReferences and the targets are Object or Variable Nodes and an Alias is not required
+// typeDefinitionId
+// This parameter restricts the operand to instances of the TypeDefinitionNode or
+// one of its subtypes.
+// { name: "typeDefinitionId", fieldType:"NodeId",documentation:"NodeId of a TypeDefinitionNode."},
+// browsePath
+// A relative path to a Node.
+// This parameter specifies a relative path using a list of BrowseNames instead of
+// the RelativePath structure used in the AttributeOperand. The list of
+// BrowseNames is equivalent to a RelativePath that specifies forward references
+// which are subtypes of the HierarchicalReferences ReferenceType.
+// All Nodes followed by the browsePath shall be of the NodeClass Object or
+// Variable.
+// If this list is empty the Node is the instance of the TypeDefinition.
+//  { name: "browsePath", isArray:true, fieldType:"QualifiedName"},
+// Id of the Attribute. The IntegerId is defined in 7.13.
+// The Value Attribute shall be supported by all Servers. The support of other
+// Attributes depends on requirements set in Profiles or other parts of this
+// specification.
+// { name: "attributeId", fieldType:"IntegerId"},
+// This parameter is used to identify a single element of an array, or a single range
+// of indexes for an array. The first element is identified by index 0 (zero).
+// This parameter is ignored if the selected Node is not a Variable or the Value of a
+// Variable is not an array.
+// The parameter is null if not specified.
+// All values in the array are used if this parameter is not specified.
+// The NumericRange type is defined in 7.21.
+// { name: "indexRange", fieldType:"NumericRange"}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA;;GAEG;AACH,4CAA0B;AAC1B,uDAAqC;AAErC,oGAAoG;AACpG,mGAAmG;AACnG,oFAAoF;AACpF,yFAAyF;AACzF,mGAAmG;AAEnG,mBAAmB;AACnB,iFAAiF;AACjF,uBAAuB;AACvB,mGAAmG;AAEnG,aAAa;AACb,6BAA6B;AAC7B,kFAAkF;AAClF,uEAAuE;AACvE,gFAAgF;AAChF,kEAAkE;AAClE,2EAA2E;AAC3E,YAAY;AACZ,wEAAwE;AACxE,mEAAmE;AAEnE,yDAAyD;AACzD,8EAA8E;AAC9E,4EAA4E;AAC5E,iBAAiB;AACjB,iDAAiD;AAEjD,qFAAqF;AACrF,8EAA8E;AAC9E,qFAAqF;AACrF,4BAA4B;AAC5B,0CAA0C;AAC1C,uEAAuE;AACvE,4CAA4C;AAC5C,kDAAkD"}

package/dist/tools_event_filter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module node-opcua-service-filter
+ */
+import { NodeId } from "node-opcua-nodeid";
+import { EventFilter, SimpleAttributeOperand } from "./imports";
+/**
+ * helper to construct event filters:
+ * construct a simple event filter
+ *
+ *
+ * @example
+ *
+ *     constructEventFilter(["SourceName","Message","ReceiveTime"]);
+ *
+ *     constructEventFilter(["SourceName",{namespaceIndex:2 , "MyData"}]);
+ *     constructEventFilter(["SourceName","2:MyData" ]);
+ *
+ *     constructEventFilter(["SourceName" ,["EnabledState","EffectiveDisplayName"] ]);
+ *     constructEventFilter(["SourceName" ,"EnabledState.EffectiveDisplayName" ]);
+ *
+ */
+export declare function constructEventFilter(arrayOfNames: string[] | string, conditionTypes?: NodeId[] | NodeId): EventFilter;
+/**
+ * @class SimpleAttributeOperand
+ * @method toShortString
+ * @return {String}
+ *
+ * @example:
+ *
+ *
+ */
+export declare function simpleAttributeOperandToShortString(self: SimpleAttributeOperand, addressSpace: any): string;

package/dist/tools_event_filter.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * @module node-opcua-service-filter
+ */
+// tslint:disable:object-literal-shorthand
+// tslint:disable:only-arrow-functions
+// tslint:disable:max-line-length
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simpleAttributeOperandToShortString = exports.constructEventFilter = void 0;
+const node_opcua_constants_1 = require("node-opcua-constants");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_debug_1 = require("node-opcua-debug");
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+const imports_1 = require("./imports");
+const debugLog = (0, node_opcua_debug_1.make_debugLog)(__filename);
+const doDebug = (0, node_opcua_debug_1.checkDebugFlag)(__filename);
+/**
+ * helper to construct event filters:
+ * construct a simple event filter
+ *
+ *
+ * @example
+ *
+ *     constructEventFilter(["SourceName","Message","ReceiveTime"]);
+ *
+ *     constructEventFilter(["SourceName",{namespaceIndex:2 , "MyData"}]);
+ *     constructEventFilter(["SourceName","2:MyData" ]);
+ *
+ *     constructEventFilter(["SourceName" ,["EnabledState","EffectiveDisplayName"] ]);
+ *     constructEventFilter(["SourceName" ,"EnabledState.EffectiveDisplayName" ]);
+ *
+ */
+function constructEventFilter(arrayOfNames, conditionTypes) {
+    if (!Array.isArray(arrayOfNames)) {
+        return constructEventFilter([arrayOfNames], conditionTypes);
+    }
+    if (conditionTypes && !Array.isArray(conditionTypes)) {
+        return constructEventFilter(arrayOfNames, [conditionTypes]);
+    }
+    // istanbul ignore next
+    if (!(arrayOfNames instanceof Array)) {
+        throw new Error("internal error");
+    }
+    // replace "string" element in the form A.B.C into [ "A","B","C"]
+    const arrayOfNames2 = arrayOfNames.map((path) => {
+        if (typeof path !== "string") {
+            return path;
+        }
+        return path.split(".");
+    });
+    const arrayOfNames3 = arrayOfNames2.map((path) => {
+        if (Array.isArray(path)) {
+            return path.map(node_opcua_data_model_1.stringToQualifiedName);
+        }
+        return path;
+    });
+    // replace "string" elements in arrayOfName with QualifiedName in namespace 0
+    const arrayOfNames4 = arrayOfNames3.map((s) => {
+        return typeof s === "string" ? (0, node_opcua_data_model_1.stringToQualifiedName)(s) : s;
+    });
+    // construct browse paths array
+    const browsePaths = arrayOfNames4.map((s) => {
+        return Array.isArray(s) ? s : [s];
+    });
+    // Part 4 page 127:
+    // In some cases the same BrowsePath will apply to multiple EventTypes. If the Client specifies the BaseEventType
+    // in the SimpleAttributeOperand then the Server shall evaluate the BrowsePath without considering the Type.
+    // [..]
+    // The SimpleAttributeOperand structure allows the Client to specify any Attribute, however, the Server is only
+    // required to support the Value Attribute for Variable Nodes and the NodeId Attribute for Object Nodes.
+    // That said, profiles defined in Part 7 may make support for additional Attributes mandatory.
+    let selectClauses = browsePaths.map((browsePath) => {
+        return new imports_1.SimpleAttributeOperand({
+            attributeId: node_opcua_data_model_1.AttributeIds.Value,
+            browsePath,
+            indexRange: undefined,
+            typeDefinitionId: (0, node_opcua_nodeid_1.makeNodeId)(node_opcua_constants_1.ObjectTypeIds.BaseEventType) // i=2041
+        });
+    });
+    if (conditionTypes && conditionTypes instanceof Array) {
+        const extraSelectClauses = conditionTypes.map((nodeId) => {
+            return new imports_1.SimpleAttributeOperand({
+                attributeId: node_opcua_data_model_1.AttributeIds.NodeId,
+                browsePath: undefined,
+                indexRange: undefined,
+                typeDefinitionId: nodeId // conditionType for instance
+            });
+        });
+        selectClauses = selectClauses.concat(extraSelectClauses);
+    }
+    const filter = new imports_1.EventFilter({
+        selectClauses: selectClauses,
+        whereClause: {
+            // ContentFilter
+            elements: [
+            // ContentFilterElement
+            // {
+            //    filterOperator: FilterOperator.IsNull,
+            //    filterOperands: [ //
+            //        new ElementOperand({
+            //            index: 123
+            //        }),
+            //        new AttributeOperand({
+            //            nodeId: "i=10",
+            //            alias: "someText",
+            //            browsePath: { //RelativePath
+            //
+            //            },
+            //            attributeId: AttributeIds.Value
+            //        })
+            //    ]
+            // }
+            ]
+        }
+    });
+    return filter;
+}
+exports.constructEventFilter = constructEventFilter;
+/**
+ * @class SimpleAttributeOperand
+ * @method toPath
+ * @return {String}
+ *
+ * @example:
+ *
+ *
+ */
+function simpleAttributeOperandToPath(self) {
+    if (!self.browsePath) {
+        return "";
+    }
+    return self.browsePath
+        .map((a) => {
+        return a.name;
+    })
+        .join("/");
+}
+/**
+ * @class SimpleAttributeOperand
+ * @method toShortString
+ * @return {String}
+ *
+ * @example:
+ *
+ *
+ */
+function simpleAttributeOperandToShortString(self, addressSpace // Address Space
+) {
+    let str = "";
+    if (addressSpace) {
+        const n = addressSpace.findNode(self.typeDefinitionId);
+        str += n.BrowseName.toString();
+    }
+    str += "[" + self.typeDefinitionId.toString() + "]" + simpleAttributeOperandToPath(self);
+    return str;
+}
+exports.simpleAttributeOperandToShortString = simpleAttributeOperandToShortString;
+//# sourceMappingURL=tools_event_filter.js.map

package/dist/tools_event_filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools_event_filter.js","sourceRoot":"","sources":["../source/tools_event_filter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "node-opcua-service-filter",
+    "version": "2.51.0",
+    "description": "pure nodejs OPCUA SDK - module -service-filter",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "scripts": {
+        "test": "mocha",
+        "clean": "node -e \"require('rimraf').sync('dist');\"",
+        "build": "tsc -b"
+    },
+    "dependencies": {
+        "node-opcua-assert": "2.51.0",
+        "node-opcua-basic-types": "2.51.0",
+        "node-opcua-binary-stream": "2.51.0",
+        "node-opcua-constants": "2.51.0",
+        "node-opcua-data-model": "2.51.0",
+        "node-opcua-debug": "2.51.0",
+        "node-opcua-factory": "2.51.0",
+        "node-opcua-nodeid": "2.51.0",
+        "node-opcua-numeric-range": "2.51.0",
+        "node-opcua-service-translate-browse-path": "2.51.0",
+        "node-opcua-status-code": "2.51.0",
+        "node-opcua-types": "2.51.0",
+        "node-opcua-variant": "2.51.0"
+    },
+    "devDependencies": {
+        "node-opcua-service-secure-channel": "2.51.0",
+        "should": "^13.2.3"
+    },
+    "author": "Etienne Rossignon",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git://github.com/node-opcua/node-opcua.git"
+    },
+    "keywords": [
+        "OPCUA",
+        "opcua",
+        "m2m",
+        "iot",
+        "opc ua",
+        "internet of things"
+    ],
+    "homepage": "http://node-opcua.github.io/",
+    "gitHead": "75feb111daf7ec65fa0111e4fa5beb8987fd4945"
+}

package/source/imports.ts

@@ -0,0 +1,33 @@
+/**
+ * @module node-opcua-service-filter
+ */
+export  {
+
+    FilterOperator,
+
+    AttributeOperand,
+    ElementOperand,
+    FilterOperand,
+    LiteralOperand,
+    SimpleAttributeOperand,
+
+    MonitoringFilter,
+
+    ContentFilterElement,
+    ContentFilter,
+    EventFilter,
+    DataChangeFilter,
+
+    AttributeOperandOptions,
+    ElementOperandOptions,
+    FilterOperandOptions,
+    LiteralOperandOptions,
+    SimpleAttributeOperandOptions,
+
+    MonitoringFilterOptions,
+
+    ContentFilterElementOptions,
+    ContentFilterOptions,
+    EventFilterOptions
+
+} from "node-opcua-types";

package/source/index.ts

@@ -0,0 +1,42 @@
+/**
+ * @module node-opcua-service-filter
+ */
+export * from "./imports";
+export * from "./tools_event_filter";
+
+// The SimpleAttributeOperand is a simplified form of the AttributeOperand and all of the rules that
+// apply to the AttributeOperand also apply to the SimpleAttributeOperand. The examples provided in
+// B.1 only use AttributeOperand, however, the AttributeOperand can be replaced by a
+// SimpleAttributeOperand whenever all ReferenceTypes in the RelativePath are subtypes of
+// HierarchicalReferences and the targets are Object or Variable Nodes and an Alias is not required
+
+// typeDefinitionId
+// This parameter restricts the operand to instances of the TypeDefinitionNode or
+// one of its subtypes.
+// { name: "typeDefinitionId", fieldType:"NodeId",documentation:"NodeId of a TypeDefinitionNode."},
+
+// browsePath
+// A relative path to a Node.
+// This parameter specifies a relative path using a list of BrowseNames instead of
+// the RelativePath structure used in the AttributeOperand. The list of
+// BrowseNames is equivalent to a RelativePath that specifies forward references
+// which are subtypes of the HierarchicalReferences ReferenceType.
+// All Nodes followed by the browsePath shall be of the NodeClass Object or
+// Variable.
+// If this list is empty the Node is the instance of the TypeDefinition.
+//  { name: "browsePath", isArray:true, fieldType:"QualifiedName"},
+
+// Id of the Attribute. The IntegerId is defined in 7.13.
+// The Value Attribute shall be supported by all Servers. The support of other
+// Attributes depends on requirements set in Profiles or other parts of this
+// specification.
+// { name: "attributeId", fieldType:"IntegerId"},
+
+// This parameter is used to identify a single element of an array, or a single range
+// of indexes for an array. The first element is identified by index 0 (zero).
+// This parameter is ignored if the selected Node is not a Variable or the Value of a
+// Variable is not an array.
+// The parameter is null if not specified.
+// All values in the array are used if this parameter is not specified.
+// The NumericRange type is defined in 7.21.
+// { name: "indexRange", fieldType:"NumericRange"}

package/source/tools_event_filter.ts

@@ -0,0 +1,169 @@
+/**
+ * @module node-opcua-service-filter
+ */
+// tslint:disable:object-literal-shorthand
+// tslint:disable:only-arrow-functions
+// tslint:disable:max-line-length
+
+import { assert } from "node-opcua-assert";
+import { ObjectTypeIds } from "node-opcua-constants";
+import { AttributeIds, stringToQualifiedName } from "node-opcua-data-model";
+import { checkDebugFlag, make_debugLog } from "node-opcua-debug";
+import { makeNodeId, NodeId, resolveNodeId, sameNodeId } from "node-opcua-nodeid";
+import { DataType, Variant } from "node-opcua-variant";
+
+import { EventFilter, SimpleAttributeOperand } from "./imports";
+
+const debugLog = make_debugLog(__filename);
+const doDebug = checkDebugFlag(__filename);
+
+/**
+ * helper to construct event filters:
+ * construct a simple event filter
+ *
+ *
+ * @example
+ *
+ *     constructEventFilter(["SourceName","Message","ReceiveTime"]);
+ *
+ *     constructEventFilter(["SourceName",{namespaceIndex:2 , "MyData"}]);
+ *     constructEventFilter(["SourceName","2:MyData" ]);
+ *
+ *     constructEventFilter(["SourceName" ,["EnabledState","EffectiveDisplayName"] ]);
+ *     constructEventFilter(["SourceName" ,"EnabledState.EffectiveDisplayName" ]);
+ *
+ */
+export function constructEventFilter(arrayOfNames: string[] | string, conditionTypes?: NodeId[] | NodeId): EventFilter {
+    if (!Array.isArray(arrayOfNames)) {
+        return constructEventFilter([arrayOfNames], conditionTypes);
+    }
+    if (conditionTypes && !Array.isArray(conditionTypes)) {
+        return constructEventFilter(arrayOfNames, [conditionTypes]);
+    }
+    // istanbul ignore next
+    if (!(arrayOfNames instanceof Array)) {
+        throw new Error("internal error");
+    }
+    // replace "string" element in the form A.B.C into [ "A","B","C"]
+    const arrayOfNames2 = arrayOfNames.map((path) => {
+        if (typeof path !== "string") {
+            return path;
+        }
+        return path.split(".");
+    });
+
+    const arrayOfNames3 = arrayOfNames2.map((path) => {
+        if (Array.isArray(path)) {
+            return path.map(stringToQualifiedName);
+        }
+        return path;
+    });
+    // replace "string" elements in arrayOfName with QualifiedName in namespace 0
+    const arrayOfNames4 = arrayOfNames3.map((s) => {
+        return typeof s === "string" ? stringToQualifiedName(s) : s;
+    });
+
+    // construct browse paths array
+    const browsePaths = arrayOfNames4.map((s) => {
+        return Array.isArray(s) ? s : [s];
+    });
+
+    // Part 4 page 127:
+    // In some cases the same BrowsePath will apply to multiple EventTypes. If the Client specifies the BaseEventType
+    // in the SimpleAttributeOperand then the Server shall evaluate the BrowsePath without considering the Type.
+
+    // [..]
+    // The SimpleAttributeOperand structure allows the Client to specify any Attribute, however, the Server is only
+    // required to support the Value Attribute for Variable Nodes and the NodeId Attribute for Object Nodes.
+    // That said, profiles defined in Part 7 may make support for additional Attributes mandatory.
+    let selectClauses = browsePaths.map((browsePath) => {
+        return new SimpleAttributeOperand({
+            attributeId: AttributeIds.Value,
+            browsePath,
+            indexRange: undefined, //  NumericRange
+            typeDefinitionId: makeNodeId(ObjectTypeIds.BaseEventType) // i=2041
+        });
+    });
+
+    if (conditionTypes && conditionTypes instanceof Array) {
+        const extraSelectClauses = conditionTypes.map((nodeId) => {
+            return new SimpleAttributeOperand({
+                attributeId: AttributeIds.NodeId,
+                browsePath: undefined,
+                indexRange: undefined, //  NumericRange
+                typeDefinitionId: nodeId // conditionType for instance
+            });
+        });
+        selectClauses = selectClauses.concat(extraSelectClauses);
+    }
+
+    const filter = new EventFilter({
+        selectClauses: selectClauses,
+
+        whereClause: {
+            // ContentFilter
+            elements: [
+                // ContentFilterElement
+                // {
+                //    filterOperator: FilterOperator.IsNull,
+                //    filterOperands: [ //
+                //        new ElementOperand({
+                //            index: 123
+                //        }),
+                //        new AttributeOperand({
+                //            nodeId: "i=10",
+                //            alias: "someText",
+                //            browsePath: { //RelativePath
+                //
+                //            },
+                //            attributeId: AttributeIds.Value
+                //        })
+                //    ]
+                // }
+            ]
+        }
+    });
+    return filter;
+}
+
+/**
+ * @class SimpleAttributeOperand
+ * @method toPath
+ * @return {String}
+ *
+ * @example:
+ *
+ *
+ */
+function simpleAttributeOperandToPath(self: SimpleAttributeOperand): string {
+    if (!self.browsePath) {
+        return "";
+    }
+    return self.browsePath
+        .map((a) => {
+            return a.name;
+        })
+        .join("/");
+}
+
+/**
+ * @class SimpleAttributeOperand
+ * @method toShortString
+ * @return {String}
+ *
+ * @example:
+ *
+ *
+ */
+export function simpleAttributeOperandToShortString(
+    self: SimpleAttributeOperand,
+    addressSpace: any // Address Space
+): string {
+    let str = "";
+    if (addressSpace) {
+        const n = addressSpace.findNode(self.typeDefinitionId)!;
+        str += n.BrowseName.toString();
+    }
+    str += "[" + self.typeDefinitionId.toString() + "]" + simpleAttributeOperandToPath(self);
+    return str;
+}