Update ci (#887)

* Create UpdateCi.js

Scripted rest resource to update the CI

* Update CmdbApi.js

Created a function for Scripted Rest API to update the CIs

* Update readme.md

Updated the API details for the API to update the CI

Author: amigujarathi

Scripted REST Api/CMDB API/CmdbApi.js

@@ -320,6 +320,73 @@ createCiRelationship: function() {
         });
 
     },
+
+/**
+ * Update a Configuration Item (CI).
+ * Mapped to PATCH /cis/{ci_type}/{sys_id}
+ *
+ * This function updates a CI based on its type and system ID.
+ *
+ * @returns {Object} JSON response containing the updated CI or error details.
+ * @throws {BadRequestError} If an invalid CI type is provided.
+ * @throws {ServiceError} If the operation fails for any reason.
+ * @throws {NotFoundError} If no record is found for the provided system ID.
+ */
+    updateCi: function() {
+        var self = this;
+
+        var ciType = self.getPathParam('ci_type', '');
+
+        var ciSysId = self.getPathParam('sys_id');
+
+        var payload = self.body;
+
+        if (!self._isValidCiType(ciType)) {
+            return sn_ws_err.BadRequestError('Invalid CI Type provided:' + ciType);
+        }
+
+        var ciRec = new GlideRecord(ciType);
+        if (ciRec.get(ciSysId)) {
+
+            try {
+                for (var key in payload) {
+                    if (ciRec.isValidField(key) && key.indexOf('sys_') != 0) {
+                        var value = payload[key];
+                        var el = ciRec.getElement(key);
+
+                        var descriptor = el.getED();
+                        var choice = descriptor.choice;
+                        var type = descriptor.getInternalType();
+
+                        if (choice != '0') {
+                            ciRec[key] = self._getChoiceValue(ciType, key, value);
+                        } else if (type == 'reference') {
+                            ciRec[key] = self._getReferenceValue(ciType, key, value);
+                        } else {
+                            ciRec[key] = payload[key];
+                        }
+                    }
+                }
+                ciRec.update();
+
+                var errMsg = ciRec.getLastErrorMessage();
+                if (!gs.nil(errMsg)) {
+                    return new sn_ws_err.BadRequestError(errMsg);
+                }
+
+                return self._getGrResultStream(ciType, ciRec.getValue('sys_id'), {});
+
+            } catch (e) {
+                var serverError = new sn_ws_err.ServiceError();
+                serverError.setStatus(500);
+                serverError.setMessage('Operation Failed');
+                serverError.setDetail(e);
+                return serverError;
+            }
+        } else {
+            return new sn_ws_err.NotFoundError('No record found');
+        }
+    },
 
 /**
 	 * Determine the type of source ID.

Scripted REST Api/CMDB API/UpdateCi.js

@@ -0,0 +1,6 @@
+(function process(/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {
+
+    // implement resource here
+	return new CmdbApi(request, response).updateCi();
+
+})(request, response);

Scripted REST Api/CMDB API/readme.md

@@ -9,6 +9,7 @@ Table of Contents
 5. Retrieve CI Group
 6. Retrieve CI Relationship types
 7. Retrieve CIs
+8. Update CI
 
 1. Create CIs
   This API is designed to create Configuration Items (CIs).
@@ -114,3 +115,18 @@ Table of Contents
     Response:
       Status Code: 200 OK
       Response Body: JSON Details of CIs based on the given type
+
+  8. Update CIs
+    This API is designed to Update a Configuration Item (CI).
+    Request Details:
+      Type: HTTP
+      Method: PATCH
+      URI: https://<service-now-domain>.service-now.com/api/cis/{ci_type}/{sys_id}
+      Headers:
+       Accept: application/json
+       Content-Type: application/json
+    Request Body:
+      The request body should contain a JSON key-value pair for the required fields.
+    Response:
+      Status Code: 200 OK
+      Response Body: JSON with required fields