Client Scripts

// onLoad example: hide resolution fields when opening a new incident
function onLoad() {
    var state = g_form.getValue('state');
    // If state is not Resolved, hide resolution code
    if (state != '6') {
        g_form.setVisible('close_code', false);
        g_form.setVisible('close_notes', false);
    }
}

// onChange example: show resolution fields when state changes to Resolved
function onChange(control, oldValue, newValue, isLoading, isTemplate) {
    // ALWAYS include this guard — prevents firing on form load
    if (isLoading) return;
    if (isTemplate) return;

    if (newValue == '6') { // 6 = Resolved
        g_form.setVisible('close_code', true);
        g_form.setMandatory('close_code', true);
        g_form.setVisible('close_notes', true);
        g_form.setMandatory('close_notes', true);
    } else {
        g_form.setVisible('close_code', false);
        g_form.setMandatory('close_code', false);
        g_form.setVisible('close_notes', false);
        g_form.setMandatory('close_notes', false);
    }
}

// onSubmit example: prevent save if priority is Critical but no manager approval
function onSubmit() {
    var priority = g_form.getValue('priority');
    var approvalState = g_form.getValue('approval');

    if (priority == '1' && approvalState != 'approved') {
        g_form.addErrorMessage('Critical priority incidents require manager approval before saving.');
        return false; // Cancel the save — user stays on the form
    }
    // Returning true (or nothing) allows the save to proceed
    return true;
}

// onLoad example: customize form based on current user's role
function onLoad() {
    // Show the "Assigned to" field as read-only for non-ITIL users
    if (!g_user.hasRole('itil')) {
        g_form.setReadOnly('assigned_to', true);
        g_form.setReadOnly('assignment_group', true);
    }

    // Pre-fill caller with current user if this is a new record
    if (g_form.isNewRecord()) {
        g_form.setValue('caller_id', g_user.userID);
    }
}

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
    // Standard guard — skip if firing during initial form load
    if (isLoading) return;
    if (isTemplate) return;  // Optional: also skip template population

    // Your logic only runs on genuine user-driven field changes
    if (newValue == 'some_value') {
        g_form.setMandatory('another_field', true);
    } else {
        g_form.setMandatory('another_field', false);
    }
}

// Script Include: AssignmentGroupAjax
// Table: sys_script_include
// Name: AssignmentGroupAjax
// Client callable: CHECKED (must be true)
// Extends: AbstractAjaxProcessor

var AssignmentGroupAjax = Class.create();
AssignmentGroupAjax.prototype = Object.extendsObject(AbstractAjaxProcessor, {
    // This method will be called from the client
    getGroupManager: function() {
        // Read the parameter sent from the client
        var groupId = this.getParameter('sysparm_group_id');

        var gr = new GlideRecord('sys_user_group');
        if (gr.get(groupId)) {
            var managerName = gr.getDisplayValue('manager');
            this.setAnswer(managerName); // Send result back to client
        } else {
            this.setAnswer('Unknown');
        }
    },

    type: 'AssignmentGroupAjax'
});

// Client Script (onChange for assignment_group field)
function onChange(control, oldValue, newValue, isLoading, isTemplate) {
    if (isLoading) return;
    if (!newValue) return;

    // Step 1: Create a GlideAjax object, naming the Script Include
    var ga = new GlideAjax('AssignmentGroupAjax');

    // Step 2: Specify which method in the Script Include to call
    ga.addParam('sysparm_name', 'getGroupManager');

    // Step 3: Pass parameters to the server method
    ga.addParam('sysparm_group_id', newValue);

    // Step 4: Send the async request with a callback function
    // ALL logic using the result goes INSIDE the callback
    ga.getXML(function(response) {
        // The callback fires when the server responds
        var answer = response.responseXML.documentElement.getAttribute('answer');
        g_form.addInfoMessage('Group Manager: ' + answer);
    });

    // NOTE: Any code here runs BEFORE the callback fires
    // Do NOT try to use the result outside the callback
}

// Client-callable Script Include template
// Name: MyAjaxHelper
// Client callable: true  (MUST be checked)
// Extends: AbstractAjaxProcessor

var MyAjaxHelper = Class.create();
MyAjaxHelper.prototype = Object.extendsObject(AbstractAjaxProcessor, {

    // Public method callable from client via sysparm_name parameter
    lookupSomeValue: function() {
        var inputParam = this.getParameter('sysparm_my_input');

        // Perform server-side logic (GlideRecord, etc.)
        var gr = new GlideRecord('some_table');
        gr.addQuery('some_field', inputParam);
        gr.setLimit(1);
        gr.query();

        if (gr.next()) {
            this.setAnswer(gr.getValue('result_field'));
        } else {
            this.setAnswer('');
        }
        // Do NOT return a value — use setAnswer()
    },

    type: 'MyAjaxHelper'
});