Scripts & Functions — Deep Dive (Interview Reference)

شرح كل الدوال في تطبيقنا + أهم APIs في ServiceNow للمقابلة.
الأسلوب: عربية + إنجليزية تكمّلان بعضهما — بدون ترجمة حرفية لأسماء الشاشات.

Part 1 — Our Script Includes (line-by-line purpose)

HRLXProLeaveUtilsV2

File: src/server/script_includes/HRLXProLeaveUtilsV2.js

Interview: Why GlideAggregate for _sumApprovedDays? — أفضل أداء من loop على GlideRecord — يجمع على الخادم.

HRLXProSecurityUtilsV2

File: src/server/script_includes/HRLXProSecurityUtilsV2.js

Used in: ACL scripts (src/security/acls.md).

HRLXProIntegrationUtilsV2

File: src/server/script_includes/HRLXProIntegrationUtilsV2.js

Part 2 — Our Business Rules

BR2 event example:

gs.eventQueue('x_786686_hr_leave.leave_v2.submitted', current,
 current.getValue('u_approver_user'), current.getValue('u_number'));

Interview: Why after for BR2 not before? — لأننا نريد التأكد أن السجل حُفظ بحالة submitted قبل إطلاق الإشعار.

Part 3 — Server-Side API (gs.*) — Interview Must-Know

Part 4 — GlideRecord patterns

var gr = new GlideRecord('table');
gr.addQuery('field', 'value');
gr.addActiveQuery(); // active=true
gr.orderByDesc('sys_created_on');
gr.setLimit(1);
gr.query();
if (gr.next()) {
 gr.field = 'newValue';
 gr.update();
}

// Insert
gr.initialize();
gr.field = ‘x’;
var sysId = gr.insert();

// Secure (respects ACL)
var grs = new GlideRecordSecure(‘table’);

Interview: When use GlideRecordSecure? — Service Portal، multi-tenant، أي سياق المستخدم النهائي.

Part 5 — GlideAggregate

var ga = new GlideAggregate('x_786686_hr_leave_req_v2');
ga.addQuery('u_state', 'approved');
ga.addAggregate('SUM', 'u_days_count');
ga.query();
if (ga.next()) {
 var sum = ga.getAggregate('SUM', 'u_days_count');
}

Part 6 — Client-Side API (g_form.*)

onSubmit:

function onSubmit() {
 if (invalid) {
 g_form.addErrorMessage('Fix dates');
 return false; // blocks save
 }
}

Part 7 — GlideAjax (client → server)

var ga = new GlideAjax('ScriptIncludeName');
ga.addParam('sysparm_name', 'methodName');
ga.addParam('sysparm_custom', value);
ga.getXMLAnswer(function(response) {
 // response is string return value
});

Requirements: Script Include must be Client callable + extend AbstractAjaxProcessor (or have sysparm_name handler).

Part 8 — REST (inbound/outbound)

Inbound (Scripted REST):

(function process(request, response) {
 var body = request.body.data;
 response.setStatus(201);
 response.setBody({ sys_id: '...' });
})(request, response);

Outbound (RESTMessageV2):

var rm = new sn_ws.RESTMessageV2('REST Message Name', 'POST method');
rm.setRequestBody(JSON.stringify(payload));
var res = rm.execute();
var status = res.getStatusCode();

Part 9 — Portal Widget server.js pattern

(function() {
 data.items = [];
 var gr = new GlideRecordSecure('x_786686_hr_leave_req_v2');
 gr.addQuery('u_requested_for_user', gs.getUserID());
 gr.query();
 while (gr.next()) {
 data.items.push({
 number: gr.getDisplayValue('u_number'),
 state: gr.getDisplayValue('u_state')
 });
 }
})();

Part 10 — Common interview “write this script” scenarios

1. Set assignment group by category:

if (current.category == 'network')
 current.assignment_group.setDisplayValue('Network');

2. Prevent save if field empty:

if (!current.u_reason) {
 gs.addErrorMessage('Reason required');
 current.setAbortAction(true);
}

3. Copy manager to approver:

Same as setApproverFromEmployee in our app.

4. Query related records:

var child = new GlideRecord('child_table');
child.addQuery('parent', current.sys_id);
child.query();

Part 11 — Where each script type lives (navigation)

Part 12 — Link to full development guide

File: ../01_DEVELOPMENT.md — every artifact explained with options.

File: 00_MASTER_DEV_ADMIN_INTERVIEW.md — platform + admin tour.