GlideSystem - 범위 지정됨

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

    • 범위가 지정된 GlideSystem API는 시스템, 현재 로그인한 사용자 및 기타 시스템 수준 정보에 대한 정보를 얻을 수 있는 여러 가지 편리한 메서드를 제공합니다.

    많은 GlideSystem 메서드를 사용하면 쿼리 범위에 날짜를 쉽게 포함할 수 있으며 필터 및 보고에 가장 자주 사용됩니다.

    범위 지정된 GlideSystem - addErrorMessage(문자열 메시지)

    현재 세션에 대한 오류 메시지를 추가합니다.

    표 1. 매개변수
    이름 유형 설명
    메시지 문자열 추가할 메시지입니다.
    표 2. 반환
    유형 설명
    void 
    gs.include("PrototypeServer");
  var ValidatePasswordStronger = Class.create();
  ValidatePasswordStronger.prototype = {
       process : function() {
          var user_password = request.getParameter("user_password");
          var min_len = 8;
          var rules = "Password must be at least " + min_len + 
             " characters long and contain a digit, an uppercase letter, and a lowercase letter.";
          if (user_password.length() < min_len) {
             gs.addErrorMessage("TOO SHORT: " + rules);
             return false;
          }
          var digit_pattern = new RegExp("[0-9]", "g");
          if (!digit_pattern.test(user_password)) {
             gs.addErrorMessage("DIGIT MISSING: " + rules);
             return false;
          }
          var upper_pattern = new RegExp("[A-Z]", "g");
          if (!upper_pattern.test(user_password)) {
             gs.addErrorMessage("UPPERCASE MISSING: " + rules);
             return false;
          }
          var lower_pattern = new RegExp("[a-z]", "g");
          if (!lower_pattern.test(user_password)) {
             gs.addErrorMessage("LOWERCASE MISSING: " + rules);
             return false;
          }
          return true; // password is OK
       }
  }

    범위 지정된 GlideSystem - addInfoMessage(문자열 메시지)

    현재 세션에 대한 정보 메시지를 추가합니다. 이 메서드는 비동기 비즈니스 규칙에 대해 지원되지 않습니다.

    표 3. 매개변수
    이름 유형 설명
    메시지 문자열 추가할 정보 메시지입니다.
    표 4. 반환
    유형 설명
    void 
    if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
  var start = current.u_date1.getGlideObject().getNumericValue();
  var end = current.u_date2.getGlideObject().getNumericValue();
  if (start > end) {
    gs.addInfoMessage('start must be before end');
    current.u_date1.setError('start must be before end');
    current.setAbortAction(true);
  }
}

    범위 지정된 GlideSystem - base64Encode(문자열 소스)

    지정된 문자열에서 base64 문자열을 만듭니다.

    표 5. 매개변수
    이름 유형 설명
    소스 문자열 인코딩할 문자열입니다.
    표 6. 반환
    유형 설명
    문자열 인코딩된 base64 문자열입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var mac = new CertificateEncryption;
var key = "sample_key"; 
key = gs.base64Encode(key);
mac.generateMac(key, "HmacSHA256", "sample_data");

    범위가 지정된 GlideSystem - base64Decode(문자열 소스)

    지정된 base64 문자열에서 ASCII 문자열을 반환합니다.

    표 7. 매개변수
    이름 유형 설명
    소스 문자열 base64로 인코딩된 문자열입니다.
    표 8. 반환
    유형 설명
    문자열 디코딩된 문자열입니다.

    범위가 지정된 GlideSystem - beginningOfLastMonth()

    지난 달의 시작 날짜와 시간을 GMT로 반환합니다.

    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    문자열 지난달 초 GMT(yyyy-mm-dd hh:mm:ss 형식)

    범위 지정된 GlideSystem - beginningOfLastWeek()

    지난 주의 시작 날짜와 시간을 GMT로 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    문자열 GMT 지난주 초, yyyy-mm-dd hh:mm:ss 형식

    범위 지정 GlideSystem - beginningOfNextMonth()

    다음 달 초의 날짜와 시간을 GMT로 반환합니다.

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    문자열 다음 달 초 GMT(yyyy-mm-dd hh:mm:ss 형식)

    범위가 지정된 GlideSystem - beginningOfNextWeek()

    다음 주 시작의 날짜와 시간을 GMT로 반환합니다.

    표 15. 매개변수
    이름 유형 설명
    없음
    표 16. 반환
    유형 설명
    문자열 다음 주 초의 GMT로, yyyy-mm-dd hh:mm:ss 형식입니다.

    범위가 지정된 GlideSystem - beginningOfNextYear()

    다음 해 초의 날짜 및 시간을 GMT로 반환합니다.

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    문자열 내년 초 GMT(yyyy-mm-dd hh:mm:ss 형식)

    범위가 지정된 GlideSystem - beginningOfThisMonth()

    이번 달 초의 날짜와 시간을 GMT로 반환합니다.

    표 19. 매개변수
    이름 유형 설명
    없음
    표 20. 반환
    유형 설명
    문자열 이번 달 초 GMT(yyyy-mm-dd hh:mm:ss 형식)

    범위가 지정된 GlideSystem - beginningOfThisQuarter()

    이번 분기의 시작 날짜와 시간을 GMT로 반환합니다.

    표 21. 매개변수
    이름 유형 설명
    없음
    표 22. 반환
    유형 설명
    문자열 이번 분기 초 GMT(yyyy-mm-dd hh:mm:ss 형식)

    범위 지정 GlideSystem - beginningOfThisWeek()

    이번 주의 시작 날짜와 시간을 GMT로 반환합니다.

    표 23. 매개변수
    이름 유형 설명
    없음
    표 24. 반환
    유형 설명
    문자열 GMT 이번 주 초(yyyy-mm-dd hh:mm:ss 형식)

    범위가 지정된 GlideSystem - beginningOfThisYear()

    올해 초의 날짜 및 시간을 GMT로 반환합니다.

    표 25. 매개변수
    이름 유형 설명
    없음
    표 26. 반환
    유형 설명
    문자열 올해 초 GMT(yyyy-mm-dd hh:mm:ss 형식)

    범위 지정된 GlideSystem - dateGenerate(문자열 날짜, 문자열 범위)

    지정된 날짜의 날짜와 시간을 GMT로 생성합니다.

    표 27. 매개변수
    이름 유형 설명
    날짜 문자열 GMT를 생성할 날짜입니다.

    형식: yyyy-mm-dd
    레인지 문자열 시작, 종료 또는 24시간 형식 hh:mm:ss의 시간입니다.
    표 28. 반환
    유형 설명
    문자열 생성된 날짜 및 시간입니다.

    범위가 start인 경우 반환되는 값은 yyyy-mm-dd 00:00:00입니다.

    range가 end 인 경우 반환 값은 yyyy-mm-dd 23:59:59입니다.

    형식: yyyy-mm-dd hh:mm:ss

    이 예시에서는 dateGenerate() 를 사용하여 인시던트 테이블의 기록을 쿼리할 때 시작 날짜를 설정하는 방법을 보여줍니다.

    var tableData = new GlideRecord('incident');
