Merge branch 'ServiceNowDevProgram:main' into main

Author: raghavs046

Client-Side Components/UI Actions/Publish a Retired Knowledge Article again/README.md

@@ -0,0 +1,9 @@
+**UI Action**: 
+Publish a Retired Knowledge Article again after it is already retired.
+
+**How it works:**
+1. The code finds existing articles in the Knowledge base that share the same Article ID but are not the current article and are 'retired'.
+2. It updates the workflow state of these found articles to 'outdated'.
+3. For the current article, it sets the workflow_state to 'pubblished', records the current date and updates the 'published' field with the date.
+4. It also removes the pre-existing 'retired' date from the 'retired' field.
+5. It redirects the user to the updated current record.

Client-Side Components/UI Actions/Publish a Retired Knowledge Article again/publishretiredkb.js

@@ -0,0 +1,15 @@
+var kbArticle = new GlideRecord('kb_knowledge');
+kbArticle.setWorkflow(false);
+kbArticle.addQuery('article_id', current.article_id);
+kbArticle.addQuery('sys_id', "!=", current.sys_id); //articles that are not the current one
+kbArticle.addQuery('workflow_state', 'retired');
+kbArticle.query();
+while (kbArticle.next()) {
+    kbArticle.workflow_state = 'outdated';  //setting the articles as outdated
+    kbArticle.update();
+}
+current.workflow_state = 'published';  //publishing retired kb article again
+current.published = new GlideDate();
+current.retired = "";  //clearing retired field value
+current.update();
+action.setRedirectURL(current);

Server-Side Components/Script Includes/Dynamic Record Archiving/README.md

