Merge branch 'ServiceNowDevProgram:main' into main

Author: prashantmrshine

Core ServiceNow APIs/GlideAggregate/LicensedUserCount/licensed_user_count_by_role.js

@@ -0,0 +1,23 @@
+(function() {
+    // Purpose: Count how many users hold each licensed role
+    // Roles: sys_approver, itil, business_stakeholder, admin
+
+    var roles = ['sys_approver', 'itil', 'business_stakeholder', 'admin'];
+
+    for (var i = 0; i < roles.length; i++) {
+        var roleName = roles[i];
+
+        var ga = new GlideAggregate('sys_user_has_role');
+        ga.addQuery('role.name', roleName);
+        ga.addAggregate('COUNT');
+        ga.query();
+
+        if (ga.next()) {
+            var count = parseInt(ga.getAggregate('COUNT'), 10);
+            gs.info(roleName + ': ' + count + ' licensed users');
+        } else {
+            gs.info(roleName + ': no users found.');
+        }
+    }
+
+})();

Core ServiceNow APIs/GlideAggregate/LicensedUserCount/readme.md

@@ -0,0 +1,14 @@
+# Licensed User Count by Role Using GlideAggregate
+
+# Overview
+This script counts how many **licensed users** hold specific ServiceNow roles using the `GlideAggregate` API.  
+It’s useful for **license compliance**, **role audits**, and **access management reporting**.
+
+The licensed roles analyzed:
+- sys_approver  
+- itil  
+- business_stakeholder  
+- admin  
+
+# Objective
+To provide a simple, fast, and accurate way to count licensed users per role directly at the database level using `GlideAggregate`.

Core ServiceNow APIs/GlideRecord/CheckDuplicate-Server/readme.md

@@ -0,0 +1,25 @@
+Scan all Servers (cmdb_ci_server). For each one, check if there is another CI in cmdb_ci_computer with the same name but not a server (sys_class_name != cmdb_ci_server).
+
+If found, log the server name and the duplicate CI’s class; keep a running duplicate count; finally log the total.
+
+*******Descriton****
+1. var gr = new GlideRecord("cmdb_ci_server");
+2. Creates a record set for Server CIs.
+
+
+gr.addEncodedQuery("sys_class_name=cmdb_ci_server");
+3. Redundant: you’re already targeting the cmdb_ci_server table which is a class table. This filter doesn’t harm, but it’s unnecessary.
+
+
+while (gr.next()) { ... }
+4. Loops through each server CI.
+
+
+5.Inside loop:
+
+Query cmdb_ci_computer for records with the same name but where sys_class_name != cmdb_ci_server.
+6. If found, log the duplicate and increment dupCount.
+
+
+
+7. Finally logs total dupCount.

Core ServiceNow APIs/GlideRecord/CheckDuplicate-Server/script.js

@@ -0,0 +1,17 @@
+var dupCount = 0;
+var gr = new GlideRecord("cmdb_ci_server");
+//gr.addQuery("name", "value");
+gr.addEncodedQuery("sys_class_name=cmdb_ci_server");
+gr.query();
+while (gr.next()) {
+   var dup = new GlideRecord("cmdb_ci_computer");
+	dup.addQuery("name", gr.name);
+	dup.addQuery("sys_class_name", "!=", "cmdb_ci_server");
+	dup.query();
+	if (dup.next()) {
+		gs.log("\t" + gr.name + "\t" + dup.sys_class_name);
+		dupCount++;
+	}
+
+}
+gs.log("dup count=" + dupCount);

Core ServiceNow APIs/GlideRecord/Field Level Audit/README.md

