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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideUser - 전역

# GlideUser - 전역 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 10분

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

GlideUser API를 사용하면 사용자 정보를 얻기 위해 더 느린 GlideRecord 쿼리를 사용할 필요가 없습니다.

## GlideUser - getCompanyID() {#ariaid-title2}

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

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

{#GUser-getCompanyID__table_vmc_n33_xz} {#GUser-getCompanyID__table_wmc_n33_xz__entry__2}

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

{#GUser-getCompanyID__table_wmc_n33_xz}  

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

### 범위가 지정된 등가 {#GUser-getCompanyID__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getCompanyID() 메서드를 사용하려면 해당 범위 지정 메서드인 [getCompanyID()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_ScopedGlideUserGetCompanyID "현재 사용자의 회사 sys_id 반환합니다.")를 사용합니다.

## GlideUser - getDisplayName() {#ariaid-title3}

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

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

{#GUser-getDisplayName__table_qqh_mh3_xz} {#GUser-getDisplayName__table_rqh_mh3_xz__entry__2}

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

{#GUser-getDisplayName__table_rqh_mh3_xz}  

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

### 범위가 지정된 등가 {#GUser-getDisplayName__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getDisplayName() 메서드를 사용하려면 해당 범위 지정 메서드인 [getDisplayName()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_ScopedGlideUserGetDisplayName "현재 사용자의 표시 이름을 반환합니다.")을 사용합니다.

## GlideUser - getDomainDisplayValue() {#ariaid-title4}

사용자의 세션 도메인의 표시 값을 반환합니다.
{#GUser-getDomainDisplayValue__table_wrr_hlg_zz__entry__3}

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

{#GUser-getDomainDisplayValue__table_wrr_hlg_zz} {#GUser-getDomainDisplayValue__table_xrr_hlg_zz__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자 세션 도메인의 표시 값입니다. |
[표 6. 반환]

{#GUser-getDomainDisplayValue__table_xrr_hlg_zz}  

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

### 범위가 지정된 등가 {#GUser-getDomainDisplayValue__section_oy2_nts_mcb}

범위가 지정된 애플리케이션에 대한 임시 해결책은 없습니다.

## GlideUser - getDomainID() {#ariaid-title5}

사용자의 현재 세션 도메인의 식별자를 반환합니다.
반환되는 식별자는 도메인 유형과 해당 도메인의 인스턴스화에 따라 달라집니다.  
* 사용자가 전역 도메인에 구성되어 있고 도메인 선택기를 사용하여 도메인을 전환하지 않는 경우 메서드는 null을 반환합니다.
* 사용자가 도메인 선택기를 사용하여 전역 도메인으로 전환하는 경우 메서드는 문자열 "global"을 반환합니다.
* 다른 모든 도메인의 경우 메서드는 해당 도메인의 sys_id 반환합니다.
{#GUser-getDomainID__ul_l4v_kc1_pfb}
{#GUser-getDomainID__table_trl_lzz_4fb__entry__3}

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

{#GUser-getDomainID__table_trl_lzz_4fb} {#GUser-getDomainID__table_url_lzz_4fb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 도메인 식별자입니다. |
[표 8. 반환]

{#GUser-getDomainID__table_url_lzz_4fb}  

    var domain = new GlideRecord('domain');
    domain.get(gs.getUser().getDomainID());
    gs.info(domain.name);

## GlideUser - getEmail() {#ariaid-title6}

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

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

{#GUser-getEmail__table_nxz_qg3_xz} {#GUser-getEmail__table_oxz_qg3_xz__entry__2}

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

{#GUser-getEmail__table_oxz_qg3_xz}  

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

### 범위가 지정된 등가 {#GUser-getEmail__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getEmail() 메서드를 사용하려면 해당 범위 지정 메서드인 [getEmail()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_SGU-getEmail "사용자의 이메일 주소를 반환합니다.")을 사용합니다.

## GlideUser - getFirstName() {#ariaid-title7}

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

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

{#GUser-getFirstName__table_mjs_zb3_xz} {#GUser-getFirstName__table_njs_zb3_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 객체/문자열 | 사용자의 이름입니다. 주: 반환된 값의 데이터 형식은 object이지만 정보는 문자열로 반환됩니다. |
[표 12. 반환]

{#GUser-getFirstName__table_njs_zb3_xz}  

    var currentUser = gs.getUser(); 
    var userName = currentUser.getFirstName();
    gs.info('User First Name: + userName);
    gs.info('Data type: ' + typeof userName);

    *** Script: User First Name: John
    *** Script: Data type: object

### 범위가 지정된 등가 {#GUser-getFirstName__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getFirstName() 메서드를 사용하려면 해당 범위 지정 메서드인 [getFirstName()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_SGU-getFirstName "사용자의 이름을 반환합니다.")을 사용합니다.

## GlideUser - getID {#ariaid-title8}

현재 사용자의 sys_id 반환합니다.
{#GUser-getID__table_vtq_4xh_xz__entry__3}

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

{#GUser-getID__table_vtq_4xh_xz} {#GUser-getID__table_wtq_4xh_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자의 sys_id |
[표 14. 반환]

{#GUser-getID__table_wtq_4xh_xz}  

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

### 범위가 지정된 등가 {#GUser-getID__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getID() 메서드를 사용하려면 해당 범위 지정 메서드인 [getID()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_ScopedGlideUserGetID "현재 사용자의 sys_id 가져옵니다.")를 사용합니다.

## GlideUser - getLastName() {#ariaid-title9}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 15. 매개변수]

{#GUser-getLastName__table_agq_1g3_xz} {#GUser-getLastName__table_bgq_1g3_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 객체/문자열 | 사용자의 성입니다. 주: 반환된 값의 데이터 형식은 object이지만 정보는 문자열로 반환됩니다. |
[표 16. 반환]

{#GUser-getLastName__table_bgq_1g3_xz}  

    var currentUser = gs.getUser(); 
    var userName = currentUser.getLastName();
    gs.info('User Last Name: + userName);
    gs.info('Data type: ' + typeof userName);

    *** Script: User Last Name: Smith
    *** Script: Data type: object

### 범위가 지정된 등가 {#GUser-getLastName__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getLastName() 메서드를 사용하려면 해당 범위 지정 메서드인 [getLastName()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_SGU-getLastName "사용자의 성을 반환합니다.")을 사용합니다.

## GlideUser - getMyGroups() {#ariaid-title10}

사용자가 속한 모든 그룹의 목록을 포함하는 반복기를 반환합니다. 활성 그룹만 반환됩니다.
{#GUser-getMyGroups__table_llp_tc5_5bb__entry__3}

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

{#GUser-getMyGroups__table_llp_tc5_5bb} {#GUser-getMyGroups__table_mlp_tc5_5bb__entry__2}

| 유형 | 설명 |
|-|-|
| 반복기 | 사용자가 속한 활성 그룹의 sys_ids 목록입니다. |
[표 18. 반환]

{#GUser-getMyGroups__table_mlp_tc5_5bb}  
다음 예제에서는 사용자가 속한 그룹 목록을 반환하는 방법을 보여 줍니다.

    var groupsArray = gs.getUser().getMyGroups().toArray();
    gs.info(groupsArray[0]);

출력:

    cfcbad03d711110050f5edcb9e61038f

### 범위가 지정된 등가 {#GUser-getMyGroups__section_p31_wts_mcb}

이 메서드에 해당하는 범위가 없습니다.

## GlideUser - getName() {#ariaid-title11}

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

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

{#GUser-getName__table_exc_w13_xz} {#GUser-getName__table_fxc_w13_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자 ID |
[표 20. 반환]

{#GUser-getName__table_fxc_w13_xz}  

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

### 범위가 지정된 등가 {#GUser-getName__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getName() 메서드를 사용하려면 해당 범위 지정 메서드인 [getName()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_ScopedGlideUserGetName "현재 사용자의 사용자 ID 또는 로그인 이름을 반환합니다.")을 사용합니다.

## GlideUser - getRoles() {#ariaid-title12}

사용자와 연결된 역할 목록을 반환합니다. 명시적으로 부여된 역할, 상속된 역할 및 그룹 구성원으로 획득한 역할이 포함됩니다.
{#GUser-getRoles__table_ml5_q4m_xz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 21. 매개변수]

{#GUser-getRoles__table_ml5_q4m_xz} {#GUser-getRoles__table_nl5_q4m_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 쉼표로 구분된 사용자 역할 목록입니다. |
[표 22. 반환]

{#GUser-getRoles__table_nl5_q4m_xz}  

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

출력:

    admin,hr_fulfiller,itsa_fulfiller,security_admin

### 범위가 지정된 등가 {#GUser-getRoles__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getRoles() 메서드를 사용하려면 해당 범위 지정 메서드인 [getRoles()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_SGU-getRoles "명시적으로 부여된 역할, 상속된 역할 및 그룹 구성원으로 획득한 역할을 포함하는 역할 목록을 반환합니다.")를 사용합니다.

## GlideUser - getUserByID(문자열 ID) {#ariaid-title13}

전달된 사용자 ID(sys_user에서 sys_id) 또는 user_name와 연결된 사용자 객체를 반환합니다.
{#GUser-getUserByID_S__table_wsx_qkr_h2b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| id | 문자열 | 원하는 사용자 기록의 고유 ID(sys_id) 또는 user_name입니다. |
[표 23. 매개변수]

{#GUser-getUserByID_S__table_wsx_qkr_h2b} {#GUser-getUserByID_S__table_xsx_qkr_h2b__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 지정된 sys_id 또는 user_name과 연결된 사용자 객체입니다. |
[표 24. 반환]

{#GUser-getUserByID_S__table_xsx_qkr_h2b}  
사용자 이름(user_name)을 사용하는 예입니다.

    var currentUser = gs.getUser();
    gs.info(currentUser.getFirstName()); // print the first name of the logged in user
    var newUser = currentUser.getUserByID('abel.tuter'); // fetch a different user using the user_name field
    gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user 

사용자 ID(sys_id)를 사용한 예입니다.

    var currentUser = gs.getUser();
    gs.info(currentUser.getFirstName()); // print the first name of the logged in user
    var newUser = currentUser.getUserByID('62826bf03710200044e0bfc8bcbe5df1'); // fetch Abel Tuter user using sys_id from sys_user record
    gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user 

## GlideUser - getUserRoles() {#ariaid-title14}

사용자에게 명시적으로 부여된 역할 목록을 반환합니다.
{#GUser-getUserRoles__table_pkf_xnm_xz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 25. 매개변수]

{#GUser-getUserRoles__table_pkf_xnm_xz} {#GUser-getUserRoles__table_qkf_xnm_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 객체/문자열 | 사용자에게 명시적으로 할당된 쉼표로 구분된 역할 목록입니다. 주: 반환된 값의 데이터 형식은 object이지만 정보는 문자열로 반환됩니다. |
[표 26. 반환]

{#GUser-getUserRoles__table_qkf_xnm_xz}  

    var currentUser = gs.getUser(); 
    var userRoles = currentUser.getUserRoles();
    gs.info('User Roles: ' + userRoles);
    gs.info('Data type: ' + typeof userRoles);

    *** Script: User Roles: ,admin,security_admin
    *** Script: Data type: object

### 범위가 지정된 등가 {#GUser-getUserRoles__section_fzj_lyh_xz}

범위가 지정된 애플리케이션에서 getUserRoles() 메서드를 사용하려면 해당 범위 지정 메서드인 [getUserRoles()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_SGU-getUserRoles "사용자에게 명시적으로 부여된 역할 목록을 반환합니다.")를 사용합니다.

## GlideUser - hasRole(문자열 역할) {#ariaid-title15}

현재 사용자에게 지정된 역할이 있는지 확인합니다.
{#GUser-hasRole_S__table_xmz_mmm_xz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| role | 문자열 | 검사할 역할 |
[표 27. 매개변수]

{#GUser-hasRole_S__table_xmz_mmm_xz} {#GUser-hasRole_S__table_ymz_mmm_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 사용자에게 역할이 있는 경우 예입니다. |
[표 28. 반환]

{#GUser-hasRole_S__table_ymz_mmm_xz}  

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

### 범위가 지정된 등가 {#GUser-hasRole_S__section_fzj_lyh_xz}

범위가 지정된 응용 프로그램에서 hasRole() 메서드를 사용하려면 해당 범위 지정 메서드인 [hasRole()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_ScopedGlideUserHasRole_String "현재 사용자에게 지정된 역할이 있는지 확인합니다.")을 사용합니다.

## GlideUser - isExplicitMemberOf(문자열 그룹) {#ariaid-title16}

현재 사용자가 지정된 그룹의 명시적 구성원인지 여부를 확인합니다. 이 메서드에서는 활성 그룹만 평가됩니다.
isMemberOf() 메서드는 사용자가 하위 그룹의 구성원인 경우 상위 그룹에 대해 true를 반환합니다. 상위 그룹에 대해서만 true를 반환하려는 경우 이 방법을 사용합니다.
{#GUser-isExplicitMemberOf_S__table_l1q_4lm_xz__entry__3}

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

{#GUser-isExplicitMemberOf_S__table_l1q_4lm_xz} {#GUser-isExplicitMemberOf_S__table_m1q_4lm_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 사용자가 지정된 그룹의 명시적 구성원인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 현재 사용자가 지정된 그룹의 명시적 구성원입니다. * false: 현재 사용자가 지정된 그룹의 명시적 구성원이 아닙니다. {#GUser-isExplicitMemberOf_S__ul_gvv_fqf_nsb} |
[표 30. 반환]

{#GUser-isExplicitMemberOf_S__table_m1q_4lm_xz}  
다음 예제에서는 현재 사용자가 지정된 그룹의 명시적 멤버인지 확인하는 방법을 보여 줍니다.

    var isExplMem = gs.getUser().isExplicitMemberOf('b8ef24616fc331003b3c498f5d3ee434');
    gs.info(isExplMem);

출력:

    false

### 범위가 지정된 등가 {#GUser-isExplicitMemberOf_S__section_wxy_xpz_kwb}

이 메서드에 해당하는 범위가 없습니다.

## GlideUser - isMemberOf(문자열 그룹) {#ariaid-title17}

현재 사용자가 지정된 그룹의 구성원인지 확인합니다. 이 메서드에서는 활성 그룹만 평가됩니다.
이 메서드는 사용자가 자식 그룹의 구성원인 경우 부모 그룹에 대해 true를 반환합니다. 상위 그룹에 대해서만 true를 반환하려면 isExplicitMemberOf() 를 사용합니다.
{#GUser-isMemberOf_S__table_l1q_4lm_xz__entry__3}

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

{#GUser-isMemberOf_S__table_l1q_4lm_xz} {#GUser-isMemberOf_S__table_m1q_4lm_xz__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 사용자가 지정된 그룹의 구성원인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 현재 사용자가 지정된 그룹의 구성원입니다. * false: 현재 사용자가 지정된 그룹의 구성원이 아닙니다. {#GUser-isMemberOf_S__ul_gvv_fqf_nsb} |
[표 32. 반환]

{#GUser-isMemberOf_S__table_m1q_4lm_xz}  
다음 예제에서는 현재 사용자가 지정된 그룹의 구성원인지 확인하는 방법을 보여 줍니다.

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

### 범위가 지정된 등가 {#GUser-isMemberOf_S__section_fzj_lyh_xz}

범위가 지정된 응용 프로그램에서 isMemberOf() 메서드를 사용하려면 해당 범위 지정 메서드인 [isMemberOf()](https://servicenow-prod.fluidtopics.net/JvhmbQdiOfOfGhP3g3xOHg#r_ScopedGlideUserIsMemberOf_String "현재 사용자가 지정된 그룹의 구성원인지 확인합니다.")를 사용합니다.