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


---

# GlideRecord - Cliente

# GlideRecord - Cliente {#ariaid-title1}

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

A API GlideRecord fornece métodos que executam operações de banco de dados. Esta API permite o uso de algumas funcionalidades do GlideRecord em scripts do lado do cliente, como client scripts e scripts de política de IU.

Um GlideRecord contém registros e campos. As consultas feitas com métodos GlideRecord do lado do cliente são executadas no servidor. Portanto, uma solicitação é feita no navegador do cliente para obter os dados do registro.

A API GlideRecord do lado do cliente não é compatível com aplicações com escopo. Em vez disso, crie uma inclusão de script e use a API [GlideAJAX](https://servicenow-prod.fluidtopics.net/tp~GX8f0bMgLiewtSZeAJA#c_GlideAjaxAPI "A classe GlideAjax permite que um client script chame o código do lado do servidor em uma inclusão de script.") ou use as REST APIs. Além disso, esta API aplica listas de controle de acesso (ACLs) com base nas credenciais do usuário que está executando o script. Para executar o código no servidor sem ACLs, use a API [GlideAjax](https://servicenow-prod.fluidtopics.net/tp~GX8f0bMgLiewtSZeAJA#c_GlideAjaxAPI "A classe GlideAjax permite que um client script chame o código do lado do servidor em uma inclusão de script.").

## GlideRecorddo lado do cliente - GlideRecord(cadeia de caracteres "tableName") {#ariaid-title2}

Cria uma instância da classe GlideRecord para a tabela especificada.
{#r_GRCS-GlideRecord_S__table_c1c_25j_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tableName | Cadeia de caracteres | A tabela a ser usada. |
[Tabela 1. Parâmetros]

{#r_GRCS-GlideRecord_S__table_c1c_25j_3v}  

    var now_GR = new GlideRecord('incident');

## GlideRecorddo lado do cliente -- addOrderBy(coluna de cadeia de caracteres) {#ariaid-title3}

Adiciona uma coluna para ordenar por na consulta.
{#r_GRCS-addOrderBy_S__table_zrw_wjw_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| coluna | Cadeia de caracteres | A coluna pela qual o conjunto de resultados será ordenado. |
[Tabela 2. Parâmetros]

{#r_GRCS-addOrderBy_S__table_zrw_wjw_hv} {#r_GRCS-addOrderBy_S__table_asw_wjw_hv__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 3. Retorna]

{#r_GRCS-addOrderBy_S__table_asw_wjw_hv}

## GlideRecorddo lado do cliente - addQuery (nome da cadeia de caracteres, valor do objeto) {#ariaid-title4}

Adiciona uma consulta para retornar registros em que o nome do campo especificado é igual a um valor especificado (ou está em uma lista de valores).
Se você estiver familiarizado com SQL, este método será semelhante à cláusula "where". Você pode criar uma ou mais consultas para um único filtro chamando este método várias vezes; para este método, as consultas são feitas com AND. Depois de definir todas as consultas desejadas, chame o [GlideRecorddo lado do cliente - query (nome da cadeia de caracteres, responseFunction da função, valor da cadeia de caracteres)](https://servicenow-prod.fluidtopics.net/lsyx8yeo6~cAE_x42rXKug#r_GRCS-query_Function "Executa a consulta ao servidor em relação à tabela com base no filtro addQuery(). Este método consulta a tabela GlideRecord, bem como todas as referências da tabela.") para executar a cláusula de consulta especificada (filtro).

Para executar uma operação diferente de AND, use o [método addQuery(String name, Object Operator, Object value)](https://servicenow-prod.fluidtopics.net/lsyx8yeo6~cAE_x42rXKug#r_GRCS-addQuery_S_O_O "Adiciona um filtro para retornar registros em que o campo atende à condição especificada (campo, operador, valor).") ou o método [setEncodedQuery()](https://servicenow-prod.fluidtopics.net/lsyx8yeo6~cAE_x42rXKug#r_GRCS-setEncodedQuery "Adiciona uma cadeia de caracteres de consulta codificada especificada à cláusula de consulta atual.").
{#r_GRCS-addQuery_S_O__table_rhl_n4v_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo a ser verificado. |
| valor | Objeto | O valor ou a lista de valores a serem consultados. |
[Tabela 4. Parâmetros]

{#r_GRCS-addQuery_S_O__table_rhl_n4v_hv} {#r_GRCS-addQuery_S_O__table_shl_n4v_hv__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 5. Retorna]

{#r_GRCS-addQuery_S_O__table_shl_n4v_hv}  
Exemplo mostrando várias consultas.

    var now_GR = new GlideRecord('incident');
    now_GR.addQuery('priority', 4); // Priority is 4 -- Low and,
    now_GR.addQuery('state', 3); // State is On Hold
    now_GR.query(response);
     
    function response(result) {
        while(result.next()) {
           // Print all INC with priority 4 -- Low AND state is On Hold
            console.log(result.getValue('number')); 
        }
    }

Exemplo que mostra como passar um objeto de cadeia de caracteres.

    var now_GR = new GlideRecord('incident');
    now_GR.addQuery('short_description', new String('USB device not working')); // string object
    now_GR.addQuery('priority', 4); //number
    now_GR.query(response);
     
    function response(result) {
        while(result.next()) {
           // Print all INC with priority 4 -- Low AND short description contains 'USB device not working'
            console.log(result.getValue('number')); 
        }
    }

## GlideRecorddo lado do cliente - addQuery (cadeia de caracteres nome, operador de objeto, valor de objeto) {#ariaid-title5}

Adiciona um filtro para retornar registros em que o campo atende à condição especificada (campo, operador, valor).
Se você estiver familiarizado com SQL, este método será semelhante à cláusula "where". Você pode criar uma ou mais consultas para um único filtro chamando este método várias vezes. Depois de definir todas as consultas desejadas, chame o [GlideRecorddo lado do cliente - query (nome da cadeia de caracteres, responseFunction da função, valor da cadeia de caracteres)](https://servicenow-prod.fluidtopics.net/lsyx8yeo6~cAE_x42rXKug#r_GRCS-query_Function "Executa a consulta ao servidor em relação à tabela com base no filtro addQuery(). Este método consulta a tabela GlideRecord, bem como todas as referências da tabela.") para executar a cláusula de consulta especificada (filtro).

Para criar consultas mais complexas, use o método [setEncodedQuery()](https://servicenow-prod.fluidtopics.net/lsyx8yeo6~cAE_x42rXKug#r_GRCS-setEncodedQuery "Adiciona uma cadeia de caracteres de consulta codificada especificada à cláusula de consulta atual.").
{#r_GRCS-addQuery_S_O_O__table_wgh_cpv_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo a ser verificado. |
| operador | Objeto | Operador de consulta. Os valores disponíveis dependem do tipo de dados do parâmetro de <var class="keyword varname">valor</var>. Números: * = * != * \> * \>= * \< * \<= {#r_GRCS-addQuery_S_O_O__ul_qyb_rbt_3y} Cadeias de caracteres (devem estar em maiúsculas): * = * != * IN * NÃO EM * COMEÇA COM * TERMINACOM * CONTÉM * NÃO CONTÉM * INSTÂNCIADE {#r_GRCS-addQuery_S_O_O__ul_egz_vbt_3y} Nota: Não use o operador LIKE. Em vez disso, use CONTÉM. |
| valor | Objeto | Valor a ser consultado (sem distinção entre maiúsculas e minúsculas). |
[Tabela 6. Parâmetros]

{#r_GRCS-addQuery_S_O_O__table_wgh_cpv_hv} {#r_GRCS-addQuery_S_O_O__table_xgh_cpv_hv__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 7. Retorna]

{#r_GRCS-addQuery_S_O_O__table_xgh_cpv_hv}  
Exemplo que mostra como adicionar várias consultas a um filtro.

    var now_GR = new GlideRecord('incident');
    now_GR.addQuery('priority', '<=', 2); // Priority is 2 or higher and,
    now_GR.addQuery('short_description', 'CONTAINS', 'crash'); // Short description contains the word crash
    now_GR.query(response);
     
    function response(result) {
        while(result.next()) {
           // Print all INC with priority of 2 or higher AND short description contains "crash"
            console.log(result.getValue('number')); 
        }
    }

Exemplo que mostra como passar em uma matriz para verificar várias condições em uma única consulta.

    var priorities = [4,2]; 
    var now_GR = new GlideRecord('incident'); 
    now_GR.addQuery('priority', 'IN', priorities); 
    now_GR.query(response); 

    function response(result) {
      while(result.next()) {
        console.log(result.getValue('number')); 
      } 
    }

## GlideRecorddo lado do cliente - deleteRecord(Function responseFunction) {#ariaid-title6}

Exclui o registro atual e chama a função de resposta especificada quando concluído.
{#r_GRCS-deleteRecord_Function__table_esv_hqv_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| função de resposta | Função | Função de resposta para o retorno de chamada. |
[Tabela 8. Parâmetros]

{#r_GRCS-deleteRecord_Function__table_esv_hqv_hv} {#r_GRCS-deleteRecord_Function__table_fsv_hqv_hv__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 9. Retorna]

{#r_GRCS-deleteRecord_Function__table_fsv_hqv_hv}  
Este exemplo exclui um registro e chama a resposta da função de <var class="keyword varname">resposta</var> para registrar uma mensagem de alerta.

    var recordGR = new GlideRecord('incident');
    if (recordGR.get('99ebb4156fa831005be8883e6b3ee4b9')) {
      recordGR.deleteRecord(response);
    }

    function response(result) {
      alert('Deleted record sys_id: ' + result.getValue('sys_id'));
    }

Saída:

    Deleted record sys_id: 99ebb4156fa831005be8883e6b3ee4b9

## GlideRecorddo lado do cliente - get(cadeia de caracteres sys_id) {#ariaid-title7}

Executa uma consulta GlideRecord para um registro com o sys_id especificado. Espera-se que este método seja usado para consultar registros únicos, portanto, uma próxima operação é executada antes de retornar.
{#r_GRCS-get_O__table_u3j_fhw_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sys_id | Cadeia de caracteres | O sys_id do registro a ser encontrado. |
[Tabela 10. Parâmetros]

{#r_GRCS-get_O__table_u3j_fhw_hv} {#r_GRCS-get_O__table_v3j_fhw_hv__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se um ou mais registros correspondentes forem encontrados. Falso se nenhum registro for encontrado. |
[Tabela 11. Retorna]

{#r_GRCS-get_O__table_v3j_fhw_hv}

## GlideRecorddo lado do cliente -- getEncodedQuery() {#ariaid-title8}

Recupera a condição de consulta do conjunto de resultados atual como uma cadeia de caracteres de consulta codificada.
{#r_GRCS-getEncodedQuery__table_wfk_spv_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 12. Parâmetros]

{#r_GRCS-getEncodedQuery__table_wfk_spv_hv} {#r_GRCS-getEncodedQuery__table_xfk_spv_hv__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Uma cadeia de caracteres de consulta codificada que contém todas as condições que foram adicionadas à consulta. |
[Tabela 13. Retorna]

{#r_GRCS-getEncodedQuery__table_xfk_spv_hv}

## GlideRecorddo lado do cliente -- getLimit() {#ariaid-title9}

Retorna o limite de registros a serem retornados pela consulta GlideRecord.
{#r_GRCS-getLimit__table_pll_qlw_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 14. Parâmetros]

{#r_GRCS-getLimit__table_pll_qlw_hv} {#r_GRCS-getLimit__table_qll_qlw_hv__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O limite de registros a serem retornados pela consulta GlideRecord. |
[Tabela 15. Retorna]

{#r_GRCS-getLimit__table_qll_qlw_hv}

## GlideRecorddo lado do cliente -- getTableName() {#ariaid-title10}

Recupera o nome da tabela associada a este GlideRecord.
{#r_GRCS-getTableName__table_art_5hw_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 16. Parâmetros]

{#r_GRCS-getTableName__table_art_5hw_hv} {#r_GRCS-getTableName__table_brt_5hw_hv__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O nome da tabela |
[Tabela 17. Retorna]

{#r_GRCS-getTableName__table_brt_5hw_hv}  

    var item = new GlideRecord('sc_request'); 
    item.addQuery('sys_id', current.request); 
    item.query(itemResponse); 
     
    function itemResponse(item) {
       alert('The table is ' + item.getTableName());
    }

## GlideRecorddo lado do cliente - hasNext() {#ariaid-title11}

Determina se há mais registros no GlideRecord.
{#r_GRCS-hasNext__table_ejm_m3w_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 18. Parâmetros]

{#r_GRCS-hasNext__table_ejm_m3w_hv} {#r_GRCS-hasNext__table_fjm_m3w_hv__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se houver mais registros no conjunto de consultas. |
[Tabela 19. Retorna]

{#r_GRCS-hasNext__table_fjm_m3w_hv}

## GlideRecorddo lado do cliente - insert(Function responseFunction) {#ariaid-title12}

Insere um novo registro usando os valores de campo que foram definidos para o registro atual.
{#r_GRCS-insert_Function__table_szb_x3w_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| função de resposta | Função | Função a ser executada quando o registro for inserido. |
[Tabela 20. Parâmetros]

{#r_GRCS-insert_Function__table_szb_x3w_hv} {#r_GRCS-insert_Function__table_tzb_x3w_hv__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Sys_id do registro inserido ou nulo se o registro não tiver sido inserido. |
[Tabela 21. Retorna]

{#r_GRCS-insert_Function__table_tzb_x3w_hv}  

    var now_GR = new GlideRecord('incident');
    now_GR.short_description = 'Learn about GlideRecord';
    var recResponse = now_GR.insert(handleResponse);

    function handleResponse(recResponse, answer) {
    // Answer will be the sys_id of the created record or null
    alert('Newly created sys_id is - ' + answer + ' exists');
    }

## GlideRecorddo lado do cliente - next() {#ariaid-title13}

Move para o próximo registro no GlideRecord.
{#r_GRCS-next__table_ldp_jjw_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 22. Parâmetros]

{#r_GRCS-next__table_ldp_jjw_hv} {#r_GRCS-next__table_mdp_jjw_hv__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Falso se não houver mais registros no conjunto de consultas. |
[Tabela 23. Retorna]

{#r_GRCS-next__table_mdp_jjw_hv}  

    var rec = new GlideRecord('incident');
    rec.query(recResponse);
     
    function recResponse(rec) {
      while (rec.next()) { 
        alert(rec.number + ' exists');
      }
    }

## GlideRecorddo lado do cliente - orderBy(coluna de cadeia de caracteres) {#ariaid-title14}

Especifica uma coluna orderBy. Pode ser chamado mais de uma vez para ordenar por várias colunas.
{#r_GRCS-orderBy_S__table_jhj_3kw_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| coluna | Cadeia de caracteres | O nome da coluna a ser usado para ordenar o conjunto de resultados. |
[Tabela 24. Parâmetros]

{#r_GRCS-orderBy_S__table_jhj_3kw_hv} {#r_GRCS-orderBy_S__table_khj_3kw_hv__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 25. Retorna]

{#r_GRCS-orderBy_S__table_khj_3kw_hv}  

    function UpdateProjectWBS(project) {
      var count = 0;
      var child = new GlideRecord('pm_project_task');
      child.addQuery('parent', project.sys_id);
      child.orderBy('order');
      child.orderBy('number');
      child.query(childResponse);
      g_form.addInfoMessage(count + ' Project Tasks updated');
    }
     
    function childResponse(child) {
      var len = child.getRowCount().toString().length;
      var seq = 0;
      while (child.next()) {
        count += UpdateProjectTaskWBS(child, 1, ++seq, len, '');
      }
    }

## GlideRecorddo lado do cliente - query (nome da cadeia de caracteres, responseFunction da função, valor da cadeia de caracteres) {#ariaid-title15}

Executa a consulta ao servidor em relação à tabela com base no filtro addQuery(). Este método consulta a tabela GlideRecord, bem como todas as referências da tabela.
Não faça chamadas de consulta síncrona. Executar uma consulta sem uma função de resposta torna a chamada síncrona, o que significa que a exibição aguardará a resposta da consulta antes de continuar.
{#r_GRCS-query_Function__table_zbp_qjl_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Opcional. O nome de um campo a ser consultado. |
| função de resposta | Função | A função chamada quando os resultados da consulta estão disponíveis. |
| valor | Cadeia de caracteres | Opcional. O valor do campo a ser consultado. Qualquer par de literais é considerado um par de consulta (campo: valor). |
[Tabela 26. Parâmetros]

{#r_GRCS-query_Function__table_zbp_qjl_3v} {#r_GRCS-query_Function__table_dg5_wkw_hv__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 27. Retorna]

{#r_GRCS-query_Function__table_dg5_wkw_hv}  
A seguir está um exemplo básico com uma função de resposta.

    var rec = new GlideRecord('incident');
    rec.query(recResponse);
     
    function recResponse(rec) {
      while (rec.next()) { 
       alert(rec.number + ' exists');
      } 
    }

O exemplo a seguir mostra a diferença entre a sintaxe síncrona e assíncrona, com um exemplo assíncrono.

    // synchronous call syntax (no response function): DO NOT USE
            query();
            
            // asynchronous call syntax
            // performs query with current conditions, calls responseFunction when done
            query(responseFunction)
            
            // synchronous call syntax (no response function): DO NOT USE
            // adds "category=hardware" to current query conditions and performs query
            query('category', 'hardware')
            
            // asynchronous call syntax
            // adds "category=hardware" to current query conditions, performs query, and calls responseFunction when done
            query('category', 'hardware', responseFunction)
            
            // asynchronous call example
            // adds "user_name=abel.tuter" to current query conditions, performs query, and calls defined response function when done
            function onLoad() {
            var now_GR = new GlideRecord("sys_user");
            now_GR.query("user_name", "abel.tuter", function(now_GR) {
            if (now_GR.next()) {
            alert("You can access fields by name from the client API, just like in the server API:\n now_GR.name = " + now_GR.name);
            alert("You can also access fields using getValue():\n now_GR.getValue(\"email\") = " + now_GR.getValue("email"));
            if (now_GR.getDisplayValue) {
            alert("In Service Portal, Mobile, and Agent Workspace, you can access a field's display value:\n now_GR.getDisplayValue(\"company\") = " + now_GR.getDisplayValue("company"));
            } else {
            alert("On the desktop, you cannot access a field's display value, but can get its sys_id:\n now_GR.company = " + now_GR.company);
            }
            alert("You cannot dot-walk in the client API:\n now_GR.company.name = " + now_GR.company.name);
            }
            });
            }

## GlideRecorddo lado do cliente - setEncodedQuery(cadeia de caracteres encodedQuery) {#ariaid-title16}

Adiciona uma cadeia de caracteres de consulta codificada especificada à cláusula de consulta atual.
Este método permite que você especifique filtros complexos (cadeias de caracteres de consulta codificadas) em uma única chamada de consulta, ao contrário de outros métodos addQuery() do lado do cliente. Depois de definir todas as consultas desejadas, chame o [GlideRecorddo lado do cliente - query (nome da cadeia de caracteres, responseFunction da função, valor da cadeia de caracteres)](https://servicenow-prod.fluidtopics.net/lsyx8yeo6~cAE_x42rXKug#r_GRCS-query_Function "Executa a consulta ao servidor em relação à tabela com base no filtro addQuery(). Este método consulta a tabela GlideRecord, bem como todas as referências da tabela.") para executar a cláusula de consulta especificada (filtro). Para obter informações adicionais sobre cadeias de caracteres de consulta codificadas, consulte Cadeias de [caracteres de consulta codificadas](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US).

Se você chamar este método várias vezes antes de chamar o método query(), as consultas serão unidas por AND.
{#r_GRCS-setEncodedQuery__table_bpl_gvw_zgb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| encodedQuery | Cadeia de caracteres | Cadeia de caracteres de consulta codificada a ser adicionada à cláusula de consulta atual. |
[Tabela 28. Parâmetros]

{#r_GRCS-setEncodedQuery__table_bpl_gvw_zgb} {#r_GRCS-setEncodedQuery__table_cpl_gvw_zgb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 29. Retorna]

{#r_GRCS-setEncodedQuery__table_cpl_gvw_zgb}  

    var now_GR = new GlideRecord('incident');
    now_GR.setEncodedQuery('priority=4^ORstate=3');
    now_GR.query(response);
     
    function response(result) {
        while(result.next()) {
            console.log(result.getValue('number'));
        }
    }

## GlideRecorddo lado do cliente - setLimit(Number maxQuery) {#ariaid-title17}

Define o limite de registros no GlideRecord.
{#r_GRCS-setLimit_N__table_c4d_3lw_hv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| consulta máxima | Número | O limite para o número de registros a serem recuperados. |
[Tabela 30. Parâmetros]

{#r_GRCS-setLimit_N__table_c4d_3lw_hv} {#r_GRCS-setLimit_N__table_d4d_3lw_hv__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 31. Retorna]

{#r_GRCS-setLimit_N__table_d4d_3lw_hv}