Merge branch 'ServiceNowDevProgram:main' into main

Author: MartinStoyanoff

.github/templates/rootreadmetemplate.md

@@ -14,6 +14,7 @@ on:
     branches: main
 jobs:
   deployment:
+    if: github.repository == 'ServiceNowDevProgram/code-snippets'
     runs-on: ubuntu-latest
     steps:
 #     - name: Log payload

.github/workflows/dprevent.yml

@@ -0,0 +1,9 @@
+function calculateHash(attachmentId){
+    var attachmentStream = new GlideSysAttachment().getContentStream(attachmentId);
+    var gDigest = new GlideDigest();
+    var sha256Hash = gDigest.getSHA256HexFromInputStream(attachmentStream);
+    if (sha256Hash) {
+        gs.info("Hash code of the attachment file: " + sha256Hash);
+    }
+}
+

.github/workflows/hacktrack.yml

@@ -0,0 +1,8 @@
+This is example of recalculate the hash code using the glide digest getSHA256HexFromInputStream method.
+
+GlideDigest() -
+    This class provides methods for creating a message digest from strings or input streams using MD5, SHA1, or SHA256 hash algorithms.
+
+Docs link: https://developer.servicenow.com/dev.do#!/reference/api/tokyo/server/no-namespace/c_GlideDigestScopedAPI#r_SGDigest-GlideDigest
+
+getSHA256HexFromInputStream - function takes GlideScriptableInputStream input stream as parameter.

Attachments/Calculate attachment hash code/calculateHash.js

@@ -0,0 +1,15 @@
+// To automatically delete RITM attachment, when an attachment is deleted on SCTASK.
+// Create a After Business Rule, and set business rule condition as Table name is "sctask", so that when an attachment is deleted on SCTASK, this business rule will run.
+
+var gr = new GlideRecord("sys_attachment");
+    var task = new GlideRecord('sc_task');
+    if (task.get(current.table_sys_id)) {
+        gr.addEncodedQuery("table_name=sc_req_item^table_sys_id=" + task.request_item.sys_id + "^file_nameSTARTSWITH" + current.file_name);
+        gr.query();
+        if(gr.next())
+        //gr.deleteRecord();
+		var attachment = new GlideSysAttachment();
+			attachment.deleteAttachment(gr.getValue("sys_id"));
+    }
+
+})(current, previous);

Attachments/Calculate attachment hash code/readme.md

@@ -0,0 +1 @@
+The Delete RITM attachment business rule will automatically deletes the attachment on RITM, when the attachment is deleted on SCTASK.

Attachments/Delete RITM Attachment/deleteattachment.js

@@ -0,0 +1,11 @@
+(function executeRule(current, previous /*null when async*/) {
+
+	// Check RITM for attachments and pass True/False to client via scratchpad
+	var grAttachment = new GlideRecord('sc_req_item');
+	grAttachment.addQuery('sys_id', current.request_item);
+	grAttachment.query();
+	if (grAttachment.next()){
+			g_scratchpad.hasAttachments = grAttachment.hasAttachments();
+	}
+	
+})(current, previous);

Attachments/Delete RITM Attachment/readme.md

@@ -0,0 +1,5 @@
+function onLoad() {
+	if (g_scratchpad.hasAttachments == true) {
+		g_form.showFieldMsg('request_item', "Contains attachment(s)",'info');
+	}
+}

Attachments/Show RITM has Attachments/ShowRITMhasAttachment_BR.js

@@ -0,0 +1,3 @@
+This feature requires a "Display" Business rule on [sc_task] to pass true/false to the scratchpad and then an "onLoad" Client Script to display a message on the Catalog Task form if the RITM has attachments.
+
+The result is a message on the Catalog Task form (below the RITM field) indicating when a RITM has attachments.

Attachments/Show RITM has Attachments/ShowRITMhasAttachment_CS.js

@@ -0,0 +1,7 @@
+var sid = 'ADD YOUR CHANGE RECORD SYS_ID HERE';
+
+var chg = new GlideRecord('change_request');
+if(chg.get(sid)) {
+    chg.setValue('chg_model', 'e55d0bfec343101035ae3f52c1d3ae49'); //standard change model
+chg.update();
+}

Attachments/Show RITM has Attachments/readme.md

@@ -0,0 +1 @@
+Add the OOTB "Standard Change" model to an existing change record. OOTB, the Standard Change model is applied through an onDisplay business rule, and is not an available choice from the Model field. If you have migrated to use Change Models and generate some change requests with scripts, you may need to add the model with a background script if there is already an existing workflow context or if the model is not set by the generation script. The setter portion can be added to an existing generation script to prevent future need for this background script.

Background Scripts/Add Standard Change Model/addStandardChgModel.js

@@ -0,0 +1,15 @@
+Background script to send approval reminder to Approver Delegates:
+========================================
+var appr = new GlideRecord('sysapproval_approver');
+appr.addQuery('state', 'requested');
+appr.addQuery('sysapproval.sys_class_name', 'sc_req_item');
+appr.addEncodedQuery("sysapproval.numberLIKERITM0010468");
+appr.query();
+while(appr.next())
+	{
+    //" approval.reminded" is a registered event to trigger notificationn email to  their delegates to approve or reject approval requests when approvar not available
+		gs.eventQueue("approval.reminded" , appr , appr.approver , appr.approver.getUserName());
+	}
+
+
+gs.print(appr.getRowCount());

