Merge branch 'ServiceNowDevProgram:main' into feature/NewGSMessages

Author: HackoDev1530

Client-Side Components/UI Actions/CloseChildCases/CloseChildCases.js

@@ -0,0 +1,23 @@
+(function executeAction() {
+    var grCase = new GlideRecord('sn_customerservice_case');
+    grCase.addQuery('parent', current.sys_id);
+    grCase.query();
+    
+    var counter = 0;
+    while (grCase.next()) {
+        if (grCase.state != 3) { // 3 = Closed
+            grCase.resolution_code = '16';
+            grCase.close_notes = 'This case was auto closed from the parent case.';
+            grCase.state = 3;
+            grCase.update();
+            counter++;
+        }
+    }
+
+    //  Show info message only if any cases were closed
+    if (counter > 0) {
+        gs.addInfoMessage(counter + ' child case(s) have been closed.');
+    }
+
+    action.setRedirectURL(current);
+})();

Client-Side Components/UI Actions/CloseChildCases/README.md

@@ -0,0 +1,6 @@
+Name: Close all Child Case
+Table:sn_customerservice_case
+Condition: (gs.hasRole('sn_customerservice_agent') || gs.hasRole('admin') ) && (new GlideRecord('sn_customerservice_case').addQuery('parent', current.sys_id).query().hasNext())
+
+Use Case: 
+Provide UI action button to close all the associated child cases from the parent Case.

Client-Side Components/UI Macros/JSON Formatter and Viewer/README.md

@@ -0,0 +1,9 @@
+This solution provides a significant User Experience (UX) enhancement for fields that store complex data in JSON format (e.g., integration payloads, configuration properties, or setup data). 
+
+Instead of forcing users (developers, administrators) to read or edit raw, unformatted JSON in a plain text area, this macro adds a "JSON Viewer" button next to the field
+
+Name	json_formatter_macro	
+Active	true	
+Type	XML
+
+Navigate to **System UI > UI** Macros and create a new record named json_formatter_macro , Use XML Attached File as Script

Client-Side Components/UI Macros/JSON Formatter and Viewer/json_formatter.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="jelly:html" xmlns:g2="glide.ui">
+    
+    <g:evaluate var="jvar_field_name" expression="RP.getWindowProperties().get('fieldName')" />
+
+    <button type="button" 
+            onclick="openJsonViewer('${jvar_field_name}');" 
+            title="View and Format JSON" 
+            class="btn btn-default btn-sm">
+        <span class="icon-code"></span> JSON Viewer
+    </button>
+    
+    <script>
+        function openJsonViewer(fieldName) {
+            var jsonValue = g_form.getValue(fieldName);
+            var gm = new GlideModal('json_viewer_ui_page', false); // Replace 'json_viewer_ui_page' with your actual UI Page or Widget ID
+            gm.setTitle('JSON Data Viewer & Formatter for Field: ' + fieldName);
+            gm.setPreference('json_data', jsonValue);
+            gm.setSize(900);
+            gm.render();
+        }
+    </script>
+</j:jelly>

Core ServiceNow APIs/GlideElement/Display base table for each field/README.md

@@ -0,0 +1,32 @@
+# Display Base Table for Each Field
+
+This code snippet demonstrates how to identify the base table where each field originates from in ServiceNow's table inheritance hierarchy.
+
+## Functionality
+
+The script uses `GlideRecordUtil` to retrieve all parent tables for a given table, then iterates through each field in a record to display which base table the field was defined in using the `getBaseTableName()` method from the GlideElement API.
+
+## Use Case
+
+This is particularly useful when working with extended tables to understand:
+- Which fields are inherited from parent tables
+- Which fields are defined locally on the current table
+- The complete table inheritance structure
+
+## Example Output
+
+For a table like `db_image`, the output shows each field name alongside its originating table:
+```
+Fields          Base table
+sys_id          sys_metadata
+sys_created_on  sys_metadata
+image           db_image
+name            db_image
+...
+```
+
+## Related Methods
+
+- `getBaseTableName()` - Returns the name of the table where the field was originally defined
+- `GlideRecordUtil.getTables()` - Returns parent tables in the inheritance hierarchy
+- `GlideRecordUtil.getFields()` - Returns an array of all field names for a GlideRecord

