@5minds/node-red-contrib-processcube 1.1.4-feature-f2fee5-m0kpqgkx → 1.1.4-feature-b3c80b-m14rvpwu

package/docker-compose.yml

@@ -16,6 +16,7 @@ services:
   
   engine:
     image: 5minds/processcube_engine:2024-1
+    #image: 5minds/processcube_engine:17.1.2
     ports:
       - 8000:8000
     volumes:

package/externaltask-error.html

@@ -8,6 +8,7 @@
         },
         inputs: 1,
         outputs: 1,
+        align: 'right',
         icon: 'externaltask_error.svg',
         label: function () {
             return this.name || 'externaltask-error';

package/externaltask-event-listener.html

@@ -45,6 +45,11 @@ A node which listens for events triggered by externaltasks
 
 ## Outputs
 
+: flowNodeInstanceId (string): The unique identifier for the flow node instance.
+: externalTaskEvent (Object): An Object containing the event data returned by the engine.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
 ### References
 
 -   [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube© platform

package/externaltask-input.html

@@ -37,9 +37,9 @@ the connected ProcessCube Engine for processing.
 
 ## Outputs
 
-: payload (string) : Defines the input of the external task token
+: payload (string) : The payload the external task was started with.
 : task (object) : The external task object
-: flowNodeInstanceId : The Id of the external task, which is needed to complete the task
+: flowNodeInstanceId : The unique identifier of the external task, which is needed to complete the task
 
 ### Details
 

package/message-event-trigger.html

@@ -6,7 +6,6 @@
             name: { value: '' },
             engine: { value: '', type: 'processcube-engine-config' },
             messagename: { value: '', required: true },
-            processInstanceId: { value: '' },
         },
         inputs: 1,
         outputs: 1,
@@ -30,24 +29,21 @@
         <label for="node-input-messagename"><i class="fa fa-tag"></i> Message Name</label>
         <input type="text" id="node-input-messagename" placeholder="Name of the Message-Event" />
     </div>
-    <div class="form-row">
-        <label for="node-input-processinstanceid"><i class="fa fa-tag"></i> Process Instance Id</label>
-        <input type="text" id="node-input-processinstanceid" placeholder="Id of the recipient process instance" />
-    </div>
 </script>
 
 <script type="text/markdown" data-help-name="externaltask-input">
-A Message event to an intermediate message event can be triggert.
+A node to trigger an event that will be send to the corresponding intermediate message event in the connected ProcessCube Engine.
 
 From the config the `messagename` and the `processInstanceId` must be set.
 
 ## Inputs
 
-: payload (Object) : Will sent to the event and used an new token payload.
+: payload (Object) : The payload will be sent to the message event and be used as a new token payload.
+: processInstanceId (string) : The process instance where the message event should be triggered.
 
 ### References
 
 -   [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform
 -   [Node-RED Integration in ProcessCube&copy;](https://processcube.io/docs/node-red) - Node-RED integration in ProcessCube&copy;
-    
+
 </script>

package/message-event-trigger.js

@@ -15,7 +15,7 @@ module.exports = function (RED) {
 
             engine.engineClient.events
                 .triggerMessageEvent(config.messagename, {
-                    processInstanceId: config.processinstanceid,
+                    processInstanceId: msg.processinstanceid,
                     payload: msg.payload,
                     identity: engine.identity,
                 })

package/nodered/flows.json

@@ -202,14 +202,14 @@
             "color": "#a4a4a4"
         },
         "nodes": [
-            "f7a9604a17188737",
             "020d34cd4ab43900",
-            "1db0ae57c1b8486b",
-            "127bc6e092c5724e"
+            "127bc6e092c5724e",
+            "394bf2c574d29c0d",
+            "30354355d2a0eeb8"
         ],
         "x": 34,
         "y": 19,
-        "w": 452,
+        "w": 532,
         "h": 202
     },
     {
@@ -226,17 +226,16 @@
             "color": "#a4a4a4"
         },
         "nodes": [
-            "ae0583e83c762956",
             "f7c7682e3a6adaaa",
-            "a2fb6369b16c12fa",
             "8ef39e83173d41e3",
             "f524b8cc35d56849",
-            "9fb4017c1d0ac7c9"
+            "9fb4017c1d0ac7c9",
+            "fc23f271b106648f"
         ],
         "x": 34,
         "y": 259,
         "w": 652,
-        "h": 262
+        "h": 202
     },
     {
         "id": "a71a168415778e2c",
@@ -353,14 +352,14 @@
             "color": "#a4a4a4"
         },
         "nodes": [
-            "81a5b763cddfa482",
-            "9bfd3131d8d4529e",
-            "fcfec4ae86b4aec2",
-            "c4f20aefe585bdad"
+            "c4f20aefe585bdad",
+            "451fc49b81cfe869",
+            "07e2258a732baddb",
+            "58202f3750a9762b"
         ],
         "x": 54,
         "y": 39,
-        "w": 452,
+        "w": 432,
         "h": 202
     },
     {
@@ -377,17 +376,16 @@
             "color": "#a4a4a4"
         },
         "nodes": [
-            "59f3d5ea3d920f94",
             "682a3e6e49c407c0",
-            "30ac2bbbc0d63b17",
             "5c9668cbe4b31919",
             "693e6d63e82ee961",
-            "c63cac30d2627c52"
+            "c63cac30d2627c52",
+            "771e1802a60ea5cc"
         ],
         "x": 54,
         "y": 279,