@@ -0,0 +1,32 @@
+#  Dynamic Record Archiving Logic
+
+##  Overview
+This snippet provides a reusable logic to archive or flag records in ServiceNow that are older than a specified threshold. It helps maintain data hygiene, improve performance, and support compliance with data retention policies.
+
+You can choose between two modes:
+- **Flag Mode**: Marks records as archived using a custom field (`u_archived`).
+- **Move Mode**: Moves records to a corresponding archive table (e.g., `incident_archive`) and deletes the original.
+
+---
+
+##  Use Case
+- Archive incidents older than 1 year.
+- Clean up old tasks, requests, or custom records.
+- Automate data lifecycle management via Scheduled Jobs.
+
+---
+
+##  Parameters
+| Parameter           | Description                                                                 |
+|---------------------|-----------------------------------------------------------------------------|
+| `tableName`         | Name of the table to archive (e.g., `incident`)                             |
+| `dateField`         | Date field to filter by (e.g., `opened_at`, `created_on`)                   |
+| `archiveThresholdDays` | Number of days before today to consider for archiving (e.g., `365`)         |
+| `archiveMode`       | `'flag'` to mark records, `'move'` to transfer to archive table             |
+
+---
+
+##  Example Usage
+```javascript
+var archiver = new RecordArchiver('incident', 'opened_at', 365, 'flag');
+archiver.archiveRecords();

Server-Side Components/Script Includes/Dynamic Record Archiving/code.js

@@ -0,0 +1,53 @@
+var RecordArchiver = Class.create();
+RecordArchiver.prototype = {
+    initialize: function(tableName, dateField, archiveThresholdDays, archiveMode) {
+        this.tableName = tableName;
+        this.dateField = dateField;
+        this.archiveThresholdDays = archiveThresholdDays;
+        this.archiveMode = archiveMode || 'flag'; // 'flag' or 'move'
+    },
+
+    archiveRecords: function() {
+        var thresholdDate = new GlideDateTime();
+        thresholdDate.addDaysUTC(-this.archiveThresholdDays);
+
+        var gr = new GlideRecord(this.tableName);
+        gr.addQuery(this.dateField, '<=', thresholdDate);
+        gr.query();
+
+        var count = 0;
+        while (gr.next()) {
+            if (this.archiveMode === 'flag') {
+                gr.setValue('u_archived', true); // Assumes a custom field 'u_archived'
+                gr.update();
+            } else if (this.archiveMode === 'move') {
+                this._moveToArchiveTable(gr);
+            }
+            count++;
+        }
+
+        gs.info('Archived ' + count + ' records from ' + this.tableName);
+    },
+
+    _moveToArchiveTable: function(record) {
+        var archiveGr = new GlideRecord(this.tableName + '_archive');
+        archiveGr.initialize();
+
+        var fields = record.getFields();
+        for (var i = 0; i < fields.size(); i++) {
+            var fieldName = fields.get(i).getName();
+            if (archiveGr.isValidField(fieldName)) {
+                archiveGr.setValue(fieldName, record.getValue(fieldName));
+            }
+        }
+
+        archiveGr.insert();
+        record.deleteRecord();
+    },
+
+    type: 'RecordArchiver'
+};
+
+// Example usage:
+//var archiver = new RecordArchiver('incident', 'opened_at', 365, 'flag'); // Archive incidents older than 1 year
+//archiver.archiveRecords();

Server-Side Components/Script Includes/Recursive GlideRecord Fetcher/README.md

@@ -0,0 +1,29 @@
+#  Recursive GlideRecord Fetcher
+##  Overview
+This snippet provides a reusable logic to recursively fetch child records from a parent record in ServiceNow. It is useful for traversing hierarchical relationships such as tasks, categories, CMDB CI relationships, or any table with a parent-child structure.
+
+The logic prevents infinite loops by tracking visited records and supports nesting of children for structured output.
+
+---
+
+##  Use Case
+- Fetch all subtasks under a parent task.
+- Traverse CMDB CI relationships recursively.
+- Build hierarchical views of organizational units or categories.
+
+---
+
+##  Parameters
+| Parameter        | Description                                                                 |
+|------------------|-----------------------------------------------------------------------------|
+| `tableName`      | Name of the table to query (e.g., `task`, `cmdb_ci`, `custom_table`)        |
+| `parentField`    | Field that links to the parent record (e.g., `parent`, `parent_id`)         |
+| `parentSysId`    | Sys ID of the root parent record to start traversal                         |
+
+---
+
+##  Example Usage
+```javascript
+var fetcher = new RecursiveFetcher('task', 'parent');
+var hierarchy = fetcher.fetchChildren('abc123sysid'); // Replace with actual parent sys_id
+gs.info(JSON.stringify(hierarchy));

Server-Side Components/Script Includes/Recursive GlideRecord Fetcher/code.js

@@ -0,0 +1,41 @@
+var RecursiveFetcher = Class.create();
+RecursiveFetcher.prototype = {
+    initialize: function(tableName, parentField) {
+        this.tableName = tableName;
+        this.parentField = parentField;
+        this.visited = [];
+    },
+
+    fetchChildren: function(parentSysId) {
+        if (this.visited.indexOf(parentSysId) !== -1) {
+            // Avoid infinite loops
+            return [];
+        }
+
+        this.visited.push(parentSysId);
+        var children = [];
+
+        var gr = new GlideRecord(this.tableName);
+        gr.addQuery(this.parentField, parentSysId);
+        gr.query();
+
+        while (gr.next()) {
+            var child = {
+                sys_id: gr.getValue('sys_id'),
+                name: gr.getDisplayValue('name') || gr.getDisplayValue('short_description'),
+                children: this.fetchChildren(gr.getValue('sys_id')) // Recursive call
+            };
+            children.push(child);
+        }
+
+        return children;
+    },
+
+    type: 'RecursiveFetcher'
+};
+
+// Example usage:
+//var fetcher = new RecursiveFetcher('task', 'parent');
+//var hierarchy = fetcher.fetchChildren('abc123sysid'); // Replace with actual parent sys_id
+//gs.info(JSON.stringify(hierarchy));
+``