Merge branch 'ServiceNowDevProgram:main' into main

Author: raghavs046

Server-Side Components/Business Rules/Prevent closure if change tasks are open/Before_BR.js

@@ -0,0 +1,14 @@
+function executeRule(current, previous /*null when async*/){
+  if(current.close_code){
+    var taskGR = new GlideRecord('change_task');
+    taskGR.addQuery('change_request', current.sys_id);
+    taskGR.addQuery('state', '!=', '3') // Adjust as needed
+    taskGR.query();
+
+  if (taskGR.hasNext()){
+    gs.addErrorMessage('You cannot close this change request until all change tasks are closed.');
+    current.setAbortAction(true); // Prevent saving the form
+   }
+ }
+
+})(current, previous);

Server-Side Components/Business Rules/Prevent closure if change tasks are open/README.md

@@ -0,0 +1,10 @@
+Prevent Closure if the change tasks are open
+
+1. Create a Before Business Rule.
+2. Applicable to Change Request Table.
+3. Use Before - Update Business Rule.
+4. Add filter conditions if required.
+5. Apply the Business Rule script.
+6. If the change request have the active change tasks are still open then we can't proceed with the submission.
+7. If required we can add few more query conditions.
+8. 

Server-Side Components/Business Rules/Update Set Scope Validation/README.md

@@ -0,0 +1,53 @@
+
+# Business Rule: Validate Update Set Scope
+
+
+## Challenge
+
+When working with update sets, mismatched scopes can lead to issues during the preview process in the target instance. This often results in errors that require manual intervention to resolve. Such errors can be time-consuming, especially for minor mismatches that could have been identified and prevented earlier. This challenge highlights the need for a mechanism to validate update set scopes before completion, saving time and effort during deployment.
+
+
+## Overview
+This business rule ensures that all customer updates within an update set match the application scope of the update set. If any updates have mismatched scopes, the business rule restricts the completion of the update set and displays a message listing the files with mismatched scopes.
+
+## Features
+- Validates the scope of all updates in an update set.
+- Prevents the completion of an update set if scope mismatches are detected.
+- Displays a detailed message listing the files with mismatched scopes.
+
+## Use Case
+This business rule is useful for ensuring that updates in an update set adhere to the correct application scope, preventing potential issues caused by scope mismatches.
+
+## Implementation
+
+### 1. Create the Business Rule
+1. Navigate to **System Definition > Business Rules** in your ServiceNow instance.
+2. Click **New** to create a new business rule.
+3. Configure the business rule as follows:
+    - **Name**: Validate Update Set Scope
+    - **Table**: `sys_update_set`
+    - **When**: Before
+    - **Insert**: False
+    - **Update**: True
+    - **Delete**: False
+
+### 2. Add the Script
+Use the following script in the **Script** field:
+
+```javascript
+(function executeRule(current, previous /*null when async*/) {
+
+	// Add attached code here
+ 
+})(current, previous);
+
+```
+
+### 3. Test the Business Rule
+1. Create an update set and add updates with different scopes.
+2. Attempt to complete the update set.
+3. Verify that the business rule prevents completion and displays the appropriate error message.
+
+
+## Screenshots
+![Output Result](error.png)

Server-Side Components/Business Rules/Update Set Scope Validation/ValidateScopesForUpdateSet.js

@@ -0,0 +1,25 @@
+(function executeRule(current, previous /*null when async*/) {
+
+	// Add your code here
+
+	var updateSetSysId = current.sys_id; // Get the sys_id of the current update set
+	var updateSetScope = current.application; // Get the scope of the current update set
+	var gr = new GlideRecord('sys_update_xml');
+	gr.addQuery('update_set', updateSetSysId); // Query for records in the current update set
+	gr.query();
+
+	var misMatchedUpdates = [];
+	while (gr.next()) {
+		if (gr.application != updateSetScope) { // Check if the scope matches the update set scope
+			misMatchedUpdates.push( gr.target_name.toString() + ' (' + gr.type.toString() + ')'); // Collect the file names with mismatched scope
+		}
+	}
+
+	if (misMatchedUpdates.length > 0) {
+		gs.addErrorMessage('The following files have a different scope than the update set scope: \n' + misMatchedUpdates.join(', '));
+		current.setAbortAction(true); // Prevent the update set from being completed
+	}
+
+	
+
+})(current, previous);

Server-Side Components/Business Rules/Update Set Scope Validation/error.png

