@bitpoolos/edge-bacnet 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -1,17 +1,26 @@
 # Changelog
 
+## [1.5.1] - 13-11-2024
+
+### Summary
+
+Npm package update - iconv-lite. Fix for incorrect character string decoding bug
+
+Added dialog confirmation to rebuild data model. Fixed modal duplication bug in confirmation service implementation.
+
 ## [1.5.0] - 31-10-2024
+
 ### Summary
 
-Major feature release - Port range binding  
+Major feature release - Port range binding
 
 Large amount of bug fixes
 
 Added error string to Full Object payload. Contains a BACnet string where an error is found for point, otherwise contains "none".
 
-Proceed with caution as a correct port range has to be established in data model in order to continue uptime on existing sites. Doing a device discovery will update device model with port number. 
+Proceed with caution as a correct port range has to be established in data model in order to continue uptime on existing sites. Doing a device discovery will update device model with port number.
 
-Best method to update this version on existing installs: 
+Best method to update this version on existing installs:
 
 - Install v1.5.0
 - Restart node-red / docker container
@@ -20,141 +29,140 @@ Best method to update this version on existing installs:
 - Restart node-red / docker container again.
 - Inject manual discovery to gateway node a couple times
 
-It is recommended you back up: your node-red flows and gateway Discovery tab device list, incase something goes wrong. 
+It is recommended you back up: your node-red flows and gateway Discovery tab device list, incase something goes wrong.
 
 ## [1.4.6] - 17-09-2024
+
 ### Summary
 
 Minor fixes.
 
-Wrapped updateDeviceName function with promise to avoid network conflict for clients. 
+Wrapped updateDeviceName function with promise to avoid network conflict for clients.
 
 Fixed UI styling bugs, primarily with long names and numbers wrapping.
 
-Added ability to set device name of dummy MSTP routers. 
+Added ability to set device name of dummy MSTP routers.
 
 Improved error handling for querying devices and building point json structures.
 
 Fixed read node point export bug.
 
-Excluded commas via point name conditioning 
+Excluded commas via point name conditioning
 
 Fixed gateway port assignment bug - ability to communicate on different ports working now.
 
 More async / await refactoring.
 
-
 ## [1.4.5] - 16-08-2024
+
 ### Summary
 
 User interface redesign and restyle. Predominantly colors, buttons, fonts, and placement of UI components.
 
-Added timestamp update, and online/offline status update for points when an error has occured during the network request for present value. Use in Simple with status and Full Object payload types. 
-
+Added timestamp update, and online/offline status update for points when an error has occured during the network request for present value. Use in Simple with status and Full Object payload types.
 
 ## [1.4.4] - 08-08-2024
-### Summary 
+
+### Summary
 
 Minor updates.
 
-Added device details to meta property when full object property type is selected. 
+Added device details to meta property when full object property type is selected.
 
 Implemented applyDisplayName feature. Triggered via:
-```javascript 
-applyDisplayNames = true 
+
+```javascript
+applyDisplayNames = true;
 ```
-property in an inject node, directly linked to a read node. Function flow: inject applyDisplayNames = true to read node -> read node passes msg to gateway node -> gateway node updates bacnet model for device and point display names. 
 
-This feature is for use in scenarios where the flows.json or node json structure is programattically generated with a prefilled pointsToRead property. Some devices and points may need displayNames updating.
+property in an inject node, directly linked to a read node. Function flow: inject applyDisplayNames = true to read node -> read node passes msg to gateway node -> gateway node updates bacnet model for device and point display names.
 
+This feature is for use in scenarios where the flows.json or node json structure is programattically generated with a prefilled pointsToRead property. Some devices and points may need displayNames updating.
 
 ## [1.4.3] - 01-08-2024
-### Summary 
+
+### Summary
 
 Minor updates.
 
-Added refresh button to readList tab on read node, to handle scenarios where read node jsons may be programatically created. 
+Added refresh button to readList tab on read node, to handle scenarios where read node jsons may be programatically created.
 
-Added "Use device name in topic" topic property in inject and read nodes. This option toggles whether or not the device name is included in the msg.topic. 
+Added "Use device name in topic" topic property in inject and read nodes. This option toggles whether or not the device name is included in the msg.topic.
 
 Merge github PR 19. Added ability to configure the creation of a BacnetServer object:
+
 ```javascript
