Merge branch 'main' into code-snippets

Author: selvarun-umass

Attachments/CSVParser/script.js

@@ -0,0 +1,41 @@
+/********************************************************************************/
+Input:
+attachmentQuery - Pass sysId CSV attachment
+
+Output:
+converted into object from CSV
+
+/********************************************************************************/
+
+function parseCSVFile(sysId) {
+    var attachmentRecord = new GlideRecord("sys_attachment");
+    attachmentRecord.get(sysId);
+    attachmentRecord.query();
+
+    if (attachmentRecord.next()) {
+        var stringUtil = new GlideStringUtil();
+        var sysAttachment = new GlideSysAttachment();
+        var bytesData = sysAttachment.getBytes(attachmentRecord);
+        var encData = stringUtil.base64Encode(bytesData);
+        var decData = stringUtil.base64Decode(encData) + '';
+
+        var delimiter = ',';
+        var quoteCharacter = '"';
+        var csvArray = decData.split("\r\n");
+
+        var index = 0
+        var result = [];
+        for (index = 0; index < csvArray.length; index++) {
+            var row = csvArray[index];
+            if (row) {
+            var csvParser = new sn_impex.CSVParser().parseLineToArray(row, delimiter, quoteCharacter);
+            var rowObject = {};
+            for (var i = 0; i < csvParser.length; i++) {
+                rowObject['column' + (i + 1)] = csvParser[i];
+            }
+            result.push(rowObject);
+            }
+        }
+        return result;
+    }
+}

Background Scripts/Bulk Delete Records in Multiple Tables with Conditions/BulkDeleteRecordsMultipleTablesWithConditions.js

@@ -0,0 +1,34 @@
+
+
+/**
+ * Deletes records from multiple tables based on provided encoded queries.
+ *
+ * @param {Object} target - An object where each key is the name of a table and each value is an encoded query string.
+ *                          The function will delete all records matching the encoded query for each specified table.
+ *
+ * Example usage:
+ * bulkDelete({
+ *     'incident': 'priority=1^state=2',
+ *     'change_request': 'state=3^risk=high'
+ * });
+ * 
+ * This deletes all records in the 'incident' table where the priority is 1 and the state is 2,
+ * and all records in the 'change_request' table where the state is 3 and risk is 'high'.
+ */
+function bulkDelete(target) {
+
+    for (var table in target) {
+        if (target.hasOwnProperty(table)) {
+            var getRecord = new GlideRecord(table);
+            getRecord.addEncodedQuery(target[table]);
+            getRecord.query();
+            while (getRecord.next()) {
+                
+                getRecord.deleteRecord();
+            }
+        }
+    }
+}
+
+
+

Background Scripts/Bulk Delete Records in Multiple Tables with Conditions/Readme.md

@@ -0,0 +1,20 @@
+# Bulk Delete Function Documentation - Use the code/function to bulk-deletes records from multiple tables based on provided encoded queries.
+
+# Function: `bulkDelete(target)`
+
+Deletes records from multiple tables based on provided encoded queries.
+
+## Parameters
+
+- **`target`** (`Object`): An object where each key is the name of a table, and each value is an encoded query string. 
+  - The function will delete all records matching the encoded query for each specified table.
+
+## Example Usage
+
+```javascript
+bulkDelete({
+    'incident': 'priority=1^state=2',
+    'change_request': 'state=3^risk=high'
+});
+```
+ 

Background Scripts/Bulk Update Tables/BulkUpdateWithConditions.js

@@ -0,0 +1,32 @@
+
+
+/**
+ * Performs a bulk update on a specified table, applying the given data to all records that match the query.
+ *
+ * @param {string} table - The name of the table where the bulk update is to be performed.
+ * @param {string} query - The encoded query string that filters which records to update.
+ * @param {Object} data - An object representing the field-value pairs to update. 
+ *                        Each key is a field name, and the value is the new value for that field.
+ *
+ * Example usage:
+ * bulkUpdate('incident', 'priority=1^state=2', { priority: 2, state: 3 });
+ * 
+ * This updates all incidents where priority is 1 and state is 2, setting priority to 2 and state to 3.
+ */
+function bulkUpdate(table, query, data) {
+
+    var getRecord = new GlideRecord(table);
+    getRecord.addEncodedQuery(query);
+    getRecord.query();
+    while (getRecord.next()) {
+        for (var field in data) {
+            if (data.hasOwnProperty(field)) {
+				getRecord.setValue(field, data[field]);
+            }
+        }
+		getRecord.update();
+    }
+}
+
+
+

