GlideSystem - Global

GlideSystem - addErrorMessage(mensagem do objeto)

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

Usar 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. AddErrorMessage() em uma aplicação com escopo, use o método com escopo correspondente: AddErrorMessage() .

GlideSystem - addHighMessage(mensagem de cadeia de caracteres)

Exibe uma mensagem de alta prioridade na parte superior do formulário.

Tabela 3. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem de alta prioridade a ser exibida.

Tabela 4. Retornos
Tipo	Descrição
vazio

O exemplo a seguir mostra como exibir uma mensagem de alta prioridade na parte superior do formulário.

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

GlideSystem - addInfoMessage(mensagem do objeto)

Adiciona uma mensagem informativa para a sessão atual.

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

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

Tabela 6. 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. AddInfoMessage() em uma aplicação com escopo, use o método com escopo correspondente: AddInfoMessage() .

GlideSystem - addLowMessage (mensagem de cadeia de caracteres)

Exibe uma mensagem de baixa prioridade na parte superior do formulário.

Tabela 7. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem de baixa prioridade a ser exibida.

Tabela 8. Retornos
Tipo	Descrição
vazio

O exemplo a seguir mostra como exibir uma mensagem de baixa prioridade na parte superior do formulário.

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

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

Adiciona uma mensagem para a sessão atual.

Tabela 9. 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 10. Retornos
Tipo	Descrição
vazio

GlideSystem - addModerateMessage(mensagem de cadeia de caracteres)

Exibe uma mensagem de prioridade moderada na parte superior do formulário.

Tabela 11. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem moderada a ser exibida.

Tabela 12. Retornos
Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como exibir uma mensagem de prioridade moderada na parte superior do formulário.

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

GlideSystem - addSuccessMessage(mensagem de cadeia de caracteres)

Exibe uma mensagem confirmando uma ação bem-sucedida na parte superior do formulário.

Tabela 13. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem de sucesso a ser exibida.

Tabela 14. Retornos
Tipo	Descrição
vazio

O exemplo a seguir mostra como exibir uma mensagem confirmando uma mensagem de sucesso na parte superior do formulário.

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

GlideSystem - beginningOfLastMonth()

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

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

Tabela 16. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT do início 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. IniciaçãoLastMonth() em uma aplicação com escopo, use o método com escopo correspondente: IniciaçãoLastMonth() .

GlideSystem - beginingOfLastWeek()

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

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

Tabela 18. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT 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 semana passada.

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

Equivalente com escopo

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

GlideSystem - beginningOfNextWeek()

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

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

Tabela 20. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT 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 como o início da próxima semana.

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

Equivalente com escopo

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

GlideSystem - beginningOfNextMonth()

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

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

Tabela 22. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT 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 como o início do próximo mês.

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

Equivalente com escopo

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

GlideSystem - beginningOfNextYear()

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

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

Tabela 24. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT do início 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 como o início do próximo ano.

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

Equivalente com escopo

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

GlideSystem - beginningOfThisMonth()

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

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

Tabela 26. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT Início do mês 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 deste mês.

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

Equivalente com escopo

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

GlideSystem - beginningOfThisQuarter()

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

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

Tabela 28. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT Início 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. IniciaçãoDeThisQuarter() em uma aplicação com escopo, use o método com escopo correspondente: IniciaçãoDeThisQuarter() .

GlideSystem - beginningOfThisWeek()

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

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

Tabela 30. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT Início da semana 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 da semana atual.

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

Equivalente com escopo

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

GlideSystem - beginningOfThisYear()

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

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

Tabela 32. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT Início 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. IniciaçãoDeThisYear() em uma aplicação com escopo, use o método com escopo correspondente: IniciaçãoDeThisYear() .

GlideSystem - beginningOfToday()

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

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

Tabela 34. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT Início do dia 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 dia atual.

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

GlideSystem - beginningOfTomorrow()

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

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

Tabela 36. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT Início de amanhã. Formato: aaaa-MM-dd hh:mm:ss

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

GlideSystem - beginningOfYesterday()

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

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

Tabela 38. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT do início de ontem, no formato aaaa-mm-dd hh:mm:ss.

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

CalDateDiff (cadeia de caracteres startDate, cadeia de caracteres endDate, booliano numericValue)

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 uma determinada programação" do tópico Casos de uso de script de programação.

Tabela 39. 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.
NumericValue	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á formatado em ddd hh:mm:ss.

Tabela 40. Retornos
Tipo	Descrição
Cadeia de caracteres	. numericValueo parâmetro é verdadeiro, retorna 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, valor numérico booliano)

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. Usar ObtDisplayValue() para converter as cadeias de caracteres no formato esperado.

