GlideSystem - 전역

GlideSystem - addErrorMessage(객체 메시지)

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

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

표 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
       }
  }
[edit]

범위가 지정된 등가

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

GlideSystem - addInfoMessage(객체 메시지)

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

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

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

범위가 지정된 등가

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

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

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

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

표 6. 반환
유형	설명
void

GlideSystem - beginningOfLastMonth()

지난 달의 시작 날짜와 시간을 GMT로 가져옵니다.

표 7. 매개변수
이름	유형	설명
없음

표 8. 반환
유형	설명
문자열	지난달 초의 GMT로, 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()

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

표 9. 매개변수
이름	유형	설명
없음

표 10. 반환
유형	설명
문자열	GMT 지난주 초. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - beginningOfNextWeek()

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

표 11. 매개변수
이름	유형	설명
없음

표 12. 반환
유형	설명
문자열	GMT 다음 주 초. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - beginningOfNextMonth()

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

표 13. 매개변수
이름	유형	설명
없음

표 14. 반환
유형	설명
문자열	GMT는 다음 달 초에 발표됩니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - beginningOfNextYear()

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

표 15. 매개변수
이름	유형	설명
없음

표 16. 반환
유형	설명
문자열	내년 초의 GMT는 yyyy-mm-dd hh:mm:ss 형식입니다.

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

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

범위가 지정된 등가

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

GlideSystem - beginningOfThisMonth()

현재 월의 시작 날짜와 시간을 GMT로 반환합니다.

표 17. 매개변수
이름	유형	설명
없음

표 18. 반환
유형	설명
문자열	GMT 현재 월의 시작입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - beginningOfThisQuarter()

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

표 19. 매개변수
이름	유형	설명
없음

표 20. 반환
유형	설명
문자열	GMT 현재 분기의 시작입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - beginningOfThisWeek()

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

표 21. 매개변수
이름	유형	설명
없음

표 22. 반환
유형	설명
문자열	GMT 이번 주의 시작입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - beginningOfThisYear()

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

표 23. 매개변수
이름	유형	설명
없음

표 24. 반환
유형	설명
문자열	GMT 올해 초. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - beginningOfToday()

오늘 시작 날짜와 시간을 GMT로 검색합니다.

표 25. 매개변수
이름	유형	설명
없음

표 26. 반환
유형	설명
문자열	GMT 현재 날짜의 시작입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

GlideSystem - beginningOfTomorrow()

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

표 27. 매개변수
이름	유형	설명
없음

표 28. 반환
유형	설명
문자열	GMT는 내일 초입니다. 형식: yyyy-mm-dd hh:mm:ss

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

GlideSystem - beginningOfYesterday()

GMT로 어제 시작 날짜 및 시간을 검색합니다.

표 29. 매개변수
이름	유형	설명
없음

표 30. 반환
유형	설명
문자열	어제의 GMT 시작(yyyy-mm-dd hh:mm:ss 형식)입니다.

var start = new GlideDateTime();
start.setValue(gs.beginningOfYesterday());

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

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

캘린더는 이제 레거시입니다. 일정을 사용 중인 경우 항목 유용한 스케줄링 스크립트의 '지정된 일정 동안 계산' 섹션을 참조하십시오.

표 31. 매개변수
이름	유형	설명
startDate	문자열	현재 사용자의 날짜 형식으로 비교할 시작 날짜입니다.
endDate	문자열	현재 사용자의 날짜 형식으로 비교할 종료 날짜입니다.
숫자 값	부울	반환된 시간 값의 형식을 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 반환 값의 형식이 초 단위로 지정됩니다. false: 반환 값의 형식은 ddd hh:mm:ss입니다.

표 32. 반환
유형	설명
문자열	numericValue 매개 변수가 true이면 두 날짜 간의 차이를 정수(초)로 반환합니다. 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() 메서드를 사용합니다.

표 33. 매개변수
이름	유형	설명
startDate	문자열	현재 사용자의 날짜 형식으로 비교할 시작 날짜입니다.
endDate	문자열	현재 사용자의 날짜 형식으로 비교할 종료 날짜입니다.
숫자 값	부울	true이면 반환 값의 형식이 초 단위로 지정됩니다. false이면 반환 값의 형식은 ddd hh:mm:ss입니다.

