Merge branch 'ServiceNowDevProgram:main' into user-impersonation-activity-logger

Author: Its-Nmk

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

@@ -1,45 +1,36 @@
-Auto-Populate Short Description (Client Script)
-Overview
+# 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
+## 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
+## Configuration Steps
 
-Log in to your ServiceNow instance with admin or developer access.
-
-Navigate to System Definition → Client Scripts.
-
-Create a new Client Script with the following details:
+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
+## Testing
 
-Open any existing or new Incident record.
+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.
 
-Select a category such as Hardware or Software.
-
-The Short Description field will automatically update with the corresponding prefix.
-
-Benefits
+## 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/UI Actions/Generate a PDF/README.md

@@ -0,0 +1,8 @@
+# Introduction
+Generating a PDF using PDFGenerationAPI
+Calling an OOTB convertToPDFWithHeaderFooter() method to generate a PDF with your header and footer.
+PDFGenerationAPI – convertToPDFWithHeaderFooter(String html, String targetTable, String targetTableSysId, String pdfName, Object headerFooterInfo, String fontFamilySysId, Object documentConfiguration)
+
+# Example:
+<img width="704" height="496" alt="image" src="https://github.com/user-attachments/assets/9d086ee3-db76-482d-ab11-4b0540a5e2fb" />
+

Client-Side Components/UI Actions/Generate a PDF/serverscript.js

@@ -0,0 +1,50 @@
+//Table: Change Request
+// UI action button on the change form that exports all the related incidents into a PDF format.
+//ServiceNows PDFGenerationAPI allows you to customize the page size, header, footer, header image, page orientation, and more.
+
+var inc = new GlideRecord('incident'),
+    incidentsList = [],
+    v = new sn_pdfgeneratorutils.PDFGenerationAPI,
+    html = '',
+    hfInfo = new Object(),
+    result;
+inc.addQuery('rfc', current.sys_id);
+inc.query();
+while (inc.next()) {
+    incidentsList.push(inc.number);
+    incidentsList.push(inc.getDisplayValue('caller_id')); 
+    incidentsList.push(inc.getDisplayValue('category'));
+    incidentsList.push(inc.getDisplayValue('subcategory'));
+    incidentsList.push(inc.getValue('priority')); 
+    incidentsList.push(inc.getValue('short_description')); 
+    incidentsList.push(inc.getValue('description')); 
+    incidentsList.push(inc.getDisplayValue('assignment_group')); 
+}
+var json = {    
+    incidents: incidentsList.toString()
+};
+
+ JSON.stringify(json);
+html = '<h1 style="margin: 0in; text-align: center; line-height: 107%; break-after: avoid; font-size: 20pt; font-family: Calibri Light, sans-serif; color: #2e74b5; font-weight: normal;" align="center"><strong><span style="font-size: 16.0pt; line-height: 107%; font-family: Arial Narrow, sans-serif; color: #002060;">Incidents Related to the Change: ' + current.number + ' </span></strong></h1><br>';
+
+
+html += '<div style="width: 100%"><p><strong><span style="font-size: 11pt; font-family: Arial Arrow; color: #002060;">Incidents List</span><span style="font-size: 2pt; font-family: Palatino; color: #002060;">&nbsp;&nbsp;</span></strong></p></div>';
+html += '<table style="table-layout: fixed; width: 100%; border-collapse: collapse;" border="1"><tr style="text-align: center;background-color: #B4C6E7;font-size: 10pt; font-family: Arial Arrow; word-wrap: break-word;"><td><strong>Number</strong></td><td><strong>Caller</strong></td><td><strong>Category</strong></td><td><strong>Sub Category</strong></td><td><strong>Priority</strong></td><td><strong>Short Description</strong></td><td><strong>Description</strong></td><td><strong>Assignment Group</strong></td></tr>' + getIncidentsTable(json.incidents) + '</table>';
+hfInfo["FooterTextAlignment"] = "BOTTOM_CENTER";
+hfInfo["FooterText"] = "Incidents List";
+hfInfo["PageOrientation"] = "LANDSCAPE";
+hfInfo["GeneratePageNumber"] = "true";
+
+result = v.convertToPDFWithHeaderFooter(html, 'change_request', current.sys_id, "Incidents Related to the Change:_" + current.number, hfInfo);
+action.setRedirectURL(current);
+
+function getIncidentsTable(incidents) {
+    if (incidents == '')
+        return '';
+    var table = '',
+        i;
+    incidents = incidents.split(',');
+    for (i = 0; i < incidents.length; i += 8)
+        table += '<tr style="text-align: center;font-size: 10pt; font-family: Arial Arrow; word-wrap: break-word;"><td>' + incidents[i] + '</td><td>' + incidents[i + 1] + '</td><td>' + incidents[i +2] + '</td><td>' + incidents[i + 3] + '</td><td>' + incidents[i + 4] + '</td><td>' + incidents[i + 5] + '</td><td>' + incidents[i + 6] + '</td><td>' + incidents[i + 7] + '</td></tr>';
+    return table;
+}