Este método espera parâmetros no formato de data e hora do usuário/sistema, que podem não ser iguais ao formato interno. Usar 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 GlideDateTime subtrair() em vez de DateDiff() .

Tabela 41. 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.
NumericValue	Booliano	Se verdadeiro, o valor de retorno será formatado em número de segundos; se for falso, o valor de retorno será formatado ddd hh:mm:ss.

Tabela 42. 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, retornará 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 (data da cadeia de caracteres, intervalo de cadeia de caracteres)

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

Tabela 43. Parâmetros
Nome	Tipo	Descrição
data	Cadeia de caracteres	Data a ser gerada em GMT. Formato: aaaa-MM-dd
intervalo	Cadeia de caracteres	Início, Término ou uma hora. Formato: 24 horas hh:mm:ss

Tabela 44. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora geradas. Se o intervalo for `iniciar` , o valor retornado é aaaa-mm-dd 00:00:00. Se o intervalo for `fim` o valor de retorno é aaaa-mm-dd 23:59:59. Formato: aaaa-MM-dd hh:mm:ss

Este exemplo mostra usando 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. 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 45. Parâmetros
Nome	Tipo	Descrição
dias	Número	Número de dias

Tabela 46. 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. DayAgo() em uma aplicação com escopo, use o método com escopo correspondente: DayAgo() .

GlideSystem - daysagoEnd (número de dias)

Retorna uma data e hora para o final do dia um número especificado de dias atrás.

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

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

Este exemplo mostra usando DiaAgend() 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. DiaAgend() em uma aplicação com escopo, use o método com escopo correspondente: DiaAgend() .