tableData.addEncodedQuery("sys_created_onBETWEENjavascript:gs.dateGenerate('2015-10-07','00:00:00')@javascript:gs.daysAgoEnd(0)^priority=1^severityIN1,2");
tableData.query();
gs.info("Count: " + tableData.getRowCount());

    출력

    Count: 7

    범위 지정된 GlideSystem - daysAgo(일수)

    지정된 일수 이전의 날짜 및 시간을 반환합니다.

    표 29. 매개변수
    이름 유형 설명
    일 번호 정수 날짜 수
    표 30. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT 
    function contractNoticeDue() {
    var now_GR = new GlideRecord("contract");
    now_GR.addQuery("u_contract_status", "Active");
    now_GR.query();
    while (now_GR.next()) {
    if ((now_GR.u_termination_date <= gs.daysAgo(-90)) && (now_GR.u_contract_duration == "Long")) {
            now_GR.u_contract_status = "In review";
        } 
        else if ((now_GR.u_termination_date <= gs.daysAgo(-50)) && (now_GR.u_contract_duration == "Medium")) {
        now_GR.u_contract_status = "In review";
        } 
        else if ((now_GR.u_termination_date <= gs.daysAgo(-10)) && (now_GR.u_contract_duration == "Short")) {
            now_GR.u_contract_status = "In review";
        }
    }
    now_GR.update();
}

    범위 지정된 GlideSystem - daysAgoEnd(일수)

    지정된 일수 이전의 종료 날짜 및 시간을 반환합니다.

    표 31. 매개변수
    이름 유형 설명
    일 번호 정수 날짜 수
    표 32. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT 하루의 종료

    범위 지정된 GlideSystem - daysAgoStart(일수)

    지정된 일수 이전의 시작 날짜 및 시간을 반환합니다.

    표 33. 매개변수
    이름 유형 설명
    일 문자열 정수 날짜 수
    표 34. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT 하루의 시작 
    var now_GR = new GlideRecord('sysapproval_approver');
