Merge branch 'ServiceNowDevProgram:main' into main

Author: raghavs046

Client-Side Components/Client Scripts/Conditional Auto-Routing and Dynamic Mandatory Fields/Conditional_AutoRouting_Dynamic_Mandatory_Fields.js

@@ -0,0 +1,16 @@
+function onChange(control, oldValue, newValue, isLoading) {
+    if (isLoading) return;
+
+    if (newValue === 'hardware') {
+        g_form.setMandatory('asset_tag', true);
+        g_form.setDisplay('asset_tag', true);
+        g_form.setValue('assignment_group', 'Hardware Support Group');
+    } else if (newValue === 'software') {
+        g_form.setMandatory('asset_tag', false);
+        g_form.setDisplay('asset_tag', false);
+        g_form.setValue('assignment_group', 'Software Support Group');
+    } else {
+        g_form.setMandatory('asset_tag', false);
+        g_form.setDisplay('asset_tag', true);
+    }
+}

Client-Side Components/Client Scripts/Conditional Auto-Routing and Dynamic Mandatory Fields/Readme.md

@@ -0,0 +1,2 @@
+If an Incident Category = Hardware, make Asset Tag mandatory and automatically assign to Hardware Support Group.
+If Software, assign to Software Support Group and hide Asset Tag.

Client-Side Components/UI Actions/Email Watermark Utility/GenericEmailUtility.js

@@ -0,0 +1,80 @@
+var GenericEmailUtility = Class.create();
+GenericEmailUtility.prototype = {
+    initialize: function() {},
+  
+     // Generate an Outlook (mailto) link with watermark tracking
+    get_Outlook_link: function() {
+        try {
+            const email_payload = JSON.stringify({
+                "REQUESTOR_ID": "",
+                "TITLE": "",
+                "BODY": "",
+                "REQUEST_ID": "",
+                "TABLE_ID": ""
+            });
+
+            var mailtoLink = false;
+            const raw_data = this.getParameter("sysparm_email_body") || email_payload;
+
+            if (global.JSUtil.notNil(raw_data)) {
+                var email_data = JSON.parse(raw_data);
+
+                const to = this.getEmail(email_data.REQUESTOR_ID);
+                const cc = gs.getProperty("instanceEmailAddress"); // instance default CC
+                const subject = email_data.TITLE || '';
+                const body = email_data.BODY || '';
+
+                const watermark = this.getWatermark(email_data.REQUEST_ID, email_data.TABLE_ID);
+
+                // Construct mailto link
+                mailtoLink = 'mailto:' + to + '?cc=' + cc;
+
+                if (subject)
+                    mailtoLink += '&subject=' + encodeURIComponent(subject);
+
+                if (body)
+                    mailtoLink += '&body=' + encodeURIComponent(body);
+
+                if (watermark)
+                    mailtoLink += encodeURIComponent("\n\nRef: " + watermark);
+            }
+
+            return mailtoLink;
+
+        } catch (ex) {
+            gs.error("Error in get_Outlook_link(): " + ex.message);
+            return false;
+        }
+    },
+
+     // Fetch watermark ID (creates one if missing)
+    getWatermark: function(record_id, table_name) {
+        var wm = new GlideRecord('sys_watermark');
+        wm.addQuery('source_id', record_id);
+        wm.orderByDesc('sys_created_on');
+        wm.query();
+
+        if (wm.next()) {
+            return wm.getValue('number');
+        }
+
+        wm.initialize();
+        wm.source_id = record_id;
+        wm.source_table = table_name;
+        wm.insert();
+
+        return wm.getValue('number');
+    },
+
+     // Retrieve user’s email address
+    getEmail: function(user_id) {
+        if (global.JSUtil.notNil(user_id)) {
+            var user = new GlideRecordSecure('sys_user');
+            if (user.get(user_id))
+                return user.email.toString();
+        }
+        return '';
+    },
+
+    type: 'GenericEmailUtility'
+};

Client-Side Components/UI Actions/Email Watermark Utility/README.md

