@itentialopensource/adapter-tmf642_alarm_management 1.0.0 → 1.1.0

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.
Files changed (42) hide show
  1. package/CALLS.md +98 -62
  2. package/CHANGELOG.md +8 -0
  3. package/CONTRIBUTING.md +1 -160
  4. package/ENHANCE.md +2 -2
  5. package/README.md +31 -22
  6. package/adapter.js +159 -330
  7. package/adapterBase.js +538 -873
  8. package/changelogs/CHANGELOG.md +0 -0
  9. package/metadata.json +51 -0
  10. package/package.json +23 -25
  11. package/pronghorn.json +474 -142
  12. package/propertiesSchema.json +453 -40
  13. package/refs?service=git-upload-pack +0 -0
  14. package/report/adapter-openapi.json +8306 -0
  15. package/report/adapter-openapi.yaml +7907 -0
  16. package/report/adapterInfo.json +8 -8
  17. package/report/updateReport1691508884173.json +120 -0
  18. package/report/updateReport1692202199154.json +120 -0
  19. package/report/updateReport1692203301307.json +120 -0
  20. package/report/updateReport1694469174256.json +120 -0
  21. package/report/updateReport1698422900342.json +120 -0
  22. package/sampleProperties.json +63 -2
  23. package/test/integration/adapterTestBasicGet.js +1 -1
  24. package/test/integration/adapterTestConnectivity.js +91 -42
  25. package/test/integration/adapterTestIntegration.js +130 -2
  26. package/test/unit/adapterBaseTestUnit.js +388 -313
  27. package/test/unit/adapterTestUnit.js +307 -110
  28. package/utils/adapterInfo.js +1 -1
  29. package/utils/addAuth.js +1 -1
  30. package/utils/artifactize.js +1 -1
  31. package/utils/checkMigrate.js +1 -1
  32. package/utils/entitiesToDB.js +1 -0
  33. package/utils/findPath.js +1 -1
  34. package/utils/methodDocumentor.js +71 -23
  35. package/utils/modify.js +13 -15
  36. package/utils/packModificationScript.js +1 -1
  37. package/utils/taskMover.js +309 -0
  38. package/utils/tbScript.js +3 -10
  39. package/utils/tbUtils.js +2 -3
  40. package/utils/testRunner.js +1 -1
  41. package/utils/troubleshootingAdapter.js +1 -3
  42. package/workflows/README.md +0 -3
package/CALLS.md CHANGED
@@ -37,11 +37,6 @@ These are adapter methods that IAP or you might use. There are some other method
37
37
  <td style="padding:15px">This call provides the ability to update the adapter configuration from IAP - includes actions, schema, mockdata and other configurations.</td>
38
38
  <td style="padding:15px">Yes</td>
39
39
  </tr>
40
- <tr>
41
- <td style="padding:15px">iapFindAdapterPath(apiPath, callback)</td>
42
- <td style="padding:15px">This call provides the ability to see if a particular API path is supported by the adapter.</td>
43
- <td style="padding:15px">Yes</td>
44
- </tr>
45
40
  <tr>
46
41
  <td style="padding:15px">iapSuspendAdapter(mode, callback)</td>
47
42
  <td style="padding:15px">This call provides the ability to suspend the adapter and either have requests rejected or put into a queue to be processed after the adapter is resumed.</td>
@@ -57,12 +52,16 @@ These are adapter methods that IAP or you might use. There are some other method
57
52
  <td style="padding:15px">This call will return the requests that are waiting in the queue if throttling is enabled.</td>
58
53
  <td style="padding:15px">Yes</td>
59
54
  </tr>
55
+ <tr>
56
+ <td style="padding:15px">iapFindAdapterPath(apiPath, callback)</td>
57
+ <td style="padding:15px">This call provides the ability to see if a particular API path is supported by the adapter.</td>
58
+ <td style="padding:15px">Yes</td>
59
+ </tr>
60
60
  <tr>
61
61
  <td style="padding:15px">iapTroubleshootAdapter(props, persistFlag, adapter, callback)</td>
62
62
  <td style="padding:15px">This call can be used to check on the performance of the adapter - it checks connectivity, healthcheck and basic get calls.</td>
63
63
  <td style="padding:15px">Yes</td>
64
64
  </tr>
65
-
66
65
  <tr>
67
66
  <td style="padding:15px">iapRunAdapterHealthcheck(adapter, callback)</td>
68
67
  <td style="padding:15px">This call will return the results of a healthcheck.</td>
@@ -83,6 +82,21 @@ These are adapter methods that IAP or you might use. There are some other method
83
82
  <td style="padding:15px">This call will push the adapter configuration from the entities directory into the Adapter or IAP Database.</td>
84
83
  <td style="padding:15px">Yes</td>
85
84
  </tr>
85
+ <tr>
86
+ <td style="padding:15px">iapDeactivateTasks(tasks, callback)</td>
87
+ <td style="padding:15px">This call provides the ability to remove tasks from the adapter.</td>
88
+ <td style="padding:15px">Yes</td>
89
+ </tr>
90
+ <tr>
91
+ <td style="padding:15px">iapActivateTasks(tasks, callback)</td>
92
+ <td style="padding:15px">This call provides the ability to add deactivated tasks back into the adapter.</td>
93
+ <td style="padding:15px">Yes</td>
94
+ </tr>
95
+ <tr>
96
+ <td style="padding:15px">iapExpandedGenericAdapterRequest(metadata, uriPath, restMethod, pathVars, queryData, requestBody, addlHeaders, callback)</td>
97
+ <td style="padding:15px">This is an expanded Generic Call. The metadata object allows us to provide many new capabilities within the generic request.</td>
98
+ <td style="padding:15px">Yes</td>
99
+ </tr>
86
100
  <tr>
