0% acharam este documento útil (0 voto)

23 visualizações54 páginas

API Xanadu: Guia de Uso do GlideQuery

A Referência de API do Xanadu fornece informações sobre a inclusão de script GlideQuery, que é uma alternativa à API GlideRecord para operações CRUD em dados. O documento detalha a implementação, tratamento de erros, reutilização e limitações do GlideQuery, além de descrever métodos intermediários e de terminal. Exemplos de código ilustram como usar a API para consultas em tabelas, incluindo agregações e tratamento de erros.

Enviado por

Eduardo Roseo

Direitos autorais

Levamos muito a sério os direitos de conteúdo. Se você suspeita que este conteúdo é seu, reivindique-o aqui.

Formatos disponíveis

Baixe no formato PDF, TXT ou leia on-line no Scribd

0% acharam este documento útil (0 voto)

23 visualizações54 páginas

API Xanadu: Guia de Uso do GlideQuery

Enviado por

Eduardo Roseo

Direitos autorais

Levamos muito a sério os direitos de conteúdo. Se você suspeita que este conteúdo é seu, reivindique-o aqui.

Formatos disponíveis

Baixe no formato PDF, TXT ou leia on-line no Scribd

Referência de API do Xanadu

Referência de API do
Xanadu
Última atualização: janeiro 24, 2025

Algumas partes deste tópico podem ter sido

traduzidas automaticamente.

PDF gerado em janeiro 24, 2025

©2025 ServiceNow. Todos os direitos reservados.
Termos de uso Declaração de privacidade
ServiceNow, o logotipo ServiceNow, Now e outras marcas ServiceNow são marcas comerciais e/ou marcas registradas da ServiceNow,
Inc. nos Estados Unidos e/ou em outros países. Outros nomes de empresas e de produtos podem ser marcas comerciais das respectivas
empresas às quais estão associados.
Referência de API do Xanadu

Alguns exemplos e gráficos representados aqui são fornecidos somente

para ilustração. Nenhuma associação ou conexão real com os produtos
ou serviços da ServiceNow é pretendida ou deve ser inferida.
Este PDF foi criado a partir de conteúdo disponível
[Link]. O site é atualizado frequentemente. Para
acessar a documentação mais atual de produtos da ServiceNow, visite
[Link].

Sede da empresa
2225 Lawson Lane
Santa Clara, CA 95054
Estados Unidos
(408)501-8550

PDF gerado em janeiro 24, 2025 2

ServiceNow, o logotipo ServiceNow, Now e outras marcas ServiceNow são marcas comerciais e/ou marcas registradas da ServiceNow, Inc.
nos Estados Unidos e/ou em outros países. Outros nomes de empresas e de produtos podem ser marcas comerciais das respectivas empresas
às quais estão associados.
Referência de API do Xanadu

GlideQuery - com escopo, global

A inclusão de script GlideQuery é uma alternativa à API GlideRecord
para executar operações CRUD em dados de registro de scripts do lado
do servidor.

A inclusão de script GlideQuery permite:

• Use objetos e tipos JavaScript padrão para consultas e resultados.

• Diagnostique rapidamente erros de consulta com verificações

adicionais e mensagens de erro claras.

• Simplifique seu código evitando padrões de consulta clichê.

• Evite problemas comuns de desempenho sem precisar de um

conhecimento mais profundo do GlideRecord.

Use a inclusão de script GlideQuery em scripts do lado do servidor com

escopo ou globais. Quando usado em um app com escopo, ele deve
ser prefixado com o escopo global.
new [Link]('sys_user')
// ...
Esta inclusão de script requer o plug-in GlideQuery [com.sn_glidequery].

Implementação

Esta inclusão de script funciona junto com as APIs de fluxo e opcionais

em um padrão de construtor em que o método chama a cadeia,
cada método se baseia no resultado retornado do método anterior.
Use métodos para definir os atributos da consulta. Os métodos não são
executados até que você chame um método de terminal, um método
que retorna um resultado de consulta, permitindo que você defina os
requisitos da consulta antes de executá-la.

Se a consulta retornar um único registro, o sistema agrupará o resultado

em um objeto opcional. Se a consulta retornar um fluxo de registros,
o sistema agrupará o resultado em um objeto Stream. Esses objetos
permitem gerenciar o resultado usando um conjunto de métodos em
cada API.

PDF gerado em janeiro 24, 2025 3

Por exemplo, este script executa uma consulta na Tabela de tarefas,

agrupa os registros por prioridade e retorna cada prioridade que tem um
total de reatribuições maior que quatro.

var query = new [Link]('task')

.where('active', true) //Returns new GlideQuery objec
t with a "where" clause.
.groupBy('priority') //Returns new GlideQuery object
with a "group by" clause.
.aggregate('sum', 'reassignment_count') //Returns ne
w GlideQuery object with a "sum(reassignment_count)" clau
se.
.having('sum', 'reassignment_count', '>', 4) //Return
s new GlideQuery object with a "having reassignment_coun
t > 4" clause.
.select() //Returns a stream of records wrapped in a
Stream object.
.forEach(function (priority){ //Terminal method in th
e Stream class that executes the query and returns the re
sult.
[Link]("Priority " + [Link] + ":
" + [Link].reassignment_count + " reassignments");
});
Saída:
Priority 1: 11 reassignments
Priority 3: 6 reassignments
Priority 5: 5 reassignments

Tratamento de erros

A inclusão de script GlideQuery gera um erro quando sua consulta tem

um problema e inclui uma explicação clara para ajudar a orientá-lo.
Esta inclusão de script verifica:

• Campos inválidos

• Tipos de valor inválidos para um campo

• Valores inválidos para campos de opção

• Operadores de consulta inválidos

PDF gerado em janeiro 24, 2025 4

Por exemplo, a amostra de código a seguir geraria um erro porque o

campo consultado não existe na tabela.

new [Link]('task')
.where('id', '4717dfe5a9fe198100450448b2404c16') // s
hould be 'sys_id'
.select('description', 'severity')
.toArray(100);
// Error: Unable to find field 'id' in table 'task'. Know
n fields: active, activity_due, ...

Esta amostra de código geraria um erro porque o tipo de dados de um

dos argumentos está incorreto.

new [Link]('task')
.where('priority', 'one') // priority is an integer (
should be 1)
.select('description', 'severity')
.toArray(100);
// Error: Unable to match value ['one'] with field 'prio
rity' in table 'task'. Expecting type 'integer'

Reutilizar

Como os objetos GlideQuery são imutáveis, você pode reutilizá-los

posteriormente em outras partes do código. Por exemplo, este script cria
uma consulta e usa o objeto GlideQuery posteriormente para gerar um
relatório.

