Merge branch 'ServiceNowDevProgram:main' into SNTips

Author: dvn-lazywinner

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

@@ -0,0 +1,12 @@
+var obj ={};
+obj.name = 'Mohit Kaushik';
+obj.email ='[email protected]';
+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);

Client Scripts/Remove Option from Choice List/Remove Options from Choice List.js

@@ -0,0 +1,9 @@
+function onChange(control, oldValue, newValue, isLoading, isTemplate) {
+if (isLoading || newValue == '') {
+return;
+}
+if (newValue == 'inquiry') { //Onchange of Category
+g_form.removeOption('impact', '1');
+g_form.removeOption('urgency', '1');
+}
+}

Client Scripts/Remove Option from Choice List/readme.md

@@ -0,0 +1,6 @@
+**Purpose:**
+This onChange function automatically reacts when the "Category" field is changed. If the new category selected is "inquiry," the function removes the options for "Impact" and "Urgency" that have a value of 1.
+Whenever a user selects a new category, the script checks if it’s set to "inquiry." If so, it removes the specified options for "Impact" and "Urgency".
+**How to Use This Function**
+You can use this Onchange client script on any form and maanage your field choice options.
+

GlideAggregate/List the incident priority count under each category/code.js

@@ -0,0 +1,20 @@
+// Get the count of Incidents by Category and then by Priority.
+
+var incCATGR = new GlideAggregate('incident');
+incCATGR.addAggregate('COUNT', 'category');
+incCATGR.orderBy('category');
+incCATGR.query();
+
+while (incCATGR.next()) {
+	var cat = incCATGR.category;
+	gs.print("Category Name: " +incCATGR.category.getDisplayValue() + ' --> ' + incCATGR.getAggregate('COUNT', 'category'));
+  var incPriorityGR = new GlideAggregate('incident');
+	incPriorityGR.addQuery('category', incCATGR.category);
+  incPriorityGR.addAggregate('COUNT', 'priority');
+	incPriorityGR.orderBy('priority');
+  incPriorityGR.query();
+
+	while(incPriorityGR.next()){
+    gs.print("Priority-" +incPriorityGR.priority + " = " +incPriorityGR.getAggregate('COUNT', 'priority'));
+	}
+}

GlideAggregate/List the incident priority count under each category/readme.MD

@@ -0,0 +1,37 @@
+Purpose: This piece of code will be helpful to get the count of incidents by Priority under each Category.
+
+Sample Output:
+==============
+*** Script: Category Name:  --> 4
+*** Script: Priority-1 = 2
+*** Script: Priority-2 = 1
+*** Script: Priority-4 = 1
+*** Script: Category Name: Database --> 3
+*** Script: Priority-1 = 1
+*** Script: Priority-4 = 1
+*** Script: Priority-5 = 1
+*** Script: Category Name: Hardware --> 10
+*** Script: Priority-1 = 5
+*** Script: Priority-3 = 2
+*** Script: Priority-5 = 3
+*** Script: Category Name: Inquiry / Help --> 84
+*** Script: Priority-1 = 10
+*** Script: Priority-2 = 2
+*** Script: Priority-3 = 13
+*** Script: Priority-4 = 17
+*** Script: Priority-5 = 42
+*** Script: Category Name: Network --> 12
+*** Script: Priority-1 = 2
+*** Script: Priority-2 = 2
+*** Script: Priority-3 = 1
+*** Script: Priority-4 = 2
+*** Script: Priority-5 = 5
+*** Script: Category Name: Software --> 131
+*** Script: Priority-1 = 15
+*** Script: Priority-2 = 15
+*** Script: Priority-3 = 23
+*** Script: Priority-4 = 28
+*** Script: Priority-5 = 50
+
+
+

Scheduled Jobs/Reject approvals created before an year/Reject Approvals Created Before an Year.js

@@ -0,0 +1,7 @@
+var grAppr = new GlideRecord("sysapproval_approver");
+grAppr.addEncodedQuery("sys_created_on<javascript:gs.beginningOfLast12Months()^state=requested");
+grAppr.query();
+while(grAppr.next()){
+	grAppr.setValue('state', 'rejected');
+	grAppr.update();
+}

Scheduled Jobs/Reject approvals created before an year/readme.md

