referência rápida de APIs Glide

Instancia um GlideRecord sobre a tabela informada. É o ponto de partida de quase toda query server-side.

Adiciona uma condição de igualdade (AND por padrão). Aceita também operador: addQuery("priority", "<=", 2).

Sempre filtre antes de query(). Um query() sem addQuery() varre a tabela inteira.

→ artigo relacionado

Aplica uma encoded query inteira de uma vez (a mesma string que aparece na URL da lista).

Nunca concatene input externo direto aqui — é vetor de injeção de query. Valide/whiteliste antes.

→ artigo relacionado

Atalho para addQuery("active", true). Restringe a registros ativos.

Ordena o resultado por um campo, ascendente ou descendente.

Limita a quantidade de registros retornados pela query.

Use sempre que só precisar de alguns registros — evita trazer milhares à toa.

→ artigo relacionado

Executa a query montada. Depois, itere com while (gr.next()).

Carrega um único registro. Retorna true se encontrou. Já posiciona o cursor no registro.

Prefira get() a query()+next() quando espera exatamente um registro.

Avança o cursor para o próximo registro. Retorna false quando acabam.

Retorna o valor bruto (string) do campo, sem passar por getter de exibição.

Prefira getValue() a acessar gr.campo diretamente — evita coerção surpresa e problemas com referência.

Retorna o valor de exibição (label do choice, nome do referenciado) em vez do valor interno.

Nunca compare/grave pelo display value — o valor interno é o estável.

→ artigo relacionado

Define o valor de um campo antes de insert()/update().

Insere o registro e retorna o sys_id gerado (ou null se falhou).

Grava as alterações do registro atual e retorna o sys_id.

Cada update() dispara a pipeline de Business Rules de novo — cuidado com recursão em loop.

→ artigo relacionado

Apaga o registro atual, ou todos os que casam com a query montada.

deleteMultiple() ignora o registro corrente e apaga o conjunto — teste a query antes.

Desliga Business Rules, notificações e engines para as próximas operações deste GlideRecord.

Útil para import/migração em massa. Cuidado: pula validações — use com consciência.

Impede a atualização automática de sys_updated_on/by ao gravar.

Preserva metadados de auditoria em migrações. Raramente necessário no dia a dia.

Aborta a operação de banco em andamento. Só tem efeito em before Business Rule.

Em after BR já não desfaz nada — o dado já foi gravado.

→ artigo relacionado

Faz contagem/soma/agrupamento no banco, sem trazer os registros para o servidor de aplicação.

Para contar acima de ~100 registros ou tabela que cresce, use GlideAggregate — nunca getRowCount().

→ artigo relacionado

Declara a função de agregação. COUNT não precisa de campo.

Agrupa os resultados por um campo (equivale ao GROUP BY do SQL).

Lê o valor agregado do grupo atual, depois de query()+next().

Data e hora atuais em UTC (GMT). É o tipo certo para aritmética de data no servidor.

Datas no ServiceNow são armazenadas em UTC; a conversão para o fuso do usuário é na exibição.

Soma (ou subtrai, com valor negativo) uma quantidade de tempo à data.

Retorna o timestamp em milissegundos — bom para comparar duas datas com segurança.

Comparar datas por getNumericValue() evita bugs de string/fuso.

Diferença entre duas datas (strings). Com o terceiro parâmetro true, retorna segundos como número.

Data formatada no fuso e no formato do usuário atual.

Escreve no log do sistema (syslog) no nível correspondente.

Nunca logue PII ou credencial. Log é lido por muita gente e fica retido.

→ artigo relacionado

sys_id do usuário logado na sessão atual.

Objeto GlideUser do usuário atual (roles, grupos, dados de perfil).

Verdadeiro se o usuário atual tem a role (ou é admin).

admin passa em quase todo hasRole() — teste permissão com um usuário real, não com admin.

→ artigo relacionado

Lê uma system property (sys_properties). O segundo parâmetro é o fallback.

Coloque configuração em property, não hardcoded no script.

Guarda um dado na sessão do usuário; recupere com getClientData(chave).

É o jeito documentado de cachear na sessão (ex.: em ACL com script) sem repetir query.

→ artigo relacionado

Verdadeiro se o valor é nulo, vazio ou indefinido — o jeito idiomático de checar "vazio" no ServiceNow.

Enfileira um evento customizado no Event Registry para processamento assíncrono.

Bom para desacoplar efeitos colaterais pesados do fluxo síncrono.

Lê ou define o valor de um campo no formulário, no cliente.

setValue() em campo de referência: passe também o display value para evitar uma chamada extra ao servidor.

Controla obrigatoriedade, somente-leitura e visibilidade de um campo via Client Script.

Se o comportamento pode ser declarativo, prefira UI Policy a Client Script — é mais fácil de manter.

→ artigo relacionado

Mostra uma mensagem no topo do formulário.

Busca o registro referenciado por um campo. Sempre passe o callback para não travar a UI.

getReference() sem callback é síncrono e congela o navegador — sempre use o callback.

Dados do usuário logado disponíveis no cliente sem ida ao servidor.

g_user.hasRole() no cliente não enxerga roles herdadas de grupo em todos os casos — para decisão de segurança, valide no servidor.

Dado enviado do servidor para o cliente por uma Display Business Rule, disponível no onLoad sem GlideAjax.

É o jeito mais barato de pré-carregar dado num form — sem round-trip extra.

→ artigo relacionado