GlideSystem - Global

GlideSystem - addErrorMessage (mensagem do objeto)

Adiciona uma mensagem de erro para a sessão atual.

Use getErrorMessages() para recuperar uma lista de mensagens de erro que estão sendo mostradas no momento.

Tabela 1. Parâmetros
Nome	Tipo	Descrição
mensagem	Objeto	A mensagem a ser adicionada.

Tabela 2. Retornos
Tipo	Descrição
vazio

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]

Equivalente com escopo

Para usar o método addErrorMessage() em uma aplicação com escopo, use o método com escopo correspondente: addErrorMessage().

GlideSystem - addInfoMessage(Mensagem do objeto)

Adiciona uma mensagem informativa para a sessão atual.

Use getInfoMessages() para recuperar a lista de mensagens informativas que estão sendo mostradas. Este método não é compatível com regras de negócio assíncronas e não pode ser usado em scripts de transformação.

Tabela 3. Parâmetros
Nome	Tipo	Descrição
mensagem	Objeto	A mensagem a ser adicionada.

Tabela 4. Retornos
Tipo	Descrição
vazio

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

Equivalente com escopo

Para usar o método addInfoMessage() em uma aplicação com escopo, use o método com escopo correspondente: addInfoMessage().

GlideSystem - addMessage (tipo de cadeia de caracteres, mensagem de objeto)

Adiciona uma mensagem para a sessão atual.

Tabela 5. Parâmetros
Nome	Tipo	Descrição
tipo	Cadeia de caracteres	Tipo de mensagem, como `erro` ou `informações`.
mensagem	Objeto	Mensagem a ser adicionada à sessão atual.

Tabela 6. Retornos
Tipo	Descrição
vazio

GlideSystem – startsOfLastMonth()

Obtém a data e a hora do início do último mês em GMT.

Tabela 7. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna
Tipo	Descrição
Cadeia de caracteres	O início GMT do último mês, no formato aaaa-mm-dd hh:mm:ss.

Este exemplo define a data e a hora do objeto GlideDateTime como o início do último mês.

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

Equivalente com escopo

Para usar o método startsOfLastMonth() em uma aplicação com escopo, use o método com escopo correspondente: startsOfLastMonth().

GlideSystem – startsOfLastWeek()

Retorna a data e a hora do início da última semana em GMT.

Tabela 9. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT no início da semana passada. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo define o valor do registro de data/hora atual do Glide como o início da última semana.

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

Equivalente com escopo

Para usar o método startsOfLastWeek() em uma aplicação com escopo, use o método com escopo correspondente: startsOfLastWeek().

GlideSystem – startsOfNextWeek()

Retorna a data e a hora do início da próxima semana em GMT.

Tabela 11. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 12. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT no início da próxima semana. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo define o valor do registro de data/hora atual do Glide para o início da próxima semana.

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

Equivalente com escopo

Para usar o método startsOfNextWeek() em uma aplicação com escopo, use o método com escopo correspondente: startsOfNextWeek().

GlideSystem – startsOfNextMonth()

Retorna a data e a hora do início do próximo mês em GMT.

Tabela 13. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT no início do próximo mês. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo define o valor do registro de data/hora atual do Glide para o início do próximo mês.

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

Equivalente com escopo

Para usar o método startsOfNextMonth() em uma aplicação com escopo, use o método com escopo correspondente: startsOfNextMonth().

GlideSystem – startsOfNextYear()

Retorna a data e a hora do início do próximo ano em GMT.

Tabela 15. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 16. Retorna
Tipo	Descrição
Cadeia de caracteres	O GMT a partir do próximo ano, no formato aaaa-mm-dd hh:mm:ss.

Este exemplo define o valor do registro de data/hora atual do Glide para o início do próximo ano.

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

Equivalente com escopo

Para usar o método startsOfNextYear() em uma aplicação com escopo, use o método com escopo correspondente: startsOfNextYear().

GlideSystem – startsOf ThisMonth()

Retorna a data e a hora do início do mês atual em GMT.

Tabela 17. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 18. Retorna
Tipo	Descrição
Cadeia de caracteres	Início GMT do mês atual. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo define o valor do registro de data/hora atual do Glide para o início deste mês.

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

Equivalente com escopo

Para usar o método startsOf ThisMonth() em uma aplicação com escopo, use o método com escopo correspondente: startsOf ThisMonth().

GlideSystem – startsOf ThisQuarter()

Retorna a data e a hora do início do trimestre atual em GMT.

Tabela 19. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 20. Retorna
Tipo	Descrição
Cadeia de caracteres	Início GMT do trimestre atual. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo define o valor do registro de data/hora atual do Glide como o início do trimestre atual.

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

Equivalente com escopo

Para usar o método "inícioOfEsteQuarter"() em uma aplicação com escopo, use o método com escopo correspondente: "inícioOfEsteQuarter()".

GlideSystem – startsOf ThisWeek()

Retorna a data e a hora do início desta semana em GMT.

Tabela 21. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 22. Retorna
Tipo	Descrição
Cadeia de caracteres	Início GMT da semana atual. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo define o valor do registro de data/hora atual do Glide para o início da semana atual.

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

Equivalente com escopo

Para usar o método startsOf ThisWeek() em uma aplicação com escopo, use o método com escopo correspondente: startsOf ThisWeek().

GlideSystem – startsOf ThisYear()

Retorna a data e a hora do início deste ano em GMT.

Tabela 23. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 24. Retorna
Tipo	Descrição
Cadeia de caracteres	Início GMT do ano atual. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo define o valor do registro de data/hora atual do Glide como o início do ano atual.

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

Equivalente com escopo

Para usar o método startsOf ThisYear () em uma aplicação com escopo, use o método com escopo correspondente: startsOf ThisYear ().

GlideSystem – startsOfToday()

Recupera a data e a hora do início de hoje em GMT.

Tabela 25. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 26. Retorna
Tipo	Descrição
Cadeia de caracteres	Início GMT do dia atual. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo define o valor do registro de data/hora atual do Glide para o início do dia atual.

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

GlideSystem – startsOfTomorrow()

Recupera o início (UTC) de amanhã ajustado para o fuso horário da sessão atual.

Tabela 27. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 28. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT a partir de amanhã. Formato: aaaa-mm-dd hh:mm:ss

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

GlideSystem – startsOf Yesterday()

Recupera a data e a hora do início de ontem em GMT.

Tabela 29. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 30. Retorna
Tipo	Descrição
Cadeia de caracteres	O GMT a partir de ontem, no formato aaaa-mm-dd hh:mm:ss.

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

GlideSystem - calDateDiff(cadeia de caracteres startDate, cadeia de caracteres endDate, Booliano numéricoValue)

Calcule a diferença entre duas datas usando o calendário padrão.

Os calendários agora são legados. Se Cronogramas estiverem sendo usados, consulte a seção "Calcular durante um determinado cronograma" do tópico Scripts de programação úteis.

Tabela 31. Parâmetros
Nome	Tipo	Descrição
startDate	Cadeia de caracteres	Data de início a ser comparada no formato de data do usuário atual.
endDate	Cadeia de caracteres	Data de término a ser comparada no formato de data do usuário atual.
valor numérico	Booliano	Sinalizador que indica o formato do valor de tempo retornado. Valores válidos: verdadeiro: o valor de retorno é formatado em número de segundos falso: o valor de retorno está no formato ddd hh:mm:ss.

Tabela 32. Retornos
Tipo	Descrição
Cadeia de caracteres	Se o parâmetro numericValue for verdadeiro, retornará a diferença entre as duas datas como um número inteiro de segundos. Se falso, retorna a diferença entre as duas datas no formato 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(cadeia de caracteres startDate, cadeia de caracteres endDate, Booliano numéricoValue)