var highPriorityTasks = new [Link]('task')

.where('active', true)
.where('priority', 1);

generateReport(highPriorityTasks);
notifyOwners(highPriorityTasks);
var avgReassignmentCount = highPriorityTasks
.avg('reassignment_count')
.orElse(0)

Limitações

A inclusão de script GlideQuery não é compatível com:

PDF gerado em janeiro 24, 2025 5

• Leitura ou gravação em tabelas que não permitem o acesso de outros

escopos.

• Lendo consultas codificadas.

• Objetos GlideDate ou GlideDateTime, que são lidos como cadeias de

caracteres JavaScript.

• Campos de moeda FX.

• Atualizando tipos de campo de diário.

• Consultas com lógica condicional ambígua. Por exemplo, a consulta

a seguir não está clara porque o sistema não sabe se deve executar
(active = true AND name != null) OR last_name = Luddy or
active = true AND (name != null OR last_name = Luddy).
var user = new [Link]('sys_user')
.where('active', true)
.whereNotNull('name')
.orWhere('last_name', 'Luddy')
.selectOne()
.get()

Consulte o método Where() para entender como aninhar uma

consulta secundária.

Nota: Como a inclusão de script GlideQuery converte objetos

GlideRecord em objetos JavaScript padrão, pode demorar mais
para executar consultas. Para reduzir problemas de desempenho,
evite criar loops que iteram em um grande número de registros.

Métodos intermediários e de terminal em GlideQuery

A inclusão de script GlideQuery usa duas categorias de métodos:

intermediário e terminal. Métodos intermediários são os métodos que
retornam um Stream, uma API usada para interagir com um fluxo de
itens como registros, permitindo um estilo fluente de sintaxe em que as
chamadas são encadeadas. Métodos de terminal são os métodos que
não retornam um fluxo e, portanto, interrompem a cadeia de chamadas
do método Stream.

Na inclusão de script GlideQuery, métodos como Where( ), orderBy()e

disableWorkflow() são métodos intermediários que retornam um novo

PDF gerado em janeiro 24, 2025 6

objeto GlideQuery. Da mesma forma, os métodos de terminal mais

populares da inclusão de script GlideQuery, select() e selectOne(),
são métodos de terminal. Esses métodos são chamados quando o
GlideQuery termina de ser configurado e está pronto para começar a
processar registros. É importante ter em mente as diferenças entre esses
dois tipos de método ao configurar chamadas para a inclusão de script
GlideQuery de acordo com seus casos de uso específicos. Para obter
mais informações sobre métodos intermediários e de terminal, consulte o
artigo GlideQuery - Processamento de fluxo - Parte 1.

Os seguintes métodos são classificados como intermediários:

• agregado(cadeia de caracteres agregadoType, campo de cadeia

de caracteres)

• disableAutoSysFields()

• disableWorkflow()

• forceUpdate ()

• groupBy (campos de cadeia de caracteres)

• tendo(cadeia de caracteres agregadoType, campo de cadeia de

caracteres, operador de cadeia de caracteres, valor numérico)

• limit (limite de número)

• orderBy(campos de cadeia de caracteres)

• orderByDesc(cadeia de caracteres fieldOrAggregate, campo de

cadeia de caracteres)

• orNow(cadeia de caracteres fieldOrQuery, operador de cadeia de

caracteres, qualquer valor)

• orNowNotNull(cadeia de caracteres campo)

• orNowNull(cadeia de caracteres campo)

• em que (cadeia de caracteres fieldOrQuery, operador de cadeia de

caracteres, qualquer valor)

• WhereNotNull(campo de cadeia de caracteres)

• WhereNull(campo de cadeia de caracteres)

PDF gerado em janeiro 24, 2025 7

• withAcls()

Os seguintes métodos são classificados como terminal:

• avg(campo de cadeia de caracteres)

• contagem ()

• deleteMultiple()

• get(cadeia de caracteres chave, matriz selectedFields)

• getBy(objeto keyValues, matriz selectedFields)

• insert(objeto keyValues, objeto selectedFields)

• insertOrUpdate(Objeto muda, Objeto selectedFields)

• max (campo de cadeia de caracteres)

• min (campo de cadeia de caracteres)

• select(campos de cadeia de caracteres)

• selectOne (campos de cadeia de caracteres)

• sum(campo de cadeia de caracteres)

• toGlideRecord()

• update(Objeto muda, Objeto selectedFields)

• updateMutiple(mudanças de objeto)

Nota: parse(cadeia de caracteres tabela, cadeia de caracteres

encoded_query) não é intermediária nem terminal, mas estática.

GlideQuery - GlideQuery (tabela de cadeia de caracteres)

Instancia um objeto GlideQuery usado para criar e executar consultas

de registro.

PDF gerado em janeiro 24, 2025 8

Parâmetros

Nome Tipo Descrição

Cadeia
de
tabela Tabela a ser consultada.
caractere
s

Retorna

Tipo Descrição

Nenhum(a)

Exemplo

Este exemplo instancia uma consulta da tabela Usuário.

var query = new [Link]('sys_user');

GlideQuery - agregado (cadeia de caracteres agregadoType,

campo de cadeia de caracteres)

Agrega um campo usando uma função de agregação especificada.

Use este método para criar consultas que agregam em relação a vários
campos ou usam várias funções agregadas ou se você precisar usar o
método groupBy(). Se você quiser agregar apenas em relação a um
campo com uma função e não precisar usar groupBy(), use um destes
métodos:

• média ()

• mín ()

• máx. ()

• contagem ()

PDF gerado em janeiro 24, 2025 9

Parâmetros

Nome Tipo Descrição

O tipo de função de agregação a ser

executada. As opções incluem:

• min: retorna o menor valor de todos os

registros correspondentes.

• max: retorna o maior valor de todos os

Cadeia registros correspondentes.
agregado de
Tipo caractere • sum: retorna a soma de todos os registros
s correspondentes.

• avg: retorna a média de todos os registros

correspondentes.

• count: retorna o número de registros

correspondentes.

Cadeia
de
Assunto: Campo no qual a operação será executada.
caractere
s

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

PDF gerado em janeiro 24, 2025 10

with a "group by" clause.