Core ServiceNow APIs/GlideElement/Display base table for each field/displayBaseTablesForEachField.js

@@ -0,0 +1,19 @@
+var tableName = 'db_image';
+
+var gru = new GlideRecordUtil();
+
+var parentTables = gru.getTables(tableName);
+gs.print("Parent tables: " + parentTables);
+
+var gr = new GlideRecord(tableName);
+gr.setlimit(1);
+gr.query();
+
+if(gr.next()){ 
+	var fieldNames = gru.getFields(gr);
+	gs.print('Fields\t\tBase table');
+    for (var i = 0; i < fieldNames.length; i++) {
+		gs.print(fieldNames[i] + "\t\t" + gr[fieldNames[i]].getBaseTableName()); 
+    }
+}
+

Server-Side Components/Business Rules/Currency conversion to USD/currenct_Converstion_to_USD.js

@@ -0,0 +1,72 @@
+(function executeRule(current, previous /*null when async*/) {
+
+    // Extract the first 3 characters of the budget currency code (e.g., "INR", "EUR")
+    var currencyCode = current.budget_currency ? current.budget_currency.toString().substring(0, 3) : '';
+
+    // Convert the annual budget value to a float
+    var amount = parseFloat(current.annual_budget);
+
+    // Validate input: If currency code is missing or amount is not a valid number, clear the USD field and exit
+    if (!currencyCode || isNaN(amount)) {
+        current.u_annual_budget_usd = '';
+        return;
+    }
+
+    // If the currency is already USD, no conversion needed — store the original amount
+    if (currencyCode === 'USD') {
+        current.u_annual_budget_usd = amount;
+        return;
+    }
+
+    // Check if the currency exists in the fx_currency table
+    var currencyGR = new GlideRecord('fx_currency');
+    currencyGR.addQuery('code', currencyCode);
+    currencyGR.query();
+
+    // If currency is not found, clear the USD field and exit
+    if (!currencyGR.next()) {
+        current.u_annual_budget_usd = '';
+        return;
+    }
+
+    // Get the latest exchange rate for the selected currency from fx_rate table
+    var fxGR = new GlideRecord('fx_rate');
+    fxGR.addQuery('currency.code', currencyCode);
+    fxGR.orderByDesc('sys_updated_on'); // Sort by most recent update
+    fxGR.setLimit(1); // Limit to the latest record
+    fxGR.query();
+
+    // If no exchange rate found, clear the USD field and exit
+    if (!fxGR.next()) {
+        current.u_annual_budget_usd = '';
+        return;
+    }
+
+    var rate = parseFloat(fxGR.getValue('rate')); // Exchange rate for selected currency
+
+    // Get the latest exchange rate for USD from fx_rate table
+    var fxGR1 = new GlideRecord('fx_rate');
+    fxGR1.addQuery('currency.code', 'USD');
+    fxGR1.orderByDesc('sys_updated_on'); // Sort by most recent update
+    fxGR1.setLimit(1); // Limit to the latest record
+    fxGR1.query();
+
+    // If no USD exchange rate found, clear the USD field and exit
+    if (!fxGR1.next()) {
+        current.u_annual_budget_usd = '';
+        return;
+    }
+
+    var usdRate = parseFloat(fxGR1.getValue('rate')); // USD base rate
+
+    // Perform conversion only if both rates are valid and non-zero
+    if (!isNaN(rate) && !isNaN(usdRate) && rate !== 0) {
+        var convertedAmount = (amount / rate) * usdRate; // Convert to USD
+        current.u_annual_budget_usd = convertedAmount; // Store the converted value
+    } else {
+        gs.info("Invalid exchange rate values");
+        current.u_annual_budget_usd = '';
+    }
+
+})(current, previous);
+``

