GlideUser - 클라이언트

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

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

이 API의 특징은 다음과 같습니다.

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

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

클라이언트 쪽 스크립트 사용에 대한 자세한 내용은 클라이언트 쪽 스크립팅 소개를 참조하십시오.

GlideUser - firstName

현재 사용자의 이름입니다.

표 1. 필드

이름	유형	설명
이름	문자열	현재 사용자의 이름입니다.

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

GlideUser - getClientData(문자열 키)

setClientData() 또는 GlideSession -- putClientData()를 사용하여 설정된 클라이언트 값을 반환합니다.

세션 클라이언트 데이터는 GlideSession -- putClientData()를 사용하여 서버에서 설정할 수 있는 명명된 문자열 세트입니다. 양식을 로드하는 동안 getClientData() 를 사용하여 클라이언트 스크립트가 양식에 대한 결정을 내리는 데 필요한 정보를 가져올 수 있습니다. 예를 들어 표시할 필드를 식별할 수 있습니다.

GlideForm도 참조하십시오.

표 2. 매개변수

이름	유형	설명
키	문자열	검색할 클라이언트 데이터의 이름입니다.

표 3. 반환

유형	설명
문자열	클라이언트 데이터의 값입니다.

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

GlideUser - getFullName()

현재 사용자의 이름과 성을 반환합니다.

표 4. 매개변수

이름	유형	설명
없음

표 5. 반환

유형	설명
문자열	현재 사용자의 전체 이름입니다.

var formalName = g_user.getFullName();

GlideUser - hasRole(문자열 역할, 부울 includeDefaults)

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

표 6. 매개변수

이름	유형	설명
role	문자열	검사할 역할입니다.
기본값 포함	부울	옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 Exploring user administration. 기본값: false

표 7. 반환

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

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

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

GlideUser - hasRoleExactly(문자열 역할, 부울 includeDefaults)

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

표 8. 매개변수

이름	유형	설명
기본값 포함	부울	옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음을 참조하십시오. 명시적 역할. 기본값: false
role	문자열	검사할 역할입니다.

표 9. 반환

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

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

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

GlideUser - hasRoleFromList(문자열 역할, 부울 includeDefaults)

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

표 10. 매개변수

이름	유형	설명
역할	문자열	확인할 역할의 쉼표로 구분된 목록
기본값 포함	부울	옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 Exploring user administration. 기본값: false

표 11. 반환

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

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

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

GlideUser - hasRoles(부울 includeDefaults)

현재 사용자에게 역할이 있는 경우 예를 반환합니다.

표 12. 매개변수

이름	유형	설명
기본값 포함	부울	옵션입니다. 요청에 snc_internal 및 snc_external와 같은 기본 역할을 포함할지 여부를 나타내는 플래그입니다. 역할에 대한 자세한 내용은 다음 문서를 참조하십시오 Exploring user administration. 기본값: false

표 13. 반환

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

var yesRole = g_user.hasRoles();

var yesRole = g_user.hasRoles(true);

GlideUser - lastName

현재 사용자의 성입니다.

표 14. 필드

이름	유형	설명
lastName(성)	문자열	현재 사용자의 성입니다.

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

GlideUser - setClientData(문자열 키, 문자열 값)

getClientData()를 사용하여 검색할 수 있는 클라이언트 값을 설정합니다.

GlideForm도 참조하십시오.

표 15. 매개변수

이름	유형	설명
키	문자열	키로 저장할 클라이언트 데이터의 이름입니다.
값	번호	키에 할당할 값입니다.

표 16. 반환

유형	설명
없음

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

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

표 17. 필드

이름	유형	설명
userName	문자열	현재 사용자의 사용자 이름입니다.

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

GlideUser - userID

현재 사용자의 sys_id 반환합니다.

표 18. 필드

이름	유형	설명
userID	문자열	현재 사용자의 Sys_id입니다.

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