.aggregate('sum', 'reassignment_count') //Returns ne
w GlideQuery object with a "sum(reassignment_count)" clau
se.
.having('sum', 'reassignment_count', '>', 4) //Return
s new GlideQuery object with a "having reassignment_coun
t > 4" clause.
.select() //Returns a stream of records wrapped in a
Stream object.
.forEach(function (priority){ //Terminal method in th
e Stream class that executes the query and returns the re
sult.
[Link]("Priority " + [Link] + ":
" + [Link].reassignment_count + " reassignments");
});
Saída:
Priority 1: 11 reassignments
Priority 3: 6 reassignments
Priority 5: 5 reassignments

GlideQuery - avg (cadeia de caracteres do campo)

Retorna a média agregada de um determinado campo numérico.

Você só pode usar este método em campos dos seguintes tipos:

• Inteiro

• Longa

• Número de ponto flutuante

• Duplo

• Moeda

Parâmetros

Nome Tipo Descrição

Cadeia
Assunto: Campo no qual a operação será executada.
de

PDF gerado em janeiro 24, 2025 11

Nome Tipo Descrição

caractere
s

Retorna

Tipo Descrição

Objeto que contém a média agregada do campo

Opcional
fornecido.

Exemplo

Este exemplo mostra como retornar o número médio de falhas na tabela

cmdb_ci.

var faults = new [Link]('cmdb_ci')

.avg('fault_count')
.orElse(0);

[Link]([Link](faults));

Saída:

0.0037

GlideQuery - contagem ()

Retorna o número de registros que correspondem à consulta.

Parâmetros

Nome Tipo Descrição

Nenhum

Retorna

Tipo Descrição

Número Número de registros que correspondem à consulta.

PDF gerado em janeiro 24, 2025 12

Exemplo

Este exemplo retorna o número de registros ativos na tabela Usuário.

var userCount = new [Link]('sys_user')

.where('active', true)
.count();

Saída:

612

GlideQuery – deleteMutiple()

Exclui todos os registros na tabela especificada pelas cláusulas Where

anteriores.

Parâmetros

Nome Tipo Descrição

Nenhum

Retorna

Tipo Descrição

Nenhum(a)

Exemplo

Este exemplo exclui todos os registros ativos na tabela Usuário em que o

sobrenome é Jeter.

var query = new [Link]('sys_user')

.where('active', true)
.where('last_name', 'Jeter')
.deleteMultiple();

PDF gerado em janeiro 24, 2025 13

GlideQuery – disableAutoSysFields()

Desabilita a atualização de campos do sistema ou campos com

um nome que começa com o prefixo sys, como sys_created_on,
sys_updated_on e sys_mod_count. Aplica-se somente à consulta
especificada.

Parâmetros

Nome Tipo Descrição

Nenhum

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo adiciona um registro à tabela de tarefas, mas não define

campos do sistema. Sem chamar este método, o exemplo abaixo
atualizaria sys_updated_on, sys_mod_count e assim por diante.

var query = new [Link]('task')

.disableAutoSysFields()
.insert({ description: 'example', priority: 1 });

GlideQuery – disableWorkflow()

Desabilita quaisquer regras de negócio, fluxos, fluxos de trabalho ou

registros de auditoria que seriam executados ou criados como resultado
da consulta.

Parâmetros

Nome Tipo Descrição

Nenhum

PDF gerado em janeiro 24, 2025 14

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo atualiza vários registros na Tabela de tarefas sem acionar

nenhum processo de negócios automático.

var query = new [Link]('task')

.disableWorkflow()
.where('active', true)
.updateMultiple({ priority: 1 });

GlideQuery – forceUpdate()

Força uma atualização do banco de dados mesmo quando nenhuma

mudança de registro é feita. Por exemplo, você pode usar este método
para forçar a execução de uma regra de negócio.

Parâmetros

Nome Tipo Descrição

Nenhum

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo força atualizações de registros de tarefa com um

determinado sys_id.

var forceUpdate = new [Link]('task')

.forceUpdate()

PDF gerado em janeiro 24, 2025 15

.where('sys_id', taskId)
.update()

GlideQuery - get(Chave de cadeia de caracteres, matriz

selectedFields)

Retorna um único registro da consulta.

Parâmetros

Nome Tipo Descrição

Cadeia
de
chave Sys_id do registro a ser retornado.
caractere
s

Opcional. Campos adicionais a serem

retornados no resultado.
selectedFi
Matriz
elds
Padrão: o sistema sempre retorna o sys_id.

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

Exemplo

Exemplo que retorna um registro com base em sys_id.

var user = new [Link]('sys_user')

.get('5137153cc611227c000bbd1bd8cd2005', ['first_name'
, 'last_name']) //Returns an Optional object.
.orElse({ first_name: 'Default', last_name: 'User' })
; //Method in the Optional class to return a default valu
e.

[Link]([Link](user, null, 2));

Saída:

PDF gerado em janeiro 24, 2025 16

{
"sys_id":"5137153cc611227c000bbd1bd8cd2005",
"first_name":"Fred",
"last_name":"Luddy"
}

GlideQuery - getBy (objeto keyValues, matriz selectedFields)

Retorna um objeto opcional que contém um único registro com base

em um conjunto de pares de nome-valor para consulta. Assume o
operador '=' para cada par de nome-valor.

Parâmetros

Nome Tipo Descrição

Objeto em que as chaves são o nome dos

keyValues Objeto campos e os valores são os valores a serem
consultados.

Opcional. Campos adicionais a serem

retornados no resultado.
selectedFi
Matriz
elds
Padrão: o sistema sempre retorna o sys_id.

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

Exemplo

Exemplo que retorna um registro consultando o nome de um usuário.

var user = new [Link]('sys_user')

.getBy({
first_name: 'Fred',
last_name: 'Luddy'
}, ['first_name', 'last_name', 'city', 'active']) // s
elect first_name, last_name, city, active
.orElse({

PDF gerado em janeiro 24, 2025 17

first_name: 'Nobody',
last_name: 'Found',
city: 'Nowhere',
active: false
});

[Link]([Link](user, null, 2));

Saída:

{
"first_name":"Fred",
"last_name":"Luddy",
"city":null,
"active":true,
"sys_id":"5137153cc611227c000bbd1bd8cd2005"
}

GlideQuery - groupBy(campos de cadeia de caracteres)

Agrupa os resultados da consulta por um campo ou campos

designados.

Você deve usar este método com o método agregado().

Parâmetros

Nome Tipo Descrição

Cadeia
de
caractere
s ou matriz
Campo ou campos para agrupar os
campos de
resultados.
cadeias
de
caractere
s

PDF gerado em janeiro 24, 2025 18

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo
Este script executa uma consulta na Tabela de tarefas, agrupa os
registros por prioridade e retorna cada prioridade que tem um total de
reatribuições maior que quatro.
var query = new [Link]('task')
.where('active', true) //Returns new GlideQuery objec
t with a "where" clause.
.groupBy('priority') //Returns new GlideQuery object
with a "group by" clause.
.aggregate('sum', 'reassignment_count') //Returns ne
w GlideQuery object with a "sum(reassignment_count)" clau
se.
.having('sum', 'reassignment_count', '>', 4) //Return
s new GlideQuery object with a "having reassignment_coun
t > 4" clause.
.select() //Returns a stream of records wrapped in a
Stream object.
.forEach(function (priority){ //Terminal method in th
e Stream class that executes the query and returns the re
sult.
[Link]("Priority " + [Link] + ":
" + [Link].reassignment_count + " reassignments");
});
Saída:
Priority 1: 11 reassignments
Priority 3: 6 reassignments
Priority 5: 5 reassignments

GlideQuery - tendo (cadeia de caracteres agregadoType, campo

de cadeia de caracteres, operador de cadeia de caracteres,
valor numérico)

Os filtros agregam grupos para que você possa exibir somente grupos de
resultados que correspondam a uma condição especificada.

PDF gerado em janeiro 24, 2025 19

Deve usar este método com os métodos agregado() ou groupBy().

Parâmetros

Nome Tipo Descrição

O tipo de função de agregação a ser

executada. As opções incluem:

• min: retorna o menor valor de todos os

registros correspondentes.

• max: retorna o maior valor de todos os

Cadeia registros correspondentes.
agregado de
Tipo caractere • sum: retorna a soma de todos os registros
s correspondentes.

• avg: retorna a média de todos os registros

correspondentes.

• count: retorna o número de registros

correspondentes.

Cadeia
de
Assunto: Campo no qual a operação será executada.
caractere
s

Operador numérico a ser usado na operação.

As opções incluem:

• >: maior que.

Cadeia
de • <: menor que.
operador
caractere
s • >=: maior ou igual a.

• <=: menor ou igual a.

• =: igual a.

PDF gerado em janeiro 24, 2025 20

Nome Tipo Descrição

• !=: diferente de.

valor Número Valor numérico a ser usado na operação.

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

PDF gerado em janeiro 24, 2025 21

GlideQuery - insert(KeyValues do objeto, selectedFields do

objeto)

Insere um registro e retorna um objeto opcional que contém o registro.

Parâmetros

Nome Tipo Descrição

Objeto que contém pares de nome-valor

keyValues Objeto a serem inseridos no registro. Campos não
especificados serão nulos.

Opcional. Campos adicionais a serem

retornados no resultado.
selectedFi
Matriz
elds
Padrão: o sistema sempre retorna o sys_id.

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

Exemplo

Este exemplo mostra como inserir um registro com base no nome e no

sobrenome de um usuário.

var fred = new [Link]('sys_user')

.insert({ first_name: 'Fred', last_name: 'Luddy' })
.get();

[Link]([Link](fred, null, 2));

Saída:

{
"sys_id":"cf16eed0e82a9010f8778bda83d255d2",
"first_name":"Fred",

PDF gerado em janeiro 24, 2025 22

"last_name":"Luddy"
}

GlideQuery - insertOrUpdate(Objeto muda, Objeto selectedFields)

Atualiza um registro existente ou insere um novo registro, caso ainda não

exista.

Parâmetros

Nome Tipo Descrição

mudança Objeto que contém pares de nome-valor a

Objeto
s serem atualizados ou inseridos no registro.

Opcional. Campos adicionais a serem

retornados no resultado.
selectedFi
Matriz
elds
Padrão: o sistema sempre retorna o sys_id.

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

Exemplo

Este exemplo mostra como inserir um novo registro que ainda não existe
no sistema.

// insert a new record

var user = new GlideQuery('sys_user')
.insertOrUpdate({
first_name: 'George',
last_name: 'Griffey'
})
.orElse(null);

Exemplo

Este exemplo mostra como atualizar um registro existente.

PDF gerado em janeiro 24, 2025 23

// update existing record

var user = new [Link]('sys_user')
.insertOrUpdate({
sys_id: '2d0efd6c73662300bb513198caf6a72e',
first_name: 'George',
last_name: 'Griffey' })
.orElse(null);

GlideQuery - limit (limite de número)

Limita o número de registros retornados em uma consulta.

Parâmetros

Nome Tipo Descrição

limite Número Número de registros a serem retornados.

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como limitar os resultados retornados a cinco

registros.

var incidents = new [Link]('incident')

.limit(5)
.select('priority', 'description')
.forEach(function (incident){
[Link]([Link](incident, null, 2));
});

Saída:

*** Script: {
"priority": 1,
"description": "User can't get to any of his files on th
e file server.",

PDF gerado em janeiro 24, 2025 24

"sys_id": "9d385017c611228701d22104cc95c371"
}
*** Script: {
"priority": 1,
"description": "I just moved from floor 2 to floor 3 and
my laptop cannot connect to any wireless network.",
"sys_id": "e8caedcbc0a80164017df472f39eaed1"
}
*** Script: {
"priority": 1,
"description": "User forgot their email password.",
"sys_id": "9d3c1197c611228701cd1d94bc32d76d"
}
*** Script: {
"priority": 1,
"description": "When I try to print, my whole computer
just freezes and stops working.",
"sys_id": "8d6246c7c0a80164012fb063cecd4ace"
}
*** Script: {
"priority": 3,
"description": "Unable to login even though login crede
ntials are correct.",
"sys_id": "a9e30c7dc61122760116894de7bcc7bd"
}

GlideQuery - max (campo de cadeia de caracteres)

Retorna o máximo agregado de um determinado campo.

Parâmetros

Nome Tipo Descrição

Cadeia
de
Assunto: Campo no qual a operação será executada.
caractere
s

PDF gerado em janeiro 24, 2025 25

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

Exemplo

Este exemplo mostra como retornar o valor máximo, ou o valor

alfanumérico mais alto, de um determinado campo.

var name = new [Link]('sys_user')

.max('last_name')
.orElse('');

[Link]([Link](name));

Saída:

"Zortman"

GlideQuery - min (cadeia de caracteres do campo)

Retorna o mínimo agregado de um determinado campo.

Parâmetros

Nome Tipo Descrição

Cadeia
de
Assunto: Campo no qual a operação será executada.
caractere
s

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

PDF gerado em janeiro 24, 2025 26

Exemplo

Este exemplo mostra como retornar o valor mínimo, ou o valor

alfanumérico mais baixo, de um determinado campo.

var name = new [Link]('sys_user')

.min('last_name')
.orElse('');

[Link]([Link](name));

Saída:

"Abel"

GlideQuery - orderBy(campos de cadeia de caracteres)

Ordena o resultado retornado em ordem crescente por um determinado

campo.

Parâmetros

Nome Tipo Descrição

Cadeia
de Campos delimitados por vírgulas para ordenar
campos
caractere o resultado em ordem crescente.
s

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como ordenar os resultados em ordem crescente

por número de registro.

var query = new [Link]('incident')

.orderBy('number')

PDF gerado em janeiro 24, 2025 27

.limit(5)
.select('number', 'description') //Returns a stream o
f records wrapped in a Stream object.
.forEach(function (incident){ //Terminal method in th
e Stream class that executes the query and returns the re
sult.
[Link]([Link](incident, null, 2));
});

Saída:

*** Script: {
"number": "INC0000001",
"description": "User can't access email on [Link]
.com.",
"sys_id": "9c573169c611228700193229fff72400"
}
*** Script: {
"number": "INC0000002",
"description": "User can't get to any of his files on th
e file server.",
"sys_id": "9d385017c611228701d22104cc95c371"
}
*** Script: {
"number": "INC0000003",
"description": "I just moved from floor 2 to floor 3 and
my laptop cannot connect to any wireless network.",
"sys_id": "e8caedcbc0a80164017df472f39eaed1"
}
*** Script: {
"number": "INC0000004",
"description": "User forgot their email password.",
"sys_id": "9d3c1197c611228701cd1d94bc32d76d"
}
*** Script: {
"number": "INC0000005",
"description": "CPU was 100% busy for more than 10 minu
tes",
"sys_id": "e8e875b0c0a80164009dc852b4d677d5"
}

PDF gerado em janeiro 24, 2025 28

GlideQuery - orderByDesc(cadeia de caracteres

fieldOrAggregate, campo de cadeia de caracteres)

Ordena o resultado retornado em ordem decrescente por um

determinado campo.

Parâmetros

Nome Tipo Descrição

Se a consulta não usar o método agregado(),

passe o campo para ordenar os resultados.

Se a consulta usar o método agregado(),

passe o tipo de função de agregação a ser
executada.

As opções incluem:

• min: retorna o menor valor de todos os

Cadeia registros correspondentes.
fieldOrAg de
gregate caractere • max: retorna o maior valor de todos os
s registros correspondentes.

• sum: retorna a soma de todos os registros

correspondentes.

• avg: retorna a média de todos os registros

correspondentes.

• count: retorna o número de registros

correspondentes.

Cadeia
Opcional. Campo para ordenar o resultado
de
Assunto: em ordem decrescente. Necessário para
caractere
consultas que usam o método agregado().
s

PDF gerado em janeiro 24, 2025 29

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como ordenar o resultado em ordem decrescente

por número.

var query = new [Link]('incident')

.orderByDesc('number')
.limit(5)
.select('number', 'description') //Returns a stream o
f records wrapped in a Stream object.
.forEach(function (incident){ //Terminal method in th
e Stream class that executes the query and returns the re
sult.
[Link]([Link](incident, null, 2));
});

Saída:

*** Script: {
"number": "INC0009009",
"description": "Unable to access the shared folder. Ple
ase provide access.",
"sys_id": "57af7aec73d423002728660c4cf6a71c"
}
*** Script: {
"number": "INC0009005",
"description": "Unable to send or receive emails.",
"sys_id": "ed92e8d173d023002728660c4cf6a7bc"
}
*** Script: {
"number": "INC0009004",
"description": "While launching the defect tracking bas
e URL, it is redirecting to an error page.",
"sys_id": "e329de99731423002728660c4cf6a73c"
}
*** Script: {

PDF gerado em janeiro 24, 2025 30

"number": "INC0009003",
"description": "Having an issue with users trying to ac
cess the company portal app",
"sys_id": "9fffc328731823002728660c4cf6a742"
}
*** Script: {
"number": "INC0009002",
"description": "My computer is not detecting the headph
one device. It could be an issue with the USB port.",
"sys_id": "1c832706732023002728660c4cf6a7b9"
}

Exemplo

Este exemplo mostra como solicitar um resultado agregado pela soma

de incidentes secundários.

var aggQuery = new GlideQuery('incident')

.aggregate('sum', 'child_incidents')
.groupBy('category')
.orderByDesc('sum', 'child_incidents')
.select()
.forEach(function (category){
[Link]([Link](category, null, 2));
});

Saída:

*** Script: {
"group": {
"category": "hardware"
},
"sum": {
"child_incidents": 2
}
}
*** Script: {
"group": {
"category": "inquiry"
},
"sum": {
"child_incidents": 1
}

PDF gerado em janeiro 24, 2025 31

}
*** Script: {
"group": {
"category": "software"
},
"sum": {
"child_incidents": 0
}
}
*** Script: {
"group": {
"category": ""
},
"sum": {
"child_incidents": null
}
}
*** Script: {
"group": {
"category": "database"
},
"sum": {
"child_incidents": null
}
}
*** Script: {
"group": {
"category": "network"
},
"sum": {
"child_incidents": null
}
}

GlideQuery - orNow (cadeia de caracteres fieldOrQuery,

operador de cadeia de caracteres, qualquer valor)

Adiciona uma cláusula OR a uma consulta que retorna valores com

base em uma determinada condição.

Nota: Preceda este método com os métodos Where( ),

WhereNull()ou WhereNotNull().

PDF gerado em janeiro 24, 2025 32

Parâmetros

Nome Tipo Descrição

Cadeia
Campo ou outro objeto GlideQuery usado
de
na cláusula Where. Se estiver passando um
campoOu caractere
campo, você pode fazer referência com
Consulta s ou
pontos até um valor desejado. Por exemplo,
GlideQuer
'[Link]'.
y

Cadeia Opcional. Operador usado na cláusula OR.

de Se você não passar um argumento, o sistema
operador
caractere usará o operador =. Você não precisa incluir
s um valor de espaço reservado.

valor Qualquer Valor usado na cláusula OR.

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como adicionar uma cláusula OR simples a uma

consulta.

var query = new [Link]('sys_user')

.where('failed_attempts', '>', 0)
.orWhere('last_login', '<', '2019-04-15')
.select()
.forEach(function (user){
[Link]([Link](user, null, 2));
});

Saída:

*** Script: {
"sys_id": "005d500b536073005e0addeeff7b12f4"
}

PDF gerado em janeiro 24, 2025 33

*** Script: {
"sys_id": "d999e5fc77e72300454792718a10611d"
}
*** Script: {
"sys_id": "30ad318577ab2300454792718a10619e"
}
*** Script: {
"sys_id": "4ac73ecd738123002728660c4cf6a72c"
}
*** Script: {
"sys_id": "3883f4c0730123002728660c4cf6a754"
}
*** Script: {
"sys_id": "3988a3ca732023002728660c4cf6a757"
}
*** Script: {
"sys_id": "8ff5b254b33213005e3de13516a8dcf7"
}

Exemplo

Este exemplo mostra como adicionar uma cláusula orNow que contém
uma consulta separada.

// active = true OR (title = 'Vice President' AND state

= 'CA')
var query = new GlideQuery('sys_user')
.where('active', true)
.orWhere(new GlideQuery()
.where('title', 'Vice President')
.where('state', 'CA'))
.select('name')
.limit(5)
.forEach(function (user){
[Link]([Link](user, null, 2));
});

Saída:

*** Script: {
"name": "ITIL User",
"sys_id": "681b365ec0a80164000fb0b05854a0cd"
}

PDF gerado em janeiro 24, 2025 34

*** Script: {
"name": "SOAP Guest",
"sys_id": "155699460a0a0b2b009e27c10b7f68f6"
}
*** Script: {
"name": "System Administrator",
"sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
"name": "Alva Pennigton",
"sys_id": "ca826bf03710200044e0bfc8bcbe5d89"
}
*** Script: {
"name": "Benchmark Scheduler",
"sys_id": "d3383a875b0132003d1c484c11f91a5b"
}

GlideQuery - orNowNotNull(campo de cadeia de caracteres)

Adiciona uma cláusula OR que retorna registros que não contêm um

valor nulo em um determinado campo.

Nota: Preceda este método com os métodos Where( ),

WhereNull()ou WhereNotNull().

Parâmetros

Nome Tipo Descrição

Cadeia
de
Assunto: Campo usado na consulta.
caractere
s

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

PDF gerado em janeiro 24, 2025 35

Exemplo

Este exemplo mostra como consultar a tabela Usuário e retornar

resultados em que o nome ou o sobrenome não sejam nulos.

var query = new [Link]('sys_user')

.whereNotNull('first_name')
.orWhereNotNull('last_name')
.select('name')
.limit(5)
.forEach(function (user){
[Link]([Link](user, null, 2));
});

Saída:

*** Script: {
"name": "ITIL User",
"sys_id": "681b365ec0a80164000fb0b05854a0cd"
}
*** Script: {
"name": "System Administrator",
"sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
"name": "Alva Pennigton",
"sys_id": "ca826bf03710200044e0bfc8bcbe5d89"
}
*** Script: {
"name": "Benchmark Scheduler",
"sys_id": "d3383a875b0132003d1c484c11f91a5b"
}
*** Script: {
"name": "Allyson Gillispie",
"sys_id": "06826bf03710200044e0bfc8bcbe5d8a"
}

GlideQuery - orNowNull(campo de cadeia de caracteres)

Adiciona uma cláusula OR a uma consulta que retorna registros que

contêm um valor nulo em um determinado campo.

PDF gerado em janeiro 24, 2025 36

Nota: Preceda este método com os métodos Where( ),

WhereNull()ou WhereNotNull().

Parâmetros

Nome Tipo Descrição

Cadeia
de
Assunto: Campo usado na consulta.
caractere
s

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como consultar a tabela Usuário e retornar registros

em que o nome ou o sobrenome são nulos.

var query = new [Link]('sys_user')

.whereNull('last_name')
.orWhereNull('first_name')
.select('first_name', 'last_name')
.forEach(function (user){
[Link]([Link](user, null, 2));
});

Saída:

PDF gerado em janeiro 24, 2025 37

}
*** Script: {
"first_name": null,
"last_name": "Guest",
"sys_id": "5136503cc611227c0183e96598c4f706"
}
*** Script: {
"first_name": "ml_report.user",
"last_name": null,
"sys_id": "b6bad6c5c73003005f1b78d48b97632a"
}

