node-red-contrib-mobius-flow-base 2.5.86-beta.1 → 2.5.86-beta.101

package/dist/nodes/mobius-discover-object-list.html

@@ -0,0 +1,272 @@
+<!--
+Copyright (C) 2016, IAConnects Technology Limited
+All Rights Reserved
+
+ALL INFORMATION CONTAINED HEREIN IS, AND REMAINS
+THE PROPERTY OF IACONNECTS TECHNOLOGY LIMITED AND ITS SUPPLIERS,
+IF ANY. THE INTELLECTUAL AND TECHNICAL CONCEPTS CONTAINED
+HEREIN ARE PROPRIETARY TO IACONNECTS TECHNOLOGY LIMITED
+AND ITS SUPPLIERS AND ARE PROTECTED BY TRADE SECRET OR COPYRIGHT LAW.
+DISSEMINATION OF THIS INFORMATION OR REPRODUCTION OF THIS MATERIAL
+IS STRICTLY FORBIDDEN UNLESS PRIOR WRITTEN PERMISSION IS OBTAINED
+FROM IACONNECTS TECHNOLOGY LIMITED.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+-->
+
+<script type="text/x-red" data-template-name="mobius discover object list">
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+    <input type="text" id="node-input-name" placeholder="Name">
+  </div>
+  <hr>
+  <div class="form-row">
+    <label for="node-input-connection"><i class="fa fa-globe"></i> MOBiUS</label>
+    <input type="text" id="node-input-connection">
+  </div>
+  <div class="form-row">
+    <label for="node-input-hid"><i class="fa fa-tasks"></i> HID</label>
+    <input type="text" id="node-input-hid" placeholder="">
+  </div>
+  <hr>
+  <div class="form-row">
+    <label for="node-input-output"><i class="fa fa-sign-out"></i> Output</label>
+    <select type="text" id="node-input-output" style="display: inline-block; width: auto; vertical-align: center;">
+      <option value="objects">MOBiUS Objects</option>
+      <option value="uris">MOBiUS Object URIs</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label for="node-input-send"><i class="fa fa-ellipsis-h"></i> Send</label>
+    <select type="text" id="node-input-send" style="display: inline-block; width: auto; vertical-align: center;">
+      <option value="individual">Individual Items</option>
+      <option value="array">Array of Items</option>
+    </select>
+  </div>
+  <div class="form-row node-input-subs-container-row">
+    <label for="node-input-subs-container" style="width:105px;float:left;"><i class="fa fa-bars"></i> Discover</label>
+      <ol id="node-input-subs-container"></ol>
+  </div>
+  <div class="form-row">
+    <label for="node-input-useRIDValueFiltering" style="width:178px;float:left;"><i class="fa fa-filter"></i> Filter by Resource Value</label>
+    <input type="checkbox" id="node-input-useRIDValueFiltering" style="display: inline-block; width: auto; vertical-align: top;">
+  </div>
+  <div id="use-rid-filter-row" class="form-row hidden">
+    <div class="form-row">
+      <label for="node-input-rid"><i class="fa fa-tag"></i> RID</label>
+      <input type="text" id="node-input-rid" placeholder="Resource to test">
+    </div>
+    <div class="form-row">
+      <label for="node-input-limit"><i class="fa fa-arrow-up"></i> Limit</label>
+      <input type="text" id="node-input-limit" placeholder="Maximum number of objects to return">
+    </div>
+    <div class="form-row">
+      <label for="node-input-func-editor" style="width:105px;float:left;"><i class="fa fa-list-alt"></i> Function</label>
+      <div style="height: 150px; min-height:80px;" class="node-text-editor" id="node-input-func-editor"></div>
+    </div>
+  </div>
+</script>
+
+<script type="text/javascript">
+  RED.nodes.registerType('mobius discover object list', {
+    category: 'mobius',
+    defaults: {
+      name: {value:""},
+      useRIDValueFiltering: {value: false},
+      func: {value:""},
+      limit: {value:100, validate:RED.validators.number()},
+      rid: {value: "", validate:function(v) {
+        if(v === '') { return true; }
+        if(v.length === 2) { return true; }
+        return false;
+      }},
+      output: {value: "objects", required: true},
+      send: {value: "individual", required: true},
+      subscriptions: {value:[{uri: '', type: 'include'}]},
+      hid: {value: "", validate:function(v) {
+        if(v === '') { return true; }
+        if(v.length === 6) { return true; }
+        return false;
+      }},
+      connection: {type:"mobius connection", required:true}
+    },
+    color:"#9ee3fa",
+    inputs:1,
+    outputs:1,
+    outputLabels: ["MOBiUS objects or URIs"],
+    icon: "mobius.png",
+    align: "left",
+    paletteLabel: 'discover object list',
+    label: function() {
+      if(this.name) {
+        return this.name;
+      } else {
+        return "discover object list";
+      }
+    },
+    labelStyle: function() {
+      return this.name ? "node_label_italic":"";
+    },
+    oneditprepare: function () {
+      var node = this;
+
+      /** Create the subs container and populate it */
+      $('#node-input-subs-container').css('min-height', '200px').css('min-width', '345px').editableList ({
+        addButton: "add uri",
+        removable: true,
+        sortable: true,
+        addItem: function (container, i, subscription) {
+          container.css({
+            overflow: 'hidden',
+            whiteSpace: 'nowrap'
+          });
+
+          // Add a default subscription if it does not exist
+          if (!subscription.hasOwnProperty("uri")) {
+            subscription = {uri: '', type: 'include'};
+          }
+
+          var row = $('<div>URI</div>').appendTo(container);
+          var uriField = $('<input/>',{class: "node-input-sub-uri", type: "text", style: "width: 170px; margin-left: 5px; text-align: left;"}).appendTo(row);
+          var typeField = $('<select/>',{class: "node-input-sub-type", style: "width:auto; margin-left: 5px; text-align: center;"}).appendTo(row);
+          typeField.append($("<option></option>").val('include').text('Include'));
+          typeField.append($("<option></option>").val('exclude').text('Exclude'));
+
+          // Populate the new stat
+          uriField.val(subscription.uri);
+          typeField.val(subscription.type);
+        }
+      });
+
+      $('.red-ui-editableList-addButton').css('margin-left', '105px')
+
+      // If no stat exists, create a default one
+      if (!node.subscriptions) {
+        node.subscriptions = [subscription = {uri: '', type: 'include'}];
+      }
+      // Populate list with all saved filters
+      for (let i = 0; i < node.subscriptions.length; i++) {
+        let subscription = node.subscriptions[i];
+        $("#node-input-subs-container").editableList('addItem', subscription);
+      }
+
+      function showRIDFilterInputs() {
+        if($("#node-input-useRIDValueFiltering").is(':checked')) {
+          $("#use-rid-filter-row").show();
+        } else {
+          $("#use-rid-filter-row").hide();
+        }
+      }
+      showRIDFilterInputs();
+      $("#node-input-useRIDValueFiltering").change(function() {
+        showRIDFilterInputs();
+      });
+
+      this.editor = RED.editor.createEditor({
+        id: 'node-input-func-editor',
+        mode: 'ace/mode/javascript',
+        value: this.func
+      });
+    },
+    oneditresize(size) {
+      var rows = $("#dialog-form>div:not(.node-input-subs-container-row)");
+      var height = size.height;
+      for (var i=0; i<rows.size(); i++) {
+        height -= $(rows[i]).outerHeight(true);
+      }
+      var editorRow = $("#dialog-form>div.node-input-subs-container-row");
+      height -= 4 * ((parseInt(editorRow.css("marginTop"))+parseInt(editorRow.css("marginBottom"))));
+
+      $("#node-input-subs-container").editableList('height',height);
+    },
+    oneditsave: function() {
+      let subscriptions = $("#node-input-subs-container").editableList('items');
+      let node = this;
+      node.subscriptions= [];
+      subscriptions.each(function (i) {
+        var subscription = $(this);
+        let uri = subscription.find(".node-input-sub-uri").val();
+        let type = subscription.find(".node-input-sub-type").val();
+        node.subscriptions.push({uri: uri, type: type});
+      });
+
+      this.func = this.editor.getValue();
+      this.editor.destroy();
+      delete this.editor;
+    },
+    oneditcancel: function() {
+      this.editor.destroy();
+      delete this.editor;
+    }
+  });
+</script>
+
+<script type="text/x-red" data-help-name="mobius discover object list">
+  <p>Discover MOBiUS objects and return a filtered list of objects or URIs.</p>
+
+  <h3>Configuration Page</h3>
+  <dl class="message-properties">
+    <dt>MOBiUS <span class="property-type">node</span></dt>
+    <dd>Shared MOBiUS connection for communication with the MOBiUS Hub.</dd>
+    <dt>HID <span class="property-type">string</span></dt>
+    <dd>Optional Mobius hub ID to use for discovery. Leave empty to use the local HID.</dd>
+    <dt>Output <span class="property-type">option</span></dt>
+    <dd>Output full MOBiUS objects or MOBiUS object URIs.</dd>
+    <dt>Send <span class="property-type">option</span></dt>
+    <dd>Send the outputs individually or as a single array.</dd>
+    <dt>Discover <span class="property-type">string</span></dt>
+    <dd>The MOBiUS URI of the objects to discover. This may contain MQTT type wildcards.</dd>
+    <dt>Filter by Resource Value <span class="property-type">checkbox</span></dt>
+    <dd>If checked the returned objects are also filtered by the value of a single resource.</dd>
+    <dt>RID <span class="property-type">string</span></dt>
+    <dd>The MOBiUS Object Resource ID of the resource to test.</dd>
+    <dt class="optional">Limit <span class="property-type">number</span></dt>
+    <dd>The maximum number of objects to return. Defaults to 100.</dd>
+    <dt>Function <span class="property-type">string</span></dt>
+    <dd>JavaScript used to test the resource value.</dd>
+</dl>
+
+  <h3>Inputs</h3>
+  <ol class="node-ports">
+    <li>Input message to trigger discovery
+      <dl class="message-properties">
+        <dt class="optional">topic <span class="property-type">string</span></dt>
+        <dd>Topic is passed through to output.</dd>
+      </dl>
+    </li>
+  </ol>
+
+  <h3>Outputs</h3>
+  <ol class="node-ports">
+    <li>Array of URIs discovered.
+      <dl class="message-properties">
+        <dt>topic <span class="property-type">string</span></dt>
+        <dd>When outputting individual items the topic will be the object URI and when outputting arrays the topic is passed through from input.</dd>
+        <dt>payload <span class="property-type">array</span></dt>
+        <dd>Array or individual list of discovered objects or URIs.</dd>
+      </dl>
+    </li>
+  </ol>
+
+  <h3>Details</h3>
+  <p>
+    The <code>Function</code> configuration property is string containing the JavaScript expression used to test the resource value. The expression must return <b>true</b> or <b>false</b>.
+    The actual value of the resource is represented in the expression by <code>$PV</code>. A few examples are shown below:</br>
+    <code>return $PV === 5;</code><br>
+    <code>return $PV > 10 && $PV < 100;</code><br>
+    <code>return $PV.includes('test-string');</code>
+  </p>
+
+  <br>
+  <p align="center" style="color:#000080">iaconnects © 2019</p>
+</script>

