GlideSession - 범위 지정됨

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

    • 범위가 지정된 GlideSession API는 현재 세션에 대한 정보를 찾는 메서드를 제공합니다.

    범위가 지정된 GlideSession 객체의 인스턴스를 만들기 위한 생성자는 없습니다. 대신 범위가 지정된 GlideSystem API의 getSession() 메서드를 사용합니다.

    범위 지정된 GlideSession - getClientData(문자열 매개변수 이름)

    이전에 putClientData()로 설정된 세션 클라이언트 값을 검색합니다.

    이 메서드를 사용하여 putClientData() 메서드를 사용하여 설정된 데이터 값을 검색합니다.

    표 1. 매개변수
    이름 유형 설명
    매개변수 이름 문자열 검색할 클라이언트 데이터의 이름입니다.
    표 2. 반환
    유형 설명
    문자열 클라이언트 데이터. 
    var session = gs.getSession();
session.putClientData('test1', 'Harry');
var clientData = session.getClientData('test1');
gs.info(clientData);

    출력:

    Harry

    범위 지정 GlideSession - getClientIP()

    클라이언트 IP 주소를 반환합니다.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    문자열 IP 주소입니다. 
    var session = gs.getSession();
var addr = session.getClientIP();
gs.info(addr);

    출력:

    50.59.164.97

    범위 지정 GlideSession - getCurrentApplicationId()

    애플리케이션 선택기에서 현재 선택된 애플리케이션을 반환합니다.

    이 방법을 사용하려면 관리자 권한이 필요합니다.

    표 5. 매개변수
    이름 유형 설명
    없음
    표 6. 반환
    유형 설명
    문자열 현재 선택된 애플리케이션입니다. 
    var session = gs.getSession();
var appID = session.getCurrentApplicationId();
gs.info(appID);

    출력:

    ce05b9f32b840200c5244f74b4da1501

    범위 지정된 GlideSession - getCurrentDomainID()

    로그인한 사용자 세션에 대한 현재 도메인의 sys_id 반환합니다.

    반환되는 식별자는 도메인 유형과 해당 도메인의 인스턴스화에 따라 달라집니다.
    • 사용자가 전역 도메인에 구성되어 있고 도메인 선택기를 사용하여 도메인을 전환하지 않는 경우 메서드는 null을 반환합니다.
    • 사용자가 도메인 선택기를 사용하여 전역 도메인으로 전환하는 경우 메서드는 문자열 "global"을 반환합니다.
    • 다른 모든 도메인의 경우 메서드는 해당 도메인의 sys_id 반환합니다.
    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 현재 로그인한 사용자의 세션 도메인 Sys_id입니다. 이는 도메인 선택기에 나타나는 정보와 동일합니다.

    이 예는 사용자 도메인이 전역이거나 null인 경우 현재 sys_email 기록의 도메인이 사용자의 세션 도메인으로 설정되는 것을 보여줍니다.

    // Set domain based on parent record's domain
setDomain();

// If the domain is global, set to user's domain
if (current.sys_domain == 'global' || current.sys_domain.nil())
   current.sys_domain = gs.getSession().getCurrentDomainID();

function setDomain() {
   if (current.target_table.nil())
      return;

   var d = new GlideRecord(current.target_table);
   if (!d.isValid())
      return;

   if (!d.get('sys_id', current.instance))
      return;

   if (typeof(d.sys_domain) == 'object')
      current.sys_domain = d.sys_domain;

    범위 지정 GlideSession - getLanguage()

    세션의 언어 코드를 반환합니다.

    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    문자열 세션의 언어 코드입니다. 
    var session = gs.getSession();
var language = session.getLanguage();
gs.info(language);

    출력:

    en

    범위 지정 GlideSession - getSessionToken()

    세션 토큰을 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    문자열 세션 토큰입니다. 
    var session = gs.getSession();
var token = session.getSessionToken();
gs.info(token);

    출력:

    4284b5372b840200c5244f74b4da15f2c3476cf7fcb6572afa4ef9d5e6d307a5fd9e1da7

    범위 지정 GlideSession - getTimeZoneName()

    세션의 시간대 이름을 반환합니다.

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    문자열 세션의 시간대 이름입니다. 
    var session = gs.getSession();
var zoneName = session.getTimeZoneName();
gs.info(zoneName);

    출력:

    US/Pacific

    범위 지정 GlideSession - getUrlOnStack()

    스택의 URL을 반환합니다. 스택이 비어 있으면 null을 반환합니다.

    표 15. 매개변수
    이름 유형 설명
    없음
    표 16. 반환
    유형 설명
    문자열 스택의 URL입니다. 스택이 비어 있으면 null을 반환합니다. 
    var session = gs.getSession();
var URL = session.getUrlOnStack();
gs.info(URL);

    출력: 명확성을 위해 줄 바꿈이 추가되었습니다.

    sys_app.do?sys_id=ce05b9f32b840200c5244f74b4da1501&sysparm_goto_url=sys_app.do
%3Fsys_id%3Dce05b9f32b840200c5244f74b4da1501

    범위 지정된 GlideSession - isImpersonating()

    사용자가 다른 사용자를 가장하는 경우 예를 반환합니다.

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    부울 사용자가 다른 사용자를 가장하고 있음을 나타내는 플래그입니다.
    가능한 값:
    • true: 사용자가 가장하고 있습니다.
    • false: 사용자가 가장하지 않습니다.
    		 
    var isImpersonator = gs.getSession().isImpersonating();
gs.info(isImpersonator);

    범위가 지정된 GlideSession - isInteractive()

    세션이 대화형이면 true를 반환합니다.

    대화형 세션은 최종 사용자가 사용자 인터페이스와 상호 작용한 다음 서버에서 정보를 검색하는 세션입니다. 이러한 세션 유형의 예로는 사용자가 로그인 화면을 사용하여 로그인하거나 양식을 사용하여 데이터 저장소를 쿼리하는 경우를 들 수 있습니다. 비대화형 세션은 데이터를 검색하기 위한 SOAP 요청과 같이 서버와의 프로그래밍 방식 상호 작용만 포함하는 세션입니다.

    표 19. 매개변수
    이름 유형 설명
    없음
    표 20. 반환
    유형 설명
    부울 세션이 대화형인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 세션이 대화형입니다.
    • false: 세션이 대화형이 아닙니다.
    		 
    var interActive = gs.getSession().isInteractive();
gs.info(interActive);

    범위 지정된 GlideSession - isLoggedIn()

    사용자가 로그인되어 있는 경우 true를 반환합니다.

    표 21. 매개변수
    이름 유형 설명
    없음
    표 22. 반환
    유형 설명
    부울 사용자가 로그인했는지 여부를 나타내는 플래그
    가능한 값:
    • true: 사용자가 로그인했습니다.
    • false: 사용자가 로그인하지 않았습니다.
    		 
    var session = gs.getSession();
var loggedIn = session.isLoggedIn();
gs.info(loggedIn);

    출력:

    true

    범위 지정 GlideSession - putClientData(String paramName, String paramValue)

    getClientData()로 검색할 수 있는 세션 클라이언트 값을 설정합니다. 이 메서드는 양식을 만들 때 실행되는 서버 측 스크립트에 사용됩니다.

    표 23. 매개변수
    이름 유형 설명
    매개변수 이름 문자열 설정할 클라이언트 데이터의 이름입니다.
    매개변수값 문자열 클라이언트 데이터의 값입니다.
    표 24. 반환
    유형 설명
    void 
    var session = gs.getSession();
session.putClientData('test1', 'Harry');
var clientData = session.getClientData('test1');
gs.info(clientData);

    출력:

    Harry