node-red-contrib-teamogy-api 0.0.1

package/README.md

@@ -0,0 +1,99 @@
+# Teamogy API Node
+
+Node for connecting to the Teamogy API.
+
+## Connection Configuration
+
+You must configure a Connection before using this node.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| Name | string | Optional | You can enter a name or it will be generated on first save |
+| Subdomain | string | Required | Enter the name of the subdomain and the domain, in the format: subdomain.domain.com |
+| Unit/Agency | number | Required | Enter the number of unit or agency |
+| Token | string | Required | Enter the generated API token for the given subdomain and Unit/Agency |
+| Req/min | number | Required | Enter the maximum number of API requests per minute for the given subdomain, if the limit is greater than allowed, further requests will be rejected (not processed) |
+
+## Input
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| Name | string | Optional | You can enter a name for the given node (recommended) |
+| Connection | selection - list | Required | Select the configured connection |
+| Request views | checkbox - yes/no | Required | Check for requests for API views (see description below) |
+| Token | selection - list | Required | Select the desired entity |
+| Req/min | selection - list | Required | Select an available method |
+| Source | selection - list | Required | The parameters or even the request body can be static, i.e. from the Params and Body fields in the form, or dynamic as part of the input message |
+| Source of body | string | Required | The parameter set the source of the body, default is msg.payload |
+| Params | string \| object | Optional | You can enter the params in the case of a static request as a string, in the case of a dynamic also as an object, according to the API specification for the given entity |
+| Body | JSON string \| object | Optional | You can enter the body in the case of a static request as a JSON string, in the case of a dynamic also as an object, you can nest objects and arrays in the body without restrictions according to the API specification for the given entity |
+| Merge | checkbox - yes/no | Optional | Check if you want the output message to contain all returned records. In the background, processing is still taking place according to the Paging settings, but individual messages are not sent to the output, but only the final merged one containing all the returned records. (if not specified the value no is used) |
+| Limit | number | Optional | Limitation of the total number of records in the response (if not specified, the value 0 is used, the value 0 means no limit) |
+| Paging | number | Optional | Division of responses into multiple parts with the number of records returned (if not specified, the value 1000 is used) |
+| Offset | number | Optional | Determining from which records to return, e.g. if you have a total of 100 records and want to return records 50-100, set Offset to 50, if you want to return all records leave the option at 0 (if not specified, the value 0 is used) |
+| Skip | boolean | Optional, in message only | Adding the msg.skip=true will allow the message to pass through to the output without processing |
+
+## Examples
+
+### Static Request Examples
+
+Enter the desired values according to the selected entity and method in the Params field. Values for Params are listed on separate lines:
+
+```
+id=3
+registration=12345678
+```
+
+For API views:
+
+```
+columns=firstName,lastName
+externalFilter=id>5
+```
+
+For Body field (JSON):
+
+```json
+{
+  "id": 3,
+  "registration": 12345678
+}
+```
+
+### Dynamic Request Examples
+
+For API views, as string:
+```
+id=2&name=John
+```
+
+Or as an object:
+```javascript
+msg.params.id = 2
+msg.params.name = "John"
+```
+
+For Body, as JSON string:
+```json
+{"id": 3, "name": "John"}
+```
+
+Or as an object:
+```javascript
+msg.body.id = 2
+msg.body.name = "John"
+msg.body.address = addresses // array of objects
+```
+
+## Output
+
+| Property | Type | Description |
+|----------|------|-------------|
+| payload | string \| object | The standard output or error of the response |
+| count | number | Number of records in the output |
+| msg.* | string \| object | All properties of the input message |
+
+## References
+
+- [Teamogy Flow docs](https://teamogy.com/teamogy-flow) - full description of Teamogy Flow
+- [Teamogy API docs](https://readme.teamogy.com/reference/integration-options) - full description of parameters for `msg.params` and `msg.body` properties, and also options for API views

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "node-red-contrib-teamogy-api",
+  "version": "0.0.1",
+  "description": "",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+        "node-red",
+        "teamogy",
+        "api"
+   ],
+   "repository": {
+        "type": "git",
+        "url": "https://github.com/teamogy-team/node-red-nodes"
+   },
+  "author": "",
+  "license": "",
+  "node-red": {
+    "nodes": {
+      "teamogy-client": "teamogy-client.js"
+    }
+  },
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  }
+}

package/teamogy-client.html

