Merge branch 'ServiceNowDevProgram:main' into main

Author: dvn-lazywinner

Background Scripts/Encrypt & decrypt payload via base64/code.js

@@ -0,0 +1,12 @@
+var obj ={};
+obj.name = 'Mohit Kaushik';
+obj.email ='Mohit.1@abc.com';
+obj.contact = '1234567890';
+
+var str = JSON.stringify(obj,null,4);
+
+var encryption = GlideStringUtil.base64Encode(str);
+gs.info(encryption);
+
+var decrypt = GlideStringUtil.base64Decode(encryption);
+gs.info(JSON.stringify(decrypt,null,2));

Background Scripts/Encrypt & decrypt payload via base64/readme.md

@@ -0,0 +1 @@
+This code is an example to encrypt or decrypt the payload using base64Encode and decode methods of GlideStringUtil API.

Background Scripts/Find Groups Without Members/Get Groups with no Members.js

@@ -0,0 +1,17 @@
+var myGroups = [];
+var grGroup = new GlideRecord("sys_user_group");
+grGroup.addActiveQuery();
+grGroup.query();
+while (grGroup.next()) {
+var gaGroupMember = new GlideAggregate("sys_user_grmember");
+gaGroupMember.addQuery("group",grGroup.sys_id.toString());
+gaGroupMember.addAggregate('COUNT');
+gaGroupMember.query();
+var gm = 0;
+if (gaGroupMember.next()) {
+gm = gaGroupMember.getAggregate('COUNT');
+if (gm == 0) 
+      myGroups.push(grGroup.name.toString());
+}
+}
+gs.print(myGroups);

Background Scripts/Find Groups Without Members/readme.md

