hr_Utils - Scoped

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:2分
  • 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.

    表 : 1. Parameters
    Name Type Description
    None

    hr_Utils - getPrimaryJob(String userId)

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

    表 : 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.
    表 : 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.

    表 : 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.
    表 : 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"}