Calcula a diferença entre duas datas.

Este método espera a data anterior como o primeiro parâmetro e a data posterior como o segundo parâmetro; caso contrário, o método retornará a diferença como um valor negativo. Use getDisplayValue() para converter as cadeias de caracteres para o formato esperado.

Este método espera parâmetros no formato de data e hora do usuário/sistema, que pode não ser igual ao formato interno. O uso de parâmetros em formatos diferentes do formato de data e hora do usuário/sistema pode retornar resultados inválidos.

Se você estiver trabalhando com objetos GlideDateTime, use o método GlideDateTime subtract() em vez de dateDiff().

Tabela 33. Parâmetros
Nome	Tipo	Descrição
startDate	Cadeia de caracteres	A data de início a ser comparada no formato de data do usuário atual.
endDate	Cadeia de caracteres	A data de término a ser comparada no formato de data do usuário atual.
valor numérico	Booliano	Se verdadeiro, o valor de retorno será formatado em número de segundos; se for falso, o valor de retorno será formatado como ddd hh:mm:ss.

Tabela 34. Retornos
Tipo	Descrição
Cadeia de caracteres	Se o parâmetro numéricaValue for verdadeiro, retornará a diferença entre as duas datas como um número inteiro de segundos; se falso, retorna a diferença entre as duas datas no formato 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(cadeia de caracteres data, cadeia de caracteres intervalo)

Gera uma data e hora para a data especificada em GMT.

Tabela 35. Parâmetros
Nome	Tipo	Descrição
data	Cadeia de caracteres	Data a ser gerada em GMT. Formato: aaaa-mm-dd
intervalo	Cadeia de caracteres	Hora de início, de término ou. Formato: 24 horas hh:mm:ss

Tabela 36. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora de geração. Se o intervalo for `start`, o valor retornado será aaaa-mm-dd 00:00:00. Se o intervalo for `fim,` o valor de retorno será aaaa-mm-dd 23:59:59. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo mostra o uso de dateGenerate() para definir a data de início ao consultar registros na tabela Incidente.

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

Saída:

Count: 7

Equivalente com escopo

Para usar o método dateGenerate() em uma aplicação com escopo, use o método com escopo correspondente: dateGenerate().

GlideSystem - daysAgo(Número de dias)

Retorna uma data e hora para um determinado número de dias atrás.

Tabela 37. Parâmetros
Nome	Tipo	Descrição
dias	Número	Número de dias

Tabela 38. Retornos
Tipo	Descrição
Cadeia de caracteres	GMT do número especificado de dias atrás. Formato: aaaa-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();
}

Equivalente com escopo

Para usar o método daysAgo() em uma aplicação com escopo, use o método com escopo correspondente: daysAgo().

GlideSystem - daysAgoEnd(Número de dias)

Retorna uma data e hora para o fim do dia há um número especificado de dias.

Tabela 39. Parâmetros
Nome	Tipo	Descrição
dias	Número	Número inteiro de dias

Tabela 40. Retornos
Tipo	Descrição
Cadeia de caracteres	O fim do dia GMT no formato aaaa-mm-dd hh:mm:ss.

Este exemplo mostra o uso de daysAgoEnd() para definir a data de término ao consultar registros na tabela Incidente.

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

Equivalente com escopo

Para usar o método daysAgoEnd() em uma aplicação com escopo, use o método com escopo correspondente: daysAgoEnd().

GlideSystem - daysAgoLocal(Número de dias)

Retorna a data e a hora do início do dia para o número especificado de dias atrás. A data e a hora retornadas refletem o fuso horário da sessão atual (hora local).

Tabela 41. Parâmetros
Nome	Tipo	Descrição
dias	Número	Número de dias atrás

Tabela 42. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora locais para o início do dia no formato de data e hora definido pelo usuário. Se o formato de data e hora não for modificado em relação ao valor inicial, o formato será aaaa-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(Número de dias)

Retorna uma data e hora para o início do dia há um número especificado de dias.

Tabela 43. Parâmetros
Nome	Tipo	Descrição
dias	Cadeia de caracteres	Número inteiro de dias

Tabela 44. Retornos
Tipo	Descrição
Cadeia de caracteres	Início do dia GMT no formato aaaa-mm-dd hh:mm:ss

var now_GR = new GlideRecord('sysapproval_approver');
now_GR.addQuery('state', 'requested');
now_GR.addQuery('sys_updated_on', '<', gs.daysAgoStart(5));
now_GR.query();

Equivalente com escopo

Para usar o método daysAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: daysAgoStart().

GlideSystem – endOfLastMonth()

Retorna a data e a hora do fim do último mês em GMT.

Tabela 45. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 46. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT do fim do último mês. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo mostra como consultar um registro de relatório do último dia do último mês.

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

Equivalente com escopo

Para usar o método endOfLastMonth() em uma aplicação com escopo, use o método com escopo correspondente: endOfLastMonth().

GlideSystem – endOfLastWeek()

Retorna a data e a hora do fim da última semana em GMT.

Tabela 47. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 48. Retorna
Tipo	Descrição
Cadeia de caracteres	Fim GMT da semana passada. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo mostra como consultar registros abertos na última semana do mês anterior.

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

Equivalente com escopo

Para usar o método endOfLastWeek() em uma aplicação com escopo, use o método com escopo correspondente: endOfLastWeek().

GlideSystem – endOfLastYear()

Retorna a data e a hora do fim do último ano em GMT.

Tabela 49. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 50. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT no formato aaaa-mm-dd hh:mm:ss.

Este exemplo mostra como consultar registros criados para todos os registros criados no último ano.

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

Equivalente com escopo

Para usar o método endOfLastYear() em uma aplicação com escopo, use o método com escopo correspondente: endOfLastYear().

GlideSystem – endOfNextMonth()

Retorna a data e a hora do fim do próximo mês em GMT.

Tabela 51. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 52. Retorna
Tipo	Descrição
Cadeia de caracteres	Dados e hora GMT. Formato aaaa-mm-dd hh:mm:ss

Este exemplo mostra como consultar registros de conhecimento da base de conhecimento criados desde o início de hoje até o final do próximo mês.

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>";

Equivalente com escopo

Para usar o método endOfNextMonth() em uma aplicação com escopo, use o método com escopo correspondente: endOfNextMonth().

GlideSystem – endOfNextWeek()

Retorna a data e a hora do fim da próxima semana em GMT.

Tabela 53. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 54. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora GMT para o fim da próxima semana. Formato aaaa-mm-dd hh:mm:ss

Este exemplo mostra como usar endOfNextWeek() em uma consulta para obter todos os visitantes da semana passada.

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

Equivalente com escopo

Para usar o método endOfNextWeek() em uma aplicação com escopo, use o método com escopo correspondente: endOfNextWeek().

GlideSystem – endOfNextYear()

Retorna a data e a hora do fim do próximo ano em GMT.

Tabela 55. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 56. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora GMT para o final do próximo ano. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo mostra como usar endOfNextYear() para definir o objeto GlideDateTime para o final do próximo ano.

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

Equivalente com escopo

Para usar o método endOfNextYear() em uma aplicação com escopo, use o método com escopo correspondente: endOfNextYear().

GlideSystem – endOf ThisMonth()

Retorna a data e a hora do fim deste mês em GMT.

Tabela 57. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 58. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora GMT para o final deste mês. Formato aaaa-mm-dd hh:mm:ss

Este exemplo mostra como usar endOf ThisMonth() para definir o objeto GlideDateTime para o fim do mês atual.

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

Equivalente com escopo

