Merge branch 'ServiceNowDevProgram:main' into main

Author: Soumyadeep10

Client-Side Components/UI Actions/Kill flow timers/README.md

@@ -0,0 +1,12 @@
+# UI Action to kill flow timers
+
+UI page that shows you all timers that a flow context [sys_flow_context] is waiting for. Shows sys_id of the sys_trigger, the datetime when the wait will finish and how long until that time. Select the checkbox and submit the modal form to kill that timer.
+
+## How to use
+
+1. Create ui action on [sys_flow_context] and input the script from *UI action.js* in the script field. Check client and set Onclick as *openTimerDialog()*
+2. Create ui page with name *timer_kill_dialog* and copy the HTML, client script and processing script from the *UI page for ui action.js* file
+3. Navigate to active flow context that is waiting for timers and click the ui action from step 1 and kill timer/s. Flow will progress as soon as the flow engine processes the flow.fire events
+
+![image](timer.png)
+

Client-Side Components/UI Actions/Kill flow timers/UI action.js

@@ -0,0 +1,9 @@
+//Onlick: openTimerDialog()
+
+//open dialog using glidemodal and timer_kill_dialog ui page, pass in current sys_flow_context sysid
+function openTimerDialog() {
+	var dialog = new GlideModal("timer_kill_dialog");
+	dialog.setTitle("Kill timers");
+	dialog.setPreference('sysparm_id', g_form.getUniqueValue());
+	dialog.render();
+}

Client-Side Components/UI Actions/Kill flow timers/UI page for ui action.js

