node-red-contrib-boolean-logic-ultimate 1.0.53 → 1.0.56

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 
 # CHANGELOG
 
+<p>
+<b>Version 1.0.56</b> August 2022<br/>
+- NEW: added string conversion from "true", "false", "0", "1", "close" to boolean.</br>
+- Updated the README</br>
+</p>
+<p>
+<b>Version 1.0.55</b> July 2022<br/>
+- NEW: you can now specify the input property name from witch the node picks up the payload.</br>
+- NEW: added more Homeassistant string compatibility values.</br>
+- Updated the README</br>
+</p>
 <p>
 <b>Version 1.0.53</b> June 2022<br/>
 - NEW: Math Ultimate. The old "Sum" node, now has become a math node, you can peform multipication other than sum.</br>

package/README.md

@@ -10,7 +10,7 @@
 [![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.me/techtoday) 
 [![youtube][youtube-image]][youtube-url]
 
-A set of Node-RED enhanced boolean logic and utility nodes, with persistent values after reboot. Compatible also with Homeassistant ON and OFF values.
+A set of Node-RED enhanced boolean logic and utility nodes, with persistent values after reboot. Compatible also with Homeassistant values. 
 
 <br/>
 <br/>
@@ -21,6 +21,26 @@ A set of Node-RED enhanced boolean logic and utility nodes, with persistent valu
 <br/>
 <br/>
 
+### COMPATIBLES INPUT VALUES
+Other than true/false, all nodes accepts these strings and convert it to true/false. All nodes are compatible with Homeassistant output strings.
+|Input|Translated into|
+|--|--|
+| "on" | true |
+| "off" | false |
+| "active" | true |
+| "inactive" | false |
+| "open" | true |
+| "closed" or "close" | false |
+| "true" | true |
+| "false" | false |
+| "1" | true |
+| "0" | false |
+
+
+<br/>
+<br/>
+
+
 # BOOLEAN LOGIC
 
 <img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/bl1.png' width='60%'>
@@ -53,50 +73,24 @@ If you need ***"NAND"*** or ***"NOR"*** gate, just put an **InvertUltimate** nod
 
 The node can have a persistent input: the input values are retained after a node-red reboot. That means, that if you reboot your node-red, you don't need to wait all inputs to arrive and initialize the node, before the node can output a payload.<br/>
 You can also set the default values of the topic inputs.<br/>
-The node can convert arbitrary input values to true/false. It supports Homeassistant ***"on"*** and ***"off"*** as well. For enabling auto conversion, please be sure to disable **Reject non boolean (true/false) input values** <br/>
-
-
-
-### CONFIGURATION
-
-
-**Inputs count**
-
-Set the number of different topics to be evaluated. The node will output a message to the flow, after this number of *different* topics arrives.<br/>
-*Remember: each input topic must be different. For example, if you set this field to 3, the node expects 3 different topics.*
-
-
-**Filter output**
-
-- Output both 'true' and 'false' results: Standard behaviour, the node will output <b>true</b> and <b>false</b> whenever it receives an input and calculate the boolean logics as output.
-- Output only 'true' results: whenever the node receives an input, it outputs a payload <b>true</b> only if the result of the logic is true. <b>False</b> results are filtered out.
-
-**Trigger mode**
-
-- All topics: standard behaviour, the node will evaluate each input topic and ouputs the values. At each input change, it will output a msg on the flow.
-- Single topic + eval other inputs: the node evaluates all the input topics, but only whenever it receives a msg input with the **specified topic**, it  outputs a msg to the flow.
+The node can convert arbitrary input values to true/false. It supports Homeassistant string to boolean conversion as well. For enabling auto conversion, please be sure to disable **Reject non boolean (true/false) input values** <br/>
 
-**If input states are undefined**
 
-Every time you create a node or modify the node, all inputs are set to undefined. This means that the node will wait the arrive of all topics (for example 3 topics, if you've selected 3 topics in the option), before it can output a payload. This can be a problem if your logic must be operative as soon as you deploy the flow. To overcome this problem, you can "initialize" all the undefined inputs with True or False.
-- Leave undefined: Standard behaviour, the node will wait all the "undefined" topics to arrive, then starts a flow with the result.
-- True or False: The node is immediately operative, by force the initialization of the "undefined" inputs with "true" or "false".
 
-**Remember latest input values after reboot**
+### NODE CONFIGURATION
 
-If checked, the input values are retained after a node-red reboot. That means, that if you reboot your node-red, you don't need to wait all inputs to arrive and initialize the node, before the node can output a payload.<br/>
-Every time you modify the node's config, <b>the retained values are cleared</b>.<br/>
+|Property|Description|
+|--|--|
+| Inputs count | Set the number of different topics to be evaluated. The node will output a message to the flow, after this number of *different* topics arrives. *Remember: each input topic must be different. For example, if you set this field to 3, the node expects 3 different topics.* |
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+| Filter output | **Output both 'true' and 'false'** results: Standard behaviour, the node will output <b>true</b> and <b>false</b> whenever it receives an input and calculate the boolean logics as output. **Output only 'true'** results: whenever the node receives an input, it outputs a payload <b>true</b> only if the result of the logic is true. <b>False</b> results are filtered out. |
+| Trigger mode | **All topics**: standard behaviour, the node will evaluate each input topic and ouputs the values. At each input change, it will output a msg on the flow. **Single topic + eval other inputs**: the node evaluates all the input topics, but only whenever it receives a msg input with the **specified topic**, it  outputs a msg to the flow.|
+| If input states are undefined | Every time you create a node or modify the node, all inputs are set to undefined. This means that the node will wait the arrive of all topics (for example 3 topics, if you've selected 3 topics in the option), before it can output a payload. This can be a problem if your logic must be operative as soon as you deploy the flow. To overcome this problem, you can "initialize" all the undefined inputs with True or False. **Leave undefined**: Standard behaviour, the node will wait all the "undefined" topics to arrive, then starts a flow with the result. **True or False**: The node is immediately operative, by force the initialization of the "undefined" inputs with "true" or "false".|
+| Remember latest input values after reboot | If checked, the input values are retained after a node-red reboot. That means, that if you reboot your node-red, you don't need to wait all inputs to arrive and initialize the node, before the node can output a payload. Every time you modify the node's config, <b>the retained values are cleared</b>.|
+| Reject non boolean (true/false) input values | If checked, the node will accept only boolean true/false values. Otherwise, it will try to convert the payload value to a logic true/false boolean. |
+| Delay evaluation (ms) | Delays the evaluation until this time (in milliseconds) is elapsed. Each time a message or "topic trigger message" (see **Trigger mode**) arrives, the delay is restarted. This option is useful for debouncing pourposes or simply for adding some delay. For example, you can turn on a light if the room is occupied for a long time, allowing people to fast transit repeatedly, without the need of turning the light on. Another example, if you have many sensors changing state rapidly, you can wait until these sensor reach a quiet state, then evaluate the inputs.|
 
-**Reject non boolean (true/false) input values**
-
-If checked, the node will accept only boolean true/false values. Otherwise, it will try to convert the payload to a logic value true/false (including "on" and "off" values, sent, for example, from HomeAssistant).<br/>
-
-**Delay evaluation (ms)**
-
-Delays the evaluation until this time (in milliseconds) is elapsed. Each time a message or "topic trigger message" (see **Trigger mode**) arrives, the delay is restarted.<br/>
-This option is useful for debouncing pourposes or simply for adding some delay.<br/>
-For example, you can turn on a light if the room is occupied for a long time, allowing people to fast transit repeatedly, without the need of turning the light on.<br/>
-Another example, if you have many sensors changing state rapidly, you can wait until these sensor reach a quiet state, then evaluate the inputs.<br/>
+<br/>
 
 **INPUT MSG TO THE NODE**
 
@@ -115,17 +109,21 @@ Resets all inputs to undefined.
 
 The interrupt flows is able to stop the input messages to exiting the node.
 
-**Trigger by topic**
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Trigger by topic | Whenever the node receives a payload = false from this topic,it stops output messages to the flow. As soon it receives payload = true from this topic, the output messages start to flow out again. The node will output the current stored message plus an added property "isReplay = true", as soon as it receives a ***msg.play = true*** from this topic. The node will clear the current stored message, as soon as it receives a ***msg.reset = true*** from this topic. |
+| With Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+| Then | This property, allow you to auto toggle the selected start state (pass or block) after a timer has elapsed. You can choose from some pre-defined delays. If you have, for example, an Homekit-Bridged nodeset with a thermostat node or security system node in your flow, once node-red restarts, these homekit nodes output a default message to the flow. Just put an InterruptFlow node with a "block at start" behaviour and a toggle delay enabled behind homekit nodes, to temporary stop the chained nodes to receive the unwanted startup message.|
+
+
+<br/>
+
+
+
 
-Whenever the node receives a payload = false from this topic,it stops output messages to the flow.<br/>
-As soon it receives payload = true from this topic, the output messages start to flow out again. <br/>
-The node will output the current stored message plus an added property "isReplay = true", as soon as it receives a ***msg.play = true*** from this topic.<br/>
-The node will clear the current stored message, as soon as it receives a ***msg.reset = true*** from this topic.<br/>
-The node tries to convert any arbitrary input value to a valid boolean value. It converts Homeassistant ***"on"*** and ***"off"*** to true/false values as well.<br/>
 
-**Then** 
-This property, allow you to auto toggle the selected start state (pass or block) after a timer has elapsed. You can choose from some pre-defined delays. If you have, for example, an Homekit-Bridged nodeset with a thermostat node or security system node in your flow, once node-red restarts, these homekit nodes output a default message to the flow. Just put an InterruptFlow node with a "block at start" behaviour and a toggle delay enabled behind homekit nodes, to temporary stop the chained nodes to receive the unwanted startup message.</br>
-</br>
 
 **INPUT MSG WITH "TRIGGER" TOPIC**
 
@@ -183,7 +181,15 @@ This allow to save the state of a node and then replay it back whenever you want
 
 Outputs the inverted input. For example true -> false<br />
 The input message is preserved and passed to the output pin, changing only the topic and the payload. If the input message has it's own topic, it'll be preserved as well.<br/>
-The node tries to convert any arbitrary input value to a valid boolean value. It converts Homeassistant ***"on"*** and ***"off"*** to true/false values as well.<br/>
+
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+<br/>
+
 
 <br/>
 <br/>
@@ -197,7 +203,15 @@ This node has 2 outputs.<br />
 If the input payload is true, the node will send <code>true</code> on output 1 and nothing on oputput 2<br />
 If the input payload is false, the node will send nothing on output 1, and <code>false</code> on oputput 2<br />
 The input message is preserved and passed to the output pin, changing only the topic and the payload. If the input message has it's own topic, it'll be preserved as well.<br/>
-The node tries to convert any arbitrary input value to a valid boolean value. It converts Homeassistant ***"on"*** and ***"off"*** to true/false values as well.<br/>
+
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+<br/>
+
 
 <br/>
 <br/>
@@ -212,6 +226,15 @@ Output PIN1 : outputs the value true/false<br/>
 Output PIN2 : outputs the inverted value false/true<br/>
 <br/>
 
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+<br/>
+
+
 Pass <code>msg.payload = true</code> to start blinking</br>
 Pass <code>msg.payload = false</code> to stop blinking</br>
 Pass <code>msg.interval = 2000</code> to change the blinking interval</br>
@@ -239,6 +262,15 @@ Pass <code>msg.interval = 2000</code> to change the blinking interval</br>
 The pourpose of this node is to send a message with payload TRUE on the first pin and FALSE on second pin, independently from the msg input.<br />
 This is useful if you need to simply send a true or false payload.
 
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+<br/>
+
+
 <img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/SimpleOutput.png' width='60%'>
 
 <details><summary>CLICK HERE, copy and paste it into your flow</summary>
@@ -304,6 +336,15 @@ The pourpose of this node is to send a sequence of pulsed commands to for exampl
 </code>
 </details>
 
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+<br/>
+
+
 **Avaiable Commands**<br />
 Commands are to be wrote in the format: command:value. For example ***send:200***, ***wait:2000***. Each row represents a command.<br />
 <br /><b>send</b><br />
@@ -332,6 +373,7 @@ Pass <code>msg.payload = false</code> to the node to stop the running sequence</
 
 The pourpose of this node is to do maths on the incoming values. Each incoming message MUST HAVE OWN TOPIC.<br />
 
+
 <img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/sum.png' width='60%'>
 <details><summary>CLICK HERE, copy and paste it into your flow</summary>
 <code>
@@ -339,6 +381,15 @@ The pourpose of this node is to do maths on the incoming values. Each incoming m
 </code>
 </details>
 
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+<br/>
+
+
 **INPUT**<br />
 
 <br /><b>msg.reset</b><br />
@@ -365,8 +416,16 @@ br/>
 
 # TOGGLE ULTIMATE
 
-The pourpose of this node is to toggle between true/false the payload of every incoming message.<br />
+The pourpose of this node is to toggle between true/false, everytime an inboud message arrives.<br />
+
+
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
 
+<br/>
 
 **INPUT**<br />
 
@@ -384,12 +443,17 @@ The railway switcher, switches the input msg flow to one ot the two output pins
 
 <img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/railroadSwitchScambio.png' width='80%'>
 
-**Switcher topic**
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Switcher topic | Whenever the node receives a payload from this **topic**, it switches the input messages to an output PIN. |
+| With Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+| Then | This property, allow you to auto toggle the selected start state after some time. |
 
-Whenever the node receives a payload from this **topic**, it switches the input messages to an output PIN.<br/>
+<br/>
 
-**Then** 
-This property, allow you to auto toggle the selected start state after some time.</br>
+</br>
 </br>
 
 **INPUT MSG WITH "TRIGGER" TOPIC**

package/boolean-logic-ultimate/BlinkerUltimate.html

@@ -8,6 +8,7 @@
 			stopbehaviorPIN2: { value: "0" },
 			blinkfrequency: { value: "500" },
 			initializewith: { value: "0" },
+			payloadPropName: { value: "payload", required: false }
 		},
 		inputs: 1,
 		outputs: 2,
@@ -30,6 +31,10 @@
 			},
 		paletteLabel: function () {
 			return "BlinkerUltimate";
+		},
+		oneditprepare: function () {
+			if ($("#node-input-payloadPropName").val() === "") $("#node-input-payloadPropName").val("payload");
+			$("#node-input-payloadPropName").typedInput({ default: 'msg', types: ['msg'] });
 		}
 	});
 </script>
