GlideUser - 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기12분

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

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

    GlideUser - getCompanyID()

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

    표 1. 매개변수
    이름 유형 설명
    없음
    표 2. 반환
    유형 설명
    문자열 회사 sys_id 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getCompanyID());

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getCompanyID() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getCompanyID()를 사용합니다.

    GlideUser - getDisplayName()

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

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    문자열 사용자의 표시 이름 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getDisplayName());

    범위가 지정된 해당 항목

    범위가 지정된 응용 프로그램에서 getDisplayName() 메서드를 사용하려면 해당 범위가 지정된 메서드인 getDisplayName()을 사용합니다.

    GlideUser - getDomainDisplayValue()

    사용자 세션 도메인의 표시 값을 반환합니다.

    표 5. 매개변수
    이름 유형 설명
    없음
    표 6. 반환
    유형 설명
    문자열 사용자 세션 도메인의 표시 값입니다. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getDomainDisplayValue());

    범위가 지정된 해당 항목

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

    GlideUser - getDomainID()

    사용자의 현재 세션 도메인의 식별자를 반환합니다.

    반환되는 식별자는 도메인 유형과 해당 도메인의 인스턴스화에 따라 다릅니다.

    • 사용자가 전역 도메인에 구성되어 있고 도메인 선택기를 사용하여 도메인을 전환하지 않는 경우 메서드는 null을 반환합니다.
    • 사용자가 도메인 선택기를 사용하여 전역 도메인으로 전환하면 메서드는 문자열 "global"을 반환합니다.
    • 다른 모든 도메인의 경우 메서드는 해당 도메인의 sys_id 반환합니다.
    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 도메인 식별자입니다. 
    var domain = new GlideRecord('domain');
domain.get(gs.getUser().getDomainID());
gs.info(domain.name);

    GlideUser - getEmail()

    사용자의 이메일 주소를 반환합니다.

    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    문자열 사용자의 이메일 주소 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getEmail());

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getEmail() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getEmail()을 사용합니다.

    GlideUser - getFirstName()

    사용자의 이름을 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    객체/문자열 사용자의 이름입니다.
    주:
    반환된 값의 데이터 형식은 object이지만 정보는 문자열로 반환됩니다.
    		 
    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

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getFirstName() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getFirstName()을 사용합니다.

    GlideUser - getID

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

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    문자열 사용자의 sys_id 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getID());

    범위가 지정된 해당 항목

    범위가 지정된 응용 프로그램에서 getID() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getID()를 사용합니다.

    GlideUser - getLastName()

    사용자의 성을 반환합니다.

    표 15. 매개변수
    이름 유형 설명
    없음
    표 16. 반환
    유형 설명
    객체/문자열 사용자의 성입니다.
    주:
    반환된 값의 데이터 형식은 object이지만 정보는 문자열로 반환됩니다.
    		 
    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

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getLastName() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getLastName()을 사용합니다.

    GlideUser - getMyGroups()

    사용자가 속한 모든 그룹의 목록이 포함된 반복기를 반환합니다. 활성 그룹만 반환됩니다.

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    반복기 사용자가 속한 활성 그룹의 sys_ids 목록입니다.

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

    var groupsArray = gs.getUser().getMyGroups().toArray();