-        payload = {
-            value: 12,
-            resolution: 0,
-            priorityArray: 0,
-            units: 0,
-        }
+payload = {
+  value: 12,
+  resolution: 0,
+  priorityArray: 0,
+  units: 0,
+};
 ```
 
 Inject nodes may need to be deleted and replaced. Try deploying node-red 2 times to instantiate the new deviceName property.
 
-
 ## [1.4.2] - 23-07-2024
-### Summary 
 
-Improved UI tree generation, fixing some unique scenarios where devices were not being correctly added. 
+### Summary
 
-Added new payload type: Individual JSON. This publishes JSON payloads to a point level, rather than to a device or property level. 
+Improved UI tree generation, fixing some unique scenarios where devices were not being correctly added.
+
+Added new payload type: Individual JSON. This publishes JSON payloads to a point level, rather than to a device or property level.
 
 Added payload and output types to be configured via Inject node. Any checked options in the inject node will take priority over read node options. Note - to use read node output types only, please deselect all inject node output options.
 
-Added dumb BACnet parent devices to UI tree, for unique situations where MSTP devices are on a network without a parent IP device. 
+Added dumb BACnet parent devices to UI tree, for unique situations where MSTP devices are on a network without a parent IP device.
 
 Bug fixes:
- - Importing read list was incorrectly generating UI 
- - Block per device JSON payloads were not using DisplayName and JSON key 
- - Added node-red context variable to monitor if writeProperty event has been subscribed to, avoiding a new subscription for every node-red deploy.
- - Fixed issue requiring Bacnet server to be constantly enabled in order for the node to function. 
 
+- Importing read list was incorrectly generating UI
+- Block per device JSON payloads were not using DisplayName and JSON key
+- Added node-red context variable to monitor if writeProperty event has been subscribed to, avoiding a new subscription for every node-red deploy.
+- Fixed issue requiring Bacnet server to be constantly enabled in order for the node to function.
 
-No nodes need to be deleted and replaced for this update. 
+No nodes need to be deleted and replaced for this update.
 
 ## [1.4.1] - 09-07-2024
 
 ### Summary
 
 Bug fixes
- - incorrect variable used in doRead try catch
- - setmaxlisteners on bacnet server event parent class
 
+- incorrect variable used in doRead try catch
+- setmaxlisteners on bacnet server event parent class
 
 ## [1.4.0] - 05-07-2024
 
 ### Summary
 
-Fixed read list export for sites with large point counts. 
+Fixed read list export for sites with large point counts.
 
-Removed auto tree reload on read node UI. UI tree must be manually reloaded now. 
+Removed auto tree reload on read node UI. UI tree must be manually reloaded now.
 
-Fixed export to CSV bug. 
+Fixed export to CSV bug.
 
 Fixed state array text not found bug
 
-Removed unecessary debug. 
+Removed unecessary debug.
 
-Updated required json saved to node JSON file. 
+Updated required json saved to node JSON file.
 
-Added github pull requests
-    - Added create object and delete object to bacnet server 
-    - Added write property to bacnet server 
+Added github pull requests - Added create object and delete object to bacnet server - Added write property to bacnet server
 
-Added Simple With Status read property type.
-    - This type sends a msg.payload that consists of {presentValue, timestamp, status}
-    - Status is currently online and offline
+Added Simple With Status read property type. - This type sends a msg.payload that consists of {presentValue, timestamp, status} - Status is currently online and offline
 
 Changed inject node to only 1 selectable type of inject (Discover or Poll)
 
-
 ## [1.3.2] - 18-06-2024
 
-### Summary 
+### Summary
 
 Bug fix for API request URL paths. Updated for using node-red host setting.
 
 ## [1.3.1] - 06-06-2024
 
-### Summary 
+### Summary
 
 Primarily bug fixes and performance improvements
 
@@ -176,11 +184,10 @@ Primarily bug fixes and performance improvements
 
 - Devices are immediately added to the UI tree with a device placeholder on a whoIs/iAm response. The devices are then back populated with Names and BACnet Objects. This gives the user a fast understanding of the size and relationships of the BACnet network.
 
-- Added docstrings to bacnet_server.js and code clean up. 
+- Added docstrings to bacnet_server.js and code clean up.
 
 - Set Server enable to default on True
 
-
 ## [1.3.0] - 16-05-2024
 
 ### Summary
@@ -198,34 +205,35 @@ This release includes several new features, bug fixes, and performance improveme
 - Updated Add All button to add all sub MSTP devices if parent IP device button is selected
 
 - Introduced Right click context menu for all device types present in Device List:
-    - Purge Device
-        - Purges device from active model, removing it from the device list
-    - Update Points
-        - Triggers point updating function for selected device, beneficial for large bacnet networks 
-    - Add All Points
-        - Same as Add All button
-    - Remove All Points
-        - Same as Remove All button
-    - Set device name
-        - Sets device Display Name, which is used in the output of read operations
-
-- Introduced Right click context menu for all points present in the Device List: 
-    - Set point Name
-        - Sets point display name, used in the output of read operations
-    - Update point
-        - Triggers point update function, forces latest present value
-
-- Introduced Export and Import of ReadList in the read node. 
-    - This feature Exports a light weight JSON file with all devices and points added to the Read List. This allows the user to rename all of the devices and points in the Read List via a plain text editor, then Import the modified file. The process of importing will update the Display Names of desired points and device. This feature was introduced with the intention of streamlinibg the naming convetions and processes used for site deployment. 
-
-- Added support for debian systems, displays All Interfaces (0.0.0.0) in network adapter property 
 
-- Added publish status under gateway node
+  - Purge Device
+    - Purges device from active model, removing it from the device list
+  - Update Points
+    - Triggers point updating function for selected device, beneficial for large bacnet networks
+  - Add All Points
+    - Same as Add All button
+  - Remove All Points
+    - Same as Remove All button
+  - Set device name
+    - Sets device Display Name, which is used in the output of read operations
 
-- Implemented usage of gateway and read node names in MQTT topics
-    - {gateway node name}/{read node name}/pointName 
+- Introduced Right click context menu for all points present in the Device List:
+
+  - Set point Name
+    - Sets point display name, used in the output of read operations
+  - Update point
+    - Triggers point update function, forces latest present value
+
+- Introduced Export and Import of ReadList in the read node.
+
+  - This feature Exports a light weight JSON file with all devices and points added to the Read List. This allows the user to rename all of the devices and points in the Read List via a plain text editor, then Import the modified file. The process of importing will update the Display Names of desired points and device. This feature was introduced with the intention of streamlinibg the naming convetions and processes used for site deployment.
 
+- Added support for debian systems, displays All Interfaces (0.0.0.0) in network adapter property
 
+- Added publish status under gateway node
+
+- Implemented usage of gateway and read node names in MQTT topics
+  - {gateway node name}/{read node name}/pointName
 
 ### Bug Fixes
 
@@ -233,16 +241,15 @@ This release includes several new features, bug fixes, and performance improveme
 
 - Write to MSTP devices bug fix
 
-
 ### Performance Improvements
 
-- Added support for a wider range of devices. 
+- Added support for a wider range of devices.
 
 - Added getProtocolsSupported request to identify bacnet service support for each device
 
 - Added apduSize based readPropertyMultiple packaging for reduced network requests
 
-- Refactored device tree function and implemented treeBuilder. 
+- Refactored device tree function and implemented treeBuilder.
 
 - Refactored device object building / querying process
 
@@ -250,7 +257,7 @@ This release includes several new features, bug fixes, and performance improveme
 
 ### Other Changes
 
-- Added Changelog 
+- Added Changelog
 
 - Updated Readme for better node updating.
 

package/bacnet_client.js

@@ -6,7 +6,15 @@ const bacnet = require("./resources/node-bacstack-ts/dist/index.js");
 const baEnum = bacnet.enum;
 const bacnetIdMax = baEnum.ASN1_MAX_PROPERTY_ID;
 const { EventEmitter } = require("events");
-const { getUnit, roundDecimalPlaces, parseBacnetError, getBacnetErrorString, Read_Config_Sync, isNumber, decodeBitArray } = require("./common");
+const {
+  getUnit,
+  roundDecimalPlaces,
+  parseBacnetError,
+  getBacnetErrorString,
+  Read_Config_Sync,
+  isNumber,
+  decodeBitArray,
+} = require("./common");
 const { ToadScheduler, SimpleIntervalJob, Task } = require("toad-scheduler");
 const { BacnetDevice } = require("./bacnet_device");
 const { Mutex } = require("async-mutex");
@@ -65,13 +73,12 @@ class BacnetClient extends EventEmitter {
       };
 
       try {
-
         that.client = new bacnet.Client({
           apduTimeout: config.apduTimeout,
           interface: config.localIpAdrress,
           port: config.port,
           broadcastAddress: config.broadCastAddr,
-          portRangeMatrix: config.portRangeMatrix
+          portRangeMatrix: config.portRangeMatrix,
         });
         that.setMaxListeners(1);
 
@@ -193,15 +200,34 @@ class BacnetClient extends EventEmitter {
 
     let addressObject = {
       address: address,
-      port: port
+      port: port,
     };
 
+    const propertiesArray = [{ objectId: { type: type, instance: instance }, properties: [{ id: property }] }];
+
+    that.client.readPropertyMultiple(addressObject, propertiesArray, that.readPropertyMultipleOptions, (err, value) => {
+      console.log("1 - readPropertyMultiple:  ");
+
+      console.log(value);
+      if (value) {
+        // If the result has value, resolve the promise
+        console.log(value.values[0]);
+        value.values[0].values.forEach(function (value) {
+          console.log("value: ", value.value);
+        });
+      } else {
+        console.log(err);
+      }
+    });
+
     that.client.readProperty(
       addressObject,
       { type: type, instance: instance },
       property,
       that.readPropertyMultipleOptions,
       (err, value) => {
+        console.log("2 - readProperty:  ");
+
         console.log(value);
         if (value) {
           // If the result has value, resolve the promise
@@ -264,7 +290,7 @@ class BacnetClient extends EventEmitter {
     let that = this;
     let addressObject = {
       address: device.getAddress(),
-      port: device.getPort()
+      port: device.getPort(),
     };
     return new Promise((resolve, reject) => {
       that.client.readProperty(
@@ -871,7 +897,7 @@ class BacnetClient extends EventEmitter {
     let that = this;
     let addressObject = {
       address: device.getAddress(),
-      port: device.getPort()
+      port: device.getPort(),
     };
     return new Promise((resolve, reject) => {
       that.client.readProperty(
@@ -1029,7 +1055,7 @@ class BacnetClient extends EventEmitter {
 
       let addressObject = {
         address: device.getAddress(),
-        port: device.getPort()
+        port: device.getPort(),
       };
 
       let index = 1;
@@ -1068,7 +1094,7 @@ class BacnetClient extends EventEmitter {
     let that = this;
     let addressObject = {
       address: device.getAddress(),
-      port: device.getPort()
+      port: device.getPort(),
     };
     return new Promise((resolve, reject) => {
       that.client.readPropertyMultiple(addressObject, requestArray, readOptions, (error, value) => {
@@ -1085,7 +1111,7 @@ class BacnetClient extends EventEmitter {
 
     let addressObject = {
       address: device.getAddress(),
-      port: device.getPort()
+      port: device.getPort(),
     };
     let deviceId = device.getDeviceId();
 
@@ -1102,7 +1128,7 @@ class BacnetClient extends EventEmitter {
     let that = this;
     let addressObject = {
       address: device.getAddress(),
-      port: device.getPort()
+      port: device.getPort(),
     };
     let deviceId = device.getDeviceId();
     try {
@@ -1150,7 +1176,7 @@ class BacnetClient extends EventEmitter {
 
     let addressObject = {
       address: device.getAddress(),
-      port: device.getPort()
+      port: device.getPort(),
     };
 
     // Define all properties to be read
@@ -1251,7 +1277,7 @@ class BacnetClient extends EventEmitter {
 
     let addressObject = {
       address: device.getAddress(),
-      port: device.getPort()
+      port: device.getPort(),
     };
 
     // Define all properties to be read
@@ -1333,7 +1359,7 @@ class BacnetClient extends EventEmitter {
         let device = that.deviceList.find((ele) => ele.getDeviceId() === point.deviceId);
         let addressObject = {
           address: device.getAddress(),
-          port: device.getPort()
+          port: device.getPort(),
         };
 
         let writeObject = {
@@ -1671,7 +1697,6 @@ class BacnetClient extends EventEmitter {
     that.buildJsonInProgress = false;
   }
 
-
   async buildJsonObject(device) {
     try {
       const pointList = device.getPointsList();

package/bacnet_gateway.html

@@ -238,14 +238,15 @@
 
       queryAdapters();
 
-      if (node.vm1 == undefined) {
+      window.confirmDialogExists = window.confirmDialogExists || false;
+
+      if (node.vm1 == undefined && !window.confirmDialogExists) {
         const confirmDialog = document.createElement("p-confirm-dialog");
         document.getElementById("serverParent").appendChild(confirmDialog);
+        window.confirmDialogExists = true;
       }
 
       const { createApp, ref, onMounted } = Vue;
-      const ConfirmDialog = primevue.confirmdialog;
-      const ConfirmationService = primevue.confirmationservice;
       const ListBox = primevue.listbox;
 
       //prime vue app
@@ -517,7 +518,6 @@
             document.getElementById("node-input-reg-block-count-portRangeMatrix").innerHTML = $(
               "#node-input-portRangeMatrix-container"
             ).editableList("length");
-
           },
           removeItem: function (data) {
             document.getElementById("node-input-reg-block-count-portRangeMatrix").innerHTML = $(
@@ -587,7 +587,6 @@
 
       document.getElementById("node-input-reg-block-count-portRangeMatrix").innerHTML = node.portRangeRegisters.length;
       //end port range matrix
-
     },
     oneditsave: function () {
       let node = this;
@@ -619,7 +618,6 @@
         node.deviceRangeRegisters.push(mapItem);
       });
 
-
       node.portRangeRegisters = [];
       let portRanges = $("#node-input-portRangeMatrix-container").editableList("items");
       portRanges.each(function (i) {
@@ -631,7 +629,6 @@
         };
         node.portRangeRegisters.push(mapItem);
       });
-
     },
   });
 
@@ -680,10 +677,6 @@
       margin-top: 20px;
       margin-left: 50px;
     }
-    .p-confirm-dialog-accept > .p-button-label,
-    .bacnetServerRebuildSchedule_clearButton > .p-button-label {
-      color: white;
-    }
     .red-ui-editor label {
       font-size: 12px;
     }
@@ -761,8 +754,7 @@
 
       <div class="form-row bp-row" id="networkInterfaceDiv">
         <label for="node-input-local_device_address"
-          ><i class="icon-tag"></i><span data-i18n="bitpool-bacnet.label.local_device_address"></span> Network
-          Interface</label
+          ><i class="icon-tag"></i><span data-i18n="bitpool-bacnet.label.local_device_address"></span> Network Interface</label
         >
         <select id="node-input-local_device_address"></select>
       </div>
@@ -795,7 +787,6 @@
       <div class="form-row node-input-deviceIdRangeMatrix-container-row bp-row">
         <ol id="node-input-deviceIdRangeMatrix-container"></ol>
       </div>
-
     </div>
 
     <div id="read-discover-tab" style="display:none">
@@ -898,8 +889,8 @@
 
       <div class="form-row bp-row" style="align-items: center; display: none;">
         <label for="node-input-sanitise_device_schedule_value"
-          ><i class="icon-tag"></i> <span data-i18n="bitpool-bacnet.label.sanitise_device_schedule"></span>Device
-          Sanitisation Frequency</label
+          ><i class="icon-tag"></i> <span data-i18n="bitpool-bacnet.label.sanitise_device_schedule"></span>Device Sanitisation
+          Frequency</label
         >
         <p style="margin-right: 5px; margin-bottom: 0px; padding-left: 7px;">Every</p>
         <input type="text" id="node-input-sanitise_device_schedule" style="display: none;" />
@@ -917,17 +908,17 @@
       </div>
 
       <div class="form-row bp-checkbox-row">
-        <input type="checkbox" id="node-input-cacheFileEnabled" class="bp-checkbox"/>
+        <input type="checkbox" id="node-input-cacheFileEnabled" class="bp-checkbox" />
         <label for="node-input-cacheFileEnabled"> Enable cache file </label>
       </div>
 
       <div class="form-row bp-checkbox-row">
-        <input type="checkbox" id="node-input-toLogIam" class="bp-checkbox"/>
+        <input type="checkbox" id="node-input-toLogIam" class="bp-checkbox" />
         <label for="node-input-toLogIam"> Log found device </label>
       </div>
 
       <div class="form-row bp-checkbox-row" style="border-bottom: 1px solid #cbcbcb; padding-bottom: 20px;">
-        <input type="checkbox" id="node-input-logErrorToConsole" class="bp-checkbox"/>
+        <input type="checkbox" id="node-input-logErrorToConsole" class="bp-checkbox" />
         <label for="node-input-logErrorToConsole"> Log BACnet errors to console </label>
       </div>
 
@@ -949,15 +940,12 @@
 
     <div id="read-server-tab" style="display:none">
       <div class="form-row bp-checkbox-row">
-        <input type="checkbox" id="node-input-serverEnabled" class="bp-checkbox"/>
+        <input type="checkbox" id="node-input-serverEnabled" class="bp-checkbox" />
         <label for="node-input-serverEnabled"> Enable Server </label>
       </div>
 
       <div class="read_server_parent_div" id="serverParent">
-        <div
-          class="form-row bp-row clearServerContainer"
-          id="clearServerContainer"
-          style="align-items: center; display: flex;">
+        <div class="form-row bp-row clearServerContainer" id="clearServerContainer" style="align-items: center; display: flex;">
           <p-button class="bacnetServerRebuildSchedule_clearButton" @click="confirmAll($event)" label="Reinitialize Server">
           </p-button>
         </div>
@@ -990,8 +978,8 @@
   <h3><strong>Gateway Tab</strong></h3>
   <ul class="node-ports">
     <li>
-      Network Interface - the desired interface for the bacstack client to bind to. This interface must not have any other
-      BACnet clients bound to it.
+      Network Interface - the desired interface for the bacstack client to bind to. This interface must not have any other BACnet
+      clients bound to it.
     </li>
     <li>
       Broadcast Address - the desired subnet for global msgs to be broadcast and recieved on. This should be as strict as
@@ -1006,13 +994,13 @@
     <li>Max APDU Size - BACnet max apdu size</li>
     <li>Max Segments - BACnet max segments</li>
     <li>
-      Global Discover Frequency - the frequency at which the gateway issues global WhoIs BACnet commands. This should be
-      limited to the least amount possible, as over-loading a network can be a serious issue with BACnet commmunications.
+      Global Discover Frequency - the frequency at which the gateway issues global WhoIs BACnet commands. This should be limited
+      to the least amount possible, as over-loading a network can be a serious issue with BACnet commmunications.
     </li>
     <li>
-      Manual Point Discovery Instance Range - if a BACnet device doesnt have a Object list (BACnet objectType:propertyId -
-      8:76), the this bacnet client will enter into manual discovery mode, where it iterates through types and instnace
-      ranges. This range can be used to limit this manual scanning
+      Manual Point Discovery Instance Range - if a BACnet device doesnt have a Object list (BACnet objectType:propertyId - 8:76),
+      the this bacnet client will enter into manual discovery mode, where it iterates through types and instnace ranges. This
+      range can be used to limit this manual scanning
     </li>
     <li>Log Device Found - toggles logging of found devices to the node-red debug tab.</li>
     <li>Log BACnet Errors to Console - toggles logging of BACnet related errors to the node-red console</li>
@@ -1025,20 +1013,18 @@
     devices via BACnet/IP
   </p>
   <p>
-    This node only supports 2 BACnet object types, Analog Value - to show numeric data, and a Character String - to show
-    string data.
+    This node only supports 2 BACnet object types, Analog Value - to show numeric data, and a Character String - to show string
+    data.
   </p>
   <ul class="node-ports">
     <li>Enabled - toggles whether or not the local BACnet server is started or not.</li>
-    <li>
-      Clear Server Points - a schedule for the locally generated BACnet points to get cleared from the node object store
-    </li>
+    <li>Clear Server Points - a schedule for the locally generated BACnet points to get cleared from the node object store</li>
   </ul>
 
   <h3><strong>Examples</strong></h3>
   <p>
-    For example flows, please use the examples section for this node. These examples can be found at: Node-red hamburger menu
-    on top right -> Import -> Examples -> @bitpoolos/edge-bacnet
+    For example flows, please use the examples section for this node. These examples can be found at: Node-red hamburger menu on
+    top right -> Import -> Examples -> @bitpoolos/edge-bacnet
   </p>
   <p>
     To find captured examples of settings and flows, please go to our wiki