---
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는 현재 사용자 및 현재 사용자 역할에 대한 정보에 액세스하는 메서드를 제공합니다. 이 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}

| 이름 | 유형 | 설명 |
|-|-|-|
| firstName | 문자열 | 현재 사용자의 이름입니다. |
[표 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/5rc_K2VezCedNulb2jN1TA#c_GlideSessionScopedAPI "범위가 지정된 GlideSession API는 현재 세션에 대한 정보를 찾는 메서드를 제공합니다.")를 사용하여 서버에서 설정할 수 있는 명명된 문자열 세트입니다. 양식을 로드하는 동안 getClientData() 를 사용하여 클라이언트 스크립트가 양식에 대한 결정을 내리는 데 필요한 정보를 가져올 수 있습니다. 예를 들어 표시해야 하는 필드를 식별할 수 있습니다.

[GlideForm](https://servicenow-prod.fluidtopics.net/qXwPa2am53gcfcc7Mwrz8A#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 | 문자열 | 확인할 역할입니다. |
| includeDefaults | 부울 | 옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=australia&pubname=australia-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}

| 이름 | 유형 | 설명 |
|-|-|-|
| includeDefaults | 부울 | 옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음을 참조하십시오. [명시적 역할.](https://www.servicenow.com/docs/access?context=explicit-roles&version=australia&pubname=australia-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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 역할 | 문자열 | 확인할 역할의 쉼표로 구분된 목록 |
| includeDefaults | 부울 | 옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=australia&pubname=australia-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}

| 이름 | 유형 | 설명 |
|-|-|-|
| includeDefaults | 부울 | 옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=australia&pubname=australia-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(String key, String value) {#ariaid-title10}

getClientData()를 사용하여 검색할 수 있는 클라이언트 값을 설정합니다.
[GlideForm](https://servicenow-prod.fluidtopics.net/qXwPa2am53gcfcc7Mwrz8A#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);