@@ -0,0 +1,38 @@
+#  AuditFieldChangeNotifier
+### Description
+A ServiceNow Script Include that audits changes to specific fields and sends real-time notifications to Slack or Microsoft Teams using a webhook.  
+It helps teams monitor important updates like priority or assignment changes without needing to check the platform.
+---
+### 🔧 Features
+- Monitors field-level changes on any table
+- Sends rich notifications to Slack/Teams
+- Easy to configure via system properties
+- Can be reused across multiple tables via Business Rules
+---
+### 🧩 How to Use
+1. **Create a System Property**
+  - Name: `x_custom.audit_notifier.webhook_url`
+  - Value: Your Slack or Teams webhook URL
+2. **Create a Script Include**
+  - Name: `AuditFieldChangeNotifier`
+  - Paste the provided Script Include code
+3. **Create a Business Rule**
+  - Table: e.g. `incident`
+  - When: `after update`
+  - Add this script:
+    ```js
+    (function executeRule(current, previous) {
+        var notifier = new AuditFieldChangeNotifier();
+        notifier.notifyOnFieldChange(current, previous, ['priority', 'state', 'assigned_to']);
+    })(current, previous);
+    ```
+4. **Test It**
+  - Update one of the watched fields.
+  - A message should appear in your Slack/Teams channel like:
+    ```
+    🛠️ ServiceNow — Field Update Notification
+    Record: Incident INC0010001
+    Description: Unable to access VPN
+    • priority changed from 4 - Low → 2 - High
+    • assigned_to changed from John → Alex
+    ```

Server-Side Components/Script Includes/Sends Slack/Teams notifications when specific fields change on configured tables/README.md

@@ -0,0 +1,72 @@
+/**
+* Script Include: AuditFieldChangeNotifier
+* Description: Sends Slack/Teams notifications when specific fields change on configured tables.
+* Usable in: Business Rule (after update)
+*/
+var AuditFieldChangeNotifier = Class.create();
+AuditFieldChangeNotifier.prototype = {
+   initialize: function () {
+       // Slack or Teams webhook URL (store in sys_properties for security)
+       this.webhookUrl = gs.getProperty('x_custom.audit_notifier.webhook_url', '');
+       // Default app name
+       this.appName = gs.getProperty('x_custom.audit_notifier.app_name', 'ServiceNow');
+   },
+   /**
+    * Send notification if the specified fields have changed
+    * @param {GlideRecord} current - Current record
+    * @param {GlideRecord} previous - Previous record
+    * @param {Array} fieldsToWatch - Array of field names to monitor
+    */
+   notifyOnFieldChange: function (current, previous, fieldsToWatch) {
+       try {
+           if (!this.webhookUrl) {
+               gs.warn('[AuditFieldChangeNotifier] Webhook URL not configured.');
+               return;
+           }
+           var changes = [];
+           fieldsToWatch.forEach(function (field) {
+               if (current[field] + '' !== previous[field] + '') {
+                   changes.push({
+                       field: field,
+                       oldValue: previous[field] + '',
+                       newValue: current[field] + ''
+                   });
+               }
+           });
+           if (changes.length === 0)
+               return; // No relevant field changed
+           var payload = this._buildPayload(current, changes);
+           this._sendWebhook(payload);
+       } catch (e) {
+           gs.error('[AuditFieldChangeNotifier] Error: ' + e.message);
+       }
+   },
+   /**
+    * Build payload for Slack/Teams message
+    */
+   _buildPayload: function (current, changes) {
+       var shortDesc = current.short_description ? current.short_description + '' : '(No short description)';
+       var tableName = current.getTableName();
+       var recordUrl = gs.getProperty('glide.servlet.uri') + tableName + '.do?sys_id=' + current.sys_id;
+       var changeLines = changes.map(function (c) {
+           return `• *${c.field}* changed from _${c.oldValue}_ → *${c.newValue}*`;
+       }).join('\n');
+       return JSON.stringify({
+           text: `🛠️ *${this.appName}* — Field Update Notification\n\n*Record:* <${recordUrl}|${tableName}> \n*Description:* ${shortDesc}\n\n${changeLines}\n\n_Updated by ${gs.getUserDisplayName()}_`
+       });
+   },
+   /**
+    * Send payload to webhook
+    */
+   _sendWebhook: function (payload) {
+       var r = new sn_ws.RESTMessageV2();
+       r.setEndpoint(this.webhookUrl);
+       r.setHttpMethod('POST');
+       r.setRequestHeader('Content-Type', 'application/json');
+       r.setRequestBody(payload);
+       var response = r.execute();
+       if (response.getStatusCode() >= 400)
+           gs.error('[AuditFieldChangeNotifier] Webhook error: ' + response.getBody());
+   },
+   type: 'AuditFieldChangeNotifier'
+};