@@ -0,0 +1,100 @@
+//name: timer_kill_dialog
+
+//HTML:
+<?xml version="1.0" encoding="utf-8" ?>
+<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
+	<g:evaluate var="jvar_timers" object="true">
+    // executed server side, gets wait jobs for current flow context and returns object with information about timers
+		var array = [];
+		var waitJob = new GlideRecord("sys_trigger");
+		waitJob.addQuery("state", "0")
+			.addCondition("name", "flow.fire")
+			.addCondition("script", "CONTAINS", RP.getParameterValue("sysparm_id"));
+		waitJob.query();
+		while (waitJob.next()) {
+			var obj = {};
+			obj.sys_id = waitJob.getUniqueValue();
+			obj.waitUntil = waitJob.getValue("next_action");
+			var now = new GlideDateTime()
+			obj.timeLeft = GlideDateTime.subtract(now, new GlideDateTime(waitJob.getValue("next_action"))).getDisplayValue()
+			array.push(obj)
+		}
+		array;
+	</g:evaluate>
+
+	<style>
+		table td {
+			padding: 8px;
+		}
+
+		table thead td {
+			font-weight: bold;
+			background-color: #f0f0f0;
+		}
+	</style>
+
+  <!-- submittable form that shows the wait jobs in [sys_trigger] for context and a checkbox to select timers to kill -->
+	<g:ui_form>
+		<input type="hidden" id="sysids" name="sysids" value="" />
+		<div style="padding: 20px; font-family: sans-serif;">
+			<table>
+				<tbody>
+					<thead>
+						<td>timer sys_id</td>
+						<td>next action</td>
+						<td>time left</td>
+						<td>kill?</td>
+					</thead>
+					<j:forEach var="jvar_timer" items="${jvar_timers}">
+						<tr>
+							<td>
+								${jvar_timer.sys_id}
+							</td>
+							<td>
+								${jvar_timer.waitUntil}
+							</td>
+							<td>
+								${jvar_timer.timeLeft}
+							</td>
+							<td>
+								<g:ui_checkbox name="${jvar_timer.sys_id}">
+								</g:ui_checkbox>
+							</td>
+						</tr>
+					</j:forEach>
+				</tbody>
+			</table>
+			<g:dialog_buttons_ok_cancel ok="return okDialog()" />
+		</div>
+	</g:ui_form>
+</j:jelly>
+
+//Client script:
+// handler for clicking ok on modal. gathers the sys_ids for the timers that have checked checkbox
+function okDialog() {
+	var c = gel('sysids');
+	var sysids = [];
+	$j('input[type="checkbox"]:checked').each(function () {
+		var checkboxId = $j(this).attr('id').replace("ni.", "");
+		sysids.push(checkboxId);
+	});
+	c.value = sysids.toString();
+	return true;
+}
+
+//Processing script:
+// queries for timer jobs and sets the job and new flow.fire event to process instantly -> timer on flow completes 
+var waitJob = new GlideRecord("sys_trigger");
+waitJob.addQuery("sys_id", "IN", sysids);
+waitJob.query();
+while (waitJob.next()) {
+	var currentScript = waitJob.getValue("script");
+	var now = new GlideDateTime().getValue();
+	var replaceScript = currentScript.replace(/gr\.setValue\('process_on',\s*'[^']*'\)/, "gr.setValue('process_on','" + now + "')");
+	waitJob.setValue("script", replaceScript);
+	waitJob.setValue("next_action", now);
+	waitJob.update();
+}
+//redirect back to bottom of nav stack
+var urlOnStack = GlideSession.get().getStack().bottom();
+response.sendRedirect(urlOnStack);

Client-Side Components/UI Actions/Kill flow timers/timer.png

@@ -0,0 +1,37 @@
+var userId = ['abel.tuter', 'abraham.lincoln']; //example
+var workItems = ['INC0009009', 'INC0009005'];
+/* Beginning of function*/
+
+var gi = GlideImpersonate();
+var currUser = gs.getUserID();
+
+// If the logged in user doesn't have impersonating roles.
+if (!gi.canImpersonate(currUser)) {
+    gs.info("You don't have access to impersonate");
+}
+for (var id in userId) {
+    var userGr = new GlideRecord('sys_user');
+    userGr.addQuery('user_name', userId[id]);
+    userGr.query();
+    if (!userGr.hasNext()) {
+      // If the user id mentioned is incorrect
+        gs.print("Cannot find user from user id " + user[id] + ". Please Validate the user id");
+    } else if (userGr.active == 'false') {
+      //If the persona is inactive
+        gs.print(id + " is inactve.");
+    } else {
+		gi.impersonate(userGr.sys_id);
+      // Analysis report
+        gs.print("Access result for " + gs.getUserDisplayName + ":");
+		for (var item in workItems){
+			var taskGr = new GlideRecord('task');
+			taskGr.addQuery('number', workItems[item]);
+			taskGr.query();
+			gs.print(workItems[item] + " Read: " + taskGr.canRead() + ", Write: " + taskGr.canWrite());
+		}
+
+    }
+
+}
+// End impersonation. Impersonate back to logged in user
+gi.impersonate(currUser); 

Server-Side Components/Background Scripts/Access Analysis Utility/Access alaysis script.js

@@ -0,0 +1,5 @@
+In scenarios where it's necessary to verify Read/Write access for multiple users across various work items (such as Incidents, Tasks, etc.), traditional methods like impersonating individual users or using the Access Analyzer plugin can be time-consuming. This utility streamlines the process by enabling simultaneous access analysis for multiple users by impersonating them and can be executed efficiently via a background script.
+
+userId- Array containing the user id of personas whose access to be analyzed.
+
+workItems- Work items extending the 'task' table.

Server-Side Components/Background Scripts/Access Analysis Utility/Access report example.png

@@ -0,0 +1 @@
+Use the script as Business Rule script on Catalog Task table which runs After Insert and will copy all MRVS values from RITM to Catalog Task for quick actions at the Catalog Task itself for reviewing and getting the work completed.

Server-Side Components/Background Scripts/Access Analysis Utility/README.md

@@ -0,0 +1,38 @@
+(function executeRule(current, previous /*null when async*/ ) {
+
+    // Copies the values from a multi-row variable set into a variable so we can view the values on a catalog task.
+    var variables = [];
+    var catItem = current.request_item.cat_item.toString();
+    var variableSets = [];
+    var getVariableSets = new GlideRecord('io_set_item');
+    getVariableSets.addQuery('sc_cat_item', catItem);
+    getVariableSets.query();
+    while (getVariableSets.next()) {
+        variableSets.push(getVariableSets.getValue('variable_set'));
+    }
+    var getCatalogVariables = new GlideRecord('item_option_new');
+    var qry = 'cat_item=' + catItem +
+        '^active=true' +
+        '^NQvariable_set.sys_idIN' + variableSets.toString() +
+        '^active=true';
+    getCatalogVariables.addQuery(qry);
+    getCatalogVariables.query();
+    while (getCatalogVariables.next()) {
+        variables.push(getCatalogVariables.getValue('sys_id'));
+    }
+    var variablesCount = variables.length;
+    var currentTaskID = current.sys_id.toString();
+    for (var i = 0; i < variablesCount; i++) {
+        var getTaskVars = new GlideRecord('sc_item_variables_task');
+        getTaskVars.addQuery('task', currentTaskID);
+        getTaskVars.addQuery('variable', variables[i]);
+        getTaskVars.setLimit(1);
+        getTaskVars.query();
+        if (!getTaskVars.hasNext()) {
+            getTaskVars.initialize();
+            getTaskVars.setValue('task', currentTaskID);
+            getTaskVars.setValue('variable', variables[i]);
+            getTaskVars.insert();
+        }
+    }
+})(current, previous);