Core ServiceNow APIs/GlideAggregate/Incident resolution percentile by assignment group/PercentileMetrics.js

@@ -0,0 +1,82 @@
+// Script Include: PercentileMetrics
+// Purpose: Compute percentile resolution times by group using nearest-rank selection.
+// Scope: global or scoped. Client callable false.
+
+var PercentileMetrics = Class.create();
+PercentileMetrics.prototype = {
+  initialize: function() {},
+
+  /**
+   * Compute percentiles for incident resolution times by group.
+   * @param {Object} options
+   *   - windowDays {Number} lookback window (default 30)
+   *   - groupField {String} field to group by (default 'assignment_group')
+   *   - percentiles {Array<Number>} e.g. [0.5, 0.9]
+   *   - table {String} table name (default 'incident')
+   * @returns {Array<Object>} [{ group: <sys_id>, count: N, avgMins: X, p: { '0.5': v, '0.9': v } }]
+   */
+  resolutionPercentiles: function(options) {
+    var opts = options || {};
+    var table = opts.table || 'incident';
+    var groupField = opts.groupField || 'assignment_group';
+    var windowDays = Number(opts.windowDays || 30);
+    var pct = Array.isArray(opts.percentiles) && opts.percentiles.length ? opts.percentiles : [0.5, 0.9];
+
+    // Build date cutoff for resolved incidents
+    var cutoff = new GlideDateTime();
+    cutoff.addDaysUTC(-windowDays);
+
+    // First pass: find candidate groups with counts and avg
+    var ga = new GlideAggregate(table);
+    ga.addQuery('resolved_at', '>=', cutoff);
+    ga.addQuery('state', '>=', 6); // resolved/closed states
+    ga.addAggregate('COUNT');
+    ga.addAggregate('AVG', 'calendar_duration'); // average of resolution duration
+    ga.groupBy(groupField);
+    ga.query();
+
+    var results = [];
+    while (ga.next()) {
+      var groupId = ga.getValue(groupField);
+      var count = parseInt(ga.getAggregate('COUNT'), 10) || 0;
+      if (!groupId || count === 0) continue;
+
+      // Second pass: ordered sample to pick percentile ranks
+      var ordered = new GlideRecord(table);
+      ordered.addQuery('resolved_at', '>=', cutoff);
+      ordered.addQuery('state', '>=', '6');
+      ordered.addQuery(groupField, groupId);
+      ordered.addNotNullQuery('closed_at');
+      // Approx resolution minutes using dateDiff: closed_at - opened_at in minutes
+      ordered.addQuery('opened_at', 'ISNOTEMPTY');
+      ordered.addQuery('closed_at', 'ISNOTEMPTY');
+      ordered.orderBy('closed_at'); // for stability
+      ordered.query();
+
+      var durations = [];
+      while (ordered.next()) {
+        var opened = String(ordered.getValue('opened_at'));
+        var closed = String(ordered.getValue('closed_at'));
+        var mins = gs.dateDiff(opened, closed, true) / 60; // seconds -> minutes
+        durations.push(mins);
+      }
+      durations.sort(function(a, b) { return a - b; });
+
+      var pvals = {};
+      pct.forEach(function(p) {
+        var rank = Math.max(1, Math.ceil(p * durations.length)); // nearest-rank
+        pvals[String(p)] = durations.length ? Math.round(durations[rank - 1]) : 0;
+      });
+
+      results.push({
+        group: groupId,
+        count: count,
+        avgMins: Math.round(parseFloat(ga.getAggregate('AVG', 'calendar_duration')) / 60),
+        p: pvals
+      });
+    }
+    return results;
+  },
+
+  type: 'PercentileMetrics'
+};