@@ -0,0 +1,596 @@
+<script type="text/javascript">
+   let requests = `[
+     {"v":"r_companies", "e":"Contacts", "m":["GET","POST","PATCH"]},
+     {"v":"r_documents", "e":"Documents", "m":["GET","POST","PATCH"]},
+	 {"v":"r_jobs", "e":"Jobs", "m":["GET","POST","PATCH"]},
+	 {"v":"r_tasks", "e":"Tasks", "m":["GET","POST","PATCH"]},
+	 {"v":"r_time", "e":"Time", "m":["POST"]},
+     {"v":"r_users", "e":"Users", "m":["GET","POST"]}
+   ]`;
+   
+   let values1 = JSON.parse(requests)
+   
+   let views = `[
+     {"v":"v_binders", "e":"Binders", "m":["GET"]},
+     {"v":"v_brands", "e":"Brands", "m":["GET"]},
+     {"v":"v_cashboxes", "e":"Cashboxes", "m":["GET"]},
+	 {"v":"v_companies", "e":"Companies", "m":["GET"]},
+	 {"v":"v_companies-client", "e":"Companies - client", "m":["GET"]},
+	 {"v":"v_companies-supplier", "e":"Companies - supplier", "m":["GET"]},
+	 {"v":"v_documents", "e":"Documents", "m":["GET"]},
+	 {"v":"v_documents-order-purchase", "e":"Documents order - purchase", "m":["GET"]},
+	 {"v":"v_documents-quotation-sales", "e":"Documents quotation - sales", "m":["GET"]},
+	 {"v":"v_gems", "e":"Gems", "m":["GET"]},
+	 {"v":"v_groups", "e":"Groups", "m":["GET"]},
+	 {"v":"v_internals-purchase", "e":"Internals - purchase", "m":["GET"]},
+	 {"v":"v_internals-sales", "e":"Internals - sales", "m":["GET"]},
+	 {"v":"v_intervals-absence", "e":"Intervals - absence", "m":["GET"]},
+	 {"v":"v_intervals-attendance", "e":"Intervals - attendance", "m":["GET"]},
+	 {"v":"v_intervals-track", "e":"Intervals - track", "m":["GET"]},
+	 {"v":"v_invoices-purchase", "e":"Invoices - purchase", "m":["GET"]},
+	 {"v":"v_invoices-sales", "e":"Invoices - sales", "m":["GET"]},
+	 {"v":"v_jobs", "e":"Jobs", "m":["GET"]},
+	 {"v":"v_journal", "e":"Journal", "m":["GET"]},
+	 {"v":"v_overheads-client", "e":"Overheads - client", "m":["GET"]},
+	 {"v":"v_overheads-internal", "e":"Overheads. - internal", "m":["GET"]},
+	 {"v":"v_opportunities", "e":"Opportunities", "m":["GET"]},
+	 {"v":"v_persons", "e":"Persons", "m":["GET"]},
+	 {"v":"v_tasks", "e":"Tasks", "m":["GET"]},
+	 {"v":"v_users", "e":"Users", "m":["GET"]}
+	]`;
+   
+	let values2 = JSON.parse(views)
+   
+	function decodeJwt(token) {
+		try {
+			return JSON.parse(atob(token.split(".")[1]));
+		} catch (e) {
+			return null;
+		}
+	}
+
+</script>
+
+<script type="text/x-red" data-template-name="teamogy-config">
+  
+  <div class="form-row">
+    <label for="node-config-input-name"><i class="fa fa-tag"></i><span>Name</span></label>
+    <input type="text" id="node-config-input-name" placeholder="name">
+  </div>
+  
+  <div class="form-row">
+    <ul style="min-width: 600px; margin-bottom: 20px;" id="config-tabs"></ul>
+  </div>
+  
+  <div id="config-tabs-content" style="min-height: 170px;">
+   
+   <div id="config-tab-config" style="display: none;">
+      
+	  <div class="form-row">
+        <label for="node-config-input-host"><i class="fa fa-server"></i> <span>Domain</span></label>
+        <input type="text" id="node-config-input-host" placeholder="subdomain.teamogy.com">
+	  </div>
+	  
+	  <div class="form-row">
+        <label for="node-config-input-unit"><i class="fa fa-square-o"></i> <span>Unit/Agency</span></label>
+        <input type="number" id="node-config-input-unit" min="1" max="100" step="1" placeholder="1" style="width: 20%">
+      </div>
+	  
+      <div class="form-row">
+        <label for="node-config-input-token"><i class="fa fa-lock"></i> <span>Token</span></label>
+        <input type="password" id="node-config-input-token" placeholder="token">
+      </div>
+	  
+ 	  <div class="form-row">
+	  <label for="node-config-input-tokendata" style="vertical-align: top;"><i class="fa fa-lock"></i> <span>Token data</span></label>
+	  <label id="node-config-label-tokendata" style="width: 50%"></label>
+	  <input type="hidden" id="node-config-input-tokendata" placeholder="">
+      </div>
+	  
+      <div class="form-row">
+        <label for="node-config-input-apilimit"><i class="fa fa-step-forward"></i> <span>Req/min</span></label>
+        <input type="number" id="node-config-input-apilimit" min="1" max="1000" step="1" placeholder="60" style="width: 20%">
+      </div>
+	  
+    </div>
+	   
+  </div>
+</script>
+
+<script type="text/javascript">
+RED.nodes.registerType('teamogy-config', {
+	category: "config",
+	color: "#fe4c00",
+	defaults: {
+		name: {
+			value: ""
+		},
+		host: {
+			value: "",
+			required: true
+		},
+		unit: {
+			value: 1,
+			required: true
+		},
+		tokendata: {
+			value: "dfgd",
+			required: false
+		},
+		apilimit: {
+			value: 60,
+			required: true
+		}
+	},
+	credentials: {
+		token: {
+			type: "password",
+			required: true
+		},
+		required: true
+	},
+	label: function() {
+		if(!this.name) {
+			this.name =   this.host + "/" + this.unit;
+		} 
+		return this.name;
+	},
+	labelStyle: function() {
+		return this.name ? "node_label_italic" : "";
+	},
+	oneditprepare: function() {
+		$('#node-config-label-tokendata').html(this.tokendata);
+		
+		$('#node-config-input-token').on('change', function() {
+
+			if($(this).val() != '__PWRD__') {
+				
+				let pt = decodeJwt($('#node-config-input-token').val())
+				
+				if(pt == null) {
+					$('#node-config-label-tokendata').html('Invalid token format')
+					$('#node-config-input-tokendata').val('Invalid token format')
+				} else {
+					pt.iat = new Date(pt.iat * 1000).toISOString()
+
+					let rt = ''
+					$.each(pt, function( key, value ) {
+						rt = rt + key + ": " + value + '<br>'
+					});
+
+					$('#node-config-label-tokendata').html(rt)
+					$('#node-config-input-tokendata').val(rt)
+				}
+			}
+
+		})
+		
+		$('#node-config-input-unit').on('change', function() {
+			if(!$.isNumeric($(this).val())) { $(this).val(1) } else {
+				if($(this).val() < 1 || $(this).val() > 100 ) { $(this).val(1) } 
+			}
+		})
+	
+		$('#node-config-input-apilimit').on('change', function() {
+			if(!$.isNumeric($(this).val())) { $(this).val(60) } else {
+				if($(this).val() < 1 || $(this).val() > 1000 ) { $(this).val(60) } 
+			}
+		})
+		
+		const tabs = RED.tabs.create({
+			id: "config-tabs",
+			onchange: function(tab) {
+				$("#config-tabs-content").children().hide();
+				$("#" + tab.id).show();
+			}
+		});
+		
+		tabs.addTab({
+			id: "config-tab-config",
+			label: "Connection"
+		});
+	}
+});
+</script>
+
+<style type="text/css">
+    .dynamic-dropdown-row {
+        padding: 6px 0;
+    }
+</style>
+
+<script type="text/x-red" data-template-name="teamogy-client">
+  
+  <div class="form-row">
+    <label for="node-input-name" style="width: 130px"><i class="icon-tag"></i><span>Name</span></label>
+    <input type="text" id="node-input-name" placeholder="name" style="width:65%">
+  </div>
+  
+  <div class="form-row">
+    <ul style="min-width: 600px; margin-bottom: 20px;" id="config-tabs"></ul>
+  </div>
+  
+  <div id="config-tabs-content" style="min-height: 170px;">
+   
+    <div id="config-tab-config" style="display: none;">
+	
+	  <div class="form-row">
+		<label for="node-input-configuration" style="width: 130px"><i class="fa fa-globe"></i><span> Connection</span></label>
+		<input type="text" id="node-input-configuration" style="width:65%">
+	  </div>
+	  
+	  <div class="form-row">
+		<label for="node-input-mode" style="width: 130px"><i class="fa fa-globe"></i> <span>Request views</span></label>
+		<input type="checkbox" id="node-input-mode" style=" width:20px;">
+	  </div>
+	  
+	  <div class="form-row">
+		<label for="node-input-entity" style="width: 130px"><i class="fa fa-caret-down"></i> Select entity</label>
+		<select id="node-input-entity" style="width:65%">
+		</select>
+	  </div>
+	  
+	  <div class="form-row">
+		<label for="node-input-method" style="width: 130px"><i class="fa fa-caret-down"></i> Select method</label>
+		<select id="node-input-method" style="width:65%">
+		</select>
+	  </div>
+
+	  <div class="form-row">
+		<label for="node-input-source" style="width: 130px"><i class="fa fa-caret-down"></i> Source</label>
+		<select id="node-input-source" style='width:65%'>
+		  <option value="static">Static command</option>
+		  <option value="dynamic">Dynamic from message </option>
+		</select>
+	  </div>
+	  
+	  <div class="form-row" id="node-row-editor">
+		<div class="form-row">
+		  <label for="node-input-params" style="width: 130px"><i class="fa fa-code"></i> Parameters</label>
+		</div>
+		<div class="form-row">
+		  <div style="height: 100px; min-height:100px;" class="node-text-editor" id="node-input-params" style='width:65%'></div>
+		</div>
+		<div class="form-row">
+		  <label for="node-input-body" style="width: 130px"><i class="fa fa-code"></i> Body</label>
+		</div>
+		<div class="form-row">
+		  <div style="height: 100px; min-height:100px;" class="node-text-editor" id="node-input-body" style='width:65%'></div>
+		</div>
+	  </div>
+
+	  <div class="form-row" id="node-row-response-option">
+		<label style="width: 130px"><span>Response option</span></label>
+		<div style="margin-bottom: 10px;"></div>
+		<div class="form-row">
+		  <label for="node-input-merge" style="width: 130px"><i class="fa fa-compress"></i> <span> Merge</span></label>
+		  <input type="checkbox" id="node-input-merge" style=" width:20px;">
+		</div>
+		<div class="form-row">
+		  <label for="node-input-limit" style="width: 130px"><i class="fa fa-step-forward"></i><span> Limit</span></label>
+		  <input type="number" id="node-input-limit"  min="0" step="1" style="width:20%">
+		</div>
+		<div class="form-row">
+		  <label for="node-input-paging" style="width: 130px"><i class="fa fa-eject"></i><span> Paging</span></label>
+		  <input type="number" id="node-input-paging" min="0" max="1000"  step="1" style="width:20%">
+		</div>
+		<div class="form-row">
+		  <label for="node-input-offset" style="width: 130px"><i class="fa fa-forward"></i><span> Offset</span></label>
+		  <input type="number" id="node-input-offset"  min="0" step="1" style="width:20%">
+		</div>
+	  </div>
+	  
+	  <div class="form-row" id="node-row-editor-dynamic">
+		<div class="form-row">
+		  <label for="node-input-params" style="width: 130px"><i class="fa fa-code"></i> Source of body</label>
+		  <input type="text" id="node-input-body-source" style="width: 65%">
+		  <input type="hidden" id="node-input-body-source-type" style="width: 0px">
+    </div>
+	  </div>
+	</div>
+  </div>
+</script>
+
+<script type="text/javascript">
+RED.nodes.registerType('teamogy-client',{
+	category: 'TF collection',
+	color: '#fe4c00',
+	defaults: {
+		name: {
+			value: ""
+		},
+		configuration: {
+			type: "teamogy-config",
+			required: true
+		},
+		mode: {
+			value: false
+		},
+		method: {
+			value: "GET"
+		},
+		entity: {
+			value: "r_users"
+		},
+		source: {
+			value: "static"
+		},
+		cparams: {
+			value: ""
+		},
+		cbody: {
+			value: ""
+		},
+		bodysource: {
+			value: "payload"
+		},
+		merge: {
+			value: true
+		},
+		limit: {
+			value: 0,
+			required: true
+		},
+		paging: {
+			value: 1000,
+			required: true
+		},
+		offset: {
+			value: 0,
+			required: true
+		}
+	},
+	inputs: 1,
+	outputs:1,
+	icon: "bridge.svg",
+	align: "left",
+	label: function() {
+		return this.name || "teamogy";
+	},
+	paletteLabel: function() {
+		return this.name || "teamogy";
+	},
+	labelStyle: function() {
+		return this.name ? "node_label_italic" : "";
+	},
+    oneditprepare : function() {
+		let values
+	    let mode = this.mode;
+	    let entity = this.entity;
+	    let method = this.method;
+	    let source = this.source;
+		let params = this.cparams;
+		let body = this.cbody;
+		
+		$('#node-input-source').val(this.source);
+		$('#node-input-merge').val(this.merge);
+		$('#node-input-limit').val(this.limit);
+		$('#node-input-paging').val(this.paging);
+		$('#node-input-offset').val(this.offset);
+		
+		$('#node-input-mode').val(this.mode);
+		$('#node-input-body-source').val(this.bodysource);
+
+		
+		if(this.mode===true) {
+			values = values2;
+		} else {
+			values = values1;
+		}
+
+		$('#node-input-mode').on('change', function() {
+			if ($(this).is(':checked')) { 
+				values = values2;
+				if($('#node-input-source').val()=='static'){ $('#node-row-response-option').show(); }
+			} else {
+				values = values1;
+				$('#node-row-response-option').hide();
+			}
+			let se = fillEntity (values)
+			fillMethod (se) 
+		})
+
+		
+		function fillEntity (values) {
+			$('#node-input-entity').empty()
+			for (let value of values) {
+				$('#node-input-entity').append($("<option></option>").attr("value", value.v).text(value.e));
+			}
+		  
+			const fe = $('#node-input-entity option[value=' + entity +']').val();
+			if(fe != undefined ) {
+				$('#node-input-entity').val(entity);
+			} else {
+				$('#node-input-entity').prop('selectedIndex',0);; 
+			}
+			return $('#node-input-entity').val();
+		}
+		
+		function fillMethod (entity) {
+			$('#node-input-method').empty()
+			for (let value of values) {
+				if (value.v === entity) { 
+					for (let method of value.m) {
+						$('#node-input-method').append($("<option></option>").attr("value", method).text(method));			
+					}
+				}
+			}
+		
+			const fe = $('#node-input-method option[value=' + method +']').val();
+			if(fe != undefined ) {
+				$('#node-input-method').val(method);
+			} else {
+				$('#node-input-method').prop('selectedIndex',0);; 
+			}
+		}
+	
+		$('#node-input-entity').on('change', function() {
+			fillMethod ($(this).val())
+		})
+		
+		$('#node-input-source').on('change', function() {
+			if($(this).val()=='static') {
+				$('#node-row-editor').show();
+				$('#node-row-editor-dynamic').hide();
+				if($('#node-input-mode').is(':checked') == true) {
+					$('#node-row-response-option').show();
+				}
+			} else {
+				$('#node-row-editor').hide();
+				$('#node-row-editor-dynamic').show();
+				$('#node-row-response-option').hide();
+			}
+		})
+				
+		$("#node-input-body-source").typedInput({
+			type:"msg",
+			types:["msg"],
+			typeField: "#node-input-body-source-type"
+		})
+		
+		$('#node-input-limit').on('change', function() {
+			if(!$.isNumeric($(this).val())) { $(this).val(0) } 
+		})
+		
+		$('#node-input-paging').on('change', function() {
+			if(!$.isNumeric($(this).val())) { $(this).val(1000) } 
+		})
+
+		$('#node-input-offset').on('change', function() {
+			if(!$.isNumeric($(this).val())) { $(this).val(0) }
+		})
+		
+		this.editorp = RED.editor.createEditor({
+			id: 'node-input-params',
+			mode: 'ace/mode/text',
+			value: this.cparams
+		});
+		
+		this.editorb = RED.editor.createEditor({
+			id: 'node-input-body',
+			mode: 'ace/mode/json',
+			value: this.cbody
+		});
+		
+		const tabs = RED.tabs.create({
+			id: "config-tabs",
+			onchange: function(tab) {
+				$("#config-tabs-content").children().hide();
+				$("#" + tab.id).show();
+			}
+		});
+		
+		tabs.addTab({
+			id: "config-tab-config",
+			label: "Configuration"
+		});
+	},
+    oneditsave: function(){
+		this.mode = $("#node-input-mode").val();
+		this.entity = $("#node-input-entity").val();
+		this.method = $("#node-input-method").val();
+		this.source = $("#node-input-source").val();
+		this.merge = $("#node-input-merge").val();
+		this.bodysource = $("#node-input-body-source").val();
+		
+		if(!$("#node-input-limit").val()) {this.limit = 0} else {this.limit = $("#node-input-limit").val();}
+		if(!$("#node-input-offset").val()) {this.offset = 0} else {this.offset = $("#node-input-offset").val();}
+		this.paging = $("#node-input-paging").val();
+		  
+		this.cparams = this.editorp.getValue();
+		this.editorp.destroy();
+		delete this.editorp;
+		  
+		this.cbody = this.editorb.getValue();
+		this.editorb.destroy();
+		delete this.editorb;
+    },
+	oneditcancel: function() {
+		this.editorp.destroy();
+		delete this.editorp;
+	  
+		this.editorb.destroy();
+		delete this.editorb;
+	}
+});
+</script>
+
+<script type="text/html" data-help-name="teamogy-client">
+    <p>Connect to a Teamogy API.</p>
+
+	<p>You must configure Connection before using this node.</p>
+	
+	<h3>Connection configuration</h3>
+		<dl class="message-properties">
+			<dt class="optional">Name (optional)<span class="property-type">string</span></dt><dd> you can enter a name or it will be generated on first save</dd>
+			<dt>Subdomain (required)<span class="property-type">string</span></dt><dd> enter the name of the subdomain and the domain, in the format: subdomain.domain.com</dd>
+			<dt>Unit/Agency (required)<span class="property-type">number</span></dt><dd> enter the number of unit or agency</dd>
+			<dt>Token (required)<span class="property-type">string</span></dt><dd> enter the generated API token for the given subdomain and Unit/Agency</dd>
+			<dt>Req/min (required)<span class="property-type">number</span></dt><dd> enter the maximum number of API requests per minute for the given subdomain, if the limit is greater than allowed, further requests will be rejected (not processed)</dd>
+		</dl>
+	
+	<h3>Input</h3>
+		<dl class="message-properties">
+			<dt class="optional">Name (optional)<span class="property-type">string</span></dt><dd> you can enter a name for the given node (recommended)</dd>
+			<dt>Connection (required)<span class="property-type">selection - list</span></dt><dd> select the configured connection</dd>
+			<dt>Request views (required)<span class="property-type">checkbox - yes/no</span></dt><dd> check for requests for API views (see description below)</dd>
+			<dt>Token (required)<span class="property-type">selection - list</span></dt><dd> select the desired entity</dd>
+			<dt>Req/min (required)<span class="property-type">selection - list</span></dt><dd> select an available method</dd>
+			<dt>Source (required)<span class="property-type">selection - list</span></dt><dd> the parameters or even the request body can be static, i.e. from the Params and Body fields in the form, or dynamic as part of the input message.</dd>
+			<dt>Source of body (required)<span class="property-type">string</span></dt><dd> the parameter set the source of the body, default is msg.payload</dd>
+			<dt>Params (optional)<span class="property-type">string | object</span></dt><dd> you can enter the params in the case of a static request as a string, in the case of a dynamic also as an object, according to the API specification for the given entity</dd>
+			<dd>&nbsp;</dd>
+			<dd> Examples:</dd>
+			<dd> In the case of a static request, enter the desired values ​​according to the selected entity and method in the Params field. Values ​​for Params are listed on separate lines.</dd>
+			<dd> id=3</dd>
+			<dd> registration=12345678</dd>
+			<dd>&nbsp;</dd>
+			<dd> In the case of a static request for API views </dd>
+			<dd> columns=firstName,lastName</dd>
+			<dd> externalFilter=id>5</dd>
+			<dd>&nbsp;</dd>
+			<dd> In the case of a dynamic request for API views, as string</dd>
+			<dd> id=2&name=John</dd>
+			<dd>&nbsp;</dd>
+			<dd> or also as an object </dd>
+			<dd> msg.params.id = 2</dd>
+			<dd> msg.params.name = "John"</dd>
+			<dd>&nbsp;</dd>
+			<dt>Body (optional)<span class="property-type">JSON string | object</span></dt><dd> you can enter the body in the case of a static request as a JSON string, in the case of a dynamic also as an object, you can nest objects and arrays in the body without restrictions according to the API specification for the given entity</dd>
+			<dd>&nbsp;</dd>
+			<dd> Examples:</dd>
+			<dd> In the case of a static request, enter the desired values ​​according to the selected entity and method in the Body field.</dd>
+			<dd> {</dd>
+			<dd> &nbsp;&nbsp;"id": 3,</dd>
+			<dd> &nbsp;&nbsp;"registration": 12345678</dd>
+			<dd> }</dd>
+			<dd>&nbsp;</dd>
+			<dd> In the case of a dynamic request for API views, as JSON string</dd>
+			<dd>{"id": 3,"name": "John"}</dd>
+			<dd>&nbsp;</dd>
+			<dd> or also as an object </dd>
+			<dd> msg.body.id = 2</dd>
+			<dd> msg.body.name = "John"</dd>
+			<dd> msg.body.address = addresses // array of objects</dd>
+			<dd>&nbsp;</dd>
+			<dd> If you use requests for API views you can use additional options, the options can also be used in dynamic requests</dd>
+			<dt class="optional">Merge (optional)<span class="property-type">checkbox - yes/no</span></dt><dd> check if you want the output message to contain all returned records. In the background, processing is still taking place according to the Paging settings, but individual messages are not sent to the output, but only the final merged one containing all the returned records. (if not specified the value no is used)</dd>
+			<dt class="optional">Limit (optional)<span class="property-type">number</span></dt><dd> limitation of the total number of records in the response (if not specified, the value 0 is used, the value 0 means no limit)</dd>
+			<dt class="optional">Paging (optional)<span class="property-type">number</span></dt><dd> division of responses into multiple parts with the number of records returned (if not specified, the value 1000 is used)</dd>
+			<dt class="optional">Offset (optional)<span class="property-type">number</span></dt><dd> determining from which records to return, e.g. if you have a total of 100 records and want to return records 50-100, set Offset to 50, if you want to return all records leave the option at 0 (if not specified, the value 0 is used)</dd>
+			<dt class="optional">Skip (optional, in message only)<span class="property-type">boolean</span></dt><dd> adding the msg.skip=true will allow the message to pass through to the output without processing</dd>
+		</dl>
+		 
+	 <h3>Output</h3>
+		 <dl class="message-properties">
+			<dt>payload<span class="property-type">string | object</span></dt><dd> the standard output or error of the response</dd>
+			<dt>count<span class="property-type">number</span></dt><dd> number of records in the output</dd>
+			<dt>msg.*<span class="property-type">string | object</span></dt><dd> all properties of the input message</dd>
+		 </dl>
+
+	<h3>References</h3>
+		<ul>
+			<li><a href="https://teamogy.com/teamogy-flow">Teamogy Flow docs</a> - full description of Teamogy Flow</li>
+			<li><a href="https://readme.teamogy.com/reference/integration-options">Teamogy API docs</a> - full description of parameters for <code>msg.params</code> and <code>msg.body</code> properties, and also options for API views</li>
+		</ul>
+</script>