now_GR.addQuery('state', 'requested');
now_GR.addQuery('sys_updated_on', '<', gs.daysAgoStart(5));
now_GR.query();

    범위가 지정된 GlideSystem - debug(문자열 메시지, 객체 매개변수1, 객체 매개변수2, 객체 매개변수3, 객체 매개변수4, 객체 매개변수5)

    시스템 로그에 디버그 메시지를 씁니다.

    표 35. 매개변수
    이름 유형 설명
    메시지 문자열 변수 인수에 대한 자리 표시자가 있는 로그 메시지입니다.
    param1 객체 (선택 사항) 첫 번째 변수 인수입니다.
    매개변수2 객체 (선택 사항) 두 번째 변수 인수입니다.
    param3 객체 (선택 사항) 세 번째 변수 인수입니다.
    param4 객체 (선택 사항) 네 번째 변수 인수입니다.
    param5 객체 (선택 사항) 다섯 번째 변수 인수입니다.
    표 36. 반환
    유형 설명
    void 
    gs.debug("This is a debug message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.debug("This is a debug message from {0}.{1}", myFirstName, myLastName);
    출력:
    This is a debug message (sys.scripts extended logging)
This is a debug message from Abel.Tuter (sys.scripts extended logging)

    범위 지정된 GlideSystem - endOfLastMonth()

    지난달 말일의 날짜와 시간을 GMT로 반환합니다.

    표 37. 매개변수
    이름 유형 설명
    없음
    표 38. 반환
    유형 설명
    문자열 GMT 지난달 말, yyyy-mm-dd hh:mm:ss 형식

    범위 지정 GlideSystem - endOfLastWeek()

    지난 주말의 날짜 및 시간을 GMT로 반환합니다.

    표 39. 매개변수
    이름 유형 설명
    없음
    표 40. 반환
    유형 설명
    문자열 GMT 지난주 말(yyyy-mm-dd hh:mm:ss 형식)

    범위 지정된 GlideSystem - endOfLastYear()

    작년 말의 날짜 및 시간을 GMT로 반환합니다.

    표 41. 매개변수
    이름 유형 설명
    없음
    표 42. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위 지정 GlideSystem - endOfNextMonth()

    다음 달 말일의 날짜 및 시간을 GMT로 반환합니다.

    표 43. 매개변수
    이름 유형 설명
    없음
    표 44. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위 지정 GlideSystem - endOfNextWeek()

    GMT로 다음 주 말의 날짜와 시간을 반환합니다.

    표 45. 매개변수
    이름 유형 설명
    없음
    표 46. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위 지정 GlideSystem - endOfNextYear()

    다음 해 말의 날짜 및 시간을 GMT로 반환합니다.

    표 47. 매개변수
    이름 유형 설명
    없음
    표 48. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위 지정 GlideSystem - endOfThisMonth()

    이번 달 말일의 날짜 및 시간을 GMT로 반환합니다.

    표 49. 매개변수
    이름 유형 설명
    없음
    표 50. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위 지정 GlideSystem - endOfThisQuarter()

    이번 분기 말의 날짜 및 시간을 GMT로 반환합니다.

    표 51. 매개변수
    이름 유형 설명
    없음
    표 52. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위 지정된 GlideSystem - endOfThisWeek()

    이번 주말의 날짜와 시간을 GMT로 반환합니다.

    표 53. 매개변수
    이름 유형 설명
    없음
    표 54. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위 지정된 GlideSystem - endOfThisYear()

    올해 말의 날짜 및 시간을 GMT로 반환합니다.

    표 55. 매개변수
    이름 유형 설명
    없음
    표 56. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위가 지정된 GlideSystem - 오류(문자열 메시지, 객체 매개변수1, 매개변수 2, 매개변수 3, 매개변수 4, 매개변수5 개체)

    시스템 로그에 오류 메시지를 씁니다.

    이 메소드는 Java MessageFormat 자리 표시자 바꾸기 패턴을 사용하여 메시지에서 최대 5개의 변수 인수(varargs)를 허용합니다.

    주:
    올바른 출력을 제공하려면 이 메서드의 변수에 유효한 값이 포함되어야 합니다.
    표 57. 매개변수
    이름 유형 설명
    메시지 문자열 변수 인수에 대한 자리 표시자가 있는 로그 메시지입니다.
    param1 객체 (선택 사항) 첫 번째 변수 인수입니다.
    매개변수2 객체 (선택 사항) 두 번째 변수 인수입니다.
    param3 객체 (선택 사항) 세 번째 변수 인수입니다.
    param4 객체 (선택 사항) 네 번째 변수 인수입니다.
    param5 객체 (선택 사항) 다섯 번째 변수 인수입니다.
    표 58. 반환
    유형 설명
    void 
    gs.error("This is an error message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.error("This is an error message from {0}.{1}", myFirstName, myLastName);
    출력:
    This is an error message
This is an error message from Abel.Tuter

    범위가 지정된 GlideSystem - eventQueue(문자열 이름, 객체 인스턴스, 문자열 매개변수1, 문자열 매개변수2, 문자열 큐)

    이벤트 관리자에 대한 이벤트를 큐에 넣습니다.

    표 59. 매개변수
    이름 유형 설명
    이름 문자열 큐에 대기 중인 이벤트의 이름입니다.
    인스턴스 객체 GlideRecord 객체(예: "현재")
    parm1 문자열 옵션입니다. 지정된 경우 인스턴스와 함께 저장됩니다.
    parm2 문자열 옵션입니다. 지정된 경우 인스턴스와 함께 저장됩니다.
    큐 문자열 옵션입니다. 큐 이름.
    표 60. 반환
    유형 설명
    void 
    if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueue('incident.commented', current, gs.getUserID(), gs.getUserName());
}

    범위 지정된 GlideSystem - eventQueueScheduled(문자열 이름, 객체 인스턴스, 문자열 매개변수 1, 문자열 매개변수 2, 객체 만료)

    이벤트 관리자에서 이벤트를 큐에 넣습니다.

    전달된 이벤트 일정 정보는 이벤트 [sysevent] 테이블에 저장됩니다. 이벤트에 대한 자세한 내용은 이벤트를 참조하십시오.

    표 61. 매개변수
    이름 유형 설명
    이름 문자열 큐에 대기할 이벤트의 이름입니다.
    인스턴스 객체/문자열 GlideRecord 객체 또는 이 이벤트가 적용되는 기록의 sys_id입니다.
    parm1 문자열 옵션입니다. 이벤트 스크립트에 전달할 문자열입니다. 이 매개변수는 자유 형식이며 이벤트 스크립트의 구현에 따라 달라집니다.

    기본값: 매개변수가 instance GlideRecord 객체인 경우 기본값은 해당 GlideRecord(now_GR.getDisplayValue)의 표시 값이며, 그렇지 않으면 null입니다.
    parm2 문자열 옵션입니다. 이벤트 스크립트에 전달할 문자열입니다. 이 매개변수는 자유 형식이며 이벤트 스크립트의 구현에 따라 달라집니다.

    기본값: null
    만료 객체 옵션입니다. GlideDateTime 객체 또는 이벤트를 처리할 날짜 및 시간을 지정하는 날짜/시간 유형 요소입니다.

    기본값: 현재 날짜/시간
    표 62. 반환
    유형 설명
    void

    이 예시에서는 GlideRecord, 이벤트 스크립트에 전달되는 두 개의 매개변수, 이벤트를 예약하기 위해 지정한 시간을 사용하여 메서드를 호출하는 방법을 보여줍니다.

    var requestXml = requestBody.dataString;
var processTime = new GlideDateTime();
processTime.addDaysLocalTime(7);
gs.eventQueueScheduled('sn_app.user.deactivate', now_GR, requestXML, gs.getUserID(), processTime);

    이 예제에서는 sys_id와 선택적 매개 변수의 기본값을 사용하여 메서드를 호출하는 방법을 보여 줍니다.

    gs.eventQueueScheduled('event.test', '0e29421383101000dada83ec37d9292d', '', '', '');

    범위 지정된 GlideSystem - executeNow(GlideRecord 작업)

    범위가 지정된 애플리케이션에 대한 작업을 실행합니다.

    이 메서드를 호출하는 스크립트와 동일한 애플리케이션의 작업에서만 이 메서드를 사용할 수 있습니다.

    표 63. 매개변수
    이름 유형 설명
    작업 GlideRecord 실행할 작업입니다.
    표 64. 반환
    유형 설명
    문자열 예약된 작업의 sys_id 반환합니다. 작업이 전역인 경우 null을 반환합니다. 
    scheduleImportJob: function () {
  var jobId = '61847fe04c603300fa9bb64c2b491dac';
  var now_GR = new GlideRecord('sysauto_script');
  if (!now_GR.get(jobId)) {
    throw new Error('Unable to find import job');
  }
  gs.executeNow(now_GR);
}

    범위 지정된 GlideSystem - generateGUID()

    고유 식별자가 필요할 때 사용할 수 있는 GUID를 생성합니다.

    표 65. 매개변수
    이름 유형 설명
    없음
    표 66. 반환
    유형 설명
    문자열 32자의 16진수 GUID입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    personalId = gs.generateGUID();
gs.info(personalId);

    출력:

    af770511ff013100e04bfffffffffff6

    범위 지정된 GlideSystem - getCallerScopeName()

    호출자 범위 이름을 가져옵니다. 호출자가 없으면 null을 반환합니다.

    표 67. 매개변수
    이름 유형 설명
    없음
    표 68. 반환
    유형 설명
    문자열 호출자의 범위 이름 또는 호출자가 없는 경우 null입니다.

    이 예시에서는 모든 애플리케이션 범위에서 접근 가능으로 설정된 두 개의 스크립트 포함을 보여줍니다. 하나의 스크립트 포함이 app_scope_a 내에 생성됩니다.

    var Scopea = Class.create(); 
 
Scopea.prototype = { 
    initialize: function() { 
    }, 
 
    callerScope: function() { 
        var scopeb = new app_scope_b.Scopeb(); 
        return scopeb.callerscope(); 
    }, 
 
    type: 'Scopea' 
}

    출력:

    이 예시에서는 app_scope_b 내에서 만들어진 또 다른 스크립트 포함을 보여줍니다.

    var Scopeb = Class.create(); 
 
Scopeb.prototype = { 
    initialize: function() { 
        this._constructorCallerScope = gs.getCallerScopeName(); 
    }, 
 
    callerscope: function() { 
        return gs.getCallerScopeName(); 
    }, 
 
    getConstructorCallerScope: function() { 
        return this._constructorCallerScope; 
    }, 
 
    type: 'Scopeb' 
}

    출력:

    이 스크립트는 app_scope_a 범위 내에서 호출자의 범위 이름(이 경우 app_scope_b)을 가져오는 데 사용할 수 있습니다.

    gs.info(new Scopea().getCallerScopeName());

    범위 지정된 GlideSystem - getCssCacheVersionString()

    CSS 파일의 캐시 버전을 나타내는 문자열을 가져옵니다.

    표 69. 매개변수
    이름 유형 설명
    없음
    표 70. 반환
    유형 설명
    문자열 CSS 캐시 버전입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var verStr = gs.getCssCacheVersionString();
gs.info(verStr);

    출력:

    _d82979516f0171005be8883e6b3ee4cf&theme=

    범위 지정된 GlideSystem - getCurrentApplicationId()

    애플리케이션 선택기를 사용하여 설정된 현재 애플리케이션의 ID를 가져옵니다.

    표 71. 매개변수
    이름 유형 설명
    없음
    표 72. 반환
    유형 설명
    문자열 현재 응용 프로그램의 sys_id 또는 전역이 설정되지 않았습니다. 
    var currentId = gs.getCurrentApplicationId();
gs.info(currentId);

    출력

    04936cb16f30b1005be8883e6b3ee4e0

    범위 지정된 GlideSystem - getCurrentScopeName()

    현재 범위의 이름을 가져옵니다.

    표 73. 매개변수
    이름 유형 설명
    없음
    표 74. 반환
    유형 설명
    문자열 현재 범위 이름입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var currentScope = gs.getCurrentScopeName();
gs.info(currentScope);

    출력:

    s_snc_test_scope

    범위 지정된 GlideSystem - getDateFormat(문자열)

    현재 사용자와 연결된 날짜 형식을 반환합니다.

    표 75. 매개변수
    이름 유형 설명
    없음
    표 76. 반환
    유형 설명
    문자열 현재 사용자와 연결된 날짜 형식입니다.

    다음 예제에서는 사용자와 연결된 날짜 형식을 반환합니다.

    var userDateFormat = gs. getDateFormat();
gs.info(userDateFormat);

    출력:

    yyyy-MM-dd

    범위 지정된 GlideSystem - getDateTimeFormat()

    현재 사용자와 연결된 날짜 및 시간 형식을 반환합니다.

    표 77. 매개변수
    이름 유형 설명
    없음
    표 78. 반환
    유형 설명
    문자열 현재 사용자와 연결된 날짜 및 시간 형식입니다.

    다음 예에서는 사용자와 연결된 날짜 및 시간의 형식을 반환합니다.

    var userDateTimeFormat = gs.getDateTimeFormat();
gs.info(userDateTimeFormat);

    출력:

    yyyy-MM-dd HH:mm:ss

    범위 지정 GlideSystem - getErrorMessages()

    세션에 대해 addErrorMessage() 에 의해 추가된 오류 메시지를 반환합니다.

    표 79. 매개변수
    이름 유형 설명
    없음
    표 80. 반환
    유형 설명
    문자열 배열 세션과 관련된 오류 메시지입니다.

    범위 지정 GlideSystem - getEscapedMessage(문자열 ID, 배열 인수)

    메시지 [sys_ui_message] 테이블에서 지정된 메시지를 조회합니다. 메시지에 HTML 특수 문자가 있는 경우 해당 HTML 이름 코드로 바꿉니다. 예를 들어, &는&가 됩니다.

    지정된 메시지 식별자(키)가 현재 언어의 메시지 [sys_ui_message] 테이블에 있는 경우 메서드는 모든 특수 문자가 이스케이프 시퀀스로 반환된 번역된 메시지를 반환합니다. 현재 언어에 대해 지정된 메시지 ID가 없는 경우 메서드는 모든 특수 문자가 이스케이프 시퀀스로 반환된 영어 버전의 메시지를 반환합니다. 메시지 ID가 테이블에 없으면 메시지 ID를 리턴합니다.

    메시지 테이블에 대한 자세한 내용은 메시지 테이블을 참조하십시오.

    주:
    UI 메시지에 체크 표시(')가 있는 경우 스크립트의 메시지에 문제가 있을 수 있습니다. 틱(')을 이스케이프하려면 getMessageS(String, Object)를 사용합니다.
    표 81. 매개변수
    이름 유형 설명
    id 문자열 메시지 식별자입니다. 이 값은 메시지 [sys_ui_message] 테이블의 키 필드에서 찾을 수 있습니다. 키 필드는 실제 메시지 문자열과 정확히 같을 수 있습니다.
    args 배열 옵션입니다. 지정된 메시지 내의 변수를 대체하는 java.text.MessageFormat에 의해 정의된 문자열 또는 기타 값의 목록입니다.

    예: gs.getMessage("Abort adding action '{0}', same subflow는 두 번 추가할 수 없습니다.", current.action.name);

    이 예제에서 '{0}' 는 current.action.name 의 내용으로 대체됩니다.

    주:
    전달된 값은 변환되지 않습니다. 메시지에 그대로 삽입됩니다.
    표 82. 반환
    유형 설명
    문자열 HTML 특수 문자가 HTML 이름 코드로 바뀐 UI 메시지입니다.

    이 예제에서는 앰퍼샌드 문자가 해당하는 앰퍼샌드 HTML 이름 코드로 대체되는 것을 보여 줍니다.

    var my_message = gs.getEscapedMessage("Is the summary & details accurate?");
alert(my_message);

    출력

    Is the summary & details accurate?

    이 예제는 메시지 내에서 단일 변수를 대체하는 방법과 메시지의 < 및 > 기호가 < 및 >의 해당 HTML 이름 코드로 전치되는 방법을 보여줍니다.

    // current.action.name is "update record"
var my_message = gs.getEscapedMessage("Abort adding action '{0}', same <subflow> can't be added twice in this subflow.", current.action.name);
alert(my_message);

    출력

    Abort adding action update record, same &ltsubflow&gt can't be added twice in this subflow.

    범위 지정된 GlideSystem - getMessage(문자열 ID, 배열 인수)

    UI에 표시할 메시지 [sys_ui_message] 테이블에서 번역된 메시지를 검색합니다.

    지정된 메시지 식별자(키)가 현재 언어의 메시지 [sys_ui_message] 테이블에 있으면 메서드는 번역된 메시지를 반환합니다. 현재 언어에 대해 지정된 메시지 ID가 없는 경우 메서드는 메시지의 영어 버전을 반환합니다. 메시지 ID가 테이블에 없으면 메시지 ID를 리턴합니다.

    메시지 테이블에 대한 자세한 내용은 메시지 테이블을 참조하세요

    주:
    UI 메시지에 체크 표시(')가 있는 경우 스크립트의 메시지에 문제가 있을 수 있습니다. 틱(')을 이스케이프하려면 getMessageS(String, Object)를 사용합니다.
    표 83. 매개변수
    이름 유형 설명
    id 문자열 메시지 식별자입니다. 이 값은 메시지 [sys_ui_message] 테이블의 키 필드에서 찾을 수 있습니다. 키 필드는 실제 메시지와 똑같이 보일 수 있습니다.
    args 배열 옵션입니다. 지정된 메시지 내의 변수를 대체하는 java.text.MessageFormat에 의해 정의된 문자열 또는 기타 값의 목록입니다.

    예: gs.getMessage("Abort adding action '{0}', same subflow는 두 번 추가할 수 없습니다.", current.action.name);

    이 예제에서 '{0}' 는 current.action.name 의 내용으로 대체됩니다.

    주:
    전달된 값은 변환되지 않습니다. 메시지에 그대로 삽입됩니다.
    표 84. 반환
    유형 설명
    문자열 UI 메시지입니다.

    이 예제에서는 스페인어가 현재 언어인 경우 현재 사용자에 대해 반환되는 메시지를 보여 줍니다.

    var my_message = gs.getMessage("rows will not be updated");
alert(my_message);

    출력:

    las filas no se actualizarán

    이 예제에서는 메시지 내의 단일 변수를 바꾸는 방법을 보여 줍니다.

    // current.action.name is "update record"
var my_message = gs.getMessage("Abort adding action '{0}', same subflow can't be added twice in this subflow.", current.action.name);
alert(my_message);

    출력:

    Abort adding action update record, same subflow can't be added twice in this subflow.

    이 예제에서는 메시지 내에서 여러 변수를 바꾸는 방법을 보여 줍니다.

    // current.sub_flow.name is 'schedule users'
// current.action.name is "update record"
var my_message = gs.getEscapedMessage("Abort adding action '{0}', same subflow can't be added twice in {1} subflow.", [current.action.name, current.sub_flow.name]);
alert(my_message);

    출력:

    Abort adding action update record, same subflow can't be added twice in schedule users subflow.

    범위 지정된 GlideSystem - getProperty(문자열 키, 개체 대체)

    Glide 속성의 값을 가져옵니다. 속성을 찾을 수 없는 경우 대체 값을 반환합니다.

    표 85. 매개변수
    이름 유형 설명
    키 문자열 값을 반환해야 하는 속성의 키입니다.
    대체 객체 (선택 사항) 속성을 찾을 수 없는 경우 반환할 대체 객체입니다.
    표 86. 반환
    유형 설명
    문자열 Glide 속성 또는 위에 정의된 대체 객체의 값입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var attachment_link = gs.getProperty('glide.servlet.uri');
gs.info(attachment_link);

    출력:

    https://instance.service-now.com/

    범위가 지정된 GlideSystem - getSession()

    현재 Glide 세션에 대한 참조를 가져옵니다.

    표 87. 매개변수
    이름 유형 설명
    없음
    표 88. 반환
    유형 설명
    문자열 현재 세션에 대한 참조입니다. 
    if (!gs.hasRole("admin") && !gs.hasRole("user_admin") && gs.getSession().isInteractive()) {
  current.addQuery("active", "true");
}

    범위 지정된 GlideSystem - getSessionID()

    GlideSession 세션 ID를 검색합니다.

    표 89. 매개변수
    이름 유형 설명
    없음
    표 90. 반환
    유형 설명
    문자열 세션 ID입니다. 
    var myUserObject = gs.getSessionID();
gs.info(myUserObject);
    출력:
    A0D4E5416F3F21005BE8883E6B3EE4B8

    범위 지정된 GlideSystem - getSessionToken()

    이 메서드는 더 이상 사용할 수 없습니다. 대신 gs.getSession().getSessionToken()을 사용합니다.

    표 91. 매개변수
    이름 유형 설명
    없음
    표 92. 반환
    유형 설명
    문자열 세션 토큰입니다.

    범위 지정된 GlideSystem - getTimeFormat()

    현재 사용자와 연결된 시간 형식을 반환합니다.

    표 93. 매개변수
    이름 유형 설명
    없음
    표 94. 반환
    유형 설명
    문자열 현재 사용자와 연결된 시간 형식입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var userTimeFormat = gs. getTimeFormat();
gs.info(userTimeFormat);

    출력:

    HH:mm:ss

    범위 지정 GlideSystem - getTimeZoneName()

    현재 사용자와 연결된 시간대 이름을 반환합니다.

    이 메서드는 더 이상 사용되지 않습니다. 대신 GlideSession API에서 getTimeZoneName() 메서드를 사용하십시오.

    표 95. 매개변수
    이름 유형 설명
    없음
    표 96. 반환
    유형 설명
    문자열 시간대 이름입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    gs.info(gs.getTimeZoneName());

    범위 지정된 GlideSystem - getUrlOnStack()

    세션의 현재 URI를 가져옵니다.

    표 97. 매개변수
    이름 유형 설명
    없음
    표 98. 반환
    유형 설명
    문자열 URI입니다. 
    gs.info(gs.getUrlOnStack());

    범위 지정된 GlideSystem - getUser()

    현재 사용자의 범위가 지정된 GlideUser 객체에 대한 참조를 반환합니다.

    사용 가능한 메서드 목록은 GlideUser - 범위 지정을참조하십시오.

    표 99. 매개변수
    이름 유형 설명
    없음
    표 100. 반환
    유형 설명
    GlideUser 범위가 지정된 사용자 객체에 대한 참조입니다. 
    var myUserObject = gs.getUser();
gs.info(myUserObject);

    출력

    com.glide.script.fencing.ScopedUser@6c0645

    범위 지정된 GlideSystem - getUserDisplayName()

    현재 사용자의 표시 이름을 가져옵니다.

    표 101. 매개변수
    이름 유형 설명
    없음
    표 102. 반환
    유형 설명
    문자열 현재 사용자의 이름 필드입니다.

    예를 들어, 이 메서드는 abel.tuter가 아닌 Abel Tuter를 반환합니다.

    이 예제에서는 현재 사용자의 표시 이름을 가져옵니다.

    gs.info(gs.getUserDisplayName());

    출력:

    System Administrator

    범위 지정된 GlideSystem - getUserID()

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

    표 103. 매개변수
    이름 유형 설명
    없음
    표 104. 반환
    유형 설명
    문자열 현재 사용자의 sys_id입니다.

    다음 예는 현재 사용자에게 할당된 모든 활성 인시던트 기록의 할당을 해제하는 방법을 보여줍니다.

    var incidentGR = new GlideRecord('incident');
incidentGR.addActiveQuery();

// Filter results to incidents assigned to the current user
var currentUserSysId = gs.getUserID();
incidentGR.addQuery('assigned_to', currentUserSysId);
incidentGR.query();

while (incidentGR.next()) {
    incidentGR.setValue('assigned_to', 'NULL');
    incidentGR.update();
    gs.info(
        'Unassigned Incident: {0}: {1}',
        incidentGR.number.toString(),
        incidentGR.short_description.toString()
    );
}

    출력:

    Unassigned Incident: INC0000057: Performance problems with wifi
Unassigned Incident: INC0009001: Unable to post content on a Wiki page
Unassigned Incident: INC0008111: ATF : Test1

    범위 지정된 GlideSystem - getUserName()

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

    표 105. 매개변수
    이름 유형 설명
    없음
    표 106. 반환
    유형 설명
    문자열 현재 사용자의 사용자 이름입니다.

    예를 들어, 이 메서드는 Abel Tuter가 아닌 abel.tuter를 반환합니다.

    이 예제에서는 현재 사용자의 사용자 이름을 가져옵니다.

    gs.info("The current user name is: " + gs.getUserName());
    출력:
    The current user name is: admin

    범위 지정된 GlideSystem - hasRole(개체 역할)

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

    표 107. 매개변수
    이름 유형 설명
    role 객체 확인할 역할입니다.
    표 108. 반환
    유형 설명
    부울 사용자에게 역할이 있으면 예입니다. 관리자 역할을 가진 사용자의 경우 true를 반환합니다. 
    if (!gs.hasRole("admin") && !gs.hasRole("groups_admin")  && gs.getSession().isInteractive()) {
  var qc = current.addQuery("u_hidden", "!=", "true"); //cannot see hidden groups... 
  qc.addOrCondition("sys_id", "javascript:getMyGroups()"); //...unless in the hidden group
  gs.info("User has admin and groups admin roles");
}
else {
  gs.info("User does not have both admin and groups admin roles");
}

    범위 지정된 GlideSystem - hoursAgo(시간 수)

    지정된 시간 이전의 날짜와 시간을 반환합니다.

    표 109. 매개변수
    이름 유형 설명
    시간 번호 정수 시간 수
    표 110. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT 
    if (current.operation() == 'insert') {
 // If no due date was specified, calculate a default
 if (current.due_date == '') {
 
  if (current.urgency == '1') {
   // Set due date to 4 hours ahead of current time
   current.due_date = gs.hoursAgo(-4);
  }
 
  if (current.urgency == '2') {
   // Set due date to 2 days ahead of current time
   current.due_date = gs.daysAgo(-2);
  }
 
  if (current.urgency == '3') {
   // Set due date to 7 days ahead of current time
   current.due_date = gs.daysAgo(-7);
  }
 }
}

    범위 지정된 GlideSystem - hoursAgoEnd(시간 수)

    지정된 시간 전의 시간 종료 날짜 및 시간을 반환합니다.

    표 111. 매개변수
    이름 유형 설명
    시간 번호 정수 시간 수
    표 112. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위가 지정된 GlideSystem - hoursAgoStart(시간 수)

    지정된 시간 전의 시간 시작 날짜 및 시간을 반환합니다.

    표 113. 매개변수
    이름 유형 설명
    시간 번호 정수 시간 수
    표 114. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 GMT

    범위 지정된 GlideSystem - include(문자열 이름)

    샌드박스에서 스크립트 포함을 안전하게 호출할 수 있는 방법을 제공하여 신뢰할 수 있는 스크립트만 포함할 수 있도록 합니다.

    표 115. 매개변수
    이름 유형 설명
    이름 문자열 포함할 스크립트의 이름입니다.
    표 116. 반환
    유형 설명
    부울 스크립트 포함이 작동했는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 스크립트 포함이 작동했습니다.
    • false: 스크립트를 포함하지 못했습니다.

    이 예는 현재 스크립트 컨텍스트의 LDAPUtils를 가져옵니다.

    var ldapServer = new GlideRecord("ldap_server_config");
ldapServer.addActiveQuery();
ldapServer.query();
gs.include("LDAPUtils");
var ldapUtils = new LDAPUtils();
var errMsg = "";
while (ldapServer.next()) {
  var ldap = new GlideLDAP();
  var dn = ldapServer.dn;
  var env = ldap.setup();
  if (env == null) {
    errMsg = "Failed environment setup, missing URL";
    gs.eventQueue("ldap.connection_failed",   ldapServer, ldapServer.getDisplayValue(), errMsg);
    gs.logError("LDAP server " + ldapServer.getDisplayValue() + " failed scheduled connection test: " + errMsg, "LDAP");
 }
}

    범위가 지정된 GlideSystem - info(문자열 메시지, 객체 매개변수1, 객체 매개변수2, 객체 매개변수3, 객체 매개변수4, 객체 매개변수5)

    시스템 로그에 정보 메시지를 씁니다.

    표 117. 매개변수
    이름 유형 설명
    메시지 문자열 변수 인수에 대한 자리 표시자가 있는 로그 메시지입니다.
    param1 객체 (선택 사항) 첫 번째 변수 인수입니다.
    매개변수2 객체 (선택 사항) 두 번째 변수 인수입니다.
    param3 객체 (선택 사항) 세 번째 변수 인수입니다.
    param4 객체 (선택 사항) 네 번째 변수 인수입니다.
    param5 객체 (선택 사항) 다섯 번째 변수 인수입니다.
    표 118. 반환
    유형 설명
    void 
    gs.info("This is an info message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.info("This is an info message from {0}.{1}", myFirstName, myLastName);
    출력:
    This is an info message
This is an info message from Abel.Tuter

    범위 지정된 GlideSystem - isDebugging()

    특정 범위에 대해 디버깅이 활성 상태인지 여부를 결정합니다.

    표 119. 매개변수
    이름 유형 설명
    없음
    표 120. 반환
    유형 설명
    부울 세션 디버깅이 활성 상태이거나 로그 수준이 지정된 범위에 대해 디버그로 설정된 경우 True입니다. 
    gs.debug("This is a log message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.debug("This is a log message from {0}.{1}", myFirstName, myLastName);
gs.info(gs.isDebugging());

    범위가 지정된 GlideSystem - isInteractive()

    현재 세션이 대화형인지 확인합니다. 대화형 세션의 예는 사용자가 정상적으로 로그인하는 경우입니다. 비대화형 세션의 예로는 SOAP 요청을 사용하여 데이터를 검색하는 경우를 들 수 있습니다.

    표 121. 매개변수
    이름 유형 설명
    없음
    표 122. 반환
    유형 설명
    부울 세션이 대화형이면 True입니다. 
    if (!gs.hasRole("admin") && gs.getSession().isInteractive()) {
    var qc1 = current.addQuery('u_group',"");
    var gra = new GlideRecord('sys_user_grmember');
    gra.addQuery('user', gs.getUserID());
    gra.query();
    while (gra.next()) {
        qc1.addOrCondition('u_group', gra.group);
    }
}

    범위 지정된 GlideSystem - isLoggedIn()

    현재 사용자가 현재 로그인되어 있는지 확인합니다.

    표 123. 매개변수
    이름 유형 설명
    없음
    표 124. 반환
    유형 설명
    부울 현재 사용자가 로그인되어 있으면 True입니다. 
    gs.info(gs.isLoggedIn());

    범위가 지정된 GlideSystem - isMobile()

    요청이 모바일 장치에서 오는지 확인할 수 있습니다.

    이 메서드는 UI 작업 조건 및 비즈니스 규칙에서 사용할 수 있습니다.

    표 125. 매개변수
    이름 유형 설명
    없음
    표 126. 반환
    유형 설명
    부울 요청이 모바일 장치에서 오는 경우 True입니다. 그렇지 않으면 false입니다. 
    if (gs.isMobile())
  gs.info("submitted from mobile UI");
 else 
   gs.info("NOT submitted from mobile UI");

    출력

    NOT submitted from mobile UI

    범위가 지정된 GlideSystem - minutesAgoEnd(분)

    지정된 시간(분) 전의 분 종료 날짜 및 시간을 반환합니다.

    표 127. 매개변수
    이름 유형 설명
    분 번호 분 전의 정수(예: 5 또는 126)입니다.
    표 128. 반환
    유형 설명
    문자열 GMT 지정된 분 전, 분 끝 부분(59초)입니다.

    형식: yyyy-mm-dd hh:mm:ss

    다음 예제에서는 현재 날짜 및 시간과 30분 전의 날짜 및 시간을 GMT로 표시합니다.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
gs.info("Thirty minutes ago end time: " + thirtyMinutesAgoDateTime);

    출력:

    Now: 2021-10-20 15:22:13
Thirty minutes ago end time: 2021-10-20 14:52:59

    범위가 지정된 GlideSystem - minutesAgoStart(분)

    지정된 시간(분) 전의 시작 날짜 및 시간을 반환합니다.

    표 129. 매개변수
    이름 유형 설명
    분 번호 분 전의 정수(예: 15 또는 112)입니다.
    표 130. 반환
    유형 설명
    문자열 GMT 지정된 시간(분) 전, 분 시작 시점입니다.

    형식: yyyy-mm-dd hh:mm:ss

    다음 예제에서는 현재 날짜 및 시간과 30분 전의 날짜 및 시간을 GMT로 분 시작 부분에 표시합니다.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoStart(30);
gs.info("Thirty minutes ago: " + thirtyMinutesAgoDateTime);

    출력:

    Now: 2021-10-20 14:56:18
Thirty minutes ago: 2021-10-20 14:26:00

    범위 지정된 GlideSystem - monthsAgo(개월 수)

    지정된 개월 수의 날짜 및 시간을 반환합니다.

    표 131. 매개변수
    이름 유형 설명
    월 번호 개월 전의 정수입니다.
    표 132. 반환
    유형 설명
    문자열 정확히 같은 시간에 지정된 개월 수의 GMT입니다.

    형식: yyyy-mm-dd hh:mm:ss

    다음 예제에서는 현재 날짜 및 시간과 1개월 전 날짜 및 시간을 동시에 GMT로 표시합니다.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var oneMonthAgoDateTime = gs.monthsAgo(1);
gs.info("One month ago: " + oneMonthAgoDateTime);

    출력:

    Now: 2021-10-20 15:29:15
One month ago: 2021-09-20 15:29:15

    범위가 지정된 GlideSystem - monthsAgoStart(개월 수)

    지정된 개월 전의 월의 시작 날짜 및 시간을 반환합니다.

    표 133. 매개변수
    이름 유형 설명
    월 번호 개월 전의 정수(예: 3 또는 14)입니다.
    표 134. 반환
    유형 설명
    문자열 GMT 월의 시작 지정된 개월 수입니다.

    형식: yyyy-mm-dd hh:mm:ss

    다음 예제에서는 현재 날짜 및 시간과 3개월 전 날짜 및 시간을 GMT로 표시합니다.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var threeMonthsAgoDateTime = gs.monthsAgoStart(3);
gs.info("Three months ago start date and time: " + threeMonthsAgoDateTime);

    출력

    Now: 2021-10-20 15:05:27
Three months ago start date and time: 2021-07-01 07:00:00

    범위가 지정된 GlideSystem - nil(객체 o)

    개체를 쿼리하고 개체가 null이거나, 정의되지 않았거나, 빈 문자열을 포함하는 경우 true를 반환합니다.

    표 135. 매개변수
    이름 유형 설명
    o 객체 검사할 객체입니다.
    표 136. 반환
    유형 설명
    부울 개체가 null이거나, 정의되지 않았거나, 빈 문자열을 포함하는 경우 True입니다. 그렇지 않으면 false를 반환합니다. 
    var now_GR = new GlideRecord();
gs.info(gs.nil(now_GR));

    출력

    true

    범위 지정된 GlideSystem - quartersAgoEnd(분기 수)

    지정된 분기 수 전에 대한 분기의 마지막 날에 대한 날짜 및 시간을 반환합니다.

    표 137. 매개변수
    이름 유형 설명
    분기 번호 정수 분기 수
    표 138. 반환
    유형 설명
    문자열 지정된 분기 수였던 분기의 GMT 종료(yyyy-mm-dd hh:mm:ss 형식)

    범위 지정된 GlideSystem - quartersAgoStart(분기 수)

    지정된 분기 수 전에 대한 분기의 첫 번째 날에 대한 날짜 및 시간을 반환합니다.

    표 139. 매개변수
    이름 유형 설명
    분기 번호 정수 분기 수
    표 140. 반환
    유형 설명
    문자열 지정된 분기 수였던 월의 GMT 말(yyyy-mm-dd hh:mm:ss 형식)

    범위 지정된 GlideSystem - setProperty(문자열 키, 문자열 값, 문자열 설명)

    속성이 스크립트의 범위 내에 있는 경우 지정된 키를 지정된 값으로 설정합니다.

    주:
    이 방법을 사용하여 시스템 속성(sys_properties)을 설정할 때는 시스템 전체 캐시 플러시를 유발하므로 주의해야 합니다. 각 플러시로 인해 캐시가 다시 빌드되는 동안 시스템 성능이 저하될 수 있습니다. 값을 자주 업데이트해야 하는 경우 시스템 속성으로 저장하면 안 됩니다. 일반적으로 자주 변경되지 않는 sys_properties 테이블에만 값을 배치해야 합니다.
    표 141. 매개변수
    이름 유형 설명
    키 문자열 설정할 속성의 키입니다.
    값 문자열 설정할 속성의 값입니다.
    description 문자열 속성에 대한 설명입니다.
    표 142. 반환
    유형 설명
    void

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    gs.setProperty("glide.foo","bar","foo");
gs.info(gs.getProperty("glide.foo"));

    출력:

    bar

    범위 지정된 GlideSystem - setRedirect(Object o)

    이 트랜잭션에 대한 리디렉션 URI를 설정하여 사용자에게 표시될 다음 페이지를 결정합니다.

    표 143. 매개변수
    이름 유형 설명
    o 객체 리디렉션으로 설정할 URI 객체 또는 URI 문자열
    표 144. 반환
    유형 설명
    void 
    gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user=" 
+ current.sys_id + "&sysparm_email=" + current.email)

    범위 지정된 GlideSystem - tableExists(문자열 이름)

    데이터베이스 테이블이 존재하는지 확인합니다.

    표 145. 매개변수
    이름 유형 설명
    이름 문자열 존재 여부를 확인할 테이블의 이름입니다.
    표 146. 반환
    유형 설명
    부울 테이블이 존재하면 예입니다. 테이블을 찾을 수 없는 경우 False입니다.

    이 예시에서는 인시던트 테이블과 foo 테이블이 ServiceNow 인스턴스에 존재하는지 여부를 확인하는 방법을 보여줍니다.

    gs.info("Does the incident table exist? " + gs.tableExists("incident"));

gs.info("Does the foo table exist? " + gs.tableExists("foo"));

    출력:

    Does the incident table exist? true
Does the foo table exist? false

    범위 지정된 GlideSystem - urlEncode(문자열 url)

    반환된 문자열을 인터넷에서 사용할 수 있도록 ASCII가 아닌 문자, 안전하지 않은 ASCII 문자 및 공백을 인코딩합니다. UTF-8 인코딩을 사용합니다. 퍼센트(%) 인코딩을 사용합니다.

    표 147. 매개변수
    이름 유형 설명
    URL 문자열 인코딩할 문자열입니다.
    표 148. 반환
    유형 설명
    문자열 ASCII가 아닌 문자, 안전하지 않은 ASCII 문자 및 공백이 인코딩된 문자열입니다.

    범위 지정 GlideSystem - urlDecode(문자열 url)

    UTF-8로 인코딩된 문자를 ASCII 문자로 바꿉니다.

    표 149. 매개변수
    이름 유형 설명
    URL 문자열 UTF-8 퍼센트(%) 인코딩 문자입니다.
    표 150. 반환
    유형 설명
    문자열 인코딩된 문자가 ASCII 문자로 바뀝니다.

    범위가 지정된 GlideSystem - 경고(문자열 메시지, 객체 매개변수1, 객체 매개변수2, 객체 매개변수3, 객체 매개변수4, 객체 매개변수5)

    시스템 로그에 경고 메시지를 씁니다.

    표 151. 매개변수
    이름 유형 설명
    메시지 문자열 변수 인수에 대한 자리 표시자가 있는 로그 메시지입니다.
    param1 객체 (선택 사항) 첫 번째 변수 인수입니다.
    매개변수2 객체 (선택 사항) 두 번째 변수 인수입니다.
    param3 객체 (선택 사항) 세 번째 변수 인수입니다.
    param4 객체 (선택 사항) 네 번째 변수 인수입니다.
    param5 객체 (선택 사항) 다섯 번째 변수 인수입니다.
    표 152. 반환
    유형 설명
    void 
    gs.warn("This is a warning");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.warn("This is a warning from {0}.{1}", myFirstName, myLastName);
    출력:
    This is a warning
This is a warning from Abel.Tuter

    범위 지정된 GlideSystem - xmlToJSON(String xmlString)

    XML 문자열을 가져와 JSON 객체를 반환합니다.

    표 153. 매개변수
    이름 유형 설명
    xml문자열 문자열 변환할 XML 문자열입니다.
    표 154. 반환
    유형 설명
    객체 XML 문자열을 나타내는 JSON 객체입니다. XML 문자열을 처리할 수 없는 경우 Null입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var jsonObject = gs.xmlToJSON(xmlString);

    범위가 지정된 GlideSystem - yearsAgo(연수)

    특정 연도 전의 날짜와 시간을 반환합니다.

    표 155. 매개변수
    이름 유형 설명
    년 번호 정수(연도)
    표 156. 반환
    유형 설명
    문자열 GMT 지정된 연도 전의 연도 시작(yyyy-mm-dd hh:mm:ss 형식)입니다.

    범위가 지정된 GlideSystem - yesterday()

    어제 시간(24시간 전)을 반환합니다.

    표 157. 매개변수
    이름 유형 설명
    없음
    표 158. 반환
    유형 설명
    문자열 24시간 전 GMT(yyyy-mm-dd hh:mm:ss 형식)