87
101
  <td style="padding:15px">genericAdapterRequest(uriPath, restMethod, queryData, requestBody, addlHeaders, callback)</td>
88
102
  <td style="padding:15px">This call allows you to provide the path to have the adapter call. It is an easy way to incorporate paths that have not been built into the adapter yet.</td>
@@ -94,23 +108,46 @@ These are adapter methods that IAP or you might use. There are some other method
94
108
  <td style="padding:15px">Yes</td>
95
109
  </tr>
96
110
  <tr>
97
- <td style="padding:15px">iapHasAdapterEntity(entityType, entityId, callback)</td>
98
- <td style="padding:15px">This call verifies the adapter has the specific entity.</td>
99
- <td style="padding:15px">No</td>
111
+ <td style="padding:15px">iapRunAdapterLint(callback)</td>
112
+ <td style="padding:15px">Runs lint on the addapter and provides the information back.</td>
113
+ <td style="padding:15px">Yes</td>
100
114
  </tr>
101
115
  <tr>
102
- <td style="padding:15px">iapVerifyAdapterCapability(entityType, actionType, entityId, callback)</td>
103
- <td style="padding:15px">This call verifies the adapter can perform the provided action on the specific entity.</td>
104
- <td style="padding:15px">No</td>
116
+ <td style="padding:15px">iapRunAdapterTests(callback)</td>
117
+ <td style="padding:15px">Runs baseunit and unit tests on the adapter and provides the information back.</td>
118
+ <td style="padding:15px">Yes</td>
105
119
  </tr>
106
120
  <tr>
107
- <td style="padding:15px">iapUpdateAdapterEntityCache()</td>
108
- <td style="padding:15px">This call will update the entity cache.</td>
109
- <td style="padding:15px">No</td>
121
+ <td style="padding:15px">iapGetAdapterInventory(callback)</td>
122
+ <td style="padding:15px">This call provides some inventory related information about the adapter.</td>
123
+ <td style="padding:15px">Yes</td>
110
124
  </tr>
111
125
  </table>
112
126
  <br>
127
+
128
+ ### Adapter Cache Calls
113
129
 
130
+ These are adapter methods that are used for adapter caching. If configured, the adapter will cache based on the interval provided. However, you can force a population of the cache manually as well.
131
+
132
+ <table border="1" class="bordered-table">
133
+ <tr>
134
+ <th bgcolor="lightgrey" style="padding:15px"><span style="font-size:12.0pt">Method Signature</span></th>
135
+ <th bgcolor="lightgrey" style="padding:15px"><span style="font-size:12.0pt">Description</span></th>
136
+ <th bgcolor="lightgrey" style="padding:15px"><span style="font-size:12.0pt">Workflow?</span></th>
137
+ </tr>
138
+ <tr>
139
+ <td style="padding:15px">iapPopulateEntityCache(entityTypes, callback)</td>
140
+ <td style="padding:15px">This call populates the adapter cache.</td>
141
+ <td style="padding:15px">Yes</td>
142
+ </tr>
143
+ <tr>
144
+ <td style="padding:15px">iapRetrieveEntitiesCache(entityType, options, callback)</td>
145
+ <td style="padding:15px">This call retrieves the specific items from the adapter cache.</td>
146
+ <td style="padding:15px">Yes</td>
147
+ </tr>
148
+ </table>
149
+ <br>
150
+
114
151
  ### Adapter Broker Calls
115
152
 
116
153
  These are adapter methods that are used to integrate to IAP Brokers. This adapter currently supports the following broker calls.
@@ -129,32 +166,31 @@ These are adapter methods that are used to integrate to IAP Brokers. This adapte
129
166
  <tr>
130
167
  <td style="padding:15px">getDevice(deviceName, callback)</td>
131
168
  <td style="padding:15px">This call returns the details of the requested device.</td>
132
- <td style="padding:15px">Yes</td>
169
+ <td style="padding:15px">No</td>
133
170
  </tr>
134
171
  <tr>
135
172
  <td style="padding:15px">getDevicesFiltered(options, callback)</td>
136
173
  <td style="padding:15px">This call returns the list of devices that match the criteria provided in the options filter.</td>
137
- <td style="padding:15px">Yes</td>
174
+ <td style="padding:15px">No</td>
138
175
  </tr>
139
176
  <tr>
140
177
  <td style="padding:15px">isAlive(deviceName, callback)</td>
141
178
  <td style="padding:15px">This call returns whether the device status is active</td>
142
- <td style="padding:15px">Yes</td>
179
+ <td style="padding:15px">No</td>
143
180
  </tr>
144
181
  <tr>
145
182
  <td style="padding:15px">getConfig(deviceName, format, callback)</td>
146
183
  <td style="padding:15px">This call returns the configuration for the selected device.</td>
147
- <td style="padding:15px">Yes</td>
184
+ <td style="padding:15px">No</td>
148
185
  </tr>
149
186
  <tr>
150
187
  <td style="padding:15px">iapGetDeviceCount(callback)</td>
151
188
  <td style="padding:15px">This call returns the count of devices.</td>
