Merge branch 'ServiceNowDevProgram:main' into main

Author: sanjivmeher

Background Scripts/Change Approver/BgScript.js

@@ -0,0 +1,9 @@
+
+var ab=new GlideRecord('sysapproval_approver');
+ab.addQuery('sysapproval','<Approval_record_sys_id>');
+ab.query();
+if(ab.next())
+{
+ab.approver.setDisplayValue('<User_Display_Name>')';
+ab.update();
+}

Background Scripts/Change Approver/Readme.md

@@ -0,0 +1,3 @@
+Use the code to change approver for any record from background script
+Replace <Approval_record_sys_id> with sys_id of record for which approval is triggered
+Replace <User_Display_Name> with name of user who needs to be set as approver

Background Scripts/Change Update Set Application Scope/changeApplicationScope.js

@@ -0,0 +1,27 @@
+function changeUpdateSetApplicationScope(updateSetName, currentApplicationScope, newApplicationScope) {
+
+    var newApplicationScopeSysId = getApplicationScopeSysId(newApplicationScope);
+
+    var updateSetGR = new GlideRecord("sys_update_set");
+    updateSetGR.addQuery('name', updateSetName);
+    updateSetGR.addQuery('application.name', currentApplicationScope);
+    updateSetGR.query();
+
+    if (updateSetGR.next()) {
+        updateSetGR.setValue('application', newApplicationScopeSysId);
+        updateSetGR.update();
+    }
+
+}
+
+function getApplicationScopeSysId(scopeName) {
+  
+    var appGR = new GlideRecord('sys_app');
+    appGR.addQuery('name', scopeName);
+    appGR.query();
+    if (appGR.next()) {
+        return appGR.getValue('sys_id');
+    }
+}
+
+changeUpdateSetApplicationScope('updateSetName', 'currentApplicationScope', 'newApplicationScope');

Background Scripts/Change Update Set Application Scope/readme.md

@@ -0,0 +1,2 @@
+# Change update set application scope
+In ServiceNow, there are instances where an update set is mistakenly created in the incorrect application scope. To rectify this, I've developed a background script that facilitates the alteration of the update set's application scope to the appropriate one.

Background Scripts/Clone User with Roles and Groups/cloneUser.js

@@ -0,0 +1,73 @@
+function cloneUser(currentUserId, newUserId) {
+
+    var newUserRecordSysId = createNewUserRecord(newUserId);
+    cloneCurrentUserFields(currentUserId, newUserId);
+    cloneUserRoles(currentUserId, newUserRecordSysId);
+    cloneUserGroups(currentUserId, newUserRecordSysId);
+}
+
+function cloneCurrentUserFields(currentUserId, newUserId) {
+
+    var currentUserGR = new GlideRecord("sys_user");
+    currentUserGR.addQuery("user_name", currentUserId);
+    currentUserGR.query();
+
+    if (currentUserGR.next()) {
+        var newUserGR = new GlideRecord("sys_user");
+        newUserGR.addQuery("user_name", newUserId);
+        newUserGR.query();
+        if (newUserGR.next()) {
+            var userGRU = new GlideRecordUtil();
+            var fieldList = userGRU.getFields(currentUserGR);
+            for (var index = 0; index < fieldList.length; index++) {
+                var fieldName = fieldList[index];
+                if (!newUserGR.getValue(fieldName)) {
+                    newUserGR.setValue(fieldName, currentUserGR.getValue(fieldName));
+                    newUserGR.update();
+                }
+            };
+        }
+    }
+}
+
+function createNewUserRecord(userId) {
+
+    var userGR = new GlideRecord("sys_user");
+    userGR.initialize();
+    userGR.setValue("user_name", userId);
+    var sysId = userGR.insert();
+    return sysId;
+}
+
+function cloneUserRoles(currentUserId, newUserRecordSysId) {
+
+    var currentUserRoleGR = new GlideRecord("sys_user_has_role");
+    currentUserRoleGR.addQuery('user.user_name', currentUserId);
+    currentUserRoleGR.addQuery('inherited', 'false');
+    currentUserRoleGR.query();
+
+    while (currentUserRoleGR.next()) {
+        var newUserRoleGR = new GlideRecord("sys_user_has_role");
+        newUserRoleGR.initialize();
+        newUserRoleGR.setValue('user', newUserRecordSysId);
+        newUserRoleGR.setValue('role', currentUserRoleGR.getValue('role'));
+        newUserRoleGR.insert();
+    }
+}
+
+function cloneUserGroups(currentUserId, newUserRecordSysId) {
+
+    var currentUserGroupGR = new GlideRecord("sys_user_grmember");
+    currentUserGroupGR.addQuery('user.user_name', currentUserId);
+    currentUserGroupGR.query();
+
+    while (currentUserGroupGR.next()) {
+        var newUserGroupGR = new GlideRecord("sys_user_grmember");
+        newUserGroupGR.initialize();
+        newUserGroupGR.setValue('user', newUserRecordSysId);
+        newUserGroupGR.setValue('group', currentUserGroupGR.getValue('group'));
+        newUserGroupGR.insert();
+    }
+}
+
+cloneUser('currentUserId', 'newUserId'); //currentUserId: Id of the you that we want to clone, newUserId: Id of the new user record. 

Background Scripts/Clone User with Roles and Groups/readme.md

@@ -0,0 +1,2 @@
+# Clone User with Roles and Groups
+I have created a script in ServiceNow to replicate a user's profile. This script not only duplicates the user's data but also replicates the roles and groups assigned to that user.

