GlideSystem - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 32 min. de leitura

    • O escopo GlideSystem A API fornece vários métodos convenientes para obter informações sobre o sistema, o usuário conectado no momento e outras informações no nível do sistema.

    Muitos dos GlideSystem os métodos facilitam a inclusão fácil de datas em intervalos de consulta e são usados com mais frequência em filtros e relatórios.

    GlideSystem com escopo - addErrorMessage (mensagem de cadeia de caracteres)

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

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres 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
       }
  }

    GlideSystem com escopo - 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 com escopo - addInfoMessage(mensagem de cadeia de caracteres)

    Adiciona uma mensagem informativa para a sessão atual. Este método não é compatível com regras de negócios assíncronas.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem informativa 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);
  }
}

    GlideSystem com escopo - 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 com escopo - addModerateMessage(mensagem de cadeia de caracteres)

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

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem moderada a ser exibida.
    Tabela 10. 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 com escopo - addSuccessMessage (mensagem de cadeia de caracteres)

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

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem de sucesso a ser exibida.
    Tabela 12. 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 com escopo - base64Encode (origem de cadeia de caracteres)

    Cria uma cadeia de caracteres base64 a partir da cadeia de caracteres especificada.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    origem Cadeia de caracteres Cadeia de caracteres a ser codificada.
    Tabela 14. Retornos
    Tipo Descrição
    Cadeia de caracteres Cadeia de caracteres base64 codificada.

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

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

    GlideSystem com escopo - base64Decode (origem de cadeia de caracteres)

    Retorna uma cadeia de caracteres ASCII da cadeia de caracteres base64 especificada.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    origem Cadeia de caracteres Uma cadeia de caracteres codificada em base64.
    Tabela 16. Retornos
    Tipo Descrição
    Cadeia de caracteres A cadeia de caracteres decodificada.

    GlideSystem com escopo - beginningOfLastMonth()

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

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT início do último mês, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - beginningOfLastWeek()

    Retorna a data e a hora do início da última 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 semana passada, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - 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, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - beginningOfNextWeek()

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

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 24. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT do início da próxima semana, no formato aaaa-mm-dd hh:mm:ss.

    GlideSystem com escopo - beginningOfNextYear()

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

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 26. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT início do próximo ano, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - beginningOfThisMonth()

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

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 28. Retorna
    Tipo Descrição
    Cadeia de caracteres Início deste mês, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - beginningOfThisQuarter()

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

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 30. Retorna
    Tipo Descrição
    Cadeia de caracteres Início deste trimestre, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - beginningOfThisWeek()

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

    Tabela 31. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 32. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT início desta semana, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - beginningOfThisYear()

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

    Tabela 33. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 34. Retorna
    Tipo Descrição
    Cadeia de caracteres Início deste ano, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - dateGenerate (data da cadeia de caracteres, intervalo de cadeia de caracteres)

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

    Tabela 35. Parâmetros
    Nome Tipo Descrição
    data Cadeia de caracteres Data para gerar o GMT.

    Formato: aaaa-MM-dd
    intervalo Cadeia de caracteres Início, término ou hora no formato de 24 horas hh:mm:ss.
    Tabela 36. 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

    GlideSystem com escopo - daysAgo (número de dias)

    Retorna a data e a hora de um número especificado de dias atrás.

    Tabela 37. Parâmetros
    Nome Tipo Descrição
    dias Número Número inteiro de dias
    Tabela 38. Retornos
    Tipo Descrição
    Cadeia de caracteres GMT no 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();
}

    GlideSystem com escopo - daysagoEnd (número de dias)

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

    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 GMT Término do dia no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - daysagoStart (número de dias)

    Retorna a data e a hora do início do dia de um número especificado de dias atrás.

    Tabela 41. Parâmetros
    Nome Tipo Descrição
    dias Cadeia de caracteres Número inteiro de dias
    Tabela 42. 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();

    GlideSystem com escopo - DEBUG(String message, Object parm1, Object parm2, Object parm3, Object parm4, objeto parm5)

    Grava uma mensagem de depuração no log do sistema.

    Tabela 43. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem de log com espaços reservados para quaisquer argumentos de variável.
    param1 Objeto (Opcional) Argumento da primeira variável.
    param2 Objeto (Opcional) Segundo argumento de variável.
    param3 Objeto (Opcional) Terceiro argumento de variável.
    param4 Objeto (Opcional) Quarto argumento de variável.
    param5 Objeto (Opcional) Argumento da quinta variável.
    Tabela 44. Retornos
    Tipo Descrição
    vazio 
    gs.debug("This is a debug message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.debug("This is a debug message from {0}.{1}", myFirstName, myLastName);
    Saída:
    This is a debug message (sys.scripts extended logging)
This is a debug message from Abel.Tuter (sys.scripts extended logging)

    GlideSystem com escopo - endOfLastMonth()

    Retorna a data e a hora do final 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 final do último mês, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfLastWeek()

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

    Tabela 47. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 48. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT final da semana passada, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfLastYear()

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

    Tabela 49. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 50. Retorna
    Tipo Descrição
    Cadeia de caracteres Formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfNextMonth()

    Retorna a data e a hora do final 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 GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfNextWeek()

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

    Tabela 53. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 54. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfNextYear()

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

    Tabela 55. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 56. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfThisMonth()

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

    Tabela 57. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 58. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfThisQuarter()

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

    Tabela 59. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 60. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfThisWeek()

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

    Tabela 61. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 62. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfThisYear()

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

    Tabela 63. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 64. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - ERROR(Mensagem de cadeia de caracteres, objeto parm1, objeto parm2, objeto parm3, objeto parm4, objeto parm5)

    Grava uma mensagem de erro no log do sistema.

    Este método aceita até cinco argumentos de variável (varargs) na mensagem usando o padrão de substituição de espaço reservado Java MessageFormat.

    Nota:
    As variáveis devem conter valores válidos para este método para fornecer a saída correta.
    Tabela 65. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem de log com espaços reservados para quaisquer argumentos de variável.
    param1 Objeto (Opcional) Argumento da primeira variável.
    param2 Objeto (Opcional) Segundo argumento de variável.
    param3 Objeto (Opcional) Terceiro argumento de variável.
    param4 Objeto (Opcional) Quarto argumento de variável.
    param5 Objeto (Opcional) Argumento da quinta variável.
    Tabela 66. Retornos
    Tipo Descrição
    vazio 
    gs.error("This is an error message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.error("This is an error message from {0}.{1}", myFirstName, myLastName);
    Saída:
    This is an error message
This is an error message from Abel.Tuter

    GlideSystem com escopo - eventQueue (nome da cadeia de caracteres, instância do objeto, cadeia de caracteres parm1, cadeia de caracteres parm2, fila de cadeia de caracteres)

    Coloca um evento em fila para o gerenciador de eventos.

    Tabela 67. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome do evento que está sendo enfileirado.
    instância 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 Opcional. Nome da fila.
    Tabela 68. Retornos
    Tipo Descrição
    vazio 
    if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueue('incident.commented', current, gs.getUserID(), gs.getUserName());
}

    GlideSystem com escopo - eventQueueScheduled (nome da cadeia de caracteres, instância do objeto, cadeia de caracteres parm1, cadeia de caracteres parm2, expiração do objeto)

    Enfileira um evento no gerenciador de eventos.

    As informações aprovadas na programação de eventos são armazenadas na tabela Eventos [Sysvent]. Para obter informações adicionais sobre eventos, consulte Eventos .

    Tabela 69. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome do evento a ser enfileirado.
    instância Objeto/Cadeia de caracteres Objeto GlideRecord ou o sys_id do registro ao qual este evento se aplica.
    parm1 Cadeia de caracteres Opcional. Cadeia de caracteres a ser passada para o script do evento. Este parâmetro é de forma livre e depende da implementação do script de evento.

    Padrão: Se instanceO parâmetro é um objeto GlideRecord, então o padrão é o valor de exibição desse GlideRecord (now_GR.getDisplayValue), caso contrário, é nulo .
    parm2 Cadeia de caracteres Opcional. Cadeia de caracteres a ser passada para o script do evento. Este parâmetro é de forma livre e depende da implementação do script de evento.

    Padrão: nulo

    expiração Objeto Opcional. Objeto GlideDateTime ou um elemento do tipo data/hora que especifica a data e a hora para processar o evento.

    Padrão: Data/hora atual
    Tabela 70. Retornos
    Tipo Descrição
    vazio

    Este exemplo mostra como chamar o método usando um GlideRecord, dois parâmetros que são passados para o script de evento e um horário especificado para programar o evento.

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

    Este exemplo mostra como chamar o método usando um sys_id e os valores padrão para os parâmetros opcionais.

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

    GlideSystem com escopo - executeNow (trabalho GlideRecord)

    Executa um trabalho para uma aplicação com escopo.

    Você só pode usar este método em um trabalho na mesma aplicação que o script que chama este método.

    Tabela 71. Parâmetros
    Nome Tipo Descrição
    trabalho GlideRecord Trabalho a ser executado.
    Tabela 72. Retornos
    Tipo Descrição
    Cadeia de caracteres Retorna o sys_id do trabalho agendado. Retorna nulo se o trabalho for global. 
    scheduleImportJob: function () {
  var jobId = '61847fe04c603300fa9bb64c2b491dac';
  var now_GR = new GlideRecord('sysauto_script');
  if (!now_GR.get(jobId)) {
    throw new Error('Unable to find import job');
  }
  gs.executeNow(now_GR);
}

    GlideSystem com escopo - generateGUID()

    Gera um GUID que pode ser usado quando um identificador exclusivo é necessário.

    Tabela 73. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 74. Retorna
    Tipo Descrição
    Cadeia de caracteres GUID hexadecimal de 32 caracteres.

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

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

    Saída:

    af770511ff013100e04bfffffffffff6

    GlideSystem com escopo - getCallerScopeName()

    Obtém o nome do escopo do chamador; retorna nulo se não houver nenhum chamador.

    Tabela 75. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 76. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome do escopo do solicitante ou nulo se não houver solicitante.

    Este exemplo mostra duas inclusões de script definidas como acessíveis em todos os escopos da aplicação. Uma inclusão de script é criada em app_scope_a.

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

    Saída:

    Este exemplo mostra outra inclusão de script criada em app_scope_b.

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

    Saída:

    Este script pode ser usado no escopo app_scope_a para obter o nome do escopo do solicitante, neste caso app_scope_b.

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

    GlideSystem com escopo - getCssCacheVersionString()

    Obtém uma cadeia de caracteres que representa a versão do cache de um arquivo CSS.

    Tabela 77. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 78. Retorna
    Tipo Descrição
    Cadeia de caracteres A versão do cache CSS.

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

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

    Saída:

    _d82979516f0171005be8883e6b3ee4cf&theme=

    GlideSystem com escopo - getCurrentApplicationId()

    Obtém o ID da aplicação atual conforme definido usando o Seletor de aplicações.

    Tabela 79. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 80. Retorna
    Tipo Descrição
    Cadeia de caracteres O sys_id da aplicação atual, ou global em nenhum, está definido. 
    var currentId = gs.getCurrentApplicationId();
gs.info(currentId);

    Saída

    04936cb16f30b1005be8883e6b3ee4e0

    GlideSystem com escopo - getCurrentScopeName()

    Obtém o nome do escopo atual.

    Tabela 81. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 82. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome do escopo atual.

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

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

    Saída:

    s_snc_test_scope

    GlideSystem com escopo - getDateFormat(cadeia de caracteres)

    Retorna o formato de data 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 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 com escopo - getDateTimeFormat()

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

    Tabela 85. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 86. 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 com escopo - getErrorMessages()

    Retorna as mensagens de erro que foram adicionadas por AddErrorMessage() para a sessão.

    Tabela 87. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 88. Retorna
    Tipo Descrição
    Matriz de cadeia de caracteres Mensagens de erro associadas à sessão.

    GlideSystem com escopo - getEscapedMessage (ID de cadeia de caracteres, argumentos de matriz)

    Recupera a mensagem especificada da tabela Mensagem [sys_ui_message]. Se a mensagem tiver caracteres especiais HTML, substitui-os pelos códigos de nome HTML correspondentes. Por exemplo, & se torna & .

    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 com todos os caracteres especiais retornados como sequências de escape. 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 com todos os caracteres especiais retornados como sequências de escape. 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 89. Parâmetros
    Nome Tipo Descrição
    id 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 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.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 90. Retornos
    Tipo Descrição
    Cadeia de caracteres Mensagem de IU com caracteres especiais HTML substituídos por códigos de nome HTML.

    Este exemplo mostra o caractere E comercial sendo substituído pelo código de nome HTML E comercial equivalente.

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

    Saída

    Is the summary & details accurate?

    Este exemplo mostra como substituir uma única variável em uma mensagem e como os símbolos " e "" na mensagem são transpostos para os códigos de nome HTML correspondentes de &lt e &gt.

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

    Saída

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

    GlideSystem com escopo - getMessage (ID de cadeia de caracteres, argumentos de matriz)

    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 91. Parâmetros
    Nome Tipo Descrição
    id 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 à mensagem real.
    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.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 92. Retornos
    Tipo Descrição
    Cadeia de caracteres Mensagem de IU.

    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.getEscapedMessage("Abort adding action '{0}', same subflow can't be added twice in {1} subflow.", [current.action.name, current.sub_flow.name]);
alert(my_message);

    Saída:

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

    GlideSystem com escopo - getProperty (chave de cadeia de caracteres, objeto alt)

    Obtém o valor de uma propriedade Glide. Se a propriedade não for encontrada, retornará um valor alternativo.

    Tabela 93. Parâmetros
    Nome Tipo Descrição
    chave Cadeia de caracteres A chave da propriedade cujo valor deve ser retornado.
    alt Objeto (Opcional) Objeto alternativo a ser retornado se a propriedade não for encontrada.
    Tabela 94. Retornos
    Tipo Descrição
    Cadeia de caracteres O valor da propriedade Glide ou o objeto alternativo definido acima.

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

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

    Saída:

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

    GlideSystem com escopo - getSession()

    Obtém uma referência à sessão atual do Glide.

    Tabela 95. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 96. Retorna
    Tipo Descrição
    Cadeia de caracteres Uma referência para a sessão atual. 
    if (!gs.hasRole("admin") && !gs.hasRole("user_admin") && gs.getSession().isInteractive()) {
  current.addQuery("active", "true");
}

    GlideSystem com escopo - getSessionID()

    Recupera o ID da sessão GlideSession.

    Tabela 97. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 98. Retorna
    Tipo Descrição
    Cadeia de caracteres O ID da sessão. 
    var myUserObject = gs.getSessionID();
gs.info(myUserObject);
    Saída:
    A0D4E5416F3F21005BE8883E6B3EE4B8

    GlideSystem com escopo - getSessionToken()

    Este método não está mais disponível. Em vez disso, use gs.getSession().getSessionToken() .

    Tabela 99. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 100. Retorna
    Tipo Descrição
    Cadeia de caracteres O token da sessão.

    GlideSystem com escopo - getTimeFormat()

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

    Tabela 101. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 102. Retorna
    Tipo Descrição
    Cadeia de caracteres O 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 com escopo - getTimeZoneName()

    Retorna o nome do fuso horário associado ao usuário atual.

    Este método foi descontinuado. Em vez disso, use GetTimeZoneName() método no GlideSession API.

    Tabela 103. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 104. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome do fuso horário.

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

    gs.info(gs.getTimeZoneName());

    GlideSystem com escopo - getUrlOnStack()

    Obtém o URI atual da sessão.

    Tabela 105. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 106. Retorna
    Tipo Descrição
    Cadeia de caracteres O URI. 
    gs.info(gs.getUrlOnStack());

    GlideSystem com escopo - getUser()

    Retorna uma referência ao objeto GlideUser com escopo para o usuário atual.

    Consulte GlideUser - Com escopo para obter uma lista de métodos disponíveis.

    Tabela 107. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 108. Retorna
    Tipo Descrição
    GlideUser Referência a um objeto de usuário com escopo. 
    var myUserObject = gs.getUser();
gs.info(myUserObject);

    Saída

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

    GlideSystem com escopo - getUserDisplayName()

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

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

    GlideSystem com escopo - getUserID()

    Obtém o sys_id do usuário atual.

    Tabela 111. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 112. Retorna
    Tipo Descrição
    Cadeia de caracteres O 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.getUserID();
incidentGR.addQuery('assigned_to', currentUserSysId);
incidentGR.query();

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

    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 com escopo - getUserName()

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

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

    gs.info("The current user name is: " + gs.getUserName());
    Saída:
    The current user name is: admin

    GlideSystem com escopo - hasRole(função de objeto)

    Determina se o usuário atual tem a função especificada.

    Tabela 115. Parâmetros
    Nome Tipo Descrição
    função Objeto A função a ser verificada.
    Tabela 116. Retornos
    Tipo Descrição
    Booliano Verdadeiro se o usuário tiver a função. Retorna verdadeiro para usuários com a função de administrador. 
    if (!gs.hasRole("admin") && !gs.hasRole("groups_admin")  && gs.getSession().isInteractive()) {
  var qc = current.addQuery("u_hidden", "!=", "true"); //cannot see hidden groups... 
  qc.addOrCondition("sys_id", "javascript:getMyGroups()"); //...unless in the hidden group
  gs.info("User has admin and groups admin roles");
}
else {
  gs.info("User does not have both admin and groups admin roles");
}

    GlideSystem com escopo - hoursAgo (número de horas)

    Retorna a data e a hora de um número especificado de horas atrás.

    Tabela 117. Parâmetros
    Nome Tipo Descrição
    horas Número Número inteiro de horas
    Tabela 118. Retornos
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss 
    if (current.operation() == 'insert') {
 // If no due date was specified, calculate a default
 if (current.due_date == '') {
 
  if (current.urgency == '1') {
   // Set due date to 4 hours ahead of current time
   current.due_date = gs.hoursAgo(-4);
  }
 
  if (current.urgency == '2') {
   // Set due date to 2 days ahead of current time
   current.due_date = gs.daysAgo(-2);
  }
 
  if (current.urgency == '3') {
   // Set due date to 7 days ahead of current time
   current.due_date = gs.daysAgo(-7);
  }
 }
}

    GlideSystem com escopo - hoursagoEnd (número de horas)

    Retorna a data e a hora do final da hora de um número especificado de horas atrás.

    Tabela 119. Parâmetros
    Nome Tipo Descrição
    horas Número Número inteiro de horas
    Tabela 120. Retornos
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - hoursagoStart (número de horas)

    Retorna a data e a hora do início da hora de um número especificado de horas atrás.

    Tabela 121. Parâmetros
    Nome Tipo Descrição
    horas Número Número inteiro de horas
    Tabela 122. Retornos
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - Include (nome da cadeia de caracteres)

    Fornece uma maneira segura de chamar uma inclusão de script da área restrita, permitindo somente a inclusão de scripts confiáveis.

    Tabela 123. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome do script a ser incluído.
    Tabela 124. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se a inclusão de script funcionou.
    Valores possíveis:
    • Verdadeiro: Inclusão de script funcionou.
    • Falso: Falha na inclusão de script.

    Este exemplo obtém os LDAPUtils no contexto de script atual.

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

    GlideSystem com escopo - info(Mensagem de cadeia de caracteres, objeto parm1, objeto parm2, objeto parm3, objeto parm4, objeto parm5)

    Grava uma mensagem informativa no log do sistema.

    Tabela 125. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem de log com espaços reservados para quaisquer argumentos de variável.
    param1 Objeto (Opcional) Argumento da primeira variável.
    param2 Objeto (Opcional) Segundo argumento de variável.
    param3 Objeto (Opcional) Terceiro argumento de variável.
    param4 Objeto (Opcional) Quarto argumento de variável.
    param5 Objeto (Opcional) Argumento da quinta variável.
    Tabela 126. Retornos
    Tipo Descrição
    vazio 
    gs.info("This is an info message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.info("This is an info message from {0}.{1}", myFirstName, myLastName);
    Saída:
    This is an info message
This is an info message from Abel.Tuter

    GlideSystem com escopo - isDepugging()

    Determina se a depuração está ativa para um escopo específico.

    Tabela 127. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 128. Retorna
    Tipo Descrição
    Booliano Verdadeiro se a depuração de sessão estiver ativa ou o nível de log estiver definido como depuração para o escopo especificado. 
    gs.debug("This is a log message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.debug("This is a log message from {0}.{1}", myFirstName, myLastName);
gs.info(gs.isDebugging());

    GlideSystem com escopo - isInteractive()

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

    Tabela 129. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 130. Retorna
    Tipo Descrição
    Booliano Verdadeiro se a sessão for interativa. 
    if (!gs.hasRole("admin") && gs.getSession().isInteractive()) {
    var qc1 = current.addQuery('u_group',"");
    var gra = new GlideRecord('sys_user_grmember');
    gra.addQuery('user', gs.getUserID());
    gra.query();
    while (gra.next()) {
        qc1.addOrCondition('u_group', gra.group);
    }
}

    GlideSystem com escopo - isLoggedIn()

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

    Tabela 131. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 132. Retorna
    Tipo Descrição
    Booliano Verdadeiro se o usuário atual estiver conectado. 
    gs.info(gs.isLoggedIn());

    GlideSystem com escopo - isMobile()

    Você pode determinar se uma solicitação vem de um dispositivo móvel.

    Este método pode ser usado em condições de ação de IU e regras de negócios.

    Tabela 133. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 134. Retorna
    Tipo Descrição
    Booliano Verdadeiro se a solicitação vier de um dispositivo móvel; caso contrário, falso. 
    if (gs.isMobile())
  gs.info("submitted from mobile UI");
 else 
   gs.info("NOT submitted from mobile UI");

    Saída

    NOT submitted from mobile UI

    GlideSystem com escopo - minutesagoEnd (número de minutos)

    Retorna a data e a hora do final do minuto especificado há um número de minutos.

    Tabela 135. Parâmetros
    Nome Tipo Descrição
    minutos Número Número inteiro de minutos atrás, como 5 ou 126.
    Tabela 136. 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.info("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
gs.info("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

    GlideSystem com escopo - minutesagoStart (número de minutos)

    Retorna a data e a hora do início do minuto de um número especificado de minutos atrás.

    Tabela 137. Parâmetros
    Nome Tipo Descrição
    minutos Número Número inteiro de minutos atrás, como 15 ou 112.
    Tabela 138. 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

    GlideSystem com escopo - monthsAgo (número de meses)

    Retorna a data e a hora de um número especificado de meses atrás.

    Tabela 139. Parâmetros
    Nome Tipo Descrição
    meses Número Número inteiro de meses atrás.
    Tabela 140. 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

    GlideSystem com escopo - monthsAgend (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 141. Parâmetros
    Nome Tipo Descrição
    meses Número (inteiro) Número de meses, como 4 ou 16.
    Tabela 142. 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 com escopo - monthsAgStart (número de meses)

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

    Tabela 143. Parâmetros
    Nome Tipo Descrição
    meses Número Número inteiro de meses atrás, como 3 ou 14.
    Tabela 144. 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

    GlideSystem com escopo - nil(Object o)

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

    Tabela 145. Parâmetros
    Nome Tipo Descrição
    o Objeto O objeto a ser verificado.
    Tabela 146. Retornos
    Tipo Descrição
    Booliano Verdadeiro se o objeto for nulo, indefinido ou contiver uma cadeia de caracteres vazia; caso contrário, retornará falso. 
    var now_GR = new GlideRecord();
gs.info(gs.nil(now_GR));

    Saída

    true

    GlideSystem com escopo - quartersAgend (trimestres numéricos)

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

    Tabela 147. Parâmetros
    Nome Tipo Descrição
    trimestres Número Número inteiro de trimestres
    Tabela 148. 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

    GlideSystem com escopo - quartersAgStart (trimestres numéricos)

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

    Tabela 149. Parâmetros
    Nome Tipo Descrição
    trimestres Número Número inteiro de trimestres
    Tabela 150. 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

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

    Define a chave especificada com o valor especificado se a propriedade estiver dentro do escopo do script.

    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 151. 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 152. Retornos
    Tipo Descrição
    vazio

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

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

    Saída:

    bar

    GlideSystem com escopo - setRedirect(Object o)

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

    Tabela 153. Parâmetros
    Nome Tipo Descrição
    o Objeto Objeto URI ou cadeia de caracteres URI a ser definido como redirecionamento
    Tabela 154. Retornos
    Tipo Descrição
    vazio 
    gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user=" 
+ current.sys_id + "&sysparm_email=" + current.email)

    GlideSystem com escopo - tableExists (nome da cadeia de caracteres)

    Determina se existe uma tabela de banco de dados.

    Tabela 155. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome da tabela a ser verificada.
    Tabela 156. Retornos
    Tipo Descrição
    Booliano Verdadeiro se a tabela existir. Falso se a tabela não foi encontrada.

    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

    GlideSystem com escopo - UrlEncode (url da cadeia de caracteres)

    Codifica caracteres não ASCII, caracteres ASCII não seguros e espaços para que a cadeia de caracteres retornada possa ser usada na Internet. Usa codificação UTF-8. Usa codificação percentual (%).

    Tabela 157. Parâmetros
    Nome Tipo Descrição
    URL Cadeia de caracteres A cadeia de caracteres a ser codificada.
    Tabela 158. Retornos
    Tipo Descrição
    Cadeia de caracteres Uma cadeia de caracteres com caracteres não ASCII, caracteres ASCII não seguros e espaços codificados.

    GlideSystem com escopo - urlDecode (url da cadeia de caracteres)

    Substitui caracteres codificados UTF-8 por caracteres ASCII.

    Tabela 159. Parâmetros
    Nome Tipo Descrição
    URL Cadeia de caracteres UTF-8 por cento (%) caracteres codificados.
    Tabela 160. Retornos
    Tipo Descrição
    Cadeia de caracteres Caracteres codificados substituídos por caracteres ASCII.

    GlideSystem com escopo - WARN(Mensagem de cadeia de caracteres, Object parm1, Object parm2, Object parm3, Object parm4, objeto parm5)

    Grava uma mensagem de aviso no log do sistema.

    Tabela 161. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem de log com espaços reservados para quaisquer argumentos de variável.
    param1 Objeto (Opcional) Argumento da primeira variável.
    param2 Objeto (Opcional) Segundo argumento de variável.
    param3 Objeto (Opcional) Terceiro argumento de variável.
    param4 Objeto (Opcional) Quarto argumento de variável.
    param5 Objeto (Opcional) Argumento da quinta variável.
    Tabela 162. Retornos
    Tipo Descrição
    vazio 
    gs.warn("This is a warning");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.warn("This is a warning from {0}.{1}", myFirstName, myLastName);
    Saída:
    This is a warning
This is a warning from Abel.Tuter

    GlideSystem com escopo - xmlToJSON(cadeia de caracteres xmlString)

    Usa uma cadeia de caracteres XML e retorna um objeto JSON.

    Tabela 163. Parâmetros
    Nome Tipo Descrição
    XmlString Cadeia de caracteres A cadeia de caracteres XML a ser convertida.
    Tabela 164. Retornos
    Tipo Descrição
    Objeto Um objeto JSON que representa a cadeia de caracteres XML. Nulo se não for possível processar a cadeia de caracteres XML.

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

    var jsonObject = gs.xmlToJSON(xmlString);

    GlideSystem com escopo - Years sAgo (número de anos)

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

    Tabela 165. Parâmetros
    Nome Tipo Descrição
    ANOS Número Um número inteiro de anos
    Tabela 166. 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.

    GlideSystem com escopo - Ontem()

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

    Tabela 167. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 168. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT de 24 horas atrás, no formato aaaa-mm-dd hh:mm:ss