GlideSystem - com escopo

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 30 min. de leitura

    • A API GlideSystem com escopo (referida pelo nome de variável "gs" em qualquer JavaScript do lado do servidor) fornece vários métodos convenientes para obter informações sobre o sistema, o usuário conectado no momento etc.

    Muitos dos métodos GlideSystem 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(cadeia de caracteres "mensagem")

    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. Retorna
    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 - addInfoMessage(cadeia de caracteres "mensagem")

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

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem informativa a ser adicionada.
    Tabela 4. Retorna
    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 - base64Encode(cadeia de caracteres source)

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

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    origem Cadeia de caracteres Cadeia de caracteres a ser codificada.
    Tabela 6. Retorna
    Tipo Descrição
    Cadeia de caracteres Cadeia de caracteres base64 codificada.

    Exemplo

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

    GlideSystem com escopo - base64Decode(cadeia de caracteres source)

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

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    origem Cadeia de caracteres Uma cadeia de caracteres codificada em base64.
    Tabela 8. Retorna
    Tipo Descrição
    Cadeia de caracteres A cadeia de caracteres decodificada.

    GlideSystem com escopo - startsOfLastMonth()

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

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT começando do último mês, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - startsOfLastWeek()

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

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Cadeia de caracteres Início GMT da última semana, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - startsOfNextMonth()

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

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

    GlideSystem com escopo - startsOfNextWeek()

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

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 16. Retorna
    Tipo Descrição
    Cadeia de caracteres O GMT que começa na próxima semana, no formato aaaa-mm-dd hh:mm:ss.

    GlideSystem com escopo - startsOfNextYear()

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

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

    GlideSystem com escopo - startsOfEsteMonth()

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

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

    GlideSystem com escopo - startsOfEsteQuarter()

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

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

    GlideSystem com escopo - startsOfEsteWeek()

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

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

    GlideSystem com escopo - startsOfEsteYear()

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

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

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

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

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    data Cadeia de caracteres Data para a qual o GMT será gerado.

    Formato: aaaa-mm-dd
    intervalo Cadeia de caracteres Início, término ou uma hora no formato de 24 horas hh:mm:ss.
    Tabela 28. Retorna
    Tipo Descrição
    Cadeia de caracteres Data e hora geradas.

    Se o intervalo for início, o valor retornado será aaaa-mm-dd 00:00:00.

    Se o intervalo for final, o valor de retorno será aaaa-mm-dd 23:59:59.

    Formato: aaaa-mm-dd hh:mm:ss

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

    var tableData = new GlideRecord('incident');