표 34. 반환
유형	설명
문자열	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(문자열 날짜, 문자열 범위)

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

표 35. 매개변수
이름	유형	설명
날짜	문자열	생성할 날짜(GMT)입니다. 형식: yyyy-mm-dd
레인지	문자열	시작, 종료 또는 시간입니다. 형식: 24시간 hh:mm:ss

표 36. 반환
유형	설명
문자열	생성된 날짜 및 시간입니다. 범위가 `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(일수)

특정 일수 이전의 날짜와 시간을 반환합니다.

표 37. 매개변수
이름	유형	설명
일	번호	날짜 수

표 38. 반환
유형	설명
문자열	지정된 일수 이전의 GMT입니다. 형식: 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(일수)

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

표 39. 매개변수
이름	유형	설명
일	번호	정수 날짜 수

표 40. 반환
유형	설명
문자열	yyyy-mm-dd hh:mm:ss 형식의 GMT 종료 날짜입니다.

이 예시에서는 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(일수)

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

표 41. 매개변수
이름	유형	설명
일	번호	일 수 전

표 42. 반환
유형	설명
문자열	하루의 시작에 대한 현지 날짜 및 시간(사용자 정의 날짜 시간 형식)입니다. 날짜 시간 형식이 초기 값에서 수정되지 않은 경우 형식은 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(일수)

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

표 43. 매개변수
이름	유형	설명
일	문자열	정수 날짜 수

표 44. 반환
유형	설명
문자열	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();

범위가 지정된 등가

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

GlideSystem - endOfLastMonth()

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

표 45. 매개변수
이름	유형	설명
없음

표 46. 반환
유형	설명
문자열	지난달 말 GMT입니다. 형식: 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 - endOfLastWeek()

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

표 47. 매개변수
이름	유형	설명
없음

표 48. 반환
유형	설명
문자열	GMT 지난주 말. 형식: 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()

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

표 49. 매개변수
이름	유형	설명
없음

표 50. 반환
유형	설명
문자열	yyyy-mm-dd hh:mm:ss 형식의 GMT입니다.

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

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

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

표 51. 매개변수
이름	유형	설명
없음

표 52. 반환
유형	설명
문자열	GMT 데이터 및 시간입니다. 형식: 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()

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

표 53. 매개변수
이름	유형	설명
없음

표 54. 반환
유형	설명
문자열	다음 주 말까지의 GMT 날짜 및 시간입니다. 형식: 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()

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

표 55. 매개변수
이름	유형	설명
없음

표 56. 반환
유형	설명
문자열	내년 말의 GMT 날짜 및 시간입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - endOfThisMonth()

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

표 57. 매개변수
이름	유형	설명
없음

표 58. 반환
유형	설명
문자열	이번 달 말의 GMT 날짜 및 시간입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - endOfThisQuarter()

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

표 59. 매개변수
이름	유형	설명
없음

표 60. 반환
유형	설명
문자열	이번 분기 말의 GMT 날짜 및 시간입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - endOfThisWeek()

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

표 61. 매개변수
이름	유형	설명
없음

표 62. 반환
유형	설명
문자열	이번 주말의 GMT 날짜 및 시간입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - endOfThisYear()

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

표 63. 매개변수
이름	유형	설명
없음

표 64. 반환
유형	설명
문자열	올해 말의 GMT 날짜 및 시간입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

범위가 지정된 등가

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

GlideSystem - endOfToday()

오늘 종료 날짜 및 시간을 GMT로 검색합니다.

표 65. 매개변수
이름	유형	설명
없음

표 66. 반환
유형	설명
문자열	yyyy-mm-dd hh:mm:ss 형식의 GMT입니다.

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

GMT에서 내일 일의 날짜 및 시간을 검색합니다.

표 67. 매개변수
이름	유형	설명
없음

표 68. 반환
유형	설명
문자열	yyyy-mm-dd hh:mm:ss 형식의 GMT입니다.

var tomorrowEnd = new GlideDateTime();
tomorrowEnd.setValue(gs.endOfTomorrow());

GlideSystem - endOfYesterday()

GMT로 어제 종료 날짜와 시간을 가져옵니다.

표 69. 매개변수
이름	유형	설명
없음

표 70. 반환
유형	설명
문자열	GMT 형식(yyyy-mm-dd huh:mm:ss)입니다.

var yesterdayEnd = new GlideDateTime();
yesterdayEnd.setValue(gs.endOfYesterday());

GlideSystem - eventQueue(문자열 이름, 객체 glideRecord, 문자열 매개변수1, 문자열 매개변수2, 문자열 대기열)

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

표 71. 매개변수
이름	유형	설명
이름	문자열	큐에 대기 중인 이벤트의 이름입니다.
glideRecord	객체	GlideRecord 객체(예: "현재")
parm1	문자열	(선택 사항) 지정된 경우 인스턴스와 함께 저장됩니다.
parm2	문자열	(선택 사항) 지정된 경우 인스턴스와 함께 저장됩니다.
큐	문자열	큐 이름.

표 72. 반환
유형	설명
void

if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueue("incident.commented", current, gs.getUserID(), gs.getUserName());
}

범위가 지정된 등가

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

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

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

표 73. 매개변수
이름	유형	설명
이름	문자열	큐에 대기 중인 이벤트의 이름입니다.
glideRecord	객체	GlideRecord 객체(예: "현재")
parm1	문자열	(선택 사항) 지정된 경우 인스턴스와 함께 저장됩니다.
parm2	문자열	(선택 사항) 지정된 경우 인스턴스와 함께 저장됩니다.
만료	객체	이 이벤트를 처리할 날짜 및 시간입니다.

표 74. 반환
유형	설명
void

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() 를 사용하여 세션 메시지를 제거합니다.

표 75. 매개변수
이름	유형	설명
없음

표 76. 반환
유형	설명
void

이 예제에서는 오류 메시지를 구문 분석하고 다시 전달한 다음 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()

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

표 77. 매개변수
이름	유형	설명
없음

표 78. 반환
유형	설명
문자열	사용자의 아바타에 대한 파일 경로입니다.

var avatarFile = gs.getUser().getAvatar();        
gs.addInfoMessage('User avatar ID: ' + avatarFile);

출력:

User avatar ID: c148e1d13741310042106710ce41f149.iix?t=small

GlideSystem - getCurrentScopeName()

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

표 79. 매개변수
이름	유형	설명
없음

표 80. 반환
유형	설명
문자열	현재 범위 이름입니다.

이 예제에서는 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()

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

표 81. 매개변수
이름	유형	설명
없음

표 82. 반환
유형	설명
문자열	현재 사용자와 연결된 날짜 형식입니다.

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

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

출력:

yyyy-MM-dd

GlideSystem - getDateTimeFormat()

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

표 83. 매개변수
이름	유형	설명
없음

표 84. 반환
유형	설명
문자열	현재 사용자와 연결된 날짜 및 시간 형식입니다.

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

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

출력:

yyyy-MM-dd HH:mm:ss

GlideSystem - getDisplayColumn(문자열 tableName)

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

표 85. 매개변수
이름	유형	설명
tableName	문자열	표시 열 이름을 가져올 테이블의 이름입니다.

표 86. 반환
유형	설명
문자열	표시 열 이름

// 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(문자열 tableName, 문자열 recordID, 문자열 fieldName)

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

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

표 88. 반환
유형	설명
문자열	필드의 값을 표시합니다.

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

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

GlideSystem - getErrorMessages()

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

표 89. 매개변수
이름	유형	설명
없음

표 90. 반환
유형	설명
문자열	오류 메시지 목록

이 예제에서는 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 구문 분석을 위해 이스케이프합니다.

표 91. 매개변수
이름	유형	설명
키	문자열	값을 반환해야 하는 속성의 키입니다.
substituteObject	객체	옵션입니다. 속성을 찾을 수 없는 경우 반환할 객체입니다.

표 92. 반환
유형	설명
문자열	속성 또는 속성을 찾을 수 없는 경우 substituteObject입니다.

var propValue = gs.getEscapedProperty("com.example.my_test_property");
gs.addInfoMessage("This is my property value " + propValue);

GlideSystem - getImpersonatingUserDisplayName()

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

표 93. 매개변수
이름	유형	설명
없음

표 94. 반환
유형	설명
문자열	다른 사용자로 전환하는 사용자의 표시 이름입니다.

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

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을 반환합니다.

표 95. 매개변수
이름	유형	설명
없음

표 96. 반환
유형	설명
문자열	다른 사용자로 전환하는 사용자의 이름

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

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()에 의해 추가된 세션에 대한 정보 메시지 목록을 검색합니다.

표 97. 매개변수
이름	유형	설명
없음

표 98. 반환
유형	설명
문자열	정보 메시지 목록입니다.

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

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

GlideSystem - getInitials()

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

표 99. 매개변수
이름	유형	설명
없음

표 100. 반환
유형	설명
문자열	사용자의 이니셜입니다.

var userInitials = gs.getUser().getInitials();        
gs.addInfoMessage('User initials: ' + userInitials);

출력:

User initials: SA

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

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

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

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

주:

UI 메시지에 체크 표시(')가 있는 경우 스크립트의 메시지에 문제가 있을 수 있습니다. 틱(')을 이스케이프하려면 getMessageS(String, Object)를 사용합니다.

표 101. 매개변수
이름	유형	설명
메시지 ID	문자열	메시지 식별자입니다. 이 값은 메시지 [sys_ui_message] 테이블의 키 필드에서 찾을 수 있습니다. 키 필드는 실제 메시지 문자열과 정확히 같을 수 있습니다.
args	객체	옵션입니다. 지정된 메시지 내의 변수를 대체하는 java.text.MessageFormat에 의해 정의된 문자열 또는 기타 값의 목록입니다. 예: `gs.getMessage("Abort adding action '{0}', same subflow는 두 번 추가할 수 없습니다.", current.action.name);` 이 예제에서 `'{0}'` 는 `current.action.name` 의 내용으로 대체됩니다. 주: 전달된 값은 변환되지 않습니다. 메시지에 그대로 삽입됩니다.

표 102. 반환
유형	설명
문자열	요청된 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가 없는 경우 메서드는 영어 버전의 메시지를 반환합니다. 메시지 ID가 테이블에 없으면 메시지 ID를 리턴합니다.

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

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

표 103. 매개변수
이름	유형	설명
메시지 ID	문자열	메시지 식별자입니다. 이 값은 메시지 [sys_ui_message] 테이블의 키 필드에서 찾을 수 있습니다. 키 필드는 실제 메시지 문자열과 정확히 같을 수 있습니다.
args	객체	옵션입니다. 지정된 메시지 내의 변수를 대체하는 java.text.MessageFormat에 의해 정의된 문자열 또는 기타 값의 목록입니다. 예: `gs.getMessage("Abort adding action '{0}', same subflow는 두 번 추가할 수 없습니다.", current.action.name);` 이 예제에서 `'{0}'` 는 `current.action.name` 의 내용으로 대체됩니다. 주: 전달된 값은 변환되지 않습니다. 메시지에 그대로 삽입됩니다.

표 104. 반환
유형	설명
문자열	틱이 있는 지정된 메시지가 이스케이프되었습니다.

/*
"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 된 값으로 이러한 변수를 확인합니다.

표 105. 매개변수
이름	유형	설명
메시지	문자열	번역할 메시지입니다.
언어	문자열	메시지를 번역할 언어입니다. 형식: BCP 47 표준
args	배열	옵션입니다. 지정된 메시지 내의 변수를 대체하는 java.text.MessageFormat에 의해 정의된 문자열 또는 기타 값의 목록입니다. 예: `gs.getMessageLang("'{0}' 작업 추가를 중단합니다. 이 하위 플로우에서 동일한 하위 플로우를 두 번 추가할 수 없습니다.", current.action.name);` 이 예제에서 `'{0}'` 는 `current.action.name` 의 내용으로 대체됩니다. 주: 전달된 값은 변환되지 않습니다. 메시지에 그대로 삽입됩니다.

표 106. 반환
유형	설명
문자열	번역된 메시지입니다.

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

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(객체 객체, 객체, 인덱스)

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

표 107. 매개변수
이름	유형	설명
obj	객체	검사할 개체입니다.
index	번호	노드 이름을 가져올 인덱스입니다.

표 108. 반환
유형	설명
문자열	노드의 이름

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(객체 객체, 숫자 인덱스)

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

표 109. 매개변수
이름	유형	설명
obj	객체	검사할 개체입니다.
index	번호	노드 값을 가져올 인덱스

표 110. 반환
유형	설명
객체	노드 값

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(문자열 키, 객체 기본값)

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

표 111. 매개변수
이름	유형	설명
키	문자열	기본 설정의 키입니다.
기본값	객체	지정된 기본 설정을 찾을 수 없는 경우 사용할 기본값입니다.

표 112. 반환
유형	설명
문자열	기본 설정 값입니다. 기본 설정이 없으면 지정된 기본값을 반환합니다.

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 값을 반환합니다.

표 113. 매개변수
이름	유형	설명
키	문자열	값을 반환해야 하는 속성의 키입니다.
대체	객체	옵션입니다. 속성을 찾을 수 없는 경우 반환할 대체 객체입니다.

표 114. 반환
유형	설명
문자열	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(문자열 스크립트)

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

주:

스크립트는 이 함수에 의해 실행되지 않으며 구문 오류만 검사합니다.

표 115. 매개변수
이름	유형	설명
스크립트	문자열	오류를 검사하는 스크립트입니다.

표 116. 반환
유형	설명
문자열	오류 메시지. 오류가 없는 경우 Null입니다.

if (gs.isValidScript(current.script) == false)
  {
    current.setAbortAction(true);
    var error = gs.getScriptError(current.script);
    current.script.setError(error);
  }

GlideSystem - getSession()

GlideSession 객체를 반환합니다.

표 117. 매개변수
이름	유형	설명
없음

표 118. 반환
유형	설명
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를 반환합니다.

표 119. 매개변수
이름	유형	설명
없음

표 120. 반환
유형	설명
문자열	세션 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(문자열 tableName, 문자열 fieldName, 문자열 fieldValue)

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

표 121. 매개변수
이름	유형	설명
tableName	문자열	테이블 이름
fieldName	문자열	필드 이름
fieldValue	문자열	필드 값

표 122. 반환
유형	설명
문자열	지정된 필드의 스타일입니다.

var returnString = gs.getStyle('<tableName>', '<fieldName>', '<fieldValue>');
gs.print(returnString);

GlideSystem - getTimeFormat()

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

표 123. 매개변수
이름	유형	설명
없음

표 124. 반환
유형	설명
문자열	현재 사용자와 연결된 시간 형식입니다.

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

출력:

HH:mm:ss

GlideSystem - getUser()

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

표 125. 매개변수
이름	유형	설명
없음

표 126. 반환
유형	설명
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()

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

표 127. 매개변수
이름	유형	설명
없음

표 128. 반환
유형	설명
문자열	현재 사용자의 이름 필드입니다. 예를 들어, 이 메서드는 abel.tuter가 아닌 Abel Tuter를 반환합니다.

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

gs.info(gs.getUserDisplayName());

출력:

System Administrator

범위가 지정된 등가

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

GlideSystem - getUserID()

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

표 129. 매개변수
이름	유형	설명
없음

표 130. 반환
유형	설명
문자열	현재 사용자의 Sys_id입니다.

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

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

출력:

Current user ID: 6816f79cc0a8016401c5a33be04be441

범위가 지정된 등가

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

GlideSystem - getUserName()

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

표 131. 매개변수
이름	유형	설명
없음

표 132. 반환
유형	설명
문자열	현재 사용자의 사용자 이름입니다. 예를 들어, 이 메서드는 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)

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

표 133. 매개변수
이름	유형	설명
user_id	문자열	연결된 표시 이름을 검색할 사용자의 로그인 이름입니다.

표 134. 반환
유형	설명
문자열	요청된 사용자의 표시 이름입니다. 주: 이 메서드는 요청된 ID를 가진 사용자를 찾을 수 없는 경우 제공된 입력 값을 반환합니다.

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

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

출력:

User display name is: Abel Tuter

GlideSystem - getXMLNodeList(문자열 xml)

XML 문서에 있는 모든 노드와 값의 배열을 생성합니다.

표 135. 매개변수
이름	유형	설명
xml	문자열	구문 분석할 XML 문서입니다.

표 136. 반환
유형	설명
배열 목록	가장 바깥쪽에 있는 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(문자열 xml, 문자열 xpathQuery)

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

표 137. 매개변수
이름	유형	설명
xml	문자열	검색할 XML 문자열입니다.
xpath쿼리	문자열	일치하는 XPath 쿼리입니다.

표 138. 반환
유형	설명
문자열	검색 매개변수와 일치하는 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(String roleName)

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

표 139. 매개변수
이름	유형	설명
roleName	문자열	쉼표로 구분된 역할 목록입니다.

표 140. 반환
유형	설명
부울	현재 사용자에게 지정된 역할 중 하나 이상이 있는지 여부를 나타내는 플래그입니다. 가능한 값: true: 사용자에게 전달된 역할 중 하나 이상이 있습니다. 사용자에게 관리자 역할이 있는 경우에도 true를 반환합니다. false: 사용자에게 전달된 역할이 없습니다.

다음 예는 현재 사용자에게 admin 또는 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, 객체 그룹)

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

표 141. 매개변수
이름	유형	설명
roleName	객체	역할의 이름입니다.
그룹	객체	지정된 역할을 확인할 그룹의 Sys_id입니다.

표 142. 반환
유형	설명
부울	현재 사용자가 지정된 그룹에서 지정된 역할을 가지고 있는지 여부를 나타내는 플래그입니다. 가능한 값: 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(시간 수)

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

표 143. 매개변수
이름	유형	설명
시간	번호	시간 전의 숫자입니다.

표 144. 반환
유형	설명
문자열	지정된 시간 전의 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(시간 수)

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

표 145. 매개변수
이름	유형	설명
시간	숫자(정수)	시간 전의 숫자입니다.

표 146. 반환
유형	설명
문자열	지정된 시간 전의 종료 시점에 대한 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(시간 수)

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

표 147. 매개변수
이름	유형	설명
시간	번호	시간 전의 숫자입니다.

표 148. 반환
유형	설명
문자열	지정된 시간 전의 종료 시점에 대한 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(객체 날짜)

지정된 날짜 객체의 날짜가 월의 첫 번째 날인지 여부를 확인합니다.

표 149. 매개변수
이름	유형	설명
날짜	객체	날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).

표 150. 반환
유형	설명
부울	지정된 날짜 객체의 날짜가 해당 월의 첫 번째 날인지 여부를 나타내는 플래그입니다. 가능한 값: true: 달의 첫 번째 날입니다. false: 해당 월의 첫 번째 날이 아닙니다.

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

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 표준을 사용합니다.

표 151. 매개변수
이름	유형	설명
날짜	객체	날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).

표 152. 반환
유형	설명
부울	현재 날짜 객체의 날짜가 주의 첫 번째 날(월요일)인지 여부를 나타내는 플래그입니다. 가능한 값: true: 주의 첫 번째 날입니다. false: 주의 첫 번째 날이 아닙니다.

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

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(객체 날짜)

지정된 날짜 객체의 날짜가 연도의 첫 번째 날인지 여부를 확인합니다.

표 153. 매개변수
이름	유형	설명
날짜	객체	날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).

표 154. 반환
유형	설명
부울	지정된 날짜 객체의 날짜가 연도의 첫 번째 날인지 여부를 나타내는 플래그입니다. 가능한 값: true: 연도의 첫 번째 날입니다. false: 연도의 첫 번째 날이 아닙니다.

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

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 요청을 사용하여 데이터를 검색하는 경우를 들 수 있습니다.

표 155. 매개변수
이름	유형	설명
없음

표 156. 반환
유형	설명
부울	세션이 대화형인지 여부를 나타내는 플래그입니다. 가능한 값: 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(객체 날짜)

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

표 157. 매개변수
이름	유형	설명
날짜	객체	날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).

표 158. 반환
유형	설명
부울	지정된 날짜 객체의 날짜가 해당 월의 마지막 날인지 여부를 나타내는 플래그입니다. 가능한 값: true: 달의 마지막 날입니다. false: 월의 마지막 날이 아닙니다.

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

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 표준을 사용합니다.

표 159. 매개변수
이름	유형	설명
날짜	객체	날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).

표 160. 반환
유형	설명
부울	현재 날짜 객체의 날짜가 주의 마지막 날(일요일)인지 여부를 나타내는 플래그입니다. 가능한 값: true: 주의 마지막 날입니다. false: 주의 마지막 날이 아닙니다.

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

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(객체 날짜)

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

표 161. 매개변수
이름	유형	설명
날짜	객체	날짜를 확인할 날짜 객체입니다(예: GlideDateTime 또는 GlideDate).

표 162. 반환
유형	설명
부울	현재 날짜 객체의 날짜가 해당 연도의 마지막 날인지 여부를 나타내는 플래그입니다. 가능한 값: true: 해당 연도의 마지막 날입니다. false: 연도의 마지막 날이 아닙니다.

이 예제에서는 지정된 date 객체의 날짜가 해당 연도의 마지막 날인지 여부를 확인하는 방법을 보여 줍니다.

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

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

표 163. 매개변수
이름	유형	설명
없음

표 164. 반환
유형	설명
부울	현재 사용자가 로그인했는지 여부를 나타내는 플래그입니다. 가능한 값: 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 작업 조건 및 비즈니스 규칙에서 이 방법을 사용할 수 있습니다.

표 165. 매개변수
이름	유형	설명
없음

표 166. 반환
유형	설명
부울	요청이 모바일 장치에서 왔는지 여부를 나타내는 플래그입니다. 가능한 값: true: 모바일 장치입니다. false: 모바일 장치가 아닙니다.

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

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

출력

Submitted from mobile UI

범위가 지정된 등가

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

GlideSystem - lastWeek()

1주일 전의 날짜와 시간을 GMT로 반환합니다.

표 167. 매개변수
이름	유형	설명
없음

표 168. 반환
유형	설명
문자열	1주일 전의 날짜 및 시간입니다. 형식: yyyy-MM-dd hh:mm:ss

이 예제에서는 현재 date 개체의 날짜로부터 1주일 후의 날짜를 가져오는 방법을 보여 줍니다.

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 테이블에 저장합니다.

표 169. 매개변수
이름	유형	설명
메시지	문자열	로그할 메시지입니다.
소스	문자열	옵션입니다. 메시지의 소스입니다.

표 170. 반환
유형	설명
void

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

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 테이블에 저장합니다.

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

표 172. 반환
유형	설명
void

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

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

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

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

표 173. 매개변수
이름	유형	설명
메시지	문자열	로그할 메시지입니다.
소스	문자열	옵션입니다. 메시지의 소스입니다.

표 174. 반환
유형	설명
void

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

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

GlideSystem - minutesAgo(분)

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

표 175. 매개변수
이름	유형	설명
분	번호	과거 반환까지의 시간(분)입니다.

표 176. 반환
유형	설명
문자열	지정된 시간(분) 전의 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(분)

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

표 177. 매개변수
이름	유형	설명
분	번호	분 전의 정수(예: 5 또는 11)입니다.

표 178. 반환
유형	설명
문자열	GMT 지정된 분 전, 분 끝 부분(59초)입니다. 형식: yyyy-mm-dd hh:mm:ss

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

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

특정 시간(분) 전의 분 시작에 대한 날짜 및 시간을 반환합니다.

표 179. 매개변수
이름	유형	설명
분	번호	분 전의 정수(예: 15 또는 112)입니다.

표 180. 반환
유형	설명
문자열	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

범위가 지정된 등가

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

GlideSystem - monthsAgo(개월 수)

특정 개월 수의 날짜와 시간을 반환합니다.

표 181. 매개변수
이름	유형	설명
월	번호	개월 전의 정수입니다.

표 182. 반환
유형	설명
문자열	정확히 같은 시간에 지정된 개월 수의 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

범위가 지정된 등가

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

GlideSystem - monthsAgoEnd(개월 수)

특정 개월 전의 마지막 날에 대한 날짜와 시간을 반환합니다.

표 183. 매개변수
이름	유형	설명
월	번호	개월 수를 정수(예: 4 또는 16)로 나타낸 것입니다.

표 184. 반환
유형	설명
문자열	GMT 지정된 개월 수 전의 월말입니다. 형식: 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-09-01 06:59:59

GlideSystem - monthsAgoStart(개월 수)

특정 개월 전의 월이 시작되는 날짜와 시간을 반환합니다.

표 185. 매개변수
이름	유형	설명
월	번호	개월 전의 정수(예: 5 또는 14)입니다.

표 186. 반환
유형	설명
문자열	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

범위가 지정된 등가

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

GlideSystem - nil(객체 obj)

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

표 187. 매개변수
이름	유형	설명
obj	객체	검사할 객체입니다.

표 188. 반환
유형	설명
부울	null 또는 빈 문자열인 경우 True입니다. 그렇지 않으면 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로 반환합니다.

표 189. 매개변수
이름	유형	설명
없음

표 190. 반환
유형	설명
문자열	사용자 정의 형식의 현재 날짜(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 형식으로 반환합니다.

표 191. 매개변수
이름	유형	설명
없음

표 192. 반환
유형	설명
문자열	현재 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()

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

표 193. 매개변수
이름	유형	설명
없음

표 194. 반환
유형	설명
문자열	사용자 정의 형식의 현재 날짜 및 시간입니다. 시스템 날짜 및 시간 형식 설정에 대한 자세한 내용은 날짜 및 날짜/시간 필드를 참조하십시오.

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 객체를 가져옵니다.

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

표 195. 매개변수
이름	유형	설명
없음

표 196. 반환
유형	설명
객체	현재 날짜 및 시간이 GMT 형식으로 표시된 GlideDateTime 객체입니다.

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

current.u_target_date = gs.nowGlideDateTime();

GlideSystem - print(문자열 메시지)

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

이 방법은 디버그가 활성화되지 않은 경우 syslog 테이블에 메시지를 쓰지 않습니다.

표 197. 매개변수
이름	유형	설명
메시지	문자열	기록할 메시지

표 198. 반환
유형	설명
void

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(분기 수)

특정 분기 수의 날짜와 시간을 반환합니다.

표 199. 매개변수
이름	유형	설명
분기	번호	분기 전의 정수입니다.

표 200. 반환
유형	설명
문자열	지정된 분기 수였던 분기의 GMT입니다. 형식: 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(분기 수)

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

표 201. 매개변수
이름	유형	설명
분기	번호	정수 분기 수

표 202. 반환
유형	설명
문자열	지정된 분기 수였던 분기의 GMT 종료(yyyy-mm-dd hh:mm:ss 형식)

범위가 지정된 등가

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

GlideSystem - quartersAgoStart(분기 수)

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

표 203. 매개변수
이름	유형	설명
분기	번호	정수 분기 수

표 204. 반환
유형	설명
문자열	지정된 분기 수였던 월의 GMT 말(yyyy-mm-dd hh:mm:ss 형식)

범위가 지정된 등가

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

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

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

주:

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

표 205. 매개변수
이름	유형	설명
키	문자열	설정할 속성의 키입니다.
값	문자열	설정할 속성의 값입니다.
description	문자열	속성에 대한 설명입니다.

표 206. 반환
유형	설명
void

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

출력: bar

범위가 지정된 등가

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

GlideSystem - setRedirect(객체 URI)

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

표 207. 매개변수
이름	유형	설명
URI	객체	리디렉션으로 설정할 URI

표 208. 반환
유형	설명
void

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

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를 설정합니다. 이렇게 하면 사용자가 다음 양식에서 돌아올 때 이동할 페이지가 결정됩니다.

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

표 210. 반환
유형	설명
void

이 예제에서는 사용자가 다음 페이지를 완료할 때 현재 페이지로 돌아가도록 합니다.

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

GlideSystem - tableExists(String tableName)

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

표 211. 매개변수
이름	유형	설명
tableName	문자열	확인할 테이블의 이름입니다.

표 212. 반환
유형	설명
부울	지정된 테이블이 인스턴스에 있는지 여부를 나타내는 플래그입니다 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()를 사용합니다.

표 213. 매개변수
이름	유형	설명
없음

표 214. 반환
유형	설명
문자열	현재 사용자의 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(예약) 테이블에서 열려 있는 모든 예약된 작업 기록을 삭제합니다.

표 215. 매개변수
이름	유형	설명
glideRecord	객체	The GlideRecord

표 216. 반환
유형	설명
void

GlideSystem - yearsAgo(수년)

특정 연도 전의 날짜와 시간을 가져옵니다.

표 217. 매개변수
이름	유형	설명
년	번호	정수(연도)

표 218. 반환
유형	설명
문자열	GMT 지정된 연도 전의 연도 시작(yyyy-mm-dd hh:mm:ss 형식)입니다.

범위가 지정된 등가

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

GlideSystem - yesterday()

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

표 219. 매개변수
이름	유형	설명
없음

표 220. 반환
유형	설명
문자열	24시간 전 GMT(yyyy-mm-dd hh:mm:ss 형식)

범위가 지정된 등가

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