@@ -0,0 +1,31 @@
+**Initialize an Array:**
+var myGroups = [];
+
+**Create a GlideRecord Object for User Groups:**
+var grGroup = new GlideRecord("sys_user_group");
+
+**Add a Query for Active Groups:**
+grGroup.addActiveQuery();
+
+**Execute the Query:**
+grGroup.query();
+
+**Iterate Through Active Groups:**
+while (grGroup.next()) {
+
+**Count Group Members:**
+var gaGroupMember = new GlideAggregate("sys_user_grmember");
+gaGroupMember.addQuery("group", grGroup.sys_id.toString());
+gaGroupMember.addAggregate('COUNT');
+gaGroupMember.query();
+
+**Check Member Count:**
+var gm = 0;
+if (gaGroupMember.next()) {
+    gm = gaGroupMember.getAggregate('COUNT');
+    if (gm == 0) 
+        myGroups.push(grGroup.name.toString());
+}
+
+**Print the Results:**
+gs.print(myGroups);

Business Rules/Fetching reference field value from higher-level parents/Fetching reference field value from higher-level parents.js

@@ -0,0 +1,12 @@
+// In this before insert or update Business Rule, we are fetching a reference field value from higher-level parents in hierarchy when there is a field containing the parent record in the children and our use-case reference field is present in all the tables in hierarchy
+// I would be referring to "reference field name we want to populate" as "r1"
+// I would be referring to "reference field containing parent record" as "parent"
+
+
+(function executeRule(current, previous /*null when async*/ ) {
+    if (current.r1 == "" && !JSUtil.nil(current.parent.r1)) // Populate 'use-case reference field' from parent's value for the reference field'
+        current.r1 = current.parent.r1;
+    else if (current.< reference field name we want to populate > == "" && !JSUtil.nil(current.parent.parent.r1)) // Populate 'use-case reference field' from 'parent of parent' 
+        current.r1 = current.parent.parent.r1;
+
+})(current, previous);

Business Rules/Fetching reference field value from higher-level parents/readme.md

@@ -0,0 +1,12 @@
+This is a "**before insert/update**" Business Rule
+We are fetching a reference field value from higher-level parents in hierarchy 
+when there is a field containing the parent record in the children and 
+our use-case reference field is present in all the tables in hierarchy
+
+In the code, we are referring to "reference field name we want to populate" as "_r1_"
+In the code, we are referring to "reference field containing parent record" as "_parent_"
+
+The "**JSUtil.nil**" is being used to check for empty/null value for the field.
+
+
+Through the code we are checking the empty value of the use-case reference field and dot walking to parents and fetching the value from them if it exists

Business Rules/Trigger Event when a member is added to a list/Readme.md

@@ -0,0 +1,8 @@
+Scenario: You are wanting to send a notification to someone whenever they are added to a list of people. 
+
+Application: Create an event in the event registry. Then, create a business rule. Set the name and table, advanced = true. 
+
+When to run: 
+When = after, update = true, conditions = watch list (replace with applicable field name) | changes
+
+Advanced tab: insert the snippet

Business Rules/Trigger Event when a member is added to a list/Trigger an event when user is added to field.js

@@ -0,0 +1,36 @@
+(function executeRule(current, previous /*null when async*/) {
+   
+    // Ensure the 'watch_list' (replace with applicable field name) field has been modified
+    if (current.watch_list != previous.watch_list) {
+        
+        // Split the current and previous watch lists into arrays
+        var newWatchers = current.watch_list.split(',');
+        var oldWatchers = previous.watch_list ? previous.watch_list.split(',') : [];
+
+        // Identify the newly added users to the watch list
+        var addedUsers = newWatchers.filter(function (user) {
+            return oldWatchers.indexOf(user) === -1;
+        });
+
+        // Loop through the added users to trigger the event for each
+        addedUsers.forEach(function(userID) {
+            var email;
+            var firstName;
+
+            // Try to get the user record by user ID (sys_id)
+            var userGr = new GlideRecord('sys_user');
+            if (userGr.get(userID)) {
+                firstName = userGr.first_name;
+                email = userGr.email;
+            } else {
+                
+                // If no user record is found, assume the userID is an email address
+                email = userID;
+                firstName = "Team";
+            }
+
+            // Trigger the event (replace "new_member") with the current case and user information
+            gs.eventQueue('new_member', current, email, firstName);
+        });
+    }
+})(current, previous);

Business Rules/User Activity Log Tracking/README

@@ -0,0 +1,16 @@
+# Overview
+This script logs specific user actions (e.g: record updates and approvals) in ServiceNow into a custom table `u_user_activity_log`. 
+
+This provides audit capabilities and allowing developers to track user actions for compliance or analytics.
+
+# How It Works
+The script is triggered by a Business Rule on record updates and checks for changes in specified critical fields (e.g., `state`, `approval`). When a change occurs, it logs relevant details in the `u_user_activity_log` table, including:
+- `u_user`: User ID
+- `u_action`: Type of action performed
+- `u_record_id`: ID of the updated record
+- `u_record_table`: Name of the table where the change occurred
+- `u_description`: Brief description of the action
+
+# Implementation
+- Create Custom Table: Ensure `u_user_activity_log` table exists with fields like `u_user`, `u_action`, `u_record_id`, `u_record_table`, `u_description`, etc.
+- Configure Business Rule: Set the Business Rule to run on update and add conditions for monitoring fields (`state`, `approval`).

Business Rules/User Activity Log Tracking/userActivityLog.js

@@ -0,0 +1,17 @@
+// Script to log user actions (updates, approvals) into a custom table
+(function executeRule(current, previous /*null when async*/) {
+    // Check if key fields are modified (customize as needed)
+    if (current.state.changes() || current.approval.changes()) {
+        var logEntry = new GlideRecord('u_user_activity_log');
+        logEntry.initialize();
+
+        // Populate log details
+        logEntry.u_user = gs.getUserID();
+        logEntry.u_action = current.state.changes() ? "State Change" : "Approval Change";
+        logEntry.u_record_id = current.sys_id;
+        logEntry.u_record_table = current.getTableName();
+        logEntry.u_description = "User " + gs.getUserDisplayName() + " updated " + logEntry.u_action;
+
+        logEntry.insert();
+    }
+})(current, previous);