@@ -0,0 +1,56 @@
+# Outlook Email Watermark Utility for ServiceNow
+
+# Overview
+This reusable utility allows users to send emails **outside ServiceNow** (e.g., using Outlook or any default mail client) while still  maintaining the conversation within ServiceNow.  
+By embedding a unique watermark reference, any replies to the email will automatically append to the original record's activity feed.
+
+This helps teams collaborate externally without losing internal record visibility — ideal for customers or vendors who communicate via Outlook.
+
+---
+
+# Objective
+- Enable ServiceNow users to send Outlook emails directly from a record.  
+- Maintain conversation history in ServiceNow using watermark tracking.  
+- Make the solution **generic**, reusable across tables (Incident, Change, Request, etc.).  
+- Prevent dependency on outbound mail scripts or custom integrations.  
+
+# Components
+
+## 1. Script Include: GenericEmailUtility
+Handles the logic for:
+- Constructing the mailto: link.  
+- Fetching recipient and instance email addresses.  
+- Generating or retrieving the watermark ID.  
+- Returning a formatted Outlook link to the client script.
+
+## Key Methods
+1. get_Outlook_link() - Builds the full Outlook mail link with subject, body, and watermark.
+2. getWatermark(record_id, table_name) - Ensures a watermark exists for the record.
+3. getEmail(user_id) - Fetches the email address for the target user.
+
+## 2. UI Action (Client Script)
+Executes on the record form when the button/link is clicked.  
+It gathers record data, constructs a payload, calls the Script Include using GlideAjax, and opens Outlook.
+
+## Key Steps
+1. Collect field data like requestor, short description, and description.  
+2. Pass record details to the Script Include (GenericEmailUtility).  
+3. Receive a ready-to-use Outlook link.  
+4. Open the mail client with prefilled details and watermark reference.  
+
+## How It Works
+1. User clicks "Send Outlook Email" UI Action on a record.
+2. Script gathers record data and passes it to GenericEmailUtility.
+3. The utility builds a 'mailto:' link including the watermark.
+4. Outlook (or default mail client) opens with pre-filled To, CC, Subject, and Body fields.
+5. When the recipient replies, ServiceNow uses the watermark to append comments to the correct record.
+
+## Example Usage
+**User clicks “Send Outlook Email”** on a Request record:  
+Outlook opens prefilled like this:
+
+<img width="288" height="65" alt="image" src="https://github.com/user-attachments/assets/b58c5e0a-d80a-40ca-9ab5-f188a1203169" />
+
+
+<img width="710" height="496" alt="image" src="https://github.com/user-attachments/assets/5cbc7645-4233-4826-99f7-e2948bb5ab78" />
+

Client-Side Components/UI Actions/Email Watermark Utility/Send Email UI Action.js

@@ -0,0 +1,25 @@
+function onClick(g_form) {
+    var separator = "\n--------------------------------\n";
+    var email_body = "Record URL:\n" + g_form.getDisplayValue('number') + separator;
+    email_body += "Short Description:\n" + g_form.getValue('short_description') + separator;
+    email_body += "Description:\n" + g_form.getValue('description') + separator;
+
+    var email_data = {};
+    email_data.REQUESTOR_ID = g_form.getValue('caller_id') || g_form.getValue('opened_by') || g_form.getValue('requested_for');
+    email_data.TITLE = g_form.getValue('short_description') || 'ServiceNow Communication';
+    email_data.BODY = email_body;
+    email_data.REQUEST_ID = g_form.getUniqueValue();
+    email_data.TABLE_ID = g_form.getTableName();
+
+    var ga = new GlideAjax('GenericEmailUtility');
+    ga.addParam('sysparm_name', 'get_Outlook_link');
+    ga.addParam('sysparm_email_body', JSON.stringify(email_data));
+    ga.getXMLAnswer(function(response) {
+        var mailto_link = response;
+        if (mailto_link && mailto_link != 'false') {
+            window.open(mailto_link);
+        } else {
+            g_form.addErrorMessage('Unable to generate Outlook link.');
+        }
+    });
+}

Client-Side Components/UI Actions/Field Review of User Record when on form using action button/Field_Review_userTable_1.png