-        "w": 652,
-        "h": 262
+        "w": 632,
+        "h": 202
     },
     {
         "id": "e17f65347110575e",
@@ -1075,29 +1073,13 @@
         "y": 540,
         "wires": []
     },
-    {
-        "id": "f7a9604a17188737",
-        "type": "usertask-new-listener",
-        "z": "fd3c725340de4f74",
-        "g": "887f3fb69ad1d1fb",
-        "name": "New User Task",
-        "engine": "42e6796dddd9d4db",
-        "multisend": false,
-        "x": 160,
-        "y": 120,
-        "wires": [
-            [
-                "020d34cd4ab43900"
-            ]
-        ]
-    },
     {
         "id": "020d34cd4ab43900",
         "type": "debug",
         "z": "fd3c725340de4f74",
         "g": "887f3fb69ad1d1fb",
         "name": "Show User Task",
-        "active": true,
+        "active": false,
         "tosidebar": true,
         "console": false,
         "tostatus": false,
@@ -1105,26 +1087,10 @@
         "targetType": "msg",
         "statusVal": "",
         "statusType": "auto",
-        "x": 360,
+        "x": 440,
         "y": 120,
         "wires": []
     },
-    {
-        "id": "1db0ae57c1b8486b",
-        "type": "usertask-finished-listener",
-        "z": "fd3c725340de4f74",
-        "g": "887f3fb69ad1d1fb",
-        "name": "Finished User Task",
-        "engine": "42e6796dddd9d4db",
-        "multisend": false,
-        "x": 150,
-        "y": 180,
-        "wires": [
-            [
-                "020d34cd4ab43900"
-            ]
-        ]
-    },
     {
         "id": "127bc6e092c5724e",
         "type": "comment",
@@ -1136,22 +1102,6 @@
         "y": 60,
         "wires": []
     },
-    {
-        "id": "ae0583e83c762956",
-        "type": "usertask-new-listener",
-        "z": "fd3c725340de4f74",
-        "g": "72d3db13edc2486b",
-        "name": "",
-        "engine": "42e6796dddd9d4db",
-        "multisend": true,
-        "x": 160,
-        "y": 360,
-        "wires": [
-            [
-                "a2fb6369b16c12fa"
-            ]
-        ]
-    },
     {
         "id": "f7c7682e3a6adaaa",
         "type": "usertask-input",
@@ -1163,7 +1113,7 @@
         "query_type": "msg",
         "force_send_array": false,
         "multisend": false,
-        "x": 380,
+        "x": 180,
         "y": 420,
         "wires": [
             [
@@ -1171,27 +1121,6 @@
             ]
         ]
     },