152
- <td style="padding:15px">Yes</td>
189
+ <td style="padding:15px">No</td>
153
190
  </tr>
154
191
  </table>
155
192
  <br>
156
193
 
157
-
158
194
  ### Specific Adapter Calls
159
195
 
160
196
  Specific adapter calls are built based on the API of the tmf642_alarm_management. The Adapter Builder creates the proper method comments for generating JS-DOC for the adapter. This is the best way to get information on the calls.
@@ -168,247 +204,247 @@ Specific adapter calls are built based on the API of the tmf642_alarm_management
168
204
  </tr>
169
205
  <tr>
170
206
  <td style="padding:15px">listAlarm(fields, offset, limit, callback)</td>
171
- <td style="padding:15px">This operation list or find Alarm entities</td>
207
+ <td style="padding:15px">List or find Alarm objects</td>
172
208
  <td style="padding:15px">{base_path}/{version}/alarm?{query}</td>
173
209
  <td style="padding:15px">Yes</td>
174
210
  </tr>
175
211
  <tr>
176
212
  <td style="padding:15px">createAlarm(alarm, callback)</td>
177
- <td style="padding:15px">This operation creates a Alarm entity.</td>
213
+ <td style="padding:15px">Creates a Alarm</td>
178
214
  <td style="padding:15px">{base_path}/{version}/alarm?{query}</td>
179
215
  <td style="padding:15px">Yes</td>
180
216
  </tr>
181
217
  <tr>
182
218
  <td style="padding:15px">retrieveAlarm(id, fields, callback)</td>
183
- <td style="padding:15px">This operation retrieves a Alarm entity. Attribute selection is enabled for all first level attributes.</td>
219
+ <td style="padding:15px">Retrieves a Alarm by ID</td>
184
220
  <td style="padding:15px">{base_path}/{version}/alarm/{pathv1}?{query}</td>
185
221
  <td style="padding:15px">Yes</td>
186
222
  </tr>
187
223
  <tr>
188
224
  <td style="padding:15px">patchAlarm(id, alarm, callback)</td>
189
- <td style="padding:15px">This operation updates partially a Alarm entity.</td>
225
+ <td style="padding:15px">Updates partially a Alarm</td>
190
226
  <td style="padding:15px">{base_path}/{version}/alarm/{pathv1}?{query}</td>
191
227
  <td style="padding:15px">Yes</td>
192
228
  </tr>
193
229
  <tr>
194
230
  <td style="padding:15px">deleteAlarm(id, callback)</td>
195
- <td style="padding:15px">This operation deletes a Alarm entity.</td>
231
+ <td style="padding:15px">Deletes a Alarm</td>
196
232
  <td style="padding:15px">{base_path}/{version}/alarm/{pathv1}?{query}</td>
197
233
  <td style="padding:15px">Yes</td>
198
234
  </tr>
199
235
  <tr>
200
236
  <td style="padding:15px">listAckAlarms(fields, offset, limit, callback)</td>
201
- <td style="padding:15px">This operation list or find AckAlarms entities</td>
237
+ <td style="padding:15px">List or find AckAlarms objects</td>
202
238
  <td style="padding:15px">{base_path}/{version}/ackAlarms?{query}</td>
203
239
  <td style="padding:15px">Yes</td>
204
240
  </tr>
205
241
  <tr>
206
242
  <td style="padding:15px">createAckAlarms(ackAlarms, callback)</td>
207
- <td style="padding:15px">This operation creates a AckAlarms entity.</td>
243
+ <td style="padding:15px">Creates a AckAlarms</td>
208
244
  <td style="padding:15px">{base_path}/{version}/ackAlarms?{query}</td>
209
245
  <td style="padding:15px">Yes</td>
210
246
  </tr>
211
247
  <tr>
212
248
  <td style="padding:15px">retrieveAckAlarms(id, fields, callback)</td>
213
- <td style="padding:15px">This operation retrieves a AckAlarms entity. Attribute selection is enabled for all first level attributes.</td>
249
+ <td style="padding:15px">Retrieves a AckAlarms by ID</td>
214
250
  <td style="padding:15px">{base_path}/{version}/ackAlarms/{pathv1}?{query}</td>
215
251
  <td style="padding:15px">Yes</td>
216
252
  </tr>
217
253
  <tr>
218
254
  <td style="padding:15px">listUnAckAlarms(fields, offset, limit, callback)</td>
219
- <td style="padding:15px">This operation list or find UnAckAlarms entities</td>
255
+ <td style="padding:15px">List or find UnAckAlarms objects</td>
220
256
  <td style="padding:15px">{base_path}/{version}/unAckAlarms?{query}</td>
221
257
  <td style="padding:15px">Yes</td>
222
258
  </tr>
223
259
  <tr>
224
260
  <td style="padding:15px">createUnAckAlarms(unAckAlarms, callback)</td>
225
- <td style="padding:15px">This operation creates a UnAckAlarms entity.</td>
261
+ <td style="padding:15px">Creates a UnAckAlarms</td>
226
262
  <td style="padding:15px">{base_path}/{version}/unAckAlarms?{query}</td>
227
263
  <td style="padding:15px">Yes</td>
228
264
  </tr>
229
265
  <tr>
230
266
  <td style="padding:15px">retrieveUnAckAlarms(id, fields, callback)</td>