Para usar o método endOf ThisMonth () em uma aplicação com escopo, use o método com escopo correspondente: endOf ThisMonth ().

GlideSystem – endOf ThisQuarter()

Retorna a data e a hora do fim deste trimestre em GMT.

Tabela 59. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 60. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora GMT para o final deste trimestre. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo mostra como usar endOf ThisQuarter() para definir o objeto GlideDateTime para o fim do mês atual.

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

Equivalente com escopo

Para usar o método endOf ThisQuarter() em uma aplicação com escopo, use o método com escopo correspondente: endOf ThisQuarter().

GlideSystem – endOf ThisWeek()

Retorna a data e a hora do fim desta semana em GMT.

Tabela 61. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 62. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora GMT para o final desta semana. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo mostra como usar endOf ThisWeek() para definir o objeto GlideDateTime para o fim do mês atual.

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

Equivalente com escopo

Para usar o método endOf ThisWeek () em uma aplicação com escopo, use o método com escopo correspondente: endOf ThisWeek ().

GlideSystem – endOf ThisYear()

Retorna a data e a hora do fim deste ano em GMT.

Tabela 63. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 64. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora GMT para o final deste ano. Formato aaaa-mm-dd hh:mm:ss

Este exemplo mostra como usar endOf ThisYear() para definir o objeto GlideDateTime para o fim do mês atual.

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

Equivalente com escopo

Para usar o método endOf ThisYear () em uma aplicação com escopo, use o método com escopo correspondente: endOf ThisYear ().

GlideSystem – endOfToday()

Recupera a data e a hora do fim de hoje em GMT.

Tabela 65. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 66. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT no formato aaaa-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()

Recupera a data e a hora do fim de amanhã em GMT.

Tabela 67. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 68. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT no formato aaaa-mm-dd hh:mm:ss.

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

GlideSystem – endOf Yesterday ()

Obtém a data e a hora do fim de ontem em GMT.

Tabela 69. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 70. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT no formato (aaaa-mm-dd uh:mm:ss).

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

GlideSystem - eventQueue(cadeia de caracteres nome, objeto glideRecord, cadeia de caracteres parm1, cadeia de caracteres parm2, fila de cadeias de caracteres)

Enfileira um evento para o gerenciador de eventos.

Tabela 71. Parâmetros
Nome	Tipo	Descrição
nome	Cadeia de caracteres	Nome do evento que está sendo enfileirado.
glideRecord	Objeto	Objeto GlideRecord, como "atual".
parm1	Cadeia de caracteres	(Opcional) Salvo com a instância, se especificado.
parm2	Cadeia de caracteres	(Opcional) Salvo com a instância, se especificado.
fila	Cadeia de caracteres	Nome da fila.

Tabela 72. Retornos
Tipo	Descrição
vazio

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

Equivalente com escopo

Para usar o método eventQueue() em uma aplicação com escopo, use o método com escopo correspondente: eventQueue().

GlideSystem - eventQueueScheduled(cadeia de caracteres name, objeto glideRecord, cadeia de caracteres parm1, cadeia de caracteres parm2, objeto expiração)

Enfileira um evento para o gerenciador de eventos em uma data e hora especificadas.

Tabela 73. Parâmetros
Nome	Tipo	Descrição
nome	Cadeia de caracteres	Nome do evento que está sendo enfileirado.
glideRecord	Objeto	Objeto GlideRecord, como "atual".
parm1	Cadeia de caracteres	(Opcional) Salvo com a instância, se especificado.
parm2	Cadeia de caracteres	(Opcional) Salvo com a instância, se especificado.
expiração	Objeto	Data e hora para processar este evento.

Tabela 74. Retornos
Tipo	Descrição
vazio

if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueueScheduled("incident.commented", current, gs.getUserID(), gs.getUserName(), new GlideDateTime('2018-06-02 20:00:00'));
}

Equivalente com escopo

Para usar o método eventQueueScheduled() em uma aplicação com escopo, use o método com escopo correspondente: eventQueueScheduled().

GlideSystem – FlushMessages()

Limpa mensagens de sessão salvas usando addErrorMessage() ou addInfoMessage().

As mensagens da sessão são mostradas na parte superior do formulário. Em scripts do lado do cliente, use g_form.clearMessages() para remover mensagens da sessão.

Tabela 75. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 76. Retorna
Tipo	Descrição
vazio

Este exemplo mostra como analisar e passar de volta mensagens de erro e, em seguida, limpar as mensagens usando 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()

Retorna o caminho do arquivo para o avatar do usuário.

Tabela 77. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 78. Retorna
Tipo	Descrição
Cadeia de caracteres	O caminho do arquivo para o avatar do usuário.

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

Saída:

User avatar ID: c148e1d13741310042106710ce41f149.iix?t=small

GlideSystem – getCurrentScopeName()

Retorna o nome do escopo da aplicação atual.

Tabela 79. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 80. Retorna
Tipo	Descrição
Cadeia de caracteres	Nome do escopo atual.

Este exemplo mostra como usar getCurrentScopeName() para obter o escopo do processador.

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
}

Equivalente com escopo

Para usar o método getCurrentScopeName() em uma aplicação com escopo, use o método com escopo correspondente: getCurrentScopeName().

GlideSystem – getDateFormat()

Retorna o formato de data associado ao usuário atual.

Tabela 81. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 82. Retorna
Tipo	Descrição
Cadeia de caracteres	O formato de data associado ao usuário atual.

O exemplo a seguir retorna o formato de data associado ao usuário.

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

Saída:

yyyy-MM-dd

GlideSystem – getDateTimeFormat()

Retorna o formato de data e hora associado ao usuário atual.

Tabela 83. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 84. Retorna
Tipo	Descrição
Cadeia de caracteres	O formato de data e hora associado ao usuário atual.

O exemplo a seguir retorna o formato da data e hora associados ao usuário.

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

Saída:

yyyy-MM-dd HH:mm:ss

GlideSystem – getDisplayColumn(cadeia de caracteres "tableName")

Recupera a coluna de exibição da tabela.

Tabela 85. Parâmetros
Nome	Tipo	Descrição
tableName	Cadeia de caracteres	Nome da tabela da qual será obtido o nome da coluna de exibição.

Tabela 86. Retornos
Tipo	Descrição
Cadeia de caracteres	Exibir nome da coluna

// 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(cadeia de caracteres "tableName", cadeia de caracteres recordID, cadeia de caracteres "fieldName")

Retorna o valor de exibição de um campo especificado em um registro especificado.

Tabela 87. Parâmetros
Nome	Tipo	Descrição
tableName	Cadeia de caracteres	Nome da tabela.
recordID	Cadeia de caracteres	Sys_id do registro.
fieldName	Cadeia de caracteres	Nome do campo cujo valor de exibição será retornado.

Tabela 88. Retornos
Tipo	Descrição
Cadeia de caracteres	Valor de exibição para o campo.

Este exemplo mostra como usar getDisplayValueFor() para retornar o valor de exibição do campo numérico.

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

GlideSystem – getErrorMessages()

Retorna a lista de mensagens de erro da sessão que foram adicionadas por addErrorMessage().

Tabela 89. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 90. Retorna
Tipo	Descrição
Cadeia de caracteres	Lista de mensagens de erro

Este exemplo mostra como analisar e passar de volta mensagens de erro usando getErrorMessages().

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

Equivalente com escopo

Para usar o método getErrorMessages() em uma aplicação com escopo, use o método com escopo correspondente: getErrorMessages().

GlideSystem - getEscapedProperty(cadeia de caracteres chave, objeto substituto de objeto)

Recupera a propriedade e faz o escape para análise de XML.

