Merge branch 'ServiceNowDevProgram:main' into fxhack

Author: chetnadev

CONTRIBUTING.md

@@ -31,10 +31,25 @@ If you plan to submit another pull request while your original is still pending,
 - **Descriptive Pull Request Titles**: Your pull request must have explicit and descriptive titles that accurately represent the changes made.
 - **Scope Adherence**: Changes that fall outside the described scope will result in the entire pull request being rejected.
 - **Quality Over Quantity**: Low-effort or spam pull requests will be marked accordingly.
-- **Expanded Snippets**: Code snippets reused from the [ServiceNow Documentation](https://docs.servicenow.com/) or [API References](https://developer.servicenow.com/dev.do#!/reference/) are acceptable only if they are expanded in a meaningful way (e.g., with additional context, documentation, or variations). Remember: *“QUANTITY IS FUN, QUALITY IS KEY.”*
+- **Expanded Snippets**: Code snippets reused from the [ServiceNow Documentation](https://docs.servicenow.com/) or [API References](https://developer.servicenow.com/dev.do#!/reference/) are acceptable only if they are expanded in a meaningful way (e.g., with additional context, documentation, or variations). Remember: *"QUANTITY IS FUN, QUALITY IS KEY."*
 - **Relevance**: Code should be relevant to ServiceNow Developers.
 - **ES2021 Compatibility**: While ES2021 is allowed, we encourage you to disclose if your code is using ES2021 features, as not everyone may be working with ES2021-enabled applications.
 
+## Core Documentation File Changes
+
+**IMPORTANT**: For changes to core documentation files (README.md, CONTRIBUTING.md, LICENSE, etc.), contributors must:
+
+1. **Submit an Issue First**: Before making any changes to core documentation files, create an issue describing:
+   - What you intend to edit
+   - Why the change is needed
+   - Your proposed approach
+
+2. **Get Assignment**: Wait to be assigned to the issue by a maintainer before submitting a PR.
+
+3. **Reference the Issue**: Include the issue number in your PR title and description.
+
+This process helps prevent merge conflicts when multiple contributors want to update the same documentation files and ensures all changes align with the project's direction.
+
 ## Repository Structure
 
 **IMPORTANT**: The repository has been reorganized into major categories. All new contributions MUST follow this structure for PR approval.

Core ServiceNow APIs/GlideDateTime/Find Incidents Older Than X Days/readme.md

@@ -0,0 +1,10 @@
+## Overview
+This script retrieves incidents that were opened more than X days ago using **GlideDateTime** and **GlideRecord**.  
+Useful for reporting, escalations, notifications, and cleanup tasks.
+
+## Table and Field
+- **Table:** `incident`
+- **Field:** `opened_at`
+
+## Parameters
+- **X (number of days):** Defines the threshold for old incidents (e.g., 30 days).

Core ServiceNow APIs/GlideDateTime/Find Incidents Older Than X Days/script.js

@@ -0,0 +1,18 @@
+(function() {
+    var days = 30; // Change this to your required number of days
+
+    // Calculate the date X days ago
+    var cutoffDate = new GlideDateTime();
+    cutoffDate.addDaysUTC(-days);
+
+    // Query incidents opened before the cutoff date
+    var gr = new GlideRecord('incident');
+    gr.addQuery('opened_at', '<', cutoffDate);
+    gr.query();
+
+    gs.info('Incidents opened more than ' + days + ' days ago:');
+
+    while (gr.next()) {
+        gs.info('Incident Number: ' + gr.number + ', Opened At: ' + gr.opened_at.getDisplayValue());
+    }
+})();

Core ServiceNow APIs/GlideJsonPath/Basic-Example/README.md

@@ -0,0 +1,9 @@
+# Querying JSON with JSONPath to extract values
+
+GlideJsonPath is a class which can be used to use JSONPath in ServiceNow. It can be useful when working with JSON Payloads, especially highly nested or in general complex structures.
+
+References:
+- [RFC 9535: JSONPath: Query Expressions for JSON](https://datatracker.ietf.org/doc/rfc9535/)
+- [Play with JSONPath outside of ServiceNow](https://jsonpath.com/)
+- [Good Examples to start with](https://restfulapi.net/json-jsonpath/)
+- [ServiceNow API Documentation](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/app-store/dev_portal/API_reference/GlideJsonPath/concept/GlideJsonPathAPI.html)

Core ServiceNow APIs/GlideJsonPath/Basic-Example/examples.js

@@ -0,0 +1,53 @@
+// Run in background script
+var json = { 
+	"store": 
+	{
+		"book": [
+			{ 
+				"category": "reference",
+				"author": "Nigel Rees",
+				"title": "Sayings of the Century",
+				"price": 8.95
+			},
+			{ 
+				"category": "fiction",
+				"author": "Evelyn Waugh",
+				"title": "Sword of Honour",
+				"price": 12.99
+			},
+			{ 
+				"category": "fiction",
+				"author": "Herman Melville",
+				"title": "Moby Dick",
+				"isbn": "0-553-21311-3",
+				"price": 8.99
+			},
+			{ 
+				"category": "fiction",
+				"author": "J. R. R. Tolkien",
+				"title": "The Lord of the Rings",
+				"isbn": "0-395-19395-8",
+				"price": 22.99
+			}
+		],
+		"bicycle": {
+			"color": "red",
+			"price": 19.95
+		}
+	}
+};
+
+var path1 = 'store.book[0].author'; // The author of the first book
+var path2 = 'store.book[*].author'; // All authors
+var path3 = 'store..price'; // All prices
+var path4 = '$..book[?(@.price<10)]'; // All books cheaper than 10
+var path5 = '$..book[?(@.isbn)]'; // All books with an ISBN number
+var path6 = '$..*'; // All members of JSON structure
+
+var gjp = new GlideJsonPath(JSON.stringify(json));
+gs.info('Path: ' + path1 + ' Result: ' + gjp.read(path1));
+gs.info('Path: ' + path2 + ' Result: ' + gjp.read(path2));
+gs.info('Path: ' + path3 + ' Result: ' + gjp.read(path3));
+gs.info('Path: ' + path4 + ' Result: ' + gjp.read(path4));
+gs.info('Path: ' + path5 + ' Result: ' + gjp.read(path5));
+gs.info('Path: ' + path6 + ' Result: ' + gjp.read(path6));

Server-Side Components/Background Scripts/Duplicate Finder/findDuplicatesByCombination.js

@@ -0,0 +1,92 @@
+/**
+*	Finds and reports records that have duplicate values across a combination of specified fields instead of a single field
+*	Useful for finding for example duplicate items where unique key is not just 1 field
+*/
+
+// --- UPDATE ONLY THE VALUES BELOW ---
+var tableName = 'cmdb_model'; // ADD: The table you want to check for duplicates.
+var fieldNames = ['name', 'model_number', 'manufacturer']; // ADD: An array of fields that create the unique combination.
+
+// --- DO NOT EDIT BELOW THIS LINE ---
+findDuplicateCombinations(tableName, fieldNames);
+
+function findDuplicateCombinations(tableName, fieldNames) {
+    /**************************************/
+    /*** Basic Error Handling         ***/
+    /**************************************/
+
+    // Check if the table exists
+    if (!gs.tableExists(tableName)) {
+        gs.print('Error: Table "' + tableName + '" does not exist.');
+        return;
+    }
+
+    // Check if fieldNames is a valid, non-empty array
+    if (!Array.isArray(fieldNames) || fieldNames.length === 0) {
+        gs.print('Error: The "fieldNames" variable must be an array with at least one field.');
+        return;
+    }
+
+    // Check if all specified fields exist on the table
+    var gr = new GlideRecord(tableName);
+    gr.initialize();
+    for (var i = 0; i < fieldNames.length; i++) {
+        var currentField = fieldNames[i];
+        if (!gr.isValidField(currentField)) {
+            gs.print('Error: The field "' + currentField + '" does not exist on the "' + tableName + '" table.');
+            return;
+        }
+    }
+
+    /***************************************/
+    /*** Find Duplicate Combinations   ***/
+    /***************************************/
+    var duplicateJson = {}; // Stores the duplicate records and their counts
+    var duplicateGroupCount = 0; // Counts the number of groups of duplicates
+
+    var duplicateAggregate = new GlideAggregate(tableName);
+    duplicateAggregate.addAggregate('COUNT');
+
+    // Loop through the array to group by each field, creating the combination
+    for (var j = 0; j < fieldNames.length; j++) {
+        var field = fieldNames[j];
+        duplicateAggregate.groupBy(field);
+        duplicateAggregate.addNotNullQuery(field); // Ignore records where any part of the combination is empty
+    }
+
+    duplicateAggregate.addHaving('COUNT', '>', 1); // More than 1 means it is a duplicate combination
+    duplicateAggregate.query();
+
+    while (duplicateAggregate.next()) {
+        duplicateGroupCount++;
+        var combinationDisplay = [];
+
+        for (var k = 0; k < fieldNames.length; k++) {
+            var fieldName = fieldNames[k];
+            var fieldValue = duplicateAggregate.getDisplayValue(fieldName) || duplicateAggregate.getValue(fieldName);
+            combinationDisplay.push(fieldName + ': "' + fieldValue + '"');
+        }
+
+        var displayKey = combinationDisplay.join(', ');
+        var countInGroup = duplicateAggregate.getAggregate('COUNT');
+        duplicateJson[displayKey] = countInGroup;
+    }
+
+    /***************************************/
+    /*** Print the Results             ***/
+    /***************************************/
+
+    // No duplicates found
+    var fieldCombinationString = '"' + fieldNames.join('", "') + '"';
+    if (Object.keys(duplicateJson).length === 0) {
+        gs.print('No duplicates found for the field combination [' + fieldCombinationString + '] on table "' + tableName + '".');
+        return;
+    }
+
+    // Duplicates were found
+    gs.print("Found " + duplicateGroupCount + " groups of duplicates based on the combination [" + fieldCombinationString + "]:");
+
+    for (var key in duplicateJson) {
+        gs.print('Combination {' + key + '} has ' + duplicateJson[key] + ' occurrences.');
+    }
+}

Server-Side Components/Background Scripts/Duplicate Finder/script.js renamed to Server-Side Components/Background Scripts/Duplicate Finder/findDuplicatesBySingleField.js

@@ -1,10 +1,11 @@
-## ServiceNow Duplicate Record Finder
-A simple server-side script for ServiceNow that finds and reports on duplicate values for any field on any table. It uses an efficient GlideAggregate query and formats the results into a clean, readable report.
-
+# ServiceNow Duplicate Record Finder
+A simple server-side script for ServiceNow that finds and reports on duplicate values for any field on any table. It uses an efficient `GlideAggregate` query.
+## Find Duplicates by Single Field - `findDuplicatesBySingleField.js`
+This finds duplicates based on a single field which matches
 ### How to Use
 This script is designed to be run in **Scripts - Background** or as a Fix Script.
 1. Navigate: Go to **System Definition > Scripts - Background** (or type sys.scripts.do in the filter navigator).
-2. Copy Script: Copy the entire contents of the script.js file.
+2. Copy Script: Copy the entire contents of the `findDuplicatesBySingleField.js` file.
 3. Paste and Configure: Paste the script into the "Run script" text box. Add the table to search in `tableName` and the field to search for duplicates in `fieldName`
   ```js
   // Update ONLY below values to find duplicates
@@ -22,6 +23,25 @@ This script is designed to be run in **Scripts - Background** or as a Fix Script
   var fieldName = 'short_description';
   ```
 
-
 4. Run Script: Click the "Run script" button. The results will be displayed on the screen below the editor.
 
+## Find Duplicates by Field Combination - `findDuplicatesByCombination.js`
+This is a more powerful script that finds duplicate records based on a unique combination of one or more fields.
+
+### How to use
+This script is also designed to be run in **Scripts - Background**
+1. Navigate: Go to **System Definition > Scripts - Background**
+2. Copy Script: Copy the entire contents of the `findDuplicatesByCombination.js` file.
+3. Paste and Configure: Paste the script into the "Run script" text box. Update the `tableName` field and the `fieldNames` array. The `fieldNames` variable is an array, so even a single field must be enclosed in square brackets `[]`
+
+```js
+// --- UPDATE ONLY THE VALUES BELOW ---
+var tableName = '<table_name>'; // The table you want to check.
+var fieldNames = ['field_1', 'field_2']; // An array of fields for the unique combination.
+```
+
+For example, to find models with the same name, model number and manufacturer
+```js
+var tableName = 'cmdb_model';
+var fieldNames = ['name', 'model_number', 'manufacturer'];
+```

Server-Side Components/Background Scripts/Duplicate Finder/readme.md

@@ -0,0 +1,13 @@
+The script retrieves the top-level manager for the currently logged-in user  by traversing the manager hierarchy in the sys_user table.
+
+It starts from the current user and moves up through each manager until it reaches a user who does not have a manager.
+
+The script starts with the current user (e.g., Employee).
+
+It checks if the user has a manager.
+
+If yes, it moves up the hierarchy to the manager.
+
+It repeats this process until it reaches a user who does not have a manager.
+
+That user is considered the Top-Level Manager.

Server-Side Components/Background Scripts/Find Top-Level Manager Hierarchy/Readme.md

@@ -0,0 +1,25 @@
+var currentUser = gs.getUser(); // Current logged-in user
+var userGR = new GlideRecord('sys_user');
+var maxLevels = 7; 
+var currentLevel = 0;
+
+if (userGR.get(currentUser.getID())) {
+
+    // Loop until we find a user who has no manager or reach max level
+    while (userGR.manager && currentLevel < maxLevels) {
+        var managerID = userGR.getValue('manager');
+        var managerGR = new GlideRecord('sys_user');
+
+        if (managerGR.get(managerID)) {
+            userGR = managerGR; // Move up one level
+            currentLevel++;    
+			// gs.print(" Level " + currentLevel + " Manager: " + userGR.getDisplayValue('name'));
+        } else {
+            break; // Manager record not found
+        }
+    }
+
+    gs.print("Top-level (or Level " + currentLevel + ") Manager: " + userGR.getDisplayValue('name'));
+} else {
+    gs.print("User not found.");
+}