231
- <td style="padding:15px">This operation retrieves a UnAckAlarms entity. Attribute selection is enabled for all first level attributes.</td>
267
+ <td style="padding:15px">Retrieves a UnAckAlarms by ID</td>
232
268
  <td style="padding:15px">{base_path}/{version}/unAckAlarms/{pathv1}?{query}</td>
233
269
  <td style="padding:15px">Yes</td>
234
270
  </tr>
235
271
  <tr>
236
272
  <td style="padding:15px">listClearAlarms(fields, offset, limit, callback)</td>
237
- <td style="padding:15px">This operation list or find ClearAlarms entities</td>
273
+ <td style="padding:15px">List or find ClearAlarms objects</td>
238
274
  <td style="padding:15px">{base_path}/{version}/clearAlarms?{query}</td>
239
275
  <td style="padding:15px">Yes</td>
240
276
  </tr>
241
277
  <tr>
242
278
  <td style="padding:15px">createClearAlarms(clearAlarms, callback)</td>
243
- <td style="padding:15px">This operation creates a ClearAlarms entity.</td>
279
+ <td style="padding:15px">Creates a ClearAlarms</td>
244
280
  <td style="padding:15px">{base_path}/{version}/clearAlarms?{query}</td>
245
281
  <td style="padding:15px">Yes</td>
246
282
  </tr>
247
283
  <tr>
248
284
  <td style="padding:15px">retrieveClearAlarms(id, fields, callback)</td>
249
- <td style="padding:15px">This operation retrieves a ClearAlarms entity. Attribute selection is enabled for all first level attributes.</td>
285
+ <td style="padding:15px">Retrieves a ClearAlarms by ID</td>
250
286
  <td style="padding:15px">{base_path}/{version}/clearAlarms/{pathv1}?{query}</td>
251
287
  <td style="padding:15px">Yes</td>
252
288
  </tr>
253
289
  <tr>
254
290
  <td style="padding:15px">listCommentAlarms(fields, offset, limit, callback)</td>
255
- <td style="padding:15px">This operation list or find CommentAlarms entities</td>
291
+ <td style="padding:15px">List or find CommentAlarms objects</td>
256
292
  <td style="padding:15px">{base_path}/{version}/commentAlarms?{query}</td>
257
293
  <td style="padding:15px">Yes</td>
258
294
  </tr>
259
295
  <tr>
260
296
  <td style="padding:15px">createCommentAlarms(commentAlarms, callback)</td>
261
- <td style="padding:15px">This operation creates a CommentAlarms entity.</td>
297
+ <td style="padding:15px">Creates a CommentAlarms</td>
262
298
  <td style="padding:15px">{base_path}/{version}/commentAlarms?{query}</td>
263
299
  <td style="padding:15px">Yes</td>
264
300
  </tr>
265
301
  <tr>
266
302
  <td style="padding:15px">retrieveCommentAlarms(id, fields, callback)</td>
267
- <td style="padding:15px">This operation retrieves a CommentAlarms entity. Attribute selection is enabled for all first level attributes.</td>
303
+ <td style="padding:15px">Retrieves a CommentAlarms by ID</td>
268
304
  <td style="padding:15px">{base_path}/{version}/commentAlarms/{pathv1}?{query}</td>
269
305
  <td style="padding:15px">Yes</td>
270
306
  </tr>
271
307
  <tr>
272
308
  <td style="padding:15px">listGroupAlarms(fields, offset, limit, callback)</td>
273
- <td style="padding:15px">This operation list or find GroupAlarms entities</td>
309
+ <td style="padding:15px">List or find GroupAlarms objects</td>
274
310
  <td style="padding:15px">{base_path}/{version}/groupAlarms?{query}</td>
275
311
  <td style="padding:15px">Yes</td>
276
312
  </tr>
277
313
  <tr>
278
314
  <td style="padding:15px">createGroupAlarms(groupAlarms, callback)</td>
279
- <td style="padding:15px">This operation creates a GroupAlarms entity.</td>
315
+ <td style="padding:15px">Creates a GroupAlarms</td>
280
316
  <td style="padding:15px">{base_path}/{version}/groupAlarms?{query}</td>
281
317
  <td style="padding:15px">Yes</td>
282
318
  </tr>
283
319
  <tr>
284
320
  <td style="padding:15px">retrieveGroupAlarms(id, fields, callback)</td>
285
- <td style="padding:15px">This operation retrieves a GroupAlarms entity. Attribute selection is enabled for all first level attributes.</td>
321
+ <td style="padding:15px">Retrieves a GroupAlarms by ID</td>
286
322
  <td style="padding:15px">{base_path}/{version}/groupAlarms/{pathv1}?{query}</td>
287
323
  <td style="padding:15px">Yes</td>
288
324
  </tr>
289
325
  <tr>
290
326
  <td style="padding:15px">listUnGroupAlarms(fields, offset, limit, callback)</td>
291
- <td style="padding:15px">This operation list or find UnGroupAlarms entities</td>
327
+ <td style="padding:15px">List or find UnGroupAlarms objects</td>
292
328
  <td style="padding:15px">{base_path}/{version}/unGroupAlarms?{query}</td>
293
329
  <td style="padding:15px">Yes</td>
294
330
  </tr>
295
331
  <tr>
296
332
  <td style="padding:15px">createUnGroupAlarms(unGroupAlarms, callback)</td>
297
- <td style="padding:15px">This operation creates a UnGroupAlarms entity.</td>
333
+ <td style="padding:15px">Creates a UnGroupAlarms</td>
298
334
  <td style="padding:15px">{base_path}/{version}/unGroupAlarms?{query}</td>