package/teamogy-client.js

@@ -0,0 +1,288 @@
+function isEmpty(value) { return (value == null || (typeof value === "string" && value.trim().length === 0)); }
+
+module.exports = function(RED) {
+	
+	function ConnectionNode(n) {
+		try {
+			RED.nodes.createNode(this, n);
+
+			this.name = n.name;
+			this.host = n.host;
+			this.unit = n.unit;
+			this.apilimit = n.apilimit;
+			this.tokendata = n.tokendata;
+			if (this.credentials) {
+				this.token = this.credentials.token;
+			}
+			
+			if(typeof this.context().global.get('cache_' + this.host ) == 'undefined') {
+				let cache = []
+				this.context().global.set('cache_' + this.host, cache)
+			}
+		
+		} catch (e) {
+			node.error(e);
+		}
+	}
+  
+	RED.nodes.registerType('teamogy-config', ConnectionNode, {
+		credentials: {
+			token: {type: 'password'}
+		}
+	});
+	
+	function teamogyClient(data) {
+		try {
+			var node = this;
+
+			RED.nodes.createNode(node,data);
+
+			this.config = RED.nodes.getNode(data.configuration);
+
+			let token = this.config.credentials.token
+			let host = this.config.host
+			let unit = this.config.unit
+		
+			let clientid = data.id
+			let c = this.context().global.get('cache_' + host)
+			let st = null;
+
+			async function sendmsg(mesg) {
+				try {
+					const msg = { ... mesg.msg }
+					let mparams = ''
+					let body = ''
+					let mmerge = false
+					let mlimit = 0
+					let mpaging = 1000
+					let moffset = 0
+					
+					if(data.source=='dynamic') {
+						if(typeof msg.params == 'string') { mparams = msg.params }
+						if(typeof msg.params == 'object') {
+						 
+							let pa=Object.entries(msg.params)
+							if(pa.length > 0) {
+								mparams = pa[0][0] + '=' + pa[0][1]
+
+								for (let i = 1; i < pa.length; i++) {
+									if(pa[i].length > 0) { mparams = mparams + '&' + pa[i][0] + '=' + pa[i][1] }
+								}
+							}
+						}
+
+						if(typeof msg[data.bodysource] == 'string') { body = msg[data.bodysource] }
+						if(typeof msg[data.bodysource] == 'object') { body = JSON.stringify(msg[data.bodysource]) }
+
+						if(typeof msg.merge == 'boolean') { mmerge = msg.merge }
+						if(typeof msg.limit == 'number') { mlimit = msg.limit }
+						if(typeof msg.paging == 'number') { mpaging = msg.paging }
+						if(typeof msg.offset == 'number') { moffset = msg.offset }
+	
+					}
+					
+					if(data.source=='static') {
+						const pa = data.cparams.split(/\r?\n/)
+						if(pa.length > 0) {
+							mparams = pa[0]
+						
+							for (let i = 1; i < pa.length; i++) {
+								if(pa[i].length > 0) { mparams = mparams + '&' + pa[i] }
+							}
+						}
+						body = data.cbody
+						mmerge = data.merge
+						mlimit = data.limit
+						mpaging = data.paging
+						moffset = data.offset
+					}
+					
+					const headers = {
+						'Authorization': 'Bearer ' + token,
+						'Accept': 'application/json',
+						'Content-type': 'application/json'
+					};
+					
+					let url = `https://${host}/rest/v1/${unit}/`
+
+					if(data.entity.split('_')[0] == 'v') { url = url + 'views/'}
+					
+					url = url + data.entity.split('_')[1].replaceAll('-','.')
+					
+					if(!isEmpty(mparams)) { url = url + '?' + mparams }
+
+					const doAsyncJobs = async () => {
+						try {
+							
+							let newMsg = JSON.parse(JSON.stringify(mesg.msg));
+							
+							let metadata = {};
+							metadata.count = 0
+							metadata.limit = 0
+							let rdata = [];
+							
+							let method = data.method
+							let offset = moffset
+							
+							if(method == 'GET') { body = null }
+							
+							if(data.entity.split('_')[0] == 'v') { 
+								if(isEmpty(mparams)) { url = url + '?' } else { url = url + '&' }
+								
+								while (offset != null) {
+									
+									if(parseInt(mlimit) == 0) { mlimit = 1000000000}
+									if(parseInt(mlimit) < parseInt(mpaging)) { mpaging = mlimit }
+
+									eurl = encodeURI(url + 'limit=' + mpaging +'&offset=' + offset)
+
+									const response = await fetch(eurl, {headers, method, body});
+							
+									if(response.status >= 200 && response.status < 300) {
+										
+										const body = await response.json();
+										offset = body?.metadata?.nextOffset
+										metadata.count = metadata.count + parseInt(body?.metadata?.count)
+										metadata.limit = body?.metadata?.limit
+										metadata.nextOffset = offset
+
+										if(mlimit - metadata.count < mpaging) { mpaging = mlimit - metadata.count}
+
+										if(mmerge == false) {
+											newMsg.payload=body;
+											newMsg.payload.count=body.data.length;
+											node.send(JSON.parse(JSON.stringify(newMsg)));	
+										} 
+										
+										if(mmerge == true) {
+											for(let bd of body.data) {
+												rdata.push(bd)	
+											}
+										} 
+										
+										if(mlimit <= metadata.count) { break; }
+			
+									} else {
+										node.error('Response status: ' + response.status);
+										node.error('Response status: ' + await response.text());
+										break;
+									}	
+								} 
+								
+								if(mmerge == true) {
+									let body = {}
+									metadata.limit = parseInt(data.paging)
+									body.metadata = metadata
+									body.data = rdata
+									body.count = rdata.length
+									newMsg.payload = body
+									node.send(JSON.parse(JSON.stringify(newMsg)));	
+								}
+							}
+							
+							if(data.entity.split('_')[0] == 'r') { 
+
+								const response = await fetch(encodeURI(url), {headers, method, body});
+
+								if(response.status >= 200 && response.status < 300) {
+									const body = await response.json();
+									newMsg.payload = body
+									node.send(JSON.parse(JSON.stringify(newMsg)));	
+								} else {
+									let payload = {}
+									payload.status = response.status
+									payload.text = await response.text()
+
+									newMsg.payload = payload
+									node.send(JSON.parse(JSON.stringify(newMsg)));	
+								}
+							}
+						} catch (e) {
+							node.error(e);
+						} 
+					}
+					
+					const r = await doAsyncJobs()
+					
+				} catch (e) {
+					node.error(e);
+				}
+			}
+			
+			function fa(arr,cid) {
+				try {
+					let na = arr.filter(function (el) {
+						return el.clientid == cid
+					});
+					return na.length
+				} catch (e) {
+					node.error(e);
+				} 
+			}
+
+			async function setTimer(host) {
+				try {
+					if(c.length > 0) {
+						let nd = new Date()
+						if(nd.getTime() > c[0].stime) {
+							if(c[0].clientid == clientid) {
+								let m = c.shift(0);
+								await sendmsg(m)
+							}
+						}
+							
+						let fal = fa(c,clientid);
+
+						if(fal == 0) {
+							node.status({fill: "green", shape: "dot", text: fal + " waiting messages"});
+						} else {
+							node.status({fill: "yellow", shape: "dot", text: fal + " waiting messages"});
+						}
+					} else {
+						clearInterval(st) 
+						st = null
+					}
+				}
+				catch (e) {
+					node.error(e);
+				}
+			}
+
+			node.on('input', async function(msg) {
+				try {
+					if(st == null){ st = setInterval(function () { setTimer(host) }, 1000)}
+
+					if(msg.skip != true) {
+						let stime = 0
+						let nd = new Date()
+						
+						if(c.length > 0) {
+							let hstime = c.findLast((el) => el);
+							stime = hstime.stime + (60000 / this.config.apilimit) 
+						} else {
+							stime = nd.getTime()
+						}
+
+						let md = {}
+						md.msg = msg
+						md.host = host
+						md.rtime = nd.getTime();
+						md.stime = stime
+						md.clientid = clientid
+						c.push(md)
+					} else {
+						node.send(msg)
+					}
+				}
+				catch (e) {
+					node.error(e);
+				}
+			});
+		
+		} catch (e) {
+			node.error(e);
+		}
+	}
+	
+	RED.nodes.registerType("teamogy-client",teamogyClient);
+}