Merge branch 'ServiceNowDevProgram:main' into feature/auto-incident-from-case-email

Author: mitalizope

Client-Side Components/Catalog Client Script/Normalise and Reset a MRVS based on Variable Changes/README.md

@@ -0,0 +1,31 @@
+# MRVS - Normalise and Reset Rows on Change
+
+## What this solves
+When a controlling variable changes (for example, Environment), existing MRVS rows may no longer be valid. This client script:
+- Clears or normalises specific MRVS columns
+- Deduplicates rows
+- Optionally sorts rows for a cleaner UX
+- Works entirely client-side using MRVS JSON
+
+## Where to use
+Catalog Item → OnChange client script on your controlling variable.
+
+## How it works
+- Reads the MRVS value as JSON via `g_form.getValue('my_mrvs')`
+- Applies transforms (clear columns, unique by key, sort)
+- Writes back the JSON with `g_form.setValue('my_mrvs', JSON.stringify(rows))`
+
+## Setup
+1. Replace `CONTROLLING_VARIABLE` with your variable name.
+2. Replace `MY_MRVS` with your MRVS variable name.
+3. Adjust `COLUMNS_TO_CLEAR`, `UNIQUE_KEY`, and `SORT_BY` as needed.
+
+## Notes
+- To clear the MRVS entirely, set `rows = []` before `setValue`.
+- Works with Catalog Client Scripts; no server call required.
+
+## References
+- GlideForm API (client): `getValue`, `setValue`, `clearValue`  
+  https://www.servicenow.com/docs/bundle/zurich-api-reference/page/app-store/dev_portal/API_reference/GlideForm/concept/c_GlideFormAPI.html
+- Working with MRVS values on the client (community examples)  
+  https://www.servicenow.com/community/developer-articles/accessing-multi-row-variable-set-value-outside-the-multi-row/ta-p/2308876

Client-Side Components/Catalog Client Script/Normalise and Reset a MRVS based on Variable Changes/mrvs_normalise_onchange.js

@@ -0,0 +1,45 @@
+function onChange(control, oldValue, newValue, isLoading) {
+  if (isLoading) return;
+
+  var MRVS_NAME = 'MY_MRVS';                 // your MRVS variable name
+  var COLUMNS_TO_CLEAR = ['env', 'owner'];   // MRVS column names to clear
+  var UNIQUE_KEY = 'hostname';               // MRVS column that should be unique
+  var SORT_BY = 'hostname';                  // MRVS column to sort by
+
+  try {
+    var raw = g_form.getValue(MRVS_NAME);
+    var rows = raw ? JSON.parse(raw) : [];
+    if (!Array.isArray(rows)) rows = [];
+
+    // Clear specified columns
+    rows.forEach(function(row) {
+      COLUMNS_TO_CLEAR.forEach(function(col) { if (row.hasOwnProperty(col)) row[col] = ''; });
+    });
+
+    // Deduplicate by UNIQUE_KEY
+    if (UNIQUE_KEY) {
+      var seen = {};
+      rows = rows.filter(function(row) {
+        var key = String(row[UNIQUE_KEY] || '').toLowerCase();
+        if (!key || seen[key]) return false;
+        seen[key] = true;
+        return true;
+      });
+    }
+
+    // Sort (case-insensitive)
+    if (SORT_BY) {
+      rows.sort(function(a, b) {
+        var A = String(a[SORT_BY] || '').toLowerCase();
+        var B = String(b[SORT_BY] || '').toLowerCase();
+        if (A < B) return -1;
+        if (A > B) return 1;
+        return 0;
+      });
+    }
+
+    g_form.setValue(MRVS_NAME, JSON.stringify(rows));
+  } catch (e) {
+    console.error('MRVS normalise failed', e);
+  }
+}

Client-Side Components/Catalog Client Script/Normalise and Reset a MRVS based on Variable Changes/variant_reset_specific_columns.js

@@ -0,0 +1,17 @@
+function onChange(control, oldValue, newValue, isLoading) {
+  if (isLoading) return;
+
+  var MRVS_NAME = 'MY_MRVS';
+  var COLUMNS_TO_CLEAR = ['env', 'region'];
+
+  var rows = [];
+  try { rows = JSON.parse(g_form.getValue(MRVS_NAME) || '[]'); } catch (e) {}
+  if (!Array.isArray(rows)) rows = [];
+
+  rows.forEach(function(row) {
+    COLUMNS_TO_CLEAR.forEach(function(col) { if (row.hasOwnProperty(col)) row[col] = ''; });
+  });
+
+  g_form.setValue(MRVS_NAME, JSON.stringify(rows));
+}
+