@@ -0,0 +1,7 @@
+**Script Purpose:**
+This script helps you manage approval records in ServiceNow. It searches for approval requests in the sysapproval_approver table that were created more than 12 months ago and are currently marked as "requested." The script then updates these records to change their status to "rejected."
+
+**How to Use This Script**
+Where to Run It: You can execute this script in a server-side context, such as a Scheduled Jobs, Script Include, or Background Script. Make sure you have the necessary permissions to access and update records in the sysapproval_approver table.
+
+**Be Cautious:** The script will automatically find the relevant approval records and update all matching records, so double-check the criteria before executing it.

Scheduled Jobs/Update Inactive Application Owner/Update Inactive Application Owner.js

@@ -0,0 +1,10 @@
+var grApp = new GlideRecord("cmdb_ci_appl");
+grApp.addEncodedQuery("owned_by.active=false");
+grApp.query();
+while(grApp.next()){
+var managerSysId = grApp.owned_by.manager.toString(); // Get Manager SysId     
+if (managerSysId) {
+grApp.owned_by = managerSysId;
+grApp.update();
+}
+}

Scheduled Jobs/Update Inactive Application Owner/readme.md

@@ -0,0 +1,22 @@
+This code snippet will update the owner of application records in the cmdb_ci_appl table where the current owner is inactive. It specifically sets the owner to the manager of that inactive owner, ensuring that each application has an active owner assigned.
+
+**GlideRecord Initialization:**
+var grApp = new GlideRecord("cmdb_ci_appl");
+
+**Query for Inactive Owners:**
+grApp.addEncodedQuery("owned_by.active=false");
+
+**Executing the Query:**
+grApp.query();
+
+**Iterating Through Records:**
+while(grApp.next()){
+
+**Getting the Manager’s Sys ID:**
+var managerSysId = grApp.owned_by.manager.toString();
+
+**Updating the Owner:**
+if (managerSysId) {
+    grApp.owned_by = managerSysId;
+    grApp.update();
+}

Service Portal Widgets/Calendar widget/README.md

@@ -0,0 +1,41 @@
+# Calendar Widget for ServiceNow Portal
+This widget creates a simple, interactive calendar for the ServiceNow portal, allowing users to navigate through months and view the current day highlighted. It displays the days of the month in a grid layout.
+
+## Features
+Monthly Navigation: Buttons for navigating between months.
+Current Day Highlighting: The current date is highlighted in light blue.
+Responsive Layout: The calendar adjusts to fit within the widget container.
+
+## Usage
+
+HTML Structure: The main HTML structure displays month navigation buttons and the days in a grid layout.
+
+CSS Styling: CSS styles define the appearance of the calendar, including a shadowed border, day alignment.
+
+JavaScript Controller:
+
+Defines the calendar's navigation functionality.
+Calculates and displays the days of the selected month.
+Highlights today’s date if it is within the selected month.
+
+## Code Structure
+### Controller (api.controller):
+Initializes the month and year to display the current month.
+Provides functions to navigate to the previous and next month.
+Calculates the days of the selected month and highlights the current date.
+### CSS:
+.calendar-widget: The main container for the calendar.
+.calendar-header: Contains the month name and navigation buttons.
+
+## Customization
+### Highlight Colors:
+Modify .current-day in the CSS to change the color for today’s date.
+Month Names and Day Names:
+Update the $scope.monthNames and $scope.dayNames arrays to localize or customize the labels.
+
+### Example Usage
+In the ServiceNow portal, add this widget to display an interactive calendar. This can be embedded in any dashboard or custom page where date visualization is needed.
+
+## Known Issues
+Initial Load: If dates do not display immediately, ensure the ng-init="loadCalendar()" directive is included in the main container.
+Date Accuracy: The calendar currently starts with today's date. If dates appear incorrect, check the $scope.loadCalendar() function for accurate month and day calculations.

Service Portal Widgets/Calendar widget/index.html

@@ -0,0 +1,17 @@
+<div class="calendar-widget" ng-init="loadCalendar()">
+    <div class="calendar-header">
+        <button ng-click="prevMonth()">&#9664;</button>
+        <span>{{ monthNames[currentMonth] }} {{ currentYear }}</span>
+        <button ng-click="nextMonth()">&#9654;</button>
+    </div>
+
+    <div class="calendar-days">
+        <div class="day-name" ng-repeat="day in dayNames">{{ day }}</div>
+        <div 
+            class="day" 
+            ng-repeat="day in days track by $index" 
+            ng-class="{'current-day': isCurrentDay(day), 'weekend': isWeekend($index), 'regular-day': day}">
+            {{ day }}
+        </div>
+    </div>
+</div>