GlideQuery - parse(cadeia de caracteres tabela, cadeia de

caracteres encoded_query )

Adiciona uma consulta codificada a uma nova consulta GlideQuery.

Este método não é compatível com todos os operadores de consulta

codificada com GlideRecord. Os seguintes operadores são compatíveis
no momento:

QUALQUER
= GT_FIELD NÃO EM
COISA

FIELD_OR_Equals_G
!= ENTRE NÃO GOSTOU
T

> CONTÉM EM NSAMEAS

>= NÃO CONTÉM INSTÂNCIADE LIGADO

< DINÂMICO CURTIR SAMEAS

<= STRING VAZIO LT_FIELD COMEÇA COM

TERMINACOM LT_OU_IGUAL_CAMPO

PDF gerado em janeiro 24, 2025 38

Parâmetros

Nome Tipo Descrição

Cadeia
de Tabela a ser consultada, como tarefa ou
tabela
caracter incidente.
es

Cadeia
encoded_ de Consulta codificada a ser aplicada aos
query caracter registros na tabela especificada.
es

Retorna

Tipo Descrição

Objeto GlideQuery que contém a consulta

GlideQuery
codificada.

Exemplo

O exemplo a seguir cria um objeto GlideQuery que contém todos

os registros ativos na tabela de tarefas, ordenados pelo campo de
prioridade, retornado como um objeto Stream que contém apenas o
campo de descrição.

