GlideSystem - Com escopo

A API GlideSystem com escopo 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 métodos GlideSystem facilitam a inclusão 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 de origem)

Cria uma cadeia de caracteres em 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 codificada em base64.

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

Retorna uma cadeia de caracteres ASCII a partir da cadeia de caracteres em 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 último mês em GMT.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

Tipo	Descrição
Cadeia de caracteres	GMT no início 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	GMT no início 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 a partir da 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 - startsOf ThisMonth()

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

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	GMT no início deste trimestre, no formato aaaa-mm-dd hh:mm:ss

GlideSystem com escopo - startsOf ThisWeek()

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

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	GMT no início deste ano, no formato aaaa-mm-dd hh:mm:ss

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

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	Hora de início, de término ou no formato de 24 horas hh:mm:ss.

Tabela 28. Retorna

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

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

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

Saída

Count: 7

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 do dia há um número especificado de dias.

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 do dia há um número especificado de dias.

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

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

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 fim do último mês em GMT.

Tabela 37. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 38. Retorna

Tipo	Descrição
Cadeia de caracteres	Fim GMT do último mês, no formato aaaa-mm-dd hh:mm:ss

GlideSystem com escopo - endOfLastWeek()

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

Tabela 39. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 40. Retorna

Tipo	Descrição
Cadeia de caracteres	Fim GMT da última semana, no formato aaaa-mm-dd hh:mm:ss

GlideSystem com escopo - endOfLastYear()

Retorna a data e a hora do fim do último ano 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 fim 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 fim 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 fim 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 - endOf ThisMonth()

Retorna a data e a hora do fim 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 - endOf ThisQuarter()

Retorna a data e a hora do fim 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 - endOf ThisWeek()

Retorna a data e a hora do fim 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 - endOf ThisYear()

Retorna a data e a hora do fim 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 mensagem, 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 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)

Enfileira um evento para o gerenciador 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 de objeto, cadeia de caracteres parm1, cadeia de caracteres parm2, expiração de objeto)

Enfileira um evento no gerenciador de eventos.

As informações de programação de eventos aprovadas 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 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 de evento. Este parâmetro tem 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 tem 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 atual

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 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 65. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 66. Retorna

Tipo	Descrição
Cadeia de caracteres	Um 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 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 solicitante.

Este exemplo mostra duas inclusões de script que estã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 de 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 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.

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(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 (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, 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 Mensagem, consulte Tabela Mensagem.

Nota:

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

Tabela 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 textualmente 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 (ID da cadeia de caracteres, argumentos da 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 da mensagem não existir na tabela, ele retornará o ID da mensagem.

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

Nota:

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

Tabela 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 textualmente 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 chave, objeto 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 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 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 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.

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 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.

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 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 de usuário 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 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 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(Number hours)

Retorna a data e a hora do fim da hora há um número especificado de horas.

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 há um número especificado de horas.

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 (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 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: inclusão de script funciona. falso: falha na inclusão de script.

Este exemplo obtém 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 - informações (cadeia de caracteres mensagem, objeto parm1, objeto parm2, objeto parm3, objeto parm4, objeto 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 se 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 uma 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 no momento.

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ócio.

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

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

Tabela 127. Parâmetros

Nome	Tipo	Descrição
minutos	Número	Número inteiro de minutos atrás, como 5 ou 126.

Tabela 128. 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 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 - minutosAgoStart(Número de minutos)

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

Tabela 129. Parâmetros

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

Tabela 130. 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 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 - monthAgo(Número de meses)

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

Tabela 131. Parâmetros

Nome	Tipo	Descrição
meses	Número	Número inteiro de meses atrás.

Tabela 132. 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 - monthAgoStart(Número de meses)

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

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 há o número especificado de meses. Formato: aaaa-mm-dd hh:mm:ss

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

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

Saída

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

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, retorna falso.

var now_GR = new GlideRecord();
gs.info(gs.nil(now_GR));

Saída

true

GlideSystem com escopo - trimestresAgoEnd(Número trimestres)

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

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	Fim GMT do trimestre que era o número especificado de trimestres atrás, no formato aaaa-mm-dd hh:mm:ss

GlideSystem com escopo - trimestresAgoStart(Número trimestres)

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

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	Fim 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 com 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 limpeza pode causar degradação no sistema enquanto os caches são reconstruídos. Se um valor precisar ser atualizado com frequência, ele não deverá ser armazenado como uma propriedade do sistema. Em geral, você só deve colocar valores na tabela sys_properties que não mudam com frequência.

Tabela 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.
descrição	Cadeia de caracteres	Uma descrição da propriedade.

Tabela 142. Retorna

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 143. Parâmetros

Nome	Tipo	Descrição
o	Objeto	Objeto URI ou cadeia de caracteres URI a ser definida como o 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(String 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 para verificar a existência.

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 incidente e foo existem na instância ServiceNow.

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

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

Saída:

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

GlideSystem com escopo - urlEncode(cadeia de caracteres URL)

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 a 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 não seguros 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 mensagem, objeto parm1, objeto parm2, objeto parm3, objeto parm4, objeto 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(String xmlString)

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

Tabela 153. Parâmetros

Nome	Tipo	Descrição
xmlString	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.

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

var jsonObject = gs.xmlToJSON(xmlString);

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

Retorna uma data e hora de 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 para 24 horas atrás, no formato aaaa-mm-dd hh:mm:ss