Tabela 91. Parâmetros
Nome	Tipo	Descrição
chave	Cadeia de caracteres	Chave da propriedade cujo valor deve ser retornado.
Substituir Objeto	Objeto	Opcional. Objeto a ser retornado se a propriedade não for encontrada.

Tabela 92. Retornos
Tipo	Descrição
Cadeia de caracteres	A propriedade ou o substitutoObject se a propriedade não for encontrada.

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

GlideSystem – getImpersonatingUserDisplayName()

Retorna o nome de exibição do usuário que está representando.

Tabela 93. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 94. Retorna
Tipo	Descrição
Cadeia de caracteres	Nome de exibição do usuário que está representando.

Este exemplo mostra como obter o nome de exibição do usuário do representante.

var user = gs.getUserDisplayName();
gs.print ("The current user display name is: " + user);

var name = gs.getImpersonatingUserDisplayName(); 
gs.print("Impersonating user display name: " + name);

Saída:

The current user display name is: abel.tuter
Impersonating user display name: admin

GlideSystem – getImpersonatingUserName()

Retorna o nome do usuário de representação ou nulo se não estiver representando.

Tabela 95. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 96. Retorna
Tipo	Descrição
Cadeia de caracteres	Nome do usuário que está representando

Este exemplo mostra como obter o nome de usuário do representante.

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

Recupera a lista de mensagens informativas da sessão que foram adicionadas por addInfoMessage().

Tabela 97. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 98. Retorna
Tipo	Descrição
Cadeia de caracteres	Lista de mensagens informativas.

Este exemplo mostra como obter as mensagens informativas.

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

GlideSystem – getInitials()

Retorna as iniciais do usuário.

Tabela 99. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 100. Retorna
Tipo	Descrição
Cadeia de caracteres	As iniciais do usuário.

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

Saída:

User initials: SA

GlideSystem - getMessage(cadeia de caracteres messageID, argumentos de objeto)

Recupera mensagens traduzidas da tabela Mensagem [sys_ui_message] para exibir em uma IU.

Se o identificador de mensagem especificado (chave) existir na tabela Mensagem [sys_ui_message] para o idioma atual, o método retornará a mensagem traduzida. Se o identificador de mensagem especificado não existir para o idioma atual, o método retornará a versão em inglês da mensagem. Se o identificador da mensagem não existir na tabela, ele retornará o ID da mensagem.

Para obter informações adicionais sobre a tabela Mensagem, consulte Tabela Mensagem.

Nota:

Se a mensagem de IU tiver um tiquetaque ('), pode haver problemas com a mensagem no script; para escapar dos tiques ('), use getMessageS(String, Object).

