---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# hr_Utils - スコープ指定

# hr_Utils - スコープ指定 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

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

この API には HR Core プラグイン (com.sn_hr_core) が必要で、 `sn_hr_core` 名前空間で実行されます。

## hr_Utils - hr_Utils() {#ariaid-title2}

hr_Utils クラスのインスタンスを作成します。
{#hrU-hr_Utils__table_wyr_ql2_vhb__entry__3}

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

{#hrU-hr_Utils__table_wyr_ql2_vhb}

## hr_Utils - getPrimaryJob(文字列 userId) {#ariaid-title3}

指定されたユーザーのアクティブな主要な職務のSys ID を取得します。
{#hrU-getPrimaryJob_S__table_jsg_hn2_vhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| userID | 文字列 | プライマリが true になっているアクティブなジョブまたは将来のジョブにアサインされたユーザー \[sys_user\] テーブルの人事ユーザーのSys ID。 |
[表 : 2. パラメーター]

{#hrU-getPrimaryJob_S__table_jsg_hn2_vhb} {#hrU-getPrimaryJob_S__table_ksg_hn2_vhb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | ジョブ \[sn_hr_core_job\] テーブルの主要な職務 (存在していてアクティブな場合) のSys ID。存在しない、またはアクティブでない場合は null。 |
[表 : 3. 返される内容]

{#hrU-getPrimaryJob_S__table_ksg_hn2_vhb}  

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

出力：

    Result: eb3c69463cd63740964fb8b1ce04f9ae

## hr_Utils - switchPrimaryJob(文字列 userId, 文字列 jobId) {#ariaid-title4}

ユーザーの主要な職務を切り替えます。
{#hrU-switchPrimaryJob_S_S__table_jz3_jn2_vhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| userId | 文字列 | ユーザー \[sys_user\] テーブル内の人事ユーザーのSys ID。 |
| jobId | 文字列 | ジョブ \[sn_hr_core_job\] テーブルのジョブのSys ID。 |
[表 : 4. パラメーター]

{#hrU-switchPrimaryJob_S_S__table_jz3_jn2_vhb} {#hrU-switchPrimaryJob_S_S__table_kz3_jn2_vhb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | メッセージとステータスを含むエンコードされた JSON。それ以外の場合はエラー。 |
[表 : 5. 返される内容]

{#hrU-switchPrimaryJob_S_S__table_kz3_jn2_vhb}  

    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"}