Merge branch 'main' into CopyBulkIDs

Author: dvn-lazywinner

Client-Side Components/Catalog Client Script/Set and Lock Variable by Group/README.md

@@ -0,0 +1,5 @@
+**Set and Lock Variable by Group**
+
+This solution provides a secure and dynamic way to control data entry on a Service Catalog form based on the user's group membership. It is typically used to pre-fill and lock certain justification or approval bypass fields for authorized users (like managers or executive staff), improving their efficiency while maintaining an accurate audit trail.
+
+This functionality requires a combined Client-side (Catalog Client Script) and Server-side (Script Include) approach to ensure the group check is done securely.

Client-Side Components/Catalog Client Script/Set and Lock Variable by Group/set_lock_variable_by_grp.js

@@ -0,0 +1,33 @@
+// onload Catalog Client Script with Catalog Name 
+function onLoad() {
+    var variableName = 'bypass_approval_reason';
+    var targetGroupName = 'ServiceNow Support'; // The group authorized to skip this step
+    var ga = new GlideAjax('UserUtils');
+    ga.addParam('sysparm_name', 'isMemberOf');
+    ga.addParam('sysparm_group_name', targetGroupName);
+    ga.getXMLAnswer(checkAndLockVariable);
+    function checkAndLockVariable(response) {
+        var isMember = response;
+        if (isMember == 'true') {
+            var message = 'Value set and locked due to your ' + targetGroupName + ' membership.';
+            var setValue = 'Bypassed by authorized ' + targetGroupName + ' member.';
+            g_form.setValue(variableName, setValue);
+            g_form.setReadOnly(variableName, true);
+            g_form.showFieldMsg(variableName, message, 'info');
+        } else {
+            g_form.setReadOnly(variableName, false);
+        }
+    }
+}
+
+//Script Include
+var UserUtils = Class.create();
+UserUtils.prototype = Object.extendsObject(AbstractAjaxProcessor, {
+    isMemberOf: function() {
+        var groupName = this.getParameter('sysparm_group_name');
+        var isMember = gs.getUser().isMemberOf(groupName);
+        return isMember.toString();
+    },
+
+    type: 'UserUtils'
+});

Client-Side Components/Client Scripts/Dynamic Reference Qualifier with Filtering/README.md

@@ -0,0 +1,6 @@
+**Dynamic Reference Qualifier with Filtering**
+This Client Script provides a solution for dynamically updating the available options in a Reference Field based on the value selected in another field on the same form.
+
+This technique is essential for ensuring data quality and improving the user experience (UX). 
+
+A typical use case is filtering the Assignment Group field to show only groups relevant to the selected Service, Category, or Location.

Client-Side Components/Client Scripts/Dynamic Reference Qualifier with Filtering/reference_qual_dynamic.js

@@ -0,0 +1,14 @@
+ function onChange(control, oldValue, newValue, isLoading, isTemplate) {
+    if (isLoading || newValue === '') {
+        return;
+    }
+    var controlledField = 'assignment_group'; 
+    var controllingField = 'u_service';     
+    var serviceSysId = g_form.getValue(controllingField);
+    var encodedQuery = 'typeLIKEITIL^u_related_service=' + serviceSysId;
+    g_form.setQuery(controlledField, encodedQuery);
+    var currentGroupSysId = g_form.getValue(controlledField);
+    if (currentGroupSysId && oldValue !== '' && currentGroupSysId !== '') {
+        g_form.setValue(controlledField, '');
+    }
+}

Client-Side Components/Client Scripts/Health Scan Prevent Insert Update in Before BRs/README.md

@@ -0,0 +1,11 @@
+**Client script Deatils**
+1. Table: sys_script
+2. Type: onSubmit
+3. UI Type: Desktop
+
+**Benefits**
+1. This client script will prevent admin users to do insert/update operation in  onBefore business rules.
+2. It will help to avoid HealthScan findings thus increasing healthscan score.
+3. Will prevent recursive calls.
+
+Link to ServiceNow Business Rules best Practise : https://developer.servicenow.com/dev.do#!/guide/orlando/now-platform/tpb-guide/business_rules_technical_best_practices

Client-Side Components/Client Scripts/Health Scan Prevent Insert Update in Before BRs/script.js

@@ -0,0 +1,15 @@
+function onSubmit() {
+    /*
+	This client script will prevent insert and update operation in onBefore business rules.
+    Table: sys_script
+    Type: onSubmit
+    Ui Type: Desktop
+    */
+    var whenCond = g_form.getValue('when'); // when condition of business rule
+    var scriptVal = g_form.getValue('script'); // script value of business rule.
+
+    if (whenCond == 'before' && (scriptVal.indexOf('insert()') > -1 || scriptVal.indexOf('update()')) > -1) {
+        alert("As per ServiceNow best Practise insert and update should be avoided in onBefore BRs. If you still want tp proceed try deactivating client script : " + g_form.getUniqueValue());
+        return false;
+    }
+}

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);