@@ -45,7 +50,10 @@
         <label for="node-input-name"><i class="icon-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
 	</div>
-	
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> Input</label>
+		<input type="text" id="node-input-payloadPropName">
+    </div>
 	<div class="form-row">
         <label for="node-input-blinkfrequency"><i class="fa fa-clock-o"></i> Blink every (in milliseconds)</label>
 		<input type="text" id="node-input-blinkfrequency" placeholder="Example: 500">

package/boolean-logic-ultimate/BlinkerUltimate.js

@@ -41,9 +41,13 @@ module.exports = function (RED) {
 					setNodeStatus({ fill: "red", shape: "dot", text: "Invalid interval received" });
 				}
 			}
-			if (msg.hasOwnProperty("payload")) {
+
+			const utils = require("./utils.js");
+			let sPayload = utils.fetchFromObject(msg, config.payloadPropName || "payload");
+
+			if (sPayload !== undefined) {
 				// 06/11/2019 
-				if (ToBoolean(msg.payload) === true) {
+				if (utils.ToBoolean(sPayload) === true) {
 					if (node.tBlinker !== null) clearInterval(node.tBlinker);
 					node.tBlinker = setInterval(handleTimer, node.blinkfrequency); //  Start the timer that handles the queue of telegrams
 					node.isBlinking = true;
@@ -68,32 +72,6 @@ module.exports = function (RED) {
 		});
 
 
-		function ToBoolean(value) {
-			let res = false;
-			let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/
-
-			if (typeof value === 'boolean') {
-				res = value;
-			}
-			else if (typeof value === 'number' || typeof value === 'string') {
-
-				if (typeof value === "string" && value.toLowerCase() === "on") return true;
-				if (typeof value === "string" && value.toLowerCase() === "off") return false;
-
-
-				// Is it formated as a decimal number?
-				if (decimal.test(value)) {
-					res = parseFloat(value) != 0;
-				}
-				else {
-					res = value.toLowerCase() === "true";
-				}
-			}
-
-			return res;
-		};
-
-
 		function handleTimer() {
 			node.curPayload = !node.curPayload;
 			node.send([{ payload: node.curPayload }, { payload: !node.curPayload }]);

package/boolean-logic-ultimate/BooleanLogicUltimate.html

@@ -6,6 +6,7 @@
 			name: {
 				value: ""
 			},
+			payloadPropName: { value: "payload", required: false },
 			filtertrue: { value: "both" },
 			persist: { value: true },
 			sInitializeWith: { value: "WaitForPayload" },
@@ -33,7 +34,7 @@
 						return v !== undefined && v.length > 0;
 					}
 			},
-			restrictinputevaluation: { value: true },
+			restrictinputevaluation: { value: false },
 			delayEvaluation: { value: 0 }
 		},
 		inputs: 1,
@@ -77,6 +78,10 @@
 			return "BooleanLogicUltimate";
 		},
 		oneditprepare: function () {
+
+			if ($("#node-input-payloadPropName").val() === "") $("#node-input-payloadPropName").val("payload");
+			$("#node-input-payloadPropName").typedInput({ default: 'msg', types: ['msg'] });
+
 			// Add write and response as default for existing nodes like was default before
 			if (this.outputtriggeredby === 'all') {
 				$("#triggertopic").hide()
@@ -131,6 +136,10 @@
 	<div class="form-row">
         <label for="node-input-name"><i class="icon-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> Input</label>
+		<input type="text" id="node-input-payloadPropName">
     </div>
 	<div class="form-row">
         <label for="node-input-topic"><i class="fa fa-tasks"></i> Topic</label>

package/boolean-logic-ultimate/BooleanLogicUltimate.js

@@ -94,23 +94,27 @@ module.exports = function (RED) {
 				setNodeStatus({ fill: "red", shape: "dot", text: "Received invalid topic!" });
 				return;
 			}
-			// 15/11/2021 inform user about undefined topic or payload
-			if (!msg.hasOwnProperty("payload") || msg.payload === undefined || msg.payload === null) {
-				setNodeStatus({ fill: "red", shape: "dot", text: "Received invalid payload from " + msg.topic || "" });
-				return;
-			}
+
+
+			var topic = msg.topic;
+			const utils = require("./utils.js");
+			let sPayload = utils.fetchFromObject(msg, config.payloadPropName || "payload");
 
 			// 12/08/2021 Restrict only to true/false 
 			if (node.restrictinputevaluation) {
-				if (msg.payload !== true && msg.payload !== false) {
+				if (sPayload !== true && sPayload !== false) {
 					setNodeStatus({ fill: "red", shape: "dot", text: "Received non boolean value from " + msg.topic });
 					return;
 				}
 			}
 
-			var topic = msg.topic;
-			var payload = msg.payload;
-			var value = ToBoolean(payload);
+			var value = utils.ToBoolean(sPayload);
+
+			// 15/11/2021 inform user about undefined topic or payload
+			if (sPayload === undefined) {
+				setNodeStatus({ fill: "red", shape: "dot", text: "Received invalid payload from " + msg.topic || "" });
+				return;
+			}
 
 			// 14/08/2019 if inputs are initialized, remove a "dummy" item from the state's array, as soon as new topic arrives
 			if (node.sInitializeWith !== "WaitForPayload") {
@@ -277,29 +281,7 @@ module.exports = function (RED) {
 			return res;
 		}
 
-		function ToBoolean(value) {
-			let res = false;
-			let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/
-
-			if (typeof value === 'boolean') {
-				res = value;
-			}
-			else if (typeof value === 'number' || typeof value === 'string') {
-
-				if (typeof value === "string" && value.toLowerCase() === "on") return true;
-				if (typeof value === "string" && value.toLowerCase() === "off") return false;
 
-				// Is it formated as a decimal number?
-				if (decimal.test(value)) {
-					res = parseFloat(value) != 0;
-				}
-				else {
-					res = value.toLowerCase() === "true";
-				}
-			}
-
-			return res;
-		};
 
 		function outputResult() {
 			let optionalTopic = node.config.topic;

package/boolean-logic-ultimate/FilterUltimate.html

@@ -5,7 +5,8 @@
 		defaults: {
 			name: {
 				value: "Filter"
-			}
+			},
+			payloadPropName: { value: "payload", required: false }
 		},
 		inputs: 1,
 		outputs: 2,
@@ -29,6 +30,10 @@
 			},
 		paletteLabel: function () {
 			return "FilterUltimate";
+		},
+		oneditprepare: function () {
+			if ($("#node-input-payloadPropName").val() === "") $("#node-input-payloadPropName").val("payload");
+			$("#node-input-payloadPropName").typedInput({ default: 'msg', types: ['msg'] });
 		}
 	});
 </script>
@@ -44,6 +49,10 @@
         <label for="node-input-name"><i class="icon-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> Input</label>
+		<input type="text" id="node-input-payloadPropName">
+    </div>
 </script>
 
 <script type="text/x-red" data-help-name="FilterUltimate">

package/boolean-logic-ultimate/FilterUltimate.js

@@ -13,20 +13,24 @@ module.exports = function (RED) {
 		setNodeStatus({ fill: "grey", shape: "dot", text: "Waiting" });
 		this.on('input', function (msg) {
 
+			const utils = require("./utils.js");
+			let sPayload = utils.fetchFromObject(msg, config.payloadPropName || "payload");
+
 			// 15/11/2021 inform user about undefined topic or payload
-			if (!msg.hasOwnProperty("payload") || msg.payload === undefined || msg.payload === null) {
+			if (sPayload=== undefined ) {
 				setNodeStatus({ fill: "red", shape: "dot", text: "Received invalid payload from " + msg.topic || "" });
 				return;
 			}
 
+			
 			var bRes = null;
 			try {
-				bRes = ToBoolean(msg.payload);
+				bRes = utils.ToBoolean(sPayload);
 			} catch (error) {
 			}
 
 			if (bRes === undefined || bRes === null) {
-				setNodeStatus({ fill: "red", shape: "dot", text: "Received non convertible boolean value " + msg.payload + " from " + msg.topic });
+				setNodeStatus({ fill: "red", shape: "dot", text: "Received non convertible boolean value " + sPayload + " from " + msg.topic });
 				return;
 			}
 
@@ -44,31 +48,6 @@ module.exports = function (RED) {
 
 		});
 
-
-
-		function ToBoolean(value) {
-			let res = false;
-			let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/
-
-			if (typeof value === 'boolean') {
-				res = value;
-			}
-			else if (typeof value === 'number' || typeof value === 'string') {
-
-				if (typeof value === "string" && value.toLowerCase() === "on") return true;
-				if (typeof value === "string" && value.toLowerCase() === "off") return false;
-
-				// Is it formated as a decimal number?
-				if (decimal.test(value)) {
-					res = parseFloat(value) != 0;
-				}
-				else {
-					res = value.toLowerCase() === "true";
-				}
-			}
-
-			return res;
-		};
 	}
 
 

package/boolean-logic-ultimate/ImpulseUltimate.html

@@ -5,6 +5,7 @@
 		defaults: {
 			name: { value: "" },
 			commandText: { value: "// Open garage door\nsend:true\nwait:1000\nsend:false" },
+			payloadPropName: { value: "payload", required: false }
 		},
 		inputs: 1,
 		outputs: 1,
@@ -30,6 +31,8 @@
 				mode: 'ace/mode/text',
 				value: node.commandText
 			});
+			if ($("#node-input-payloadPropName").val() === "") $("#node-input-payloadPropName").val("payload");
+			$("#node-input-payloadPropName").typedInput({ default: 'msg', types: ['msg'] });
 		},
 		oneditsave: function () {
 			var node = this;
@@ -57,6 +60,10 @@
 	<div class="form-row">
         <label for="node-input-name"><i class="icon-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> Input</label>
+		<input type="text" id="node-input-payloadPropName">
     </div>
 	<div class="form-row" >
         <label style="width:300px;" for="node-input-commandText"><i class="fa fa-tasks"></i> Commands (one command per row)</label>

package/boolean-logic-ultimate/ImpulseUltimate.js

@@ -90,15 +90,18 @@ module.exports = function (RED) {
 		}
 
 		this.on('input', function (msg) {
+			
+			const utils = require("./utils.js");
+			let sPayload = utils.fetchFromObject(msg, config.payloadPropName || "payload");
 
-			if (msg.payload === true) {
+			if (sPayload === true) {
 				if (node.isPlaying) {
 					node.setNodeStatus({ fill: "yellow", shape: "ring", text: "Already running. Stop me first." });
 					return;
 				}
 				avvio();
 
-			} else if (msg.payload === false) {
+			} else if (sPayload === false) {
 				if (node.timerWait !== null) clearTimeout(node.timerWait);
 				node.isPlaying = false;
 				node.setNodeStatus({ fill: "red", shape: "dot", text: "Forced stop" });

package/boolean-logic-ultimate/InterruptFlowUltimate.html

@@ -6,7 +6,8 @@
 			name: { value: "Interrupt Flow" },
 			triggertopic: { value: "trigger" },
 			initializewith: { value: "1" },
-			autoToggle: { value: "0" }
+			autoToggle: { value: "0" },
+			payloadPropName: { value: "payload", required: false }
 		},
 		inputs: 1,
 		outputs: 1,
@@ -30,6 +31,10 @@
 			},
 		paletteLabel: function () {
 			return "InterruptFlowUltimate";
+		},
+		oneditprepare: function () {
+			if ($("#node-input-payloadPropName").val() === "") $("#node-input-payloadPropName").val("payload");
+			$("#node-input-payloadPropName").typedInput({ default: 'msg', types: ['msg'] });
 		}
 	});
 </script>
@@ -45,16 +50,19 @@
         <label for="node-input-name"><i class="icon-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
 	</div>
-	
 	<div class="form-row">
         <label for="node-input-triggertopic"><i class="icon-tag"></i> Trigger by topic</label>
 		<input type="text" id="node-input-triggertopic" placeholder="Name">
-		<div><i>Whenever the node receives a payload = false from this topic,<br/> it stops output messages to the flow.<br/>As soon it receives payload = true from this topic,<br/>the output messages start to flow out again.
+    </div>
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> With Input</label>
+		<input type="text" id="node-input-payloadPropName">
+    </div>
+	<div><i>Whenever the node receives a msg with false from this topic,<br/> it stops output messages to the flow.<br/>As soon it receives a message with true from this topic,<br/>the output messages start to flow out again.
 		<br/>The node will output the current stored message<br/>plus an added property "isReplay = true",<br/>as soon as it receives a "play" = true from this topic.</br>
 		The node will clear the current stored message, as soon as it receives a "msg.reset = true" from this topic.
 	</i></div>
-    </div>
-
+<br/>
 	<div class="form-row">
         <label style="width:160px" for="node-input-initializewith"><i class="fa fa-home"></i> At node-red start</label>
         <select type="text" id="node-input-initializewith" placeholder="">

package/boolean-logic-ultimate/InterruptFlowUltimate.js

@@ -43,13 +43,14 @@ module.exports = function (RED) {
 				sIncomingTopic = msg.topic.replace(/[`~!@#$%^&*()_|+\-=?;:'",.<>\{\}\[\]\\\/]/gi, ''); // Cut unwanted Characters
 				if (sIncomingTopic === node.sTriggerTopic) {
 
+					const utils = require("./utils.js");
+					let sPayload = utils.fetchFromObject(msg, config.payloadPropName || "payload");
 					// 15/11/2021 inform user about undefined topic or payload
-					if (!msg.hasOwnProperty("payload") || msg.payload === undefined || msg.payload === null) {
+					if (sPayload === undefined ) {
 						setNodeStatus({ fill: "red", shape: "dot", text: "Received invalid payload from " + msg.topic || "" });
 						return;
 					}
-
-					msg.payload = ToBoolean(msg.payload); // 15/11/2021 Convert input to boolean.
+					msg.payload = utils.ToBoolean(sPayload); // 15/11/2021 Convert input to boolean.
 
 					// 28/01/2022 Stop autotoggle
 					if (node.timerAutoToggle !== null) clearInterval(node.timerAutoToggle);
@@ -93,31 +94,6 @@ module.exports = function (RED) {
 		});
 
 
-
-
-		function ToBoolean(value) {
-			let res = false;
-			let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/
-
-			if (typeof value === 'boolean') {
-				res = value;
-			}
-			else if (typeof value === 'number' || typeof value === 'string') {
-
-				if (typeof value === "string" && value.toLowerCase() === "on") return true;
-				if (typeof value === "string" && value.toLowerCase() === "off") return false;
-
-				// Is it formated as a decimal number?
-				if (decimal.test(value)) {
-					res = parseFloat(value) != 0;
-				}
-				else {
-					res = value.toLowerCase() === "true";
-				}
-			}
-
-			return res;
-		};
 	}
 
 

package/boolean-logic-ultimate/InvertUltimate.html

@@ -5,7 +5,8 @@
         defaults: {
 			name: { 
 				value: "Invert"
-			}			
+			},
+			payloadPropName: { value: "payload", required: false }			
         },
         inputs:1,
         outputs:1,
@@ -16,6 +17,10 @@
 			},
 		paletteLabel: function() {
 			return "InvertUltimate";
+		},
+		oneditprepare: function () {
+			if ($("#node-input-payloadPropName").val() === "") $("#node-input-payloadPropName").val("payload");
+			$("#node-input-payloadPropName").typedInput({ default: 'msg', types: ['msg'] });
 		}
     });
 </script>
@@ -31,6 +36,10 @@
         <label for="node-input-name"><i class="icon-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
     </div>
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> Input</label>
+		<input type="text" id="node-input-payloadPropName">
+    </div>
 </script>
 
 <script type="text/x-red" data-help-name="InvertUltimate">

package/boolean-logic-ultimate/InvertUltimate.js

@@ -15,21 +15,23 @@ module.exports = function (RED) {
 		this.on('input', function (msg) {
 
 
+			// 11/11/2021 Clone input message and replace only relevant topics
+			const utils = require("./utils.js");
+			let sPayload = utils.fetchFromObject(msg, config.payloadPropName || "payload");
+
 			// 15/11/2021 inform user about undefined topic or payload
-			if (!msg.hasOwnProperty("payload") || msg.payload === undefined || msg.payload === null) {
+			if (sPayload === undefined ) {
 				setNodeStatus({ fill: "red", shape: "dot", text: "Received invalid payload from " + msg.topic || "" });
 				return;
 			}
 
-
-			// 11/11/2021 Clone input message and replace only relevant topics
 			var bRes = null;
 			try {
-				bRes = ToBoolean(msg.payload);
+				bRes = utils.ToBoolean(sPayload);
 			} catch (error) {
 			}
 			if (bRes === undefined || bRes === null) {
-				setNodeStatus({ fill: "red", shape: "dot", text: "Received non convertible boolean value " + msg.payload + " from " + msg.topic });
+				setNodeStatus({ fill: "red", shape: "dot", text: "Received non convertible boolean value " + sPayload + " from " + msg.topic });
 				return;
 			}
 
@@ -44,34 +46,6 @@ module.exports = function (RED) {
 
 		});
 
-
-
-		function ToBoolean(value) {
-			let res = false;
-			let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/
-
-			if (typeof value === 'boolean') {
-				res = value;
-			}
-			else if (typeof value === 'number' || typeof value === 'string') {
-
-				if (typeof value === "string" && value.toLowerCase() === "on") return true;
-				if (typeof value === "string" && value.toLowerCase() === "off") return false;
-
-				// Is it formated as a decimal number?
-				if (decimal.test(value)) {
-					res = parseFloat(value) != 0;
-				}
-				else {
-					res = value.toLowerCase() === "true";
-				}
-			}
-
-			return res;
-		};
-
-
-
 	}
 
 

package/boolean-logic-ultimate/RailwaySwitchUltimate.html

@@ -6,7 +6,8 @@
 			name: { value: "Railway Switch" },
 			triggertopic: { value: "trigger" },
 			initializewith: { value: "0" },
-			autoToggle: { value: "0" }
+			autoToggle: { value: "0" },
+			payloadPropName: { value: "payload", required: false }
 		},
 		inputs: 1,
 		outputs: 2,
@@ -30,6 +31,10 @@
 			},
 		paletteLabel: function () {
 			return "RailwaySwitchUltimate";
+		},
+		oneditprepare: function () {
+			if ($("#node-input-payloadPropName").val() === "") $("#node-input-payloadPropName").val("payload");
+			$("#node-input-payloadPropName").typedInput({ default: 'msg', types: ['msg'] });
 		}
 	});
 </script>
@@ -49,12 +54,16 @@
 	<div class="form-row">
         <label for="node-input-triggertopic"><i class="icon-tag"></i> Switcher topic</label>
 		<input type="text" id="node-input-triggertopic" placeholder="Name">
-		<div><i>An input msg having this topic and payload true or false<br/>will trigger the railway switch between the two output PINs<br/>
-			msg.payload = false switches to the upper PIN<br/>
-			msg.payload = true switches to the lower PIN<br/>
-		</i></div>
     </div>
-
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> With Input</label>
+		<input type="text" id="node-input-payloadPropName">
+    </div>
+	<div><i>An input msg having this topic and msg true or false<br/>will trigger the railway switch between the two output PINs<br/>
+		false switches to the upper PIN<br/>
+		true switches to the lower PIN<br/>
+	</i></div>
+	<br/>
 	<div class="form-row">
         <label style="width:160px" for="node-input-initializewith"><i class="fa fa-home"></i> At node-red start</label>
         <select type="text" id="node-input-initializewith" placeholder="" style="width:250px">

package/boolean-logic-ultimate/RailwaySwitchUltimate.js

@@ -41,13 +41,17 @@ module.exports = function (RED) {
 				sIncomingTopic = msg.topic.replace(/[`~!@#$%^&*()_|+\-=?;:'",.<>\{\}\[\]\\\/]/gi, ''); // Cut unwanted Characters
 				if (sIncomingTopic === node.sTriggerTopic) {
 
+
+					const utils = require("./utils.js");
+					let sPayload = utils.fetchFromObject(msg, config.payloadPropName || "payload");
+					
 					// 15/11/2021 inform user about undefined topic or payload
-					if (!msg.hasOwnProperty("payload") || msg.payload === undefined || msg.payload === null) {
+					if (sPayload === undefined ) {
 						setNodeStatus({ fill: "red", shape: "dot", text: "Received invalid payload from " + msg.topic || "" });
 						return;
 					}
-
-					msg.payload = ToBoolean(msg.payload); // 15/11/2021 Convert input to boolean.
+					
+					msg.payload = utils.ToBoolean(sPayload); // 15/11/2021 Convert input to boolean.
 
 					// 28/01/2022 Stop autotoggle
 					if (node.timerAutoToggle !== null) clearInterval(node.timerAutoToggle);
@@ -70,32 +74,6 @@ module.exports = function (RED) {
 			}
 		});
 
-
-
-
-		function ToBoolean(value) {
-			let res = false;
-			let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/
-
-			if (typeof value === 'boolean') {
-				res = value;
-			}
-			else if (typeof value === 'number' || typeof value === 'string') {
-
-				if (typeof value === "string" && value.toLowerCase() === "on") return true;
-				if (typeof value === "string" && value.toLowerCase() === "off") return false;
-
-				// Is it formated as a decimal number?
-				if (decimal.test(value)) {
-					res = parseFloat(value) != 0;
-				}
-				else {
-					res = value.toLowerCase() === "true";
-				}
-			}
-
-			return res;
-		};
 	}
 
 

package/boolean-logic-ultimate/SumUltimate.html

@@ -23,7 +23,11 @@
             },
         paletteLabel: function () {
             return "MathUltimate";
-        }
+        },
+		oneditprepare: function () {
+			if ($("#node-input-property").val() === "") $("#node-input-property").val("payload");
+			$("#node-input-property").typedInput({ default: 'msg', types: ['msg'] });
+		}
     });
 </script>
 