-    {
-        "id": "a2fb6369b16c12fa",
-        "type": "function",
-        "z": "fd3c725340de4f74",
-        "g": "72d3db13edc2486b",
-        "name": "query",
-        "func": "msg.payload = {\n    flowNodeInstanceId: msg.payload.flowNodeInstanceId,\n    flowNodeId: \"user_task\"\n};\n\nreturn msg;",
-        "outputs": 1,
-        "timeout": 0,
-        "noerr": 0,
-        "initialize": "",
-        "finalize": "",
-        "libs": [],
-        "x": 210,
-        "y": 420,
-        "wires": [
-            [
-                "f7c7682e3a6adaaa"
-            ]
-        ]
-    },
     {
         "id": "8ef39e83173d41e3",
         "type": "function",
@@ -1206,7 +1135,7 @@
         "finalize": "",
         "libs": [],
         "x": 390,
-        "y": 480,
+        "y": 420,
         "wires": [
             [
                 "f524b8cc35d56849"
@@ -1223,7 +1152,7 @@
         "result": "payload.result",
         "result_type": "msg",
         "x": 580,
-        "y": 480,
+        "y": 420,
         "wires": [
             []
         ]
@@ -1240,52 +1169,59 @@
         "wires": []
     },
     {
-        "id": "81a5b763cddfa482",
-        "type": "usertask-new-listener",
-        "z": "90fa3991405c6248",
-        "g": "4f03c1eb4784b442",
-        "name": "New User Task",
-        "engine": "b78932d162d8d468",
-        "multisend": false,
-        "x": 180,
-        "y": 140,
+        "id": "fc23f271b106648f",
+        "type": "usertask-event-listener",
+        "z": "fd3c725340de4f74",
+        "g": "72d3db13edc2486b",
+        "name": "",
+        "engine": "42e6796dddd9d4db",
+        "usertask": "user_task",
+        "eventtype": "new",
+        "query": "{}",
+        "query_type": "json",
+        "x": 160,
+        "y": 360,
         "wires": [
             [
-                "9bfd3131d8d4529e"
+                "f7c7682e3a6adaaa"
             ]
         ]
     },
     {
-        "id": "9bfd3131d8d4529e",
-        "type": "debug",
-        "z": "90fa3991405c6248",
-        "g": "4f03c1eb4784b442",
-        "name": "Show User Task",
-        "active": true,
-        "tosidebar": true,
-        "console": false,
-        "tostatus": false,
-        "complete": "payload",
-        "targetType": "msg",
-        "statusVal": "",
-        "statusType": "auto",
-        "x": 380,
-        "y": 140,
-        "wires": []
+        "id": "394bf2c574d29c0d",
+        "type": "usertask-event-listener",
+        "z": "fd3c725340de4f74",
+        "g": "887f3fb69ad1d1fb",
+        "name": "",
+        "engine": "42e6796dddd9d4db",
+        "usertask": "user_task",
+        "eventtype": "new",
+        "query": "{}",
+        "query_type": "json",
+        "x": 160,
+        "y": 120,
+        "wires": [
+            [
+                "020d34cd4ab43900"
+            ]
+        ]
     },
     {
-        "id": "fcfec4ae86b4aec2",
-        "type": "usertask-finished-listener",
-        "z": "90fa3991405c6248",
-        "g": "4f03c1eb4784b442",
-        "name": "Finished User Task",
-        "engine": "b78932d162d8d468",
-        "multisend": false,
-        "x": 170,
-        "y": 200,
+        "id": "30354355d2a0eeb8",
+        "type": "usertask-event-listener",
+        "z": "fd3c725340de4f74",
+        "g": "887f3fb69ad1d1fb",
+        "name": "",
+        "engine": "42e6796dddd9d4db",
+        "usertask": "user_task",
+        "eventtype": "finished",
+        "query": "{}",
+        "query_type": "json",
+        "x": 160,
+        "y": 180,
         "wires": [
             [
-                "9bfd3131d8d4529e"
+                "020d34cd4ab43900"
             ]
         ]
     },
@@ -1300,22 +1236,6 @@
         "y": 80,
         "wires": []
     },
-    {
-        "id": "59f3d5ea3d920f94",
-        "type": "usertask-new-listener",
-        "z": "90fa3991405c6248",
-        "g": "a135da7e3b76f6dd",
-        "name": "",
-        "engine": "b78932d162d8d468",
-        "multisend": true,
-        "x": 180,
-        "y": 380,
-        "wires": [
-            [
-                "30ac2bbbc0d63b17"
-            ]
-        ]
-    },
     {
         "id": "682a3e6e49c407c0",
         "type": "usertask-input",
@@ -1327,7 +1247,7 @@
         "query_type": "msg",
         "force_send_array": false,
         "multisend": false,
-        "x": 400,
+        "x": 200,
         "y": 440,
         "wires": [
             [
@@ -1335,27 +1255,6 @@
             ]
         ]
     },
-    {
-        "id": "30ac2bbbc0d63b17",
-        "type": "function",
-        "z": "90fa3991405c6248",
-        "g": "a135da7e3b76f6dd",
-        "name": "query",
-        "func": "msg.payload = {\n    flowNodeInstanceId: msg.payload.flowNodeInstanceId,\n    flowNodeId: \"user_task_auth\"\n};\n\nreturn msg;",
-        "outputs": 1,
-        "timeout": 0,
-        "noerr": 0,
-        "initialize": "",
-        "finalize": "",
-        "libs": [],
-        "x": 230,
-        "y": 440,
-        "wires": [
-            [
-                "682a3e6e49c407c0"
-            ]
-        ]
-    },
     {
         "id": "5c9668cbe4b31919",
         "type": "function",
@@ -1369,8 +1268,8 @@
         "initialize": "",
         "finalize": "",
         "libs": [],
-        "x": 410,
-        "y": 500,
+        "x": 390,
+        "y": 440,
         "wires": [
             [
                 "693e6d63e82ee961"
@@ -1386,8 +1285,8 @@
         "engine": "b78932d162d8d468",
         "result": "payload.result",
         "result_type": "msg",
-        "x": 600,
-        "y": 500,
+        "x": 580,
+        "y": 440,
         "wires": [
             []
         ]
@@ -1403,6 +1302,80 @@
         "y": 320,
         "wires": []
     },
+    {
+        "id": "771e1802a60ea5cc",
+        "type": "usertask-event-listener",
+        "z": "90fa3991405c6248",
+        "g": "a135da7e3b76f6dd",
+        "name": "",
+        "engine": "b78932d162d8d468",
+        "usertask": "user_task_auth",
+        "eventtype": "new",
+        "query": "{}",
+        "query_type": "json",
+        "x": 180,
+        "y": 380,
+        "wires": [
+            [
+                "682a3e6e49c407c0"
+            ]
+        ]
+    },
+    {
+        "id": "451fc49b81cfe869",
+        "type": "usertask-event-listener",
+        "z": "90fa3991405c6248",
+        "g": "4f03c1eb4784b442",
+        "name": "",
+        "engine": "b78932d162d8d468",
+        "usertask": "user_task_auth",
+        "eventtype": "new",
+        "query": "{}",
+        "query_type": "json",
+        "x": 180,
+        "y": 140,
+        "wires": [
+            [
+                "58202f3750a9762b"
+            ]
+        ]
+    },
+    {
+        "id": "07e2258a732baddb",
+        "type": "usertask-event-listener",
+        "z": "90fa3991405c6248",
+        "g": "4f03c1eb4784b442",
+        "name": "",
+        "engine": "b78932d162d8d468",
+        "usertask": "user_task_auth",
+        "eventtype": "finished",
+        "query": "{}",
+        "query_type": "json",
+        "x": 180,
+        "y": 200,
+        "wires": [
+            [
+                "58202f3750a9762b"
+            ]
+        ]
+    },
+    {
+        "id": "58202f3750a9762b",
+        "type": "debug",
+        "z": "90fa3991405c6248",
+        "g": "4f03c1eb4784b442",
+        "name": "debug 31",
+        "active": false,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "false",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 380,
+        "y": 140,
+        "wires": []
+    },
     {
         "id": "baa5d814f2e1f1d8",
         "type": "processinstance-query",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@5minds/node-red-contrib-processcube",
-    "version": "1.1.4-feature-f2fee5-m0kpqgkx",
+    "version": "1.1.4-feature-b3c80b-m14rvpwu",
     "license": "MIT",
     "description": "Node-RED nodes for ProcessCube",
     "scripts": {
@@ -41,6 +41,7 @@
             "externaltaskError": "externaltask-error.js",
             "externaltaskEventListener": "externaltask-event-listener.js",
             "processStart": "process-start.js",
+            "processTerminate": "process-terminate.js",
             "processEventListener": "process-event-listener.js",
             "processcubeEngineConfig": "processcube-engine-config.js",
             "ProcessinstanceQuery": "processinstance-query.js",

package/process-event-listener.html

@@ -75,6 +75,95 @@ A node which listens for events triggered by processes
 
 ## Outputs
 
+### starting
+
+: processInstanceId (string): The unique identifier for the process instance.
+: processModelId (string): The id of the process model.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### started
+
+: processInstanceId (string): The unique identifier for the process instance.
+: processModelId (string): The id of the process model.
+: flowNodeId (string): The id of the flowNode the process was started with.
+: token (Object): The start token of the process instance.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### resumed
+
+: processInstanceId (string): The unique identifier for the process instance.
+: processModelId (string): The id of the process model.
+: token (Object): The current token of the process instance.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### finished
+
+: processInstanceId (string): The unique identifier for the process instance.
+: processModelId (string): The id of the process model.
+: flowNodeId (string): The id of the flowNode the process was finished with.
+: token (Object): The end token of the process instance.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### terminated
+
+: processInstanceId (string): The unique identifier for the process instance.
+: processModelId (string): The id of the process model.
+: token (Object): The current token of the process instance.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### error
+
+: processInstanceId (string): The unique identifier for the process instance.
+: processModelId (string): The id of the process model.
+: token (Object): The current token of the process instance.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### owner-changed
+
+: processInstanceId (string): The unique identifier for the process instance.
+: processModelId (string): The id of the process model.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### instances-deleted
+
+: processInstanceId (string): The unique identifier for the process instance.
+: processModelId (string): The id of the process model.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### is-executable-changed
+
+: processModelId (string): The id of the process model.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### deployed
+
+: processModelId (string): The id of the process model.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
+### undeployed
+
+: processModelId (string): The id of the process model.
+: action (string): The event that occured. 
+: type (string): The target of the event.
+
 ### References
 
 -   [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube© platform

package/process-start.html

@@ -43,10 +43,15 @@ The `processModelId` and `startEventId` can be set in the message object to over
 
 ## Inputs
 
-: payload (Object) : Will be used as the input for the process.
+: payload (Object) : Will be used as the start token for the process.
 : processModelId (String) : Will be used as the process model and override the configured `Processmodel`.
 : startEventId (String) : Will be used as the start event and override the configured `Startevent`.
 
+## Outputs
+
+: processInstanceId (string) : The unique identifier of the started process instance.
+: correlationId (string) : The unique correlation identifier of the started process instance.
+
 ### References
 
 -   [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube© platform

package/process-terminate.html

@@ -0,0 +1,45 @@
+<script type="text/javascript">
+    RED.nodes.registerType('process-terminate', {
+        category: 'ProcessCube',
+        color: '#02AFD6',
+        defaults: {
+            name: { value: '' },
+            engine: { value: '', type: 'processcube-engine-config' },
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'font-awesome/fa-sign-in',
+        label: function () {
+            return this.name || 'process-terminate';
+        },
+    });
+</script>
+
+<script type="text/html" data-template-name="process-terminate">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name" />
+    </div>
+    <div class="form-row">
+        <label for="node-input-engine"><i class="fa fa-tag"></i> Engine-URL</label>
+        <input type="text" id="node-input-engine" placeholder="Engine-URL" />
+    </div>
+</script>
+
+<script type="text/markdown" data-help-name="process-terminate">
+Terminate an instance of a process model in the ProcessCube.
+
+## Inputs
+
+: payload (string): The id of the processinstance that is going to be terminated.
+
+## Outputs
+
+: payload (string): The id of the processinstance that was terminated.
+
+### References
+
+-   [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform
+-   [Node-RED Integration in ProcessCube&copy;](https://processcube.io/docs/node-red) - Node-RED integration in ProcessCube&copy;
+
+</script>

package/process-terminate.js

@@ -0,0 +1,27 @@
+module.exports = function (RED) {
+    function ProcessTerminate(config) {
+        RED.nodes.createNode(this, config);
+        var node = this;
+
+        node.on('input', function (msg) {
+            const engine = RED.nodes.getNode(config.engine);
+            const client = engine.engineClient;
+
+            if (!client) {
+                node.error('No engine configured.');
+                return;
+            }
+
+            client.processInstances
+                .terminateProcessInstance(msg.payload, engine.identity)
+                .then(() => {
+                    node.send(msg);
+                })
+                .catch((error) => {
+                    node.error(error);
+                });
+        });
+    }
+
+    RED.nodes.registerType('process-terminate', ProcessTerminate);
+};

package/processdefinition-query.html

@@ -61,7 +61,7 @@
 </script>
 
 <script type="text/markdown" data-help-name="processdefinition-query">
-Query process definitions or process models from the ProcessCube engine.
+A node to query process definition on the ProcessCube Engine.
 
 The `query` can be given a direkt query field from the configutation or a message property.
 
@@ -71,6 +71,11 @@ Only models can be queried by setting the `models_only` flag.
 
 : payload (Object | JSON) : Will be used as the input for the query or can be directly set as JSON.
 
+## Outputs
+
+: processDefinitions / models (Array) : The processDefinitions / models that matched the query.
+: totalCount (number) : The number of matches.
+
 ### References
 
 - [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform

package/processes/Call-Activity-Sample.bpmn

@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:camunda="http://camunda.org/schema/1.0/bpmn" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" id="Call-Activity-Sample_Definition" targetNamespace="http://bpmn.io/schema/bpmn" exporter="5Minds Studio" exporterVersion="1">
+  <bpmn:collaboration id="Collaboration_1cidyxu" name="">
+    <bpmn:participant id="Participant_0px403d" name="Call-Activity-Sample" processRef="Call-Activity-Sample_Process" />
+  </bpmn:collaboration>
+  <bpmn:process id="Call-Activity-Sample_Process" name="Call-Activity-Sample" isExecutable="true">
+    <bpmn:laneSet>
+      <bpmn:lane id="Lane_1xzf0d3" name="Lane">
+        <bpmn:flowNodeRef>StartEvent_1</bpmn:flowNodeRef>
+        <bpmn:flowNodeRef>Activity_1483lxt</bpmn:flowNodeRef>
+        <bpmn:flowNodeRef>Event_051opo1</bpmn:flowNodeRef>
+        <bpmn:flowNodeRef>Activity_1m883u3</bpmn:flowNodeRef>
+      </bpmn:lane>
+    </bpmn:laneSet>
+    <bpmn:startEvent id="StartEvent_1" name="Start">
+      <bpmn:outgoing>Flow_0jchwpf</bpmn:outgoing>
+    </bpmn:startEvent>
+    <bpmn:sequenceFlow id="Flow_0jchwpf" sourceRef="StartEvent_1" targetRef="Activity_1483lxt" />
+    <bpmn:scriptTask id="Activity_1483lxt" name="make multi">
+      <bpmn:incoming>Flow_0jchwpf</bpmn:incoming>
+      <bpmn:outgoing>Flow_1kbc11o</bpmn:outgoing>
+      <bpmn:script>const data = [
+    {
+        "uid": 14200
+    },
+    {
+        "uid": 14201
+    }
+];
+
+return data;</bpmn:script>
+    </bpmn:scriptTask>
+    <bpmn:sequenceFlow id="Flow_1kbc11o" sourceRef="Activity_1483lxt" targetRef="Activity_1m883u3" />
+    <bpmn:endEvent id="Event_051opo1">
+      <bpmn:incoming>Flow_0pjaqpi</bpmn:incoming>
+    </bpmn:endEvent>
+    <bpmn:sequenceFlow id="Flow_0pjaqpi" sourceRef="Activity_1m883u3" targetRef="Event_051opo1" />
+    <bpmn:callActivity id="Activity_1m883u3" name="call sub" calledElement="External-Task-Sample_Process">
+      <bpmn:extensionElements>
+        <camunda:properties>
+          <camunda:property name="startEventId" value="StartEvent_1" />
+        </camunda:properties>
+      </bpmn:extensionElements>
+      <bpmn:incoming>Flow_1kbc11o</bpmn:incoming>
+      <bpmn:outgoing>Flow_0pjaqpi</bpmn:outgoing>
+      <bpmn:multiInstanceLoopCharacteristics />
+    </bpmn:callActivity>
+  </bpmn:process>
+  <bpmndi:BPMNDiagram id="BPMNDiagram_1">
+    <bpmndi:BPMNPlane id="BPMNPlane_1" bpmnElement="Collaboration_1cidyxu">
+      <bpmndi:BPMNShape id="Participant_0px403d_di" bpmnElement="Participant_0px403d" isHorizontal="true">
+        <dc:Bounds x="5" y="4" width="885" height="346" />
+      </bpmndi:BPMNShape>
+      <bpmndi:BPMNShape id="Lane_1xzf0d3_di" bpmnElement="Lane_1xzf0d3" isHorizontal="true">
+        <dc:Bounds x="35" y="4" width="855" height="346" />
+      </bpmndi:BPMNShape>
+      <bpmndi:BPMNShape id="StartEvent_1_di" bpmnElement="StartEvent_1">
+        <dc:Bounds x="92" y="152" width="36" height="36" />
+        <bpmndi:BPMNLabel>
+          <dc:Bounds x="98" y="195" width="24" height="14" />
+        </bpmndi:BPMNLabel>
+      </bpmndi:BPMNShape>
+      <bpmndi:BPMNShape id="Activity_0uc2tzt_di" bpmnElement="Activity_1483lxt">
+        <dc:Bounds x="180" y="130" width="100" height="80" />
+        <bpmndi:BPMNLabel />
+      </bpmndi:BPMNShape>
+      <bpmndi:BPMNShape id="Event_051opo1_di" bpmnElement="Event_051opo1">
+        <dc:Bounds x="502" y="152" width="36" height="36" />
+      </bpmndi:BPMNShape>
+      <bpmndi:BPMNShape id="Activity_0t5p0pc_di" bpmnElement="Activity_1m883u3">
+        <dc:Bounds x="340" y="130" width="100" height="80" />
+        <bpmndi:BPMNLabel />
+      </bpmndi:BPMNShape>
+      <bpmndi:BPMNEdge id="Flow_0jchwpf_di" bpmnElement="Flow_0jchwpf">
+        <di:waypoint x="128" y="170" />
+        <di:waypoint x="180" y="170" />
+      </bpmndi:BPMNEdge>
+      <bpmndi:BPMNEdge id="Flow_1kbc11o_di" bpmnElement="Flow_1kbc11o">
+        <di:waypoint x="280" y="170" />
+        <di:waypoint x="340" y="170" />
+      </bpmndi:BPMNEdge>
+      <bpmndi:BPMNEdge id="Flow_0pjaqpi_di" bpmnElement="Flow_0pjaqpi">
+        <di:waypoint x="440" y="170" />
+        <di:waypoint x="502" y="170" />
+      </bpmndi:BPMNEdge>
+    </bpmndi:BPMNPlane>
+  </bpmndi:BPMNDiagram>
+</bpmn:definitions>

package/processinstance-query.html

@@ -46,12 +46,17 @@
 </script>
 
 <script type="text/markdown" data-help-name="processinstance-query">
-Query a process instance in the ProcessCube.
+A node to query process instances on the ProcessCube Engine.
 
 ## Inputs
 
 : payload (Object | JSON) : Will be used as the input for the query or can be directly set as JSON.
 
+## Outputs
+
+: processInstances (Array) : The process instances that matched the query.
+: totalCount (number) : The number of matches.
+
 ### References
 
 -  [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform

package/signal-event-trigger.html

@@ -6,7 +6,6 @@
             name: { value: '' },
             engine: { value: '', type: 'processcube-engine-config' },
             signalname: { value: '', required: true },
-            processInstanceId: { value: '' },
         },
         inputs: 1,
         outputs: 1,
@@ -30,10 +29,7 @@
         <label for="node-input-signalname"><i class="fa fa-tag"></i> Signal Name</label>
         <input type="text" id="node-input-signalname" placeholder="Name of the Signal" />
     </div>
-    <div class="form-row">
-        <label for="node-input-processinstanceid"><i class="fa fa-tag"></i> Process Instance Id</label>
-        <input type="text" id="node-input-processinstanceid" placeholder="Id of the recipient process instance" />
-    </div>
+    
 </script>
 
 <script type="text/markdown" data-help-name="signal-event-trigger">
@@ -44,6 +40,7 @@ From the config the `signalname` and the `processInstanceId` must be set.
 ## Inputs
 
 : payload (Object) : Will sent to the event and used an new token payload.
+: processInstanceId (string) : The process instance where the signal event should be triggered.
 
 ### References
 

package/signal-event-trigger.js

@@ -15,7 +15,7 @@ module.exports = function (RED) {
     
             client.events
                 .triggerSignalEvent(config.signalname, {
-                    processInstanceId: config.processinstanceid,
+                    processInstanceId: msg.processinstanceid,
                     payload: msg.payload,
                     identity: engine.identity,
                 })

package/usertask-event-listener.html

@@ -68,6 +68,12 @@ A node which listens for events triggered by usertasks
 
 ## Outputs
 
+: flowNodeInstanceId (string): The unique identifier for the usertask instance.
+: userTaskEvent (Object): An Object representing the event returned by the engine.
+: processInstance (Object): An Object representing the process instance data.
+: action (string): The event that occured.
+: type (string): The target of the event.
+
 ### References
 
 -   [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube© platform

package/usertask-input.html

@@ -7,8 +7,7 @@
             engine: { value: '', type: 'processcube-engine-config' },
             query: { value: 'payload' },
             query_type: { value: 'msg' },
-            force_send_array: { value: false },
-            multisend: { value: false },
+            sendtype: { value: 'array', required: true },
         },
         inputs: 1,
         outputs: 1,
@@ -45,33 +44,13 @@
         <label for="node-input-query"><i class="fa fa-tag"></i> Query</label>
         <input type="text" id="node-input-query" />
     </div>
-    <div class="form-row" style="display:flex; margin-bottom: 3px;">
-        <label for="node-input-force_send_array" style="vertical-align:top"
-            ><i class="fa fa-list-alt"></i> Force send payload as array</label
-        >
-        <div>
-            <input
-                type="checkbox"
-                checked
-                id="node-input-force_send_array"
-                style="display: inline-block; width: auto; margin: 0px 0px 0px 4px;"
-            />
-            <label style="width:auto" for="node-input-force_send_array"
-                >Alway send an array? Only works if <i>Send multi</i> is false.</label
-            >
-        </div>
-    </div>
-    <div class="form-row" style="display:flex; margin-bottom: 3px;">
-        <label for="node-input-multisend" style="vertical-align:top"><i class="fa fa-list-alt"></i> Send multi</label>
-        <div>
-            <input
-                type="checkbox"
-                checked
-                id="node-input-multisend"
-                style="display: inline-block; width: auto; margin: 0px 0px 0px 4px;"
-            />
-            <label style="width:auto" for="node-input-multisend">Send one output of each usertask input?</label>
-        </div>
+    <div class="form-row">
+        <label for="node-input-sendtype"><i class="fa fa-sliders"></i> Result</label>
+        <select id="node-input-sendtype" style="width: 70%;">
+            <option value="array">Send as Array</option>
+            <option value="multi">Send Separately</option>
+            <option value="first">Send First Task</option>
+        </select>
     </div>
 </script>
 
@@ -88,6 +67,6 @@ A node which sends a payload to a usertask in the ProcessCube.
 
 ### References
 
-- [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform
-- [Node-RED Integration in ProcessCube&copy;](https://processcube.io/docs/node-red) - Node-RED integration in ProcessCube&copy;
+-   [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube&copy; platform
+-   [Node-RED Integration in ProcessCube&copy;](https://processcube.io/docs/node-red) - Node-RED integration in ProcessCube&copy;
 </script>

package/usertask-input.js

@@ -4,7 +4,6 @@ module.exports = function (RED) {
         var node = this;
 
         node.on('input', function (msg) {
-
             const engine = RED.nodes.getNode(config.engine);
 
             const client = engine.engineClient;
@@ -17,46 +16,26 @@ module.exports = function (RED) {
             let query = RED.util.evaluateNodeProperty(config.query, config.query_type, node, msg);
 
             query = {
-                ...query
+                ...query,
             };
 
-            client.userTasks.query(query, { identity: engine.identity} )
+            client.userTasks
+                .query(query, { identity: engine.identity })
                 .then((matchingFlowNodes) => {
-                    if (
-                        !config.force_send_array &&
-                        matchingFlowNodes &&
-                        matchingFlowNodes.userTasks &&
-                        matchingFlowNodes.userTasks.length == 1
-                    ) {
-                        userTask = matchingFlowNodes.userTasks[0];
-
-                        msg.payload = { userTask: userTask };
+                    if (config.sendtype === 'array') {
+                        msg.payload = { userTasks: matchingFlowNodes.userTasks || [] };
                         node.send(msg);
-                    } else {
-                        if (!config.force_send_array) {
-                            if (config.multisend && matchingFlowNodes.userTasks && matchingFlowNodes.userTasks.length > 1) {
-                                matchingFlowNodes.userTasks.forEach((userTask) => {
-                                    msg.payload = { userTask: userTask };
-                                    node.send(msg);
-                                });
-                            } else {
-                                if (matchingFlowNodes.userTasks == 1) {
-                                    msg.payload = {
-                                        userTasks: matchingFlowNodes.userTasks,
-                                    };
-                                    node.send(msg);    
-                                } else {
-                                    node.log(`No user tasks found for query: ${JSON.stringify(query)}`); 
-                                }
-                            }
-                        } else {
-                            msg.payload = {
-                                userTasks: matchingFlowNodes.userTasks || [],
-                            };
+                    } else if (config.sendtype === 'multi' && matchingFlowNodes?.userTasks?.length > 1) {
+                        matchingFlowNodes.userTasks.forEach((userTask) => {
+                            msg.payload = { userTask };
                             node.send(msg);
-                        }
-                    }
-                }).catch((error) => {
+                        });
+                    } else if (matchingFlowNodes?.userTasks?.length >= 1) {
+                        msg.payload = { userTask: matchingFlowNodes.userTasks[0] };
+                        node.send(msg);
+                    } else node.log(`No user tasks found for query: ${JSON.stringify(query)}`);
+                })
+                .catch((error) => {
                     node.error(error);
                 });
         });

package/usertask-output.html

@@ -10,6 +10,7 @@
         },
         inputs: 1,
         outputs: 1,
+        align: 'right',
         icon: 'usertask_output.svg',
         label: function () {
             return this.name || 'usertask-output';
@@ -55,7 +56,6 @@ A node which sends the result of a usertask to the ProcessCube.
 
 ### References
 
-- [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube© platform
-- [Node-RED Integration in ProcessCube©](https://processcube.io/docs/node-red) - Node-RED integration in ProcessCube©
-
+-   [The ProcessCube Developer Network](https://processcube.io) - All documentation for the ProcessCube© platform
+-   [Node-RED Integration in ProcessCube©](https://processcube.io/docs/node-red) - Node-RED integration in ProcessCube©
 </script>