@@ -0,0 +1,36 @@
+# GlideRecord Field-Level Audit
+
+## Description
+This snippet compares two GlideRecord objects field by field and logs all differences.  
+It is useful for debugging, auditing updates, or validating changes in Business Rules, Script Includes, or Background Scripts.
+
+## Prerequisites
+- Server-side context (Background Script, Business Rule, Script Include)
+- Two GlideRecord objects representing the original and updated records
+- Access to the table(s) involved
+
+## Note
+- Works in Global Scope
+- Server-side execution only
+- Logs all fields with differences to system logs
+- Does not modify any records
+## Usage
+```javascript
+// Load original record
+var oldRec = new GlideRecord('incident');
+oldRec.get('sys_id_here');
+
+// Load updated record
+var newRec = new GlideRecord('incident');
+newRec.get('sys_id_here');
+
+// Compare and log differences
+fieldLevelAudit(oldRec, newRec);
+```
+
+## Output
+```
+Field changed: priority | Old: 5 | New: 2
+Field changed: state    | Old: 1 | New: 3
+Field changed: short_description | Old: 'Old description' | New: 'New description'
+```

Core ServiceNow APIs/GlideRecord/Field Level Audit/fieldLevelAudit.js

@@ -0,0 +1,25 @@
+/**
+ * Compare two GlideRecord objects field by field and log differences.
+ *
+ * @param {GlideRecord} grOld - Original record before changes
+ * @param {GlideRecord} grNew - Updated record to compare against
+ */
+function fieldLevelAudit(grOld, grNew) {
+    if (!grOld || !grNew) {
+        gs.error('Both old and new GlideRecord objects are required.');
+        return;
+    }
+
+    var fields = grOld.getFields();
+    fields.forEach(function(f) {
+        var name = f.getName();
+        var oldValue = grOld.getValue(name);
+        var newValue = grNew.getValue(name);
+
+        if (oldValue != newValue) {
+            gs.info('Field changed: ' + name + 
+                    ' | Old: ' + oldValue + 
+                    ' | New: ' + newValue);
+        }
+    });
+}

Modern Development/Service Portal Widgets/Change Calendar Report/Body HTML template.html

@@ -0,0 +1,8 @@
+<div class="report-widget-wrap">
+
+	<h2 ng-if="c.showTitle" tabindex="0" id="{{'title-' + c.rectangleId }}" class="report-widget-title">{{c.title}}</h2>
+
+	<div id="report-widget-{{c.rectangleId}}">
+     {{::c.initialMessage}}
+  </div>
+</div>

Modern Development/Service Portal Widgets/Change Calendar Report/CSS

@@ -0,0 +1,52 @@
+.report-widget-wrap {
+			background:#fff;
+			padding:15px;
+			margin: 0 0 15px 0;
+			}
+			
+			.report-widget-title {
+			padding: $sp-space--xl;
+			font-weight:bold;
+			margin-top: 0;
+			margin-bottom: 0;
+			font-family: $now-sp-font-family-sans-serif;
+			color: $text-color;
+			font-size: $font-size-h4;
+			
+			}
+			
+			.highcharts-container g.highcharts-button *,
+			.highcharts-container image.hc-image {
+			transition: fill-opacity 0.3s linear, stroke-opacity 0.3s linear, opacity 0.3s linear;
+			fill-opacity: 0;
+			stroke-opacity: 0;
+			opacity:0;
+			}
+			
+			.highcharts-container:hover g.highcharts-button *,
+			.highcharts-container:hover image.hc-image {
+			fill-opacity: 1;
+			stroke-opacity: 1;
+			opacity:1;
+			}
+			
+			.highcharts-legend-item span::after,
+			.highcharts-legend-item::after {
+			content: "\200E";
+			}
+			
+			table.wide .pivot_cell,
+			table.wide .pivot_caption,
+			table.wide .pivot_caption_dark {
+			padding: 3px 5px;
+			}
+            .highlight-wrap {
+                display: none;
+            }
+
+            .fc-week-number {
+                width: 42px;
+                background-color: #ededed;
+            }
+            
+		

Modern Development/Service Portal Widgets/Change Calendar Report/Client Controller

