Merge branch 'main' into hacktoberfest2025-contribution

Author: NayeemKaka

Client-Side Components/Catalog Client Script/Real time count of letters/Count letters.js

@@ -0,0 +1,26 @@
+function onChange(control, oldValue, newValue, isLoading) {
+    if (isLoading) {
+        return;
+    }
+
+    var maxChars = 100;//count of charaters 
+    var currentLength = newValue.length;
+
+    // Clear previous messages
+    g_form.clearMessages();
+
+    // Show info message
+    g_form.addInfoMessage('Character count: ' + currentLength + ' / ' + maxChars);
+
+    if (currentLength > maxChars) {
+        // Show error message
+        g_form.addErrorMessage('Character limit exceeded! Please shorten your text.');
+        g_form.showFieldMsg('short_description', 'Too many characters!', 'error');
+
+        // Make field mandatory to block submission
+        g_form.setMandatory('short_description', true);
+    } else {
+        // Remove mandatory if valid
+        g_form.setMandatory('short_description', false);
+    }
+}

Client-Side Components/Catalog Client Script/Real time count of letters/readme.md

@@ -0,0 +1 @@
+This onChange Catalog Client Script displays the current character count for a text field and enforces a maximum limit by showing error messages and making the field mandatory to prevent form submission when exceeded.

Client-Side Components/Client Scripts/Dynamic Location Validation Approach/Readme.md

@@ -0,0 +1,19 @@
+**User Location Validator**
+This script restricts form submissions based on the physical location of the user. The current location is obtained using the browser’s geolocation API (latitude and longitude), and is then compared against the user's assigned business location stored in ServiceNow.
+
+**How It Works**
+- The **server-side Script Include**(UserLocationUtils.js) fetches the assigned business location’s latitude, longitude, and name for the logged-in user.
+- The **client-side script**(User Location Validator.js) uses the browser API to obtain the current latitude and longitude of the user at form submission.
+- It calculates the distance between these two points using the **Haversine formula**, which accounts for the spherical shape of the Earth.
+- The key constant `earthRadiusKm = 6371` defines the Earth's radius in kilometers and is essential for accurate distance calculation.
+- If the user’s current location is outside the predefined radius (default 10 km), the form submission is blocked with an error message showing the distance and allowed location.
+- If the user is within range, a confirmation info message is displayed and the submission proceeds.
+
+**Sample Output**
+- **Success:** "Location validated successfully within range of Headquarters."
+- **Failure:** "You are 15.23 km away from your registered location: Headquarters."
+
+**Usage Notes**
+- Requires user consent for geolocation access in the browser.
+- The script uses descriptive variable names for clarity and maintainability.
+- Suitable for scenarios requiring geo-fencing compliance or location-based workflow restrictions.

Client-Side Components/Client Scripts/Dynamic Location Validation Approach/User Location Validator.js

@@ -0,0 +1,52 @@
+function onSubmit() {
+  // Check if the browser supports geolocation
+  if ("geolocation" in navigator) {
+    // Request current user position
+    navigator.geolocation.getCurrentPosition(function(position) {
+      var currentLatitude = position.coords.latitude;   // Current user latitude
+      var currentLongitude = position.coords.longitude; // Current user longitude
+
+      // Allowed business location coordinates fetched from server
+      var allowedLatitude = locData.latitude;
+      var allowedLongitude = locData.longitude;
+      var locationName = locData.name;
+
+      // Earth's radius in kilometers - constant used in distance calculation formula
+      var earthRadiusKm = 6371;
+
+      // Convert degree differences to radians
+      var deltaLatitude = (currentLatitude - allowedLatitude) * Math.PI / 180;
+      var deltaLongitude = (currentLongitude - allowedLongitude) * Math.PI / 180;
+
+      // Haversine formula components
+      var a = Math.sin(deltaLatitude / 2) * Math.sin(deltaLatitude / 2) +
+              Math.cos(allowedLatitude * Math.PI / 180) *
+              Math.cos(currentLatitude * Math.PI / 180) *
+              Math.sin(deltaLongitude / 2) * Math.sin(deltaLongitude / 2);
+
+      var c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+
+      // Calculate distance in kilometers between current and allowed locations
+      var distanceKm = earthRadiusKm * c;
+
+      // Check if user's current distance exceeds tolerance (e.g., 10 km)
+      if (distanceKm > 10) {
+        alert("You are " + distanceKm.toFixed(2) + " km away from your registered location: " + locationName);
+        g_form.addErrorMessage("Location validation failed: Submission outside the allowed radius.");
+        return false; // Cancel form submission
+      } else {
+        g_form.addInfoMessage("Location validated successfully within range of " + locationName);
+        return true; // Allow form submission
+      }
+    }, function(error) {
+      alert("Geolocation error: " + error.message);
+      return false; // Stop submission if geolocation fails
+    });
+
+    // Prevent form submission while waiting for async geolocation result
+    return false;
+  } else {
+    g_form.addErrorMessage("Geolocation is not supported by your browser.");
+    return false; // Block if geolocation API unsupported
+  }
+}

Client-Side Components/Client Scripts/Dynamic Location Validation Approach/UserLocationUtils.js

