hr_Utils - Scoped

The hr_Utils API provides basic functionality for the Human Resource (HR) application.

This API requires the HR core plugin (com.sn_hr_core) and runs in the sn_hr_core namespace.

hr_Utils - hr_Utils()

Instantiates an instance of the hr_Utils class.

Tableau 1. Parameters

Name	Type	Description
None

hr_Utils - getPrimaryJob(String userId)

Gets the Sys ID of the active primary job for a provided user.

Tableau 2. Parameters

Name	Type	Description
userID	String	Sys ID of the HR user from the User [sys_user] table assigned an active or future job in which Primary is true.

Tableau 3. Returns

Type	Description
String	If present and active, Sys ID of the primary job from the Jobs [sn_hr_core_job] table, null otherwise.

var result = new sn_hr_core.hr_Utils().getPrimaryJob('5137153cc611227c000bbd1bd8cd2007');
gs.info('Result: ' + result);

Output:

Result: eb3c69463cd63740964fb8b1ce04f9ae

hr_Utils - switchPrimaryJob(String userId String jobId)

Switches the primary job of a user.

Tableau 4. Parameters

Name	Type	Description
userId	String	Sys ID of HR user from the Users [sys_user] table.
jobId	String	Job Sys ID from the Jobs [sn_hr_core_job] table.

Tableau 5. Returns

Type	Description
String	Encoded JSON with message and status, error otherwise.

var result = new sn_hr_core.hr_Utils().switchPrimaryJob('5137153cc611227c000bbd1bd8cd2007', 'bc884e723c0ebf00964fb8b1ce04f9d7');
gs.info('Result: ' + result);

Output:

Result: {"message":"Switched primary job for the user successfully","status":"success"}