@@ -0,0 +1,34 @@
+## Field Review of User Record when on form using action button
+
+Displays informational messages suggesting improvements to field formatting on the User Table (**sys_user**) form when the **Fields Check** button is clicked.
+
+- Helps maintain consistency in user data by checking capitalization of names and titles, validating email format, ensuring phone numbers contain only digits, and preventing duplicate phone entries. 
+- Also suggests users not to leave the **user_name** field empty.
+- Shows Info messages below each field highlighting fields that may need attention.
+- Simple Prerequisite is that: when form loads give Info message to check **Field Check** button to bring user's attention
+- Uses a Client-side UI Action (**Fields Check**) that to review entered data and display friendly suggestions
+  - Name: Fields Check
+  - Table: User (sys_user)
+  - Client: true
+  - Form button: true
+  - Onclick: onClickCheckDetails()
+
+---
+
+### Grab user's attention on Field Check Button using Info message at top
+
+![Field Review on User Table_1](Field_Review_userTable_1.png)
+
+---
+
+### After clicking Field Check Button where suggestions are displayed below fields
+
+![Field Review on User Table_2](Field_Review_userTable_2.png)
+
+---
+
+### When user fixes the suggested issues and click the **Fields Check** button again, a message confirms that all fields are correctly formatted
+
+![Field Review on User Table_3](Field_Review_userTable_3.png)
+
+---

Client-Side Components/UI Actions/Field Review of User Record when on form using action button/Field_Review_userTable_2.png

@@ -0,0 +1,68 @@
+function onClickCheckDetails() {
+    // Friendly helper for field normalization guidance
+    g_form.hideAllFieldMsgs();
+    g_form.clearMessages();
+
+    // --- Get Field values ---
+    var firstName = g_form.getValue('first_name');
+    var lastName = g_form.getValue('last_name');
+    var title = g_form.getValue('title');
+    var userId = g_form.getValue('user_name');
+    var email = g_form.getValue('email');
+    var businessPhone = g_form.getValue('phone');
+    var mobilePhone = g_form.getValue('mobile_phone');
+
+    // --- Regex patterns ---
+    var capitalRegex = /^[A-Z][a-zA-Z\s]*$/;           // Names & titles start with a capital
+    var emailRegex = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/; 
+    var phoneRegex = /^\d+$/;                          
+
+    var suggestions = [];
+
+    if (firstName && !capitalRegex.test(firstName)) {
+        g_form.showFieldMsg('first_name', 'Suggestion: Start the name with a capital letter.', 'info');
+        suggestions.push('First Name');
+    }
+
+    if (lastName && !capitalRegex.test(lastName)) {
+        g_form.showFieldMsg('last_name', 'Suggestion: Start the name with a capital letter.', 'info');
+        suggestions.push('Last Name');
+    }
+
+    if (title && !capitalRegex.test(title)) {
+        g_form.showFieldMsg('title', 'Suggestion: Titles usually start with a capital letter.', 'info');
+        suggestions.push('Title');
+    }
+
+    if (!userId) {
+        g_form.showFieldMsg('user_name', 'Suggestion: Do not keep the User ID empty.', 'info');
+        suggestions.push('User ID');
+    }
+
+    if (email && !emailRegex.test(email)) {
+        g_form.showFieldMsg('email', 'Suggestion: Please use a valid email format like name@example.com.', 'info');
+        suggestions.push('Email');
+    }
+
+    if (businessPhone && !phoneRegex.test(businessPhone)) {
+        g_form.showFieldMsg('phone', 'Suggestion: Use digits only avoid letters.', 'info');
+        suggestions.push('Business Phone');
+    }
+
+    if (mobilePhone && !phoneRegex.test(mobilePhone)) {
+        g_form.showFieldMsg('mobile_phone', 'Suggestion: Use digits only avoid letters.', 'info');
+        suggestions.push('Mobile Phone');
+    }
+
+    /
+    if (businessPhone && mobilePhone && businessPhone === mobilePhone) {
+        g_form.showFieldMsg('phone', 'Work and mobile numbers appear identical, use different Numbers!', 'info');
+        suggestions.push('Phone Numbers');
+    }
+
+    if (suggestions.length > 0) {
+        g_form.addInfoMessage('Quick review complete! Please check: ' + suggestions.join(', ') + '.');
+    } else {
+        g_form.addInfoMessage('looks good! Nicely formatted data.');
+    }
+}