@@ -0,0 +1,22 @@
+var UserLocationUtils = Class.create();
+UserLocationUtils.prototype = {
+    initialize: function() {
+
+    },
+    getUserLocationCoords: function() {
+        var user = gs.getUser();
+        var loc = user.getRecord().location;
+        if (loc) {
+            var locGR = new GlideRecord('cmn_location');
+            if (locGR.get(loc))
+                return {
+                    latitude: parseFloat(locGR.latitude),
+                    longitude: parseFloat(locGR.longitude),
+                    name: locGR.name.toString()
+                };
+        }
+        return null;
+    },
+
+    type: 'UserLocationUtils'
+};

Client-Side Components/Client Scripts/Live Character Counter and Validator/README.md

@@ -0,0 +1,11 @@
+This solution dynamically provides users with real-time feedback on the length of a text input field (like short_description or a single-line text variable).
+It immediately displays a character count beneath the field and uses visual cues to indicate when a pre-defined character limit has been reached or exceeded.
+
+This is a vital User Experience (UX) enhancement that helps agents and users write concise, actionable information, leading to improved data quality and better integration reliability.
+
+Name	Live_Character_Counter_ShortDesc_OnLoad	
+Table	: Custom Table or Incident
+Type	onChange 
+Field : Description 
+UI Type	All	
+Isolate Script	false

Client-Side Components/Client Scripts/Live Character Counter and Validator/character_counter.js

@@ -0,0 +1,31 @@
+function onChange(control, oldValue, newValue, isLoading, isTemplate) {
+    
+    var FIELD_NAME = 'short_description';
+    var MAX_CHARS = 100;
+    var currentLength = newValue.length;
+    var counterId = FIELD_NAME + '_counter_label';
+    if (typeof g_form.getControl(FIELD_NAME) !== 'undefined' && !document.getElementById(counterId)) {
+        var controlElement = g_form.getControl(FIELD_NAME);
+        var counterLabel = document.createElement('div');
+        counterLabel.setAttribute('id', counterId);
+        counterLabel.style.fontSize = '85%';
+        counterLabel.style.marginTop = '2px';
+        controlElement.parentNode.insertBefore(counterLabel, controlElement.nextSibling);
+    }
+    var counterElement = document.getElementById(counterId);
+
+    if (counterElement) {
+        var remaining = MAX_CHARS - currentLength;
+        
+      
+        counterElement.innerHTML = 'Characters remaining: ' + remaining + ' (Max: ' + MAX_CHARS + ')';
+
+        // Apply red color if the limit is exceeded
+        if (remaining < 0) {
+            counterElement.style.color = 'red';
+        } else {
+            // Revert color if back within limits
+            counterElement.style.color = 'inherit';
+        }
+    }
+}

Client-Side Components/Client Scripts/Reinstate Error status/README.md

@@ -0,0 +1,14 @@
+Table: Time Worked [task_time_worked]
+Type: onsubmit
+
+#Objective :
+Ensure that time entries (represented by the work_date field) are not submitted after 8:00 PM CST on two key dates:
+The 16th of the month and The last day of the month
+If a user tries to submit time for a current or past date after the cut-off time, the submission is blocked and a clear error message is displayed.
+
+#Business Scenario
+Imagine a consulting firm where employees log billable hours against customer cases. There are internal controls in place that lock the timekeeping system after a certain cut-off time to ensure accurate payroll and billing.
+
+The finance department requires that:
+On the 16th and last day of each month, submissions must be in before 8:00 PM CST.
+If employees miss the deadline, they can only log time for future dates (not today or the past).

Client-Side Components/Client Scripts/Reinstate Error status/script.js

@@ -0,0 +1,39 @@
+function onSubmit() {
+    // Cutoff time for submission in CST.
+    var cutoffTime = "20:00:00";
+
+    // Get the current date and time in CST
+    var currentDate = new Date();
+    var currentCSTDate = new Date(
+        currentDate.toLocaleString("en-US", {
+            timeZone: "America/Chicago"
+        })
+    );
+
+    // Get time from current CST date
+    var currentCSTTime = currentCSTDate.toTimeString().substring(0, 8);
+
+    // Get last day of the month
+    var dayOfMonth = currentCSTDate.getDate();
+    var lastDayOfMonth = new Date(
+        currentCSTDate.getFullYear(),
+        currentCSTDate.getMonth() + 1,
+        0
+    ).getDate();
+
+    if ((dayOfMonth === 16 || dayOfMonth === lastDayOfMonth) && currentCSTTime > cutoffTime) {
+        var workDate = g_form.getValue("work_date");
+
+        if (workDate) {
+            var formattedWorkDate = new Date(workDate + "T00:00:00");
+            // If work_date is on or before current date, block submission
+            if (formattedWorkDate <= currentCSTDate) {
+                g_form.addErrorMessage(
+                    "The time period closed for time submission at 8:00 PM CST. Time must be billed in the next time period." + ": " + lastDayOfMonth
+                );
+                return false;
+            }
+        }
+    }
+    return true;
+}

Client-Side Components/Client Scripts/Require comment onPriority change/README.md

@@ -0,0 +1,6 @@
+Table: sn_customerservice_case
+Type: OnChange
+Field: Priority
+
+Use Case:
+Make additional comments mandatory on priority change for the case table.