---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# hr_Utils - 범위 지정됨

# hr_Utils - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 1분

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}

제공된 사용자에 대한 활성 기본 작업의 시스템 ID를 가져옵니다.
{#hrU-getPrimaryJob_S__table_jsg_hn2_vhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| userID | 문자열 | 기본이 예인 활성 또는 미래 작업이 할당된 사용자 \[sys_user\] 테이블의 HR 사용자 시스템 ID입니다. |
[표 2. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | 존재하고 활성 상태인 경우 작업 \[sn_hr_core_job\] 테이블의 기본 작업 시스템 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\] 테이블의 HR 사용자 시스템 ID입니다. |
| jobId | 문자열 | 작업 \[sn_hr_core_job\] 테이블의 작업 시스템 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"}