@@ -39,7 +43,7 @@
         <input type="text" id="node-input-name" placeholder="Topic">
     </div>
     <div class="form-row">
-        <label for="node-input-property"><i class="icon-tag"></i> Use msg.</label>
+        <label for="node-input-property"><i class="icon-tag"></i> Input</label>
         <input type="text" id="node-input-property" placeholder="payload">
     </div>
     <div class="form-row">

package/boolean-logic-ultimate/toggleUltimate.html

@@ -6,7 +6,8 @@
 			name: {
 				value: "Toggle"
 			},
-			valueToToggle: { value: "true" }
+			valueToToggle: { value: "true" },
+			payloadPropName: { value: "payload", required: false }
 		},
 		inputs: 1,
 		outputs: 1,
@@ -17,6 +18,10 @@
 			},
 		paletteLabel: function () {
 			return "toggleUltimate";
+		},
+		oneditprepare: function () {
+			if ($("#node-input-payloadPropName").val() === "") $("#node-input-payloadPropName").val("payload");
+			$("#node-input-payloadPropName").typedInput({ default: 'msg', types: ['msg'] });
 		}
 	});
 </script>
@@ -31,6 +36,10 @@
     <div class="form-row">
         <label for="node-input-name"><i class="icon-tag"></i> Name</label>
         <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> Input</label>
