GlideUser - 범위 지정

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 6분
  • GlideUser API는 현재 사용자 및 현재 사용자 역할에 대한 정보에 액세스할 수 있는 메서드를 제공합니다.

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

    범위가 지정된 GlideUser - getCompanyID()

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

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

    범위가 지정된 GlideUser - getDisplayName()

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

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

    범위가 지정된 GlideUser - getEmail()

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

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

    범위가 지정된 GlideUser - getFirstName()

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

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 사용자의 이름입니다.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getFirstName());

    범위가 지정된 GlideUser - getID()

    현재 사용자의 sys_id 가져옵니다.

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

    범위가 지정된 GlideUser - getLastName()

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

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    문자열 사용자의 성입니다.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getLastName());

    범위가 지정된 GlideUser - getName()

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

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    문자열 사용자 ID 또는 로그인 이름입니다.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getName());

    범위가 지정된 GlideUser - getPreference(문자열 이름)

    현재 사용자에 대해 지정된 사용자 기본 설정 값을 가져옵니다.

    표 15. 매개변수
    이름 유형 설명
    이름 문자열 기본 설정의 이름입니다.
    표 16. 반환
    유형 설명
    문자열 기본 설정 값입니다.
    var currentUser = gs.getUser(); 
    currentUser.savePreference(­'myPref','red'); 
    gs.info(currentUser.getPreference(­'myPref'));

    범위가 지정된 GlideUser - getRoles()

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

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    배열 사용자가 사용할 수 있는 모든 역할 목록
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getRoles());

    범위가 지정된 GlideUser - getTimeZoneLabel()

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

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

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

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

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

    출력:

    Europe/Dublin

    범위가 지정된 GlideUser - getTimeZoneLabelLang(문자열 언어)

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

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

    유효한 언어가 제공되지 않으면 표준 시간대 레이블이 영어로 반환됩니다.

    표 22. 반환
    유형 설명
    문자열 현재 사용자의 시간대 레이블입니다.

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

    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 - getUserRoles()

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

    getRoles() 메서드와 달리 이 메서드는 사용자가 상속하는 역할이나 그룹 구성원 자격에서 획득한 역할을 반환하지 않습니다.

    표 23. 매개변수
    이름 유형 설명
    없음
    표 24. 반환
    유형 설명
    배열 사용자에게 명시적으로 할당된 역할 목록입니다.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getUserRoles());

    범위가 지정된 GlideUser - hasRole(문자열 역할)

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

    표 25. 매개변수
    이름 유형 설명
    role 문자열 확인할 역할입니다.
    표 26. 반환
    유형 설명
    부울 사용자에게 지정된 역할이 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 사용자에게 지정된 역할이 있습니다.
    • false: 사용자에게 지정된 역할이 없습니다.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.hasRole('admin'));

    범위가 지정된 GlideUser - isMemberOf(문자열 그룹)

    현재 사용자가 지정된 그룹의 구성원인지 확인합니다.

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

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

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

    출력:

    false

    범위가 지정된 GlideUser - savePreference(문자열 이름, 문자열 값)

    사용자 기본 설정 값을 데이터베이스에 저장합니다.

    표 29. 매개변수
    이름 유형 설명
    이름 문자열 저장할 기본 설정입니다.
    문자열 기본 설정 값입니다.
    표 30. 반환
    유형 설명
    없음
    var currentUser = gs.getUser(); 
    currentUser.savePreference('myPref','red'); 
    gs.info(currentUser.getPreference('myPref'));