Merge branch 'ServiceNowDevProgram:main' into main

Author: SaiSankar1309

.github/scripts/validate-structure.js

@@ -49,6 +49,34 @@ function validateFilePath(filePath) {
   const normalized = filePath.replace(/\\/g, '/');
   const segments = normalized.split('/');
 
+  // Check for invalid characters that break local file systems
+  for (let i = 0; i < segments.length; i++) {
+    const segment = segments[i];
+
+    // Check for trailing periods (invalid on Windows)
+    if (segment.endsWith('.')) {
+      return `Invalid folder/file name '${segment}' in path '${normalized}': Names cannot end with a period (.) as this breaks local file system sync on Windows.`;
+    }
+
+    // Check for trailing spaces (invalid on Windows)
+    if (segment.endsWith(' ')) {
+      return `Invalid folder/file name '${segment}' in path '${normalized}': Names cannot end with a space as this breaks local file system sync on Windows.`;
+    }
+
+    // Check for reserved Windows names
+    const reservedNames = ['CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9', 'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9'];
+    const nameWithoutExt = segment.split('.')[0].toUpperCase();
+    if (reservedNames.includes(nameWithoutExt)) {
+      return `Invalid folder/file name '${segment}' in path '${normalized}': '${nameWithoutExt}' is a reserved name on Windows and will break local file system sync.`;
+    }
+
+    // Check for invalid characters (Windows and general file system restrictions)
+    const invalidChars = /[<>:"|?*\x00-\x1F]/;
+    if (invalidChars.test(segment)) {
+      return `Invalid folder/file name '${segment}' in path '${normalized}': Contains characters that are invalid on Windows file systems (< > : " | ? * or control characters).`;
+    }
+  }
+
   if (!allowedCategories.has(segments[0])) {
     return null;
   }

.github/workflows/validate-structure.yml

@@ -65,6 +65,8 @@ jobs:
           cat "$tmp_error" >&2
 
           if grep -q 'Folder structure violations found' "$tmp_output" "$tmp_error"; then
+            # Save validation output for use in PR comment
+            cat "$tmp_output" "$tmp_error" > "$RUNNER_TEMP/validation_output.txt"
             echo "status=failed" >> "$GITHUB_OUTPUT"
             exit 0
           fi
@@ -87,11 +89,37 @@ jobs:
             const owner = context.repo.owner;
             const repo = context.repo.repo;
 
+            const fs = require('fs');
+            const output = fs.readFileSync(process.env.RUNNER_TEMP + '/validation_output.txt', 'utf8');
+
+            let commentBody = `Thank you for your contribution. However, it doesn't comply with our contributing guidelines.\n\n`;
+
+            // Check if the error is about invalid file/folder names
+            if (output.includes('Names cannot end with a period') ||
+                output.includes('Names cannot end with a space') ||
+                output.includes('is a reserved name on Windows') ||
+                output.includes('Contains characters that are invalid')) {
+              commentBody += `**❌ Invalid File/Folder Names Detected**\n\n`;
+              commentBody += `Your contribution contains file or folder names that will break when syncing to local file systems (especially Windows):\n\n`;
+              commentBody += `\`\`\`\n${output}\n\`\`\`\n\n`;
+              commentBody += `**Common issues:**\n`;
+              commentBody += `- Folder/file names ending with a period (.) - not allowed on Windows\n`;
+              commentBody += `- Folder/file names ending with spaces - not allowed on Windows\n`;
+              commentBody += `- Reserved names like CON, PRN, AUX, NUL, COM1-9, LPT1-9 - not allowed on Windows\n`;
+              commentBody += `- Invalid characters: < > : " | ? * or control characters\n\n`;
+              commentBody += `Please rename these files/folders to be compatible with all operating systems.\n\n`;
+            } else {
+              commentBody += `As a reminder, the general requirements (as outlined in the [CONTRIBUTING.md file](https://github.com/ServiceNowDevProgram/code-snippets/blob/main/CONTRIBUTING.md)) are the following: follow the folder+subfolder guidelines and include a README.md file explaining what the code snippet does.\n\n`;
+              commentBody += `**Validation errors:**\n\`\`\`\n${output}\n\`\`\`\n\n`;
+            }
+
+            commentBody += `Review your contribution against the guidelines and make the necessary adjustments. Closing this for now. Once you make additional changes, feel free to re-open this Pull Request or create a new one.`;
+
             await github.rest.issues.createComment({
               owner,
               repo,
               issue_number: pullNumber,
-              body: `Thank you for your contribution. However, it doesn't comply with our contributing guidelines. As a reminder, the general requirements (as outlined in the [CONTRIBUTING.md file](https://github.com/ServiceNowDevProgram/code-snippets/blob/main/CONTRIBUTING.md)) are the following: follow the folder+subfolder guidelines and include a README.md file explaining what the code snippet does. Review your contribution against the guidelines and make the necessary adjustments. Closing this for now. Once you make additional changes, feel free to re-open this Pull Request or create a new one.`.trim()
+              body: commentBody.trim()
             });
 
             await github.rest.pulls.update({

Client-Side Components/Catalog Client Script/spModal for Sweet Alerts/readme.md

@@ -0,0 +1,27 @@
+In ServiceNow, Open catalog client Scripts [catalog_script_client] and paste the code snippet of [spModalSweetAlerts.js] file.
+
+Setup:
+1. A catalog item having variable name Rewards[rewards] of type 'Select Box'(include none as true) and 2 choices(Yes and No)
+2. A Single line type field named 'Reward Selected' [reward_selected] which will hold the value selected by user from the spModal popup.
+3. The onLoad catalog client script setup as below:
+4. Type: onChange
+5. Variable: rewards (as per step 1)
+6. Script: [[spModalSweetAlerts.js]]
+   
+
+
+Screenshots:
+
+
+<img width="1338" height="268" alt="image" src="https://github.com/user-attachments/assets/f7f22b83-7e0e-47bb-bbed-2a8f38783a4d" />
+
+
+Rewards selected as 'Yes'
+
+<img width="1353" height="327" alt="image" src="https://github.com/user-attachments/assets/1bb55339-36b4-4a9c-8b65-2b254b87cf5b" />
+
+From the spModal popup select anyone of the reward, it should be populated in the Reward Selected field.
+Along with that a message shows the same of the selection.
+
+<img width="1350" height="319" alt="image" src="https://github.com/user-attachments/assets/1b23c766-51f8-4b01-9073-f836f390deb2" />
+

Client-Side Components/Catalog Client Script/spModal for Sweet Alerts/spModalSweetAlerts.js

@@ -0,0 +1,32 @@
+function onChange(control, oldValue, newValue) {
+    if (newValue == 'Yes') {
+        spModal.open({
+            title: "Reward Type",
+            message: "Please select the category of Reward",
+            buttons: [{
+                    label: "Star Performer",
+                    value: "Star Performer"
+                },
+                {
+                    label: "Emerging Player",
+                    value: "Emerging Player"
+                },
+                {
+                    label: "High Five Award",
+                    value: "High Five Award"
+                },
+                {
+                    label: "Rising Star",
+                    value: "Rising Star"
+                }
+            ]
+        }).then(function(choice) {
+            if (choice && choice.value) {
+				g_form.addInfoMessage('Selected Reward: '+ choice.label);
+                g_form.setValue('reward_selected', choice.value);
+            }
+        });
+    } else {
+        g_form.clearValue('reward_selected');
+    }
+}

Client-Side Components/Client Scripts/Get Logged in User Information/README.md

@@ -0,0 +1,16 @@
+# The Glide User (g_user) is a global object available within the client side. It provides information about the logged-in  user.
+
+Property                   Description
+
+g_user.userID              Sys ID of the currently logged-in user
+g_user.name                User's Full name
+g_user.firstName           User's First name
+g_user.lastName            User's Last name
+
+# It also has some methods available within the client side.
+
+Method                     Description
+
+g_user.hasRole()           Determine whether the logged-in user has a specific role
+g_user.hasRoleExactly()    Do not consider the admin role while evaluating the method
+g_user.hasRoles()          You can pass two or more roles in a single method

Client-Side Components/Client Scripts/Get Logged in User Information/script.js

@@ -0,0 +1,18 @@
+if (g_user.hasRole('admin') || g_user.hasRole('itil')) {
+    // User has at least one of the roles
+    g_form.setDisplay('internal_notes', true);
+}
+
+if (g_user.hasRole('admin') && g_user.hasRole('itil')) {
+    // User must have both roles
+    g_form.setDisplay('advanced_settings', true);
+}
+
+//Using the parameters to set a field value
+g_form.setValue('short_description', g_user.firstName);
+
+g_form.setValue('short_description', g_user.lastName);
+
+g_form.setValue('short_description', g_user.name);
+
+g_form.setValue('short_description', g_user.userID);

Client-Side Components/Client Scripts/Hide Dependent Choice field if there no dependent choices/HideDependentChoiceClientScript.png

@@ -0,0 +1,18 @@
+function onChange(control, oldValue, newValue, isLoading, isTemplate) {
+    var fieldToHide = 'subcategory'; // I have taken subcategory as an example
+    if (newValue === '') {
+        g_form.setDisplay(fieldToHide, false);
+        return;
+    }
+    var ga = new GlideAjax('NumberOfDependentChoices');
+    ga.addParam('sysparm_name', 'getCountOfDependentChoices');
+    ga.addParam('sysparm_tableName', g_form.getTableName());
+    ga.addParam('sysparm_element', fieldToHide);
+    ga.addParam('sysparm_choiceName', newValue);
+    ga.getXMLAnswer(callBack);
+
+    function callBack(answer) {
+        g_form.setDisplay(fieldToHide, parseInt(answer) > 0 ? true : false);
+    }
+
+}

Client-Side Components/Client Scripts/Hide Dependent Choice field if there no dependent choices/HideDepnedentField.js

@@ -0,0 +1,21 @@
+var NumberOfDependentChoices = Class.create();
+NumberOfDependentChoices.prototype = Object.extendsObject(AbstractAjaxProcessor, {
+    getCountOfDependentChoices: function() {
+		var dependentChoiceCount = 0;
+		var choiceName = this.getParameter('sysparm_choiceName');
+		var tableName = this.getParameter('sysparm_tableName');
+		var element = this.getParameter('sysparm_element');
+		var choiceCountGa = new GlideAggregate('sys_choice');
+		choiceCountGa.addAggregate('COUNT');
+		choiceCountGa.addQuery('dependent_value',choiceName);
+		choiceCountGa.addQuery('inactive','false');
+		choiceCountGa.addQuery('name',tableName);
+		choiceCountGa.addQuery('element',element);
+		choiceCountGa.query();
+		while(choiceCountGa.next()){
+			dependentChoiceCount = choiceCountGa.getAggregate('COUNT');
+		}
+		return dependentChoiceCount;
+	},
+    type: 'NumberOfDependentChoices'
+});

Client-Side Components/Client Scripts/Hide Dependent Choice field if there no dependent choices/NumberOfDependentChoices.js

@@ -0,0 +1,7 @@
+Hide the dependent choice field when there are no available options for the selected parent choice.
+
+For example, if a selected category on the incident form has no subcategories, then the subcategory field should be hidden.
+
+The file NumberOfDependentChoices.js is a client callable script include file which has a method which returns number of dependent choices for a selected choice of parent choice field.
+
+HideDepnedentField.js is client script which hides the dependent choice field(ex:subcategory field on incident form) if there are no active choices to show for a selected choices of it's dependent field (example: category on incident form)