GlideUser - 전역

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기10분

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

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

    표 23. 매개변수
    이름 유형 설명
    id 문자열 원하는 사용자 기록의 고유 ID(sys_id) 또는 user_name입니다.
    표 24. 반환
    유형 설명
    객체 지정된 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()

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

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

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

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

    범위가 지정된 등가

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

    GlideUser - isExplicitMemberOf(문자열 그룹)

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

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

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

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

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

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

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

    출력:

    false

    범위가 지정된 등가

    이 메서드에 해당하는 범위가 없습니다.

    GlideUser - isMemberOf(문자열 그룹)

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

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

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

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

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

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

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

    범위가 지정된 등가

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