Background Scripts/Add Standard Change Model/readme.md

@@ -0,0 +1,5 @@
+Use Case: Approval are pending due approver unavailability
+
+Solution : Assign delgates to the approver and send reminder email notification using the Approval reminder code.It will send email to delgates and they will get notified with the approval request to approve/reject per limited period.
+
+Steps: Register an event and create a notification to send  email to manager when the event fired/triggered.

Background Scripts/Approval Reminders/approvalReminderToDelegates.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/Approval Reminders/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 Approver/BgScript.js

@@ -0,0 +1,2 @@
+Use this script to check for duplicates (and delete if necessary) in a table based on 2 or more criteria. 
+For reference: https://www.servicenow.com/community/developer-blog/search-for-duplicates-delete-based-on-2-columns/ba-p/2279274

Background Scripts/Change Approver/Readme.md

@@ -0,0 +1,39 @@
+deleteDuplicates('table_name', 'criteria1', 'criteria2');
+
+function deleteDuplicates(tableName, field1, field2){
+
+// declare an array
+var dupRecords = [];
+var duplicateCheck = new GlideAggregate(tableName);
+duplicateCheck.addNotNullQuery(field1);
+duplicateCheck.addNotNullQuery(field2);
+duplicateCheck.groupBy(field1);
+duplicateCheck.groupBy(field2);
+duplicateCheck.addHaving('COUNT', '>', 1); // addHaving func won't work in scope app
+duplicateCheck.query();
+while(duplicateCheck.next()) {
+var jsonObj = {}; // declare a json object
+jsonObj[field1] = duplicateCheck[field1].toString();
+jsonObj[field2] = duplicateCheck[field2].toString()
+dupRecords.push(jsonObj);
+}
+
+var jsonString = JSON.stringify(dupRecords); // convert json object to string
+
+var parser = new JSONParser();
+var parsedData = parser.parse(jsonString);
+var length = parsedData.length;
+
+for(var i=0; i<length; i++){
+
+var encodedQuery = field1 + '=' + parsedData[i][field1] + '^' + field2 + '=' + parsedData[i][field2];
+
+var tableRec = new GlideRecord(tableName);
+tableRec.addEncodedQuery(encodedQuery);
+tableRec.query();
+if(tableRec.next()){
+gs.info('Repeated Data is: User -> ' + tableRec.getDisplayValue('user') + ' Group -> ' + tableRec.getDisplayValue('group'));
+tableRec.deleteRecord();
+}
+}
+}

Background Scripts/Check for duplicates on multiple criteria/README.md

@@ -0,0 +1,2 @@
+Clone a user to another user after creating a new user from SN and run the below script from Background Script under System Definition app. 
+The sys id's are needed from both users to run the background script.

Background Scripts/Check for duplicates on multiple criteria/check-for-ducplicates.js

@@ -0,0 +1,13 @@
+createUserRoles();
+function createUserRoles(){
+var gr = new GlideRecord('sys_user_has_role');
+gr.addQuery('user', '<old sys id for that user instance>'); //old sys_id
+gr.query();
+while(gr.next()){
+var gr1 = new GlideRecord('sys_user_has_role');
+gr1.initialize();
+gr1.user = '<new sys id for that user instance>';//new user sys_id
+gr1.role = gr.role;
+gr1.insert();
+}
+}

Background Scripts/Clone User Record/Readme.md

@@ -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 Record/cloneUserRec.js

@@ -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/Clone User with Roles and Groups/cloneUser.js

@@ -0,0 +1 @@
+This is the simple code to run independently from AES -> Background Scripts module and convert the datetime from one time zone to other

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

@@ -0,0 +1,3 @@
+var strConvertedDateTime=new GlideScheduleDateTime("2022-03-03 06:30:00").convertTimeZone("CET", "IST"); // Instantiate the object by passing the timezones
+var gdtConvertedDateTime = new GlideDateTime(strConvertedDateTime); //Call the method to convert the date time from CET to IST
+gs.info(gdtConvertedDateTime); //Print the converted value

Background Scripts/Convert Date Time/Readme.md

@@ -0,0 +1,6 @@
+1.Take any comma separated string to be displayed in columns
+2.Apply above logic
+3.update to field /Print /Use this in mail scripts to include in the notification.
+4. we can also add this arryUtils script include (to convert arry elements to colums)
+
+![image](https://user-images.githubusercontent.com/42912180/195672456-f282c82e-8516-4925-9e71-c80da8329ef3.png)

Background Scripts/Convert Date Time/convertTimeZone.js

@@ -0,0 +1,8 @@
+var Str = "Element1,Element2,Element3,Element4,Element5,Element6";
+result =[];
+var myArray = Str.split(",");
+for(var i =0; i<=myArray.length;i++){
+result.push(myArray[i]);
+}
+var output= "\n" +result.join("\n");
+gs.info(output);