[Link]('task', 'active=true^ORDERBYpriority') /
/ Pass the encoded query to use to parse the Task records
.select('description') // Return the records that matc
h the encoded query
.forEach(doSomething); // Do some processing on each o
f the returned records

GlideQuery - select(campos de cadeia de caracteres)

Retorna os resultados da consulta como um objeto de fluxo que contém

os campos especificados.

PDF gerado em janeiro 24, 2025 39

Nota: Use um método de terminal na classe Stream para obter o

resultado da consulta. Para obter mais informações, consulte Fluxo.

Você pode anexar um sinalizador a um nome de campo para retornar

os metadados do campo em vez do valor do campo. Por exemplo, usar
o nome de campo company$DISPLAY retorna o valor de exibição de
um campo de empresa. Os possíveis sinalizadores incluem:

• DISPLAY: retorna o valor de exibição de um campo.

• CURRENCY_CODE: retorna o código da moeda de um campo de

moeda. Por exemplo, USD.

• CURRENCY_DISPLAY: retorna o valor de exibição da moeda de um

campo de moeda. Por exemplo, JPY 123,45.

• CURRENCY_STRING: retorna a cadeia de caracteres de moeda de um

campo de moeda. Por exemplo, JPY;123.45.

Parâmetros

Nome Tipo Descrição

