hr_Utils: スコープ対象

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：2分

    • hr_Utils API は、ヒューマンリソース (HR) アプリケーションの基本機能を提供します。

    この API は HR コアプラグイン (com.sn_hr_core) を必要とし、 sn_hr_core 名前空間で実行されます。

    hr_Utils:hr_Utils()

    hr_Utils クラスのインスタンスをインスタンス化します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし

    hr_Utils:getPrimaryJob(文字列 userId)

    指定されたユーザーのアクティブなプライマリジョブの Sys ID を取得します。

    表 : 2. パラメーター
    名前 タイプ 説明
    userID 文字列 [プライマリ] が true であるアクティブまたは将来のジョブにアサインされているユーザー [sys_user] テーブルの HR ユーザーの Sys ID。
    表 : 3. 返される内容
    タイプ 説明
    文字列 存在し、アクティブな場合は、ジョブ [sn_hr_core_job] テーブルのプライマリジョブの Sys ID。それ以外の場合は null です。 
    var result = new sn_hr_core.hr_Utils().getPrimaryJob('5137153cc611227c000bbd1bd8cd2007');
gs.info('Result: ' + result);

    出力:

    Result: eb3c69463cd63740964fb8b1ce04f9ae

    hr_Utils:switchPrimaryJob(文字列 userId 文字列 jobId)

    ユーザーの主要な職務を切り替えます。

    表 : 4. パラメーター
    名前 タイプ 説明
    userId 文字列 ユーザー [sys_user] テーブルの HR ユーザーの Sys ID です。
    jobId 文字列 ジョブ [sn_hr_core_job] テーブルのジョブ Sys ID。
    表 : 5. 返される内容
    タイプ 説明
    文字列 メッセージとステータスを含むエンコードされた JSON。それ以外の場合はエラー。 
    var result = new sn_hr_core.hr_Utils().switchPrimaryJob('5137153cc611227c000bbd1bd8cd2007', 'bc884e723c0ebf00964fb8b1ce04f9d7');
gs.info('Result: ' + result);

    出力:

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