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


---

# GlideUser - 범위 지정됨

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

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

GlideUser API는 현재 사용자 및 현재 사용자 역할에 대한 정보에 액세스하는 메서드를 제공합니다.

GlideUser API를 사용하면 느린 GlideRecord 쿼리를 사용하여 사용자 정보를 가져올 필요가 없습니다.

## 범위가 지정된 GlideUser - getCompanyID() {#ariaid-title2}

현재 사용자의 회사 sys_id 반환합니다.
{#r_ScopedGlideUserGetCompanyID__table_vx2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 1. 매개변수]

{#r_ScopedGlideUserGetCompanyID__table_vx2_525_jq} {#r_ScopedGlideUserGetCompanyID__table_qxf_p34_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 회사 sys_id. |
[표 2. 반환]

{#r_ScopedGlideUserGetCompanyID__table_qxf_p34_1r}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getCompanyID());

## 범위가 지정된 GlideUser - getDisplayName() {#ariaid-title3}

현재 사용자의 표시 이름을 반환합니다.
{#r_ScopedGlideUserGetDisplayName__table_vy2_524_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 3. 매개변수]

{#r_ScopedGlideUserGetDisplayName__table_vy2_524_jq} {#r_ScopedGlideUserGetDisplayName__table_asj_cj4_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자의 표시 이름 |
[표 4. 반환]

{#r_ScopedGlideUserGetDisplayName__table_asj_cj4_1r}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getDisplayName());

## 범위가 지정된 GlideUser - getEmail() {#ariaid-title4}

사용자의 이메일 주소를 반환합니다.
{#r_SGU-getEmail__table_syp_shb_1x__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 5. 매개변수]

{#r_SGU-getEmail__table_syp_shb_1x} {#r_SGU-getEmail__table_typ_shb_1x__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자의 이메일 주소입니다. |
[표 6. 반환]

{#r_SGU-getEmail__table_typ_shb_1x}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getEmail());

## 범위가 지정된 GlideUser - getFirstName() {#ariaid-title5}

사용자의 이름을 반환합니다.
{#r_SGU-getFirstName__table_x5k_h3b_1x__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 7. 매개변수]

{#r_SGU-getFirstName__table_x5k_h3b_1x} {#r_SGU-getFirstName__table_y5k_h3b_1x__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자의 이름입니다. |
[표 8. 반환]

{#r_SGU-getFirstName__table_y5k_h3b_1x}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getFirstName());

## 범위가 지정된 GlideUser - getID() {#ariaid-title6}

현재 사용자의 sys_id 가져옵니다.
{#r_ScopedGlideUserGetID__table_vy2_521_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 9. 매개변수]

{#r_ScopedGlideUserGetID__table_vy2_521_jq} {#r_ScopedGlideUserGetID__table_bc1_4j4_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자의 sys_id입니다. |
[표 10. 반환]

{#r_ScopedGlideUserGetID__table_bc1_4j4_1r}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getID());

## 범위가 지정된 GlideUser - getLastName() {#ariaid-title7}

사용자의 성을 반환합니다.
{#r_SGU-getLastName__table_tkm_t3b_1x__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 11. 매개변수]

{#r_SGU-getLastName__table_tkm_t3b_1x} {#r_SGU-getLastName__table_ukm_t3b_1x__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자의 성입니다. |
[표 12. 반환]

{#r_SGU-getLastName__table_ukm_t3b_1x}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getLastName());

## 범위가 지정된 GlideUser - getName() {#ariaid-title8}

현재 사용자의 사용자 ID 또는 로그인 이름을 반환합니다.
{#r_ScopedGlideUserGetName__table_vy2_525_eq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 13. 매개변수]

{#r_ScopedGlideUserGetName__table_vy2_525_eq} {#r_ScopedGlideUserGetName__table_ucq_xj4_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자 ID 또는 로그인 이름입니다. |
[표 14. 반환]

{#r_ScopedGlideUserGetName__table_ucq_xj4_1r}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getName());

## 범위가 지정된 GlideUser - getPreference(문자열 이름) {#ariaid-title9}

현재 사용자에 대해 지정된 사용자 기본 설정 값을 가져옵니다.
{#r_ScopedGlideUserGetPreference_String__table_mtf_3k4_1r__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 기본 설정의 이름입니다. |
[표 15. 매개변수]

{#r_ScopedGlideUserGetPreference_String__table_mtf_3k4_1r} {#r_ScopedGlideUserGetPreference_String__table_otf_3k4_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 기본 설정 값입니다. |
[표 16. 반환]

{#r_ScopedGlideUserGetPreference_String__table_otf_3k4_1r}  

    var currentUser = gs.getUser(); 
    currentUser.savePreference(­'myPref','red'); 
    gs.info(currentUser.getPreference(­'myPref'));

## 범위가 지정된 GlideUser - getRoles() {#ariaid-title10}

명시적으로 부여된 역할, 상속된 역할 및 그룹 구성원으로 획득한 역할을 포함하는 역할 목록을 반환합니다.
{#r_SGU-getRoles__table_ukj_xgb_1x__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 17. 매개변수]

{#r_SGU-getRoles__table_ukj_xgb_1x} {#r_SGU-getRoles__table_vkj_xgb_1x__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 사용자가 사용할 수 있는 모든 역할의 목록 |
[표 18. 반환]

{#r_SGU-getRoles__table_vkj_xgb_1x}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getRoles());

## 범위가 지정된 GlideUser - getTimeZoneLabel() {#ariaid-title11}

현재 사용자의 기본 설정 언어로 현재 사용자의 시간대 레이블을 반환합니다.
사용자의 기본 설정 언어 설정에 대한 자세한 내용은 다음 문서를 참조하십시오 [User specific language](https://www.servicenow.com/docs/access?context=r_UserSpecificLanguage&version=australia&pubname=australia-platform-administration&ft:locale=en-US).
{#GUserScoped-getTimeZoneLabel__table_mfy_jw2_bdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 19. 매개변수]

{#GUserScoped-getTimeZoneLabel__table_mfy_jw2_bdc} {#GUserScoped-getTimeZoneLabel__table_nfy_jw2_bdc__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 시간대 레이블입니다. |
[표 20. 반환]

{#GUserScoped-getTimeZoneLabel__table_nfy_jw2_bdc}  
이 예시에서는 현재 사용자의 표준 시간대 레이블을 기본 설정 언어로 반환하는 방법을 보여줍니다.

    gs.info(gs.getUser().getTimeZoneLabel());

출력:

    Europe/Dublin

## 범위가 지정된 GlideUser - getTimeZoneLabelLang(문자열 언어) {#ariaid-title12}

지정된 언어로 현재 사용자의 시간대 레이블을 반환합니다.
{#GUserScoped-getTimeZoneLabelLang_S__table_hlp_hw2_bdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 언어 | 문자열 | 시간대 레이블에 사용할 언어입니다. 언어 \[sys_language\] 테이블의 ID 열에 있습니다. 유효한 언어가 제공되지 않은 경우 시간대 레이블이 영어로 반환됩니다. |
[표 21. 매개변수]

{#GUserScoped-getTimeZoneLabelLang_S__table_hlp_hw2_bdc} {#GUserScoped-getTimeZoneLabelLang_S__table_ilp_hw2_bdc__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 시간대 레이블입니다. |
[표 22. 반환]

{#GUserScoped-getTimeZoneLabelLang_S__table_ilp_hw2_bdc}  
이 예시에서는 현재 사용자의 시간대 레이블을 지정된 언어로 반환하는 방법을 보여줍니다.

    gs.info(gs.getUser().getTimeZoneLabelLang("es")); //Spanish
    gs.info(gs.getUser().getTimeZoneLabelLang("ja")); //Japanese
    gs.info(gs.getUser().getTimeZoneLabelLang("jksjsjks")); //invalid

출력:

    Europa/Dublín
    ヨーロッパ/ダブリン
    Europe/Dublin

## 범위가 지정된 GlideUser - getUserRoles() {#ariaid-title13}

사용자에게 명시적으로 부여된 역할 목록을 반환합니다.
getRoles() 메서드와 달리 이 메서드는 사용자가 상속하는 역할이나 그룹 구성원 자격에서 획득한 역할을 반환하지 않습니다.
{#r_SGU-getUserRoles__table_jhl_yfb_1x__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 23. 매개변수]

{#r_SGU-getUserRoles__table_jhl_yfb_1x} {#r_SGU-getUserRoles__table_khl_yfb_1x__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 사용자에게 명시적으로 할당된 역할 목록입니다. |
[표 24. 반환]

{#r_SGU-getUserRoles__table_khl_yfb_1x}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getUserRoles());

## 범위가 지정된 GlideUser - hasRole(문자열 역할) {#ariaid-title14}

현재 사용자에게 지정된 역할이 있는지 여부를 결정합니다.
{#r_ScopedGlideUserHasRole_String__table_gk4_5k4_1r__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| role | 문자열 | 확인할 역할입니다. |
[표 25. 매개변수]

{#r_ScopedGlideUserHasRole_String__table_gk4_5k4_1r} {#r_ScopedGlideUserHasRole_String__table_ik4_5k4_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 사용자에게 지정된 역할이 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 사용자에게 지정된 역할이 있습니다. * 아니오: 사용자에게 지정된 역할이 없습니다. |
[표 26. 반환]

{#r_ScopedGlideUserHasRole_String__table_ik4_5k4_1r}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.hasRole('admin'));

## 범위가 지정된 GlideUser - isMemberOf(문자열 그룹) {#ariaid-title15}

현재 사용자가 지정된 그룹의 구성원인지 여부를 결정합니다.
{#r_ScopedGlideUserIsMemberOf_String__table_mck_gl4_1r__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 그룹 | 문자열 | 확인할 그룹의 Sys_id 또는 이름입니다. |
[표 27. 매개변수]

{#r_ScopedGlideUserIsMemberOf_String__table_mck_gl4_1r} {#r_ScopedGlideUserIsMemberOf_String__table_ock_gl4_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 사용자가 지정된 그룹의 구성원인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 사용자가 그룹의 구성원입니다. * false: 사용자가 그룹의 구성원이 아닙니다. {#r_ScopedGlideUserIsMemberOf_String__ul_ytn_2bf_z1c} |
[표 28. 반환]

{#r_ScopedGlideUserIsMemberOf_String__table_ock_gl4_1r}  
다음 예시에서는 현재 사용자가 용량 관리 그룹의 구성원인지 확인합니다.

    var currentUser = gs.getUser(); 
    gs.info(currentUser.isMemberOf('Capacity Mgmt'));

출력:

    false

## 범위가 지정된 GlideUser - savePreference(문자열 이름, 문자열 값) {#ariaid-title16}

사용자 기본 설정 값을 데이터베이스에 저장합니다.
{#r_ScopedGlideUserSavePreference_String_String__table_wyt_rl4_1r__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 저장할 기본 설정입니다. |
| 값 | 문자열 | 기본 설정 값입니다. |
[표 29. 매개변수]

{#r_ScopedGlideUserSavePreference_String_String__table_wyt_rl4_1r} {#r_ScopedGlideUserSavePreference_String_String__table_xyt_rl4_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 안 함 |   |
[표 30. 반환]

{#r_ScopedGlideUserSavePreference_String_String__table_xyt_rl4_1r}  

    var currentUser = gs.getUser(); 
    currentUser.savePreference('myPref','red'); 
    gs.info(currentUser.getPreference('myPref'));