299
335
  <td style="padding:15px">Yes</td>
300
336
  </tr>
301
337
  <tr>
302
338
  <td style="padding:15px">retrieveUnGroupAlarms(id, fields, callback)</td>
303
- <td style="padding:15px">This operation retrieves a UnGroupAlarms entity. Attribute selection is enabled for all first level attributes.</td>
339
+ <td style="padding:15px">Retrieves a UnGroupAlarms by ID</td>
304
340
  <td style="padding:15px">{base_path}/{version}/unGroupAlarms/{pathv1}?{query}</td>
305
341
  <td style="padding:15px">Yes</td>
306
342
  </tr>
307
343
  <tr>
308
344
  <td style="padding:15px">registerListener(data, callback)</td>
309
- <td style="padding:15px">Sets the communication endpoint address the service instance must use to deliver information about its health state, execution state, failures and metrics.</td>
345
+ <td style="padding:15px">Register a listener</td>
310
346
  <td style="padding:15px">{base_path}/{version}/hub?{query}</td>
311
347
  <td style="padding:15px">Yes</td>
312
348
  </tr>
313
349
  <tr>
314
350
  <td style="padding:15px">unregisterListener(id, callback)</td>
315
- <td style="padding:15px">Resets the communication endpoint address the service instance must use to deliver information about its health state, execution state, failures and metrics.</td>
351
+ <td style="padding:15px">Unregister a listener</td>
316
352
  <td style="padding:15px">{base_path}/{version}/hub/{pathv1}?{query}</td>
317
353
  <td style="padding:15px">Yes</td>
318
354
  </tr>
319
355
  <tr>
320
356
  <td style="padding:15px">listenToAlarmCreateEvent(data, callback)</td>
321
- <td style="padding:15px">Example of a client listener for receiving the notification AlarmCreateEvent</td>
357
+ <td style="padding:15px">Client listener for entity AlarmCreateEvent</td>
322
358
  <td style="padding:15px">{base_path}/{version}/listener/alarmCreateEvent?{query}</td>
323
359
  <td style="padding:15px">Yes</td>
324
360
  </tr>
325
361
  <tr>
326
362
  <td style="padding:15px">listenToAlarmAttributeValueChangeEvent(data, callback)</td>
327
- <td style="padding:15px">Example of a client listener for receiving the notification AlarmAttributeValueChangeEvent</td>
363
+ <td style="padding:15px">Client listener for entity AlarmAttributeValueChangeEvent</td>
328
364
  <td style="padding:15px">{base_path}/{version}/listener/alarmAttributeValueChangeEvent?{query}</td>
329
365
  <td style="padding:15px">Yes</td>
330
366
  </tr>
331
367
  <tr>
332
368
  <td style="padding:15px">listenToAlarmStateChangeEvent(data, callback)</td>
333
- <td style="padding:15px">Example of a client listener for receiving the notification AlarmStateChangeEvent</td>
369
+ <td style="padding:15px">Client listener for entity AlarmStateChangeEvent</td>
334
370
  <td style="padding:15px">{base_path}/{version}/listener/alarmStateChangeEvent?{query}</td>
335
371
  <td style="padding:15px">Yes</td>
336
372
  </tr>
337
373
  <tr>
338
374
  <td style="padding:15px">listenToAlarmDeleteEvent(data, callback)</td>
339
- <td style="padding:15px">Example of a client listener for receiving the notification AlarmDeleteEvent</td>
375
+ <td style="padding:15px">Client listener for entity AlarmDeleteEvent</td>
340
376
  <td style="padding:15px">{base_path}/{version}/listener/alarmDeleteEvent?{query}</td>
341
377
  <td style="padding:15px">Yes</td>
342
378
  </tr>
343
379
  <tr>
344
380
  <td style="padding:15px">listenToAckAlarmsCreateEvent(data, callback)</td>
345
- <td style="padding:15px">Example of a client listener for receiving the notification AckAlarmsCreateEvent</td>
381
+ <td style="padding:15px">Client listener for entity AckAlarmsCreateEvent</td>
346
382
  <td style="padding:15px">{base_path}/{version}/listener/ackAlarmsCreateEvent?{query}</td>
347
383
  <td style="padding:15px">Yes</td>
348
384
  </tr>
349
385
  <tr>
350
386
  <td style="padding:15px">listenToAckAlarmsStateChangeEvent(data, callback)</td>
351
- <td style="padding:15px">Example of a client listener for receiving the notification AckAlarmsStateChangeEvent</td>
387
+ <td style="padding:15px">Client listener for entity AckAlarmsStateChangeEvent</td>
352
388
  <td style="padding:15px">{base_path}/{version}/listener/ackAlarmsStateChangeEvent?{query}</td>
353
389
  <td style="padding:15px">Yes</td>
354
390
  </tr>
355
391
  <tr>
356
392
  <td style="padding:15px">listenToUnAckAlarmsCreateEvent(data, callback)</td>
357
- <td style="padding:15px">Example of a client listener for receiving the notification UnAckAlarmsCreateEvent</td>
393
+ <td style="padding:15px">Client listener for entity UnAckAlarmsCreateEvent</td>
358
394
  <td style="padding:15px">{base_path}/{version}/listener/unAckAlarmsCreateEvent?{query}</td>
359
395
  <td style="padding:15px">Yes</td>
360
396
  </tr>
361
397
  <tr>