+		<input type="text" id="node-input-payloadPropName">
     </div>
 	<div class="form-row">
 		<label style="width:160px" for="node-input-valueToToggle"><i class="fa fa-toggle-on"></i> Initial value</label>

package/boolean-logic-ultimate/toggleUltimate.js

@@ -3,7 +3,8 @@ module.exports = function (RED) {
 		RED.nodes.createNode(this, config);
 		this.config = config;
 		var node = this;
-		node.valueToToggle = config.valueToToggle === undefined ? true : ToBoolean(config.valueToToggle);
+		const utils = require("./utils.js");
+		node.valueToToggle = config.valueToToggle === undefined ? true : utils.ToBoolean(config.valueToToggle);
 
 		function setNodeStatus({ fill, shape, text }) {
 			let dDate = new Date();
@@ -14,9 +15,11 @@ module.exports = function (RED) {
 
 		this.on('input', function (msg) {
 
+			const utils = require("./utils.js");
+			let sPayload = utils.fetchFromObject(msg, config.payloadPropName || "payload");
 
 			// 15/11/2021 inform user about undefined topic or payload
-			if (!msg.hasOwnProperty("payload") || msg.payload === undefined || msg.payload === null) {
+			if (sPayload === undefined ) {
 				setNodeStatus({ fill: "red", shape: "dot", text: "Received invalid payload from " + msg.topic || "" });
 				return;
 			}
@@ -35,33 +38,6 @@ module.exports = function (RED) {
 		});
 
 
-
-		function ToBoolean(value) {
-			let res = false;
-			let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/
-
-			if (typeof value === 'boolean') {
-				res = value;
-			}
-			else if (typeof value === 'number' || typeof value === 'string') {
-
-				if (typeof value === "string" && value.toLowerCase() === "on") return true;
-				if (typeof value === "string" && value.toLowerCase() === "off") return false;
-
-				// Is it formated as a decimal number?
-				if (decimal.test(value)) {
-					res = parseFloat(value) != 0;
-				}
-				else {
-					res = value.toLowerCase() === "true";
-				}
-			}
-
-			return res;
-		};
-
-
-
 	}
 
 

package/boolean-logic-ultimate/utils.js

@@ -0,0 +1,45 @@
+module.exports.ToBoolean = function ToBoolean(value) {
+    let res = false;
+    let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/
+
+    if (typeof value === 'boolean') {
+        return value;
+    } else if (typeof value === 'string') {
+
+        if (value.toLowerCase() === "on") return true;
+        if (value.toLowerCase() === "off") return false;
+
+        if (value.toLowerCase() === "active") return true;
+        if (value.toLowerCase() === "inactive") return false;
+
+        if (value.toLowerCase() === "open") return true;
+        if (value.toLowerCase() === "closed") return false;
+        if (value.toLowerCase() === "close") return false;
+
+        if (value.toLowerCase() === "1") return true;
+        if (value.toLowerCase() === "0") return false;
+
+        if (value.toLowerCase() === "true") return true;
+        if (value.toLowerCase() === "false") return false;
+
+    } else if (typeof value === 'number') {
+        // Is it formated as a decimal number?
+        if (decimal.test(value)) {
+            res = parseFloat(value) != 0;
+        }
+        else {
+            res = value.toLowerCase() === "true";
+        }
+        return res;
+    }
+};
+
+module.exports.fetchFromObject = function fetchFromObject(_msg, _payloadPropName) {
+    // The output cannot be an oblect. In case, return undefined.
+    var _index = _payloadPropName.indexOf('.')
+    if (_index > -1) {
+        return fetchFromObject(_msg[_payloadPropName.substring(0, _index)], _payloadPropName.substr(_index + 1));
+    }
+    if (typeof _msg[_payloadPropName] === "object") return undefined;
+    return _msg[_payloadPropName];
+};

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "node-red-contrib-boolean-logic-ultimate",
-    "version": "1.0.53",
-    "description": "A set of Node-RED enhanced boolean logic and utility nodes, flow interruption, blinker, invert, filter, toggle etc.., with persistent values after reboot. Compatible also with Homeassistant ON and OFF values.",
+    "version": "1.0.56",
+    "description": "A set of Node-RED enhanced boolean logic and utility nodes, flow interruption, blinker, invert, filter, toggle etc.., with persistent values after reboot. Compatible also with Homeassistant values.",
     "author": "Supergiovane (https://github.com/Supergiovane)",
     "dependencies": {
         "fs": "0.0.1-security",