Opcional. Campos a serem exibidos no

resultado. Você pode fornecer qualquer
número de campos como argumentos,
Cadeia referência com pontos até um valor desejado
de ou usar um sinalizador. Por exemplo:
caractere
s ou matriz select('first_name', '[Link]'
campos de , 'company$DISPLAY');
cadeias ou
de
caractere select(['first_name', '[Link]'
s , 'company$DISPLAY']);

Padrão: o sistema sempre retorna o sys_id.

PDF gerado em janeiro 24, 2025 40

Retorna

Tipo Descrição

Objeto usado para interagir com um fluxo de itens,

Fluxo
como registros.

Exemplo

Este exemplo mostra como selecionar campos a serem exibidos na

consulta e usar $ DISPLAY para retornar o valor de exibição de um
campo.

var stream = new [Link]('sys_user')

.select('first_name', 'last_name', 'company$DISPLAY')
.limit(5)
.forEach(function (user){
[Link]([Link](user, null, 2));
});

Saída:

*** Script: {
"first_name": "System",
"last_name": "Administrator",
"company$DISPLAY": "",
"sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
"first_name": "Alva",
"last_name": "Pennigton",
"company$DISPLAY": "ACME North America",
"sys_id": "ca826bf03710200044e0bfc8bcbe5d89"
}
*** Script: {
"first_name": "Benchmark",
"last_name": "Scheduler",
"company$DISPLAY": "",
"sys_id": "d3383a875b0132003d1c484c11f91a5b"
}
*** Script: {
"first_name": "Allyson",

PDF gerado em janeiro 24, 2025 41

"last_name": "Gillispie",
"company$DISPLAY": "ACME North America",
"sys_id": "06826bf03710200044e0bfc8bcbe5d8a"
}
*** Script: {
"first_name": "SOAP",
"last_name": "Guest",
"company$DISPLAY": "",
"sys_id": "155699460a0a0b2b009e27c10b7f68f6"
}