362
398
  <td style="padding:15px">listenToUnAckAlarmsStateChangeEvent(data, callback)</td>
363
- <td style="padding:15px">Example of a client listener for receiving the notification UnAckAlarmsStateChangeEvent</td>
399
+ <td style="padding:15px">Client listener for entity UnAckAlarmsStateChangeEvent</td>
364
400
  <td style="padding:15px">{base_path}/{version}/listener/unAckAlarmsStateChangeEvent?{query}</td>
365
401
  <td style="padding:15px">Yes</td>
366
402
  </tr>
367
403
  <tr>
368
404
  <td style="padding:15px">listenToClearAlarmsCreateEvent(data, callback)</td>
369
- <td style="padding:15px">Example of a client listener for receiving the notification ClearAlarmsCreateEvent</td>
405
+ <td style="padding:15px">Client listener for entity ClearAlarmsCreateEvent</td>
370
406
  <td style="padding:15px">{base_path}/{version}/listener/clearAlarmsCreateEvent?{query}</td>
371
407
  <td style="padding:15px">Yes</td>
372
408
  </tr>
373
409
  <tr>
374
410
  <td style="padding:15px">listenToClearAlarmsStateChangeEvent(data, callback)</td>
375
- <td style="padding:15px">Example of a client listener for receiving the notification ClearAlarmsStateChangeEvent</td>
411
+ <td style="padding:15px">Client listener for entity ClearAlarmsStateChangeEvent</td>
376
412
  <td style="padding:15px">{base_path}/{version}/listener/clearAlarmsStateChangeEvent?{query}</td>
377
413
  <td style="padding:15px">Yes</td>
378
414
  </tr>
379
415
  <tr>
380
416
  <td style="padding:15px">listenToCommentAlarmsCreateEvent(data, callback)</td>
381
- <td style="padding:15px">Example of a client listener for receiving the notification CommentAlarmsCreateEvent</td>
417
+ <td style="padding:15px">Client listener for entity CommentAlarmsCreateEvent</td>
382
418
  <td style="padding:15px">{base_path}/{version}/listener/commentAlarmsCreateEvent?{query}</td>
383
419
  <td style="padding:15px">Yes</td>
384
420
  </tr>
385
421
  <tr>
386
422
  <td style="padding:15px">listenToCommentAlarmsStateChangeEvent(data, callback)</td>
387
- <td style="padding:15px">Example of a client listener for receiving the notification CommentAlarmsStateChangeEvent</td>
423
+ <td style="padding:15px">Client listener for entity CommentAlarmsStateChangeEvent</td>
388
424
  <td style="padding:15px">{base_path}/{version}/listener/commentAlarmsStateChangeEvent?{query}</td>
389
425
  <td style="padding:15px">Yes</td>
390
426
  </tr>
391
427
  <tr>
392
428
  <td style="padding:15px">listenToGroupAlarmsCreateEvent(data, callback)</td>
393
- <td style="padding:15px">Example of a client listener for receiving the notification GroupAlarmsCreateEvent</td>
429
+ <td style="padding:15px">Client listener for entity GroupAlarmsCreateEvent</td>
394
430
  <td style="padding:15px">{base_path}/{version}/listener/groupAlarmsCreateEvent?{query}</td>
395
431
  <td style="padding:15px">Yes</td>
396
432
  </tr>
397
433
  <tr>
398
434
  <td style="padding:15px">listenToGroupAlarmsStateChangeEvent(data, callback)</td>
399
- <td style="padding:15px">Example of a client listener for receiving the notification GroupAlarmsStateChangeEvent</td>
435
+ <td style="padding:15px">Client listener for entity GroupAlarmsStateChangeEvent</td>
400
436
  <td style="padding:15px">{base_path}/{version}/listener/groupAlarmsStateChangeEvent?{query}</td>
401
437
  <td style="padding:15px">Yes</td>
402
438
  </tr>
403
439
  <tr>
404
440
  <td style="padding:15px">listenToUnGroupAlarmsCreateEvent(data, callback)</td>
405
- <td style="padding:15px">Example of a client listener for receiving the notification UnGroupAlarmsCreateEvent</td>
441
+ <td style="padding:15px">Client listener for entity UnGroupAlarmsCreateEvent</td>
406
442
  <td style="padding:15px">{base_path}/{version}/listener/unGroupAlarmsCreateEvent?{query}</td>
407
443
  <td style="padding:15px">Yes</td>
408
444
  </tr>
409
445
  <tr>
410
446
  <td style="padding:15px">listenToUnGroupAlarmsStateChangeEvent(data, callback)</td>
411
- <td style="padding:15px">Example of a client listener for receiving the notification UnGroupAlarmsStateChangeEvent</td>
447
+ <td style="padding:15px">Client listener for entity UnGroupAlarmsStateChangeEvent</td>
412
448
  <td style="padding:15px">{base_path}/{version}/listener/unGroupAlarmsStateChangeEvent?{query}</td>
413
449
  <td style="padding:15px">Yes</td>
414
450
  </tr>
package/CHANGELOG.md CHANGED
@@ -1,4 +1,12 @@
1
1
 
2
+ ## 1.1.0 [01-04-2024]
3
+
4
+ * Adapter Engine has been updated and the changes are being migrated to the adapter
5
+
6
+ See merge request itentialopensource/adapters/telemetry-analytics/adapter-tmf642_alarm_management!1
7
+
8
+ ---
9
+
2
10
  ## 1.0.0 [10-17-2023]