Background Scripts/Bulk Update Tables/Readme.md

@@ -0,0 +1,19 @@
+# Bulk Update Function Documentation - Use the code/function to bulk change some fields in any tables.
+
+## `bulkUpdate(table, query, data)`
+
+Performs a bulk update on a specified table, applying the given data to all records that match the query.
+
+### Parameters
+
+- **`table`** (`string`): The name of the table where the bulk update is to be performed.
+- **`query`** (`string`): The encoded query string that filters which records to update.
+- **`data`** (`Object`): An object representing the field-value pairs to update. 
+  - Each key is a field name, and the value is the new value for that field.
+
+### Example Usage
+
+```javascript
+bulkUpdate('incident', 'priority=1^state=2', { priority: 2, state: 3 });
+```
+ 

Background Scripts/Updating a record in the sys_user table/readme.md

@@ -0,0 +1,9 @@
+# update a record in sys_user table
+
+If we use the command below to update a record, it can lead to a problem.
+
+grUser.get('grUser.get('62826bf03710200044e0bfc8bcbe5df9')');
+
+If the record is not found in the table, the script will create a new one. 
+
+To make sure we are updating and not inserting, it is better to wrap up the get method with an If statement.

Background Scripts/Updating a record in the sys_user table/script.js

@@ -0,0 +1,11 @@
+var grUser = new GlideRecord('sys_user');
+
+if (grUser.get('62826bf03710200044e0bfc8bcbe5df9')) {
+    grUser.user_name = 'test.user';
+    grUser.first_name = 'test';
+    grUser.last_name = 'user';
+    grUser.email = 'test.user@servicenow';
+    grUser.update();
+} else {
+    gs.info('Record not found.');
+}

Catalog Client Script/MRVS Reference Qualifier from Catalog Item Variable/mrvs_ref_qual.js

@@ -0,0 +1,5 @@
+function onLoad() {
+    var mgr = g_service_catalog.parent.getValue('v_manager'); //Catalog Item Variable Name
+    var filter = g_list.get('v_employee'); //MRVS variable name
+    filter.setQuery('active=true^manager=' + mgr);
+}

Catalog Client Script/MRVS Reference Qualifier from Catalog Item Variable/readme.md

@@ -0,0 +1,9 @@
+*** This solution uses g_list, so it works in Service Portal (and I assume ESC) only, not the native UI / Service Catalog interface ***<br>
+Developed in collaboration with Chris Perry
+
+
+On a reference variable in a multi-row variable set, sometimes you want the reference qualifier to include the value of a variable that is part of the Catalog Item, not within the MRVS
+
+When using this script that applies to the Variable set, not the Catalog Item, leave the Reference qualifier field on the MRVS variable empty 
+
+In this simplified example, I have a Manager (v_manager) reference variable (sys_user table) that belongs to the Catalog Item.  In the MRVS, I have an Employee (v_employee) reference variable (sys_user table).  I only want to be able to select user records that are active, and the Manager is the user I selected on the Catalog Item variable.

Catalog Client Script/Set fields from URL Parameter 2/CatalogClientScript.js

@@ -0,0 +1,36 @@
+function onLoad() {
+   
+    var taskId = getParameterValue("taskid");
+   
+    if (taskId != "" && taskId != null && taskId != undefined) {
+      console.log('=== CAMACHO Task id: ' + taskId);
+      
+      var gaGetTaskNumber = new GlideAjax('UtilsAjax');
+      gaGetTaskNumber.addParam('sysparm_name', 'getTaskNumber');
+      gaGetTaskNumber.addParam('sysparm_task_id', taskId);
+      gaGetTaskNumber.getXMLAnswer(setmyFormValue);
+    }
+ }
+ 
+ function setmyFormValue(answer) {
+   
+   //console.log('=== CAMACHO Entered setmyFormValue');
+   if (answer) {
+     var obj = JSON.parse(answer);
+     var numero = obj.number.toString();
+     console.log(numero);
+     
+     g_form.setValue('task_number', numero);
+     
+   }
+ }
+ 
+ function getParameterValue(name) {
+   var url = top.location.href;
+   var value = new URLSearchParams(url).get(name);
+   if (value) {
+     return value;
+   } else {
+     return null;
+   }
+ }