---
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) 소요 시간: 6분

GlideUser API는 현재 사용자 및 현재 사용자 역할에 대한 정보에 액세스하는 메서드를 제공합니다. 이 API를 사용하면 사용자 정보를 얻기 위해 더 느린 GlideRecord 쿼리를 사용할 필요가 없습니다.

GlideUser 메서드 및 속성은 클라이언트 스크립트에서만 사용할 수 있는 `g_user`(전역 객체)를 통해 액세스됩니다.  
이 API의 특징은 다음과 같습니다.

* 현재 사용자에 대한 이름 및 역할 정보를 포함합니다.
* 은 일반적으로 클라이언트 스크립트 및 UI 정책에서 사용되지만 클라이언트에서 실행되는 UI 작업에서도 사용됩니다.
* 서버에서 실행되는 비즈니스 규칙 또는 UI 작업에서는 사용할 수 없습니다.
{#c_GlideUserAPI__ul_bqz_wch_vs}

현재 사용자 및 현재 사용자 역할에 대한 세션 정보는 클라이언트(웹 브라우저)에 포함되어 있습니다. getClientData()를 제외한 모든 GlideUser 메서드는 기본적으로 사용할 수 있는 세션 정보에 액세스합니다. getClientData() 메서드를 사용하려면 서버에서 설정하고 putClientData() 메서드를 사용하여 세션 정보를 제공해야 합니다.

클라이언트 쪽 스크립트 사용에 대한 자세한 내용은 [클라이언트 쪽 스크립팅 소개를](https://developer.servicenow.com/dev.do#!/learn/courses/sandiego/app_store_learnv2_scripting_rome_scripting_in_servicenow/app_store_learnv2_scripting_rome_client_side_scripting/app_store_learnv2_scripting_rome_introduction_to_client_side_scripting) 참조하십시오.

## GlideUser - firstName {#ariaid-title2}

현재 사용자의 이름입니다.
{#r_GlideUserFirstName__table_yrj_5fh_vs__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 현재 사용자의 이름입니다. |
[표 1. 필드]

{#r_GlideUserFirstName__table_yrj_5fh_vs}  

    alert('first name = ' + g_user.firstName);

## GlideUser - getClientData(문자열 키) {#ariaid-title3}

setClientData() 또는 GlideSession -- putClientData()를 사용하여 설정된 클라이언트 값을 반환합니다.
세션 클라이언트 데이터는 [GlideSession -- putClientData()](https://servicenow-prod.fluidtopics.net/gST2BQlInPlkUYZnufLk1g#c_GlideSessionScopedAPI "범위가 지정된 GlideSession API는 현재 세션에 대한 정보를 찾는 메서드를 제공합니다.")를 사용하여 서버에서 설정할 수 있는 명명된 문자열 세트입니다. 양식을 로드하는 동안 getClientData() 를 사용하여 클라이언트 스크립트가 양식에 대한 결정을 내리는 데 필요한 정보를 가져올 수 있습니다. 예를 들어 표시할 필드를 식별할 수 있습니다.

[GlideForm](https://servicenow-prod.fluidtopics.net/c6EJlXXKcD6ogDdekEkrbA#c_GlideFormAPI "GlideForm API는 양식을 사용자 지정하는 메서드를 제공합니다.")도 참조하십시오.
{#r_GlideUser-getClientData_string__table_nv5_3k3_ws__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 키 | 문자열 | 검색할 클라이언트 데이터의 이름입니다. |
[표 2. 매개변수]

{#r_GlideUser-getClientData_string__table_nv5_3k3_ws} {#r_GlideUser-getClientData_string__table_ov5_3k3_ws__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 클라이언트 데이터의 값입니다. |
[표 3. 반환]

{#r_GlideUser-getClientData_string__table_ov5_3k3_ws}  

    var loginLanguage = g_user.getClientData("loginlanguage");

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

현재 사용자의 이름과 성을 반환합니다.
{#r_GlideUser-getFullName__table_pvh_cm3_ws__entry__3}

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

{#r_GlideUser-getFullName__table_pvh_cm3_ws} {#r_GlideUser-getFullName__table_qvh_cm3_ws__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 전체 이름입니다. |
[표 5. 반환]

{#r_GlideUser-getFullName__table_qvh_cm3_ws}  

    var formalName = g_user.getFullName();

## GlideUser - hasRole(문자열 역할, 부울 includeDefaults) {#ariaid-title5}

현재 사용자에게 지정된 역할 또는 관리자 역할이 있는 경우 예를 반환합니다.
{#r_GlideUser-hasRole_String__table_p1w_4m3_ws__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| role | 문자열 | 검사할 역할입니다. |
| 기본값 포함 | 부울 | 옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). 기본값: false |
[표 6. 매개변수]

{#r_GlideUser-hasRole_String__table_p1w_4m3_ws} {#r_GlideUser-hasRole_String__table_q1w_4m3_ws__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 사용자에게 지정된 역할 또는 관리자 역할이 있는 경우 예를 반환합니다. 그렇지 않으면 false를 반환합니다. |
[표 7. 반환]

{#r_GlideUser-hasRole_String__table_q1w_4m3_ws}  

    var isInternal = g_user.hasRole('snc_internal', true);

    var isItil = g_user.hasRole('itil');

## GlideUser - hasRoleExactly(문자열 역할, 부울 includeDefaults) {#ariaid-title6}

현재 사용자에게 지정된 역할이 있는지 여부를 확인합니다.
{#r_GlideUser-hasRoleExactly_String__table_r53_hn3_ws__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 기본값 포함 | 부울 | 옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음을 참조하십시오. [명시적 역할](https://www.servicenow.com/docs/access?context=explicit-roles&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). 기본값: false |
| role | 문자열 | 검사할 역할입니다. |
[표 8. 매개변수]

{#r_GlideUser-hasRoleExactly_String__table_r53_hn3_ws} {#r_GlideUser-hasRoleExactly_String__table_s53_hn3_ws__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 사용자에게 지정된 역할이 있는 경우 예를 반환합니다. |
[표 9. 반환]

{#r_GlideUser-hasRoleExactly_String__table_s53_hn3_ws}  

    var isInternal = g_user.hasRoleExactly('snc_internal', true);

    var isItil = g_user.hasRoleExactly('itil');

## GlideUser - hasRoleFromList(문자열 역할, 부울 includeDefaults) {#ariaid-title7}

현재 사용자에게 지정된 역할 중 하나 이상이 있거나 관리자 역할이 있는 경우 예를 반환합니다.
{#r_GlideUser-hasRoleFromList_String__table_oxf_wn3_ws__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 역할 | 문자열 | 확인할 역할의 쉼표로 구분된 목록 |
| 기본값 포함 | 부울 | 옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). 기본값: false |
[표 10. 매개변수]

{#r_GlideUser-hasRoleFromList_String__table_oxf_wn3_ws} {#r_GlideUser-hasRoleFromList_String__table_pxf_wn3_ws__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 사용자에게 목록 또는 관리자 역할의 역할이 있는 경우 예를 반환합니다. |
[표 11. 반환]

{#r_GlideUser-hasRoleFromList_String__table_pxf_wn3_ws}  

    var isOK = g_user.hasRoleFromList("itil, maint");

    var isOK = g_user.hasRoleFromList("itil, maint, snc_internal", true);

## GlideUser - hasRoles(부울 includeDefaults) {#ariaid-title8}

현재 사용자에게 역할이 있는 경우 예를 반환합니다.
{#r_GlideUser-hasRoles__table_ups_k43_ws__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 기본값 포함 | 부울 | 옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). 기본값: false |
[표 12. 매개변수]

{#r_GlideUser-hasRoles__table_ups_k43_ws} {#r_GlideUser-hasRoles__table_vps_k43_ws__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 현재 사용자에게 하나 이상의 역할이 있는 경우 예를 반환합니다. |
[표 13. 반환]

{#r_GlideUser-hasRoles__table_vps_k43_ws}  

    var yesRole = g_user.hasRoles();

    var yesRole = g_user.hasRoles(true);

## GlideUser - lastName {#ariaid-title9}

현재 사용자의 성입니다.
{#r_GlideUserLastName__table_g2n_dgh_vs__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| lastName(성) | 문자열 | 현재 사용자의 성입니다. |
[표 14. 필드]

{#r_GlideUserLastName__table_g2n_dgh_vs}  

    alert('last name = ' + g_user.lastName);

## GlideUser - setClientData(문자열 키, 문자열 값) {#ariaid-title10}

getClientData()를 사용하여 검색할 수 있는 클라이언트 값을 설정합니다.
[GlideForm](https://servicenow-prod.fluidtopics.net/c6EJlXXKcD6ogDdekEkrbA#c_GlideFormAPI "GlideForm API는 양식을 사용자 지정하는 메서드를 제공합니다.")도 참조하십시오.
{#r_GlideUser-setClientData_S_S__table_nv5_3k3_ws__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 키 | 문자열 | 키로 저장할 클라이언트 데이터의 이름입니다. |
| 값 | 번호 | 키에 할당할 값입니다. |
[표 15. 매개변수]

{#r_GlideUser-setClientData_S_S__table_nv5_3k3_ws} {#r_GlideUser-setClientData_S_S__table_ov5_3k3_ws__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 16. 반환]

{#r_GlideUser-setClientData_S_S__table_ov5_3k3_ws}  

    function onSubmit() {
    	
    	if (!g_user.getClientData('keyName')) {
    		var now_GR = new GlideRecord('incident');
    		now_GR.addActiveQuery();
    		now_GR.setLimit(1);
    		now_GR.query(cb);
    		return false;
    	}
    	return true;
    }

    function cb(now_GR) {
    	// <insert glide operation >
    	g_user.setClientData('keyName', now_GR.getValue('<number>'));
    	g_form.submit();	
    }

## GlideUser - userName {#ariaid-title11}

현재 사용자의 사용자 이름(예: gsmith02)입니다. 사용자의 이름(예: George Smith)이 아닙니다.
{#r_GlideUserUserName__table_sf4_t2h_vs__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| userName | 문자열 | 현재 사용자의 사용자 이름입니다. |
[표 17. 필드]

{#r_GlideUserUserName__table_sf4_t2h_vs}  

    var userName = g_user.userName;
       alert('Current user = ' + userName);

## GlideUser - userID {#ariaid-title12}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| userID | 문자열 | 현재 사용자의 Sys_id입니다. |
[표 18. 필드]

{#r_GlideUserUserID__table_fhb_3fh_vs}  

    var userID = g_user.userID;
       alert('Current user ID = ' + userID);