Skip to content

Commit 21a7550

Browse files
authored
Merge branch 'ServiceNowDevProgram:main' into main
2 parents 535a273 + fe3b963 commit 21a7550

File tree

21 files changed

+504
-0
lines changed

21 files changed

+504
-0
lines changed
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
function onSubmit() {
2+
//Type appropriate comment here, and begin script below
3+
var description = g_form.getValue('description');
4+
var state = g_form.getValue('state');
5+
6+
if ((!description) && (state == 'completed')) {
7+
g_form.addErrorMessage('Please provide Description Value, Description Cannot be empty');
8+
9+
return false;
10+
}
11+
12+
}
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
When an Incident record is being closed, the system should validate that the Description field is not empty and state is completed.
2+
If the Description field is blank and state is completed, the record submission (update) should be aborted, and the user should be prompted to provide a description before closing the incident.
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
>**UI Action**
2+
When a new Incident record is created, user can come to incident ticket and assigned to themself. Once they click on UI Action.
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
var currentUser = gs.getUserID(); //Getting loggedIn User Id
2+
3+
//Checing wheather user is available or not in Assignee field
4+
if(current.assigned_to == ""){ //checking assigned to is there or not
5+
current.assigned_to = currentUser; //Setting the current loggedIn user
6+
current.update(); //updating the record.
7+
gs.addInfoMessage("Incident has been assigned to You.");
8+
action.setRedirectURL(current);
9+
} else {
10+
gs.addErrorMessage("Incident is already assigned");
11+
action.setRedirectURL(current);
12+
}
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# 🧩 ServiceNow Asset QR Code Generator (UI Action)
2+
3+
This repository contains a **ServiceNow UI Action** script that generates and displays a QR Code for an Asset record from list view.
4+
When the user selects a record and clicks the UI Action, a modal window pops up showing a dynamically generated QR Code that links to asset details.
5+
6+
7+
A supporting **Script Include** (server-side) is required in your ServiceNow instance but **is not included** in this repository.
8+
At the bottom of file , a sample Script Include Code is given , check for the reference.
9+
10+
---
11+
12+
## 🚀 Features
13+
14+
- Generates a QR Code for the selected Asset record.
15+
- Displays the QR Code inside a ServiceNow modal (`GlideModal`).
16+
- Uses **QrIckit API** for quick and free QR code generation.
17+
- Clean, modular client-side code that integrates seamlessly with UI Actions.
18+
- Includes a `qr-code-image` file showing example QR Code generated.
19+
20+
---
21+
22+
## 🧠 How It Works
23+
24+
1. The `onClickQR()` function is triggered when the user clicks a UI Action button.
25+
2. It calls `generateQRCodeForAsset(sys_id)` and passes the record’s `sys_id`.
26+
3. A `GlideAjax` request fetches asset data from a **Script Include** on the server.
27+
4. That data is encoded and sent to the **QrIckit** API to generate a QR Code image.
28+
5. A ServiceNow modal (`GlideModal`) displays the generated QR Code to the user.
29+
30+
---
31+
32+
33+
**Note :**
34+
1) As the UI action calls a Script Include , in this folder no script include is present
35+
2) You can modify script include part as required(i.e Which fields are to be shown when QR is scanned)
36+
3) A sample Client Callable Script-Include is given here.
37+
38+
``` Script Include Code
39+
var GenerateAssetQR = Class.create();
40+
GenerateAssetQR.prototype = Object.extendsObject(AbstractAjaxProcessor, {
41+
getAssetQRData: function() {
42+
var sys_id = this.getParameter('sysparm_sys_id');
43+
var asset = new GlideRecord('alm_asset');
44+
if (asset.get(sys_id)) {
45+
return 'Asset: ' + asset.name + ', Serial: ' + asset.serial_number;
46+
}
47+
return 'Invalid asset record.';
48+
}
49+
});
50+
```
87.7 KB
Loading
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
function onClickQR() {
2+
generateQRCodeForAsset(g_sysId);//get the sysid of selected record
3+
}
4+
5+
function generateQRCodeForAsset(sys_id) {
6+
var ga = new GlideAjax('GenerateAssetQR');//Script Include which stores data to be presented when QR-Code is Scanned
7+
ga.addParam('sysparm_name', 'getAssetQRData');
8+
ga.addParam('sysparm_sys_id', sys_id);
9+
10+
ga.getXMLAnswer(function(response) {
11+
var qrData = response;
12+
var qrURL = 'https://qrickit.com/api/qr.php?d=' + encodeURIComponent(qrData) + '&addtext=Get Asset Data';
13+
//QrIckit is a tool using which Customized QR-Codes can be generated
14+
var modalHTML = `
15+
<div style="text-align:center">
16+
<img id="qrCodeImage" src="${qrURL}" alt="QR Code" style="margin-bottom:10px;" />
17+
<p>Scan to view asset details</p>
18+
</div>
19+
`;
20+
21+
var gModal = new GlideModal("QR Code");
22+
gModal.setTitle('Asset QR Code');
23+
gModal.setWidth(500);
24+
gModal.renderWithContent(modalHTML);
25+
});
26+
}
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
**Calculate the due date based on the Priority**
2+
3+
Script Type: UI Action, Table: incident, Form button: True, Show update: True, Condition: (current.due_date == '' && current.priority != '5'), OnClick: functionName()
4+
5+
Script Type: Script Include, Glide AJAX enabled: False
6+
7+
Schedule- Name: Holidays, Time Zone: GMT
8+
9+
Schedule Entry - Name: New Year's Day, Type: Exclude, Show as: Busy, When: 31-12-2024, To: 01-01-2025
10+
Schedule Entry - Name: Christmas Day, Type: Exclude, Show as: Busy, When: 24-12-2025, To: 25-12-2025
11+
Schedule Entry - Name: Thanksgiving Day, Type: Exclude, Show as: Busy, When: 26-11-2025, To: 27-11-2025
12+
Schedule Entry - Name: Diwali, Type: Exclude, Show as: Busy, When: 19-10-2025, To: 20-10-2025
13+
14+
**Goal:** To Calculate Due-Date based on Priority with some conditions.
15+
16+
**Walk through of code:** So in this use case the UI Action is been used and then Script Include for server calculate is used.So the main to calculate the due-date by the user trigger.
17+
18+
UI Action- So this button will check the priority and check the due date field is empty or not if not then will fetch the value of "Priority" and "Created date" and pass the data to the Script Include for calculation once it gets the response will populate the value to the due_date field in the incident table and then update it.
19+
20+
Script Include- The role of this is to get the "Priority" and "Created date" based on prioriy this will calculate the time and date by using th GlidDateTime API and the will do some additional changes based on each priorit which is mentioned below and then return the response back to the UI Action,
21+
22+
Schedule & Schedule Entry- It is used for the P3 and P4 Priority which is mentioned below for the use case.To exclude the Holidays.
23+
24+
These are the use case which the above functionality works,
25+
26+
**1-> P1** - add 4hrs to the Created date
27+
**2-> P2 **- add 4hrs to the Created date but if it's exceed the working hrs of of 5 PM the add to the next day or if the is before the working hours of 8 AM set 5 PM to the same Created date.
28+
**3-> P3 or P4** - Kind of low priority so add the due date to the next day but it should exclude the holidays and the weekend's and the populate the next business working day.
29+
**4-> P5 **- User manually will populate the due date based on the process.
30+
31+
The UI Action on the Incident Form
32+
<img width="815" height="382" alt="Button" src="https://github.com/user-attachments/assets/68876b10-e6e0-43b9-9ecf-f6eb95b7ef87" />
33+
34+
UI Action which will call the Script Include
35+
<img width="556" height="425" alt="UI Action" src="https://github.com/user-attachments/assets/2715232a-000b-4520-8b1a-f5bf72afdaa9" />
36+
37+
Script Include
38+
<img width="817" height="416" alt="SI" src="https://github.com/user-attachments/assets/5ddb332c-d23f-4746-b014-1a71acb59186" />
39+
40+
Schedules and Schedule Entry
41+
<img width="839" height="431" alt="Schedules" src="https://github.com/user-attachments/assets/f96ea4dc-e2d4-4d8f-87b7-67df66a2d8af" />
42+
<img width="917" height="370" alt="Schedule Entry" src="https://github.com/user-attachments/assets/c4fec5ce-8ee4-46cc-8673-2d22a27290f1" />
43+
44+
Output
45+
<img width="828" height="356" alt="Priority 1" src="https://github.com/user-attachments/assets/7f4049b6-294e-4064-bab1-e2d1ab938bfd" />
46+
<img width="817" height="416" alt="Priority 2" src="https://github.com/user-attachments/assets/37f0cffd-f05c-4f4d-bf35-36090f02ee3b" />
47+
<img width="815" height="334" alt="Priority 4" src="https://github.com/user-attachments/assets/0ab4ab27-4726-4ea7-b99e-7e35f9b0f4c7" />
Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,94 @@
1+
/*
2+
3+
Input
4+
1. Created Date
5+
2. Priority
6+
7+
Output
8+
1. Due Date
9+
10+
Based on Priority equivalent due dates
11+
12+
P1 - add 4hrs to the Created date
13+
P2 - add 4hrs to the Created date but if it's exceed the working hrs of of 5 PM the add to the next day or if the is before the working hours of 8 AM set 5 PM to the same Created date.
14+
P3 or P4 - Kind of low priority so add the due date to the next day but it should exclude the holidays and the weekend's and the populate the next business working day.
15+
16+
*/
17+
18+
19+
// This SI findDueDate() function will help to calculate the duration based on the each priority.
20+
21+
var CalculateDueDates = Class.create();
22+
CalculateDueDates.prototype = {
23+
initialize: function() {},
24+
25+
findDueDate: function(priority, created) {
26+
var dueDateVal;
27+
28+
29+
// For the Priority 1 and adding 4 hours in reagrd less of 8-5 working hours and then holidays
30+
if (priority == 1) {
31+
var now = new GlideDateTime(created);
32+
now.addSeconds(60 * 60 * 4); // Add 4 hours
33+
dueDateVal = now;
34+
return dueDateVal;
35+
36+
}
37+
38+
// For the Priority 2 and adding the 4 hours if exceed the workin hours then add the next day before 5'o Clock
39+
else if (priority == 2) {
40+
var dueDate = new GlideDateTime(created);
41+
dueDate.addSeconds(60 * 60 * 4); // Add 4 hours
42+
dueDate = dueDate+'';
43+
var hours = Number((dueDate + '').slice(11, 13));
44+
45+
if (hours >= 0 && hours < 12) {
46+
gs.addInfoMessage('if Inside 8-5/7');
47+
dueDateVal = dueDate.slice(0, 10) + " 17:00:00";
48+
return dueDateVal;
49+
50+
} else if (hours >= 17 && hours <= 23) {
51+
var nextDate = new GlideDateTime(created);
52+
nextDate.addDaysUTC(1);
53+
var newDue = new GlideDateTime(nextDate.getDate().getValue() + " 17:00:00");
54+
dueDateVal = newDue;
55+
return dueDateVal;
56+
} else {
57+
dueDateVal = dueDate;
58+
return dueDateVal;
59+
}
60+
61+
}
62+
63+
// For the Priority 3 or 4 add the next day and then if the due date is holiday or weekend populate the next working day in a respective field
64+
else if (priority == 3 || priority == 4) {
65+
var schedule = new GlideSchedule();
66+
// cmn_schedule for the Holidays
67+
var scheduleId = 'bd6d74b2c3fc72104f7371edd40131b7';
68+
schedule.load(scheduleId);
69+
70+
var nextDay = new GlideDateTime(created);
71+
nextDay.addDaysUTC(1);
72+
73+
74+
//Checking for weekends
75+
var dayOfWeek = nextDay.getDayOfWeekUTC();
76+
77+
var isWeekend = (dayOfWeek == 6 || dayOfWeek == 7);
78+
79+
80+
// Loop until next working day (weekdays excluding holidays)
81+
while (schedule.isInSchedule(nextDay) || isWeekend) {
82+
nextDay.addDaysUTC(1);
83+
dayOfWeek = nextDay.getDayOfWeekUTC();
84+
isWeekend = (dayOfWeek == 6 || dayOfWeek == 7);
85+
}
86+
87+
// Set to 12:00 PM on that valid day
88+
var validDate = new GlideDateTime(nextDay.getDate().getValue() + " 17:00:00");
89+
return validDate;
90+
}
91+
},
92+
93+
type: 'CalculateDueDates'
94+
};
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
/*
2+
Table - incident
3+
Show Update - True
4+
Form Button - True
5+
Condition - (current.due_date == '' && current.priority != '5')
6+
7+
Input
8+
1. Created Date
9+
2. Priority
10+
11+
Validation
12+
Will not appeare if the value is already there and the priority is 5
13+
14+
Output
15+
1. Due Date
16+
17+
*/
18+
19+
20+
// The function duedate is used to pass the priority and then created display value to the script include where the calculate of Due date is done will get the response and the set the value to the due_date field of incident.
21+
function duedate() {
22+
23+
var priority = current.getValue('priority');
24+
var created = current.getDisplayValue('sys_created_on');
25+
var si = new CalculateDueDates();
26+
var response = si.findDueDate(priority, created);
27+
var gdt = new GlideDateTime();
28+
gdt.setDisplayValue(response);
29+
current.setValue('due_date', gdt);
30+
current.update();
31+
action.setRedirectURL(current);
32+
33+
}
34+
duedate();

0 commit comments

Comments
 (0)