gs.info(groupsArray[0]);
    출력:
    cfcbad03d711110050f5edcb9e61038f

    범위가 지정된 해당 항목

    이 메서드에 해당하는 범위가 지정되지 않았습니다.

    GlideUser - getName()

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

    표 19. 매개변수
    이름 유형 설명
    없음
    표 20. 반환
    유형 설명
    문자열 사용자 ID 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getName());

    범위가 지정된 해당 항목

    범위가 지정된 응용 프로그램에서 getName() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 getName()을 사용합니다.

    GlideUser - getRoles()

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

    표 21. 매개변수
    이름 유형 설명
    없음
    표 22. 반환
    유형 설명
    객체 쉼표로 구분된 사용자 역할 목록입니다. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getRoles());

    출력:

    admin,hr_fulfiller,itsa_fulfiller,security_admin

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getRoles() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 getRoles()를 사용합니다.

    GlideUser - getTimeZoneLabel()

    현재 사용자의 시간대 레이블을 현재 사용자의 기본 설정 언어로 반환합니다.

    사용자의 기본 설정 언어 설정에 대한 자세한 내용은 다음 문서를 참조하십시오 User specific language.

    표 23. 매개변수
    이름 유형 설명
    없음
    표 24. 반환
    유형 설명
    문자열 현재 사용자의 시간대 레이블입니다.

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

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

    출력:

    Europe/Dublin

    GlideUser - getTimeZoneLabelLang(문자열 언어)

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

    표 25. 매개변수
    이름 유형 설명
    언어 문자열 시간대 레이블에 사용할 언어입니다. 언어 [sys_language] 테이블의 ID 열에 있습니다.

    유효한 언어가 제공되지 않으면 표준 시간대 레이블이 영어로 반환됩니다.
    표 26. 반환
    유형 설명
    문자열 현재 사용자의 시간대 레이블입니다.

    이 예제에서는 현재 사용자의 표준 시간대 레이블을 지정된 언어로 반환하는 방법을 보여 줍니다.

    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 - getUserByID(문자열 ID)

    전달된 사용자 ID(sys_user에 sys_id) 또는 user_name와 연결된 사용자 객체를 반환합니다.

    표 27. 매개변수
    이름 유형 설명
    ID 문자열 원하는 사용자 기록의 고유 ID(sys_id) 또는 user_name입니다.
    표 28. 반환
    유형 설명
    객체 지정된 sys_id 또는 user_name와 연결된 사용자 객체입니다.

    사용자 이름 사용 예(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()

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

    표 29. 매개변수
    이름 유형 설명
    없음
    표 30. 반환
    유형 설명
    객체/문자열 사용자에게 명시적으로 할당된 쉼표로 구분된 역할 목록입니다.
    주:
    반환된 값의 데이터 형식은 object이지만 정보는 문자열로 반환됩니다.
    		 
    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

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 getUserRoles() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getUserRoles()를 사용합니다.

    GlideUser - hasRole(문자열 역할)

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

    표 31. 매개변수
    이름 유형 설명
    역할 문자열 확인할 역할
    표 32. 반환
    유형 설명
    부울 사용자에게 역할이 있는 경우 True입니다. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.hasRole('admin'));

    범위가 지정된 해당 항목

    범위가 지정된 응용 프로그램에서 hasRole() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 hasRole()을 사용합니다.

    GlideUser - isExplicitMemberOf(문자열 그룹)

    현재 사용자가 지정된 그룹의 명시적 구성원인지 여부를 결정합니다. 활성 그룹만 이 메서드에서 평가됩니다.

    isMemberOf() 메서드는 사용자가 하위 그룹의 구성원인 경우 상위 그룹에 대해 true를 반환합니다. 상위 그룹에 대해서만 true를 반환하려는 경우 이 메서드를 사용합니다.

    표 33. 매개변수
    이름 유형 설명
    그룹 문자열 확인할 사용자 그룹의 Sys_id입니다.
    표 34. 반환
    유형 설명
    부울

    현재 사용자가 지정된 그룹의 명시적 구성원인지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 현재 사용자가 지정된 그룹의 명시적 구성원입니다.
    • false: 현재 사용자가 지정된 그룹의 명시적 구성원이 아닙니다.

    다음 예제에서는 현재 사용자가 지정된 그룹의 명시적 구성원인지 확인하는 방법을 보여 줍니다.

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

    출력:

    false

    범위가 지정된 해당 항목

    이 메서드에 해당하는 범위가 지정되지 않았습니다.

    GlideUser - isMemberOf(문자열 그룹)

    현재 사용자가 지정된 그룹의 구성원인지 확인합니다. 활성 그룹만 이 메서드에서 평가됩니다.

    이 메서드는 사용자가 하위 그룹의 구성원인 경우 상위 그룹에 대해 true를 반환합니다. 상위 그룹에 대해서만 true를 반환하려는 경우 isExplicitMemberOf() 를 사용하십시오.

    표 35. 매개변수
    이름 유형 설명
    그룹 문자열 확인할 그룹의 Sys_id 또는 이름입니다.
    표 36. 반환
    유형 설명
    부울 사용자가 지정된 그룹의 구성원인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 사용자가 그룹의 구성원입니다.
    • false: 사용자가 그룹의 구성원이 아닙니다.

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

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

    출력:

    false

    범위가 지정된 해당 항목

    범위가 지정된 응용 프로그램에서 isMemberOf() 메서드를 사용하려면 해당 범위가 지정된 메서드인 isMemberOf()를 사용합니다.