Merge branch 'ServiceNowDevProgram:main' into improve-ci-classes-readme

Author: ChaseMillers

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/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.

Client-Side Components/Client Scripts/Require comment onPriority change/script.js

@@ -0,0 +1,10 @@
+function onChange(control, oldValue, newValue, isLoading, isTemplate) {
+    if (isLoading || newValue === '') {
+        return;
+    }
+    if ((!g_form.isNewRecord()) && (newValue != oldValue)) {
+        g_form.setMandatory('comments', true);
+        g_form.addErrorMessage('Additional comment required when changing Priority.');
+    } else {
+        g_form.setMandatory('comments', false);
+    }

Client-Side Components/UI Scripts/PersistentAnnouncementBanner/README.md

@@ -0,0 +1,7 @@
+This UI Script is used to inject a custom, highly visible, and persistent notification banner across the top of the entire ServiceNow platform interface. 
+
+It is ideal for communicating critical, non-transactional system messages such as scheduled maintenance, major outages, or company-wide policy announcements.
+
+The key feature of this banner is that it is dismissible, and it uses a User Preference to ensure that once a user closes a specific version of the announcement
+
+The Reason to use this is , Announcements Banner Module Sometimes Loads Slower or Doesnt trigger the notification banner , instead this scripts all the time,if user is logged in 

Client-Side Components/UI Scripts/PersistentAnnouncementBanner/annoucement_banner.js

@@ -0,0 +1,51 @@
+(function() {
+    var BANNER_TEXT = ' **SYSTEM ALERT:** Scheduled maintenance for all services will occur this Saturday from 1 AM to 4 AM UTC. Expect minor downtime. 🚨';
+    var BANNER_BG_COLOR = '#ffcc00'; // Warning yellow
+    var BANNER_TEXT_COLOR = '#333333';
+
+    // Check if the user has already dismissed this version of the banner
+    var isDismissed = (g_preference.get(PREF_KEY) === 'true');
+
+    if (isDismissed) {
+        return;
+    }
+    var banner = document.createElement('div');
+    banner.setAttribute('id', 'global_announcement_banner');
+    banner.innerHTML = BANNER_TEXT;
+    banner.style.cssText = [
+        'position: fixed;',
+        'top: 0;',
+        'left: 0;',
+        'width: 100%;',
+        'padding: 10px 40px 10px 15px;', // Added padding on the right for the close button
+        'background-color: ' + BANNER_BG_COLOR + ';',
+        'color: ' + BANNER_TEXT_COLOR + ';',
+        'z-index: 10000;', // High z-index to ensure it sits on top of everything
+        'text-align: center;',
+        'font-weight: bold;',
+        'box-shadow: 0 2px 5px rgba(0,0,0,0.2);'
+    ].join('');
+    var closeButton = document.createElement('span');
+    closeButton.innerHTML = '×'; // Times symbol
+    closeButton.style.cssText = [
+        'position: absolute;',
+        'top: 50%;',
+        'right: 15px;',
+        'transform: translateY(-50%);',
+        'font-size: 20px;',
+        'cursor: pointer;',
+        'font-weight: normal;',
+        'line-height: 1;'
+    ].join('');
+
+    closeButton.onclick = function() {
+        // Remove the banner from the DOM
+        banner.remove(); 
+        
+        // Set the User Preference so the banner stays dismissed across sessions
+        g_preference.set(PREF_KEY, 'true');
+    };
+    banner.appendChild(closeButton);
+    document.body.appendChild(banner);
+
+})();

Server-Side Components/Script Includes/Populate MRVS from Excel/ParsingScript.js

@@ -0,0 +1,20 @@
+parseExcel: function() {
+    var attachSysId = this.getParameter('sysparm_id');
+    var attachment = new GlideSysAttachment();
+    var parser = new sn_impex.GlideExcelParser();
+    var mrvsArray = [];
+    // get content of the attachment
+    var content = attachment.getContentStream(attachSysId);
+    parser.parse(content);
+    // Iterate through each row after header. Return false if row doesn't exist
+    while (parser.next()) {
+        // get content of the row
+        var row = parser.getRow();
+        //push the object with key same as variable name in the MRVS.
+        var obj = {};
+        obj.employee_id = row['Id'];
+        obj.employee_name = row['Name'];
+        mrvsArray.push(obj);
+    }
+    return JSON.stringify(mrvsArray);
+},

Server-Side Components/Script Includes/Populate MRVS from Excel/README.md

@@ -0,0 +1,16 @@
+This script allows to parse the excel file attached to the attachment variable and populate the MRVS present in the
+catalog item / record producer.
+Use this script in a client-callable script include along with an onChange client script on the attachment variable.
+
+When a file is uploaded as an attachment, it's metdata is stored in the sys_attachment table and sys_attachment_doc contains
+the actual binary content.
+
+**getContentStream()** converts the binary content in a way so that it can be parsed by GlideExcelParser API.
+
+**Example used-**
+
+The excel has two columns "Id" and "Name" to store employee details. MRVS also has the variable name as "employee_id" and "employee_name".
+
+
+
+