GlideSystem - daysAgLocal (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 49. Parâmetros
Nome	Tipo	Descrição
dias	Número	Número de dias atrás

Tabela 50. 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 de um número especificado de dias atrás.

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

Tabela 52. Retornos
Tipo	Descrição
Cadeia de caracteres	Início GMT do dia 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. DiaAgStart() em uma aplicação com escopo, use o método com escopo correspondente: DiaAgStart() .

GlideSystem - endOfLastMonth()

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

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

Tabela 54. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT do final do mês passado. 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. EndOfLastMonth() em uma aplicação com escopo, use o método com escopo correspondente: EndOfLastMonth() .

GlideSystem - endOfLastWeek()

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

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

Tabela 56. Retorna
Tipo	Descrição
Cadeia de caracteres	GMT no final 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. EndOfLastWeek() em uma aplicação com escopo, use o método com escopo correspondente: EndOfLastWeek() .

GlideSystem - endOfLastYear()

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

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

Tabela 58. Retorna
Tipo	Descrição
Cadeia de caracteres	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. EndOfLastYear() em uma aplicação com escopo, use o método com escopo correspondente: EndOfLastYear() .

GlideSystem - endOfNextMonth()

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

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

Tabela 60. 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. NextMês() em uma aplicação com escopo, use o método com escopo correspondente: NextMês() .

GlideSystem - endOfNextWeek()

Retorna a data e a hora do final da próxima 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 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. EndOfNextWeek() em uma aplicação com escopo, use o método com escopo correspondente: EndOfNextWeek() .

GlideSystem - endOfNextYear()

Retorna a data e a hora do final do próximo 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 do próximo ano. Formato: aaaa-MM-dd hh:mm:ss

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

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

Equivalente com escopo

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

GlideSystem - endOfThisMonth()

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

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

Tabela 66. 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 EndOfThisMês() Para definir o objeto GlideDateTime como o final do mês atual.

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

Equivalente com escopo

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

GlideSystem - endOfThisQuarter()

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

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

Tabela 68. 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 EndOfThisQuarter() Para definir o objeto GlideDateTime como o final do mês atual.

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

Equivalente com escopo

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

GlideSystem - endOfThisWeek()

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

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

Tabela 70. 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 EndOfThisWeek() Para definir o objeto GlideDateTime como o final do mês atual.

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

Equivalente com escopo

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

GlideSystem - endOfThisYear()

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

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

Tabela 72. 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 EndOfThisYear() Para definir o objeto GlideDateTime como o final do mês atual.

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

Equivalente com escopo

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

GlideSystem - endOfToday()

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

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

Tabela 74. 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 final de amanhã em GMT.

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

Tabela 76. 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 - endOfYesterday()

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

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

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

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

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

Coloca um evento em fila para o gerenciador de eventos.

Tabela 79. 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 80. 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. EventQueue() em uma aplicação com escopo, use o método com escopo correspondente: EventQueue() .

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

Enfila um evento para o gerente de eventos em uma data e hora especificadas.

Tabela 81. 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 82. 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. QueueScheduled() em uma aplicação com escopo, use o método com escopo correspondente: QueueScheduled() .

GlideSystem - flushMessages()

Limpa as 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 de sessão.

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

Tabela 84. Retorna
Tipo	Descrição
vazio

Este exemplo mostra como analisar e repassar mensagens de erro e 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 85. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 86. 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 87. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 88. 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. 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 89. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 90. 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 91. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 92. 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 associada 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 93. Parâmetros
Nome	Tipo	Descrição
tableName	Cadeia de caracteres	Nome da tabela da qual o nome da coluna de exibição será obtido.

Tabela 94. Retornos
Tipo	Descrição
Cadeia de caracteres	Nome da coluna de exibição

// 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 95. 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 96. Retornos
Tipo	Descrição
Cadeia de caracteres	Valor de exibição do campo.

Este exemplo mostra como usar ObteDisplayValueFor() para retornar o valor de exibição do número campo.

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

GlideSystem - getErrorMessages()

Retorna a lista de mensagens de erro da sessão que foi adicionada por AddErrorMessage() .

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

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

Este exemplo mostra como analisar e repassar 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. GetErrorMessages() em uma aplicação com escopo, use o método com escopo correspondente: GetErrorMessages() .

GlideSystem - getEscapedProperty(chave de cadeia de caracteres, Object replaceObject)

Recupera a propriedade e a escapa para análise de XML.

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

Tabela 100. Retornos
Tipo	Descrição
Cadeia de caracteres	Ou substituteObject 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 de representação.

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

Tabela 102. Retorna
Tipo	Descrição
Cadeia de caracteres	Nome de exibição do usuário de representação.

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 103. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 104. Retorna
Tipo	Descrição
Cadeia de caracteres	Nome do usuário de representação

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 105. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 106. 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 107. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 108. Retorna
Tipo	Descrição
Cadeia de caracteres	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 de mensagem não existir na tabela, ele retornará o ID da mensagem.

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

Nota:

Se a mensagem de IU tiver uma marca de seleção ('), pode haver problemas com a mensagem no script; para escapar das marcas de seleção ('), use GetMessageS(cadeia de caracteres, objeto) .

Tabela 109. Parâmetros
Nome	Tipo	Descrição
MessageID	Cadeia de caracteres	Identificador da mensagem. Você pode localizar este valor no campo Chave da tabela Mensagem [sys_ui_message]. Observação 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("Cancelar adição da ação '0', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo `"(0)"` substituído pelo conteúdo de `current.action.name` . Nota: Os valores passados em não são traduzidos. Eles são inseridos textualmente na mensagem.

Tabela 110. 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. GetMessage() em uma aplicação com escopo, use o método com escopo correspondente: GetMessage() .

GlideSystem - getMessageS (cadeia de caracteres MessageID, objetos args)

Recupera mensagens traduzidas para exibir na IU e escapa de todas as marcações (').

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 de mensagem não existir na tabela, ele retornará o ID da mensagem.

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

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

Tabela 111. Parâmetros
Nome	Tipo	Descrição
MessageID	Cadeia de caracteres	Identificador da mensagem. Você pode localizar este valor no campo Chave da tabela Mensagem [sys_ui_message]. Observação 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("Cancelar adição da ação '0', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo `"(0)"` substituído pelo conteúdo de `current.action.name` . Nota: Os valores passados em não são traduzidos. Eles são inseridos textualmente na mensagem.

Tabela 112. Retornos
Tipo	Descrição
Cadeia de caracteres	Mensagem especificada com marcas 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(mensagem de cadeia de caracteres, idioma de cadeia de caracteres, argumentos de matriz)

Traduz a mensagem especificada para o idioma especificado.

Você também pode incorporar variáveis na mensagem aprovada. O método resolve essas variáveis com os valores passados no argsmatriz.

Tabela 113. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem a ser traduzida.
idioma	Cadeia de caracteres	Idioma para traduzir a mensagem. 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("Anular adição da ação '0', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);` Neste exemplo `"(0)"` substituído pelo conteúdo de `current.action.name` . Nota: Os valores passados em não são traduzidos. Eles são inseridos textualmente na mensagem.

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

Retorna o nome do nó do índice especificado.

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

Tabela 116. 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 obj, índice de número)

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

Tabela 117. Parâmetros
Nome	Tipo	Descrição
obj	Objeto	Objeto a ser examinado.
índice	Número	Índice do qual o nó valu.e será obtido

Tabela 118. 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 119. 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 120. Retornos
Tipo	Descrição
Cadeia de caracteres	Valor de preferência. Se não houver preferência, retornará 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 (chave de cadeia de caracteres, objeto alt)

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

Tabela 121. 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 122. Retornos
Tipo	Descrição
Cadeia de caracteres	Valor da propriedade Glide ou o 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 (script de cadeia de caracteres)

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

Nota:

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

Tabela 123. Parâmetros
Nome	Tipo	Descrição
script	Cadeia de caracteres	Script para verificar se há erros.

Tabela 124. 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 125. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 126. 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. 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 127. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 128. 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. 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 129. 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 130. 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 131. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 132. 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 do usuário atual.

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

Tabela 134. 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 do 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. 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 135. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 136. 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. 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 137. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 138. 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. 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 139. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 140. 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. 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 do usuário fornecido.

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

Tabela 142. 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 143. Parâmetros
Nome	Tipo	Descrição
xml	Cadeia de caracteres	Documento XML a ser analisado.

Tabela 144. 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 matriz.

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 145. 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 146. Retornos
Tipo	Descrição
Cadeia de caracteres	Nó XML correspondente 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(String roleName)

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

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

Tabela 148. 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 retorna verdadeiro se o usuário tiver a função de administrador. Falso: O usuário não tem nenhuma das funções aprovadas.

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. HasRole() em uma aplicação com escopo, use o método com escopo correspondente: HasRole() .

GlideSystem - hasRoleInGroup(Object roleName, Object group)

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

Tabela 149. 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 150. 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 é 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 151. Parâmetros
Nome	Tipo	Descrição
horas	Número	Número de horas atrás.

Tabela 152. 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. HorasAgo() em uma aplicação com escopo, use o método com escopo correspondente: HorasAgo() .

GlideSystem - hoursagoEnd (número de horas)

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

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

Tabela 154. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora UTC para o final 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. HorasAgend() em uma aplicação com escopo, use o método com escopo correspondente: HorasAgend() .

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 155. Parâmetros
Nome	Tipo	Descrição
horas	Número	Número de horas atrás.

Tabela 156. Retornos
Tipo	Descrição
Cadeia de caracteres	Data e hora UTC para o final 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. HorasAgStart() em uma aplicação com escopo, use o método com escopo correspondente: HorasAgStart() .

GlideSystem - isFirstDayOfMonth(Data do objeto)

Verifica se a data no objeto de data especificado é o primeiro 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 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 sendo o primeiro 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 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 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 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 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 163. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 164. 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. IsInterativo() em uma aplicação com escopo, use o método com escopo correspondente: IsInterativo() .

GlideSystem - isLastDayofMonth(data do objeto)

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

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

Tabela 166. 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 167. Parâmetros
Nome	Tipo	Descrição
data	Objeto	Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate.

Tabela 168. 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 169. Parâmetros
Nome	Tipo	Descrição
data	Objeto	Objeto de data no qual a data será verificada, como GlideDateTime ou GlideDate.

Tabela 170. 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 171. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 172. 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. 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ócios.

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

Tabela 174. 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. IsMobile() em uma aplicação com escopo, use o método com escopo correspondente: IsMobile() .

GlideSystem - lastWeek()

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

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

Tabela 176. Retorna
Tipo	Descrição
Cadeia de caracteres	Data e hora há uma semana. 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 177. Parâmetros
Nome	Tipo	Descrição
message	Cadeia de caracteres	Mensagem a ser registrada.
origem	Cadeia de caracteres	Opcional. Origem da mensagem.

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

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

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

Tabela 180. Retornos
Tipo	Descrição
vazio

O exemplo a seguir registra 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 (mensagem de cadeia de caracteres, origem de cadeia de caracteres)

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

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

Tabela 182. Retornos
Tipo	Descrição
vazio

O exemplo a seguir registra 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 - minutesAgo(número de minutos)

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

Tabela 183. Parâmetros
Nome	Tipo	Descrição
minutos	Número	Número de minutos no passado para retornar.

Tabela 184. 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étodo minutesAgo() 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 - minutesagoEnd(número de minutos)

Retorna uma data e hora para o final do minuto de um determinado número de minutos atrás.

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

Tabela 186. 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 a hora atuais e a data e a 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. MinutosAgend() em uma aplicação com escopo, use o método com escopo correspondente: MinutosAgend() .

GlideSystem - minutesagoStart (número de minutos)

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

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

Tabela 188. 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 a hora atuais e a data e a 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. MinutosAgStart() em uma aplicação com escopo, use o método com escopo correspondente: MinutosAgStart() .

GlideSystem - monthsAgo (número de meses)

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

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

Tabela 190. Retornos
Tipo	Descrição
Cadeia de caracteres	GMT do número especificado de meses atrás exatamente no mesmo horário. Formato: aaaa-MM-dd hh:mm:ss

O exemplo a seguir exibe a data e a hora atuais e a data e a hora 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êsAgo() em uma aplicação com escopo, use o método com escopo correspondente: MêsAgo() .

GlideSystem - monthsagoEnd (número de meses)

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

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

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

O exemplo a seguir exibe a data e a hora atuais e a data e a hora 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 - monthsAgStart (número de meses)

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

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

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

O exemplo a seguir exibe a data e a hora atuais e a data e a hora há três meses 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. MensagoStart() em uma aplicação com escopo, use o método com escopo correspondente: MensagoStart() .

GlideSystem - nil(obj de objeto)

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

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

Tabela 196. Retornos
Tipo	Descrição
Booliano	Verdadeiro se 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. nil() em uma aplicação com escopo, use o método com escopo correspondente: nil() .

GlideSystem - NOW()

Retorna a data atual em UTC.

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

Tabela 198. 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 a hora atuais no formato UTC.

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

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

// 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 201. Parâmetros
Nome	Tipo	Descrição
Nenhum

Tabela 202. 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 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 com a data e hora atuais, use DisplayValue() método. O script a seguir define a variável de fluxo de trabalho end_date para a data e hora atuais.

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

GlideSystem - nowGlideDateTime()

Obtém um objeto GlideDateTime com a data e a 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/hora, como executar cálculos de data/hora, formatar uma data/hora ou converter formatos de data/hora.

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

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

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

current.u_target_date = gs.nowGlideDateTime();

GlideSystem - print (mensagem de cadeia de caracteres)

Grava uma mensagem no log do sistema.

Este método não grava a mensagem na tabela syslog, a menos que DEBUG tenha sido ativado.

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

Tabela 206. 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 - quartersAgo (número de trimestres)

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

Tabela 207. Parâmetros
Nome	Tipo	Descrição
trimestres	Número	Número inteiro dos trimestres atrás.

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

O exemplo a seguir exibe a data e a hora atuais e a data e a hora há quatro trimestres 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

QuartersagoEnd (número de trimestres)

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

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

Tabela 210. Retornos
Tipo	Descrição
Cadeia de caracteres	GMT Fim 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. DoEnd() em uma aplicação com escopo, use o método com escopo correspondente: DoEnd() .

QuartersAgStart (número de trimestres)

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

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

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

Equivalente com escopo

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

GlideSystem - setProperty (chave da cadeia de caracteres, valor da cadeia de caracteres, descrição da cadeia de caracteres)

Define a chave especificada com o valor especificado.

Nota:

Cuidado deve ser tomado 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 do sistema enquanto os caches são recriados. 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 213. 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 definida.
descrição	Cadeia de caracteres	Uma descrição da propriedade.

Tabela 214. 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. SetProperty() em uma aplicação com escopo, use o método com escopo correspondente: SetProperty() .

GlideSystem - setRedirect (URI do objeto)

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

Tabela 215. Parâmetros
Nome	Tipo	Descrição
URI	Objeto	URI a ser definido como redirecionamento

Tabela 216. 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. SetRedirect() em uma aplicação com escopo, use o método com escopo correspondente: SetRedirect() .

GlideSystem - setReturn(URI do objeto)

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

Tabela 217. Parâmetros
Nome	Tipo	Descrição
URI	Objeto	URI a ser definido como o local de retorno.

Tabela 218. Retornos
Tipo	Descrição
vazio

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

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

GlideSystem - tableExists(cadeia de caracteres tablename)

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

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

Tabela 220. Retornos
Tipo	Descrição
Booliano	Sinalizador que indica se a tabela especificada existe no ServiceNow instância. Valores possíveis: Verdadeiro: A tabela existe Falso: A tabela não existe

Este exemplo mostra como verificar se as tabelas de incidente e FOO existem no ServiceNow instância.

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. 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. Usar GetUserID() em vez disso.

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

Tabela 222. 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 (Object glideRecord)

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

Tabela 223. Parâmetros
Nome	Tipo	Descrição
GlideRecord	Objeto	GlideRecord

Tabela 224. Retornos
Tipo	Descrição
vazio

GlideSystem - Years sAgo (número de anos)

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

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

Tabela 226. Retornos
Tipo	Descrição
Cadeia de caracteres	GMT Início 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. AnosAgo (número de anos) em uma aplicação com escopo, use o método com escopo correspondente: AnosAgo (número de anos) .

GlideSystem - Ontem()

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

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

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

Equivalente com escopo

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