3
11
 
4
12
  * name change
package/CONTRIBUTING.md CHANGED
@@ -10,163 +10,4 @@ This project and everyone participating in it is governed by the Code of Conduct
10
10
 
11
11
  ## How to Contribute
12
12
 
13
- ### Reporting Bugs
14
-
15
- This section guides you through submitting a bug report. Following these guidelines helps maintainers understand your report :pencil:, reproduce the behavior :computer: :left_right_arrow: :computer:, and find related reports :mag_right:.
16
-
17
- Before creating bug reports, please check before-submitting-a-bug-report, as you might find out that you don't need to create one. When you are creating a bug report, please include as many details as possible. If you have an Itential support contract, please create an Itential Service Desk ticket. If you don't have an Itential support contract, please send an email of the issue to support@itential.com.
18
-
19
- #### Before Submitting A Bug Report
20
-
21
- * **Check the README.md.** You might be able to find the cause of the problem and fix things yourself. Most importantly, check if you can reproduce the problem __in the latest version__.
22
- * **Work through the troubleshooting process.** Troubleshooting will include changing the log level of Itential Automation Platform (IAP) and adapters and checking the logs to see what the issues are. These logs should be included in any ticket you open for this issue.
23
- * **Check for resolutions to the issue.** Check the <a href="https://itential.atlassian.net/servicedesk/customer/kb/view/286883841?applicationId=605994d2-2cb2-3174-af59-ed5b23ff5fd5&spaceKey=PKB&src=1187380921" target="_blank">Itential Knowledge Base</a> to see if there is a known resolution for the issue you are having.
24
- * **Ask around in chat if you are an Itential employee** to see if others are experiencing the same issue.
25
-
26
- #### How to Submit a (Good) Bug Report
27
-
28
- Bugs are tracked through the Itential Service Desk. Explain the problem and include additional details to help maintainers reproduce the problem:
29
-
30
- - **Use a clear and descriptive title** for the issue to identify the problem.
31
- - **Describe the exact steps which reproduce the problem** in as much detail as possible. For example, start by explaining how you configured the adapter (e.g., which properties you used and how they were set) or how you are using an artifact.
32
- - **Provide specific examples to demonstrate the steps**. Include logs, or copy/paste snippets, in your examples.
33
- - **Describe the behavior you observed after following the steps** and point out what exactly is the problem with that behavior.
34
- - **Explain which behavior you expected to see instead and why.**
35
- - **Include screenshots and animated GIFs** which show you following the described steps and clearly demonstrate the problem. You can use <a href="https://www.cockos.com/licecap/" target="_blank">this tool</a> to record GIFs on macOS and Windows. Use <a href="https://github.com/colinkeenan/silentcast" target="_blank">this tool</a> or <a href="https://github.com/rhcarvalho/byzanz-guiz" target="_blank">program</a> on Linux.
36
- - **If the problem wasn't triggered by a specific action**, describe what you were doing before the problem happened and share more information using the guidelines below.
37
-
38
- Provide more context by answering these questions:
39
-
40
- - **Did the problem start happening recently** (e.g. after updating to a new version/tag) or was this always a problem?
41
- - If the problem started happening recently, **can you reproduce the problem in an older version/tag?** What's the most recent version in which the problem does not happen?
42
- - **Can you reliably reproduce the issue?** If not, provide details about how often the problem happens and under which conditions it normally happens.
43
-
44
- Include details about your configuration and environment:
45
-
46
- - **Which version of the adapter/artifact are you using?** You can get the exact version by checking the project version in the package.json file.
47
- - **What's the name and version of the OS you're using**?
48
- - **Are you running or using IAP in a virtual machine?** If so, which VM software are you using and which operating systems and versions are used for the host and guest?
49
- - **Are there firewalls between IAP and any other system you are integrating with?** If so, have you tried running curl from the system IAP is on to the other system to verify you have connectivity between the systems?
50
-
51
- ### Your First Code Contribution
52
-
53
- #### Local development
54
-
55
- This project can be developed locally on all operating systems. For instructions on how to do this, follow the steps highlighted in the README.md. The README.mdprovides many more details on cloning the repository for local development, how to lint and test your changes.
56
-
57
- #### Development Process
58
-
59
- The following provides a local copy of the repository along with dependencies.
60
-
61
- ```json
62
- go to the repository you are interested in working on
63
- click on the Clone button to get the link(s) you can use to clone the repository
64
- git clone <link to clone the project>
65
- npm install
66
- ```
67
-
68
- Prior to making changes you should create a branch to work in. The branch should be named with the type of change (major, minor or patch) and then a Jira issue number or a description of the issue.
69
-
70
- ```json
71
- git checkout -b <name_of_your_new_branch>
72
- ```
73
-
74
- Make all of the desired changes.
75
-
76
- > **Note:** All code changes should be accompanied by additional Unit and Integration tests to minimize the likelihood that any changes will negatively impact the adapter/artifact as well as to ensure the desired functionality is achieved.
77
-
78
-
79
- <table border="1" class="bordered-table">
80
- <tr>
81
- <th bgcolor="lightgrey" style="padding:15px"><span style="font-size:12.0pt">Files</span></th>
82
- <th bgcolor="lightgrey" style="padding:15px"><span style="font-size:12.0pt">Changes</span></th>
83
- </tr>
84
- <tr>
85
- <td style="padding:15px">.codeclimate.yml, .eslintignore, .eslintrc.js, .gitignore, .gitlab-ci.yml, .jshintrc, .npmignore</td>
86
- <td style="padding:15px">These are foundational files that are used in linting and building of the adapter. Changes to these files are heavily scrutinized and may be implemented in a different manner so that the changes can be implemented across all adapters.</td>
87
- </tr>
88
- <tr>
89
- <td style="padding:15px">CODE_OF_CONDUCT.md, CONTRIBUTING.md, LICENSE, README.md</td>
90
- <td style="padding:15px">These are license and process files for the repository. Changes to these files may require legal review and may also be implemented in a different manner so that the changes can be implemented across all adapters.</td>
91
- </tr>
92
- <tr>
93
- <td style="padding:15px">utils/*, adapterBase.js</td>
94
- <td style="padding:15px">Changes to these files will rarely be accepted. These are process files that need to be changed through the builder process and migration.</td>
95
- </tr>
96
- <tr>
97
- <td style="padding:15px">adapter.js</td>
98
- <td style="padding:15px">Changes to this file are code changes. They should be accompanied by the appropriate unit and integration tests. If new methods are added, they should also be added to the pronghorn.json file, otherwise integration tests are likely to fail.</td>
99
- </tr>
100
- <tr>
101
- <td style="padding:15px">error.json, propertiesSchema.json</td>
102
- <td style="padding:15px">These files are utilized by the Itential Runtime libraries. You can make changes to these files, but the changes should be appending of new errors or properties. Removal of errors and properties can result in rejection of the changes.</td>
103
- </tr>
104
- <tr>
105
- <td style="padding:15px">pacakge.json, package-lock.json</td>
106
- <td style="padding:15px">The package-lock.json is automatically generated and should only be updated when the dependencies inside of the package.json are modified. You can make changes to the package.json to add additional scripts, add new dependencies, modify names, etc. However, changing the scripts or dependencies that are Itential specific will be overriden during the acceptance process.</td>
107
- </tr>
108
- <tr>
109
- <td style="padding:15px">pronghorn.json</td>
110
- <td style="padding:15px">Changes to this file are made for integration into IAP. The most common change here is adding new methods that shoud be exposed to the IAP Workflow.</td>
111
- </tr>
112
- <tr>
113
- <td style="padding:15px">entities/*</td>
114
- <td style="padding:15px">Changes to these files include adding new capabilities, updating existing capabilities, or removing deprecated capabilities in the adapter. Translation configuration can also be modified here.</td>
115
- </tr>
116
- <tr>
117
- <td style="padding:15px">test/*</td>
118
- <td style="padding:15px">Changes to these files include adding, updating, or removing unit and integration tests in the adapter. Tests should never be removed unless the methods that are being tested are removed also. Both the unit and integration test file should have a marker that identifies where modification can take place. Modifications above that marker are likely to be rejected or implemented in a different manner.</td>
119
- </tr>
120
- </table>
121
- <br>
122
-
123
- > **Note:** It is a best practice to lint and test your code prior to committing changes into the repository. You can lint your code by running **npm run lint** and test it by running **node utils/testRunner.sh**. However, there are pre-commit hooks that will run these scripts when you commit your changes.
124
-
125
- Commit the changes to the repository.
126
-
127
- ```json
128
- git commit -a -m "<descriptive message>"
129
- ```
130
-
131
- > **Note:** There are pre-commit hooks in place. If the pre-commit hooks fail, you will need to address those issues before moving forward.
132
-
133
- Push the changes into the repository. This should only be done after the commit has successfully completed.
134
-
135
- ```json
136
- git push origin <name_of_your_new_branch>
137
- ```
138
-
139
- Create a Merge Request.
140
-
141
- ### Merge Requests
142
-
143
- - Fill out the provided merge request template.
144
- - Reference related issues and merge requests liberally.
145
- - Include screenshots and animated GIFs in your merge request whenever possible.
146
- - Follow the project Styleguide.
147
- - End all files with a newline.
148
-
149
- ## Styleguide
150
-
151
- ### Git Commit Messages
152
-
153
- - Use the present tense ("Add feature" not "Added feature")
154
- - Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
155
- - Consider starting the commit message with an applicable emoji _(not required)_:
156
- - :art: `:art:` When improving the format/structure of the code.
157
- - :racehorse: `:racehorse:` When improving performance
158
- - :non-potable_water: `:non-potable_water:` When plugging memory leaks.
159
- - :memo: `:memo:` When writing documentation.
160
- - :penguin: `:penguin:` When fixing something on Linux.
161
- - :apple: `:apple:` When fixing something on macOS.
162
- - :checkered_flag: `:checkered_flag:` When fixing something on Windows.
163
- - :bug: `:bug:` When fixing a bug.
164
- - :fire: `:fire:` When removing code or files.
165
- - :green_heart: `:green_heart:` When fixing the CI build.
166
- - :white_check_mark: `:white_check_mark:` When adding tests,
167
- - :lock: `:lock:` When dealing with security.
168
- - :arrow_up: `:arrow_up:` When upgrading dependencies.
169
- - :arrow_down: `:arrow_down:` When downgrading dependencies.
170
- - :shirt: `:shirt:` When removing linter warnings.
171
-
172
- __Avoid installing unnecessary packages.__ Do not install packages just because they might be "nice to have". Itential Opensource projects are supposed to be minimal, specific, and compact by design.
13
+ Follow the contributing guide (here)[https://gitlab.com/itentialopensource/adapters/contributing-guide]