@5minds/node-red-contrib-processcube 1.4.0-feature-d2cbe1-m2dh23ei → 2.0.0-feature-629c78-m2dq1ygt

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,115 @@
1
+ ## Query fields
2
+
3
+ **Summary**:
4
+
5
+ **Description**: Gets all ProcessInstances that match the given query.
6
+
7
+ #### Parameters:
8
+ - Name: `offset` Required: `false`
9
+ - Type: number
10
+ - Description: The index of the first ProcessInstance to include in the result set.
11
+ - Name: `limit` Required: `false`
12
+ - Type: number
13
+ - Description: The maximum number of ProcessInstances to return.
14
+ - Name: `correlationId` Required: `false`
15
+ - Type: Array<string> | string | SearchQuery
16
+ - string: myCorrelationId
17
+ - Array<string>: myCorrelationId1,myCorrelationId2
18
+ - object:
19
+ - Description: Filter by the CorrelationId of the ProcessInstances.
20
+ - Name: `processInstanceId` Required: ``
21
+ - Type: Array<string> | string | SearchQuery
22
+ - string: myProcessInstance_12345678
23
+ - Array<string>: myProcessInstance_12345678,myProcessInstance_87654321
24
+ - object:
25
+ - Description: Filter by the ID of the ProcessInstances.
26
+ - Name: `processDefinitionId` Required: ``
27
+ - Type: Array<string> | string | SearchQuery
28
+ - string: myProcess_12345678
29
+ - Array<string>: myProcess_12345678,myProcess_87654321
30
+ - object:
31
+ - Description: Filter by the ID of the ProcessDefinition that the ProcessInstances belong to.
32
+ - Name: `processModelId` Required: ``
33
+ - Type: Array<string> | string | SearchQuery
34
+ - string: myProcessModel_12345678
35
+ - Array<string>: myProcessModel_12345678,myProcessModel_87654321
36
+ - object:
37
+ - Description: Filter by the ID of the ProcessModel that the ProcessInstances belong to.
38
+ - Name: `processModelName` Required: ``
39
+ - Type: Array<string> | string | SearchQuery
40
+ - string: My Process Model
41
+ - Array<string>: My Process Model,My Other Process Model
42
+ - object:
43
+ - Description: Filter by the name of the ProcessModel that the ProcessInstances belong to.
44
+ - Name: `processModelHash` Required: ``
45
+ - Type: Array<string> | string | SearchQuery
46
+ - string: 12345678
47
+ - Array<string>: 12345678,87654321
48
+ - object:
49
+ - Description: Filter by the hash of the ProcessModel that the ProcessInstances belong to.
50
+ - Name: `ownerId` Required: ``
51
+ - Type: Array<string> | string | SearchQuery
52
+ - string: 12345678
53
+ - Array<string>: 12345678,87654321
54
+ - object:
55
+ - Description: Filter by the ID of the User that owns the ProcessInstances.
56
+ - Name: `state` Required: ``
57
+ - Type: Array<string> | string | SearchQuery
58
+ - string: running
59
+ - Array<string>: running,finished
60
+ - object:
61
+ - Description: Filter by the state of the ProcessInstances.
62
+ - Name: `parentProcessInstanceId` Required: ``
63
+ - Type: Array<string> | string | SearchQuery
64
+ - string: myParentProcessInstance_12345678
65
+ - Array<string>: myParentProcessInstance_12345678,myParentProcessInstance_87654321
66
+ - object:
67
+ - Description: Filter by the ID of the parent ProcessInstance.
68
+ - Name: `terminatedByUserId` Required: ``
69
+ - Type: Array<string> | string | SearchQuery
70
+ - string: 12345678
71
+ - Array<string>: 12345678,87654321
72
+ - object:
73
+ - Description: Filter by the ID of the User that terminated the ProcessInstances.
74
+ - Name: `createdBefore` Required: ``
75
+ - Type: string
76
+ - Description: The maximum created date of the ProcessInstances to include in the results.
77
+ - Name: `createdAt` Required: ``
78
+ - Type: Array<string> | string
79
+ - string: 2021-01-01T00:00:00.000Z
80
+ - array: 2021-01-01T00:00:00.000Z,2021-01-02T00:00:00.000Z
81
+ - Description: The minimum created date of the ProcessInstances to include in the results.
82
+ - Name: `createdAfter` Required: ``
83
+ - Type: string
84
+ - Description: The minimum created date of the ProcessInstances to include in the results.
85
+ - Name: `updatedBefore` Required: ``
86
+ - Type: string
87
+ - Description: The maximum updated date of the ProcessInstances to include in the results.
88
+ - Name: `updatedAt` Required: ``
89
+ - Type: Array<string> | string
90
+ - string: 2021-01-01T00:00:00.000Z
91
+ - array: 2021-01-01T00:00:00.000Z,2021-01-02T00:00:00.000Z
92
+ - Description: The exact updated date of the ProcessInstances to include in the results.
93
+ - Name: `updatedAfter` Required: ``
94
+ - Type: string
95
+ - Description: The minimum updated date of the ProcessInstances to include in the results.
96
+ - Name: `finishedBefore` Required: ``
97
+ - Type: string
98
+ - Description: The maximum finished date of the ProcessInstances to include in the results.
99
+ - Name: `finishedAt` Required: ``
100
+ - Type: Array<string> | string
101
+ - string: 2021-01-01T00:00:00.000Z
102
+ - array: 2021-01-01T00:00:00.000Z,2021-01-02T00:00:00.000Z
103
+ - Description: The exact finished date of the ProcessInstances to include in the results.
104
+ - Name: `finishedAfter` Required: ``
105
+ - Type: string
106
+ - Description: The minimum finished date of the ProcessInstances to include in the results.
107
+ - Name: `triggeredByFlowNodeInstance` Required: ``
108
+ - Type: Array<string> | string | SearchQuery
109
+ - string: myFlowNodeInstance_12345678
110
+ - array: myFlowNodeInstance_12345678,myFlowNodeInstance_87654321
111
+ - object:
112
+ - Description: Filter by the ID of the FlowNodeInstance that triggered the ProcessInstance.
113
+
114
+ #### Responses:
115
+ - **200**:
@@ -0,0 +1,41 @@
1
+ const Mustache = require('mustache');
2
+ const fs = require('fs');
3
+
4
+ const swaggerFilename = '../../ProcessCube.Engine/docs/swagger/swagger.json'; // Dateiname der Swagger-Datei
5
+
6
+ const swaggerJson = JSON.parse(fs.readFileSync(swaggerFilename, 'utf-8'));
7
+
8
+ //console.log(Object.keys(swaggerJson.paths));
9
+ //return
10
+
11
+ const apiPath = '/process_instances/query'; // Die API-Route, die du dokumentieren möchtest
12
+ const routeData = swaggerJson.paths[apiPath];
13
+
14
+ if (routeData) {
15
+ console.log(`Details for ${apiPath}:`, routeData);
16
+ } else {
17
+ console.error(`Route ${apiPath} not found in Swagger documentation.`);
18
+ }
19
+
20
+ // API-Route-Information vorbereiten
21
+ const apiRouteData = {
22
+ path: apiPath,
23
+ method: Object.keys(routeData)[0], // z.B. GET, POST, etc.
24
+ summary: routeData[Object.keys(routeData)[0]].summary,
25
+ description: routeData[Object.keys(routeData)[0]].description,
26
+ parameters: routeData[Object.keys(routeData)[0]].parameters || [],
27
+ responses: Object.entries(routeData[Object.keys(routeData)[0]].responses).map(([status, response]) => ({
28
+ status,
29
+ description: response.description
30
+ }))
31
+ };
32
+
33
+ // Mustache-Template einlesen
34
+ const template = fs.readFileSync('template_instance_query.mustache', 'utf-8');
35
+
36
+ // Mustache-Rendering
37
+ const output = Mustache.render(template, apiRouteData);
38
+
39
+ // Ausgabe in eine Datei schreiben oder anzeigen
40
+ console.log(output);
41
+ fs.writeFileSync('output.md', output);
@@ -0,0 +1,72 @@
1
+ const Mustache = require('mustache');
2
+ const fs = require('fs');
3
+
4
+ const SwaggerParser = require('swagger-parser');
5
+
6
+ //const swaggerFilename = '../../ProcessCube.Engine/docs/swagger/swagger.json'; // Dateiname der Swagger-Datei
7
+ const swaggerFilename = 'swagger.json'; // Dateiname der Swagger-Datei
8
+
9
+
10
+ //SwaggerParser.dereference("http://localhost:8000/atlas_engine/api/v1/swagger")
11
+ SwaggerParser.dereference(swaggerFilename)
12
+ .then(swaggerJson => {
13
+ console.log('Dereferenced API:', swaggerJson);
14
+
15
+ const apiPaths = [{
16
+ "ProcessInstance Query": {
17
+ "path": "/process_instances/query",
18
+ "method": "get"
19
+ },
20
+ "UserTasks Query": {
21
+ "path": "/process_instances/query",
22
+ "method": "get"
23
+ },
24
+ "Wait for UserTask": {
25
+ "path": "/process_instances/query",
26
+ "method": "get"
27
+ },
28
+ "UserTask Event Listener": {
29
+ "path": "/process_instances/query",
30
+ "method": "get"
31
+ }
32
+ }];
33
+
34
+ const apiPath = '/process_instances/query'; // Die API-Route, die du dokumentieren möchtest
35
+ const routeData = swaggerJson.paths[apiPath];
36
+
37
+ if (routeData) {
38
+ console.log(`Details for ${apiPath}:`, routeData);
39
+ } else {
40
+ console.error(`Route ${apiPath} not found in Swagger documentation.`);
41
+ }
42
+
43
+ // API-Route-Information vorbereiten
44
+ const apiRouteData = {
45
+ path: apiPath,
46
+ method: Object.keys(routeData)[0], // z.B. GET, POST, etc.
47
+ summary: routeData[Object.keys(routeData)[0]].summary,
48
+ description: routeData[Object.keys(routeData)[0]].description,
49
+ parameters: routeData[Object.keys(routeData)[0]].parameters || [],
50
+ responses: Object.entries(routeData[Object.keys(routeData)[0]].responses).map(([status, response]) => ({
51
+ status,
52
+ description: response.description
53
+ }))
54
+ };
55
+
56
+ // Mustache-Template einlesen
57
+ const template = fs.readFileSync('query_template.mustache', 'utf-8');
58
+
59
+ // Mustache-Rendering
60
+ const output = Mustache.render(template, apiRouteData);
61
+
62
+ // Ausgabe in eine Datei schreiben oder anzeigen
63
+ console.log(output);
64
+
65
+ const outputFilename = apiPath.replace(/\//g, '_') + '.md';
66
+
67
+ fs.writeFileSync(outputFilename, output);
68
+
69
+ })
70
+ .catch(err => {
71
+ console.error('Dereferencing failed:', err);
72
+ });
@@ -0,0 +1,176 @@
1
+ {
2
+ "name": "doc_generator",
3
+ "version": "1.0.0",
4
+ "lockfileVersion": 3,
5
+ "requires": true,
6
+ "packages": {
7
+ "": {
8
+ "name": "doc_generator",
9
+ "version": "1.0.0",
10
+ "license": "MIT",
11
+ "dependencies": {
12
+ "mustache": "^4.2.0",
13
+ "swagger-parser": "^10.0.3"
14
+ }
15
+ },
16
+ "node_modules/@apidevtools/json-schema-ref-parser": {
17
+ "version": "9.1.2",
18
+ "resolved": "https://registry.npmjs.org/@apidevtools/json-schema-ref-parser/-/json-schema-ref-parser-9.1.2.tgz",
19
+ "integrity": "sha512-r1w81DpR+KyRWd3f+rk6TNqMgedmAxZP5v5KWlXQWlgMUUtyEJch0DKEci1SorPMiSeM8XPl7MZ3miJ60JIpQg==",
20
+ "license": "MIT",
21
+ "dependencies": {
22
+ "@jsdevtools/ono": "^7.1.3",
23
+ "@types/json-schema": "^7.0.6",
24
+ "call-me-maybe": "^1.0.1",
25
+ "js-yaml": "^4.1.0"
26
+ }
27
+ },
28
+ "node_modules/@apidevtools/openapi-schemas": {
29
+ "version": "2.1.0",
30
+ "resolved": "https://registry.npmjs.org/@apidevtools/openapi-schemas/-/openapi-schemas-2.1.0.tgz",
31
+ "integrity": "sha512-Zc1AlqrJlX3SlpupFGpiLi2EbteyP7fXmUOGup6/DnkRgjP9bgMM/ag+n91rsv0U1Gpz0H3VILA/o3bW7Ua6BQ==",
32
+ "license": "MIT",
33
+ "engines": {
34
+ "node": ">=10"
35
+ }
36
+ },
37
+ "node_modules/@apidevtools/swagger-methods": {
38
+ "version": "3.0.2",
39
+ "resolved": "https://registry.npmjs.org/@apidevtools/swagger-methods/-/swagger-methods-3.0.2.tgz",
40
+ "integrity": "sha512-QAkD5kK2b1WfjDS/UQn/qQkbwF31uqRjPTrsCs5ZG9BQGAkjwvqGFjjPqAuzac/IYzpPtRzjCP1WrTuAIjMrXg==",
41
+ "license": "MIT"
42
+ },
43
+ "node_modules/@apidevtools/swagger-parser": {
44
+ "version": "10.0.3",
45
+ "resolved": "https://registry.npmjs.org/@apidevtools/swagger-parser/-/swagger-parser-10.0.3.tgz",
46
+ "integrity": "sha512-sNiLY51vZOmSPFZA5TF35KZ2HbgYklQnTSDnkghamzLb3EkNtcQnrBQEj5AOCxHpTtXpqMCRM1CrmV2rG6nw4g==",
47
+ "license": "MIT",
48
+ "dependencies": {
49
+ "@apidevtools/json-schema-ref-parser": "^9.0.6",
50
+ "@apidevtools/openapi-schemas": "^2.0.4",
51
+ "@apidevtools/swagger-methods": "^3.0.2",
52
+ "@jsdevtools/ono": "^7.1.3",
53
+ "call-me-maybe": "^1.0.1",
54
+ "z-schema": "^5.0.1"
55
+ },
56
+ "peerDependencies": {
57
+ "openapi-types": ">=7"
58
+ }
59
+ },
60
+ "node_modules/@jsdevtools/ono": {
61
+ "version": "7.1.3",
62
+ "resolved": "https://registry.npmjs.org/@jsdevtools/ono/-/ono-7.1.3.tgz",
63
+ "integrity": "sha512-4JQNk+3mVzK3xh2rqd6RB4J46qUR19azEHBneZyTZM+c456qOrbbM/5xcR8huNCCcbVt7+UmizG6GuUvPvKUYg==",
64
+ "license": "MIT"
65
+ },
66
+ "node_modules/@types/json-schema": {
67
+ "version": "7.0.15",
68
+ "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
69
+ "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
70
+ "license": "MIT"
71
+ },
72
+ "node_modules/argparse": {
73
+ "version": "2.0.1",
74
+ "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
75
+ "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
76
+ "license": "Python-2.0"
77
+ },
78
+ "node_modules/call-me-maybe": {
79
+ "version": "1.0.2",
80
+ "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz",
81
+ "integrity": "sha512-HpX65o1Hnr9HH25ojC1YGs7HCQLq0GCOibSaWER0eNpgJ/Z1MZv2mTc7+xh6WOPxbRVcmgbv4hGU+uSQ/2xFZQ==",
82
+ "license": "MIT"
83
+ },
84
+ "node_modules/commander": {
85
+ "version": "9.5.0",
86
+ "resolved": "https://registry.npmjs.org/commander/-/commander-9.5.0.tgz",
87
+ "integrity": "sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==",
88
+ "license": "MIT",
89
+ "optional": true,
90
+ "engines": {
91
+ "node": "^12.20.0 || >=14"
92
+ }
93
+ },
94
+ "node_modules/js-yaml": {
95
+ "version": "4.1.0",
96
+ "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
97
+ "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
98
+ "license": "MIT",
99
+ "dependencies": {
100
+ "argparse": "^2.0.1"
101
+ },
102
+ "bin": {
103
+ "js-yaml": "bin/js-yaml.js"
104
+ }
105
+ },
106
+ "node_modules/lodash.get": {
107
+ "version": "4.4.2",
108
+ "resolved": "https://registry.npmjs.org/lodash.get/-/lodash.get-4.4.2.tgz",
109
+ "integrity": "sha512-z+Uw/vLuy6gQe8cfaFWD7p0wVv8fJl3mbzXh33RS+0oW2wvUqiRXiQ69gLWSLpgB5/6sU+r6BlQR0MBILadqTQ==",
110
+ "license": "MIT"
111
+ },
112
+ "node_modules/lodash.isequal": {
113
+ "version": "4.5.0",
114
+ "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz",
115
+ "integrity": "sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==",
116
+ "license": "MIT"
117
+ },
118
+ "node_modules/mustache": {
119
+ "version": "4.2.0",
120
+ "resolved": "https://registry.npmjs.org/mustache/-/mustache-4.2.0.tgz",
121
+ "integrity": "sha512-71ippSywq5Yb7/tVYyGbkBggbU8H3u5Rz56fH60jGFgr8uHwxs+aSKeqmluIVzM0m0kB7xQjKS6qPfd0b2ZoqQ==",
122
+ "license": "MIT",
123
+ "bin": {
124
+ "mustache": "bin/mustache"
125
+ }
126
+ },
127
+ "node_modules/openapi-types": {
128
+ "version": "12.1.3",
129
+ "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz",
130
+ "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==",
131
+ "license": "MIT",
132
+ "peer": true
133
+ },
134
+ "node_modules/swagger-parser": {
135
+ "version": "10.0.3",
136
+ "resolved": "https://registry.npmjs.org/swagger-parser/-/swagger-parser-10.0.3.tgz",
137
+ "integrity": "sha512-nF7oMeL4KypldrQhac8RyHerJeGPD1p2xDh900GPvc+Nk7nWP6jX2FcC7WmkinMoAmoO774+AFXcWsW8gMWEIg==",
138
+ "license": "MIT",
139
+ "dependencies": {
140
+ "@apidevtools/swagger-parser": "10.0.3"
141
+ },
142
+ "engines": {
143
+ "node": ">=10"
144
+ }
145
+ },
146
+ "node_modules/validator": {
147
+ "version": "13.12.0",
148
+ "resolved": "https://registry.npmjs.org/validator/-/validator-13.12.0.tgz",
149
+ "integrity": "sha512-c1Q0mCiPlgdTVVVIJIrBuxNicYE+t/7oKeI9MWLj3fh/uq2Pxh/3eeWbVZ4OcGW1TUf53At0njHw5SMdA3tmMg==",
150
+ "license": "MIT",
151
+ "engines": {
152
+ "node": ">= 0.10"
153
+ }
154
+ },
155
+ "node_modules/z-schema": {
156
+ "version": "5.0.5",
157
+ "resolved": "https://registry.npmjs.org/z-schema/-/z-schema-5.0.5.tgz",
158
+ "integrity": "sha512-D7eujBWkLa3p2sIpJA0d1pr7es+a7m0vFAnZLlCEKq/Ij2k0MLi9Br2UPxoxdYystm5K1yeBGzub0FlYUEWj2Q==",
159
+ "license": "MIT",
160
+ "dependencies": {
161
+ "lodash.get": "^4.4.2",
162
+ "lodash.isequal": "^4.5.0",
163
+ "validator": "^13.7.0"
164
+ },
165
+ "bin": {
166
+ "z-schema": "bin/z-schema"
167
+ },
168
+ "engines": {
169
+ "node": ">=8.0.0"
170
+ },
171
+ "optionalDependencies": {
172
+ "commander": "^9.4.1"
173
+ }
174
+ }
175
+ }
176
+ }
@@ -0,0 +1,15 @@
1
+ {
2
+ "name": "doc_generator",
3
+ "version": "1.0.0",
4
+ "main": "generator.js",
5
+ "scripts": {
6
+ "test": "echo \"Error: no test specified\" && exit 1"
7
+ },
8
+ "author": "",
9
+ "license": "MIT",
10
+ "description": "",
11
+ "dependencies": {
12
+ "mustache": "^4.2.0",
13
+ "swagger-parser": "^10.0.3"
14
+ }
15
+ }
@@ -0,0 +1,20 @@
1
+ ### Query fields
2
+
3
+ **Summary**: {{summary}}
4
+
5
+ **Description**: {{description}}
6
+
7
+ #### Parameters:
8
+ {{#parameters}}
9
+ - Name: `{{name}}` Required: `{{required}}`
10
+ - Type: {{schema.type}}
11
+ {{#schema.oneOf}}
12
+ - {{type}}: {{example}}
13
+ {{/schema.oneOf}}
14
+ - Description: {{description}}
15
+ {{/parameters}}
16
+
17
+ #### Responses:
18
+ {{#responses}}
19
+ - **{{status}}**: {{description}}
20
+ {{/responses}}