Server-Side Components/Business Rules/Currency conversion to USD/readme.md

@@ -0,0 +1,12 @@
+This script is designed to automatically convert the value of the Annual Budget field (annual_budget) from its original currency to USD. It uses the fx_currency and fx_rate tables to fetch the latest exchange rates and performs the conversion only when valid data is available.
+🔍 Key Features:
+
+Field Focus: Converts the annual_budget field based on the currency specified in budget_currency.
+Validation: Ensures both the currency code and amount are valid before proceeding.
+Currency Check: If the currency is already USD, it bypasses conversion.
+Exchange Rate Lookup: Retrieves the most recent exchange rates for both the source currency and USD.
+Conversion Logic: Applies the formula
+USD Amount=(Original AmountSource Rate)×USD Rate\text{USD Amount} = \left(\frac{\text{Original Amount}}{\text{Source Rate}}\right) \times \text{USD Rate}USD Amount=(Source RateOriginal Amount​)×USD Rate
+Error Handling: Clears the USD field if any required data is missing or invalid.
+
+This script ensures accurate and up-to-date currency conversion for budgeting purposes and is well-commented for maintainability and clarity.

Server-Side Components/Business Rules/Mask Sensitive Data in Description Field/maskData.js

@@ -0,0 +1,49 @@
+(function executeRule(current, previous /*null when async*/) {
+
+   
+
+    // Only run if description has a value
+    if (current.description) {
+        var desc = current.description.toString();
+      
+
+        // Regex patterns for sensitive data
+        var ccRegex = /\b\d{13,16}\b/g;                     // 13–16 continuous digits
+        var ccSpaced = /\b(\d{4}[- ]?){3}\d{4}\b/g;         // 4-4-4-4 with spaces/dashes
+        var ssnRegex = /\b\d{3}-\d{2}-\d{4}\b/g;            // US SSN
+        var phoneRegex = /(\+?\d{1,2}[- ]?)?\(?\d{3}\)?[- ]?\d{3}[- ]?\d{4}/g; // phone
+
+        var masked = desc;
+
+        // Apply masking with messages
+        if (ccRegex.test(desc)) {
+            gs.addInfoMessage("Credit card pattern found → masking");
+            masked = masked.replace(ccRegex, "****-****-****-****");
+        }
+
+        if (ccSpaced.test(desc)) {
+            gs.addInfoMessage("Spaced/dashed credit card pattern found → masking");
+            masked = masked.replace(ccSpaced, "****-****-****-****");
+        }
+
+        if (ssnRegex.test(desc)) {
+            gs.addInfoMessage("SSN pattern found → masking");
+            masked = masked.replace(ssnRegex, "***-**-****");
+        }
+
+        if (phoneRegex.test(desc)) {
+            gs.addInfoMessage("Phone number pattern found → masking");
+            masked = masked.replace(phoneRegex, "**********");
+        }
+
+        // If changes were made, update the description
+        if (masked !== desc) {
+            current.description = masked;
+            gs.addInfoMessage("Final masked description: " + masked);
+            gs.log("Masking rule triggered on record: " + current.number, "MaskingRule");
+        } else {
+            gs.addInfoMessage("No sensitive data detected, nothing masked.");
+        }
+    }
+
+})(current, previous);

Server-Side Components/Business Rules/Mask Sensitive Data in Description Field/readme.md

@@ -0,0 +1,7 @@
+This script scans the description field of a record for patterns that resemble sensitive personal data and masks them to ensure privacy and compliance. It targets the following data types using regular expressions:
+
+Credit Card Numbers: Detects both continuous digits (13–16 digits) and spaced/dashed formats (e.g., 1234-5678-9012-3456).
+Social Security Numbers (SSNs): Matches the standard US format (XXX-XX-XXXX).
+Phone Numbers: Identifies various formats including international and local styles.
+
+If any of these patterns are found, the script replaces them with masked placeholders (e.g., ****-****-****-**** for credit cards) and updates the description field accordingly. It also logs messages to the system and displays info messages to notify users of the masking actions taken.