package/dist/nodes/mobius-discover-object-list.js

@@ -0,0 +1,263 @@
+/**
+ Copyright (C) 2016, IAConnects Technology Limited
+ All Rights Reserved
+
+ ALL INFORMATION CONTAINED HEREIN IS, AND REMAINS
+ THE PROPERTY OF IACONNECTS TECHNOLOGY LIMITED AND ITS SUPPLIERS,
+ IF ANY. THE INTELLECTUAL AND TECHNICAL CONCEPTS CONTAINED
+ HEREIN ARE PROPRIETARY TO IACONNECTS TECHNOLOGY LIMITED
+ AND ITS SUPPLIERS AND ARE PROTECTED BY TRADE SECRET OR COPYRIGHT LAW.
+ DISSEMINATION OF THIS INFORMATION OR REPRODUCTION OF THIS MATERIAL
+ IS STRICTLY FORBIDDEN UNLESS PRIOR WRITTEN PERMISSION IS OBTAINED
+ FROM IACONNECTS TECHNOLOGY LIMITED.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS
+ BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ POSSIBILITY OF SUCH DAMAGE.
+ **/
+
+/* jshint elision: true */
+'use strict';
+
+module.exports = function (RED) {
+  function MobiusFlowNode (n) {
+    RED.nodes.createNode(this, n);
+    this.subscriptions = n.subscriptions;
+    this.sendType = n.send;
+    this.outputType = n.output;
+    this.hid = n.hid;
+    this.useRIDValueFiltering = n.useRIDValueFiltering;
+    this.rid = n.rid;
+    this.limit = n.limit;
+    this.func = n.func;
+    this.serviceConn = RED.nodes.getNode(n.connection);
+    var node = this;
+
+    if (node.serviceConn) {
+      node.status({
+        fill: 'red',
+        shape: 'ring',
+        text: 'Disconnected'
+      });
+
+      node.serviceConn.register(node);
+
+      node.on('input', function (msg, done) {
+        node.status({
+          fill: 'green',
+          shape: 'ring',
+          text: 'Busy'
+        });
+
+        node.discoverAllObjectURIs(msg).then((objectList) => {
+          if (node.sendType === 'individual') {
+            objectList.forEach((mobiusObject) => {
+              if (node.outputType === 'uris') {
+                node.send({
+                  topic: mobiusObject.uri,
+                  payload: mobiusObject.uri
+                });
+              } else {
+                node.send({
+                  topic: mobiusObject.uri,
+                  payload: mobiusObject
+                });
+              }  
+            });
+          } else {
+            if (node.outputType === 'uris') {
+              const uris = [];
+              objectList.forEach((mobiusObject) => {
+                uris.push(mobiusObject.uri);
+              });
+              node.send({
+                topic: msg.topic,
+                payload: uris
+              });  
+            } else {
+              node.send({
+                topic: msg.topic,
+                payload: objectList
+              });  
+            }
+          }
+ 
+          node.status({
+            fill: 'green',
+            shape: 'dot',
+            text: 'Done'
+          });
+        }).catch(() => {
+          node.status({
+            fill: 'yellow',
+            shape: 'dot',
+            text: 'Failed discovery'
+          });
+        });
+        if (done) {
+          done();
+        }
+      });
+
+      node.on('close', function (done) {
+        node.serviceConn.deregister(node, done);
+      });
+    } else {
+      node.error(RED._('Mobius service not defined'));
+    }
+
+    node.discoverAllObjectURIs = async function (msg) {
+      return new Promise(async (resolve, reject) => {
+        let objectList = [];
+        try {
+          const hid = node.hid === '' ? node.serviceConn.service.srvcAPI.status.hubId : node.hid;
+          const profiles = await discoverProfiles(node.serviceConn, hid, node.subscriptions);
+
+          for await (let entry of profiles.entries()) {
+            let discoverParams = {};
+            const serviceURI = entry[0];
+            const pids = entry[1];
+            if (node.useRIDValueFiltering) {
+              discoverParams = {
+                uri: serviceURI,
+                pids: pids,
+                rid: node.rid,
+                func: node.func,
+                limit: node.limit
+              };
+            } else {
+              discoverParams = {
+                uri: serviceURI,
+                pids: pids,
+                rid: '00',
+                func: 'return true;',
+                limit: 512
+              };
+            }
+            try {
+              let objects = await discover(node.serviceConn, discoverParams);
+              for (let lp = 0; lp < objects.value.length; lp++) {
+                objects.value[lp]['uri'] = `${serviceURI}/${objects.value[lp].pid}/${objects.value[lp].ins}`;
+                objectList.push(objects.value[lp]);
+              }
+            } catch (err) {
+              node.warn(`Discover object failed for service (${serviceURI}) - ${err.message}`);
+            }
+          } 
+
+          if (objectList.length === 0) {
+            throw new Error('No discovery data found');
+          }
+        } catch (err) {
+          node.warn(`Failed discover all objects: ${err.message}`);
+          reject(err.message);
+        }
+        resolve(objectList);
+      });
+    };
+  }
+
+  async function discoverProfiles(serviceConn, hid, subscriptions) {
+    return new Promise(async (resolve) => {
+      let discoveredProfiles = new Map();
+      let services = await discover(serviceConn, hid);
+      for (const service of services.value) {
+        if (service.status === 'online') {
+          let sid = service.id.split('/')[1];
+          if (isIncluded(`${hid}/${sid}/#`, subscriptions)) {
+            let profiles = await discover(serviceConn, `${hid}/${sid}`);
+            let pids = [];
+            for (const pid of profiles.value) {
+              if (isIncluded(`${hid}/${sid}/${pid}/#`, subscriptions) && !isExcluded(`${hid}/${sid}/${pid}/#`, subscriptions)) {
+                pids.push(pid);
+              }  
+            }
+            if (pids.length > 0) {
+              discoveredProfiles.set(`${hid}/${sid}`, pids);
+            }
+          }
+        } else {
+          RED.log.warn(`Failed to discover objects for service ${service.id.split('/')[1]} as it is offline.`);
+        }
+      }
+      resolve(discoveredProfiles);
+    });
+  }
+
+  async function discover (serviceConn, params) {
+    return new Promise((resolve, reject) => {
+      serviceConn.discover(params, (err, response) => {
+        if (err) {
+          reject(err);
+        } else {
+          resolve(response);
+        }
+      });
+    });
+  };
+
+  function isIncluded(uri, subscriptions) {
+    let include = false;
+    for (const subscription of subscriptions) {
+      if (subscription.type === 'include' && validateSubscription(subscription.uri)) {
+        if (matchTopic(subscription.uri, uri)) {
+          include = true;
+        }
+      }
+    }
+    return include;
+  }
+
+  function isExcluded (uri, subscriptions) {
+    let exclude = false;
+    for (const subscription of subscriptions) {
+      if (subscription.type === 'exclude' && validateSubscription(subscription.uri)) {
+        if (matchTopic(subscription.uri, uri)) {
+          exclude = true;
+        }
+      }
+    }
+    return exclude;
+  }
+
+  function validateSubscription (uri) {
+    let parts = uri.split('/');
+    for (let lp = 0; lp < parts.length; lp++) {
+      if (parts[lp] === null || parts[lp] === '') {
+        return false;
+      }
+    }
+    if (parts.length === 4) {
+      return true;
+    }
+    if (parts.length < 4 && parts[parts.length - 1] === '#') {
+      return true;
+    }
+    return false;
+  }
+
+  function matchTopic (filter, topic) {
+    const filterArray = filter.split('/');
+    const topicArray = topic.split('/');
+    const length = filterArray.length < topicArray.length ? filterArray.length : topicArray.length;
+  
+    for (let i = 0; i < length; ++i) {
+      const left = filterArray[i];
+      const right = topicArray[i];
+      if (!(left === right || left === '+' || left === '#' || right === '+' || right === '#')) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  RED.nodes.registerType('mobius discover object list', MobiusFlowNode);
+};

package/dist/nodes/mobius-discover.html

@@ -0,0 +1,139 @@
+<!--
+Copyright (C) 2016, IAConnects Technology Limited
+All Rights Reserved
+
+ALL INFORMATION CONTAINED HEREIN IS, AND REMAINS
+THE PROPERTY OF IACONNECTS TECHNOLOGY LIMITED AND ITS SUPPLIERS,
+IF ANY. THE INTELLECTUAL AND TECHNICAL CONCEPTS CONTAINED
+HEREIN ARE PROPRIETARY TO IACONNECTS TECHNOLOGY LIMITED
+AND ITS SUPPLIERS AND ARE PROTECTED BY TRADE SECRET OR COPYRIGHT LAW.
+DISSEMINATION OF THIS INFORMATION OR REPRODUCTION OF THIS MATERIAL
+IS STRICTLY FORBIDDEN UNLESS PRIOR WRITTEN PERMISSION IS OBTAINED
+FROM IACONNECTS TECHNOLOGY LIMITED.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+-->
+
+<script type="text/x-red" data-template-name="mobius discover">
+  <div class="form-row">
+    <label for="node-input-connection"><i class="fa fa-globe"></i> MOBiUS</label>
+    <input type="text" id="node-input-connection">
+  </div>
+  <hr>
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+    <input type="text" id="node-input-name" placeholder="Name">
+  </div>
+</script>
+
+<script type="text/javascript">
+  RED.nodes.registerType('mobius discover',{
+    category: 'mobius',
+    color: "#8abff5",
+    defaults: {
+      name: {value: ""},
+      connection: {type: "mobius connection", required: true}
+    },
+    inputs:1,
+    outputs:1,
+    inputLabels: "Trigger discovery",
+    outputLabels: ["Full MOBiUS response"],
+    icon: "mobius.png",
+    align: "left",
+    paletteLabel: "discover",
+    label: function() {
+      if(this.name) {
+        return this.name;
+      } else {
+        return "discover";
+      }
+    },
+    labelStyle: function() {
+      return this.name ? "node_label_italic":"";
+    }
+  });
+</script>
+
+<script type="text/x-red" data-help-name="mobius discover">
+  <p>Discover MOBiUS services, object profiles, and objects</p>
+
+  <h3>Configuration Page</h3>
+  <dl class="message-properties">
+    <dt>MOBiUS <span class="property-type">node</span></dt>
+    <dd>Shared MOBiUS connection for communication with the MOBiUS Hub.</dd>
+  </dl>
+
+  <h3>Inputs</h3>
+  <ol class="node-ports">
+    <li>Input message to trigger discovery
+      <dl class="message-properties">
+        <dt>topic <span class="property-type">string</span></dt>
+        <dd>The path (in the form of a partial MOBiUS URI) whose children are to be discovered.</dd>
+        <dt class="optional">payload <span class="property-type">object</span></dt>
+        <dd>If the following properties are supplied in the payload the discovery will filter the results based on a resource's value.
+          See the Details section below for more information.</dd>
+        <dt class="optional">payload.pids <span class="property-type">array of strings</span></dt>
+        <dd>An array of MOBiUS Object Profile IDs to filter. Defaults to an empty array.</dd>
+        <dt>payload.rid <span class="property-type">string</span></dt>
+        <dd>The MOBiUS Object Resource ID of the resource to test.</dd>
+        <dt class="optional">payload.limit <span class="property-type">number</span></dt>
+        <dd>The maximum number of objects to return. Defaults to 100.</dd>
+        <dt>payload.func <span class="property-type">string</span></dt>
+        <dd>JavaScript used to test the resource value.</dd>
+      </dl>
+    </li>
+  </ol>
+
+  <h3>Outputs</h3>
+  <ol class="node-ports">
+    <li>Full MOBiUS response
+      <dl class="message-properties">
+        <dt>topic <span class="property-type">string</span></dt>
+        <dd>The original path used in the disccovery.</dd>
+        <dt>error <span class="property-type">boolean</span></dt>
+        <dd>True if an error occured, else false.</dd>
+        <dt>response <span class="property-type">object</span></dt>
+        <dd>The full MOBiUS response message.</dd>
+      </dl>
+    </li>
+  </ol>
+
+  <h3>Details</h3>
+  <p>
+    In addition to discovering all MOBiUS services, object profiles, and objects it is possible filter the results based on the value of a resource.
+    This is done by passing in additional parameters in the payload. These parameters are detailed below.
+    <br><b>Filtering only works when discovering object profiles or objects.</b>
+  </p>
+  <p>To filter on objects of type 0201 and 0258 and only return the objects with a value of greater than 12 in resource 40 the message would be:<br>
+    <code>{ topic: "000001/021", payload: { pids: ["0201", "0258"], rid: "40", func: "return $PV > 12;" }</code>
+  <p>
+    <code><i>pids</i></code> When discovering object profiles an array of the profiles (as 4 digit hex strings) to be used in the filter can be supplied. If this is an empty array it acts as a
+    wild card and all objects belonging to a service will be used regardless of their object profile. If pids is not supplied it will default to an empty array.
+    <br>When discovering object instances the pids value will be ignored and only the pid supplied as part of the discovery URI is used.
+  </p>
+  <p>
+    <code>rid</code> The ID of resource whose value will be tested. This is a 2 digit hex string.
+  </p>
+  <p>
+    <code><i>limit</i></code> The maximum number of objects that will be returned. If not supplied it defaults to 100.
+  </p>
+  <p>
+    <code>func</code> A string containing the JavaScript expression used to test the resource value. The expression must return <b>true</b> or <b>false</b>.
+    The actual value of the resource is represented in the expression by <code>$PV</code>. A few examples are shown below:</br>
+    <code>return $PV === 5;</code><br>
+    <code>return $PV > 10 && $PV < 100;</code><br>
+    <code>return $PV.includes('test-string');</code>
+  </p>
+  <br>
+  <p align="center" style="color:#000080">iaconnects © 2017</p>
+</script>