tableData.addEncodedQuery("sys_created_onBETWEENjavascript:gs.dateGenerate('2015-10-07','00:00:00')@javascript:gs.daysAgoEnd(0)^priority=1^severityIN1,2");
tableData.query();
gs.info("Count: " + tableData.getRowCount());

    Saída

    Count: 7

    GlideSystem com escopo - daysAgo(Number days)

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

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    dias Número Número inteiro de dias
    Tabela 30. Retorna
    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(Number days)

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

    Tabela 31. Parâmetros
    Nome Tipo Descrição
    dias Número Número inteiro de dias
    Tabela 32. Retorna
    Tipo Descrição
    Cadeia de caracteres Fim do dia GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - daysAgoStart(Number days)

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

    Tabela 33. Parâmetros
    Nome Tipo Descrição
    dias Cadeia de caracteres Número inteiro de dias
    Tabela 34. Retorna
    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(cadeia de caracteres "mensagem", "Objeto parm1", "Objeto parm2", "Objeto parm3", "objeto parm4", "objeto parm5")

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

    Tabela 35. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem de log com espaços reservados para qualquer argumento de variável.
    param1 Objeto (Opcional) Primeiro argumento de variável.
    parâmetro2 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) Quinto argumento de variável.
    Tabela 36. Retorna
    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 mês passado em GMT.

    Tabela 37. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 38. Retorna
    Tipo Descrição
    Cadeia de caracteres Fim de GMT 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 39. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 40. Retorna
    Tipo Descrição
    Cadeia de caracteres Término GMT da última semana, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfLastYear()

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

    Tabela 41. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 42. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT no 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 43. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 44. 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 45. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 46. 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 47. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 48. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - endOfEsteMonth()

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

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

    GlideSystem com escopo - endOfEsteQuarter()

    Retorna a data e a hora do final deste trimestre 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 - endOfEsteWeek()

    Retorna a data e a hora do final desta 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 - endOfEsteYear()

    Retorna a data e a hora do final deste 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 - erro (cadeia de caracteres message, Object parm1, Object parm2, Object parm3, Object parm4, Object 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 que este método forneça a saída correta.
    Tabela 57. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem de log com espaços reservados para qualquer argumento de variável.
    param1 Objeto (Opcional) Primeiro argumento de variável.
    parâmetro2 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) Quinto argumento de variável.
    Tabela 58. Retorna
    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(cadeia de caracteres name, Object instance, String parm1, String parm2, String queue)

    Coloca um evento na fila para o gerente de eventos.

    Tabela 59. 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 60. Retorna
    Tipo Descrição
    vazio 
    if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueue('incident.commented', current, gs.getUserID(), gs.getUserName());
}

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

    Coloca um evento na fila no gerenciador de eventos.

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

    Tabela 61. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome do evento a ser colocado na fila.
    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 de evento. Este parâmetro é de forma livre e depende da implementação do script de evento.

    Padrão: se o parâmetro instance for um objeto GlideRecord, o padrão será o valor de exibição desse GlideRecord (now_GR.getDisplayValue), caso contrário, será nulo.
    parm2 Cadeia de caracteres Opcional. Cadeia de caracteres a ser passada para o script de 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 de tipo de data/hora que especifica a data e a hora para processar o evento.

    Padrão: data/hora atuais
    Tabela 62. Retorna
    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 63. Parâmetros
    Nome Tipo Descrição
    trabalho GlideRecord Trabalho a ser executado.
    Tabela 64. Retorna
    Tipo Descrição
    Cadeia de caracteres Retorna o sys_id do trabalho programado. Retornará nulo se o trabalho for global.

    Exemplo

    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 65. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 66. Retorna
    Tipo Descrição
    Cadeia de caracteres Um GUID hexadecimal de 32 caracteres. 
    personalId = gs.generateGUID();
gs.info(personalId);

    Saída

    af770511ff013100e04bfffffffffff6

    GlideSystem com escopo - getCallerScopeName()

    Obtém o nome do escopo do solicitante; retornará nulo se não houver nenhum solicitante.

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

    Este exemplo mostra duas inclusões de script que são definidas como Acessíveis de 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 69. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 70. Retorna
    Tipo Descrição
    Cadeia de caracteres A versão do cache CSS. 
    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 71. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 72. 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 73. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 74. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome do escopo atual. 
    var currentScope = gs.getCurrentScopeName();