Tabela 101. Parâmetros
Nome	Tipo	Descrição
ID da mensagem	Cadeia de caracteres	Identificador de mensagem. Você pode localizar este valor no campo Chave da tabela Mensagem [sys_ui_message]. Observe que o campo Chave pode ser exatamente igual à cadeia de caracteres da mensagem real.
args	Objeto	Opcional. Lista de cadeias de caracteres ou outros valores definidos por java.text.MessageFormat que substituem as variáveis na mensagem especificada. Por exemplo: `gs.getMessage("Anula a adição da ação '{0}', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo, `'{0}'` foi substituído pelo conteúdo de `current.action.name`. Nota: Os valores passados não são traduzidos. Eles são inseridos textualmente na mensagem.

Tabela 102. Retornos
Tipo	Descrição
Cadeia de caracteres	Mensagem de IU solicitada.

Este exemplo mostra a mensagem retornada para o usuário atual quando o espanhol é o idioma atual.

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

Saída:

las filas no se actualizarán

Este exemplo mostra como substituir uma única variável em uma mensagem.

// 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);

Saída:

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

Este exemplo mostra como substituir várias variáveis em uma mensagem.

// 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);

Saída:

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

Equivalente com escopo

Para usar o método getMessage() em uma aplicação com escopo, use o método com escopo correspondente: getMessage().

GlideSystem - getMessageS(cadeia de caracteres messageID, argumentos de objeto)

Recupera mensagens traduzidas para exibir na IU e faz o escape de todos os tiques (').

Se o identificador de mensagem especificado (chave) existir na tabela Mensagem [sys_ui_message] para o idioma atual, o método retornará a mensagem traduzida. Se o identificador de mensagem especificado não existir para o idioma atual, o método retornará a versão em inglês da mensagem. Se o identificador da mensagem não existir na tabela, ele retornará o ID da mensagem.

Para obter informações adicionais sobre a tabela Mensagem, consulte Tabela Mensagem.

Útil se você estiver inserindo em uma expressão JavaScript do Jelly.

Tabela 103. Parâmetros
Nome	Tipo	Descrição
ID da mensagem	Cadeia de caracteres	Identificador de mensagem. Você pode localizar este valor no campo Chave da tabela Mensagem [sys_ui_message]. Observe que o campo Chave pode ser exatamente igual à cadeia de caracteres da mensagem real.
args	Objeto	Opcional. Lista de cadeias de caracteres ou outros valores definidos por java.text.MessageFormat que substituem as variáveis na mensagem especificada. Por exemplo: `gs.getMessage("Anula a adição da ação '{0}', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo, `'{0}'` foi substituído pelo conteúdo de `current.action.name`. Nota: Os valores passados não são traduzidos. Eles são inseridos textualmente na mensagem.

Tabela 104. Retornos
Tipo	Descrição
Cadeia de caracteres	Mensagem especificada com tiques de escape.

/*
"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);

Saída:

J'aime la France

GlideSystem - getMessageLang (cadeia de caracteres de mensagem, cadeia de caracteres de idioma, argumentos de matriz)

Traduz a mensagem especificada para o idioma especificado.

Você também pode incorporar variáveis na mensagem passada. O método resolve essas variáveis com os valores passados na matriz args.

Tabela 105. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem a ser traduzida.
idioma	Cadeia de caracteres	Idioma no qual a mensagem será traduzida. Formato: padrão BCP 47
args	Matriz	Opcional. Lista de cadeias de caracteres ou outros valores definidos por java.text.MessageFormat que substituem as variáveis na mensagem especificada. Por exemplo: `gs.getMessageLang("Anula a adição da ação '{0}', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo, `'{0}'` foi substituído pelo conteúdo de `current.action.name`. Nota: Os valores passados não são traduzidos. Eles são inseridos textualmente na mensagem.

Tabela 106. Retornos
Tipo	Descrição
Cadeia de caracteres	Mensagem traduzida.

O exemplo a seguir transforma a mensagem especificada em espanhol.

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

Saída:

Nuevo correo electrónico

O exemplo a seguir mostra como substituir variáveis em uma mensagem.

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

Saída:

Hay 7 correos nuevos para John Smith

GlideSystem - getNodeName (objeto de objeto, índice de número)

Retorna o nome do nó do índice especificado.

Tabela 107. Parâmetros
Nome	Tipo	Descrição
obj	Objeto	Objeto a ser examinado.
índice	Número	Índice do qual obter o nome do nó.

Tabela 108. Retornos
Tipo	Descrição
Cadeia de caracteres	Nome do nó

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 (objeto de objeto, índice de número)

Retorna o valor do nó para o índice especificado.

Tabela 109. Parâmetros
Nome	Tipo	Descrição
obj	Objeto	Objeto a ser examinado.
índice	Número	Índice do qual obter o valor do nó

Tabela 110. Retornos
Tipo	Descrição
Objeto	Valor do nó

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 (chave de cadeia de caracteres, padrão de objeto)

Retorna a preferência do usuário especificada.

Tabela 111. Parâmetros
Nome	Tipo	Descrição
chave	Cadeia de caracteres	Chave para a preferência.
padrão	Objeto	Valor padrão a ser usado se a preferência especificada não for encontrada.

Tabela 112. Retornos
Tipo	Descrição
Cadeia de caracteres	Valor de preferência. Se não houver preferência, retorna o valor padrão especificado.

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 (cadeia de caracteres chave, objeto alt)

Retorna o valor de uma propriedade do Glide. Se a propriedade não for encontrada, retornará o valor alt especificado.

Tabela 113. Parâmetros
Nome	Tipo	Descrição
chave	Cadeia de caracteres	Chave da propriedade cujo valor deve ser retornado.
alt	Objeto	Opcional. Objeto alternativo a ser retornado se a propriedade não for encontrada.

Tabela 114. Retornos
Tipo	Descrição
Cadeia de caracteres	Valor da propriedade Glide ou do objeto alternativo definido acima.

//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(cadeia de caracteres script)

Retorna o erro de script encontrado no script especificado, se houver.

Nota:

O script não é executado por esta função, ele é verificado somente quanto a erros de sintaxe.

Tabela 115. Parâmetros
Nome	Tipo	Descrição
script	Cadeia de caracteres	Script para verificar erros.

Tabela 116. Retornos
Tipo	Descrição
Cadeia de caracteres	Mensagens de erro Nulo se não houver erro.

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

GlideSystem – getSession()

Retorna um objeto GlideSession.

Tabela 117. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 118. Retorna
Tipo	Descrição
Objeto GlideSession	Objeto GlideSession para a sessão atual

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

Equivalente com escopo

Para usar o método getSession() em uma aplicação com escopo, use o método com escopo correspondente: getSession().

GlideSystem – getSessionID()

Retorna o ID da sessão GlideSession.

Tabela 119. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 120. Retorna
Tipo	Descrição
Cadeia de caracteres	ID da Sessão

var gr_NOW = new GlideRecord('v_user_session');
var sessionId = gs.getSessionID();
gs.log("Session ID is: " + sessionId);

Saída

Session ID is: FEE589B3DB7EE4103DD9C39D139619D7

Equivalente com escopo

Para usar o método getSessionID() em uma aplicação com escopo, use o método com escopo correspondente: getSessionID.

GlideSystem - getStyle(cadeia de caracteres "tableName", cadeia de caracteres "fieldName", cadeia de caracteres "fieldValue")

Retorna o estilo definido para a tabela, o campo e o valor do campo.

Tabela 121. Parâmetros
Nome	Tipo	Descrição
tableName	Cadeia de caracteres	Nome da tabela
fieldName	Cadeia de caracteres	Nome do campo
fieldValue	Cadeia de caracteres	Valor do campo

Tabela 122. Retornos
Tipo	Descrição
Cadeia de caracteres	Estilo do campo especificado.

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

GlideSystem – getTimeFormat()

Retorna o formato de hora associado ao usuário atual.

Tabela 123. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 124. Retorna
Tipo	Descrição
Cadeia de caracteres	Formato de hora associado ao usuário atual.

O exemplo de código a seguir mostra como chamar este método.

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

Saída:

HH:mm:ss

GlideSystem – getUser()

Retorna uma referência ao objeto de usuário para o usuário atual.

Tabela 125. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 126. Retorna
Tipo	Descrição
GlideUser	Referência a um objeto de usuário para o usuário atual.

O exemplo a seguir mostra como obter o objeto de usuário atual.

var user = gs.getUser();
gs.print ("The current user is: " + user);

Saída:

The current user is: com.glide.sys.User@db5dd9

O exemplo a seguir mostra como verificar se o usuário atual tem a função workflow_admin.

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

Saída:

Does the current user have the workflow_admin role: true

Equivalente com escopo

Para usar o método getUser() em uma aplicação com escopo, use o método com escopo correspondente: getUser().

GlideSystem – getUserDisplayName()

Obtém o nome de exibição do usuário atual.

Tabela 127. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 128. Retorna
Tipo	Descrição
Cadeia de caracteres	O campo de nome do usuário atual. Por exemplo, este método retorna Abel Tuter em vez de abel.tuter.

Este exemplo obtém o nome de exibição do usuário atual.

gs.info(gs.getUserDisplayName());

Saída:

System Administrator

Equivalente com escopo

Para usar o método getUserDisplayName() em uma aplicação com escopo, use o método com escopo correspondente: getUserDisplayName().

GlideSystem – getUserID()

Retorna o sys_id do usuário atual.

Tabela 129. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 130. Retorna
Tipo	Descrição
Cadeia de caracteres	Sys_id do usuário atual.

Este exemplo obtém o sys_id do usuário atual.

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

Saída:

Current user ID: 6816f79cc0a8016401c5a33be04be441

Equivalente com escopo

Para usar o método getUserID() em uma aplicação com escopo, use o método com escopo correspondente: getUserID().

GlideSystem – getUserName()

Retorna o nome de usuário do usuário atual.

Tabela 131. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 132. Retorna
Tipo	Descrição
Cadeia de caracteres	O nome de usuário do usuário atual. Por exemplo, este método retorna abel.tuter em vez de Abel Tuter.

Este exemplo obtém o nome de usuário do usuário atual e um usuário representado.

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

Saída:

The current user name is: admin
The impersonated user name is: abel.tuter

Equivalente com escopo

Para usar o método getUserName() em uma aplicação com escopo, use o método com escopo correspondente: getUserName().

GlideSystem – getUserNameByUserID(cadeia de caracteres user_id)

Retorna o nome de exibição do usuário com base em um nome de login de usuário fornecido.

Tabela 133. Parâmetros
Nome	Tipo	Descrição
user_id	Cadeia de caracteres	Nome de login do usuário do qual o nome de exibição associado será recuperado.

Tabela 134. Retornos
Tipo	Descrição
Cadeia de caracteres	Nome de exibição do usuário solicitado. Nota: Se este método não puder encontrar um usuário com o ID solicitado, ele retornará o valor de entrada fornecido.

O exemplo a seguir mostra como obter o nome de exibição do usuário especificado.

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

Saída:

User display name is: Abel Tuter

GlideSystem – getXMLNodeList(cadeia de caracteres xml)

Constrói uma matriz de todos os nós e valores em um documento XML.

Tabela 135. Parâmetros
Nome	Tipo	Descrição
xml	Cadeia de caracteres	Documento XML a ser analisado.

Tabela 136. Retornos
Tipo	Descrição
Lista de matrizes	Lista de nomes e valores do nó XML mais externo.

O exemplo a seguir mostra como obter uma lista de nós XML e seus valores associados em uma lista de matrizes.

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

Saída:

The node contains: [to : Tove, from : Jani, heading : Reminder, body : Don't forget me this weekend!]

GlideSystem – getXMLText(cadeia de caracteres xml, cadeia de caracteres xpathQuery)

Retorna o texto XML do primeiro elemento na cadeia de caracteres XML que corresponde à consulta XPath.

Tabela 137. Parâmetros
Nome	Tipo	Descrição
xml	Cadeia de caracteres	Cadeia de caracteres XML a ser pesquisada.
xpathQuery	Cadeia de caracteres	Consulta XPath a ser correspondida.

Tabela 138. Retornos
Tipo	Descrição
Cadeia de caracteres	Nó XML que corresponde aos parâmetros de pesquisa.

O exemplo a seguir mostra como obter o valor de um elemento XML especificado em um nó passado.

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

Saída:

The from element contains: Jani

GlideSystem – hasRole(cadeia de caracteres roleName)

Determina se o usuário atual tem pelo menos uma das funções aprovadas.

Tabela 139. Parâmetros
Nome	Tipo	Descrição
roleName	Cadeia de caracteres	Lista separada por vírgulas de funções.

Tabela 140. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se o usuário atual tem pelo menos uma das funções especificadas. Valores possíveis: verdadeiro: o usuário tem pelo menos uma das funções aprovadas. Também retornará verdadeiro se o usuário tiver a função de administrador. falso: o usuário não tem nenhuma das funções passadas.

O exemplo a seguir mostra como verificar se o usuário atual tem a função admin ou 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
}

Equivalente com escopo

Para usar o método hasRole() em uma aplicação com escopo, use o método com escopo correspondente: hasRole().

GlideSystem - hasRoleInGroup (objeto roleName, grupo de objetos)

Determina se o usuário atual tem a função especificada em um grupo especificado.

Tabela 141. Parâmetros
Nome	Tipo	Descrição
roleName	Objeto	Nome da função.
grupo	Objeto	Sys_id do grupo para verificar a função especificada.

Tabela 142. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se o usuário atual tem a função especificada no grupo especificado. Valores possíveis: verdadeiro: o usuário conectado está atribuído à função especificada no grupo especificado. falso: o usuário conectado não está atribuído à função especificada no grupo especificado.

O exemplo a seguir mostra como verificar se o grupo sys_user_group tem a função 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(Número de horas)

Retorna uma data e hora para o número especificado de horas atrás. O valor retornado é ajustado para o fuso horário da instância.

Tabela 143. Parâmetros
Nome	Tipo	Descrição
horas	Número	Número de horas atrás.

Tabela 144. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora UTC para o número especificado de horas atrás. Formato: aaaa-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);

Saída

Current date/time: 2021-03-17 20:53:25
Ago date/time: 2021-03-17 19:53:25

Equivalente com escopo

Para usar o método hoursAgo() em uma aplicação com escopo, use o método com escopo correspondente: hoursAgo().

GlideSystem - hoursAgoEnd(Número de horas)

Retorna uma data e hora para o fim da hora para o número especificado de horas atrás. O valor retornado é ajustado para o fuso horário da instância.

Tabela 145. Parâmetros
Nome	Tipo	Descrição
horas	Número (inteiro)	Número de horas atrás.

Tabela 146. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora UTC para o fim do número especificado de horas atrás. Formato: aaaa-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);

Saída

Current date/time: 2021-03-17 20:59:59
Ago date/time: 2021-03-17 19:59:59

Equivalente com escopo

Para usar o método hoursAgoEnd() em uma aplicação com escopo, use o método com escopo correspondente: hoursAgoEnd().

GlideSystem - hoursAgoStart(Número de horas)

Retorna uma data e hora para o início da hora para o número especificado de horas atrás. O valor retornado é ajustado para o fuso horário da instância.

Tabela 147. Parâmetros
Nome	Tipo	Descrição
horas	Número	Número de horas atrás.

Tabela 148. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora UTC para o fim do número especificado de horas atrás. Formato: aaaa-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);

Saída

Current date/time: 2021-03-17 20:00:00
Ago date/time: 2021-03-17 19:00:00

Equivalente com escopo

Para usar o método hoursAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: hoursAgoStart().

GlideSystem - isFirstDayOfMonth(Data do objeto)

Verifica se a data no objeto de data especificado é o primeiro dia do mês.

Tabela 149. Parâmetros
Nome	Tipo	Descrição
data	Objeto	Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate.

Tabela 150. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se a data no objeto de data especificado é o primeiro dia do mês. Valores possíveis: verdadeiro: primeiro dia do mês. falso: não é o primeiro dia do mês.

Este exemplo mostra como determinar se a data no objeto de data especificado é o primeiro dia do mês.

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

Saída

First day of month: true
First day of month: false

GlideSystem - isFirstDayOfWeek(Data do objeto)

Verifica se a data no objeto de data especificado é o primeiro dia da semana. Este método usa o padrão ISO de segunda-feira como o primeiro dia da semana.

Tabela 151. Parâmetros
Nome	Tipo	Descrição
data	Objeto	Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate.

Tabela 152. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se a data no objeto de data atual é o primeiro dia da semana (segunda-feira). Valores possíveis: verdadeiro: primeiro dia da semana. falso: não é o primeiro dia da semana.

Este exemplo mostra como determinar se a data no objeto de data especificado é o primeiro dia da semana.

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

Saída

First day of week: false
First day of week: true

GlideSystem - isFirstDayOfYear(Data do objeto)

Verifica se a data no objeto de data especificado é o primeiro dia do ano.

Tabela 153. Parâmetros
Nome	Tipo	Descrição
data	Objeto	Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate.

Tabela 154. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se a data no objeto de data especificado é o primeiro dia do ano. Valores possíveis: verdadeiro: primeiro dia do ano. falso: não é o primeiro dia do ano.

Este exemplo mostra como determinar se a data no objeto de data especificado é o primeiro dia do ano.

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

Saída

First day of year: false
First day of year: true

GlideSystem – isInteractive()

Verifica se a sessão atual é interativa.

Um exemplo de uma sessão interativa é quando um usuário faz login usando a tela de login. Um exemplo de uma sessão não interativa é usar uma solicitação SOAP para recuperar dados.

Tabela 155. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 156. Retorna
Tipo	Descrição
Booliano	Sinalizador que indica se a sessão é interativa. Valores possíveis: verdadeiro: a sessão é interativa. falso: a sessão não é interativa.

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

Equivalente com escopo

Para usar o método isInteractive() em uma aplicação com escopo, use o método com escopo correspondente: isInteractive().

GlideSystem - isLastDayofMonth(Data do objeto)

Verifica se a data no objeto de data especificado é o último dia do mês.

Tabela 157. Parâmetros
Nome	Tipo	Descrição
data	Objeto	Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate.

Tabela 158. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se a data no objeto de data especificado é o último dia do mês. Valores possíveis: verdadeiro: último dia do mês. falso: não é o último dia do mês.

Este exemplo mostra como determinar se a data no objeto de data especificado é o último dia do mês.

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

Saída

Last day of month: true
Last day of month: false

GlideSystem - isLastDayOfWeek(data do objeto)

Verifica se a data no objeto de data especificado é o último dia da semana. Este método usa o padrão ISO de domingo sendo o último dia da semana.

Tabela 159. Parâmetros
Nome	Tipo	Descrição
data	Objeto	Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate.

Tabela 160. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se a data no objeto de data atual é o último dia da semana (domingo). Valores possíveis: verdadeiro: último dia da semana. falso: não é o último dia da semana.

Este exemplo mostra como determinar se a data no objeto de data especificado é o último dia da semana.

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

Saída

First day of week: false
First day of week: true

GlideSystem - isLastDayOfYear(Data do objeto)

Verifica se a data no objeto de data especificado é o último dia do ano.

Tabela 161. Parâmetros
Nome	Tipo	Descrição
data	Objeto	Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate.

Tabela 162. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se a data no objeto de data atual é o último dia do ano. Valores possíveis: verdadeiro: último dia do ano. falso: não é o último dia do ano.

Este exemplo mostra como determinar se a data no objeto de data especificado é o último dia do ano.

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

Saída

Last day of year: true
Last day of year: false

GlideSystem - isLoggedIn()

Determina se o usuário atual está conectado no momento.

Tabela 163. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 164. Retorna
Tipo	Descrição
Booliano	Sinalizador que indica se o usuário atual está conectado. Valores possíveis: verdadeiro: o usuário está conectado. falso: o usuário não está conectado.

Este exemplo mostra como determinar se o usuário atual está conectado.

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

Saída

Current user is logged in

Equivalente com escopo

Para usar o método isLoggedIn() em uma aplicação com escopo, use o método com escopo correspondente: isLoggedIn().

GlideSystem - isMobile()

Determina se a solicitação veio de um dispositivo móvel.

Você pode usar este método em condições de ação de IU e regras de negócio.

Tabela 165. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 166. Retorna
Tipo	Descrição
Booliano	Sinalizador que indica se a solicitação veio de um dispositivo móvel. Valores possíveis: verdadeiro: dispositivo móvel. falso: dispositivo não móvel.

Este exemplo mostra como determinar se o dispositivo atual é um dispositivo móvel.

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

Saída

Submitted from mobile UI

Equivalente com escopo

Para usar o método isMobile() em uma aplicação com escopo, use o método com escopo correspondente: isMobile().

GlideSystem – lastWeek()

Retorna a data e a hora de uma semana atrás em GMT.

Tabela 167. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 168. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora de uma semana atrás. Formato: aaaa-MM-dd hh:mm:ss

Este exemplo mostra como obter a data que é uma semana a partir da data no objeto de data atual.

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

Saída

Current date: 2021-03-22 15:27:07
One week earlier: 2021-03-15 15:27:07

GlideSystem - log (mensagem de cadeia de caracteres, origem de cadeia de caracteres)

Registra uma mensagem no log do sistema e a salva na tabela syslog.

Tabela 169. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem para registrar.
Fonte	Cadeia de caracteres	Opcional. Origem da mensagem.

Tabela 170. Retornos
Tipo	Descrição
vazio

O exemplo a seguir mostra como publicar uma entrada de log usando constantes e variáveis.

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(cadeia de caracteres mensagem, cadeia de caracteres de origem)

Registra um erro no log do sistema e o salva na tabela syslog.

Tabela 171. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem de erro a ser registrada.
Fonte	Cadeia de caracteres	Opcional. Origem da mensagem.

Tabela 172. Retornos
Tipo	Descrição
vazio

O exemplo a seguir registrará em log um erro se a tabela Incidente não puder ser encontrada.

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

GlideSystem - logWarning(cadeia de caracteres mensagem, cadeia de caracteres de origem)

Registra um aviso no log do sistema e o salva na tabela syslog.

Tabela 173. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem para registrar.
Fonte	Cadeia de caracteres	Opcional. Origem da mensagem.

Tabela 174. Retornos
Tipo	Descrição
vazio

O exemplo a seguir registrará em log um aviso se a tabela Incidente não puder ser encontrada.

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

GlideSystem - minutosAgo (Número de minutos)

Retorna uma data e hora para o número especificado de minutos atrás.

Tabela 175. Parâmetros
Nome	Tipo	Descrição
minutos	Número	Número de minutos no passado a serem retornados.

Tabela 176. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora UTC para o número especificado de minutos atrás. Formato: aaaa-mm-dd hh:mm:ss

Este exemplo mostra como usar o métodominutesAgo() em uma chamada addQuery().

// 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 – minutosAgoEnd(Número de minutos)

Retorna uma data e hora para o fim do minuto há um determinado número de minutos.

Tabela 177. Parâmetros
Nome	Tipo	Descrição
minutos	Número	Número inteiro de minutos atrás, como 5 ou 11.

Tabela 178. Retornos
Tipo	Descrição
Cadeia de caracteres	GMT o número especificado de minutos atrás, no final do minuto (59 segundos). Formato: aaaa-mm-dd hh:mm:ss

O exemplo a seguir exibe a data e hora atuais e a data e hora 30 minutos atrás no final do minuto em GMT.

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

Saída

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

Equivalente com escopo

Para usar o método minutosAgoEnd() em uma aplicação com escopo, use o método com escopo correspondente: minutosAgoEnd().

GlideSystem – minutosAgoStart(Número de minutos)

Retorna uma data e hora para o início do minuto há um determinado número de minutos.

Tabela 179. Parâmetros
Nome	Tipo	Descrição
minutos	Número	Número inteiro de minutos atrás, como 15 ou 112.

Tabela 180. Retornos
Tipo	Descrição
Cadeia de caracteres	GMT o número especificado de minutos atrás, no início do minuto. Formato: aaaa-mm-dd hh:mm:ss

O exemplo a seguir exibe a data e hora atuais e a data e hora 30 minutos atrás no início do minuto em GMT.

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

Saída

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

Equivalente com escopo

Para usar o método minutosAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: minutosAgoStart().

GlideSystem - monthAgo(Número de meses)

Retorna uma data e hora de um determinado número de meses atrás.

Tabela 181. Parâmetros
Nome	Tipo	Descrição
meses	Número	Número inteiro de meses atrás.

Tabela 182. Retornos
Tipo	Descrição
Cadeia de caracteres	GMT do número especificado de meses atrás exatamente ao mesmo tempo. Formato: aaaa-mm-dd hh:mm:ss

O exemplo a seguir exibe a data e hora atuais e a data e hora de um mês atrás ao mesmo tempo em GMT.

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

Saída

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

Equivalente com escopo

Para usar o método monthAgo() em uma aplicação com escopo, use o método com escopo correspondente: monthAgo().

GlideSystem - monthAgoEnd(Número de meses)

Retorna a data e a hora do último dia do mês há um número especificado de meses.

Tabela 183. Parâmetros
Nome	Tipo	Descrição
meses	Número (inteiro)	Número de meses, como 4 ou 16.

Tabela 184. Retornos
Tipo	Descrição
Cadeia de caracteres	Carimbo de data/hora do mês, o número especificado de meses atrás, no horário local. Formato: UTC aaaa-mm-dd hh:mm:ss

O exemplo a seguir exibe a data e hora atuais e a data e hora de dois meses atrás no final do mês útil.

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

Saída:

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

GlideSystem - monthAgoStart(Número de meses)

Retorna uma data e hora para o início do mês de um determinado número de meses atrás.

Tabela 185. Parâmetros
Nome	Tipo	Descrição
meses	Número	Número inteiro de meses atrás, como 5 ou 14.

Tabela 186. Retornos
Tipo	Descrição
Cadeia de caracteres	Início GMT do mês há o número especificado de meses. Formato: aaaa-mm-dd hh:mm:ss

O exemplo a seguir exibe a data e hora atuais e a data e hora de três meses atrás em GMT.

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

Saída

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

Equivalente com escopo

Para usar o método monthAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: monthAgoStart().

GlideSystem - nil (objeto de objeto)

Consulta um objeto e retorna verdadeiro se o objeto for nulo ou contiver uma cadeia de caracteres vazia.

Tabela 187. Parâmetros
Nome	Tipo	Descrição
obj	Objeto	O objeto a ser verificado.

Tabela 188. Retornos
Tipo	Descrição
Booliano	Verdadeiro se for cadeia de caracteres nula ou vazia; caso contrário, falso.

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

Equivalente com escopo

Para usar o método nil() em uma aplicação com escopo, use o método com escopo correspondente: nil().

GlideSystem – now()

Retorna a data atual em UTC.

Tabela 189. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 190. Retorna
Tipo	Descrição
Cadeia de caracteres	A data atual no formato definido pelo usuário, em 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()

Retorna a data e hora atuais no formato UTC.

Tabela 191. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 192. Retorna
Tipo	Descrição
Cadeia de caracteres	A data e hora UTC atuais

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

Retorna a data e a hora atuais no formato definido pelo usuário.

Tabela 193. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 194. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora atuais no formato definido pelo usuário. Para obter mais informações sobre como definir o formato de data e hora do sistema, consulte Campos de data e data/hora.

var currentDateTime = gs.nowDateTime();
gs.print("Current date/time: " + currentDateTime);

Saída

Current date/time: 2021-03-17 14:04:02

Ao definir uma variável em um script de fluxo de trabalho para a data e hora atuais, use o método setDisplayValue(). O script a seguir define a variável de fluxo de trabalho end_date com a data e hora atuais.

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

GlideSystem – nowGlideDateTime()

Obtém um objeto GlideDateTime com a data e hora atuais.

Depois de obter um objeto GlideDateTime com a data e a hora atuais, você pode usar os métodos GlideDateTime para executar operações de data e hora, como cálculos de data e hora, formatação de data e hora ou conversão entre formatos de data e hora.

Tabela 195. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 196. Retorna
Tipo	Descrição
Objeto	Objeto GlideDateTime com a data e hora atuais no formato GMT.

Define o campo u_target_date com a data e hora atuais no formato GMT.

current.u_target_date = gs.nowGlideDateTime();

GlideSystem - imprimir (cadeia de caracteres mensagem)

Grava uma mensagem no log do sistema.

Este método não grava a mensagem na tabela syslog, a menos que a depuração tenha sido ativada.

Tabela 197. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	A mensagem a ser registrada

Tabela 198. Retornos
Tipo	Descrição
vazio

var rec = new GlideRecord('incident');
rec.addQuery('active',false);
rec.query();
while (rec.next()) { 
 gs.print('Inactive incident ' + rec.number + ' deleted');
 rec.deleteRecord();
}

GlideSystem - trimestresAgo (Número trimestres)

Retorna uma data e hora de um determinado número de trimestres atrás.

Tabela 199. Parâmetros
Nome	Tipo	Descrição
trimestres	Número	Número inteiro dos trimestres anteriores.

Tabela 200. Retornos
Tipo	Descrição
Cadeia de caracteres	GMT do trimestre que era o número especificado de trimestres atrás. Formato: aaaa-mm-dd hh:mm:ss

O exemplo a seguir exibe a data e hora atuais e a data e hora de quatro trimestres atrás ao mesmo tempo.

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

Saída

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

GlideSystem - trimestresAgoEnd(Número trimestres)

Retorna uma data e hora para o último dia do trimestre, para um número especificado de trimestres atrás.

Tabela 201. Parâmetros
Nome	Tipo	Descrição
trimestres	Número	Um número inteiro de trimestres

Tabela 202. Retornos
Tipo	Descrição
Cadeia de caracteres	Fim GMT do trimestre que era o número especificado de trimestres atrás, no formato aaaa-mm-dd hh:mm:ss

Equivalente com escopo

Para usar o método trimestresAgoEnd() em uma aplicação com escopo, use o método com escopo correspondente: trimestresAgoEnd().

GlideSystem - trimestresAgoInício(Número trimestres)

Retorna uma data e hora para o primeiro dia do trimestre, para um número especificado de trimestres atrás.

Tabela 203. Parâmetros
Nome	Tipo	Descrição
trimestres	Número	Um número inteiro de trimestres

Tabela 204. Retornos
Tipo	Descrição
Cadeia de caracteres	Fim GMT do mês que era o número especificado de trimestres atrás, no formato aaaa-mm-dd hh:mm:ss

Equivalente com escopo

Para usar o método trimestresAgoStart() em uma aplicação com escopo, use o método com escopo correspondente: trimestresAgoStart().

GlideSystem - setProperty(Chave de cadeia de caracteres, Valor de cadeia de caracteres, Descrição de cadeia de caracteres)

Define a chave especificada para o valor especificado.

Nota:

Deve-se ter cuidado ao definir as propriedades do sistema (sys_properties) usando este método, pois ele causa uma limpeza de cache em todo o sistema. Cada limpeza pode causar degradação no sistema enquanto os caches são reconstruídos. Se um valor precisar ser atualizado com frequência, ele não deverá ser armazenado como uma propriedade do sistema. Em geral, você só deve colocar valores na tabela sys_properties que não mudam com frequência.

Tabela 205. Parâmetros
Nome	Tipo	Descrição
chave	Cadeia de caracteres	A chave da propriedade a ser definida.
valor	Cadeia de caracteres	O valor da propriedade a ser definido.
descrição	Cadeia de caracteres	Uma descrição da propriedade.

Tabela 206. Retornos
Tipo	Descrição
vazio

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

Saída: barra

Equivalente com escopo

Para usar o método setProperty() em uma aplicação com escopo, use o método com escopo correspondente: setProperty().

GlideSystem – setRedirect(Object URI)

Define o URI de redirecionamento para esta transação, que determina a próxima página que o usuário verá.

Tabela 207. Parâmetros
Nome	Tipo	Descrição
URI (Identificador uniforme de recursos)	Objeto	URI a ser definido como redirecionamento

Tabela 208. Retornos
Tipo	Descrição
vazio

Este exemplo redireciona o usuário para um item do catálogo específico e passa o e-mail atual como um parâmetro.

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

Equivalente com escopo

Para usar o método setRedirect() em uma aplicação com escopo, use o método com escopo correspondente: setRedirect().

GlideSystem – setReturn(Object URI)

Define o URI de retorno para esta transação. Isso determina para qual página o usuário será direcionado quando retornar do próximo formulário.

Tabela 209. Parâmetros
Nome	Tipo	Descrição
URI (Identificador uniforme de recursos)	Objeto	URI a ser definido como o local de retorno.

Tabela 210. Retornos
Tipo	Descrição
vazio

Este exemplo garante que o usuário retorne à página atual quando terminar com a próxima.

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

GlideSystem – tableExists(cadeia de caracteres "tableName")

Determina se existe uma tabela de banco de dados na instância ServiceNow.

Tabela 211. Parâmetros
Nome	Tipo	Descrição
tableName	Cadeia de caracteres	Nome da tabela a ser verificada.

Tabela 212. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se a tabela especificada existe na instância ServiceNow. Valores possíveis: verdadeiro: a tabela existe falso: a tabela não existe

Este exemplo mostra como verificar se as tabelas incidente e foo existem na instância ServiceNow.

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

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

Saída

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

Equivalente com escopo

Para usar o método tableExists() em uma aplicação com escopo, use o método com escopo correspondente: tableExists().

GlideSystem - userID()

Retorna o sys_id do usuário associado a esta sessão. Em vez disso, use getUserID().

Tabela 213. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 214. Retorna
Tipo	Descrição
Cadeia de caracteres	Sys_id do usuário atual.

O exemplo a seguir mostra como cancelar a atribuição de todos os registros de incidentes ativos atribuídos ao usuário atual.

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

Saída:

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

Exclui todos os registros de trabalho agendado abertos na tabela Programação (sys_trigger) para o GlideRecord especificado.

Tabela 215. Parâmetros
Nome	Tipo	Descrição
glideRecord	Objeto	O GlideRecord

Tabela 216. Retornos
Tipo	Descrição
vazio

GlideSystem - daysAgo(Número de anos)

Obtém uma data e hora para um determinado número de anos atrás.

Tabela 217. Parâmetros
Nome	Tipo	Descrição
anos	Número	Um número inteiro de anos

Tabela 218. Retornos
Tipo	Descrição
Cadeia de caracteres	Início GMT do ano que é o número especificado de anos atrás, no formato aaaa-mm-dd hh:mm:ss.

Equivalente com escopo

Para usar o métodoyearsAgo (Numberyears) em uma aplicação com escopo, use o método com escopo correspondente: yearsAgo(Numberyears).

GlideSystem - ontem ()

Retorna a hora de ontem (24 horas atrás).

Tabela 219. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 220. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT para 24 horas atrás, no formato aaaa-mm-dd hh:mm:ss

Equivalente com escopo

Para usar o método ontem() em uma aplicação com escopo, use o método com escopo correspondente: ontem().