---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideQueryCondition - Global

# GlideQueryCondition - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

A API GlideQueryCondition fornece condições `AND` ou `OR` adicionais que podem ser adicionadas à condição atual, permitindo que você crie consultas complexas.  
Crie consultas complexas, como:

    category='hardware' OR category='software' AND priority='2' AND priority='1'

No caso de addCondition(), um `E` implícito é adicionado.  
Esta classe não tem construtor. Um objeto GlideQueryCondition é retornado pelos seguintes métodos:

* addActiveQuery()
* addInactiveQuery()
* addJoinQuery()
* addNotNullQuery()
* addNullQuery()
* adicionarConsulta()
{#c_GlideQueryConditionAPI__ul_xyz_nsg_qz}

Se houver um conjunto complexo de consultas `AND` e `OR`, uma única consulta codificada contendo todas as condições simplificará a criação da consulta. Para simplificar a criação da consulta, crie uma consulta em uma exibição de lista, clique com o botão direito do mouse na consulta e selecione Copiar consulta. Ele cria uma única cadeia de caracteres de consulta codificada para retornar seu conjunto de resultados. Use essa cadeia de caracteres como um parâmetro em uma chamada de método addEncodedQuery().

Sempre teste consultas em uma instância de subprodução antes de implantá-las em uma instância de produção. Uma consulta codificada construída incorretamente, como a inclusão de um nome de campo inválido, produz uma consulta inválida. Quando a consulta inválida é executada, a parte inválida da condição de consulta é descartada e os resultados são baseados na parte válida da consulta, que pode retornar todos os registros da tabela. Usar um método insert(), update(), deleteRecord( )ou deleteMutiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a propriedade do sistema glide.invalid_query.returns_no_rows como verdadeira para que as consultas com consultas codificadas inválidas não retornem registros. Em alguns casos, a consulta ainda pode retornar registros nos resultados da API, mesmo quando glide.invalid_query.returns_no_rows está definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Nessas consultas, o operador WHERE ignora os termos inválidos, mas ainda interpreta e retorna o restante da declaração de consulta. Para obter mais informações sobre esta propriedade do sistema e sua funcionalidade, consulte [Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

## GlideQueryCondition - addCondition(cadeia de caracteres nome, cadeia de caracteres oper, valor do objeto) {#ariaid-title2}

Adiciona uma condição E à condição atual.
{#GQC-addCondition_S_S_O__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | O nome de um campo. |
| operador | Cadeia de caracteres | (Opcional) O operador da consulta. Se você não especificar um operador, a condição usará um operador igual a. |
| valor | Objeto | O valor a ser consultado. |
[Tabela 1. Parâmetros]

{#GQC-addCondition_S_S_O__table_vy2_525_jq}  
{#GQC-addCondition_S_S_O__table_mxx_f5b_2r__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | Uma referência a um GlideQueryConditon que foi adicionado ao GlideRecord. |
[Tabela 2. Retorna]

{#GQC-addCondition_S_S_O__table_mxx_f5b_2r}  

    var now_GR = new GlideRecord('incident');
    var qc = now_GR.addQuery('category', 'Hardware');
    qc.addCondition('category', 'Network');
    now_GR.addQuery('number','INC0000003');
    now_GR.next();
    now_GR.number;
    gs.info(now_GR.getEncodedQuery());

### Equivalente com escopo {#GQC-addCondition_S_S_O__section_cgd_h3n_g1b}

Para usar o método addCondition() em uma aplicação com escopo, use o método com escopo correspondente: [addCondition()](https://servicenow-prod.fluidtopics.net/NnYSmSxrgMgcP2q2sBafSQ#r_ScopedGlideQueryConditionAddCondition "Adiciona uma condição E à condição atual.").

## GlideQueryCondition - addOrCondition(cadeia de caracteres nome, cadeia de caracteres oper, valor do objeto) {#ariaid-title3}

Acrescenta um parâmetro OU condição 2-ou-3 a um GlideQueryCondition existente.
addOrCondition() funciona em conjunto com qualquer um dos métodos [addQuery()](https://servicenow-prod.fluidtopics.net/FBR_zQLvGAsgQtw7~4MAGA#r_ScopedGlideRecordAddQuery_String_String_Object "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação.")para `OR` os parâmetros de consulta especificados para a consulta construída anteriormente usando addQuery().

addOrCondition() é normalmente chamado com três parâmetros; campo de tabela, operador e valor de comparação. Ele pode ser chamado com apenas dois parâmetros, campo da tabela e valor de comparação, como `qc.addOrCondition('category', 'software');`. O operador, neste caso, é considerado "igual a".  
{#GQC-addOrCondition_S_S_O__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo |
| operador | Cadeia de caracteres | (Opcional) Operador de consulta. Os valores disponíveis dependem do tipo de dados do parâmetro de <var class="keyword varname">valor</var>. Números: * = * != * \> * \>= * \< * \<= {#GQC-addOrCondition_S_S_O__ul_qyb_rbt_3y} Cadeias de caracteres (devem estar em maiúsculas): * = * != * IN * COMEÇA COM * TERMINACOM * CONTÉM * NÃOCONTÉM {#GQC-addOrCondition_S_S_O__ul_egz_vbt_3y} |
| valor | Objeto | Valor a ser consultado (sem distinção entre maiúsculas e minúsculas). Nota: Todas as matrizes passadas devem conter no mínimo dois elementos. Matrizes de elemento único não são compatíveis. |
[Tabela 3. Parâmetros]

{#GQC-addOrCondition_S_S_O__table_vy2_525_jq}  
{#GQC-addOrCondition_S_S_O__table_w2h_w2c_2r__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | Uma referência a um GlideQueryConditon que foi adicionado ao GlideRecord. |
[Tabela 4. Retorna]

{#GQC-addOrCondition_S_S_O__table_w2h_w2c_2r}  

    var now_GR = new GlideRecord('incident');
    var qc = now_GR.addQuery('category', 'Hardware');
    qc.addOrCondition('category', 'Network');
    now_GR.addQuery('number','INC0000003');
    now_GR.next();
    now_GR.number;
    gs.info(now_GR.getEncodedQuery());

Para agrupar instruções E/OU como `(estado < 3 OU estado > 5) E (prioridade = 1 OU prioridade = 5)`, use um código semelhante ao seguinte:

    var myObj = new GlideRecord('incident');
    var q1 = myObj.addQuery('state', '<', 3);
    q1.addOrCondition('state', '>', 5);
    var q2 = myObj.addQuery('priority', 1);
    q2.addOrCondition('priority', 5);
    myObj.query();

### Equivalente com escopo {#GQC-addOrCondition_S_S_O__section_cgd_h3n_g1b}

Para usar o método addOrCondition() em uma aplicação com escopo, use o método com escopo correspondente: [addOrCondition()](https://servicenow-prod.fluidtopics.net/NnYSmSxrgMgcP2q2sBafSQ#r_ScopedGlideQueryConditionAddOrCondition "Acrescenta um parâmetro OU condição de dois ou três a um GlideQueryCondition existente.").