Core ServiceNow APIs/GlideAggregate/Incident resolution percentile by assignment group/README.md

@@ -0,0 +1,27 @@
+# Incident resolution percentile by assignment group
+
+## What this solves
+Leaders often ask for P50 or P90 of incident resolution time by assignment group. Out-of-box reports provide averages, but percentiles are more meaningful for skewed distributions. This utility computes configurable percentiles from incident resolution durations.
+
+## Where to use
+- Script Include callable from Background Scripts, Scheduled Jobs, or Flow Actions
+- Example Background Script is included
+
+## How it works
+- Uses `GlideAggregate` to get candidate groups with resolved incidents in a time window
+- For each group, queries resolved incidents ordered by resolution duration (ascending)
+- Picks percentile ranks (for example 0.5, 0.9) using nearest-rank method
+- Returns a simple object per group with count, average minutes, and requested percentiles
+
+## Configure
+- `WINDOW_DAYS`: number of days to look back (default 30)
+- `GROUP_FIELD`: field to group by (default `assignment_group`)
+- Percentiles array (for example `[0.5, 0.9]`)
+
+## References
+- GlideAggregate API  
+  https://www.servicenow.com/docs/bundle/zurich-api-reference/page/app-store/dev_portal/API_reference/GlideAggregate/concept/c_GlideAggregateAPI.html
+- GlideRecord API  
+  https://www.servicenow.com/docs/bundle/zurich-api-reference/page/app-store/dev_portal/API_reference/GlideRecord/concept/c_GlideRecordAPI.html
+- GlideDateTime API  
+  https://www.servicenow.com/docs/bundle/zurich-api-reference/page/app-store/dev_portal/API_reference/GlideDateTime/concept/c_GlideDateTimeAPI.html

Core ServiceNow APIs/GlideAggregate/Incident resolution percentile by assignment group/example_background_usage.js

@@ -0,0 +1,13 @@
+// Background Script: example usage for PercentileMetrics
+(function() {
+  var util = new PercentileMetrics();
+  var out = util.resolutionPercentiles({
+    windowDays: 30,
+    groupField: 'assignment_group',
+    percentiles: [0.5, 0.9, 0.95]
+  });
+
+  out.forEach(function(r) {
+    gs.info('Group=' + r.group + ' count=' + r.count + ' avg=' + r.avgMins + 'm P50=' + r.p['0.5'] + 'm P90=' + r.p['0.9'] + 'm P95=' + r.p['0.95'] + 'm');
+  });
+})();

Server-Side Components/Background Scripts/Analyze user access UI page/readme.md

@@ -0,0 +1 @@
+Background script to check if a specific user has access to UI page

Server-Side Components/Background Scripts/Analyze user access UI page/script.js

@@ -0,0 +1,11 @@
+/*
+Below background script can be used to analyze if user has access to UI page 
+*/
+
+var user = '5381f6fbdb5f4d14567a8e7a4896192e'; // Gets current user ID
+var pageId = "manage_access"; // Replace with your actual page ID
+
+var spScriptable = new GlideSPScriptable();
+var canAccess = spScriptable.canSeePage(pageId);
+
+gs.print("User " + user + " can access page '" + pageId + "': " + canAccess);