@@ -0,0 +1,101 @@
+function($scope, $uibModal, $timeout, spUtil) {
+    var c = this;
+    var reportId = c.options.report_id || '';
+    c.rectangleId = c.widget.rectangle_id || c.data.rectangleId;
+    c.showTitle = (c.options.show_title === true || c.options.show_title === 'true');
+    c.title = c.options.title || '';
+
+    if (c.options.widget_parameters) {
+        c.initialMessage = c.data.ch.i18n.building;
+        window.chartHelpers = window.chartHelpers || {};
+        $.extend(window.chartHelpers, c.data.ch);
+
+        $timeout(function() {
+            var targetEl = $("#report-widget-" + c.rectangleId);
+            embedReportById(targetEl, reportId);
+
+            $timeout(function() {
+                targetEl.off('click', 'a[href*="change_request.do?sys_id"]');
+
+                targetEl.on('click', 'a[href*="change_request.do?sys_id"]', function(event) {
+                    event.preventDefault();
+                    var href = $(this).attr('href') || '';
+                    var match = href.match(/sys_id=([a-f0-9]{32})/i);
+                    var sysId = match ? match[1] : '';
+
+                    var modalData = {
+                        number: '',
+                        short_description: '',
+                        description: '',
+                        sys_id: sysId
+                    };
+
+                    // Open modal immediately
+                    $uibModal.open({
+                        controller: function($scope, $uibModalInstance, $sce) {
+                            $scope.data = modalData;
+
+                            $scope.getTrustedDescription = function() {
+                                if (!$scope.data.description) return '';
+                                var text = $scope.data.description;
+
+                                // Convert line breaks to <br>
+                                text = text.replace(/\n/g, '<br>');
+
+                                // Convert URLs to links
+                                var urlRegex = /(\bhttps?:\/\/[^\s<]+)/gi;
+                                text = text.replace(urlRegex, function(url) {
+                                    return '<a href="' + url + '" target="_blank" rel="noopener noreferrer">' + url + '</a>';
+                                });
+
+                                // Convert emails to mailto links
+                                var emailRegex = /([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,6})/gi;
+                                text = text.replace(emailRegex, function(email) {
+                                    return '<a href="mailto:' + email + '">' + email + '</a>';
+                                });
+
+                                return $sce.trustAsHtml(text);
+                            };
+
+                            $scope.close = function() {
+                                $uibModalInstance.dismiss('cancel');
+                            };
+                        },
+                        resolve: {
+                            $sce: function() {
+                                return angular.injector(['ng']).get('$sce');
+                            }
+                        },
+                        template: '<div class="modal-header">' +
+                            '<h4 class="modal-title">Change Details</h4>' +
+                            '</div>' +
+                            '<div class="modal-body">' +
+                            '<p><strong>Change Number:</strong> {{data.number}}</p>' +
+                            '<p><strong>Short Description:</strong> {{data.short_description}}</p>' +
+                            '<p><strong>Description:</strong></p>' +
+                            '<p ng-bind-html="getTrustedDescription()"></p>' +
+                            '</div>' +
+                            '<div class="modal-footer">' +
+                            '<a class="btn btn-primary" ng-href="/change_request.do?sys_id={{data.sys_id}}" target="_blank">View Record</a>' +
+                            '<button class="btn btn-default" ng-click="close()">Close</button>' +
+                            '</div>'
+                    });
+
+                    // Populate modal data via server
+                    spUtil.get(c.widget.sys_id, {
+                        action: 'getChangeDetails',
+                        sys_id: sysId
+                    }).then(function(response) {
+                        if (response.data.changeDetails && !response.data.changeDetails.error) {
+                            modalData.number = response.data.changeDetails.number;
+                            modalData.short_description = response.data.changeDetails.short_description;
+                            modalData.description = response.data.changeDetails.description;
+                        }
+                    });
+                });
+            }, 1000);
+        });
+    } else {
+        c.initialMessage = c.data.ch.i18n.selectReport;
+    }
+}