Client-Side Components/Catalog Client Script/Reusable GlideAjax Client Script/DynamicTableQueryUtil.js

@@ -0,0 +1,73 @@
+var DynamicTableQueryUtil = Class.create();
+DynamicTableQueryUtil.prototype = Object.extendsObject(AbstractAjaxProcessor, {
+
+    getTableRow: function() {
+        var tableName = this.getParameter('sysparm_table_name');
+        var keyField = this.getParameter('sysparm_key_field');
+        var keyValue = this.getParameter('sysparm_key_value');
+        var fieldsParam = this.getParameter('sysparm_fields');
+        var limitFields = !JSUtil.nil(fieldsParam);
+        var desiredFields = limitFields ? fieldsParam.split(',') : [];
+
+        var result = {};
+        var tableObj = {};
+        var gr = new GlideRecord(tableName);
+
+        // Use addQuery for non-sys_id fields
+        if (keyField === 'sys_id') {
+            if (!gr.get(keyValue)) {
+                return null;
+            }
+        } else {
+            gr.addQuery(keyField, keyValue);
+            gr.query();
+            if (!gr.next()) {
+                return null;
+            }
+        }
+
+        // Handle variables (if present)
+        if (gr.variables) {
+            for (var key in gr.variables) {
+                if (!JSUtil.nil(gr.variables[key])) {
+                    var variableObj = gr.variables[key];
+                    tableObj['variables.' + key] = {
+                        fieldDisplayVal: variableObj.getDisplayValue() || String(variableObj),
+                        fieldVal: String(variableObj)
+                    };
+                }
+            }
+        }
+
+        // Handle standard fields
+        var fields = gr.getFields();
+        for (var i = 0; i < fields.size(); i++) {
+            var field = fields.get(i);
+            var fieldName = field.getName();
+            tableObj[fieldName] = {
+                fieldDisplayVal: field.getDisplayValue() || String(field),
+                fieldVal: String(field)
+            };
+        }
+
+        // Add sys_id explicitly
+        tableObj['sys_id'] = {
+            fieldDisplayVal: 'Sys ID',
+            fieldVal: gr.getUniqueValue()
+        };
+
+        // Filter fields if requested
+        if (limitFields) {
+            desiredFields.forEach(function(field) {
+                field = field.trim();
+                if (tableObj[field]) {
+                    result[field] = tableObj[field];
+                }
+            });
+        } else {
+            result = tableObj;
+        }
+
+        return new JSON().encode(result);
+    }
+});

Client-Side Components/Catalog Client Script/Reusable GlideAjax Client Script/Readme.md

@@ -0,0 +1,25 @@
+This solution provides a generic and reusable GlideAjax-based client-server interaction in ServiceNow that allows querying any table by passing:
+
+Table name
+Key field and value
+Desired fields to retrieve
+
+It dynamically returns field values from the server and populates them on the form, making it ideal for use cases like CMDB enrichment, entitlement lookups, or dynamic form population.
+
+1. Client Script (onChange)
+Triggers on field change.
+Sends parameters to the Script Include via GlideAjax.
+Receives JSON response and sets target field value.
+
+Parameters:
+sysparm_table_name: Table to query (e.g., sys_user)
+sysparm_key_field: Field to match (e.g., sys_id)
+sysparm_key_value: Value to match
+sysparm_fields: Comma-separated list of fields to retrieve
+
+2. Script Include: DynamicTableQueryUtil
+   
+Processes incoming parameters.
+Queries the specified table and retrieves requested fields.
+Supports both standard fields and catalog item variables.
+Returns a JSON object with field values and display values.

Client-Side Components/Catalog Client Script/Reusable GlideAjax Client Script/clientscript.js

