Merge branch 'main' into Hacktober-2025-5th_code_branch

Author: Soumyadeep10

Integration/Import Sets/Import sets overview/ModelManufacture.README.md

@@ -0,0 +1,16 @@
+When importing or processing Configuration Items (CIs), especially hardware assets, missing model or manufacturer data can cause CI creation failures or incomplete relationships.
+This script handles that automatically by:
+* Checking if a manufacturer already exists in the core_company table.
+* Checking if a model already exists in the cmdb_model hierarchy.
+* Creating the manufacturer and/or model records if they are missing.
+
+How It Works
+
+1. Extracts model and manufacturer names from the data source (source.u_model and source.u_manufacturer).
+2. Calls getOrCreateManufacturer():
+    * Searches the core_company table by name.
+    * Creates a new company record if not found.
+3. Calls getOrCreateModel():
+    * Searches the cmdb_model table (including child tables).
+    * If no match exists, inserts a new record in cmdb_hardware_product_model.
+4. Logs each action (found, created, or failed) for debugging and auditing.

Integration/Import Sets/Import sets overview/ModelManufacture.js

@@ -0,0 +1,70 @@
+  var modelName = source.u_model;
+    var manufacturerName = source.u_manufacturer;
+ 
+function getOrCreateModel(modelName, manufacturerName) {
+        try {
+            var manufacturerSysId = getOrCreateManufacturer(manufacturerName);
+            if (!manufacturerSysId) {
+                gs.error("MODEL SCRIPT: Failed to find or create manufacturer: " + manufacturerName);
+                return null;
+            }
+
+            // Query cmdb_model to check if any existing model (including child tables) exists
+            var modelGr = new GlideRecord('cmdb_model');
+            modelGr.addQuery('name', modelName);
+            modelGr.addQuery('manufacturer', manufacturerSysId);
+            modelGr.query();
+
+            if (modelGr.next()) {
+                gs.info("MODEL SCRIPT: Found existing model: " + modelGr.getUniqueValue());
+                return modelGr.getUniqueValue();
+            } else {
+                // Create in child table: cmdb_hardware_product_model
+                var newModel = new GlideRecord('cmdb_hardware_product_model');
+                newModel.initialize();
+                newModel.setValue('name', modelName);
+                newModel.setValue('manufacturer', manufacturerSysId);
+                var newModelSysId = newModel.insert();
+
+                if (newModelSysId) {
+                    gs.info("MODEL SCRIPT: Created new hardware model: " + newModelSysId);
+                    return newModelSysId;
+                } else {
+                    gs.error("MODEL SCRIPT: Failed to insert new model for " + modelName);
+                    return null;
+                }
+            }
+        } catch (e) {
+            gs.error("MODEL SCRIPT: Error in getOrCreateModel(): " + (e.message || e));
+            return null;
+        }
+    }
+
+    function getOrCreateManufacturer(name) {
+        try {
+            var companyGr = new GlideRecord('core_company');
+            companyGr.addQuery('name', name);
+            companyGr.query();
+
+            if (companyGr.next()) {
+                gs.info("MODEL SCRIPT: Found manufacturer: " + companyGr.getUniqueValue());
+                return companyGr.getUniqueValue();
+            } else {
+                companyGr.initialize();
+                companyGr.setValue('name', name);
+                //companyGr.setValue('manufacturer', true); // Ensure it’s marked as manufacturer
+                var newMfrSysId = companyGr.insert();
+
+                if (newMfrSysId) {
+                    gs.info("MODEL SCRIPT: Created new manufacturer: " + newMfrSysId);
+                    return newMfrSysId;
+                } else {
+                    gs.error("MODEL SCRIPT: Failed to insert new manufacturer: " + name);
+                    return null;
+                }
+            }
+        } catch (e) {
+            gs.error("MODEL SCRIPT: Error in getOrCreateManufacturer(): " + (e.message || e));
+            return null;
+        }
+    }

Integration/Import Sets/Import sets overview/TriggerDataSource.README.md

@@ -0,0 +1,4 @@
+The triggerDataSource() function eliminates the need for manually executing a Data Source from the UI.
It programmatically triggers the import of a predefined Data Source record and loads the associated data into an Import Set table.
+This function is typically used in:
+* Scheduled Script Executions
+* Flow Designer Actions.

Integration/Import Sets/Import sets overview/TriggerDataSource.js

@@ -0,0 +1,14 @@
+triggerDataSource: function() {
+
+    var dataSourceSysId = gs.getProperty('ds.tag.based.sys.id'); //Store the sysId of DataSource from system property
+
+    var grDataSource = new GlideRecord('sys_data_source');
+    if (grDataSource.get(dataSourceSysId)) {
+        var loader = new GlideImportSetLoader(); //OOB Method to load
+        var importSetRec = loader.getImportSetGr(grDataSource);
+        var ranload = loader.loadImportSetTable(importSetRec, grDataSource);
+        importSetRec.state = "loaded";
+        importSetRec.update();
+        return importSetRec.getUniqueValue();
+    }
+},

Specialized Areas/Flow Actions/Get KB Article Permalink/README.md

@@ -0,0 +1,10 @@
+# Get KB Article Permalink
+Flow Action which will take KB Article Number as input and returns the latest version of Permalink. This URL will stay constant always even if the KB Article is updated with new version.
+
+**Input** : KB Article Number (Type : String)
+
+**Script Step** : Generates the Permalink URL for KB Article (see the script.js file in this folder)
+
+**Output** : Permalink (Type : URL)
+
+**Usage** : This can be used in multiple scenarios where the KB Article Link/URL is required. It can either be in notifications, scripts, Integrations, etc. Since this Permalink is always fixed and works even if the KB Article is updated to new version, there is no maintainance required.

Specialized Areas/Flow Actions/Get KB Article Permalink/script.js

@@ -0,0 +1,7 @@
+(function execute(inputs, outputs) {
+
+    var instanceURL = gs.getProperty('glide.servlet.uri').toString();
+    var permalink = instanceURL + 'kb?id=kb_article_view&sysparm_article=' + inputs.kb_number;
+    outputs.kb_article_permalink = permalink;
+    
+})(inputs, outputs);