GlideQuery - selectOne(campos de cadeia de caracteres)

Retorna o resultado da consulta como um objeto opcional que contém

os campos especificados.

Use este método ao retornar um único registro ou para testar se existe

um registro. Se estiver retornando vários registros, use o método select()
para retornar um objeto Stream.

Você pode anexar um sinalizador a um nome de campo para retornar

os metadados do campo em vez do valor do campo. Por exemplo, usar
o nome de campo company$DISPLAY retorna o valor de exibição de
um campo de empresa. Os possíveis sinalizadores incluem:

• DISPLAY: retorna o valor de exibição de um campo.

• CURRENCY_CODE: retorna o código da moeda de um campo de

moeda. Por exemplo, USD.

• CURRENCY_DISPLAY: retorna o valor de exibição da moeda de um

campo de moeda. Por exemplo, JPY 123,45.

• CURRENCY_STRING: retorna a cadeia de caracteres de moeda de um

campo de moeda. Por exemplo, JPY;123.45.

Parâmetros

Nome Tipo Descrição

Cadeia Opcional. Campos a serem exibidos no

campos de resultado. Você pode fornecer qualquer
caractere número de campos como argumentos,

PDF gerado em janeiro 24, 2025 42

Nome Tipo Descrição

referência com pontos até um valor desejado
ou usar um sinalizador. Por exemplo:

s ou matriz selectOne('first_name', '[Link]

de y', 'company$DISPLAY');
cadeias ou
de
caractere selectOne(['first_name', '[Link]
s ty', 'company$DISPLAY']);

Padrão: o sistema sempre retorna o sys_id.

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

Exemplo

Este exemplo mostra como retornar um único registro como um objeto

opcional e exibir os campos especificados.

var user = new [Link]('sys_user')

.where('zip', '12345')
.whereNotNull('last_name')
.selectOne('first_name', 'last_name', 'company$DISPLAY
')
.get();

[Link]([Link](user, null, 2));

Saída:

{
"first_name":"Abel",
"last_name":"Tuter",
"company$DISPLAY":"ACME South America",
"sys_id":"62826bf03710200044e0bfc8bcbe5df1"
}

PDF gerado em janeiro 24, 2025 43

GlideQuery - soma (cadeia de caracteres do campo)

Retorna a soma agregada de um determinado campo numérico.

Você só pode usar este método em campos dos seguintes tipos:

• Inteiro

• Longa

• Número de ponto flutuante

• Duplo

• Moeda

Parâmetros

Nome Tipo Descrição

Cadeia
de
Assunto: Campo no qual a operação será executada.
caractere
s

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

Exemplo

Este exemplo mostra como retornar a soma de todas as falhas na tabela

cmdb_ci.

var totalFaults = new [Link]('cmdb_ci')

.sum('fault_count')
.orElse(0);

[Link]([Link](totalFaults));

Saída:

PDF gerado em janeiro 24, 2025 44

GlideQuery – toGlideRecord()

Retorna um objeto GlideRecord que representa a consulta atual.

Retorna um objeto GlideAggregate se a consulta usar o método
[Link]().

Depois de transformar a consulta, use o método query() nas classes

GlideRecord ou GlideAggregate para consultar o banco de dados.

Parâmetros

Nome Tipo Descrição

Nenhum

Retorna

Tipo Descrição

Objeto GlideRecord que contém a consulta. Se

GlideRecord ou
você usou o método [Link](), o
GlideAggregate
método retornará um objeto GlideAggregate.

Exemplo

Este exemplo mostra como transformar um objeto GlideQuery em um

GlideRecord.

var userGr = new [Link]('sys_user')

.where('active', true)
.whereNotNull('first_name')
.limit(10)
.toGlideRecord();
[Link]();

GlideQuery - update(Objeto muda, Objeto selectedFields)

Atualiza um registro existente que corresponde às condições definidas.

Antes de usar este método, chame o método Where () para especificar

as condições que um registro deve atender para ser atualizado.

PDF gerado em janeiro 24, 2025 45

Parâmetros

Nome Tipo Descrição

Objeto que contém pares de nome-valor

mudança
Objeto a serem atualizados no registro. Os nomes
s
devem corresponder aos campos na tabela.

Opcional. Campos adicionais a serem

retornados no resultado.
selectedFi
Matriz
elds
Padrão: o sistema sempre retorna o sys_id.

Retorna

Tipo Descrição

Opcional Objeto usado para interagir com um único registro.

Exemplo

Este exemplo mostra como atualizar um registro com novos valores.

var updateRecord = new [Link]('sys_user')

.where('sys_id', '0a826bf03710200044e0bfc8bcbe5d7a')
.update({ city: 'Los Angeles' });

GlideQuery - updateMutiple(mudanças de objeto)

Atualiza todos os registros existentes que correspondem às condições

definidas. Retorna o número de registros atualizados.

Antes de usar este método, chame o método Where () para especificar

as condições que os registros devem atender para serem atualizados.

PDF gerado em janeiro 24, 2025 46

Parâmetros

Nome Tipo Descrição

Objeto que contém pares de nome-valor

mudança
Objeto a serem atualizados no registro. Os nomes
s
devem corresponder aos campos na tabela.

Retorna

Tipo Descrição

Objeto que contém o número de registros que foram

atualizados. As chaves incluem:
Objeto
• rowCount: número de linhas atualizadas na tabela.

Exemplo

Este exemplo mostra como atualizar todos os registros que se encaixam

em critérios definidos.

var update = new [Link]('sys_user')

.where('active', false)
.where('last_name', 'Griffey')
.updateMultiple({ active: true });

[Link]([Link](update));

Saída:

{"rowCount":1}

GlideQuery - onde (cadeia de caracteres fieldOrQuery, operador

de cadeia de caracteres, qualquer valor)

Adiciona uma cláusula Where à consulta que retorna valores com base
em uma determinada condição.

PDF gerado em janeiro 24, 2025 47

Nota: Não preceda este método com os métodos orNow(),

orNowNull()ou orNowNotNull().

Parâmetros

Nome Tipo Descrição

Cadeia
Opcional. Operador usado na cláusula
de
operador "where". Se você não passar um argumento,
caractere
o sistema usará o operador =.
s

valor Qualquer Valor usado na cláusula Where.

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como retornar registros da tabela Usuário em

que ativo é verdadeiro e o último login do usuário é após uma data
especificada.

var query = new [Link]('sys_user')

.where('active', true)
.where('last_login', '>', '2018-01-01')
.limit(5)
.select()
.forEach(function (user){
[Link]([Link](user, null, 2));
});

PDF gerado em janeiro 24, 2025 48

Saída:

*** Script: {
"sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
"sys_id": "005d500b536073005e0addeeff7b12f4"
}
*** Script: {
"sys_id": "d999e5fc77e72300454792718a10611d"
}
*** Script: {
"sys_id": "30ad318577ab2300454792718a10619e"
}
*** Script: {
"sys_id": "3883f4c0730123002728660c4cf6a754"
}

Exemplo

Este exemplo mostra como retornar registros da tabela Incidente em que

ativo é verdadeiro e a prioridade ou gravidade é 1.

// active = true AND (priority = 1 OR severity = 1)

var query = new GlideQuery('incident')
.where('active', true)
.where(new GlideQuery()
.where('priority', 1)
.orWhere('severity', 1))
.limit(5)
.select()
.toArray(5)

[Link]([Link](query, null, 2));

Saída:

[
{
"sys_id":"b0f31e5673500010c2e7660c4cf6a711"
},
{
"sys_id":"8ff5b254b33213005e3de13516a8dcf7"

PDF gerado em janeiro 24, 2025 49

},
{
"sys_id":"d999e5fc77e72300454792718a10611d"
},
{
"sys_id":"30ad318577ab2300454792718a10619e"
},
{
"sys_id":"3883f4c0730123002728660c4cf6a754"
}
]

GlideQuery - WhereNotNull(cadeia de caracteres do campo)

Retorna registros que não contêm um valor nulo em um determinado

campo.

Nota: Não preceda este método com os métodos orNow(),

orNowNull()ou orNowNotNull().

Parâmetros

Nome Tipo Descrição

Cadeia
de
Assunto: Campo usado na consulta.
caractere
s

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como consultar a tabela Usuário e retornar

resultados em que o campo first_name não é nulo.

var query = new [Link]('sys_user')

.whereNotNull('first_name')

PDF gerado em janeiro 24, 2025 50

.select('name')
.limit(5)
.forEach(function (user){
[Link]([Link](user, null, 2));
});

Saída:

*** Script: {
"name": "System Administrator",
"sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
"name": "Alva Pennigton",
"sys_id": "ca826bf03710200044e0bfc8bcbe5d89"
}
*** Script: {
"name": "Benchmark Scheduler",
"sys_id": "d3383a875b0132003d1c484c11f91a5b"
}
*** Script: {
"name": "Allyson Gillispie",
"sys_id": "06826bf03710200044e0bfc8bcbe5d8a"
}
*** Script: {
"name": "SOAP Guest",
"sys_id": "155699460a0a0b2b009e27c10b7f68f6"
}

GlideQuery - WhereNull(cadeia de caracteres campo)

Retorna registros que contêm um valor nulo em um determinado

campo.

Nota: Não preceda este método com os métodos orNow(),

orNowNull()ou orNowNotNull().

Parâmetros

Nome Tipo Descrição

Cadeia
Assunto: Campo usado na consulta.
de

PDF gerado em janeiro 24, 2025 51

Nome Tipo Descrição

caractere
s

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como consultar a tabela Usuário e retornar registros

em que o nome ou o sobrenome são nulos.

var query = new [Link]('sys_user')

.whereNull('last_name')
.orWhereNull('first_name')
.select('first_name', 'last_name')
.forEach(function (user){
[Link]([Link](user, null, 2));
});

Saída:

*** Script: {
"first_name": "[Link]",
"last_name": null,
"sys_id": "88aad6c5c73003005f1b78d48b9763a5"
}
*** Script: {
"first_name": "Sitemap Scheduler User",
"last_name": null,
"sys_id": "85388c25b71011104eed4643ae11a993"
}
*** Script: {
"first_name": null,
"last_name": "Guest",
"sys_id": "5136503cc611227c0183e96598c4f706"
}
*** Script: {
"first_name": "ml_report.user",

PDF gerado em janeiro 24, 2025 52

"last_name": null,
"sys_id": "b6bad6c5c73003005f1b78d48b97632a"
}

GlideQuery - withAcls()

Executa a consulta usando a API GlideRecordSecure para consultar o

banco de dados com segurança e respeitando as ACLs.

Parâmetros

Nome Tipo Descrição

Nenhum

Retorna

Tipo Descrição

GlideQuery O objeto de consulta que está sendo criado.

Exemplo

Este exemplo mostra como executar uma consulta segura usando ACLs.

var users = new [Link]('sys_user')

.withAcls()
.limit(5)
.orderByDesc('first_name')
.select('first_name')
.forEach(function (user){
[Link]([Link](user, null, 2));
});

Saída:

*** Script: {
"first_name": "Zane",
"sys_id": "16826bf03710200044e0bfc8bcbe5dbc"
}
*** Script: {
"first_name": "Zackary",

PDF gerado em janeiro 24, 2025 53

"sys_id": "8a826bf03710200044e0bfc8bcbe5d69"
}
*** Script: {
"first_name": "Yvette",
"sys_id": "4e826bf03710200044e0bfc8bcbe5d57"
}
*** Script: {
"first_name": "Winnie",
"sys_id": "f682abf03710200044e0bfc8bcbe5d1d"
}
*** Script: {
"first_name": "Wilmer",
"sys_id": "42826bf03710200044e0bfc8bcbe5d7b"
}