@@ -0,0 +1,32 @@
+function onChange(control, oldValue, newValue, isLoading) {
+    if (isLoading || newValue === '') {
+        return;
+    }
+
+    // Define parameters dynamically
+    var tableName = 'sys_user'; // Change as needed
+    var keyField = 'sys_id'; // Change as needed
+    var fieldsToFetch = 'email'; // Comma-separated list
+    var targetField = 'user'; // Field to populate
+
+    var ga = new GlideAjax('DynamicTableQueryUtil');
+    ga.addParam('sysparm_name', 'getTableRow');
+    ga.addParam('sysparm_table_name', tableName);
+    ga.addParam('sysparm_key_field', keyField);
+    ga.addParam('sysparm_key_value', newValue);
+    ga.addParam('sysparm_fields', fieldsToFetch);
+    ga.getXML(function(response) {
+        var answer = response.responseXML.documentElement.getAttribute("answer");
+        if (!answer) {
+            alert('No response from Script Include');
+            return;
+        }
+
+        var parsedAnswer = JSON.parse(answer);
+        if (parsedAnswer[fieldsToFetch]) {
+            g_form.setValue(targetField, parsedAnswer[fieldsToFetch]['fieldVal']);
+        } else {
+            alert('error');
+        }
+    });
+}

Client-Side Components/Client Scripts/Auto-Populate Short Discription/Auto populate short description.js

@@ -0,0 +1,29 @@
+function onChange(control, oldValue, newValue, isLoading, isTemplate) {
+    if (isLoading || newValue === '') {
+        return;
+    }
+
+    // Define category-to-short description mapping
+    var categoryToShortDescription = {
+        'hardware': 'Hardware Issue - ',
+        'software': 'Software Issue - ',
+        'network': 'Network Issue - ',
+        'inquiry': 'Inquiry/Help - ',
+		'database': 'Database - '
+    };
+
+    // Convert the selected value to lowercase for matching
+    var selectedCategory = newValue.toLowerCase();
+
+    // If category exists in mapping, update the short description
+    if (categoryToShortDescription.hasOwnProperty(selectedCategory)) {
+        var existingDesc = g_form.getValue('short_description') || '';
+        var prefix = categoryToShortDescription[selectedCategory];
+
+        // Only add prefix if it's not already there
+        if (!existingDesc.startsWith(prefix)) {
+            g_form.setValue('short_description', prefix + existingDesc);
+            g_form.showFieldMsg('short_description', 'Short Description auto-updated based on category.', 'info');
+        }
+    }
+}

Client-Side Components/Client Scripts/Auto-Populate Short Discription/Readme.md

@@ -0,0 +1,36 @@
+# Auto-Populate Short Description (Client Script)
+## Overview
+
+This client script automatically updates the Short Description field in ServiceNow whenever a user selects a category on the form. It improves data consistency, saves time, and ensures that short descriptions remain meaningful and standardized.
+
+## How It Works
+
+When a user selects a category such as Hardware, Software, or Network, the script automatically prefixes the existing short description with a corresponding label (for example, “Hardware Issue –”).
+This makes incident records easier to identify and improves the quality of data entry.
+
+## Configuration Steps
+
+1. Log in to your ServiceNow instance with admin or developer access.
+2. Navigate to System Definition → Client Scripts.
+3. Create a new Client Script with the following details:
+
+```
+Table: Incident
+Type: onChange
+Field name: category
+Copy and paste the provided script into the Script field.
+Save the record and make sure the script is active.
+```
+
+## Testing
+
+1. Open any existing or new Incident record.
+2. Select a category such as Hardware or Software.
+3. The Short Description field will automatically update with the corresponding prefix.
+
+## Benefits
+
+Speeds up data entry for users.
+Maintains consistency in short descriptions.
+Reduces manual effort and human errors.
+Enhances clarity in incident listings and reports.

Client-Side Components/Client Scripts/Dynamic script to make fields read only/reame.md

@@ -0,0 +1,5 @@
+Dynamic script to make fields read only
+
+It runs when the field value changes.On change client script
+If the new value equals '7', it retrieves all editable fields using g_form.getEditableFields().
+Then it loops through each field and sets it to read-only using g_form.setReadOnly().

Client-Side Components/Client Scripts/Dynamic script to make fields read only/script.js

@@ -0,0 +1,20 @@
+/*
+It runs when the field value changes.
+If the new value equals '7', it retrieves all editable fields using g_form.getEditableFields().
+Then it loops through each field and sets it to read-only using g_form.setReadOnly().
+
+*/
+
+
+function onChange(control, oldValue, newValue, isLoading, isTemplate) {
+    if (isLoading || newValue === '') {
+        return;
+    }
+
+
+    if (newValue == '7') { // update condition as required
+        var fields = g_form.getEditableFields();
+        for (var i = 0; i < fields.length; i++) {
+            g_form.setReadOnly(fields[i].getName(), true);
+        }
+