Background Scripts/Currency Formatting/README.md

@@ -0,0 +1,15 @@
+Format currency values to your preferred locale and format.
+Examples are provided for EUR, HUF with English and Hungarian number format.
+
+formatString values:
+    Valid values:
+    
+    %s: Replaced by the currency symbol associated with the country code specified in the format() call.
+    %v: Replaced by the currency amount, such as 123.45.
+    %c: Replaced by the ISO currency code specified in the format() call, such as USD or EUR.
+    %l: Replaced with the passed in value, no formatting performed.
+    %p: Replaced by the percent sign (%).
+    For example, if the format string is '%s%v%c' and the value to format is 123.45 in US dollars, the returned formatted string is $123.45 USD. If the format string is '%s%l%c' and the value string to format is '56M' in Euros, the returned formatted string is €56M EUR.
+
+setMaxFractionDigits:
+    Maximum number of fraction digits to return. Does a rounding based on the closest right-most digit.

Background Scripts/Currency Formatting/currencyFormatting.js

@@ -0,0 +1,17 @@
+var amount = '9123456.123456789';
+var currencyCode = 'EUR';
+var formatString = '%s%v %c';
+var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
+exchangeValue.setLocale("en", "EN"); // Language = en Country = EN
+
+gs.info('Formatted currency: ' + exchangeValue.setMaxFractionDigits(1).format(amount, currencyCode));
+// expected output: Formatted currency: €9,123,456.1 EUR
+
+amount = '9123456.127456789';
+currencyCode = 'HUF';
+formatString = '%v %c';
+exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
+exchangeValue.setLocale("hu", "HU"); // Language = hu Country = HU
+
+gs.info('Formatted currency: ' + exchangeValue.setMaxFractionDigits(2).format(amount, currencyCode));
+// expected output: Formatted currency: 9 123 456,13 HUF

Background Scripts/Extend Code Search Base./add_more_tables_to_code_search.js

@@ -0,0 +1,54 @@
+var grSearchGroup = new GlideRecord('sn_codesearch_search_group');
+
+grSearchGroup.query();
+
+//iterate all code search groups
+while (grSearchGroup.next()) {
+	var grDictionary        = new GlideRecord('sys_dictionary');
+	var strSearchGroupSysID = grSearchGroup.getValue('sys_id');
+	var objArrayUtil        = new ArrayUtil();
+
+  //determine all candidates for a code search from the dictionary 
+	grDictionary.addEncodedQuery(
+		'internal_type.nameINscript,condition,condition_string,script_plain,XML,script_server' +
+		'^ORelement=reference_qual' +
+		'^ORelement=calculation' +
+		'^NQelementSTARTSWITHscript' +
+		'^ORelementLIKE_script' +
+		'^internal_type.nameSTARTSWITHstring' +
+		'^ORinternal_type.name=json' +
+		'^NQname=sys_variable_value' +
+		'^element=value'
+	);
+
+	grDictionary.query();
+
+	while (grDictionary.next()) {
+		var grCodeSearch = new GlideRecord('sn_codesearch_table');
+		var strTable     = grDictionary.getValue('name');
+		var strField     = grDictionary.getValue('element');
+
+    //load everything which is already registered as code search base
+		grCodeSearch.addQuery('table', strTable);
+		grCodeSearch.addQuery('search_group', strSearchGroupSysID);
+		grCodeSearch.setLimit(1);
+		grCodeSearch.query();
+
+		//for the respective table there is already a record available
+		if (grCodeSearch.next()) {
+			var arrFields = grCodeSearch.getValue('search_fields').split(',');
+
+			arrFields.push(strField);
+			grCodeSearch.setValue('search_fields', objArrayUtil.unique(arrFields).join(','));
+			grCodeSearch.update();
+		}
+		// create a new record at table "sn_codesearch_table"
+		else {
+			grCodeSearch.initialize();
+			grCodeSearch.setValue('table', strTable);
+			grCodeSearch.setValue('search_group', strSearchGroupSysID);
+			grCodeSearch.setValue('search_fields', strField);
+			grCodeSearch.insert();
+		}
+	}
+}

Background Scripts/Extend Code Search Base./readme.md

@@ -0,0 +1,19 @@
+# Description
+Over time, your code spreads across dozens of artifact types and it becomes very difficult to keep track of it all. 
+
+The whole thing is made more difficult by the fact that JavaScript code is not always contained in pure script fields but also, for example, in conditions or even in JSON payloads. 
+
+Fortunately, there is a code search - for example in the ServiceNow Studio, via the UI page "CodeSearchExampleUse" or with the help of the browser extension "SN Utils".
+
+However in a baseline instance the code search covers about 31 tables and their fields only. If you want to search all available tables and script-related fields, you can execute my script `add_more_tables_to_code_search`. It determines in the dictionary all potential candidates that could hold JavaScript code and add them to the code search base.
+
+# Involved tables
+
+## `sn_codesearch_search_group`
+
+A search group has a certain name and covers all tables and fields which can be searched when using that search group. Utilizing "SN Utils" browser extension you can select the preferred search group. Within ServiceNow Studio this is not possible and the search group "sn_devstudio.Studio" is leveraged automatically. For this reason my script adds all tables and fields to all search groups the same way.
+
+## `sn_codesearch_table`
+
+Each record in that table represent a table and their fields which are searchable. These records are added or complemented by my script.
+