Employee Change Request
This topic describes a feature that is currently available only in some customer accounts. For information about the availability of this feature for your account, please contact your NetSuite account manager.
Employee Change Requests allow managers to initiate requests for changes to their employees in NetSuite. Employee change request types must be set up and assigned to an employee change reason. Managers can initiate an employee change request for their direct reports in the Employee Center and have it go through an approval process which you can define in SuiteFlow. Approvers can approve or decline employee change requests and approved requests will be reflected in the employee's record on a proposed future date. For more information about employee change requests, see Employee Change Requests.
The internal ID for this record is employeechangerequest
.
See the SuiteScript Records Browser for all internal IDs associated with this record.
For information about using the SuiteScript Records Browser, see Working with the SuiteScript Records Browser in the NetSuite Help Center.
For information about scripting with this record in SuiteScript, see the following help topics:
Prerequisites
To use the employee change request record, you must enable and set up the Employee Change Requests, Effective Dating, and Advanced Employee Permissions features at Setup > Company > Enable Features, on the Employees tab. To create an employee change request approval workflow in SuiteFlow, you must also enable the SuiteFlow feature at Setup > Company > Enable Features, on the SuiteCloud tab.
Supported Script Types
The employee change request record is scriptable in both client and server SuiteScript.
Field IDs
Field Label |
Internal ID |
Type |
---|---|---|
Justification |
justification |
text |
Requester |
requester |
select |
Proposed Date |
proposeddate |
date |
Next Approver |
nextapprover |
select |
Request Status |
requeststatus |
select |
Inactive |
isinactive |
checkbox |
Change Type |
employeechangerequesttype |
select |
Declining Reason |
decliningreason |
text |
Declined By |
declinedby |
select |
Supported Functions
The following SuiteScript functionality is supported:
-
Read
-
Create
-
Update
-
Delete
-
Search
Copy and transform are not supported.
Usage Notes
The following fields cannot be edited and are only available on create:
-
requester
-
employee
-
<requested fields>
Code Samples
The proposeddate field syntax must match the format you have chosen in your company settings. Go to Setup > Company > Preferences > General Preferences to configure your Date Format.
The following sample shows how to create an employee change request.
require(['N/record'], function(record){
var empChangeReq = record.create({
type : record.Type.EMPLOYEE_CHANGE_REQUEST
});
empChangeReq.setValue({
fieldId : 'employeechangerequesttype',
value: '1'
});
empChangeReq.setText({
fieldId : 'proposeddate',
text: '10/10/2020'
});
empChangeReq.setValue({
fieldId : 'justification',
value: 'Justification'
});
empChangeReq.setValue({
fieldId : 'employee',
value: '854'
});
empChangeReq.save();
});