@itentialopensource/adapter-servicenow 2.6.0 → 2.6.2

package/CHANGELOG.md

@@ -1,4 +1,20 @@
 
+## 2.6.2 [09-11-2023]
+
+* more meta changes
+
+See merge request itentialopensource/adapters/itsm-testing/adapter-servicenow!25
+
+---
+
+## 2.6.1 [09-05-2023]
+
+* metadata changes
+
+See merge request itentialopensource/adapters/itsm-testing/adapter-servicenow!24
+
+---
+
 ## 2.6.0 [08-16-2023]
 
 * Minor/2023 migration

package/README.md

@@ -14,6 +14,7 @@ Some of the page links in this document and links to other GitLab files do not w
   - [Testing](#testing)
 - [Configuration](./PROPERTIES.md)
 - [Using this Adapter](./CALLS.md)
+  - [Authentication](./AUTH.md)
 - [Additional Information](#additional-information)
   - [Enhancements](./ENHANCE.md)
   - [Contributing](./CONTRIBUTING.md)
@@ -47,17 +48,20 @@ These instructions will help you get a copy of the project on your local machine
 
 ### Helpful Background Information
 
-There is adapter documentation available on the Itential Developer Site <a href="https://docs.itential.com/opensource/docs/adapters" target="_blank">HERE</a>. This documentation includes information and examples that are helpful for:
+There is <a href="https://docs.itential.com/opensource/docs/adapters" target="_blank">Adapter documentation available on the Itential Documentation Site</a>. This documentation includes information and examples that are helpful for:
 
 ```text
 Authentication
-Properties
+IAP Service Instance Configuration
 Code Files
-Action Files
-Schema Files
-Mock Data Files
+Endpoint Configuration (Action & Schema)
+Mock Data
+Adapter Generic Methods
+Headers
+Security
 Linting and Testing
-Troubleshooting
+Build an Adapter
+Troubleshooting an Adapter
 ```
 
 Others will be added over time.

package/adapterBase.js

@@ -1027,6 +1027,24 @@ class AdapterBase extends EventEmitterCl {
     return this.requestHandlerInst.hasEntities(entityType, entityList, callback);
   }
 
+  /**
+   * @summary Determines if this adapter supports any in a list of entities
+   *
+   * @function hasEntitiesAuth
+   * @param {String} entityType - the entity type to check for
+   * @param {Array} entityList - the list of entities we are looking for
+   * @param {Object} callOptions - Additional options used to make request, including auth headers, AWS service, or datatypes
+   *
+   * @param {Callback} callback - A map where the entity is the key and the
+   *                              value is true or false
+   */
+  hasEntitiesAuth(entityType, entityList, callOptions, callback) {
+    const origin = `${this.id}-adapterBase-hasEntitiesAuth`;
+    log.trace(origin);
+
+    return this.requestHandlerInst.hasEntitiesAuth(entityType, entityList, callOptions, callback);
+  }
+
   /**
    * @summary Get Appliance that match the deviceName
    *
@@ -1043,6 +1061,23 @@ class AdapterBase extends EventEmitterCl {
     return this.requestHandlerInst.getDevice(deviceName, callback);
   }
 
+  /**
+   * @summary Get Appliance that match the deviceName
+   *
+   * @function getDeviceAuth
+   * @param {String} deviceName - the deviceName to find (required)
+   * @param {Object} callOptions - Additional options used to make request, including auth headers, AWS service, or datatypes
+   *
+   * @param {getCallback} callback - a callback function to return the result
+   *                                 (appliance) or the error
+   */
+  getDeviceAuth(deviceName, callOptions, callback) {
+    const origin = `${this.id}-adapterBase-getDeviceAuth`;
+    log.trace(origin);
+
+    return this.requestHandlerInst.getDeviceAuth(deviceName, callOptions, callback);
+  }
+
   /**
    * @summary Get Appliances that match the filter
    *
@@ -1059,6 +1094,23 @@ class AdapterBase extends EventEmitterCl {
     return this.requestHandlerInst.getDevicesFiltered(options, callback);
   }
 
+  /**
+   * @summary Get Appliances that match the filter
+   *
+   * @function getDevicesFilteredAuth
+   * @param {Object} options - the data to use to filter the appliances (optional)
+   * @param {Object} callOptions - Additional options used to make request, including auth headers, AWS service, or datatypes
+   *
+   * @param {getCallback} callback - a callback function to return the result
+   *                                 (appliances) or the error
+   */
+  getDevicesFilteredAuth(options, callOptions, callback) {
+    const origin = `${this.id}-adapterBase-getDevicesFilteredAuth`;
+    log.trace(origin);
+
+    return this.requestHandlerInst.getDevicesFilteredAuth(options, callOptions, callback);
+  }
+
   /**
    * @summary Gets the status for the provided appliance
    *
@@ -1075,6 +1127,23 @@ class AdapterBase extends EventEmitterCl {
     return this.requestHandlerInst.isAlive(deviceName, callback);
   }
 
+  /**
+   * @summary Gets the status for the provided appliance
+   *
+   * @function isAliveAuth
+   * @param {String} deviceName - the deviceName of the appliance. (required)
+   * @param {Object} callOptions - Additional options used to make request, including auth headers, AWS service, or datatypes
+   *
+   * @param {configCallback} callback - callback function to return the result
+   *                                    (appliance isAliveAuth) or the error
+   */
+  isAliveAuth(deviceName, callOptions, callback) {
+    const origin = `${this.id}-adapterBase-isAliveAuth`;
+    log.trace(origin);
+
+    return this.requestHandlerInst.isAliveAuth(deviceName, callOptions, callback);
+  }
+
   /**
    * @summary Gets a config for the provided Appliance
    *
@@ -1092,6 +1161,24 @@ class AdapterBase extends EventEmitterCl {
     return this.requestHandlerInst.getConfig(deviceName, format, callback);
   }
 
+  /**
+   * @summary Gets a config for the provided Appliance
+   *
+   * @function getConfigAuth
+   * @param {String} deviceName - the deviceName of the appliance. (required)
+   * @param {String} format - the desired format of the config. (optional)
+   * @param {Object} callOptions - Additional options used to make request, including auth headers, AWS service, or datatypes
+   *
+   * @param {configCallback} callback - callback function to return the result
+   *                                    (appliance config) or the error
+   */
+  getConfigAuth(deviceName, format, callOptions, callback) {
+    const origin = `${this.id}-adapterBase-getConfigAuth`;
+    log.trace(origin);
+
+    return this.requestHandlerInst.getConfigAuth(deviceName, format, callOptions, callback);
+  }
+
   /**
    * @summary Gets the device count from the system
    *
@@ -1107,6 +1194,22 @@ class AdapterBase extends EventEmitterCl {
     return this.requestHandlerInst.iapGetDeviceCount(callback);
   }
 
+  /**
+   * @summary Gets the device count from the system
+   *
+   * @function iapGetDeviceCountAuth
+   * @param {Object} callOptions - Additional options used to make request, including auth headers, AWS service, or datatypes
+   *
+   * @param {getCallback} callback - callback function to return the result
+   *                                    (count) or the error
+   */
+  iapGetDeviceCountAuth(callOptions, callback) {
+    const origin = `${this.id}-adapterBase-iapGetDeviceCountAuth`;
+    log.trace(origin);
+
+    return this.requestHandlerInst.iapGetDeviceCountAuth(callOptions, callback);
+  }
+
   /* ********************************************** */
   /*                                                */
   /*          EXPOSES GENERIC HANDLER               */

package/metadata.json

@@ -1,5 +1,6 @@
 {
   "name": "adapter-servicenow",
+  "webName": "Adapter for Integration to ServiceNow",
   "vendor": "ServiceNow",
   "product": "IT Service Management",
   "osVersions": [
@@ -27,36 +28,30 @@
     "2022.1.x",
     "2023.1.x"
   ],
-  "method": "REST API",
+  "method": "REST",
   "type": "Adapter",
-  "example": {
-    "name": "getStandardChangeRequestById",
-    "overview": "Get a particular Servicenow change request by its id",
-    "exampleInput": "{\n  \"name\": \"sysparmQuery\",\n  \"type\": \"object\",\n  \"info\": \"Encoded query used to filter the result set. e.g. { change: 'CHG123456' }\",\n  \"required\": false,\n  \"schema\": {\n    \"title\": \"sysparmQuery\",\n    \"type\": \"object\"\n  }\n},\n{\n  \"name\": \"changeId\",\n  \"type\": \"string\",\n  \"info\": \"Unique identifier of the standard change request to retrieve from the [change_request] table.\",\n  \"required\": true,\n  \"schema\": {\n    \"title\": \"changeId\",\n    \"type\": \"string\"\n  }\n}\n",
-    "exampleOutput": "{ \n  \"result\": { \n    \"sys_id\": {\n      \"display_value\": \"c45e54b0db400010a704fe1b68961985\",\n      \"value\": \"c45e54b0db400010a704fe1b68961985\"\n    },\n    \"reason\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"parent\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"watch_list\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"upon_reject\": {\n      \"display_value\": \"Cancel all future Tasks\",\n      \"value\": \"cancel\"\n    },\n    \"sys_updated_on\": {\n      \"display_value\": \"2019-09-19 14:06:29\",\n      \"value\": \"2019-09-19 21:06:29\",\n      \"display_value_internal\": \"2019-09-19 14:06:29\"\n    },\n    \"type\": {\n      \"display_value\": \"Standard\",\n      \"value\": \"standard\"\n    },\n    \"approval_history\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"test_plan\": {\n      \"display_value\": \"Explain what testing you have done or will do prior to implementation that gives you confidence this change will be successful.\\r\\n\\r\\nDescribe the tests that will be carried out after implementation to confirm.\\r\\n\\t\\t\\tthat the change has been successful.\",\n      \"value\": \"Explain what testing you have done or will do prior to implementation that gives you confidence this change will be successful.\\r\\n\\r\\nDescribe the tests that will be carried out after implementation to confirm.\\r\\n\\t\\t\\tthat the change has been successful.\"\n    },\n    \"number\": {\n      \"display_value\": \"CHG0030004\",\n      \"value\": \"CHG0030004\"\n    },\n    \"cab_delegate\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"requested_by_date\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"state\": {\n      \"display_value\": \"New\",\n      \"value\": -5\n    },\n    \"sys_created_by\": {\n      \"display_value\": \"admin\",\n      \"value\": \"admin\"\n    },\n    \"knowledge\": {\n      \"display_value\": \"false\",\n      \"value\": false\n    },\n    \"order\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"phase\": {\n      \"display_value\": \"Requested\",\n      \"value\": \"requested\"\n    },\n    \"cmdb_ci\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"delivery_plan\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"impact\": {\n      \"display_value\": \"3 - Low\",\n      \"value\": 3\n    },\n    \"active\": {\n      \"display_value\": \"true\",\n      \"value\": true\n    },\n    \"work_notes_list\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"priority\": {\n      \"display_value\": \"4 - Low\",\n      \"value\": 4\n    },\n    \"sys_domain_path\": {\n      \"display_value\": \"/\",\n      \"value\": \"/\"\n    },\n    \"production_system\": {\n      \"display_value\": \"false\",\n      \"value\": false\n    },\n    \"cab_recommendation\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"rejection_goto\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"review_date\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"requested_by\": {\n      \"display_value\": \"System Administrator\",\n      \"value\": \"6816f79cc0a8016401c5a33be04be441\"\n    },\n    \"business_duration\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"group_list\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"change_plan\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"approval_set\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"wf_activity\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"implementation_plan\": {\n      \"display_value\": \"List the steps in order of completion that will be worked through when implementing this change.\\r\\n\\r\\nNote who will perform each step and whether there are dependencies\\r\\n\\t\\t\\tbetween steps.\",\n      \"value\": \"List the steps in order of completion that will be worked through when implementing this change.\\r\\n\\r\\nNote who will perform each step and whether there are dependencies\\r\\n\\t\\t\\tbetween steps.\"\n    },\n    \"end_date\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"short_description\": {\n      \"display_value\": \"Include a title for your change no greater than 100 characters\",\n      \"value\": \"Include a title for your change no greater than 100 characters\"\n    },\n    \"correlation_display\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"delivery_task\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"work_start\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"outside_maintenance_schedule\": {\n      \"display_value\": \"false\",\n      \"value\": false\n    },\n    \"additional_assignee_list\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"std_change_producer_version\": {\n      \"display_value\": \"Replace printer toner - 1\",\n      \"value\": \"5b7399bc53231300e321ddeeff7b1206\"\n    },\n    \"sys_class_name\": {\n      \"display_value\": \"Change Request\",\n      \"value\": \"change_request\"\n    },\n    \"closed_by\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"follow_up\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"review_status\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"reassignment_count\": {\n      \"display_value\": \"0\",\n      \"value\": 0\n    },\n    \"start_date\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"assigned_to\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"variables\": {\n      \"display_value\": \"variable_pool\",\n      \"value\": \"variable_pool\"\n    },\n    \"sla_due\": {\n      \"display_value\": \"UNKNOWN\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"comments_and_work_notes\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"escalation\": {\n      \"display_value\": \"Normal\",\n      \"value\": 0\n    },\n    \"upon_approval\": {\n      \"display_value\": \"Proceed to Next Task\",\n      \"value\": \"proceed\"\n    },\n    \"correlation_id\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"made_sla\": {\n      \"display_value\": \"true\",\n      \"value\": true\n    },\n    \"backout_plan\": {\n      \"display_value\": \"Describe the steps you will take to revert the change to its pre-implementation state.\\r\\n\\r\\nAt what point during the implementation will you take the decision to\\r\\n\\t\\t\\tbackout your change?\\r\\n\\r\\n\\t\\t\\tDoes your change window include time to backout if you need\\r\\n\\t\\t\\tto?\",\n      \"value\": \"Describe the steps you will take to revert the change to its pre-implementation state.\\r\\n\\r\\nAt what point during the implementation will you take the decision to\\r\\n\\t\\t\\tbackout your change?\\r\\n\\r\\n\\t\\t\\tDoes your change window include time to backout if you need\\r\\n\\t\\t\\tto?\"\n    },\n    \"conflict_status\": {\n      \"display_value\": \"Not Run\",\n      \"value\": \"Not Run\"\n    },\n    \"sys_updated_by\": {\n      \"display_value\": \"admin\",\n      \"value\": \"admin\"\n    },\n    \"opened_by\": {\n      \"display_value\": \"System Administrator\",\n      \"value\": \"6816f79cc0a8016401c5a33be04be441\"\n    },\n    \"user_input\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"sys_created_on\": {\n      \"display_value\": \"2019-09-19 14:06:29\",\n      \"value\": \"2019-09-19 21:06:29\",\n      \"display_value_internal\": \"2019-09-19 14:06:29\"\n    },\n    \"on_hold_task\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"sys_domain\": {\n      \"display_value\": \"global\",\n      \"value\": \"global\"\n    },\n    \"closed_at\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"review_comments\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"business_service\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"time_worked\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"expected_start\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"opened_at\": {\n      \"display_value\": \"2019-09-19 14:06:20\",\n      \"value\": \"2019-09-19 21:06:20\",\n      \"display_value_internal\": \"2019-09-19 14:06:20\"\n    },\n    \"work_end\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"phase_state\": {\n      \"display_value\": \"Open\",\n      \"value\": \"open\"\n    },\n    \"cab_date\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"work_notes\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"close_code\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"assignment_group\": {\n      \"display_value\": \"Help Desk\",\n      \"value\": \"679434f053231300e321ddeeff7b12d8\"\n    },\n    \"description\": {\n      \"display_value\": \"Describe what you plan to do\",\n      \"value\": \"Describe what you plan to do\"\n    },\n    \"on_hold_reason\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"calendar_duration\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"close_notes\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"contact_type\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"cab_required\": {\n      \"display_value\": \"false\",\n      \"value\": false\n    },\n    \"urgency\": {\n      \"display_value\": \"3 - Low\",\n      \"value\": 3\n    },\n    \"scope\": {\n      \"display_value\": \"Medium\",\n      \"value\": 3\n    },\n    \"company\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"justification\": {\n      \"display_value\": \"To improve color standards.\",\n      \"value\": \"To improve color standards.\"\n    },\n    \"activity_due\": {\n      \"display_value\": \"UNKNOWN\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"comments\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"approval\": {\n      \"display_value\": \"Approved\",\n      \"value\": \"approved\"\n    },\n    \"due_date\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"on_hold\": {\n      \"display_value\": \"false\",\n      \"value\": false\n    },\n    \"sys_tags\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"conflict_last_run\": {\n      \"display_value\": \"\",\n      \"value\": \"\",\n      \"display_value_internal\": \"\"\n    },\n    \"risk\": {\n      \"display_value\": \"Moderate\",\n      \"value\": 3\n    },\n    \"location\": {\n      \"display_value\": \"\",\n      \"value\": \"\"\n    },\n    \"category\": {\n      \"display_value\": \"Other\",\n      \"value\": \"Other\"\n    },\n    \"risk_impact_analysis\": {\n      \"display_value\": \"Low\",\n      \"value\": \"Low\"\n    }\n  }\n}"
-  },
   "domains": [
     "Inventory",
-    "Discovery",
+    "Discovery & Topology",
     "ITSM"
   ],
   "tags": [
     "Change Management",
-    "ITSM",
     "Incidents",
-    "Request"
+    "Service Request"
+  ],
+  "useCases": [
+    "Create Change Management Request",
+    "Update Change Management Request",
+    "Complete Change Management Request",
+    "Create Incident",
+    "Update Incident",
+    "Close Incident",
+    "Add asset to CMDB",
+    "Remove asset from CMDB"
   ],
   "deprecated": {
-    "isDeprecated": false,
-    "deprecatedOn": "<date>",
-    "endOfLife": "<date>",
-    "replacedBy": {
-      "name": "adapter-servicenow  JUST EXAMPLE!!!!",
-      "overview": "1 sentence about this thing",
-      "repoLink": "https://gitlab.com/itentialopensource/adapters/itsm-testing/adapter-servicenow",
-      "docLink": "https://docs.itential.com/opensource/docs/servicenow",
-      "webLink": "<TBD>"
-    }
+    "isDeprecated": false
   },
   "brokerSince": "",
   "documentation": {
@@ -64,6 +59,11 @@
     "npmLink": "https://www.npmjs.com/package/@itentialopensource/adapter-servicenow",
     "repoLink": "https://gitlab.com/itentialopensource/adapters/itsm-testing/adapter-servicenow",
     "docLink": "https://docs.itential.com/opensource/docs/servicenow",
+    "demoLinks": [
+      "https://www.itential.com/blog/company/network-cloud-automation/getting-real-time-with-automating-network-change-management-with-servicenow/",
+      "https://www.itential.com/resource/demo/integrating-servicenow-cmdb-as-a-source-of-truth-to-drive-network-automation-with-itential-2/",
+      "https://www.itential.com/solutions/integrations/servicenow-network-automation/"
+    ],
     "faqLink": "https://docs.itential.com/opensource/docs/troubleshooting-an-adapter",
     "contributeLink": "https://gitlab.com/itentialopensource/adapters/contributing-guide",
     "issueLink": "https://itential.atlassian.net/servicedesk/customer/portals",
@@ -74,107 +74,39 @@
       "https://developer.servicenow.com/dev.do#!/learn/learning-plans/tokyo/new_to_servicenow/app_store_learnv2_scripting_tokyo_servicenow_apis"
     ]
   },
+  "assets": [],
   "relatedItems": {
     "adapters": [],
     "integrations": [],
     "ecosystemApplications": [
       {
         "name": "Itential ServiceNow App",
+        "webName": "Itential ServiceNow App",
         "overview": "Start automations in the Itential Platform from ServiceNow",
+        "isDependency": false,
         "versions": [
           "^0.9.0"
         ],
         "storeLink": "https://store.servicenow.com/sn_appstore_store.do#!/store/application/f2ba728813da041032813092e144b01f",
         "docLink": "https://docs.itential.com/opensource/docs/servicenow-application",
-        "webLink": "<TBD>"
+        "webLink": ""
       }
     ],
-    "automations": [
-      {
-        "name": "ServiceNow Create Change Request",
-        "overview": "This pre-built integrates with the ServiceNow Open Source Adapter to create a Change Request in the change_request table in ServiceNow.",
-        "versions": [
-          "^0.2.5"
-        ],
-        "repoLink": "https://gitlab.com/itentialopensource/pre-built-automations/servicenow-create-change-request",
-        "docLink": "<TBD>",
-        "webLink": "https://www.itential.com/automations/servicenow-create-change-request/"
-      },
-      {
-        "name": "ServiceNow Schedule Automation Using Change Request",
-        "overview": "This pre-built integrates with the ServiceNow Open Source Adapter to schedule an automation via Automation Catalog at the start of the Planned start date.",
-        "versions": [
-          "^0.2.5"
-        ],
-        "repoLink": "https://gitlab.com/itentialopensource/pre-built-automations/servicenow-schedule-automation-using-change-request",
-        "docLink": "<TBD>",
-        "webLink": "https://www.itential.com/automations/servicenow-schedule-automation-using-change-request/"
-      },
-      {
-        "name": "ServiceNow Incident Creation",
-        "overview": "This Pre-Built integrates with the ServiceNow Open Source Adapter to create an incident in the incident table in ServiceNow.",
-        "versions": [
-          "^0.0.21"
-        ],
-        "repoLink": "https://gitlab.com/itentialopensource/pre-built-automations/servicenow-incident-creation",
-        "docLink": "<TBD>",
-        "webLink": "https://www.itential.com/automations/servicenow-incident-creation/"
-      },
+    "workflowProjects": [
       {
-        "name": "ServiceNow Create RITM",
-        "overview": "This Pre-built integrates with the ServiceNow Open Source Adapter to create a Request and a Request Item (RITM) using the Service Catalog API.",
+        "name": "ServiceNow - Now Platform - REST",
+        "webName": "Project with workflows for the Now Platform from ServiceNow",
+        "overview": "Project with workflows for the Now Platform from ServiceNow",
+        "isDependency": false,
         "versions": [
-          "^0.2.6"
+          "^0.0.5"
         ],
-        "repoLink": "https://gitlab.com/itentialopensource/pre-built-automations/servicenow-create-ritm",
-        "docLink": "<TBD>",
-        "webLink": "https://www.itential.com/automations/servicenow-create-ritm/"
+        "repoLink": "https://gitlab.com/itentialopensource/pre-built-automations/staging/servicenow-now-platform-rest",
+        "docLink": "",
+        "webLink": ""
       }
     ],
-    "transformations": [],
-    "useCases": [
-      {
-        "name": "Create, update and complete change management requests",
-        "overview": "1 sentence about this thing",
-        "webLink": "<TBD>",
-        "exampleInput": "",
-        "exampleOutput": ""
-      },
-      {
-        "name": "Create, update and complete change management requests",
-        "overview": "1 sentence about this thing",
-        "webLink": "<TBD>",
-        "exampleInput": "",
-        "exampleOutput": ""
-      },
-      {
-        "name": "Create tickets/issues when problems arise during automations",
-        "overview": "1 sentence about this thing",
-        "webLink": "<TBD>",
-        "exampleInput": "",
-        "exampleOutput": ""
-      },
-      {
-        "name": "Close tickets/issues when problems are fixed by automations",
-        "overview": "1 sentence about this thing",
-        "webLink": "<TBD>",
-        "exampleInput": "",
-        "exampleOutput": ""
-      },
-      {
-        "name": "Add items into CMDB systems and set them up to be discovered",
-        "overview": "1 sentence about this thing",
-        "webLink": "<TBD>",
-        "exampleInput": "",
-        "exampleOutput": ""
-      },
-      {
-        "name": "Remove items from CMDB",
-        "overview": "1 sentence about this thing",
-        "webLink": "<TBD>",
-        "exampleInput": "",
-        "exampleOutput": ""
-      }
-    ]
+    "transformationProjects": [],
+    "exampleProjects": []
   }
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@itentialopensource/adapter-servicenow",
-  "version": "2.6.0",
+  "version": "2.6.2",
   "description": "This adapter integrates with system described as: servicenowMadrid.",
   "main": "adapter.js",
   "systemName": "ServiceNow",
   "wizardVersion": "2.44.7",
-  "engineVersion": "1.67.5",
+  "engineVersion": "1.67.7",
   "adapterType": "http",
   "scripts": {
     "artifactize": "npm i && node utils/packModificationScript.js",
@@ -55,12 +55,12 @@
   "author": "Itential",
   "homepage": "https://gitlab.com/itentialopensource/adapters/itsm-testing/adapter-servicenow#readme",
   "dependencies": {
-    "@itentialopensource/adapter-utils": "^5.1.0",
+    "@itentialopensource/adapter-utils": "^5.1.7",
+    "acorn": "^8.10.0",
     "ajv": "^8.12.0",
     "axios": "^1.4.0",
     "commander": "^11.0.0",
     "dns-lookup-promise": "^1.0.4",
-    "esprima": "^4.0.1",
     "fs-extra": "^11.1.1",
     "json-query": "^2.2.2",
     "mocha": "^10.2.0",

package/propertiesSchema.json

@@ -1063,6 +1063,38 @@
                 "description": "The method of the call to getDevicesFiltered",
                 "default": "GET"
               },
+              "pagination": {
+                "type": "object",
+                "description": "todo",
+                "properties": {
+                  "offsetVar": {
+                    "type": "string",
+                    "description": "Name of variable that defines how to go to next set of results"
+                  },
+                  "limitVar": {
+                    "type": "string",
+                    "description": "Name of variable that defines the max results returned in a request"
+                  },
+                  "incrementBy": {
+                    "type": "string",
+                    "enum": [
+                      "limit",
+                      "page"
+                    ],
+                    "description": "How to incremenet offset. Default limit",
+                    "default": "limit"
+                  },
+                  "requestLocation": {
+                    "type": "string",
+                    "enum": [
+                      "query",
+                      "body"
+                    ],
+                    "description": "Where in request the pagination data goes",
+                    "default": "query"
+                  }
+                }
+              },
               "query": {
                 "type": "object",
                 "description": "The json object with query parameters of the call to getDevicesFiltered",
@@ -1487,6 +1519,38 @@
                       "description": "The method of the call to getDevice",
                       "default": "GET"
                     },
+                    "pagination": {
+                      "type": "object",
+                      "description": "todo",
+                      "properties": {
+                        "offsetVar": {
+                          "type": "string",
+                          "description": "Name of variable that defines how to go to next set of results"
+                        },
+                        "limitVar": {
+                          "type": "string",
+                          "description": "Name of variable that defines the max results returned in a request"
+                        },
+                        "incrementBy": {
+                          "type": "string",
+                          "enum": [
+                            "limit",
+                            "page"
+                          ],
+                          "description": "How to incremenet offset. Default limit",
+                          "default": "limit"
+                        },
+                        "requestLocation": {
+                          "type": "string",
+                          "enum": [
+                            "query",
+                            "body"
+                          ],
+                          "description": "Where in request the pagination data goes",
+                          "default": "query"
+                        }
+                      }
+                    },
                     "query": {
                       "type": "object",
                       "description": "The json object with query parameters of the call to getDevice",

package/report/adapterInfo.json

@@ -1,10 +1,10 @@
 {
-  "version": "2.4.5",
-  "configLines": 8328,
+  "version": "2.6.1",
+  "configLines": 8392,
   "scriptLines": 1783,
-  "codeLines": 12818,
-  "testLines": 11853,
+  "codeLines": 12921,
+  "testLines": 11859,
   "testCases": 613,
-  "totalCodeLines": 26454,
+  "totalCodeLines": 26563,
   "wfTasks": 165
 }