gs.info(currentScope);

    Saída

    s_snc_test_scope

    GlideSystem com escopo - getDateFormat(String)

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

    Tabela 75. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 76. 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 77. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 78. Retorna
    Tipo Descrição
    Cadeia de caracteres O formato de data e hora associado ao usuário atual.

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

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

    Saída:

    yyyy-MM-dd HH:mm:ss

    GlideSystem com escopo – getErrorMessages()

    Retorna as mensagens de erro que foram adicionadas por addErrorMessage() à sessão.

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

    GlideSystem com escopo - getEscapedMessage(cadeia de caracteres id, matriz args)

    Recupera a mensagem especificada da tabela Mensagem [sys_ui_message]. Se a mensagem tiver caracteres HTML especiais, o substituirá 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 da mensagem não existir na tabela, ele retornará o ID da mensagem.

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

    Nota:
    Se a mensagem de IU tiver um visto ('), pode haver problemas com a mensagem no script; para escapar dos tiques ('), use getMessageS(String, Object).
    Tabela 81. Parâmetros
    Nome Tipo Descrição
    id Cadeia de caracteres Identificador de mensagem. Você pode localizar este valor no campo Chave da tabela Mensagem [sys_ui_message]. Observe que o campo Chave pode ser exatamente igual à cadeia de caracteres da mensagem real.
    args 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("Anula a adição da ação '{0}', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);

    Neste exemplo , '{0}' foi substituído pelo conteúdo de current.action.name.

    Nota:
    Os valores passados não são traduzidos. Eles são inseridos integralmente na mensagem.
    Tabela 82. Retorna
    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 < e >.

    // 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(cadeia de caracteres id, matriz args)

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

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

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

    Nota:
    Se a mensagem de IU tiver um visto ('), pode haver problemas com a mensagem no script; para escapar dos tiques ('), use getMessageS(String, Object).
    Tabela 83. Parâmetros
    Nome Tipo Descrição
    id Cadeia de caracteres Identificador de mensagem. Você pode localizar este valor no campo Chave da tabela Mensagem [sys_ui_message]. Observe que o campo Chave pode ser exatamente igual à 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("Anula a adição da ação '{0}', o mesmo subfluxo não pode ser adicionado duas vezes neste subfluxo.", current.action.name);

    Neste exemplo , '{0}' foi substituído pelo conteúdo de current.action.name.

    Nota:
    Os valores passados não são traduzidos. Eles são inseridos integralmente na mensagem.
    Tabela 84. Retorna
    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(cadeia de caracteres key, Object alt)

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

    Tabela 85. 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 86. Retorna
    Tipo Descrição
    Cadeia de caracteres O valor da propriedade do Glide ou o objeto alternativo definido acima. 
    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 87. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 88. 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 do GlideSession.

    Tabela 89. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 90. 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 91. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 92. 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 93. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 94. Retorna
    Tipo Descrição
    Cadeia de caracteres O formato de hora associado ao usuário atual. 
    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 o método getTimeZoneName() na API GlideSession.

    Tabela 95. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 96. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome do fuso horário. 
    gs.info(gs.getTimeZoneName());

    GlideSystem com escopo - getUrlOnStack()

    Obtém o URI atual da sessão.

    Tabela 97. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 98. 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 escopopara obter uma lista de métodos disponíveis.

    Tabela 99. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 100. 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 101. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 102. 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 103. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 104. 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 do usuário atual.

    Tabela 105. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 106. 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 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(Object role)

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

    Tabela 107. Parâmetros
    Nome Tipo Descrição
    função Objeto A função a ser verificada.
    Tabela 108. Retorna
    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(Number hours)

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

    Tabela 109. Parâmetros
    Nome Tipo Descrição
    horas Número Número inteiro de horas
    Tabela 110. Retorna
    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 fim da hora de um número especificado de horas atrás.

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

    GlideSystem com escopo - hoursAgoStart(Number hours)

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

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

    GlideSystem com escopo - include(cadeia de caracteres name)

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

    Tabela 115. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome do script a ser incluído.
    Tabela 116. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se a inclusão de script funcionou.
    Valores possíveis:
    • verdadeiro: a inclusão de script funcionou.
    • falso: falha na inclusão de script.

    Este exemplo obtém o 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(cadeia de caracteres message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    Grava uma mensagem informativa no log do sistema.

    Tabela 117. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem de log com espaços reservados para qualquer argumento de variável.
    param1 Objeto (Opcional) Primeiro argumento de variável.
    parâmetro2 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) Quinto argumento de variável.
    Tabela 118. Retorna
    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 - isDebugging()

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

    Tabela 119. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 120. Retorna
    Tipo Descrição
    Booliano Verdadeiro se a depuração de sessão estiver ativa ou o nível de log estiver definido como depurar 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 121. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 122. 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.

    Tabela 123. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 124. 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 125. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 126. 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 - monthAgo(Número meses)

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

    Tabela 127. Parâmetros
    Nome Tipo Descrição
    meses Número Número inteiro de meses atrás.
    Tabela 128. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT do número especificado de meses atrás, exatamente ao mesmo tempo.

    Formato: aaaa-mm-dd hh:mm:ss

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

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

    Saída

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

    GlideSystem com escopo - minutesAgoEnd(Number minutes)

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

    Tabela 129. Parâmetros
    Nome Tipo Descrição
    minutos Número Número inteiro de minutos atrás, como 5 ou 126.
    Tabela 130. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT o número especificado de minutos atrás, no final do minuto (59 segundos).

    Formato: aaaa-mm-dd hh:mm:ss

    O exemplo a seguir exibe a data e hora atuais e a data e hora de 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(Number minutes)

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

    Tabela 131. Parâmetros
    Nome Tipo Descrição
    minutos Número Número inteiro de minutos atrás, como 15 ou 112.
    Tabela 132. Retorna
    Tipo Descrição
    Cadeia de caracteres GMT o número especificado de minutos atrás, no início do minuto.

    Formato: aaaa-mm-dd hh:mm:ss

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

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

    Tabela 133. Parâmetros
    Nome Tipo Descrição
    meses Número Número inteiro de meses atrás, como 3 ou 14.
    Tabela 134. Retorna
    Tipo Descrição
    Cadeia de caracteres Início GMT do mês do número especificado de meses atrás.

    Formato: aaaa-mm-dd hh:mm:ss

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

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

    Saída

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

    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 135. Parâmetros
    Nome Tipo Descrição
    o Objeto O objeto a ser verificado.
    Tabela 136. Retorna
    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 - quartersAgoEnd(Number quarters)

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

    Tabela 137. Parâmetros
    Nome Tipo Descrição
    trimestres Número Número inteiro de trimestres
    Tabela 138. Retorna
    Tipo Descrição
    Cadeia de caracteres Término GMT do trimestre que era o número especificado de trimestres atrás, no formato aaaa-mm-dd hh:mm:ss

    GlideSystem com escopo - quartersAgoStart(Number quarters)

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

    Tabela 139. Parâmetros
    Nome Tipo Descrição
    trimestres Número Número inteiro de trimestres
    Tabela 140. Retorna
    Tipo Descrição
    Cadeia de caracteres Término GMT do mês que era 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 de cadeia de caracteres)

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

    Nota:
    Deve-se ter cuidado ao definir as propriedades do sistema (sys_properties) usando este método, pois ele causa uma limpeza de cache em todo o sistema. Cada liberação pode causar degradação do sistema enquanto os caches são recriados. Se um valor deve ser atualizado com frequência, ele não deve 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 141. Parâmetros
    Nome Tipo Descrição
    chave Cadeia de caracteres A chave da propriedade a ser definida.
    valor Cadeia de caracteres O valor da propriedade a ser definido.
    description Cadeia de caracteres Uma descrição da propriedade.
    Tabela 142. Retorna
    Tipo Descrição
    vazio 
    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 143. Parâmetros
    Nome Tipo Descrição
    o Objeto Objeto URI ou cadeia de caracteres URI a ser definido como redirecionamento
    Tabela 144. Retorna
    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(cadeia de caracteres name)

    Determina se existe uma tabela de banco de dados.

    Tabela 145. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome da tabela a ser verificada.
    Tabela 146. Retorna
    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 incidentes e foo existem na instância ServiceNow.

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

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

    Saída

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

    GlideSystem com escopo - urlEncode(cadeia de caracteres url)

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

    Tabela 147. Parâmetros
    Nome Tipo Descrição
    url Cadeia de caracteres A cadeia de caracteres a ser codificada.
    Tabela 148. Retorna
    Tipo Descrição
    Cadeia de caracteres Uma cadeia de caracteres com caracteres não ASCII, caracteres ASCII inseguros e espaços codificados.

    GlideSystem com escopo - urlDecode(cadeia de caracteres url)

    Substitui caracteres codificados em UTF-8 por caracteres ASCII.

    Tabela 149. Parâmetros
    Nome Tipo Descrição
    url Cadeia de caracteres Caracteres codificados em UTF-8 por cento (%).
    Tabela 150. Retorna
    Tipo Descrição
    Cadeia de caracteres Caracteres codificados substituídos por caracteres ASCII.

    GlideSystem com escopo - aviso (cadeia de caracteres message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    Grava uma mensagem de aviso no log do sistema.

    Tabela 151. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres A mensagem de log com espaços reservados para qualquer argumento de variável.
    param1 Objeto (Opcional) Primeiro argumento de variável.
    parâmetro2 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) Quinto argumento de variável.
    Tabela 152. Retorna
    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 153. Parâmetros
    Nome Tipo Descrição
    Cadeia de caracteres xml Cadeia de caracteres A cadeia de caracteres XML a ser convertida.
    Tabela 154. Retorna
    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. 
    var jsonObject = gs.xmlToJSON(xmlString);

    GlideSystem com escopo - yearAgo(Número de anos)

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

    Tabela 155. Parâmetros
    Nome Tipo Descrição
    anos Número Um número inteiro de anos
    Tabela 156. Retorna
    Tipo Descrição
    Cadeia de caracteres Início GMT do ano que é o número especificado de anos atrás, no formato aaaa-mm-dd hh:mm:ss.

    GlideSystem com escopo - ontem ()

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

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