GlideSystem - 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 98분
  • 서버 측 JavaScript에서 변수 이름 gs로 참조되는 GlideSystem API는 시스템에 대한 정보, 현재 로그인한 사용자 및 날짜/시간 정보를 얻을 수 있는 여러 가지 편리한 메서드를 제공합니다.

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

    GlideSystem - addErrorMessage(객체 메시지)

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

    getErrorMessages()를 사용하여 현재 표시 중인 오류 메시지의 목록을 검색합니다.

    표 1. 매개변수
    이름 유형 설명
    메시지 객체 추가할 메시지입니다.
    표 2. 반환
    유형 설명
    무효
    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
           }
      }
    [edit]

    범위가 지정된 해당 항목

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

    GlideSystem - addHighMessage(문자열 메시지)

    양식 상단에 높은 우선순위 메시지를 표시합니다.

    표 3. 매개변수
    이름 유형 설명
    메시지 문자열 표시할 높은 우선순위 메시지입니다.
    표 4. 반환
    유형 설명
    무효

    다음 예제에서는 양식 맨 위에 높은 우선 순위 메시지를 표시하는 방법을 보여 줍니다.

    gs.addHighMessage("This is a high priority message");

    GlideSystem - addInfoMessage(객체 메시지)

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

    getInfoMessages()를 사용하여 표시되는 정보 메시지 목록을 검색합니다. 이 메서드는 비동기 비즈니스 규칙에 지원되지 않으며 변환 스크립트 내에서 사용할 수 없습니다.

    표 5. 매개변수
    이름 유형 설명
    메시지 객체 추가할 메시지입니다.
    표 6. 반환
    유형 설명
    무효
    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);
      }
    }

    범위가 지정된 해당 항목

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

    GlideSystem - addLowMessage(문자열 메시지)

    양식 상단에 우선순위가 낮은 메시지를 표시합니다.

    표 7. 매개변수
    이름 유형 설명
    메시지 문자열 표시할 낮은 우선순위 메시지입니다.
    표 8. 반환
    유형 설명
    무효

    다음 예제에서는 양식 맨 위에 우선 순위가 낮은 메시지를 표시하는 방법을 보여 줍니다.

    gs.addLowMessage("This is a low priority message");

    GlideSystem - addMessage(문자열 유형, 객체 메시지)

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

    표 9. 매개변수
    이름 유형 설명
    유형 문자열 오류 또는 정보와 같은 메시지 유형입니다.
    메시지 객체 현재 세션에 추가할 메시지입니다.
    표 10. 반환
    유형 설명
    무효

    GlideSystem - addModerateMessage(문자열 메시지)

    양식 상단에 보통 우선순위 메시지를 표시합니다.

    표 11. 매개변수
    이름 유형 설명
    메시지 문자열 표시할 보통 메시지입니다.
    표 12. 반환
    유형 설명
    없음

    다음 예제에서는 양식 맨 위에 보통 우선 순위 메시지를 표시하는 방법을 보여 줍니다.

    gs.addModerateMessage("This is a moderate priority message");

    GlideSystem - addSuccessMessage(문자열 메시지)

    양식 상단에 성공적인 작업을 확인하는 메시지를 표시합니다.

    표 13. 매개변수
    이름 유형 설명
    메시지 문자열 표시할 성공 메시지입니다.
    표 14. 반환
    유형 설명
    무효

    다음 예제에서는 양식 맨 위에 성공 확인 메시지를 표시하는 방법을 보여 줍니다.

    gs.addSuccessMessage("This is a success message");

    GlideSystem - beginningOfLastMonth()

    사용자의 세션 시간대에 있는 지난달 초 날짜 및 시간을 UTC 타임스탬프로 가져옵니다.

    표 15. 매개변수
    이름 유형 설명
    안 함
    표 16. 반환
    유형 설명
    문자열 지난달 초 UTC로 yyyy-mm-dd hh:mm:ss 형식입니다.

    이 예에서는 GlideDateTime 객체의 날짜 및 시간을 지난달 초로 설정합니다.

    var date = new GlideDate();
    date.setValue(gs.beginningOfLastMonth());
    var dateasint = date.toString().replace('-','');
    gs.print(dateasint);

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfLastWeek()

    사용자의 세션 시간대에 지난 주 시작 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 17. 매개변수
    이름 유형 설명
    안 함
    표 18. 반환
    유형 설명
    문자열 지난주 초(UTC)

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

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 지난 주 초로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfLastWeek());

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfNextWeek()

    사용자의 세션 시간대에 다음 주 시작 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 19. 매개변수
    이름 유형 설명
    안 함
    표 20. 반환
    유형 설명
    문자열 다음 주 초의 UTC입니다.

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

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 다음 주 초로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfNextWeek());

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfNextMonth()

    사용자의 세션 시간대에 다음 달 초 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 21. 매개변수
    이름 유형 설명
    안 함
    표 22. 반환
    유형 설명
    문자열 다음 달 초 UTC.

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

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 다음 달 초로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfNextMonth());

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfNextYear()

    사용자의 세션 시간대에 내년 초 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 23. 매개변수
    이름 유형 설명
    안 함
    표 24. 반환
    유형 설명
    문자열 내년 초 UTC는 yyyy-mm-dd hh:mm:ss 형식입니다.

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 다음 연초로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfNextYear());

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfThisMonth()

    사용자의 세션 시간대에 있는 현재 달의 시작 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 25. 매개변수
    이름 유형 설명
    안 함
    표 26. 반환
    유형 설명
    문자열 UTC 현재 달의 초.

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

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 이번 달 초로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfThisMonth());

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfThisQuarter()

    사용자의 세션 시간대에 있는 현재 분기의 시작 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 27. 매개변수
    이름 유형 설명
    안 함
    표 28. 반환
    유형 설명
    문자열 현재 분기의 UTC 시작입니다.

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

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 현재 분기의 시작으로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfThisQuarter());

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfThisWeek()

    사용자의 세션 시간대에 있는 이번 주 시작 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 29. 매개변수
    이름 유형 설명
    안 함
    표 30. 반환
    유형 설명
    문자열 UTC 현재 주의 시작.

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

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 현재 주의 시작으로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfThisWeek());

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfThisYear()

    사용자의 세션 시간대에 올해 초의 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 31. 매개변수
    이름 유형 설명
    안 함
    표 32. 반환
    유형 설명
    문자열 UTC 현재 연도 초.

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

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 현재 연도의 시작으로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfThisYear());

    범위가 지정된 해당 항목

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

    GlideSystem - beginningOfToday()

    사용자의 세션 시간대에서 오늘의 시작 날짜 및 시간을 UTC 타임스탬프로 조회합니다.

    표 33. 매개변수
    이름 유형 설명
    안 함
    표 34. 반환
    유형 설명
    문자열 현재 날짜의 UTC 시작입니다.

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

    이 예에서는 현재 Glide 날짜/시간 기록의 값을 현재 날짜의 시작으로 설정합니다.

    var gdt2 = new GlideDateTime(dt);
    gdt2.setValue(gs.beginningOfToday());

    GlideSystem - beginningOfTomorrow()

    사용자의 현재 세션의 시간대에 맞게 조정된 내일의 (UTC) 시작을 조회합니다.

    표 35. 매개변수
    이름 유형 설명
    안 함
    표 36. 반환
    유형 설명
    문자열 내일 UTC 초.

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

    var today = new GlideDateTime(gs.beginningOfTomorrow()).getNumericValue();

    GlideSystem - beginningOfYesterday()

    사용자의 세션 시간대에서 어제의 시작 날짜 및 시간을 UTC 타임스탬프로 조회합니다.

    표 37. 매개변수
    이름 유형 설명
    안 함
    표 38. 반환
    유형 설명
    문자열 어제 UTC로 yyyy-mm-dd hh:mm:ss 형식입니다.
    var start = new GlideDateTime();
    start.setValue(gs.beginningOfYesterday());

    GlideSystem - calDateDiff(String startDate, String endDate, Boolean numericValue)

    기본 달력을 사용하여 두 날짜의 차이를 계산합니다.

    달력은 이제 레거시입니다. 일정을 사용 중인 경우 이 항목 일정 스크립트 사용 사례의 '지정된 일정 동안 계산' 섹션을 참조하십시오.

    표 39. 매개변수
    이름 유형 설명
    startDate 문자열 현재 사용자의 날짜 형식으로 비교할 시작 날짜입니다.
    endDate 문자열 현재 사용자의 날짜 형식으로 비교할 종료 날짜입니다.
    숫자 값 부울 반환된 시간 값의 형식을 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.

    • true: 반환 값은 초 단위로 지정됩니다.
    • 아니오: 반환 값의 형식은 ddd hh:mm:ss입니다.
    표 40. 반환
    유형 설명
    문자열 매개변수가 numericValue 예일 경우 두 날짜 간의 차이를 정수(초)로 반환합니다.

    false인 경우 두 날짜 간의 차이를 ddd hh:mm:ss 형식으로 반환합니다.

    var endDateTime = gs.nowDateTime();
    gs.print('--- Total records: ' + countRecordsTotal);
    gs.print('--- End time: ' + endDateTime);
    gs.print('Time diff: ' + gs.calDateDiff(startDateTime, endDateTime));

    GlideSystem - dateDiff(String startDate, String endDate, Boolean numericValue)

    두 날짜 간의 차이를 계산합니다.

    이 메서드는 이전 날짜를 첫 번째 매개변수로 예상하고 이후 날짜를 두 번째 매개변수로 예상합니다. 그렇지 않으면 메서드는 차이를 음수 값으로 반환합니다. getDisplayValue()를 사용하여 문자열을 예상 형식으로 변환합니다.

    이 메서드에는 사용자/시스템 날짜 시간 형식의 매개변수가 필요하며 내부 형식과 다를 수 있습니다. 사용자/시스템 날짜 시간 형식 이외의 형식으로 매개변수를 사용하면 잘못된 결과가 반환될 수 있습니다.

    GlideDateTime 객체로 작업하는 경우 dateDiff() 대신 GlideDateTime subtract() 메서드를 사용합니다.

    표 41. 매개변수
    이름 유형 설명
    startDate 문자열 현재 사용자의 날짜 형식으로 비교할 시작 날짜입니다.
    endDate 문자열 현재 사용자의 날짜 형식으로 비교할 종료 날짜입니다.
    숫자 값 부울 예일 경우 반환 값은 초 단위로 형식이 지정됩니다. 아니오인 경우 반환 값은 ddd hh:mm:ss 형식이 됩니다.
    표 42. 반환
    유형 설명
    문자열 numericValue 매개변수가 true이면 두 날짜의 차이를 정수(초)로 반환합니다. false인 경우 두 날짜 간의 차이를 ddd hh:mm:ss 형식으로 반환합니다.
    // Given two date/times as DateTime objects
    // Set the values this way to ensure a consistent input time
    var date1 = new GlideDateTime();
    var date2 = new GlideDateTime();
    date1.setDisplayValueInternal('2014-01-01 12:00:00');
    date2.setDisplayValueInternal('2014-01-01 13:00:00');
     
    // Determine the difference as number of seconds (returns a string)
    // Use getDisplayValue() to convert the string to the format expected by dateDiff()
    var diffSeconds = gs.dateDiff(date1.getDisplayValue(), date2.getDisplayValue(), true);
     
    // JavaScript will coerce diffSeconds from a string to a number
    // since diffSeconds is being compared to a number
    var msg = (diffSeconds <= 0) ? ' is on or after ' : ' is before ';
    gs.print(date1.getDisplayValue() + msg + date2.getDisplayValue())

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

    사용자의 세션 시간대에 지정된 날짜의 날짜 및 시간을 UTC 타임스탬프로 생성합니다.

    표 43. 매개변수
    이름 유형 설명
    날짜 문자열 생성할 날짜(UTC)입니다.

    형식: yyyy-mm-dd

    범위 문자열 시작, 종료 또는 시간입니다.

    형식: 24시간 hh:mm:ss

    표 44. 반환
    유형 설명
    문자열 생성된 날짜 및 시간입니다.

    범위가 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

    범위가 지정된 해당 항목

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

    GlideSystem - daysAgo(숫자 일)

    특정 일수 전의 날짜 및 시간을 반환합니다. 사용자의 세션 시간대에 UTC 타임스탬프로 반환됩니다.

    표 45. 매개변수
    이름 유형 설명
    번호 날짜 수
    표 46. 반환
    유형 설명
    문자열 지정된 일수 전의 UTC입니다.

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

    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();
    }

    범위가 지정된 해당 항목

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

    GlideSystem - daysAgoEnd(일 수)

    지정된 일수 전의 하루가 끝난 날짜 및 시간을 반환합니다. 사용자의 세션 시간대에 있는 값을 UTC 타임스탬프로 반환합니다.

    표 47. 매개변수
    이름 유형 설명
    번호 정수 일 수
    표 48. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식으로 된 UTC 하루의 끝입니다.

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

    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.addInfoMessage("Count: " +tableData.getRowCount());

    범위가 지정된 해당 항목

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

    GlideSystem - daysAgoLocal(일 수)

    지정된 일수 전에 해당하는 일의 시작 날짜 및 시간을 반환합니다. 반환된 날짜 및 시간은 현재 세션의 시간대(현지 시간)를 반영합니다.

    표 49. 매개변수
    이름 유형 설명
    번호 일수 전
    표 50. 반환
    유형 설명
    문자열 사용자 정의된 날짜 시간 형식으로 된 하루의 시작에 해당하는 현지 시간 날짜 및 시간입니다. 날짜 시간 형식이 초기 값에서 수정되지 않은 경우 형식은 yyyy-mm-dd hh:mm:ss입니다.
    if (due_in == "1 Day") {
      dd = gs.daysAgoLocal(-1);
    }
    if (due_in == "1 Week") {
      dd = gs.daysAgoLocal(-7);
    }

    GlideSystem - daysAgoStart(일 수)

    지정된 일수 전 하루의 시작에 대한 날짜 및 시간을 반환합니다. 사용자의 세션 시간대에 UTC 타임스탬프로 반환됩니다.

    표 51. 매개변수
    이름 유형 설명
    문자열 정수 일 수
    표 52. 반환
    유형 설명
    문자열 YYYY-MM-DD HH:MM:SS 형식의 UTC 하루의 시작
    var now_GR = new GlideRecord('sysapproval_approver');
    now_GR.addQuery('state', 'requested');
    now_GR.addQuery('sys_updated_on', '<', gs.daysAgoStart(5));
    now_GR.query();

    범위가 지정된 해당 항목

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

    GlideSystem - 지난달의 끝()

    사용자의 세션 시간대에 지난 달 말 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 53. 매개변수
    이름 유형 설명
    안 함
    표 54. 반환
    유형 설명
    문자열 지난 달 말 UTC입니다.

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

    이 예에서는 지난 달의 마지막 날의 보고서 기록을 쿼리하는 방법을 보여줍니다.

    var month = gs.endOfLastMonth();
    var monthd = new GlideDateTime(month);
    monthd.addDays(-1);
    
    var queueLast = new GlideRecord('u_amazon_connect_phone_metrics');
    queueMtd.addQuery('u_queue_name',queueNames[i]);
    queueMtd.addEncodedQuery('u_time_range=MTD');
    queueMtd.addEncodedQuery('u_report_date'+ monthd);
    queueMtd.orderByDesc('u_report_date');
            
    queueMtd.query();
    
    if(queueMtd.next()){
      gs.info(queueMtd.u_report_date);
    } 

    범위가 지정된 해당 항목

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

    GlideSystem - 지난주 종료()

    사용자의 세션 시간대에 지난 주말 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 55. 매개변수
    이름 유형 설명
    안 함
    표 56. 반환
    유형 설명
    문자열 지난 주말 UTC.

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

    이 예에서는 이전 달의 마지막 주에 오픈된 기록을 쿼리하는 방법을 보여줍니다.

    var inc = new GlideRecord('incident');
    inc.addQuery('active=true^priority=1^opened_atONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()^opened_atONLast week@javascript:gs.beginningOfLastWeek()@javascript:gs.endOfLastWeek()');
    inc.query();
    while(inc.next())
     {
       gs.addInfoMessage(inc.getRowCount());
     }

    범위가 지정된 해당 항목

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

    GlideSystem - endOfLastYear()

    사용자의 세션 시간대에 작년 말 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 57. 매개변수
    이름 유형 설명
    안 함
    표 58. 반환
    유형 설명
    문자열 yyyy-mm-dd hh:mm:ss 형식의 UTC입니다.

    이 예에서는 작년에 생성된 모든 기록에 대해 생성된 기록을 쿼리하는 방법을 보여줍니다.

    var inc = new GlideRecord('incident');
    inc.addEncodedQuery('sys_created_onONLast year@javascript:gs.beginningOfLastYear()@javascript:gs.endOfLastYear()');
    inc.query();
    while(inc.next()){
      inc.assignment_group = "d625dccec0a8016700a222a0f7900d06";
      inc.update();
    }

    범위가 지정된 해당 항목

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

    GlideSystem - endOfNextMonth()

    사용자의 세션 시간대에 다음 달 말 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 59. 매개변수
    이름 유형 설명
    안 함
    표 60. 반환
    유형 설명
    문자열 UTC 데이터 및 시간입니다.

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

    이 예에서는 오늘부터 다음 달 말까지 생성된 KB 지식 기록을 쿼리하는 방법을 보여줍니다.

    var query = "kb_knowledge_base=e81c9a0ddbc15810c38f0763b99619c1^ORkb_knowledge_base=21302e89db055810c38f0763b99619cc^valid_toBETWEENjavascript:gs.beginningOfToday()@javascript:gs.endOfNextMonth()^ORworkflow_state=pending_retirement^latest=true";
    var rec = new GlideRecord('kb_knowledge');
    rec.addEncodedQuery(query);
    rec.addQuery('author', current.author);
    rec.query();
    while (rec.next()) {
      var Kbtitle = rec.getValue('short_description');
      articles.push(rec.number.toString()+ '' + Kbtitle);
      template.print('Click here to view record<a href="https://give urs instance url here/nav_to.do?uri=kb_knowledge.do?sys_id=' + rec.sys_id + '">' + rec.number + '</a>');
    }
    var articlesList = "<ul>";
    for (i = 0; i <= articles.length-1; i++) {
      articlesList = articlesList + "<li>" + articles[i] + "</li>";
    }
    articlesList = articlesList + "</ul>";

    범위가 지정된 해당 항목

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

    GlideSystem - endOfNextWeek()

    사용자의 세션 시간대에 다음 주말 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 61. 매개변수
    이름 유형 설명
    안 함
    표 62. 반환
    유형 설명
    문자열 다음 주말의 UTC 날짜 및 시간입니다.

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

    이 예에서는 쿼리에서 endOfNextWeek() 를 사용하여 지난 주의 모든 방문자를 가져오는 방법을 보여줍니다.

    var title = 'Visitors arriving this Week';
    var visitorQuery = 'active=true^category=visitor_request^u_my_start_dateONThis week@javascript:gs.beginningOfThisWeek()@javascript:gs.endOfNextWeek()';

    범위가 지정된 해당 항목

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

    GlideSystem - endOfNextYear()

    사용자의 세션 시간대에 내년 말 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 63. 매개변수
    이름 유형 설명
    안 함
    표 64. 반환
    유형 설명
    문자열 내년 말의 UTC 날짜 및 시간입니다.

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

    이 예제에서는 endOfNextYear() 를 사용하여 GlideDateTime 객체를 다음 연말로 설정하는 방법을 보여줍니다.

    setEndDate : function(dt) {
      var gdt2 = new GlideDateTime(dt);
      gdt2.setValue(gs.endOfNextYear());
    }

    범위가 지정된 해당 항목

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

    GlideSystem - endOfThisMonth()

    사용자의 세션 시간대로 이번 달 말 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 65. 매개변수
    이름 유형 설명
    안 함
    표 66. 반환
    유형 설명
    문자열 이번 달 말의 UTC 날짜 및 시간입니다.

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

    이 예시에서는 endOfThisMonth() 를 사용하여 GlideDateTime 객체를 현재 월의 끝으로 설정하는 방법을 보여줍니다.

    setEndDate : function(dt) {
      var gdt2 = new GlideDateTime(dt);
      gdt2.setValue(gs.endOfThisMonth());
    }

    범위가 지정된 해당 항목

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

    GlideSystem - endOfThisQuarter()

    사용자의 세션 시간대에 이 분기 말의 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 67. 매개변수
    이름 유형 설명
    안 함
    표 68. 반환
    유형 설명
    문자열 이번 분기 말의 UTC 날짜 및 시간입니다.

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

    이 예시에서는 endOfThisQuarter() 를 사용하여 GlideDateTime 객체를 현재 월의 끝으로 설정하는 방법을 보여줍니다.

    setEndDate : function(dt) {
      var gdt2 = new GlideDateTime(dt);
      gdt2.setValue(gs.endOfThisQuarter());
    }

    범위가 지정된 해당 항목

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

    GlideSystem - endOfThisWeek()

    사용자의 세션 시간대에 있는 이번 주 말의 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 69. 매개변수
    이름 유형 설명
    안 함
    표 70. 반환
    유형 설명
    문자열 이번 주말의 UTC 날짜 및 시간입니다.

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

    이 예시에서는 endOfThisWeek() 를 사용하여 GlideDateTime 객체를 현재 월의 끝으로 설정하는 방법을 보여줍니다.

    setEndDate : function(dt) {
      var gdt2 = new GlideDateTime(dt);
      gdt2.setValue(gs.endOfThisWeek());
    }

    범위가 지정된 해당 항목

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

    GlideSystem - endOfThisYear()

    사용자의 세션 시간대에 올해 말 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 71. 매개변수
    이름 유형 설명
    안 함
    표 72. 반환
    유형 설명
    문자열 올해 말의 UTC 날짜 및 시간입니다.

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

    이 예시에서는 endOfThisYear() 를 사용하여 GlideDateTime 객체를 현재 월의 끝으로 설정하는 방법을 보여줍니다.

    setEndDate : function(dt) {
      var gdt2 = new GlideDateTime(dt);
      gdt2.setValue(gs.endOfThisYear());
    }

    범위가 지정된 해당 항목

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

    GlideSystem - endOfToday()

    사용자의 세션 시간대에서 오늘 종료 날짜 및 시간을 UTC 타임스탬프로 조회합니다.

    표 73. 매개변수
    이름 유형 설명
    안 함
    표 74. 반환
    유형 설명
    문자열 UTC를 yyyy-mm-dd hh:mm:ss 형식으로 설정합니다.
    var beginToday = gs.beginningOfToday(); 
            var endToday = gs.endOfToday(); 
            var beginTomorrow = gs.beginningOfTomorrow(); 
            var endTomorrow = gs.endOfTomorrow(); 
            var beginYesterday = gs.beginningOfYesterday(); 
            var endYesterday = gs.endOfYesterday(); 
            
            gs.info('beginningOfToday: ' + beginToday); 
            gs.info('endOfToday: ' + endToday); 
            gs.info('-----------'); 
            gs.info('beginningOfTomorrow: ' + beginTomorrow); 
            gs.info('endOfTomorrow: ' + endTomorrow); 
            gs.info('beginningOfYesterday: ' + beginYesterday); 
            gs.info('endOfYesterday: ' + endYesterday); 
            gs.info('-----------'); 
            var gdt1 = new GlideDateTime(beginToday); 
            var gdt2 = new GlideDateTime(beginTomorrow); 
            var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2 
            gs.info('BeginTomorrow: ' + dur.getDisplayValue()); 
            
            var gdt1 = new GlideDateTime(endToday); 
            var gdt2 = new GlideDateTime(endTomorrow); 
            var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2 
            gs.info('EndTomorrow: ' + dur.getDisplayValue()); 
            
            var gdt1 = new GlideDateTime(beginToday); 
            var gdt2 = new GlideDateTime(beginYesterday); 
            var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2 
            gs.info('BeginningYesterday: ' + dur.getDisplayValue()); 
            
            var gdt1 = new GlideDateTime(endToday); 
            var gdt2 = new GlideDateTime(endYesterday); 
            var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2 
            gs.info('EndYesterday: ' + dur.getDisplayValue());

    GlideSystem - endOfTomorrow()

    내일 종료 날짜 및 시간을 사용자의 세션 시간대로 UTC 타임스탬프로 조회합니다.

    표 75. 매개변수
    이름 유형 설명
    안 함
    표 76. 반환
    유형 설명
    문자열 UTC를 yyyy-mm-dd hh:mm:ss 형식으로 설정합니다.
    var tomorrowEnd = new GlideDateTime();
    tomorrowEnd.setValue(gs.endOfTomorrow());

    GlideSystem - endOfYesterday()

    사용자의 세션 시간대에서 어제 종료 날짜 및 시간을 UTC 타임스탬프로 가져옵니다.

    표 77. 매개변수
    이름 유형 설명
    안 함
    표 78. 반환
    유형 설명
    문자열 형식(yyyy-mm-dd huh:mm:ss)의 UTC입니다.
    var yesterdayEnd = new GlideDateTime();
    yesterdayEnd.setValue(gs.endOfYesterday());

    GlideSystem - eventQueue(문자열 이름, 객체 glideRecord, 문자열 parm1, 문자열 parm2, 문자열 큐)

    이벤트 관리자에 대한 이벤트를 큐에 대기시킵니다.

    표 79. 매개변수
    이름 유형 설명
    이름 문자열 큐에 대기 중인 이벤트의 이름입니다.
    glideRecord 객체 "current"와 같은 GlideRecord 객체
    parm1 문자열 (선택 사항) 지정된 경우 인스턴스와 함께 저장됩니다.
    parm2 문자열 (선택 사항) 지정된 경우 인스턴스와 함께 저장됩니다.
    문자열 큐 이름.
    표 80. 반환
    유형 설명
    무효
    if (current.operation() != 'insert' && current.comments.changes()) {
        gs.eventQueue("incident.commented", current, gs.getUserID(), gs.getUserName());
    }

    범위가 지정된 해당 항목

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

    GlideSystem - eventQueueScheduled(문자열 이름, 객체 glideRecord, 문자열 매개변수 1, 문자열 매개변수 2, 객체 만료)

    지정된 날짜 및 시간에 이벤트 관리자에 대한 이벤트를 큐에 대기합니다.

    표 81. 매개변수
    이름 유형 설명
    이름 문자열 큐에 대기 중인 이벤트의 이름입니다.
    glideRecord 객체 "current"와 같은 GlideRecord 객체
    parm1 문자열 (선택 사항) 지정된 경우 인스턴스와 함께 저장됩니다.
    parm2 문자열 (선택 사항) 지정된 경우 인스턴스와 함께 저장됩니다.
    만료 객체 이 이벤트를 처리할 날짜 및 시간입니다.
    표 82. 반환
    유형 설명
    무효
    if (current.operation() != 'insert' && current.comments.changes()) {
        gs.eventQueueScheduled("incident.commented", current, gs.getUserID(), gs.getUserName(), new GlideDateTime('2018-06-02 20:00:00'));
    }

    범위가 지정된 해당 항목

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

    GlideSystem - flushMessages()

    addErrorMessage() 또는 addInfoMessage()를 사용하여 저장된 세션 메시지를 지웁니다.

    세션 메시지는 양식의 맨 위에 표시됩니다. 클라이언트 측 스크립트에서 g_form.clearMessages() 를 사용하여 세션 메시지를 제거합니다.

    표 83. 매개변수
    이름 유형 설명
    안 함
    표 84. 반환
    유형 설명
    무효

    이 예제에서는 오류 메시지를 구문 분석하고 다시 전달한 다음 flushMessages()를 사용하여 메시지를 지우는 방법을 보여줍니다.

    MySessionUtil.getSessionError = function() {
      var msg = null;
      var msgs = gs.getErrorMessages().toArray();
      if (msgs.length > 0) {
        msg = msgs[0] + '';
        gs.flushMessages();
      }
      return msg;
    };
    

    GlideSystem - getAvatar()

    사용자의 아바타에 대한 파일 경로를 반환합니다.

    표 85. 매개변수
    이름 유형 설명
    안 함
    표 86. 반환
    유형 설명
    문자열 사용자의 아바타에 대한 파일 경로입니다.
    var avatarFile = gs.getUser().getAvatar();        
    gs.addInfoMessage('User avatar ID: ' + avatarFile);

    출력:

    User avatar ID: c148e1d13741310042106710ce41f149.iix?t=small

    GlideSystem - getCurrentScopeName()

    현재 애플리케이션 범위의 이름을 반환합니다.

    표 87. 매개변수
    이름 유형 설명
    안 함
    표 88. 반환
    유형 설명
    문자열 현재 범위 이름입니다.

    이 예제에서는 getCurrentScopeName() 을 사용하여 프로세서의 범위를 가져오는 방법을 보여줍니다.

    var incident_GR = new GlideRecord('Incident');
    
    if (incident_GR.get("2e3f6baddb9ad600added8fdbf9618cb")) {
      gs.debug("processor scope = "+ gs.getCurrentScopeName());
      var w = new global.Workflow();
      var context = w.startFlow('1f4a4baddb9ad600affed8fdbf9619bc', incident_GR, "update");   //id = id workflow
    }

    범위가 지정된 해당 항목

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

    GlideSystem - getDateFormat()

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

    표 89. 매개변수
    이름 유형 설명
    안 함
    표 90. 반환
    유형 설명
    문자열 현재 사용자와 연결된 날짜 형식입니다.

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

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

    출력:

    yyyy-MM-dd

    GlideSystem - getDateTimeFormat()

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

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

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

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

    출력:

    yyyy-MM-dd HH:mm:ss

    GlideSystem - getDisplayColumn(문자열 tableName)

    테이블의 표시 열을 검색합니다.

    표 93. 매개변수
    이름 유형 설명
    tableName 문자열 표시 열 이름을 가져올 테이블의 이름입니다.
    표 94. 반환
    유형 설명
    문자열 표시 열 이름
    // Return the sys_id value for a given table and its display value
    function GetIDValue(table, displayValue) { 
        var rec = new GlideRecord(table);
        var dn = gs.getDisplayColumn(table);
        if (rec.get(dn, displayValue))
            return rec.sys_id;
        else
            return null;
    }

    GlideSystem - getDisplayValueFor(String tableName, String recordID, String fieldName)

    지정된 기록의 특정 필드에 대한 표시 값을 반환합니다.

    표 95. 매개변수
    이름 유형 설명
    tableName 문자열 테이블의 이름입니다.
    recordID 문자열 기록에 대한 Sys_id입니다.
    fieldName 문자열 표시 값을 반환할 필드의 이름입니다.
    표 96. 반환
    유형 설명
    문자열 필드의 값을 표시합니다.

    이 예시에서는 getDisplayValueFor() 를 사용하여 숫자 필드의 표시 값을 반환하는 방법을 보여줍니다.

    var value = gs.getDisplayValueFor(current.getTableName(),current.getValue('sys_id'),'number');
    

    GlideSystem - getErrorMessages()

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

    표 97. 매개변수
    이름 유형 설명
    안 함
    표 98. 반환
    유형 설명
    문자열 오류 메시지 목록

    이 예제에서는 getErrorMessages()를 사용하여 오류 메시지를 구문 분석하고 다시 전달하는 방법을 보여줍니다.

    MySessionUtil.getSessionError = function() {
      var msg = null;
      var msgs = gs.getErrorMessages().toArray();
      if (msgs.length > 0) {
        msg = msgs[0] + '';
        gs.flushMessages();
      }
      return msg;
    };
    

    범위가 지정된 해당 항목

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

    GlideSystem - getEscapedProperty(문자열 키, 객체 substituteObject)

    XML 구문 분석을 위해 속성을 검색하고 이스케이프합니다.

    표 99. 매개변수
    이름 유형 설명
    문자열 값을 반환해야 하는 속성의 키입니다.
    substituteObject 객체 옵션입니다. 속성을 찾을 수 없는 경우 반환할 객체입니다.
    표 100. 반환
    유형 설명
    문자열 속성 또는 속성을 찾을 수 없는 경우 substituteObject입니다.
    var propValue = gs.getEscapedProperty("com.example.my_test_property");
    gs.addInfoMessage("This is my property value " + propValue);

    GlideSystem - getImpersonatingUserDisplayName()

    가장 사용자의 표시 이름을 반환합니다.

    표 101. 매개변수
    이름 유형 설명
    안 함
    표 102. 반환
    유형 설명
    문자열 가장 사용자의 표시 이름입니다.

    이 예제에서는 가장자의 사용자 표시 이름을 가져오는 방법을 보여 줍니다.

    var user = gs.getUserDisplayName();
    gs.print ("The current user display name is: " + user);
    
    var name = gs.getImpersonatingUserDisplayName(); 
    gs.print("Impersonating user display name: " + name);
    출력:
    The current user display name is: abel.tuter
    Impersonating user display name: admin

    GlideSystem - getImpersonatingUserName()

    가장 사용자의 이름을 반환하거나 가장하지 않는 경우 null을 반환합니다.

    표 103. 매개변수
    이름 유형 설명
    안 함
    표 104. 반환
    유형 설명
    문자열 사용자를 가장하는 사용자의 이름

    이 예시에서는 가장자의 사용자 이름을 가져오는 방법을 보여줍니다.

    var name = gs.getImpersonatingUserName();
    var actual_user = null;
    if (name == null || name == '')
      actual_user = user;
    else
      actual_user = Packages.com.glide.sys.User.getUser(name);
    
    var recent_impersonations = actual_user.getPreference('recent.impersonations');
    var admin_role=actual_user.hasRole("admin");

    GlideSystem - getInfoMessages()

    addInfoMessage()에 의해 추가된 세션에 대한 정보 메시지 목록을 조회합니다.

    표 105. 매개변수
    이름 유형 설명
    안 함
    표 106. 반환
    유형 설명
    문자열 정보 메시지의 목록입니다.

    이 예시에서는 정보 메시지를 가져오는 방법을 보여줍니다.

    var messages = gs.getInfoMessages();
    if (messages.toString().indexOf('Conflicts Detected') == -1)
      gs.addInfoMessage(msg);

    GlideSystem - getInitials()

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

    표 107. 매개변수
    이름 유형 설명
    안 함
    표 108. 반환
    유형 설명
    문자열 사용자의 이니셜입니다.
    var userInitials = gs.getUser().getInitials();        
    gs.addInfoMessage('User initials: ' + userInitials);

    출력:

    User initials: SA

    GlideSystem - getMessage(문자열, messageID, 객체 인수)

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

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

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

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

    예: gs.getMessage("작업 '{0}' 추가를 중단합니다. 동일한 하위 플로우를 이 하위 플로우에 두 번 추가할 수 없습니다.", current.action.name);

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

    주:
    전달된 값은 번역되지 않습니다. 메시지에 그대로 삽입됩니다.
    표 110. 반환
    유형 설명
    문자열 요청된 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.getMessage("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.

    범위가 지정된 해당 항목

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

    GlideSystem - getMessageS(문자열, messageID, 객체 인수)

    UI에 표시할 번역된 메시지를 검색하고 모든 체크(')을 이스케이프합니다.

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

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

    Jelly에서 JavaScript 표현식에 삽입하는 경우에 유용합니다.

    표 111. 매개변수
    이름 유형 설명
    메시지 ID 문자열 메시지 식별자입니다. 이 값은 메시지 [sys_ui_message] 테이블의 키 필드에서 찾을 수 있습니다. 키 필드는 실제 메시지 문자열과 똑같이 보일 수 있습니다.
    args 객체 옵션입니다. 지정된 메시지 내의 변수를 대체하는 java.text.MessageFormat으로 정의된 문자열 또는 기타 값의 목록입니다.

    예: gs.getMessage("작업 '{0}' 추가를 중단합니다. 동일한 하위 플로우를 이 하위 플로우에 두 번 추가할 수 없습니다.", current.action.name);

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

    주:
    전달된 값은 번역되지 않습니다. 메시지에 그대로 삽입됩니다.
    표 112. 반환
    유형 설명
    문자열 틱이 있는 지정된 메시지를 이스케이프했습니다.
    /*
    "I love France" translates to "J'aime la France" in French.
    Rendering this without escaping the tick in "J'aime" would break Jelly, because 
    the tick would prematurely end the variable assignment, and everything that 
    follows (aime la France') would be a jelly syntax error.
    */
    var my_message = '${gs.getMessageS("I love France")}'; 
    alert(my_message);

    출력:

    J'aime la France

    GlideSystem - getMessageLang(문자열 메시지, 문자열 언어, 배열 인수)

    지정된 메시지를 지정된 언어로 번역합니다.

    전달된 메시지에 변수를 포함할 수도 있습니다. 메서드는 배열에 전달된 값으로 이러한 변수를 해결합니다.args

    표 113. 매개변수
    이름 유형 설명
    메시지 문자열 번역할 메시지입니다.
    언어 문자열 메시지를 번역할 언어입니다.

    형식: BCP 47 표준

    args 배열 옵션입니다. 지정된 메시지 내의 변수를 대체하는 java.text.MessageFormat으로 정의된 문자열 또는 기타 값의 목록입니다.

    예: gs.getMessageLang("작업 '{0}' 추가를 중단합니다. 동일한 하위 플로우를 이 하위 플로우에 두 번 추가할 수 없습니다.", current.action.name);

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

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

    다음 예시에서는 지정된 메시지를 스페인어로 변환합니다.

    var my_message = gs.getMessageLang("New email", "es");
    gs.info(my_message);

    출력:

    Nuevo correo electrónico

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

    var my_message = gs.getMessageLang("There are {0} new emails for {1}", "es", [current.numEmails, current.userName]);
    gs.info(my_message);

    출력:

    Hay 7 correos nuevos para John Smith

    GlideSystem - getNodeName(객체 객체, 번호 인덱스)

    지정된 인덱스의 노드 이름을 반환합니다.

    표 115. 매개변수
    이름 유형 설명
    obj 객체 검사할 이의.
    인덱스 번호 노드 이름을 가져올 인덱스입니다.
    표 116. 반환
    유형 설명
    문자열 노드 이름
    function doInsert(nodeList) {
      gs.print('Doing insert');
      var task = new GlideRecord('task');
      task.initialize();
      for (var x=0; x < nodeList.size(); x++) {
        var name = gs.getNodeName(nodeList, x);
        var value = gs.getNodeValue(nodeList, x);
        task.setValue(name, value);
      }
      task.insert();
    }

    GlideSystem - getNodeValue(객체 객체, 숫자 인덱스)

    지정된 인덱스의 노드 값을 반환합니다.

    표 117. 매개변수
    이름 유형 설명
    obj 객체 검사할 이의.
    인덱스 번호 노드 값을 가져올 인덱스
    표 118. 반환
    유형 설명
    객체 노드 값
    function doInsert(nodeList) {
      gs.print('Doing insert');
      var task = new GlideRecord('task');
      task.initialize();
      for (var x=0; x < nodeList.size(); x++) {
        var name = gs.getNodeName(nodeList, x);
        var value = gs.getNodeValue(nodeList, x);
        task.setValue(name, value);
      }
      task.insert();
    }

    GlideSystem - getPreference(문자열 키, 객체 기본값)

    지정된 사용자 기본 설정을 반환합니다.

    표 119. 매개변수
    이름 유형 설명
    문자열 기본 설정의 키입니다.
    기본값 객체 지정된 기본 설정을 찾을 수 없는 경우 사용할 기본값입니다.
    표 120. 반환
    유형 설명
    문자열 기본 설정 값입니다. 기본 설정이 없으면 지정된 기본값을 반환합니다.
    function getSelectedProject() {
      var array= new Array();
      var prj_id = gs.getPreference("prj_id"); //This will fetch value from user preference
      var gr = new GlideRecord('pm_project_task');
      gr.addQuery('parent', prj_id);
      gr.addActiveQuery();
      while(gr.next()) {
        array.push(gr.sys_id.toString());
      }
      return array;
    }

    GlideSystem - getProperty(문자열 키, 개체 대체)

    Glide 속성의 값을 반환합니다. 속성을 찾을 수 없는 경우 지정된 alt 값을 반환합니다.

    표 121. 매개변수
    이름 유형 설명
    문자열 값을 반환해야 하는 속성의 키입니다.
    대체 객체 옵션입니다. 속성을 찾을 수 없는 경우 반환할 대체 객체입니다.
    표 122. 반환
    유형 설명
    문자열 Glide 속성 또는 위에 정의된 대체 객체의 값입니다.
    //Check for attachments and add link if there are any
    var attachment_link = '';
    var rec = new GlideRecord('sc_req_item');
    rec.addQuery('sys_id', current.request_item);
    rec.query();
    if(rec.next()){
      if(rec.hasAttachments()){
        attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
      }   
    }

    GlideSystem - getScriptError(문자열 스크립트)

    지정된 스크립트에서 발견된 스크립트 오류(있는 경우)를 반환합니다.

    주:
    스크립트는 이 함수에 의해 실행되지 않으며 구문 오류만 검사됩니다.
    표 123. 매개변수
    이름 유형 설명
    스크립트 문자열 오류를 검사할 스크립트입니다.
    표 124. 반환
    유형 설명
    문자열 오류 메시지. 오류가 없으면 Null입니다.
    if (gs.isValidScript(current.script) == false)
      {
        current.setAbortAction(true);
        var error = gs.getScriptError(current.script);
        current.script.setError(error);
      }

    GlideSystem - getSession()

    GlideSession 객체를 반환합니다.

    표 125. 매개변수
    이름 유형 설명
    안 함
    표 126. 반환
    유형 설명
    GlideSession 객체 현재 세션에 대한 GlideSession 객체
    if(!gs.hasRole("admin") && gs.getSession().isInteractive() && gs.getUserName() != "guest"){
      var qc = current.addQuery('u_visibility', "both");
      qc.addOrCondition('u_visibility', '');
      if (gs.getImpersonatingUserName() != null) {
        gs.getSession().clearClientData('navQuery');
      }
      var navQuery = gs.getSession().getClientData('navQuery');
      if (navQuery == null) {
        var isManager = gs.getUser().getRecord().getValue('u_is_manager');
          if (!isManager) {
            qc.addOrCondition('u_visibility', 'nonmanager');
            gs.getSession().putClientData('navQuery', 'nonmanager');
          } else {
            qc.addOrCondition('u_visibility', 'manager');
            gs.getSession().putClientData('navQuery', 'manager');
            }
      } else {
      qc.addOrCondition('u_visibility', navQuery);
      }   
    }

    범위가 지정된 해당 항목

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

    GlideSystem - getSessionID()

    GlideSession 세션 ID를 반환합니다.

    표 127. 매개변수
    이름 유형 설명
    안 함
    표 128. 반환
    유형 설명
    문자열 세션 ID
    var gr_NOW = new GlideRecord('v_user_session');
    var sessionId = gs.getSessionID();
    gs.log("Session ID is: " + sessionId);

    출력

    Session ID is: FEE589B3DB7EE4103DD9C39D139619D7

    범위가 지정된 해당 항목

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

    GlideSystem - getStyle(String tableName, String fieldName, String fieldValue)

    테이블, 필드 및 필드 값에 대해 정의된 스타일을 반환합니다.

    표 129. 매개변수
    이름 유형 설명
    tableName 문자열 테이블 이름
    fieldName 문자열 필드 이름
    fieldValue 문자열 필드 값
    표 130. 반환
    유형 설명
    문자열 지정된 필드의 스타일입니다.
    var returnString = gs.getStyle('<tableName>', '<fieldName>', '<fieldValue>');
    gs.print(returnString);

    GlideSystem - getTimeFormat()

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

    표 131. 매개변수
    이름 유형 설명
    안 함
    표 132. 반환
    유형 설명
    문자열 현재 사용자와 연결된 시간 형식입니다.

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

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

    출력:

    HH:mm:ss

    GlideSystem - getUser()

    현재 사용자에 대한 사용자 객체에 대한 참조를 반환합니다.

    표 133. 매개변수
    이름 유형 설명
    안 함
    표 134. 반환
    유형 설명
    GlideUser 현재 사용자에 대한 사용자 객체에 대한 참조입니다.

    다음 예시에서는 현재 사용자 객체를 가져오는 방법을 보여줍니다.

    var user = gs.getUser();
    gs.print ("The current user is: " + user);
    출력:
    The current user is: com.glide.sys.User@db5dd9

    다음 예시에서는 현재 사용자에게 workflow_admin 역할이 있는지 확인하는 방법을 보여줍니다.

    var role = gs.getUser().hasRole('workflow_admin');
    gs.print ("Does the current user have the workflow_admin role: " + role);
    출력:
    Does the current user have the workflow_admin role: true

    범위가 지정된 해당 항목

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

    GlideSystem - getUserDisplayName()

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

    표 135. 매개변수
    이름 유형 설명
    안 함
    표 136. 반환
    유형 설명
    문자열 현재 사용자의 이름 필드입니다.

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

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

    gs.info(gs.getUserDisplayName());

    출력:

    System Administrator

    범위가 지정된 해당 항목

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

    GlideSystem - getUserID()

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

    표 137. 매개변수
    이름 유형 설명
    안 함
    표 138. 반환
    유형 설명
    문자열 현재 사용자의 Sys_id입니다.

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

    var currentUserId = gs.getUserID();
    gs.print("Current user ID: " + currentUserId);
    출력:
    Current user ID: 6816f79cc0a8016401c5a33be04be441

    범위가 지정된 해당 항목

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

    GlideSystem - getUserName()

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

    표 139. 매개변수
    이름 유형 설명
    안 함
    표 140. 반환
    유형 설명
    문자열 현재 사용자의 사용자 이름입니다.

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

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

    var user = gs.getUserName();
    gs.info("The current user name is: " + user);
    
    var impUser = new GlideImpersonate();
    impUser.impersonate("62826bf03710200044e0bfc8bcbe5df1");
    var user2 = gs.getUserName();
    gs.info("The impersonated user name is: " + user2);
    출력:
    The current user name is: admin
    The impersonated user name is: abel.tuter

    범위가 지정된 해당 항목

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

    GlideSystem - getUserNameByUserID(문자열 user_id)

    제공된 사용자 로그인 이름을 기반으로 사용자 표시 이름을 반환합니다.

    표 141. 매개변수
    이름 유형 설명
    user_id 문자열 연결된 표시 이름을 검색할 사용자의 로그인 이름입니다.
    표 142. 반환
    유형 설명
    문자열 요청된 사용자의 표시 이름입니다.
    주:
    이 메서드가 요청한 ID의 사용자를 찾을 수 없는 경우 제공된 입력 값을 반환합니다.

    다음 예제에서는 지정된 사용자의 표시 이름을 가져오는 방법을 보여 줍니다.

    var displayName = gs.getUserNameByUserID('abel.tuter');
    gs.info('User display name is: ' + displayName);
    출력:
    User display name is: Abel Tuter

    GlideSystem - getXMLNodeList(문자열 xml)

    XML 문서의 모든 노드와 값의 배열을 구성합니다.

    표 143. 매개변수
    이름 유형 설명
    XML 문자열 구문 분석할 XML 문서입니다.
    표 144. 반환
    유형 설명
    배열 목록 가장 바깥쪽 XML 노드의 이름과 값 목록입니다.

    다음 예제는 배열 목록에서 XML 노드 및 관련 값의 목록을 가져오는 방법을 보여줍니다.

    var nodeList = gs.getXMLNodeList("<note><to>Tove</to><from>Jani</from><heading>Reminder</heading><body>Don't forget me this weekend!</body></note>");
    gs.print ("The node contains: " + nodeList);
    
    출력:
    The node contains: [to : Tove, from : Jani, heading : Reminder, body : Don't forget me this weekend!]
    

    GlideSystem - getXMLText(String xml, String xpathQuery)

    XPath 쿼리와 일치하는 XML 문자열의 첫 번째 요소에 대한 XML 텍스트를 반환합니다.

    표 145. 매개변수
    이름 유형 설명
    XML 문자열 검색할 XML 문자열입니다.
    xpath쿼리 문자열 일치시킬 XPath 쿼리입니다.
    표 146. 반환
    유형 설명
    문자열 검색 매개변수와 일치하는 XML 노드입니다.

    다음 예제에서는 전달된 노드 내에서 지정된 XML 요소의 값을 가져오는 방법을 보여 줍니다.

    var nodeList = gs.getXMLText("<outer><note><to>Tove</to><from>Jani</from><heading>Reminder</heading><body>Don't forget me this weekend!</body></note></outer>", "//from");
    gs.print ("The from element contains: " + nodeList);
    출력:
    The from element contains: Jani

    GlideSystem - hasRole(문자열 roleName)

    현재 사용자에게 전달된 역할 중 하나 이상이 있는지 확인합니다.

    표 147. 매개변수
    이름 유형 설명
    roleName 문자열 쉼표로 구분된 역할 목록입니다.
    표 148. 반환
    유형 설명
    부울 현재 사용자에게 지정된 역할 중 하나 이상이 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 사용자에게 전달된 역할이 하나 이상 있습니다. 사용자에게 관리자 역할이 있는 경우에도 예를 반환합니다.
    • false: 사용자에게 전달된 역할이 없습니다.

    다음 예는 현재 사용자에게 관리자 또는 groups_admin 역할이 있는지 확인하는 방법을 보여줍니다.

    if (!gs.hasRole("admin, 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
    }

    범위가 지정된 해당 항목

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

    GlideSystem - hasRoleInGroup(객체 roleName, 객체 그룹)

    현재 사용자가 지정된 그룹 내에서 지정된 역할을 가지고 있는지 여부를 결정합니다.

    표 149. 매개변수
    이름 유형 설명
    roleName 객체 역할의 이름입니다.
    그룹 객체 지정된 역할을 확인할 그룹의 Sys_id입니다.
    표 150. 반환
    유형 설명
    부울 현재 사용자가 지정된 그룹에서 지정된 역할을 가지고 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 로그인한 사용자가 지정된 그룹의 지정된 역할에 할당됩니다.
    • false: 로그인한 사용자가 지정된 그룹의 지정된 역할에 할당되지 않았습니다.

    다음 예시에서는 sys_user_group 그룹에 role_name 역할이 있는지 확인하는 방법을 보여줍니다.

    var group = new GlideRecord('sys_user_group');
    group.addQuery('name', 'GROUP_NAME');
    group.setLimit(1);
    group.query();
    if (group.next()) {
       if (gs.hasRoleInGroup('role_name', group)) {
          gs.print('User has role in group');  
       } else {
          gs.print('User does NOT have role in group');
       }  
    }

    GlideSystem - hoursAgo(숫자 시간)

    지정된 시간 전의 날짜 및 시간을 반환합니다. 반환 값은 인스턴스의 표준 시간대에 맞게 조정됩니다.

    표 151. 매개변수
    이름 유형 설명
    시간 번호 시간 전의 수입니다.
    표 152. 반환
    유형 설명
    문자열 지정된 시간 전의 UTC 날짜 및 시간입니다.

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

    var currentDateTime = gs.hoursAgo(0);
    gs.info("Current date/time: " + currentDateTime);
    
    var agoDateTime = gs.hoursAgo(1);
    gs.info("Ago date/time: " + agoDateTime);
    출력
    Current date/time: 2021-03-17 20:53:25
    Ago date/time: 2021-03-17 19:53:25

    범위가 지정된 해당 항목

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

    GlideSystem - hoursAgoEnd(숫자 시간)

    지정된 시간 전에 한 시간의 끝에 대한 날짜 및 시간을 반환합니다. 반환 값은 인스턴스의 표준 시간대에 맞게 조정됩니다.

    표 153. 매개변수
    이름 유형 설명
    시간 숫자(정수) 시간 전의 수입니다.
    표 154. 반환
    유형 설명
    문자열 지정된 시간 수가 경과한 UTC 날짜 및 시간입니다.

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

    var currentDateTime = gs.hoursAgoEnd(0);
    gs.print("Current date/time: " + currentDateTime);
    
    var agoDateTime = gs.hoursAgoEnd(1);
    gs.print("Ago date/time: " + agoDateTime);
    출력
    Current date/time: 2021-03-17 20:59:59
    Ago date/time: 2021-03-17 19:59:59

    범위가 지정된 해당 항목

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

    GlideSystem - hoursAgoStart(시간 수)

    지정된 시간 수에 대한 시간의 시작에 대한 날짜 및 시간을 반환합니다. 반환 값은 인스턴스의 표준 시간대에 맞게 조정됩니다.

    표 155. 매개변수
    이름 유형 설명
    시간 번호 시간 전의 수입니다.
    표 156. 반환
    유형 설명
    문자열 지정된 시간 수가 경과한 UTC 날짜 및 시간입니다.

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

    var currentDateTime = gs.hoursAgoStart(0);
    gs.print("Current date/time: " + currentDateTime);
    
    var agoDateTime = gs.hoursAgoStart(1);
    gs.print("Ago date/time: " + agoDateTime);
    출력
    Current date/time: 2021-03-17 20:00:00
    Ago date/time: 2021-03-17 19:00:00

    범위가 지정된 해당 항목

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

    GlideSystem - isFirstDayOfMonth(목표 날짜)

    지정된 날짜 객체의 날짜가 해당 월의 첫 번째 날인지 확인합니다.

    표 157. 매개변수
    이름 유형 설명
    날짜 객체 날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).
    표 158. 반환
    유형 설명
    부울 지정된 날짜 객체의 날짜가 해당 월의 첫 번째 날인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 달의 첫 번째 날입니다.
    • false: 매월 1일이 아닙니다.

    이 예시에서는 지정된 날짜 객체의 날짜가 해당 월의 첫 번째 날인지 확인하는 방법을 보여줍니다.

    var gdt = new GlideDateTime();
    gdt.setValue('2021-04-01 12:00:00');
    var currentDay = gs.isFirstDayOfMonth(gdt);
    gs.print("First day of month: " + currentDay);
    
    gdt.setValue('2021-04-21 12:00:00');
    var currentDay = gs.isFirstDayOfMonth(gdt);
    gs.print("First day of month: " + currentDay);
    출력
    First day of month: true
    First day of month: false

    GlideSystem - isFirstDayOfWeek(목표 날짜)

    지정된 날짜 객체의 날짜가 주의 첫 번째 날인지 확인합니다. 이 방법은 월요일을 주의 첫 번째 날로 하는 ISO 표준을 사용합니다.

    표 159. 매개변수
    이름 유형 설명
    날짜 객체 날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).
    표 160. 반환
    유형 설명
    부울 현재 날짜 객체의 날짜가 주의 첫 번째 날(월요일)인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 주의 첫 번째 날입니다.
    • false: 주의 첫 번째 날이 아닙니다.

    이 예에서는 지정된 날짜 객체의 날짜가 주의 첫 번째 날인지 확인하는 방법을 보여줍니다.

    var gdt = new GlideDateTime();
    gdt.setValue('2021-03-02 12:00:00');
    var currentDay = gs.isFirstDayOfWeek(gdt);
    gs.info("First day of week: " + currentDay);
    
    gdt.setValue('2021-03-22 12:00:00');
    var currentDay = gs.isFirstDayOfWeek(gdt);
    gs.info("First day of week: " + currentDay);
    출력
    First day of week: false
    First day of week: true

    GlideSystem - isFirstDayOfYear(객체 날짜)

    지정된 날짜 객체의 날짜가 해당 해의 첫 번째 날인지 확인합니다.

    표 161. 매개변수
    이름 유형 설명
    날짜 객체 날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).
    표 162. 반환
    유형 설명
    부울 지정된 날짜 객체의 날짜가 해당 해의 첫 번째 날인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 한 해의 첫 번째 날.
    • 아니오: 매년 첫 번째 날이 아님

    이 예시에서는 지정된 날짜 객체의 날짜가 해당 해의 첫 번째 날인지 확인하는 방법을 보여줍니다.

    var gdt = new GlideDateTime();
    gdt.setValue('2020-12-31 12:00:00');
    var currentDay = gs.isFirstDayOfYear(gdt);
    gs.info("First day of year: " + currentDay);
    
    gdt.setValue('2021-01-01 12:00:00');
    var currentDay = gs.isFirstDayOfYear(gdt);
    gs.info("First day of year: " + currentDay);
    출력
    First day of year: false
    First day of year: true

    GlideSystem - isInteractive()

    현재 세션이 대화형인지 확인합니다.

    대화형 세션의 예로는 사용자가 로그인 화면을 사용하여 로그인하는 경우가 있습니다. 비대화형 세션의 예로는 SOAP 요청을 사용하여 데이터를 검색하는 것이 있습니다.

    표 163. 매개변수
    이름 유형 설명
    안 함
    표 164. 반환
    유형 설명
    부울 세션이 대화형인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 세션이 대화형입니다.
    • false: 세션이 대화형이 아닙니다.
    if (!gs.hasRole('admin') && gs.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);
      }
    }

    범위가 지정된 해당 항목

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

    GlideSystem - isLastDayofMonth(객체 날짜)

    지정된 날짜 객체의 날짜가 해당 월의 마지막 날인지 확인합니다.

    표 165. 매개변수
    이름 유형 설명
    날짜 객체 날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).
    표 166. 반환
    유형 설명
    부울 지정된 날짜 객체의 날짜가 해당 월의 마지막 날인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 달의 마지막 날입니다.
    • false: 달의 마지막 날이 아닙니다.

    이 예시에서는 지정된 날짜 객체의 날짜가 해당 월의 마지막 날인지 확인하는 방법을 보여줍니다.

    var gdt = new GlideDate();
    gdt.setValue('2020-12-31 12:00:00');
    var currentDay = gs.isLastDayOfMonth(gdt);
    gs.print("First day of year: " + currentDay);
    
    gdt.setValue('2021-01-01 12:00:00');
    var currentDay = gs.isLastDayOfMonth(gdt);
    gs.print("First day of year: " + currentDay);
    출력
    Last day of month: true
    Last day of month: false

    GlideSystem - isLastDayOfWeek(목표 날짜)

    지정된 날짜 객체의 날짜가 주의 마지막 날인지 확인합니다. 이 방법은 일요일을 주의 마지막 날로 하는 ISO 표준을 사용합니다.

    표 167. 매개변수
    이름 유형 설명
    날짜 객체 날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).
    표 168. 반환
    유형 설명
    부울 현재 날짜 객체의 날짜가 주의 마지막 날(일요일)인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 주의 마지막 날입니다.
    • false: 주의 마지막 날이 아닙니다.

    이 예시에서는 지정된 날짜 객체의 날짜가 주의 마지막 날인지 확인하는 방법을 보여줍니다.

    var gdt = new GlideDate();
    gdt.setValue('2021-03-01 12:00:00');
    var currentDay = gs.isLastDayOfWeek(gdt);
    gs.info("Last day of week: " + currentDay);
    
    gdt.setValue('2021-03-21 12:00:00');
    var currentDay = gs.isLastDayOfWeek(gdt);
    gs.info("Last day of week: " + currentDay);
    출력
    First day of week: false
    First day of week: true

    GlideSystem - isLastDayOfYear(객체 날짜)

    지정된 날짜 객체의 날짜가 해당 연도의 마지막 날인지 확인합니다.

    표 169. 매개변수
    이름 유형 설명
    날짜 객체 날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).
    표 170. 반환
    유형 설명
    부울 현재 날짜 객체의 날짜가 해당 해의 마지막 날인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 한 해의 마지막 날입니다.
    • false: 한 해의 마지막 날이 아님

    이 예시에서는 지정된 날짜 객체의 날짜가 그 해의 마지막 날인지 확인하는 방법을 보여줍니다.

    var gdt = new GlideDateTime();
    gdt.setValue('2020-12-31 12:00:00');
    var currentDay = gs.isLastDayOfYear(gdt);
    gs.info("Last day of year: " + currentDay);
    
    gdt.setValue('2021-01-01 12:00:00');
    var currentDay = gs.isLastDayOfYear(gdt);
    gs.info("Last day of year: " + currentDay);
    출력
    Last day of year: true
    Last day of year: false

    GlideSystem - isLoggedIn()

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

    표 171. 매개변수
    이름 유형 설명
    안 함
    표 172. 반환
    유형 설명
    부울 현재 사용자가 로그인했는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 사용자가 로그인했습니다.
    • false: 사용자가 로그인하지 않았습니다.

    이 예시에서는 현재 사용자가 로그인되어 있는지 확인하는 방법을 보여줍니다.

    if(gs.isLoggedIn())
      gs.info("Current user is logged in");
    else
      gs.info("Current user is NOT logged in");
    출력
    Current user is logged in

    범위가 지정된 해당 항목

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

    GlideSystem - isMobile()

    요청이 모바일 장치에서 왔는지 여부를 확인합니다.

    UI 작업 조건 및 비즈니스 규칙에서 이 방법을 사용할 수 있습니다.

    표 173. 매개변수
    이름 유형 설명
    안 함
    표 174. 반환
    유형 설명
    부울 요청이 모바일 장치에서 왔는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 모바일 장치.
    • 아니오: 모바일 장치가 아님.

    이 예에서는 현재 장치가 모바일 장치인지 확인하는 방법을 보여줍니다.

    if(gs.isMobile())
        gs.info("Submitted from mobile UI");
      else 
       gs.info("NOT submitted from mobile UI");
    출력
    Submitted from mobile UI

    범위가 지정된 해당 항목

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

    GlideSystem - 지난주()

    사용자의 세션 시간대에서 일주일 전 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 175. 매개변수
    이름 유형 설명
    안 함
    표 176. 반환
    유형 설명
    문자열 1주일 전 날짜 및 시간입니다.

    형식: (UTC) yyyy-MM-dd hh:mm:ss

    이 예는 현재 날짜 객체의 날짜로부터 일주일 후인 날짜를 가져오는 방법을 보여줍니다.

    var gdt = new GlideDateTime();
    gdt.setValue('2021-03-22 01:00:00');
    
    gs.info("Current date: " + gs.nowDateTime());
    
    gs.info("One week earlier: " + gs.lastWeek());
    출력
    Current date: 2021-03-22 15:27:07
    One week earlier: 2021-03-15 15:27:07

    GlideSystem - log(문자열 메시지, 문자열 소스)

    시스템 로그에 메시지를 기록하고 syslog 테이블에 저장합니다.

    표 177. 매개변수
    이름 유형 설명
    메시지 문자열 기록할 메시지입니다.
    소스 문자열 옵션입니다. 메시지의 소스입니다.
    표 178. 반환
    유형 설명
    무효

    다음 예제에서는 상수와 변수를 사용하여 로그 항목을 게시하는 방법을 보여줍니다.

    var count = new GlideAggregate('incident');
    count.addQuery('active', 'true');
    count.addAggregate('COUNT', 'category');
    count.query();   
    while (count.next()) {
       var category = count.category;
       var categoryCount = count.getAggregate('COUNT', 'category');
       gs.log("The are currently " + categoryCount + " incidents with a category of " + category, "Incident Counter");
    }

    GlideSystem - logError(문자열 메시지, 문자열 소스)

    시스템 로그에 오류를 기록하고 syslog 테이블에 저장합니다.

    표 179. 매개변수
    이름 유형 설명
    메시지 문자열 기록할 오류 메시지입니다.
    소스 문자열 옵션입니다. 메시지의 소스입니다.
    표 180. 반환
    유형 설명
    무효

    다음 예시에서는 인시던트 테이블을 찾을 수 없는 경우 오류를 기록합니다.

    var gr_NOW = new GlideRecord("incident");
    if (!gr_NOW.isValid()) {
      gs.logError('Incident table could not be found');
      return;
    }

    GlideSystem - logWarning(문자열 메시지, 문자열 소스)

    시스템 로그에 경고를 기록하고 syslog 테이블에 저장합니다.

    표 181. 매개변수
    이름 유형 설명
    메시지 문자열 기록할 메시지입니다.
    소스 문자열 옵션입니다. 메시지의 소스입니다.
    표 182. 반환
    유형 설명
    무효

    다음 예시에서는 인시던트 테이블을 찾을 수 없는 경우 경고를 기록합니다.

    var gr_NOW = new GlideRecord("incident");
    if (!gr_NOW.isValid()) {
      gs.logWarning('Incident table could not be found');
      return;
    }

    GlideSystem - minutesAgo(숫자 분)

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

    표 183. 매개변수
    이름 유형 설명
    번호 과거에 반환할 시간(분)입니다.
    표 184. 반환
    유형 설명
    문자열 지정된 시간(분) 전의 UTC 날짜 및 시간입니다.

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

    이 예제에서는 addQuery() 호출에서 minutesAgo() 메서드를 사용하는 방법을 보여줍니다.

    // Check to see if the user has failed to login too many times
    // when the limit is reached, lock the user out of the system
    //
    //Check failed logins in the last 15 minutes
    var now_GR = new GlideRecord('sysevent');
    now_GR.addQuery('name', 'login.failed');
    now_GR.addQuery('parm1', event.parm1.toString());
    now_GR.addQuery('sys_created_on','>=', gs.minutesAgo(15));
    now_GR.query();
    var rowCount = now_GR.getRowCount();
    if(rowCount >= 5){
      var now_GR = new GlideRecord("sys_user");
      now_GR.addQuery("user_name", event.parm1.toString());
      now_GR.query();
      if (now_GR.next()) {
        now_GR.locked_out = true;
        now_GR.update();
        gs.log("User " + event.parm1 + " locked out due to too many invalid login attempts");
      }
    }

    GlideSystem - minutesAgoEnd(숫자 분)

    특정 시간(분) 전의 종료 날짜 및 시간을 반환합니다. 사용자의 세션 시간대에 UTC 타임스탬프로 반환됩니다.

    표 185. 매개변수
    이름 유형 설명
    번호 5 또는 11과 같은 분전의 정수입니다.
    표 186. 반환
    유형 설명
    문자열 UTC 분이 끝날 때 지정된 시간(분)입니다(59초).

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

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

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

    출력:

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

    범위가 지정된 해당 항목

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

    GlideSystem - minutesAgoStart(분)

    특정 시간(분) 전의 시작 날짜 및 시간을 반환합니다. 사용자의 세션 시간대에 UTC 타임스탬프로 반환됩니다.

    표 187. 매개변수
    이름 유형 설명
    번호 15 또는 112와 같은 정수 분 전입니다.
    표 188. 반환
    유형 설명
    문자열 UTC 분의 시작 시점에 지정된 시간(분)입니다.

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

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

    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

    범위가 지정된 해당 항목

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

    GlideSystem - monthsAgo(개월 수)

    사용자의 세션 시간대에서 특정 개월 전의 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

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

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

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

    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

    범위가 지정된 해당 항목

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

    GlideSystem - monthsAgoEnd(개월 수)

    지정된 개월 수 전에 해당하는 달의 마지막 날의 날짜 및 시간을 반환합니다.

    표 191. 매개변수
    이름 유형 설명
    숫자(정수) 월 수(예: 4 또는 16).
    표 192. 반환
    유형 설명
    문자열 현지 시간으로 지정된 개월 수인 월의 날짜 및 시간 스탬프입니다.

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

    다음 예에서는 현재 날짜 및 시간과 2개월 전 날짜 및 시간이 해당 월의 끝에 표시됩니다.

    var nowDateTime = new GlideDateTime();
    gs.info("Now: " + nowDateTime);
    var endOfTheMonthDateTime = gs.monthsAgoEnd(2);
    gs.info("End of the month: " + endOfTheMonthDateTime);

    출력:

    Now: 2021-10-20 19:23:35
    End of the month: 2021-08-01 06:59:59

    GlideSystem - monthsAgoStart(개월 수)

    특정 개월 수 전의 월의 시작에 대한 날짜 및 시간을 반환합니다. 사용자의 세션 시간대에 UTC 타임스탬프로 반환됩니다.

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

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

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

    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

    범위가 지정된 해당 항목

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

    GlideSystem - nil(객체 객체)

    객체를 쿼리하고 객체가 null이거나 빈 문자열을 포함하는 경우 예를 반환합니다.

    표 195. 매개변수
    이름 유형 설명
    obj 객체 검사할 객체입니다.
    표 196. 반환
    유형 설명
    부울 null이거나 빈 문자열이면 예입니다. 그렇지 않으면 false입니다.
    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);
      }
    }

    범위가 지정된 해당 항목

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

    GlideSystem - now()

    UTC의 현재 날짜를 반환합니다.

    표 197. 매개변수
    이름 유형 설명
    안 함
    표 198. 반환
    유형 설명
    문자열 사용자 정의 형식의 현재 날짜(UTC)입니다.
    // When the user password changes then set the u_password_last_reset field
    // to now so we know when to force another update
     
    var now_GR = new GlideRecord("sys_user");
    if (now_GR.get(event.parm1.toString())) {
        // Do something based on the Password Changing
        gs.log("The user password changed so do something else...");
        now_GR.u_password_last_reset = gs.now();
        now_GR.update();
    }

    GlideSystem - nowNoTZ()

    UTC 형식으로 현재 날짜 및 시간을 반환합니다.

    표 199. 매개변수
    이름 유형 설명
    안 함
    표 200. 반환
    유형 설명
    문자열 현재 UTC 날짜 시간
    // When the user password changes then set the u_password_last_reset field
    // to now so we know when to force another update
     
    var now_GR = new GlideRecord("sys_user");
    if (now_GR.get(event.parm1.toString())) {
        // Do something based on the Password Changing
        gs.log("The user password changed so do something else...");
        now_GR.u_password_last_reset = gs.nowNoTZ();
        now_GR.update();
    }

    GlideSystem - nowDateTime()

    사용자 정의 형식으로 현재 날짜 및 시간을 반환합니다.

    표 201. 매개변수
    이름 유형 설명
    안 함
    표 202. 반환
    유형 설명
    문자열 사용자 정의 형식의 현재 날짜 및 시간입니다. 시스템 날짜 및 시간 형식 설정에 대한 자세한 내용은 날짜 및 날짜/시간 필드를 참조하십시오.
    var currentDateTime = gs.nowDateTime();
    gs.print("Current date/time: " + currentDateTime);
    출력
    Current date/time: 2021-03-17 14:04:02

    워크플로우 스크립트의 변수를 현재 날짜 및 시간으로 설정하는 경우 setDisplayValue() 메서드를 사용합니다. 다음 스크립트는 워크플로우 변수 end_date 을 현재 날짜 및 시간으로 설정합니다.

    current.variables.end_date.setDisplayValue(gs.nowDateTime());

    GlideSystem - nowGlideDateTime()

    사용자의 세션 시간대에서 현재 날짜와 시간이 포함된 GlideDateTime 객체를 UTC 타임스탬프로 가져옵니다.

    현재 날짜 및 시간이 포함된 GlideDateTime 객체를 가져오면 GlideDateTime 메서드를 사용하여 날짜-시간 계산 수행, 날짜-시간 서식 지정 또는 날짜-시간 형식 간 변환과 같은 날짜-시간 작업을 수행할 수 있습니다.

    표 203. 매개변수
    이름 유형 설명
    안 함
    표 204. 반환
    유형 설명
    객체 현재 날짜와 시간이 UTC 형식인 GlideDateTime 객체입니다.

    필드 u_target_date를 UTC 형식의 현재 날짜 및 시간으로 설정합니다.

    current.u_target_date = gs.nowGlideDateTime();

    GlideSystem - 인쇄(문자열 메시지)

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

    이 메서드는 디버그가 활성화되지 않은 경우 syslog 테이블에 메시지를 기록하지 않습니다.

    표 205. 매개변수
    이름 유형 설명
    메시지 문자열 기록할 메시지
    표 206. 반환
    유형 설명
    무효
    var rec = new GlideRecord('incident');
    rec.addQuery('active',false);
    rec.query();
    while (rec.next()) { 
     gs.print('Inactive incident ' + rec.number + ' deleted');
     rec.deleteRecord();
    }

    GlideSystem - quartersAgo(분기 수)

    사용자의 세션 시간대에서 특정 분기 수의 날짜 및 시간을 UTC 타임스탬프로 반환합니다.

    표 207. 매개변수
    이름 유형 설명
    분기 번호 분기 전의 정수 번호입니다.
    표 208. 반환
    유형 설명
    문자열 분기 전에 지정된 분기 수였던 분기의 UTC입니다.

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

    다음 예에서는 현재 날짜 및 시간과 4분기 전 날짜 및 시간을 동시에 표시합니다.

    var nowDateTime = new GlideDateTime();
    gs.print("Now: " + nowDateTime);
    var fourQuartersAgoDateTime = gs.quartersAgo(4);
    gs.print("Four quarters ago: " + fourQuartersAgoDateTime);

    출력:

    Now: 2021-10-20 16:27:32
    Four quarters ago: 2020-10-20 16:27:32

    GlideSystem - quartersAgoEnd(분기 번호)

    지정된 분기 수에 대한 분기의 마지막 날의 날짜 및 시간을 반환합니다. 사용자의 세션 시간대에 UTC 타임스탬프로 반환됩니다.

    표 209. 매개변수
    이름 유형 설명
    분기 번호 분기의 정수 수
    표 210. 반환
    유형 설명
    문자열 지정된 분기 수였던 분기의 UTC 말(YYYY-MM-DD HH:MM:SS 형식)

    범위가 지정된 해당 항목

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

    GlideSystem - quartersAgoStart(분기 수)

    지정된 분기 수에 대한 분기의 첫 번째 날의 날짜 및 시간을 반환합니다. 사용자의 세션 시간대에 UTC 타임스탬프로 반환됩니다.

    표 211. 매개변수
    이름 유형 설명
    분기 번호 분기의 정수 수
    표 212. 반환
    유형 설명
    문자열 지정된 분기 수였던 월의 UTC 말(YYYY-MM-DD HH:MM:SS 형식)

    범위가 지정된 해당 항목

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

    GlideSystem - setProperty(문자열 키, 문자열 값, 문자열 설명)

    지정된 키를 지정된 값으로 설정합니다.

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

    출력: bar

    범위가 지정된 해당 항목

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

    GlideSystem - setRedirect(객체 URI)

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

    표 215. 매개변수
    이름 유형 설명
    URI 객체 리디렉션으로 설정할 URI
    표 216. 반환
    유형 설명
    무효

    이 예시에서는 사용자를 특정 카탈로그 항목으로 리디렉션하고 현재 이메일을 매개변수로 전달합니다.

    gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user=" 
    + current.sys_id + "&sysparm_email=" + current.email)

    범위가 지정된 해당 항목

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

    GlideSystem - setReturn(객체 URI)

    이 트랜잭션에 대한 반환 URI를 설정합니다. 이렇게 하면 사용자가 다음 양식에서 돌아올 때 어떤 페이지로 리디렉션될지 결정됩니다.

    표 217. 매개변수
    이름 유형 설명
    URI 객체 반환 위치로 설정할 URI입니다.
    표 218. 반환
    유형 설명
    무효

    이 예시에서는 사용자가 다음 페이지를 마쳤을 때 현재 페이지로 돌아가도록 합니다.

    gs.setReturn (current.getLink(true));

    GlideSystem - tableExists(문자열 tableName)

    데이터베이스 테이블이 인스턴스에 있는지 확인합니다.ServiceNow

    표 219. 매개변수
    이름 유형 설명
    tableName 문자열 확인할 테이블의 이름입니다.
    표 220. 반환
    유형 설명
    부울 지정된 테이블이 인스턴스에 있는지 여부를 나타내는 플래그입니다.ServiceNow
    가능한 값:
    • true: 테이블 존재
    • 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

    범위가 지정된 해당 항목

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

    GlideSystem - userID()

    이 세션과 연결된 사용자의 sys_id 반환합니다. 대신 getUserID()를 사용합니다.

    표 221. 매개변수
    이름 유형 설명
    안 함
    표 222. 반환
    유형 설명
    문자열 현재 사용자의 Sys_id입니다.

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

    var incidentGR = new GlideRecord('incident');
    incidentGR.addActiveQuery();
    
    // Filter results to incidents assigned to the current user
    var currentUserSysId = gs.userID();
    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 - workflowFlush(객체 glideRecord)

    지정된 GlideRecord에 대한 일정(sys_trigger) 테이블에서 열려 있는 예약된 작업 기록을 삭제합니다.

    표 223. 매개변수
    이름 유형 설명
    glideRecord 객체 The GlideRecord
    표 224. 반환
    유형 설명
    무효

    GlideSystem - yearsAgo(숫자 연도)

    사용자의 세션 시간대에서 특정 년 전의 날짜 및 시간을 UTC 타임스탬프로 가져옵니다.

    표 225. 매개변수
    이름 유형 설명
    번호 연도의 정수 수
    표 226. 반환
    유형 설명
    문자열 지정된 연도의 UTC 시작(yyyy-mm-dd hh:mm:ss 형식)

    범위가 지정된 해당 항목

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

    GlideSystem - 어제()

    사용자의 세션 시간대에 어제(24시간 전) 시간을 UTC 타임스탬프로 반환합니다.

    표 227. 매개변수
    이름 유형 설명
    안 함
    표 228. 반환
    유형 설명
    문자열 24시간 전의 UTC(yyyy-mm-dd hh:mm:ss 형식)

    범위가 지정된 해당 항목

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