---
sourceDocument: Referência de API do Brasil
sourceDocumentLink: https://www.servicenow.com/docs/r/pt-BR/api-reference

 Release :

    - brazil

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Brasil

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideRecord - Global

# GlideRecord - Global {#ariaid-title1}

Versão de lançamento: Brazil  
Atualizado 10 de set. de 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 103 min. de leitura  
A API GlideRecord é usada para operações de banco de dados.
A API GlideRecord é o meio primário de interface com o banco de dados no código do lado do servidor. Um GlideRecord é um objeto que contém registros de uma única tabela. Use a API para instanciar um objeto GlideRecord e adicionar parâmetros de consulta, filtros, limites e ordenação.

Para usar esta API para criar atributos dinâmicos, você deve ter a função dynamic_schema_writer. Para ler dados dinâmicos usando esta API, você deve ter a função dynamic_schema_reader .

Para obter informações sobre uma classe que executa as mesmas funções que GlideRecord e impõe ACLs, consulte [Aplicando ACLs com GlideRecordSecure](https://www.servicenow.com/docs/etCIPh2stQRU_x4GkrVKJw#c_UsingGlideRecordSecure "GlideRecordSecure é uma classe herdada do GlideRecord que executa as mesmas funções que GlideRecord, e também impõe ACLs.").

Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).

Consulte o <https://developer.servicenow.com/dev.do#!/learn/courses/utah/app_store_learnv2_scripting_utah_scripting_in_servicenow/app_store_learnv2_scripting_utah_server_side_scripting/app_store_learnv2_scripting_utah_gliderecord> artigo GlideRecord para obter detalhes sobre como criar e executar consultas.

Para obter informações sobre GlideRecordSecure, que é uma classe herdada do GlideRecord que executa as mesmas funções que GlideRecord e também impõe ACLs, consulte [Aplicando ACLs com GlideRecordSecure](https://www.servicenow.com/docs/etCIPh2stQRU_x4GkrVKJw#c_UsingGlideRecordSecure "GlideRecordSecure é uma classe herdada do GlideRecord que executa as mesmas funções que GlideRecord, e também impõe ACLs.").

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).

## Recupere valores de registros {#c_GlideRecordAPI__section_t45_vmd_npb}

Na maioria dos casos, não use a referência com pontos para obter valores de um registro. A referência com pontos recupera o objeto inteiro em vez do valor do campo. A recuperação do objeto usa mais armazenamento e pode causar resultados indesejáveis quando usado em matrizes ou em Portal de serviços.

Em vez de recuperar o objeto inteiro, você pode usar um dos seguintes métodos para copiar os valores do campo:

* [getValue()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-getValue_String "Recupera o valor da cadeia de caracteres de um campo especificado ou o valor da cadeia de caracteres de um atributo em um armazenamento dinâmico de atributos.")
* [getDisplayValue()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-getDisplayValue "Recupera o valor de exibição do registro atual ou o valor de exibição de um atributo em um armazenamento dinâmico de atributos.")

{#c_GlideRecordAPI__gr-api-dot-walk-global-rec-lnx}  
Se a referência com pontos em um objeto GlideElement for necessária, use o método toString() para recuperar valores. Por exemplo, você pode precisar do sys_id do gerenciador do solicitante atual para definir outro campo de referência. O exemplo a seguir mostra como obter o valor da cadeia de caracteres em vez de todo o objeto:

    var mgr = current.caller_id.manager.toString();

## Atributos dinâmicos {#c_GlideRecordAPI__section_qss_t53_1cc}

Nesta API, há métodos que têm a mesma funcionalidade que os métodos de esquema dinâmico na [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.") API. Use os métodos de atributo dinâmico nesta API para executar ações em um GlideRecord especificado. Use os métodos na API GlideDynamicAttributeStore se quiser definir o mesmo grupo de atributos dinâmicos em vários registros. Usando esta API, você pode preparar um objeto GlideDynamicAttributeStore com os atributos desejados e, em seguida, copiar esse objeto para vários GlideRecords usando os vários métodos setDynamicAttributeValues().
Consulte também:

* [GlideAggregate](https://www.servicenow.com/docs/xzD~6b8FXCC7Nvb_DXCWrg#c_GlideAggregateAPI "A API GlideAggregate permite criar consultas de agregação de banco de dados.")
* [GlideElement](https://www.servicenow.com/docs/8b~fKEUHbZF~fL1vQDQZ9g#c_GlideElementAPI "A API GlideElement fornece uma série de métodos de script convenientes para lidar com campos e seus valores. Os métodos GlideElement estão disponíveis para os campos do registro Glide atual.")
* [GlideQuery](https://www.servicenow.com/docs/ODvX~GJ5Gzru20mpX8Yetg#GlideQueryGlobalAPI "A inclusão de script GlideQuery é uma alternativa à API GlideRecord para executar operações de CRUD em dados de registro de scripts do lado do servidor.")
{#c_GlideRecordAPI__ul_mky_nkd_npb}

## GlideRecord - GlideRecord (cadeia de caracteres tablename) {#ariaid-title2}

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

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

{#r_GlideRecord-GlideRecord_S__table_v1n_btj_3v}  

    var now_GR = new GlideRecord('incident');

## GlideRecord - addActiveQuery() {#ariaid-title3}

Adiciona um filtro para retornar registros ativos.
{#r_GlideRecord-AddActiveQuery__table_bk4_zkp_dt__entry__3}

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

{#r_GlideRecord-AddActiveQuery__table_bk4_zkp_dt} {#r_GlideRecord-AddActiveQuery__table_ck4_zkp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | Filtro para retornar registros ativos. |
[Tabela 3. Retorna]

{#r_GlideRecord-AddActiveQuery__table_ck4_zkp_dt}  

    var inc = new GlideRecord('incident');
    inc.addActiveQuery();
    inc.query();

### Escopo equivalente {#r_GlideRecord-AddActiveQuery__section_t1r_lbs_mcb}

Para usar o método addActiveQuery() em uma aplicação com escopo, use o método com escopo correspondente: [AddActiveQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-addActiveQuery "Adiciona um filtro para retornar registros ativos.").

## AddDomainQuery (objeto glideRecord) {#ariaid-title4}

Muda o domínio usado para a consulta do domínio do usuário para o domínio do GlideRecord fornecido.
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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).

Esta função requer o plug-in Suporte a domínios - Instalador de extensões de domínio (com.glide.domain.msp_extensions.installer).
{#r_GlideRecord-AddDomainQuery_Object__table_ukh_fmp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| GlideRecord | Object | GlideRecord do qual obter o domínio. |
[Tabela 4. Parâmetros]

{#r_GlideRecord-AddDomainQuery_Object__table_ukh_fmp_dt} {#r_GlideRecord-AddDomainQuery_Object__table_vkh_fmp_dt__entry__2}

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

{#r_GlideRecord-AddDomainQuery_Object__table_vkh_fmp_dt}  

    //This example requires the Domain plugin be active, the Group table is the specified 
    //Domain table, and the ITIL user is in the Database Atlanta domain
    //From any domain (using queryNoDomain()) look up the incidents that an ITIL user can only see 
    //who is in the Database Atlanta domain, should expect all incidents with the global or the
    //Database Atlanta domain specified.
    var domain = new GlideRecord('sys_user');
    domain.addQuery('user_name', 'itil');
    domain.queryNoDomain();
    if (domain.next()) {
        var domainQuery = new GlideRecord('incident');
        domainQuery.addQuery('active', true);
        domainQuery.addDomainQuery(domain);
        domainQuery.query();
        gs.print('Number of Incidents for ITIL user: ' + domainQuery.getRowCount());
        while (domainQuery.next())
            gs.print(domainQuery.number);
    }

### Escopo equivalente {#r_GlideRecord-AddDomainQuery_Object__section_bct_nbs_mcb}

Este método não está disponível em aplicações com escopo.

## AddEncodedQuery (consulta de cadeia de caracteres, enforceFieldACL booliano) {#ariaid-title5}

Adiciona uma consulta codificada a outras consultas que podem ter sido definidas.
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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Nota:  
Para impor o acesso à consulta com base no usuário, use [AddUserEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para impor o acesso à consulta com base no usuário.").
{#r_GlideRecord-AddEncodedQuery_String__table_j3p_mlp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| consulta | Cadeia de caracteres | Uma [cadeia de caracteres de consulta codificada](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US). |
| Enforce FieldACL | Booliano | Opcional. Sinalizador que indica se as regras ACL (Lista de controle de acesso) devem ser impostas de campo. Valores válidos: * Verdadeiro: Impor ACLs de campo. * Falso: Não aplique ACLs de campo. {#r_GlideRecord-AddEncodedQuery_String__ul_ml3_mpk_wbc} Padrão: falso |
[Tabela 6. Parâmetros]

{#r_GlideRecord-AddEncodedQuery_String__table_j3p_mlp_dt} {#r_GlideRecord-AddEncodedQuery_String__table_k3p_mlp_dt__entry__2}

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

{#r_GlideRecord-AddEncodedQuery_String__table_k3p_mlp_dt}  

    var queryString = "priority=1^ORpriority=2";
     var now_GR = new GlideRecord('incident');
     
     now_GR.addEncodedQuery(queryString);
     now_GR.query();
     while (now_GR.next()) {
     gs.addInfoMessage(now_GR.number);
     }

### Escopo equivalente {#r_GlideRecord-AddEncodedQuery_String__section_un1_qbs_mcb}

Para usar o método addEncodedQuery() em uma aplicação com escopo, use o método com escopo correspondente: [AddEncodedQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordAddEncodedQuery_String "Adiciona uma consulta codificada a outras consultas que podem ter sido definidas.").

## AddExtraField (cadeia de caracteres dotWalkedField) {#ariaid-title6}

Consulta um ou mais campos com referência com pontos de um formulário ou script em uma única solicitação.
O método addExtraField() permite consultar campos com referência a pontos em uma única solicitação de banco de dados, em vez de executar várias consultas por elemento com referência a pontos em um formulário ou script (o que requer várias viagens de ida e volta para o banco de dados).
{#GlideRecord-addExtraField_S__table_ctk_qcx_hzb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| DotWalkedField | Cadeia de caracteres | O nome do campo com referência com pontos. Os níveis de nomes de campos são separados por pontos (pontos). Por exemplo, insira o valor `Caller.Company` se você quiser consultar o. EmpresaSolicitante Condição na tabela Incidente \[incidente\]. O formato de dotWalkedField segue a ordem da esquerda para a direita dos campos em um formulário ou script com pontos. |
[Tabela 8. Parâmetros]

{#GlideRecord-addExtraField_S__table_ctk_qcx_hzb} {#GlideRecord-addExtraField_S__table_dtk_qcx_hzb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) | Nota: O método addExtraField() não afeta os resultados de saída; a saída é sempre a mesma, independentemente de você usar este método no script. |
[Tabela 9. Retorna]

{#GlideRecord-addExtraField_S__table_dtk_qcx_hzb}  
O exemplo a seguir mostra como consultar o campo de nome do contato de cmn_location (referenciado no campo de referência "local" em um campo cmdb_ci).  
Nota:  
O valor dotWalkedField neste exemplo, cmdb_ci.location.contact.name, parece "cmdb_ci fields":\> "cmn_location fields":\> "sys_user fields" na ServiceNow® IU ao selecionar campos em uma lista.

    var gliderecord = new GlideRecord("incident");
    gliderecord.addQuery("number", "INC0041457");
    gliderecord.addExtraField("cmdb_ci.location.contact.name");
    gliderecord.query();
    gliderecord.next();
    gs.print(gliderecord.cmdb_ci.location.contact.name);

A saída é a mesma que `gs.print(gr.cmdb_ci.location.contact.name)` sem usar addExtraField(). O método addExtraField() otimiza a consulta dos campos analisados com pontos. Saída de exemplo:

    Abel Tuter

## AddFunction (Object Function) {#ariaid-title7}

Aplica um objeto GlideDBFunctionBuilder predefinido a um registro.
Use a classe com escopo GlideDBFunctionBuilder para definir uma função. Depois que a função for definida, use o método addFunction(Object Function) para aplicar a função a um registro.
{#r_GlideRecord-addFunction_Object__table_mkh_dnk_kbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| . | Object | Um objeto GlideDBFunctionBuilder ou GlideDBCaseStatementBuilder que define uma operação SQL. |
[Tabela 10. Parâmetros]

{#r_GlideRecord-addFunction_Object__table_mkh_dnk_kbb} {#r_GlideRecord-addFunction_Object__table_nkh_dnk_kbb__entry__2}

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

{#r_GlideRecord-addFunction_Object__table_nkh_dnk_kbb}  

    var functionBuilder = new GlideDBFunctionBuilder();
    var myAddingFunction = functionBuilder.add();
    myAddingFunction = functionBuilder.field('order');
    myAddingFunction = functionBuilder.field('priority');
    myAddingFunction = functionBuilder.build();

    var now_GR = new GlideRecord('incident');
    now_GR.addFunction(myAddingFunction);
    now_GR.addQuery(myAddingFunction, '<', 5);
    now_GR.query();
    while(now_GR.next())
    gs.log(now_GR.getValue(myAddingFunction));

Saída:

    *** Script: 1
    *** Script: 4
    *** Script: 3
    *** Script: 1
    *** Script: 1
    *** Script: 2
    *** Script: 1
    *** Script: 1

## AddSystemEncodedQuery (consulta de cadeia de caracteres) {#ariaid-title8}

Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para ignorar o acesso à consulta.
Use este método quando o acesso no nível do sistema for pretendido, para que a imposição da ACL de consulta seja explicitamente ignorada para o usuário. Use [AddUserEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para impor o acesso à consulta com base no usuário.") para impor o acesso à consulta.  
Métodos adicionais para acesso no nível do sistema que ignoram as verificações de ACL de consulta:

* [AddSystemOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemOrderBy_S "Especifica uma coluna orderBy. Use este método para ignorar o acesso à consulta.")
* [AddSystemOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para ignorar o acesso à consulta.")
* [AddSystemQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. Use este método para ignorar o acesso à consulta.")
* [GlideQueryCondition - addSystemCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addSystemCondition_S_S_O "Adiciona uma condição AND à condição atual. Use este método para ignorar o acesso à consulta.")
* [GlideQueryCondition - addSystemOrCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addSystemOrCondition_S_O_O "Anexa um parâmetro OU condição de dois ou três a uma GlideQueryCondition existente. Use este método para ignorar o acesso à consulta.")
{#GR-addSystemEncodedQuery_S__ul_znd_wlp_53c}

Para obter informações sobre como usar este método com GlideRecordSecure, consulte [ACLs de consulta imposta](https://www.servicenow.com/docs/etCIPh2stQRU_x4GkrVKJw#c_UsingGlideRecordSecure__enforcing_query_ACLs).

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#GR-addSystemEncodedQuery_S__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| consulta | Cadeia de caracteres | Uma [cadeia de caracteres de consulta codificada](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US). |
[Tabela 12. Parâmetros]

{#GR-addSystemEncodedQuery_S__table_vy2_525_jq} {#GR-addSystemEncodedQuery_S__table_up3_d5b_2r__entry__2}

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

{#GR-addSystemEncodedQuery_S__table_up3_d5b_2r}  
O exemplo a seguir mostra como retornar o valor numérico dos primeiros 12 incidentes com um valor de prioridade de 1 ou 2.

    var queryString = "priority=1^ORpriority=2";
    var now_GR = new GlideRecord('incident');
    now_GR.addSystemEncodedQuery(queryString);

    now_GR.setLimit(12);
    now_GR.query();

    while (now_GR.next()) {
      gs.info(now_GR.getValue('number'));
    }

Saída:

    *** Script: INC0002318
    *** Script: INC0000144
    *** Script: INC0006927
    *** Script: INC0003577
    *** Script: INC0006928
    *** Script: INC0000135
    *** Script: INC0005637
    *** Script: INC0003196
    *** Script: INC0002647
    *** Script: INC0004074
    *** Script: INC0003444
    *** Script: INC0001694

## AddSystemOrderBy (nome da cadeia de caracteres) {#ariaid-title9}

Especifica uma coluna orderBy. Use este método para ignorar o acesso à consulta.
Use este método quando o acesso no nível do sistema for pretendido, para que a imposição da ACL de consulta seja explicitamente ignorada para o usuário. Use [AddUserOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderBy_S "Especifica uma coluna orderBy. Use este método para impor o acesso à consulta com base no usuário.") para impor o acesso à consulta.  
Métodos adicionais para acesso no nível do sistema que ignoram as verificações de ACL de consulta:

* [AddSystemEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para ignorar o acesso à consulta.")
* [AddSystemQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. Use este método para ignorar o acesso à consulta.")
* [GlideQueryCondition - addSystemCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addSystemCondition_S_S_O "Adiciona uma condição AND à condição atual. Use este método para ignorar o acesso à consulta.")
* [GlideQueryCondition - addSystemOrCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addSystemOrCondition_S_O_O "Anexa um parâmetro OU condição de dois ou três a uma GlideQueryCondition existente. Use este método para ignorar o acesso à consulta.")
{#GR-addSystemOrderBy_S__ul_znd_wlp_53c}

Chame este método mais de uma vez para ordenar por várias colunas. Os resultados são organizados em ordem crescente. Para organizar registros em ordem decrescente, consulte [addSystemOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para ignorar o acesso à consulta.").
{#GR-addSystemOrderBy_S__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome da coluna a ser usado para ordenar os registros neste objeto GlideRecord. |
[Tabela 14. Parâmetros]

{#GR-addSystemOrderBy_S__table_vy2_525_jq} {#GR-addSystemOrderBy_S__table_ts3_ktb_2r__entry__2}

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

{#GR-addSystemOrderBy_S__table_ts3_ktb_2r}  
O exemplo a seguir mostra como solicitar registros de incidente em ordem crescente por descrição resumida.

    var queryString = "priority=1";
    var now_GR = new GlideRecord('incident');

    now_GR.addSystemOrderBy('short_description'); // Ascending Order
    now_GR.addSystemEncodedQuery(queryString);

    now_GR.setLimit(6);
    now_GR.query();

    while (now_GR.next()) {
      gs.info(now_GR.getValue('short_description'));
    }

Saída:

    *** Script: Access token revoked
    *** Script: Access token revoked
    *** Script: Account locked, pls reset my password for Linkedin Sales Navigator
    *** Script: Active Directory (AD) synchronization error
    *** Script: Adobe Photoshop & Digital Publishing Instance is down
    *** Script: Application response time is poor when performing any action in ADP Payroll S...

## AddSystemOrderByDesc(nome da cadeia de caracteres) {#ariaid-title10}

Especifica uma coluna orderBy decrescente. Use este método para ignorar o acesso à consulta.
Use este método quando o acesso no nível do sistema for pretendido, para que a imposição da ACL de consulta seja explicitamente ignorada para o usuário. Use [AddUserOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para impor o acesso à consulta com base no usuário.") para impor o acesso à consulta.  
Métodos adicionais para acesso no nível do sistema que ignoram as verificações de ACL de consulta:

* [AddSystemEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para ignorar o acesso à consulta.")
* [AddSystemQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. Use este método para ignorar o acesso à consulta.")
* [GlideQueryCondition - addSystemCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addSystemCondition_S_S_O "Adiciona uma condição AND à condição atual. Use este método para ignorar o acesso à consulta.")
* [GlideQueryCondition - addSystemOrCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addSystemOrCondition_S_O_O "Anexa um parâmetro OU condição de dois ou três a uma GlideQueryCondition existente. Use este método para ignorar o acesso à consulta.")
{#GR-addSystemOrderByDesc_S__ul_znd_wlp_53c}

Chame este método mais de uma vez para ordenar por várias colunas. Os resultados são organizados em ordem decrescente. Para organizar registros em ordem crescente, consulte [addSystemOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemOrderBy_S "Especifica uma coluna orderBy. Use este método para ignorar o acesso à consulta.").
{#GR-addSystemOrderByDesc_S__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome da coluna a ser usado para ordenar os registros em um objeto GlideRecord. |
[Tabela 16. Parâmetros]

{#GR-addSystemOrderByDesc_S__table_vy2_525_jq} {#GR-addSystemOrderByDesc_S__table_lpd_ktb_2r__entry__2}

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

{#GR-addSystemOrderByDesc_S__table_lpd_ktb_2r}  
O exemplo a seguir mostra como solicitar registros de incidente em ordem decrescente por descrição resumida.

    var queryString = "priority=2";
    var now_GR = new GlideRecord('incident');

    now_GR.addSystemOrderByDesc('short_description'); //Descending Order
    now_GR.addSystemEncodedQuery(queryString);

    now_GR.setLimit(6);
    now_GR.query();

    while (now_GR.next()) {
      gs.info(now_GR.getValue('short_description'));
    }

Saída:

    *** Script: Xignite U.S. and Global Real Time Quotes upgrade to the latest version
    *** Script: Xignite Company, Market and Industry News Headlines upgrade to the latest ver...
    *** Script: Workday Talent Management Instance relocation from US datacenter to Hongkong ...
    *** Script: Warning displayed while launching Tableau Server
    *** Script: Warning displayed while launching SAP Financial Accounting
    *** Script: Warning displayed while launching Jive Daily

## AddSystemQuery (nome da cadeia de caracteres, operador do objeto, valor do objeto) {#ariaid-title11}

Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. Use este método para ignorar o acesso à consulta.
Use este método quando o acesso no nível do sistema for pretendido, para que a imposição da ACL de consulta seja explicitamente ignorada para o usuário. Use [AddUserQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. O usuário solicitante deve ter acesso para executar a operação de consulta especificada no campo para que esta solicitação seja adicionada. Use este método para impor o acesso à consulta com base no usuário.") para impor o acesso à consulta.  
Métodos adicionais para acesso no nível do sistema que ignoram as verificações de ACL de consulta:

* [AddSystemEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para ignorar o acesso à consulta.")
* [AddSystemOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemOrderBy_S "Especifica uma coluna orderBy. Use este método para ignorar o acesso à consulta.")
* [AddSystemOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para ignorar o acesso à consulta.")
* [GlideQueryCondition - addSystemCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addSystemCondition_S_S_O "Adiciona uma condição AND à condição atual. Use este método para ignorar o acesso à consulta.")
* [GlideQueryCondition - addSystemOrCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addSystemOrCondition_S_O_O "Anexa um parâmetro OU condição de dois ou três a uma GlideQueryCondition existente. Use este método para ignorar o acesso à consulta.")
{#GR-addSystemQuery_S_O_O__ul_znd_wlp_53c}

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#GR-addSystemQuery_S_O_O__table_ix2_hvp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo da tabela. |
| operador | Object | Operador de consulta. Os valores disponíveis dependem do tipo de dados do <var class="keyword varname"></var> parâmetro Valor. Números: * = * != * \> * \>= * \< * \<= {#GR-addSystemQuery_S_O_O__ul_qyb_rbt_3y} Cadeias de caracteres (deve estar em maiúsculas): * = * != * IN * NÃO ESTÁ EM * INICIAR * ENDSWITH * CONTÉM * NÃO CONTÉM * INSTANCEOF {#GR-addSystemQuery_S_O_O__ul_egz_vbt_3y} Nota: Use CONTAINS em vez do operador LIKE. Operadores de esquema dinâmico: * = * != * \< * \> * \<= * \>= * ENTRE * CONTÉM * _NOT_CONTER * ENDSWITH * GT_FIELD * GT_OU_EQUALS_FIELD * IN * ISEMPTY * ISNOTEMPTY * IS_NOT_NULL * IS_NULL * COMO * LT_FIELD * LT_OR_EQUALS_FIELD * CORRESPONDÊNCIAS * NOT_IN * NÃO_GOSTO * NOT_MATCHES * NSAMEAS * SAMEAS * INICIAR {#GR-addSystemQuery_S_O_O__ul_g5t_j32_cgc} |
| valor | Object | Valor no qual consultar (não diferencia maiúsculas de minúsculas). |
[Tabela 18. Parâmetros]

{#GR-addSystemQuery_S_O_O__table_ix2_hvp_dt} {#GR-addSystemQuery_S_O_O__table_gty_wtb_2r__entry__2}

| Tipo | Descrição |
|-|-|
| [GlideQueryCondition](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#c_GlideQueryConditionAPI "Esta API fornece condições AND ou OR que podem ser adicionadas à condição atual, permitindo que você crie consultas complexas.") | A condição de consulta que foi adicionada ao GlideRecord. |
[Tabela 19. Retorna]

{#GR-addSystemQuery_S_O_O__table_gty_wtb_2r}  
O exemplo a seguir mostra como retornar explicitamente todos os usuários ativos chamados fred.

    var rec = new GlideRecord('sys_user');
    rec.addSystemQuery("first_name", "=", "Fred");
    rec.query();

    while (rec.next()) {
      gs.info('Active user ' + rec.getValue('last_name'));
    }

Saída:

    Active user Luddy
    Active user Kunde

## AddUserEncodedQuery (consulta de cadeia de caracteres) {#ariaid-title12}

Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para impor o acesso à consulta com base no usuário.
Este método retorna somente registros aos quais o usuário atual tem acesso de consulta (com base em ACLs).  
Métodos relacionados:

* [AddEncodedQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordAddEncodedQuery_String "Adiciona uma consulta codificada a outras consultas que podem ter sido definidas.") Fornece a mesma funcionalidade sem imposição de ACL.
* [AddSystemEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para ignorar o acesso à consulta.") ignora as verificações de acesso à consulta.
{#GR-addUserEncodedQuery_S__ul_i2h_csq_53c}  
Métodos adicionais para impor verificações de ACL de consulta:

* [AddUserOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderBy_S "Especifica uma coluna orderBy. Use este método para impor o acesso à consulta com base no usuário.")
* [AddUserOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para impor o acesso à consulta com base no usuário.")
* [AddUserQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. O usuário solicitante deve ter acesso para executar a operação de consulta especificada no campo para que esta solicitação seja adicionada. Use este método para impor o acesso à consulta com base no usuário.")
* [GlideQueryCondition - addUserCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addUserCondition_S_S_O "Adiciona uma condição AND à condição atual. Use este método para impor o acesso à consulta com base no usuário.")
* [GlideQueryCondition - addUserOrCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addUserOrCondition_S_O_O "Anexa um parâmetro OU condição de dois ou três a uma GlideQueryCondition existente. Use este método para impor o acesso à consulta com base no usuário.")
{#GR-addUserEncodedQuery_S__ul_znd_wlp_53c}

Para obter informações sobre como usar este método com GlideRecordSecure, consulte [ACLs de consulta imposta](https://www.servicenow.com/docs/etCIPh2stQRU_x4GkrVKJw#c_UsingGlideRecordSecure__enforcing_query_ACLs).

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#GR-addUserEncodedQuery_S__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| consulta | Cadeia de caracteres | Uma [cadeia de caracteres de consulta codificada](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US). |
[Tabela 20. Parâmetros]

{#GR-addUserEncodedQuery_S__table_vy2_525_jq} {#GR-addUserEncodedQuery_S__table_up3_d5b_2r__entry__2}

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

{#GR-addUserEncodedQuery_S__table_up3_d5b_2r}  
O exemplo a seguir mostra como retornar o valor numérico dos primeiros 12 incidentes com um valor de prioridade de 1 ou 2.

    var queryString = "priority=1^ORpriority=2";
    var now_GR = new GlideRecord('incident');
    now_GR.addUserEncodedQuery(queryString);

    now_GR.setLimit(12);
    now_GR.query();

    while (now_GR.next()) {
      gs.info(now_GR.getValue('number'));
    }

Saída:

    *** Script: INC0002318
    *** Script: INC0000144
    *** Script: INC0006927
    *** Script: INC0003577
    *** Script: INC0006928
    *** Script: INC0000135
    *** Script: INC0005637
    *** Script: INC0003196
    *** Script: INC0002647
    *** Script: INC0004074
    *** Script: INC0003444
    *** Script: INC0001694

## AddUserOrderBy (nome da cadeia de caracteres) {#ariaid-title13}

Especifica uma coluna orderBy. Use este método para impor o acesso à consulta com base no usuário.
Este método retorna somente registros aos quais o usuário atual tem acesso de consulta (com base em ACLs).  
Métodos relacionados:

* [Orderby()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-orderBy_String "Especifica um nome de campo, ou caminho para um atributo em um armazenamento de atributos dinâmico, a ser usado para ordenar o conjunto de consultas. Para ordenar por vários campos, chame este método várias vezes com valores de campo diferentes.") Fornece a mesma funcionalidade sem imposição de ACL.
* [AddSystemOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemOrderBy_S "Especifica uma coluna orderBy. Use este método para ignorar o acesso à consulta.") ignora as verificações de acesso à consulta.
{#GR-addUserOrderBy_S__ul_i2h_csq_53c}  
Métodos adicionais para impor verificações de ACL de consulta:

* [AddUserEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para impor o acesso à consulta com base no usuário.")
* [AddUserQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. O usuário solicitante deve ter acesso para executar a operação de consulta especificada no campo para que esta solicitação seja adicionada. Use este método para impor o acesso à consulta com base no usuário.")
* [GlideQueryCondition - addUserCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addUserCondition_S_S_O "Adiciona uma condição AND à condição atual. Use este método para impor o acesso à consulta com base no usuário.")
* [GlideQueryCondition - addUserOrCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addUserOrCondition_S_O_O "Anexa um parâmetro OU condição de dois ou três a uma GlideQueryCondition existente. Use este método para impor o acesso à consulta com base no usuário.")
{#GR-addUserOrderBy_S__ul_znd_wlp_53c}

Chame este método mais de uma vez para ordenar por várias colunas. Os resultados são organizados em ordem crescente. Para organizar registros em ordem decrescente, consulte [addUserOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para impor o acesso à consulta com base no usuário.").
{#GR-addUserOrderBy_S__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome da coluna a ser usado para ordenar os registros neste objeto GlideRecord. |
[Tabela 22. Parâmetros]

{#GR-addUserOrderBy_S__table_vy2_525_jq} {#GR-addUserOrderBy_S__table_ts3_ktb_2r__entry__2}

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

{#GR-addUserOrderBy_S__table_ts3_ktb_2r}  
O exemplo a seguir mostra como solicitar registros de incidente em ordem crescente por descrição resumida.

    var queryString = "priority=1";
    var now_GR = new GlideRecord('incident');

    now_GR.addUserOrderBy('short_description'); // Ascending Order
    now_GR.addUserEncodedQuery(queryString);

    now_GR.setLimit(6);
    now_GR.query();

    while (now_GR.next()) {
      gs.info(now_GR.getValue('short_description'));
    }

Saída:

    *** Script: Access token revoked
    *** Script: Access token revoked
    *** Script: Account locked, pls reset my password for Linkedin Sales Navigator
    *** Script: Active Directory (AD) synchronization error
    *** Script: Adobe Photoshop & Digital Publishing Instance is down
    *** Script: Application response time is poor when performing any action in ADP Payroll S...

## AddUserOrderByDesc(nome da cadeia de caracteres) {#ariaid-title14}

Especifica uma coluna orderBy decrescente. Use este método para impor o acesso à consulta com base no usuário.
Este método retorna somente registros aos quais o usuário atual tem acesso de consulta (com base em ACLs).  
Métodos relacionados:

* [OrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-orderByDesc_String "Especifica o campo, ou um atributo em um armazenamento dinâmico de atributos, a ser usado para ordenar o conjunto de consultas em ordem decrescente.") Fornece a mesma funcionalidade sem imposição de ACL.
* [AddSystemOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para ignorar o acesso à consulta.") ignora as verificações de acesso à consulta.
{#GR-addUserOrderByDesc_S__ul_i2h_csq_53c}  
Métodos adicionais para impor verificações de ACL de consulta:

* [AddUserEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para impor o acesso à consulta com base no usuário.")
* [AddUserQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. O usuário solicitante deve ter acesso para executar a operação de consulta especificada no campo para que esta solicitação seja adicionada. Use este método para impor o acesso à consulta com base no usuário.")
* [GlideQueryCondition - addUserCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addUserCondition_S_S_O "Adiciona uma condição AND à condição atual. Use este método para impor o acesso à consulta com base no usuário.")
* [GlideQueryCondition - addUserOrCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addUserOrCondition_S_O_O "Anexa um parâmetro OU condição de dois ou três a uma GlideQueryCondition existente. Use este método para impor o acesso à consulta com base no usuário.")
{#GR-addUserOrderByDesc_S__ul_znd_wlp_53c}

Chame este método mais de uma vez para ordenar por várias colunas. Os resultados são organizados em ordem decrescente. Para organizar registros em ordem crescente, consulte [addUserOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderBy_S "Especifica uma coluna orderBy. Use este método para impor o acesso à consulta com base no usuário.").
{#GR-addUserOrderByDesc_S__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome da coluna a ser usado para ordenar os registros em um objeto GlideRecord. |
[Tabela 24. Parâmetros]

{#GR-addUserOrderByDesc_S__table_vy2_525_jq} {#GR-addUserOrderByDesc_S__table_lpd_ktb_2r__entry__2}

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

{#GR-addUserOrderByDesc_S__table_lpd_ktb_2r}  
O exemplo a seguir mostra como solicitar registros de incidente em ordem decrescente por descrição resumida.

    var queryString = "priority=2";
    var now_GR = new GlideRecord('incident');

    now_GR.addUserOrderByDesc('short_description'); //Descending Order
    now_GR.addUserEncodedQuery(queryString);

    now_GR.setLimit(6);
    now_GR.query();

    while (now_GR.next()) {
      gs.info(now_GR.getValue('short_description'));
    }

Saída:

    *** Script: Xignite U.S. and Global Real Time Quotes upgrade to the latest version
    *** Script: Xignite Company, Market and Industry News Headlines upgrade to the latest ver...
    *** Script: Workday Talent Management Instance relocation from US datacenter to Hongkong ...
    *** Script: Warning displayed while launching Tableau Server
    *** Script: Warning displayed while launching SAP Financial Accounting
    *** Script: Warning displayed while launching Jive Daily

## AddUserQuery (nome da cadeia de caracteres, operador do objeto, valor do objeto) {#ariaid-title15}

Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. O usuário solicitante deve ter acesso para executar a operação de consulta especificada no campo para que esta solicitação seja adicionada. Use este método para impor o acesso à consulta com base no usuário.
Este método retorna somente registros aos quais o usuário atual tem acesso de consulta (com base em ACLs).  
Métodos relacionados:

* [AddQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-AddQuery_String_Object_Object "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação.") Fornece a mesma funcionalidade sem imposição de ACL.
* [AddSystemQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addSystemQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. Use este método para ignorar o acesso à consulta.") ignora as verificações de acesso à consulta.
{#GR-addUserQuery_S_O_O__ul_i2h_csq_53c}  
Métodos adicionais para impor verificações de ACL de consulta:

* [AddUserOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderBy_S "Especifica uma coluna orderBy. Use este método para impor o acesso à consulta com base no usuário.")
* [AddUserEncodedQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserEncodedQuery_S "Adiciona uma consulta usando uma cadeia de caracteres de consulta codificada. Use este método para impor o acesso à consulta com base no usuário.")
* [AddUserOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para impor o acesso à consulta com base no usuário.")
* [GlideQueryCondition - addUserCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addUserCondition_S_S_O "Adiciona uma condição AND à condição atual. Use este método para impor o acesso à consulta com base no usuário.")
* [GlideQueryCondition - addUserOrCondition()](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#GQC-addUserOrCondition_S_O_O "Anexa um parâmetro OU condição de dois ou três a uma GlideQueryCondition existente. Use este método para impor o acesso à consulta com base no usuário.")
{#GR-addUserQuery_S_O_O__ul_znd_wlp_53c}

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#GR-addUserQuery_S_O_O__table_ix2_hvp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo da tabela. |
| operador | Object | Operador de consulta. Os valores disponíveis dependem do tipo de dados do <var class="keyword varname"></var> parâmetro Valor. Números: * = * != * \> * \>= * \< * \<= {#GR-addUserQuery_S_O_O__ul_qyb_rbt_3y} Cadeias de caracteres (deve estar em maiúsculas): * = * != * IN * NÃO ESTÁ EM * INICIAR * ENDSWITH * CONTÉM * NÃO CONTÉM * INSTANCEOF {#GR-addUserQuery_S_O_O__ul_egz_vbt_3y} Nota: Use CONTAINS em vez do operador LIKE. Operadores de esquema dinâmico: * = * != * \< * \> * \<= * \>= * ENTRE * CONTÉM * _NOT_CONTER * ENDSWITH * GT_FIELD * GT_OU_EQUALS_FIELD * IN * ISEMPTY * ISNOTEMPTY * IS_NOT_NULL * IS_NULL * COMO * LT_FIELD * LT_OR_EQUALS_FIELD * CORRESPONDÊNCIAS * NOT_IN * NÃO_GOSTO * NOT_MATCHES * NSAMEAS * SAMEAS * INICIAR {#GR-addUserQuery_S_O_O__ul_g5t_j32_cgc} |
| valor | Object | Valor no qual consultar (não diferencia maiúsculas de minúsculas). |
[Tabela 26. Parâmetros]

{#GR-addUserQuery_S_O_O__table_ix2_hvp_dt} {#GR-addUserQuery_S_O_O__table_gty_wtb_2r__entry__2}

| Tipo | Descrição |
|-|-|
| [GlideQueryCondition](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#c_GlideQueryConditionAPI "Esta API fornece condições AND ou OR que podem ser adicionadas à condição atual, permitindo que você crie consultas complexas.") | A condição de consulta que foi adicionada ao GlideRecord. |
[Tabela 27. Retorna]

{#GR-addUserQuery_S_O_O__table_gty_wtb_2r}  
A seguir, é mostrado como retornar somente usuários chamados fred que o usuário atual tem permissão para ver.

    var rec = new GlideRecord('sys_user');
    rec.addUserQuery("first_name", "=", "Fred");
    rec.query();

    while (rec.next()) {
      gs.info('Active user ' + rec.getValue('last_name'));
    }

Saída:

    Active user Luddy
    Active user Kunde

## GlideRecord - addInactiveQuery() {#ariaid-title16}

Adiciona um filtro para retornar registros inativos. Registros inativos têm o sinalizador ativo definido como falso.
{#r_GlideRecord-AddInactiveQuery__table_jhb_fnp_dt__entry__3}

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

{#r_GlideRecord-AddInactiveQuery__table_jhb_fnp_dt} {#r_GlideRecord-AddInactiveQuery__table_khb_fnp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | Registros em que o sinalizador ativo é falso. |
[Tabela 29. Retorna]

{#r_GlideRecord-AddInactiveQuery__table_khb_fnp_dt}  

    var inc = new GlideRecord('incident');
    inc.addInactiveQuery();
    inc.query();

### Escopo equivalente {#r_GlideRecord-AddInactiveQuery__section_rx1_sbs_mcb}

Em aplicações com escopo, use o método com escopo [addQuery("active","false")](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordAddQuery_String_Object "Crie uma consulta de pesquisa e retorne as linhas que correspondem à solicitação.").

## AddJoinQuery (tabela de cadeia de caracteres) {#ariaid-title17}

Adiciona um filtro para retornar registros com base em um relacionamento em uma tabela relacionada.
Por exemplo, encontre todos os usuários que estão no grupo de banco de dados (usuários por meio da tabela sys_user_grmember). Outro exemplo seria Localizar todos os problemas que têm um incidente atribuído (problemas por meio do relacionamento incident.problem_id).

Esta não é uma junção de banco de dados verdadeira; em vez disso, addJoinQuery() adiciona uma subconsulta. Assim, enquanto o conjunto de resultados é limitado com base na junção, os únicos campos aos quais você tem acesso são aqueles na tabela base (aqueles que estão na tabela com a qual o GlideRecord foi inicializado).

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#r_GlideRecord-AddJoinQuery_String__table_lvg_wnp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tabela | Cadeia de caracteres | Nome da tabela |
[Tabela 30. Parâmetros]

{#r_GlideRecord-AddJoinQuery_String__table_lvg_wnp_dt} {#r_GlideRecord-AddJoinQuery_String__table_mvg_wnp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | Registros em que os relacionamentos correspondem. |
[Tabela 31. Retorna]

{#r_GlideRecord-AddJoinQuery_String__table_mvg_wnp_dt}  
Encontre problemas que tenham um incidente anexado. Este exemplo retorna problemas que têm incidentes associados. No entanto, ele não extrairá valores dos incidentes retornados como parte da consulta.

    var prob = new GlideRecord('problem');
    prob.addJoinQuery('incident');
    prob.query();

Encontrar problemas ativos ou falsos com incidentes associados.

    // Look for Problem records
    var now_GR = new GlideRecord('problem');
     
    // That have associated Incident records
    var grSQ = now_GR.addJoinQuery('incident');
     
    // Where the Problem records are "active=false"
    now_GR.addQuery('active', 'false');
     
    // And the Incident records are "active=true"
    grSQ.addCondition('active', 'true');
     
    // Query
    now_GR.query();
     
    // Iterate and print results
    while (now_GR.next()) {
        gs.print(now_GR.getValue('number'));
    }

### Escopo equivalente {#r_GlideRecord-AddJoinQuery_String__section_l1h_vbs_mcb}

Para usar o método addJoinQuery() em uma aplicação com escopo, use o método com escopo correspondente: [AddJoinQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordAddJoinQuery_String_Object_Object "Adiciona um filtro para retornar registros com base em um relacionamento em uma tabela relacionada ao GlideRecord atual.").

## AddJoinQuery (tabela de cadeia de caracteres, cadeia de caracteres primaryField) {#ariaid-title18}

Adiciona um filtro para retornar registros com base em um relacionamento em uma tabela relacionada.
Por exemplo, encontre todos os usuários que estão no grupo de banco de dados (usuários por meio da tabela sys_user_grmember). Outro exemplo seria Localizar todos os problemas que têm um incidente atribuído (problemas por meio do relacionamento incident.problem_id).

Esta não é uma junção de banco de dados verdadeira; em vez disso, addJoinQuery() adiciona uma subconsulta. Assim, enquanto o conjunto de resultados é limitado com base na junção, os únicos campos aos quais você tem acesso são aqueles na tabela base (aqueles que estão na tabela com a qual o GlideRecord foi inicializado).

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#r_GlideRecord-AddJoinQuery_String_String__table_es5_y4p_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tabela | Cadeia de caracteres | Nome da tabela |
| PrimáriaryField | Cadeia de caracteres | Se for diferente de sys_id, o campo primário. |
[Tabela 32. Parâmetros]

{#r_GlideRecord-AddJoinQuery_String_String__table_es5_y4p_dt} {#r_GlideRecord-AddJoinQuery_String_String__table_fs5_y4p_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | Registros em que os relacionamentos correspondem. |
[Tabela 33. Retorna]

{#r_GlideRecord-AddJoinQuery_String_String__table_fs5_y4p_dt}  
Encontre problemas que têm incidentes usando o campo open_by na chave de junção em vez do sys_id.

    var now_GR = new GlideRecord('problem'); 
    now_GR.addJoinQuery('incident', 'opened_by'); 
    now_GR.query();

### Escopo equivalente

Para usar o método addJoinQuery() em uma aplicação com escopo, use o método com escopo correspondente: [AddJoinQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordAddJoinQuery_String_Object_Object "Adiciona um filtro para retornar registros com base em um relacionamento em uma tabela relacionada ao GlideRecord atual.").

## AddJoinQuery (tabela de cadeia de caracteres, cadeia de caracteres primaryField, cadeia de caracteres joinTableField) {#ariaid-title19}

Adiciona um filtro para retornar registros com base em um relacionamento em uma tabela relacionada.
Por exemplo, encontre todos os usuários que estão no grupo de banco de dados (usuários por meio da tabela sys_user_grmember). Outro exemplo seria Localizar todos os problemas que têm um incidente atribuído (problemas por meio do relacionamento incident.problem_id).

Esta não é uma junção de banco de dados verdadeira; em vez disso, addJoinQuery() adiciona uma subconsulta. Assim, enquanto o conjunto de resultados é limitado com base na junção, os únicos campos aos quais você tem acesso são aqueles na tabela base (aqueles que estão na tabela com a qual o GlideRecord foi inicializado).

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#r_GlideRecord-AddJoinQuery_String_String_String__table_x3f_rpp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tabela | Cadeia de caracteres | Nome da tabela |
| PrimáriaryField | Cadeia de caracteres | Se for diferente de sys_id, o campo primário. |
| JoinTableField | Cadeia de caracteres | Se for diferente de sys_id, o campo que une as tabelas |
[Tabela 34. Parâmetros]

{#r_GlideRecord-AddJoinQuery_String_String_String__table_x3f_rpp_dt} {#r_GlideRecord-AddJoinQuery_String_String_String__table_y3f_rpp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | Registros em que os relacionamentos correspondem. |
[Tabela 35. Retorna]

{#r_GlideRecord-AddJoinQuery_String_String_String__table_y3f_rpp_dt}  
Encontre problemas com incidentes associados em que o valor do campo caller_id do incidente corresponde ao do campo Problema opened_by.

    var now_GR = new GlideRecord('problem'); 
    now_GR.addJoinQuery('incident', 'opened_by', 'caller_id'); 
    now_GR.query();

### Escopo equivalente {#r_GlideRecord-AddJoinQuery_String_String_String__section_tjh_zbs_mcb}

Para usar o método addJoinQuery() em uma aplicação com escopo, use o método com escopo correspondente: [AddJoinQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordAddJoinQuery_String_Object_Object "Adiciona um filtro para retornar registros com base em um relacionamento em uma tabela relacionada ao GlideRecord atual.").

## AddNotNullQuery (cadeia de caracteres fieldName) {#ariaid-title20}

Adiciona um filtro para retornar registros em que o campo especificado não é nulo.
{#r_GlideRecord-AddNotNullQuery_String__table_qkf_3tp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo. |
[Tabela 36. Parâmetros]

{#r_GlideRecord-AddNotNullQuery_String__table_qkf_3tp_dt} {#r_GlideRecord-AddNotNullQuery_String__table_rkf_3tp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | GlideQueryCondition de registros em que o campo de parâmetro não é nulo. |
[Tabela 37. Retorna]

{#r_GlideRecord-AddNotNullQuery_String__table_rkf_3tp_dt}  

    var target = new GlideRecord('incident'); 
      target.addNotNullQuery('short_description');
      target.query();   // Issue the query to the database to get all records
      while (target.next()) {   
         // add code here to process the incident record
      }

### Escopo equivalente {#r_GlideRecord-AddNotNullQuery_String__section_kh3_bcs_mcb}

Para usar o método addNotNullQuery() em uma aplicação com escopo, use o método com escopo correspondente: [AddNotNullQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordAddNotNullQuery_String "Um filtro que especifica registros em que o valor do campo passado no parâmetro não é nulo.").

## AddNullQuery (cadeia de caracteres fieldName) {#ariaid-title21}

Adiciona um filtro para retornar registros em que o campo especificado é nulo.
{#r_GlideRecord-AddNullQuery_String__table_jm5_vtp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo. |
[Tabela 38. Parâmetros]

{#r_GlideRecord-AddNullQuery_String__table_jm5_vtp_dt} {#r_GlideRecord-AddNullQuery_String__table_km5_vtp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | GlideQueryCondition de registros em que o campo especificado é nulo. |
[Tabela 39. Retorna]

{#r_GlideRecord-AddNullQuery_String__table_km5_vtp_dt}  

    var target = new GlideRecord('incident'); 
      target.addNullQuery('short_description');
      target.query();   // Issue the query to the database to get all records
      while (target.next()) {   
         // add code here to process the incident record
      }

### Escopo equivalente {#r_GlideRecord-AddNullQuery_String__section_n33_dcs_mcb}

Para usar o método addNullQuery() em uma aplicação com escopo, use o método com escopo correspondente: [AddNullQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordAddNullQuery_String "Adiciona um filtro para retornar registros em que o valor do campo especificado é nulo.").

## AddQuery (nome da cadeia de caracteres, operador do objeto, valor do objeto) {#ariaid-title22}

Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação.
Se você estiver familiarizado com SQL, este método será semelhante à cláusula "WHERE". Você pode fazer uma ou mais chamadas addQuery() em uma única consulta. Para este método, as consultas são AND'ed. Se alguma das instruções de consulta precisar ser OR'ed, use a classe [GlideQueryCondition](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#c_GlideQueryConditionAPI "Esta API fornece condições AND ou OR que podem ser adicionadas à condição atual, permitindo que você crie consultas complexas.").

AddQuery() é normalmente chamado com três parâmetros: Campo de tabela, operador e valor de comparação. Pode ser chamado com apenas dois parâmetros, campo de tabela e valor de comparação, como `myObj.addQuery('category','Hardware');`. Neste caso, o operador é considerado "igual a".

Para obter informações adicionais sobre como usar consultas, consulte [Consultar tabelas no script](https://www.servicenow.com/docs/q4J01nmu1lvw3Z5QUb0oJA#c_UsingGlideRecordToQueryTables "Usando métodos na API GlideRecord, você pode retornar todos os registros de uma tabela, retornar registros de uma tabela que atendam a condições específicas ou retornar registros que incluem uma cadeia de caracteres de uma única tabela ou de várias tabelas em um grupo de índice de texto.").

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 incluir 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. O uso de um método insert(), update(), deleteRecord() ou deleteMultiple() em resultados de consulta incorretos pode resultar em perda de dados.

Você pode definir a glide.invalid_query.returns_no_rows propriedade do sistema como verdadeiro para que 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 estiver definido como verdadeiro. Isso acontece em consultas em que um termo de consulta inválido é usado com um operador WHERE. Em tais consultas, o operador WHERE ignora o(s) termo(s) inválido(s), mas ainda interpreta e retorna o restante da instruçã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=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Nota:  
Para impor o acesso à consulta com base no usuário, use [AddUserQuery()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserQuery_S_O_O "Fornece a capacidade de criar uma solicitação que, quando executada, retorna as linhas da tabela especificada que correspondem à solicitação. O usuário solicitante deve ter acesso para executar a operação de consulta especificada no campo para que esta solicitação seja adicionada. Use este método para impor o acesso à consulta com base no usuário.").
{#r_GlideRecord-AddQuery_String_Object_Object__table_ix2_hvp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Caminho ou nome do campo da tabela para um atributo em um elemento de armazenamento de atributo dinâmico. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#r_GlideRecord-AddQuery_String_Object_Object__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
| operador | Object | Operador de consulta. Os valores disponíveis dependem do tipo de dados do <var class="keyword varname"></var> parâmetro Valor. Números: * = * != * \> * \>= * \< * \<= {#r_GlideRecord-AddQuery_String_Object_Object__ul_qyb_rbt_3y} Cadeias de caracteres (deve estar em maiúsculas): * = * != * IN * NÃO ESTÁ EM * INICIAR * ENDSWITH * CONTÉM * NÃO CONTÉM * INSTANCEOF {#r_GlideRecord-AddQuery_String_Object_Object__ul_egz_vbt_3y} Nota: Use CONTAINS em vez do operador LIKE. Operadores de esquema dinâmico: * = * != * \< * \> * \<= * \>= * ENTRE * CONTÉM * _NOT_CONTER * ENDSWITH * GT_FIELD * GT_OU_EQUALS_FIELD * IN * ISEMPTY * ISNOTEMPTY * IS_NOT_NULL * IS_NULL * COMO * LT_FIELD * LT_OR_EQUALS_FIELD * CORRESPONDÊNCIAS * NOT_IN * NÃO_GOSTO * NOT_MATCHES * NSAMEAS * SAMEAS * INICIAR |
| valor | Object | Valor no qual consultar (não diferencia maiúsculas de minúsculas). |
[Tabela 40. Parâmetros]

{#r_GlideRecord-AddQuery_String_Object_Object__table_ix2_hvp_dt} {#r_GlideRecord-AddQuery_String_Object_Object__table_jx2_hvp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideQueryCondition | Referência à GlideQueryCondition que foi adicionada ao GlideRecord. |
[Tabela 41. Retorna]

{#r_GlideRecord-AddQuery_String_Object_Object__table_jx2_hvp_dt}  
O exemplo a seguir mostra como chamar este método.

    var rec = new GlideRecord('incident');
    rec.addQuery('active',true);
    rec.addQuery('sys_created_on', ">", "2010-01-19 04:05:00");
    rec.query();
    while (rec.next()) { 
     rec.active = false;
     gs.print('Active incident ' + rec.number + ' closed');
     rec.update();
    }

O exemplo a seguir mostra como usar o operador IN.

    var que = new GlideRecord('incident');
    que.addQuery('number','IN','INC00001,INC00002');
    que.query();
    while(que.next()) {
     //do something....
    }

O exemplo a seguir mostra como chamar este método usando atributos em um armazenamento dinâmico de atributos.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.addQuery('inc_dynamic_schema->avg_mpg', 'GT_FIELD', 'inc_dynamic_schema2->avg_mpg'); 
    gr_Inc.query();
    while(gr_Inc.next()) {
        gs.info(gr_Inc.number + " Gas Mileage 1: " + gr_Inc.getDynamicAttributeValue('inc_dynamic_schema->avg_mpg') +  " GT_FIELD Gas Mileage 2 :" + gr_Inc.getDynamicAttributeValue('inc_dynamic_schema2->avg_mpg'));
    }

### Escopo equivalente {#r_GlideRecord-AddQuery_String_Object_Object__section_swp_3cs_mcb}

Para usar o método addQuery() em uma aplicação com escopo, use o método com escopo correspondente: [AddQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#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.").

## AddValue (campo de cadeia de caracteres, valor numérico) {#ariaid-title23}

Fornece operações atômicas de adição e subtração em um campo numérico especificado no nível do banco de dados para o objeto GlideRecord atual.
Um objeto GlideRecord é escrito como um registro em um banco de dados. Os valores de campos individuais são armazenados conforme definido. Para código que adiciona um valor a um campo GlideRecord, ele simplesmente salva o campo no banco de dados com o novo valor, em vez de incrementá-lo atomicamente.  
Por exemplo, quando o código a seguir é executado, o valor do campo u_count no banco de dados é 2.

    gs.print(now_now_GR.u_count); // "1" 
    now_GR.u_count += 1; 
    now_GR.update(); 
    now_GR.get(now_now_GR.sys_id); 
    gs.print(now_now_GR.u_count); // "2"   

Se outro usuário executar simultaneamente código idêntico, em vez de as duas operações adicionarem 1 a u_count, o efeito líquido é que u_count contém apenas 2, com a atualização de uma operação realmente sendo perdida.  
Por outro lado, o método addValue() executa a adição/subtração no banco de dados quando o registro é atualizado como uma operação atômica. Cada uma das operações em execução simultaneamente atualiza corretamente o campo.

    gs.print(now_now_GR.u_count); // "1" 
    now_GR.addValue("u_count", 1); 
    now_GR.update(); 
    now_GR.get(now_GR); // The record must be reloaded from the database to observe the result
    gs.print(now_now_GR.u_count); // "3", if executed concurrently with another user 

Nota:  
O novo valor não é lido do banco de dados, a menos que explicitamente feito isso.

Como setValue(), as mudanças addValue() só entram em vigor no banco de dados após uma chamada subsequente para update() ou insert(). Se insert() for chamado, o campo especificado será inicializado com o value parâmetro passado para addValue().  
Nota:  
Se setValue() for chamado para o campo especificado antes de chamar addValue(), o método addValue() não será processado e uma mensagem de erro será registrada.
{#GlideRecord-addValue_S_N__table_h43_tjt_hlb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| campo | Cadeia de caracteres | O nome do campo neste GlideRecord a ser modificado. Se o campo associado não for um tipo numérico, a operação será ignorada. |
| valor | Número | O valor a ser adicionado ao valor quando o registro for salvo. Para executar uma operação de subtração, basta passar um valor negativo. |
[Tabela 42. Parâmetros]

{#GlideRecord-addValue_S_N__table_h43_tjt_hlb} {#GlideRecord-addValue_S_N__table_i43_tjt_hlb__entry__2}

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

{#GlideRecord-addValue_S_N__table_i43_tjt_hlb}  
Mostra um valor que está sendo adicionado.

    gs.print(now_GR.u_count); // "1" 
    now_GR.addValue("u_count", 1); 
    now_GR.update(); 
    now_GR.get(now_GR.sys_id); // The record must be reloaded from the database to observe the result
    gs.print(now_GR.u_count);

Saída: 2  
Mostra um valor que está sendo subtraído.

    gs.print(now_GR.u_count); // "4" 
    now_GR.addValue("u_count", -1); 
    now_GR.update(); 
    now_GR.get(now_GR.sys_id); // The record must be reloaded from the database to observe the result
    gs.print(now_GR.u_count);

Saída: 3

## GlideRecord - applyEncodedQuery (cadeia de caracteres querystring) {#ariaid-title24}

Define os valores dos termos de consulta codificados especificados e os aplica ao GlideRecord atual.
{#GlideRecord-applyEncodedQuery_S__table_p5j_nfg_rmb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Cadeia de caracteres de consulta | Cadeia de caracteres | Consulta codificada a ser aplicada ao GlideRecord atual. |
[Tabela 44. Parâmetros]

{#GlideRecord-applyEncodedQuery_S__table_p5j_nfg_rmb} {#GlideRecord-applyEncodedQuery_S__table_q5j_nfg_rmb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 45. Retorna]

{#GlideRecord-applyEncodedQuery_S__table_q5j_nfg_rmb}  
<br />

    function createAcl(table, role) {
      gs.print("Checking security on table " + table);
      var now_GR = new GlideRecord("sys_security_acl");
      now_GR.addQuery("name", table);
      now_GR.addQuery("operation", "read");
      now_GR.query();
      var encQuery = now_GR.getEncodedQuery();
      if (now_GR.next()) {
        // existing acl found so use it
        createAclRole(now_GR.sys_id.toString(), role);
        return;
      } else {
      now_GR.initialize();
      now_GR.applyEncodedQuery(encQuery);
      var acl = now_GR.insert();
        gs.print("Added read access control on " + table);
        createAclRole(acl, role);
      } 
    }

## ApplyTemplate (modelo de cadeia de caracteres) {#ariaid-title25}

Aplique um registro de modelo da tabela de modelo \[sys_template\] ao registro atual. Se o modelo especificado não for encontrado, nenhuma ação será realizada.
Nota:  
Este método instanciará automaticamente um método now_GR.insert() se um modelo tiver o campo Próximo modelo secundário relacionado preenchido. Para obter informações, consulte [Criar modelos para registros de tarefa relacionados](https://www.servicenow.com/docs/access?context=create-templates-for-related-task-records&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#r_GlideRecord-applyTemplate_String__table_r2n_mlw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| modelo | Cadeia de caracteres | Nome de um modelo da tabela Modelos \[sys_template\]. |
[Tabela 46. Parâmetros]

{#r_GlideRecord-applyTemplate_String__table_r2n_mlw_dt} {#r_GlideRecord-applyTemplate_String__table_s2n_mlw_dt__entry__2}

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

{#r_GlideRecord-applyTemplate_String__table_s2n_mlw_dt}  

    var rec1 = new GlideRecord("incident");
    rec1.initialize();
    rec1.applyTemplate("my_incident_template");
    rec1.insert();

## AutoSysFields (booliano e) {#ariaid-title26}

Habilita ou desabilita a atualização para os campos sys_updated_by, sys_updated_on, sys_mod_count, sys_created_by e sys_created_on. Isso geralmente é usado para atualizar manualmente valores de campo em um registro, deixando as informações históricas inalteradas.
Aviso:  
Se você usar este método, tenha cuidado. Quando você usar este método, o campo sys_mod_count não será incrementado e outros campos sys_ não serão atualizados. Isso pode interromper a funcionalidade, incluindo, entre outros, o formatador de atividades, conjuntos de histórico, notificações e métricas.
{#r_GlideRecord-autoSysFields_Boolean__table_t32_tfw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| e | Booliano | Se for falso, desabilita atualizações em sys_updated_by, sys_updated_on, sys_mod_count, sys_created_by e sys_created_on. |
[Tabela 48. Parâmetros]

{#r_GlideRecord-autoSysFields_Boolean__table_t32_tfw_dt} {#r_GlideRecord-autoSysFields_Boolean__table_u32_tfw_dt__entry__2}

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

{#r_GlideRecord-autoSysFields_Boolean__table_u32_tfw_dt}  

    var inc = new GlideRecord('incident');
     
    // Change all Open(1) incidents to Active(2)
     
    inc.addQuery('state', 1);
    inc.query();
     
    while (inc.next()) {
      inc.autoSysFields(false);  // Do not update sys_updated_by, sys_updated_on, sys_mod_count, sys_created_by, and sys_created_on
      inc.setWorkflow(false);    // Do not run any other business rules
      inc.setValue('state', 2);
      inc.update();
    }

## CanCreate() {#ariaid-title27}

Determina se as regras de controle de acesso (que inclui a função do usuário) permitem inserir novos registros nesta tabela.
{#r_GlideRecord-CanCreate__table_qyz_pwp_dt__entry__3}

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

{#r_GlideRecord-CanCreate__table_qyz_pwp_dt} {#r_GlideRecord-CanCreate__table_ryz_pwp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se as funções do usuário permitem a criação de registros nesta tabela. Valores possíveis: * Verdadeiro: Criação permitida * Criar não é permitido {#r_GlideRecord-CanCreate__ul_vtm_pf2_t3b} |
[Tabela 51. Retorna]

{#r_GlideRecord-CanCreate__table_ryz_pwp_dt}  
Este exemplo mostra se os registros podem ser criados na tabela Benefit_plan.

    canCreateBenefitPlan : function() {
      var now_GR = new GlideRecord('benefit_plan');
      return now_GR.canCreate();
    }

### Escopo equivalente

Para usar o método canCreate() em uma aplicação com escopo, use o método com escopo correspondente: [CanCreate()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordCanCreate "Determina se as Regras de controle de acesso, que incluem as funções do usuário, permitem inserir novos registros nesta tabela.").

## CanDelete() {#ariaid-title28}

Determina se as regras de controle de acesso (que inclui a função do usuário) permitem a exclusão de registros nesta tabela.
{#r_GlideRecord-CanDelete__table_kmz_zwp_dt__entry__3}

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

{#r_GlideRecord-CanDelete__table_kmz_zwp_dt} {#r_GlideRecord-CanDelete__table_lmz_zwp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se as funções do usuário permitem a exclusão de registros nesta tabela. Valores válidos: * Verdadeiro: Exclusão permitida * Não é permitido excluir {#r_GlideRecord-CanDelete__ul_vtm_pf2_t3b} |
[Tabela 53. Retorna]

{#r_GlideRecord-CanDelete__table_lmz_zwp_dt}  

    var att = new GlideRecord('sys_attachment');
    att.get('$[sys_attachment.sys_id]');
    var sm = GlideSecurityManager.get();
    var checkMe = 'record/sys_attachment/delete';
    var canDelete = sm.hasRightsTo(checkMe, att);
    gs.log('canDelete: ' + canDelete);

### Escopo equivalente {#r_GlideRecord-CanDelete__section_itl_mcs_mcb}

Para usar o método canDelete() em uma aplicação com escopo, use o método com escopo correspondente: [CanDelete()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordCanDelete "Determina se as Regras de controle de acesso, que incluem as funções do usuário, permitem excluir registros nesta tabela.").

## CanRead() {#ariaid-title29}

Indica se as regras de controle de acesso (ACLs) permitem que o usuário atual leia o registro atual na tabela GlideRecord associada. Este método avalia todas as ACLs disponíveis para o recurso específico.
Nota:  
Você não deve usar este método para verificar o acesso no nível da tabela. Uma única chamada a este método pode não ser suficiente para obter um resultado conclusivo da verificação de direitos de acesso no nível da tabela. Para executar uma verificação de acesso no nível da tabela, use o método GlideSecurityManager.hasRightsTo().

Para obter informações adicionais sobre ACLs, consulte [Pedido de avaliação de controles de acesso](https://developer.servicenow.com/dev.do#!/learn/learning-plans/yokohama/servicenow_application_developer/app_store_learnv2_securingapps_yokohama_access_controls_evaluation_order).
{#r_GlideRecord-CanRead__table_c3g_4xp_dt__entry__3}

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

{#r_GlideRecord-CanRead__table_c3g_4xp_dt} {#r_GlideRecord-CanRead__table_d3g_4xp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se as funções do usuário permitem a leitura do registro atual. Valores válidos: * Verdadeiro: Leitura permitida * Leitura não é permitida {#r_GlideRecord-CanRead__ul_vtm_pf2_t3b} |
[Tabela 55. Retorna]

{#r_GlideRecord-CanRead__table_d3g_4xp_dt}  
Este exemplo mostra como iterar na tabela Incidente \[incidente\] e verificar se o usuário tem direitos de leitura para cada registro.

    var grTable = new GlideRecord('incident');
    grTable.query();
    while (grTable.next()) {
      if (grTable.canRead()) 
    		...
    }

### Escopo equivalente

Para usar o método canRead() em uma aplicação com escopo, use o método com escopo correspondente: [CanRead()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordCanRead "Determina se as regras de controle de acesso (ACLs) permitem registros de leitura nesta tabela. Este método avalia todos os tipos de ACL, como funções de usuário, ACLs com script, ACLs com condições com script e assim por diante.").

## CanWrite() {#ariaid-title30}

Determina se as regras de controle de acesso (que inclui a função do usuário) permitem atualizações nos registros nesta tabela.
{#r_GlideRecord-CanWrite__table_srp_xxp_dt__entry__3}

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

{#r_GlideRecord-CanWrite__table_srp_xxp_dt} {#r_GlideRecord-CanWrite__table_trp_xxp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se as funções do usuário permitem a gravação de registros nesta tabela. Valores válidos: * Verdadeiro: Gravação permitida * Escrita não é permitida {#r_GlideRecord-CanWrite__ul_vtm_pf2_t3b} |
[Tabela 57. Retorna]

{#r_GlideRecord-CanWrite__table_trp_xxp_dt}  
Este exemplo mostra se os registros podem ser gravados na tabela Benefit_plan.

    canWriteBenefitPlan : function() {
      var now_GR = new GlideRecord('benefit_plan');
      return now_GR.canWrite();
    }

### Escopo equivalente

Para usar o método canWrite() em uma aplicação com escopo, use o método com escopo correspondente: [CanWrite()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordCanWrite "Determina se as Regras de controle de acesso, que incluem as funções do usuário, permitem a edição de registros nesta tabela.").

## GlideRecord - Changes() {#ariaid-title31}

Determina se algum dos campos no registro foi alterado.
{#r_GlideRecord-Changes__table_ofg_gyp_dt__entry__3}

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

{#r_GlideRecord-Changes__table_ofg_gyp_dt} {#r_GlideRecord-Changes__table_pfg_gyp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se há mudanças no registro especificado. Valores possíveis: * Verdadeiro: Os campos no registro especificado foram alterados. * Falso: Nenhum campo foi alterado. {#r_GlideRecord-Changes__ul_cqj_2fx_z4b} |
[Tabela 59. Retorna]

{#r_GlideRecord-Changes__table_pfg_gyp_dt}  
Este exemplo mostra como verificar se há mudanças em um registro de incidente.

    var now_GR = new GlideRecord("incident");
    now_GR.query();
    now_GR.next();
    if (now_GR.changes()) {
      gs.print("The incident record reported changes right after being read");
    } else {
      gs.print("The incident record has not changed");
    }

### Escopo equivalente

Para implementar esta funcionalidade em uma aplicação com escopo, adicione um código semelhante ao seguinte:

    var now_GR = new GlideRecord("incident");
       now_GR.get("965c9e5347c12200e0ef563dbb9a7156");
       now_GR.short_description = "test";
       var elements = now_GR.getElements();
       var hasChanged = false;
       for(var i=0; i < elements.length;i++){
         var element = elements[i];
         hasChanged = hasChanged || element.changes();
         gs.info(element.getName() + ":" + element.changes());
       }
       gs.info(hasChanged);

## ChooseWindow (Number firstLine, Number lastRow, boolian forceCount) {#ariaid-title32}

Define um intervalo de linhas a serem retornadas por consultas subsequentes.

Usando setLimit() com chooseWindow()
:   O método setLimit() chama implicitamente o método chooseWindow() e pode causar resultados inesperados quando usado com chooseWindow() em uma consulta.

    * Se o método chooseWindow() for chamado primeiro, sua janela de registro será substituída pelo método setLimit().  
      Usar as seguintes linhas em uma consulta retorna 100 registros começando na linha 1:

          grIncident.chooseWindow(20,30);
          grIncident.setLimit(100);

    * Se o método setLimit() for chamado primeiro, a janela definida por chooseWindow() será usada e o limite será substituído.  
      Usar as seguintes linhas em uma consulta retorna 10 registros começando na linha 21:

          grIncident.setLimit(5);
          grIncident.chooseWindow(20,30);

      Nota:  
      Executar query() com o método chooseWindow() aciona uma consulta COUNT(\*), o que pode resultar em desempenho lento em tabelas com um grande número de registros. Você pode usar setLimit() antes de chooseWindow() para ignorar a execução da consulta COUNT(\*), mas o mesmo benefício de desempenho é possível usando setNoCount().
    {#GR-chooseWindow_N_N_B__ul_btb_yhw_wgc}
Consulte também:

* [consulta ()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-query_Object_Object "Executa uma consulta na tabela com base nos filtros especificados nos métodos de consulta, como addQuery() e addEncodedQuery().")
* [SetLimit()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-setLimit_Number "Define o número máximo de registros a serem retornados no GlideRecord de uma consulta.")
* [SetNoCount()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-setNoCount "Impede que uma consulta GlideRecord execute uma consulta COUNT(*).")
{#GR-chooseWindow_N_N_B__ul_vmm_cfj_xgc}
{#GR-chooseWindow_N_N_B__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Primeira linha | Número | Índice baseado em zero da linha inicial do intervalo, inclusive. (O valor 0 retorna a primeira linha.) |
| LastRow | Número | Índice baseado em zero da linha final do intervalo, Exclusivo. Por exemplo, se firstRow for igual a 1 e lastRow igual a 5, quatro registros serão retornados (2-5). |
| ForceCount | Booliano | Opcional. Sinalizador que indica se uma consulta de contagem de linhas deve ser forçada. Na maioria das implementações desta chamada, a contagem de linhas é realizada. Há alguns casos periféricos, como pesquisas de texto, em que uma contagem de linhas não foi realizada. A definição deste sinalizador garante que a contagem de linhas ocorra. Valores válidos: * Verdadeiro: A contagem de linhas sempre ocorre. * Falso: A contagem de linhas ocorre se implementada na execução normal do método. {#GR-chooseWindow_N_N_B__ul_fgp_42j_gqb} Padrão: falso |
[Tabela 60. Parâmetros]

{#GR-chooseWindow_N_N_B__table_vy2_525_jq} {#GR-chooseWindow_N_N_B__table_twn_tdk_fdc__entry__2}

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

{#GR-chooseWindow_N_N_B__table_twn_tdk_fdc}  
Este exemplo mostra como retornar os registros 3 e 4 da tabela Incidente \[incidente\].

    var now_GR = new GlideRecord('incident');
    now_GR.orderBy('number');
    now_GR.chooseWindow(2, 4);
    now_GR.query();
    while (now_GR.next()) {
      gs.info(now_GR.getValue('number') + ' is within window');
    }

Saída:

    *** Script: INC0000003 is within window
    *** Script: INC0000004 is within window

## GlideRecord - deleteMultiple() {#ariaid-title33}

Exclui todos os registros que atendem à consulta.
Este método não exclui anexos.

A referência com pontos não é compatível com este método. Ao usar a função deleteMultiple() em tabelas referenciadas, todos os registros na tabela são excluídos. Além disso, ao usar deleteRecord() para exclusão em cascata, as chamadas anteriores a setWorkflow() no mesmo objeto GlideRecord são ignoradas.

Não use deleteMultiple() em tabelas com campos de moeda. Sempre exclua cada registro individualmente. Além disso, não use este método com os métodos chooseWindow() ou setLimit() ao trabalhar com tabelas grandes. O método setLimit() não limita o número de registros excluídos com deleteMultiple(). Todos os registros retornados pela consulta são excluídos independentemente de setLimit().

A glide.db.forced.chunk.threshold propriedade do sistema define o limite acima do qual força exclusões e atualizações de registro de bloco. O agrupamento ajuda a evitar que exclusões de chaves não primárias em tabelas enormes causem problemas de replicação. Para obter mais informações, consulte [Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Nota:  
Ao usar deleteMultiple() para exclusão em cascata, as chamadas anteriores a setWorkflow() no mesmo objeto GlideRecord são ignoradas.
{#r_GlideRecord-deleteMultiple__table_ck5_g1x_dt__entry__3}

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

{#r_GlideRecord-deleteMultiple__table_ck5_g1x_dt} {#r_GlideRecord-deleteMultiple__table_dk5_g1x_dt__entry__2}

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

{#r_GlideRecord-deleteMultiple__table_dk5_g1x_dt}  
Este exemplo mostra como excluir todos os registros inativos da tabela Incidente.

    var now_GR = new GlideRecord('incident');
    now_GR.addQuery('active','false');
    now_GR.query();
    now_GR.deleteMultiple();

### Escopo equivalente {#r_GlideRecord-deleteMultiple__section_gy3_zcs_mcb}

Para usar o método deleteMultiple() em uma aplicação com escopo, use o método com escopo correspondente: [DeleteMultiple()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordDeleteMultiple "Exclui todos os registros que atendem à consulta.").

## GlideRecord - deleteRecord() {#ariaid-title34}

Exclui um único registro.
{#r_GlideRecord-deleteRecord__table_xqy_s1x_dt__entry__3}

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

{#r_GlideRecord-deleteRecord__table_xqy_s1x_dt} {#r_GlideRecord-deleteRecord__table_yqy_s1x_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o registro foi excluído com sucesso. Valores possíveis: * Verdadeiro: O registro foi excluído. * Falso: Nenhum registro foi encontrado para excluir. {#r_GlideRecord-deleteRecord__ul_hkn_5bj_s3b} |
[Tabela 65. Retorna]

{#r_GlideRecord-deleteRecord__table_yqy_s1x_dt}  
Este exemplo mostra como excluir todos os registros inativos da tabela Incidente.

    var rec = new GlideRecord('incident');
    rec.addQuery('active',false);
    rec.query();
    while (rec.next()) { 
     gs.info('Inactive incident ' + rec.number + ' deleted');
     rec.deleteRecord();
    }

Saída:

    Inactive incident INC0010010 deleted
    Inactive incident INC0010011 deleted

Este exemplo mostra como excluir um registro da tabela Incidente imediatamente após ele ser inserido. O GlideRecord do incidente deve ser recarregado após a inserção antes que possa ser excluído.

    var grTicket = new GlideRecord('incident');
    grTicket.initialize();
    grTicket.short_description = 'Example ticket';
    grTicket.work_notes = 'An update about the ticket';
    var ins_sys_id = grTicket.insert(); // Insert the record
    grTicket.get(ins_sys_id); // Reload the inserted record
    gs.info(grTicket.deleteRecord()); // Delete the record

Saída:

    true

### Escopo equivalente {#r_GlideRecord-deleteRecord__section_h4z_1ds_mcb}

Para usar o método deleteRecord() em uma aplicação com escopo, use o método com escopo correspondente: [DeleteRecord()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordDeleteRecord "Exclui o registro atual.").

## GlideRecord - disableSysIdInOptimization() {#ariaid-title35}

Desabilita a otimização padrão que impede a execução de uma consulta de banco de dados extra quando um usuário passa um grande número de sys_ids, como `grIncident.addQuery('sys_id', 'IN', listOf200SysIds)`.
Este método afeta apenas o GlideRecord no qual é chamado. Para modificar a otimização do limite sys_id para todos os GlideRecords, ajuste o valor na glide.db.first_pass_sys_id_list_size.max propriedade do sistema (padrão 100).

Se você não chamar este método ou ajustar a glide.db.first_pass_sys_id_list_size.max propriedade do sistema e passar uma lista que contém mais entradas sys_id do que o definido em glide.db.first_pass_sys_id_list_size.max, o valor retornado de GlideRecord.getRowCount() pode estar incorreto.
{#GR-disableSysIdInOptimization__table_ilp_2cg_zcc__entry__3}

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

{#GR-disableSysIdInOptimization__table_ilp_2cg_zcc} {#GR-disableSysIdInOptimization__table_jlp_2cg_zcc__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 67. Retorna]

{#GR-disableSysIdInOptimization__table_jlp_2cg_zcc}  
O exemplo de código a seguir mostra como usar o método disableSysIdInOptimiation() para desabilitar a otimização de limite sys_id ao passar uma lista de sys_id de incidente que contém 200 entradas.

    var listOf200SysIds = [ ... ]; // 200 comma separated sys_ids
    var grIncident = new GlideRecord('incident');
    grIncident.addQuery('sys_id', 'IN', listOf200SysIds);
    grIncident.disableSysIdInOptimization(); // Rowcount could be incorrect without this method call
    grIncident.query();
    if (grIncident.next())
        gs.info("Rowcount: " + grIncident.getRowCount());

Saída:

    Rowcount: 200

## Localizar (cadeia de caracteres columnName, valor da cadeia de caracteres) {#ariaid-title36}

Retorna verdadeiro se algum registro tiver um valor correspondente na coluna especificada. Se encontrado, ele também move para o primeiro registro correspondente, essencialmente executando next() até que o registro seja retornado.
Nota:  
Este método cria um registro em vez de atualizar o registro existente se você aplicar o método update() após modificar o GlideRecord. Para evitar criar um registro, chame o método next() antes de chamar find(). Por exemplo:

    var existingMaterials = new GlideRecord('u_m2m_material_num_service_instance');
    existingMaterials.addQuery('u_service_instance', serviceInstance.sys_id);
    existingMaterials.query();
    existingMaterials.next(); // This line added to prevent new record creation

    existingMaterials.find('u_material_number', 'ca41b9fd37a84200fdc25ca543990ed8');

    existingMaterials.u_material_quantity = 5;
    existingMaterials.update("Modify request via catalog");

Consulte também:

* [próximo()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-next "Move para o próximo registro no GlideRecord.")
* [update()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-update_Object "Atualiza o GlideRecord com todas as mudanças que foram feitas. Se o registro não existir, ele será inserido.")
{#r_GlideRecord-Find_String_String__ul_nfc_rxc_lgc}
{#r_GlideRecord-Find_String_String__table_k1m_qyp_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ColumnName | Cadeia de caracteres | Nome do campo a ser pesquisado. |
| valor | Cadeia de caracteres | Valor a ser verificado no campo especificado. |
[Tabela 68. Parâmetros]

{#r_GlideRecord-Find_String_String__table_k1m_qyp_dt} {#r_GlideRecord-Find_String_String__table_l1m_qyp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se algum registro na tabela atual tem um valor correspondente no campo especificado. Valores possíveis: * Verdadeiro: Campo correspondente. * Falso: Nenhum campo correspondente. |
[Tabela 69. Retorna]

{#r_GlideRecord-Find_String_String__table_l1m_qyp_dt}  
Este exemplo mostra como encontrar um registro na tabela Incidente com "Crítico" no campo Descrição resumida.

    var now_GR = new GlideRecord("incident");
    now_GR.query();
    var shortDescription = "Critical";
    if (now_GR.find("short_description", shortDescription)) {
      gs.print("An incident with the specified field value was found");
      var recordID = now_GR.getValue("sys_id");
      gs.print("Found in the following record: " + recordID);
    } else {
      gs.print("An incident with the specified field value was not found");
    }

Saída:

    An incident with the specified field value was found
    Found in the following record: 552c48888c033300964f4932b03eb092

## Get (nome do objeto, valor do objeto) {#ariaid-title37}

Retorna o registro especificado no objeto GlideRecord atual.
Este método aceita um ou dois parâmetros. Se apenas um único parâmetro for passado, o método assume que é o sys_id do registro desejado. Se não for encontrado, ele tentará corresponder o valor ao valor de exibição. Se dois parâmetros forem passados, o primeiro será o nome da coluna dentro do GlideRecord a ser pesquisado. O segundo é o valor a ser pesquisado. Se vários registros forem encontrados, use next() para acessar os registros adicionais.
{#r_GlideRecord-get_Object_Object__table_bwp_pcr_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Object | Opcional. Nome da coluna GlideRecord instanciado para pesquisar o value parâmetro especificado. Se apenas um parâmetro for passado, o método presume que esse parâmetro é sys_id. |
| valor | Object | Valor a ser correspondido. Para campos calculados, o valor é correspondido como está, em vez de executar um cálculo em um valor padrão com script para um campo no registro. |
[Tabela 70. Parâmetros]

{#r_GlideRecord-get_Object_Object__table_bwp_pcr_dt} {#r_GlideRecord-get_Object_Object__table_cwp_pcr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Indica se o registro solicitado foi localizado. Valores possíveis: * Verdadeiro: O registro foi encontrado * Falso: O registro não foi encontrado {#r_GlideRecord-get_Object_Object__ul_ngs_clw_qfb} |
[Tabela 71. Retorna]

{#r_GlideRecord-get_Object_Object__table_cwp_pcr_dt}  
Este exemplo obtém um registro de incidente passando o sys_id.

    var grIncident = new GlideRecord('incident');
    var returnValue = grIncident.get('99ebb4156fa831005be8883e6b3ee4b9');
    gs.info(returnValue); // logs true or false
    gs.info(grIncident.number); // logs Incident Number

Este exemplo obtém um registro de incidente passando a coluna no registro a ser pesquisado e o valor a ser pesquisado.

    var grIncident = new GlideRecord('incident');
    var returnValue = grIncident.get('caller_id.name','Sylivia Wayland');
    gs.info(returnValue); // logs true or false
    gs.info(grIncident.number); // logs Incident Number

### Escopo equivalente {#r_GlideRecord-get_Object_Object__section_rcl_s2s_mcb}

Para usar o método get() em uma aplicação com escopo, use o método com escopo correspondente: [Get()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGet_Object_Object "Retorna o registro especificado no objeto GlideRecord atual.").

## GetAttribute (cadeia de caracteres fieldName) {#ariaid-title38}

Retorna os atributos de dicionário no campo especificado.
{#r_GlideRecord-getAttribute_String__table_b2b_jdr_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo para o qual os atributos do dicionário serão retornados |
[Tabela 72. Parâmetros]

{#r_GlideRecord-getAttribute_String__table_b2b_jdr_dt} {#r_GlideRecord-getAttribute_String__table_c2b_jdr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Atributos do dicionário |
[Tabela 73. Retorna]

{#r_GlideRecord-getAttribute_String__table_c2b_jdr_dt}  
Este exemplo mostra como retornar os atributos de dicionário para "tree_picker".

    function doit() {
      var now_GR = new GlideRecord('sys_user');
      now_GR.query("user_name","admin");
      if (now_GR.next()) {
        gs.print("we got one");
        gs.print(now_GR.location.getAttribute("tree_picker"));
      }
    }

### Escopo equivalente {#r_GlideRecord-getAttribute_String__section_bmb_dds_mcb}

Para usar o método getAttribute() em uma aplicação com escopo, use o método com escopo correspondente: [GetAttribute()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-getAttribute_S "Retorna os atributos de dicionário para o campo especificado.").

## GlideRecord - getClassDisplayValue() {#ariaid-title39}

Retorna o rótulo da tabela.
{#r_GlideRecord-getClassDisplayValue__table_ltd_ydr_dt__entry__3}

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

{#r_GlideRecord-getClassDisplayValue__table_ltd_ydr_dt} {#r_GlideRecord-getClassDisplayValue__table_mtd_ydr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Rótulo que identifica a tabela. |
[Tabela 75. Retorna]

{#r_GlideRecord-getClassDisplayValue__table_mtd_ydr_dt}  
Este exemplo imprime o rótulo da tabela Passado em.

    // Display the incident table label
    var now_GR = new GlideRecord("incident");
    var value = now_GR.getClassDisplayValue();
    gs.info("The table label is " + value + ".");

Saída:

    The table label is Incident.

### Escopo equivalente

Para usar o método getClassDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: [GetClassDisplayValue()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-getClassDisplayValue "Retorna o rótulo da tabela atual.").

## GetDisplayValue (nome da cadeia de caracteres) {#ariaid-title40}

Recupera o valor de exibição do registro atual ou o valor de exibição de um atributo em um armazenamento dinâmico de atributos.
[Display values](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US) são manipulados com base no valor real no banco de dados e nas configurações e preferências do usuário ou do sistema.  
O valor de exibição retornado depende do tipo de campo.

* Campos de seleção: O valor do banco de dados pode ser um número, mas o valor de exibição é mais descritivo.
* Campos de data: O valor do banco de dados está no formato UTC, enquanto o valor de exibição é baseado no fuso horário do usuário.
* Texto criptografado: O valor do banco de dados é criptografado, enquanto o valor exibido não é criptografado com base no contexto de criptografia do usuário.
* Campos de referência: O valor do banco de dados é sys_id, mas o valor de exibição é o campo de exibição do registro referenciado.
{#r_GlideRecord-getDisplayValue__ul_ok1_cbv_hsb}

Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#r_GlideRecord-getDisplayValue__table_kps_f2r_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Opcional. Necessário somente ao solicitar o valor de exibição de um atributo dinâmico. Caminho para um atributo em um esquema dinâmico a ser recuperado. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#r_GlideRecord-getDisplayValue__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
[Tabela 76. Parâmetros]

{#r_GlideRecord-getDisplayValue__table_kps_f2r_dt} {#r_GlideRecord-getDisplayValue__table_lps_f2r_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de exibição do registro atual ou do elemento especificado. |
[Tabela 77. Retorna]

{#r_GlideRecord-getDisplayValue__table_lps_f2r_dt}  
Este exemplo grava o valor de exibição de um registro de incidente especificado no log.

    var now_GR = new GlideRecord('incident');
    now_GR.get('sys_id','<sys_id>');
    gs.info(now_GR.getDisplayValue());

Saída:

    INC0000050

Este exemplo mostra como recuperar o valor de exibição de um atributo em um elemento de armazenamento de atributo dinâmico.

    var gr_AppTab = new GlideRecord('application_table'); 
    gr_AppTab.setValue('dyn_att_field->attr', 42); 
    gr_AppTab.setDisplayValue('dyn_att_field->attr2, true);
    gr_AppTab.update();
    gs.info('Attr value: ' + 
    gr_AppTab.getDisplayValue('dyn_att_field->attr);
    gs.info('Attr2 value: ' + 
    gr_AppTab.getDisplayValue('dyn_att_field->attr2);

Saída:

    Attr value: System error
    Attr2 value: true

### Escopo equivalente {#r_GlideRecord-getDisplayValue__section_j51_nds_mcb}

Para usar o método getDisplayValue() em uma aplicação com escopo, use o método com escopo correspondente: [GetDisplayValue()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGetDisplayValue "Recupera o valor de exibição do registro atual.").

## GetDynamicAttribute (cadeia de caracteres fullPath) {#ariaid-title41}

Retorna o objeto GlideElementDynamicAttribute para o caminho de armazenamento de atributos dinâmicos especificado.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-getDynamicAttribute_S__ul_cx2_lf1_r3c}
{#GR-getDynamicAttribute_S__table_rgk_h1x_1bc__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Caminho completo | Cadeia de caracteres | Caminho a ser usado para localizar o atributo dinâmico desejado. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#GR-getDynamicAttribute_S__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
[Tabela 78. Parâmetros]

{#GR-getDynamicAttribute_S__table_rgk_h1x_1bc} {#GR-getDynamicAttribute_S__table_sgk_h1x_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Object | Objeto GlideElementDynamicAttribute que contém o atributo dinâmico especificado. Se o fullPath parâmetro for inválido, retornará nulo. |
[Tabela 79. Retorna]

{#GR-getDynamicAttribute_S__table_sgk_h1x_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.get('number', 'INC0009009');
    gr_Inc.getDynamicAttribute('attr_store->color').setValue('Blue');
    gr_Inc.update();

    gr_Inc = new GlideRecord('incident');
    gr_Inc.get('number', 'INC0009009');
    gs.info(gr_Inc.getDynamicAttribute('attr_store', 'color'));

Saída:

    *** Script: Blue

## GetDynamicAttribute(cadeia de caracteres dynamicAttributeField, cadeia de caracteres attrPath) {#ariaid-title42}

Retorna um objeto GlideElementDynamicAttribute que contém o atributo dinâmico localizado no campo de tabela especificado e no caminho do atributo.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-getDynamicAttribute_S_S__ul_cx2_lf1_r3c}
{#GR-getDynamicAttribute_S_S__table_yzz_p1x_1bc__entry__3}{#GR-getDynamicAttribute_S_S__DynS-dynamicAttributeField-entry}

| Nome | Tipo | Descrição |
|-|-|-|
| DynamicAttributeField | Cadeia de caracteres | Nome do campo na tabela que contém o atributo dinâmico. |
| Caminho de atributo | Cadeia de caracteres | Caminho do atributo a ser usado para localizar o atributo do esquema dinâmico associado. Formato: `"attr_name"` `attr_name`: Nome do atributo dinâmico. Tabela: No campo de atributo da tabela Atributo dinâmico \[dynamic_attribute\]. |
[Tabela 80. Parâmetros]

{#GR-getDynamicAttribute_S_S__table_yzz_p1x_1bc} {#GR-getDynamicAttribute_S_S__table_zzz_p1x_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Object | Objeto GlideElementDynamicAttribute que contém o atributo dinâmico especificado. Se os dynamicAttributeFieldattrPath parâmetros ou forem inválidos, retornará nulo. |
[Tabela 81. Retorna]

{#GR-getDynamicAttribute_S_S__table_zzz_p1x_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.get('number', 'INC0009009');
    gr_Inc.getDynamicAttribute('attr_store', 'color').setValue('Blue');
    gr_Inc.update();

    gr_Inc = new GlideRecord('incident');
    gr_Inc.get('number', 'INC0009009');
    gs.info(gr_Inc.getDynamicAttribute('attr_store', 'color'));

Saída:

    *** Script: Blue

## GetDynamicAttributeValue (cadeia de caracteres fullPath) {#ariaid-title43}

Retorna o valor do atributo dinâmico localizado em um caminho especificado.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-getDynamicAttributeValue_S__ul_cx2_lf1_r3c}
{#GR-getDynamicAttributeValue_S__table_oh3_x1x_1bc__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Caminho completo | Cadeia de caracteres | Caminho a ser usado para localizar o atributo dinâmico desejado. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#GR-getDynamicAttributeValue_S__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
[Tabela 82. Parâmetros]

{#GR-getDynamicAttributeValue_S__table_oh3_x1x_1bc} {#GR-getDynamicAttributeValue_S__table_ph3_x1x_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Object | Valor do atributo dinâmico localizado no caminho especificado. Se o fullPath parâmetro contiver dados inválidos ou o valor do atributo especificado não for um dos tipos de dados compatíveis, retornará nulo. |
[Tabela 83. Retorna]

{#GR-getDynamicAttributeValue_S__table_ph3_x1x_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    // Update the value of the attribute 'attribute_store->time_of_purchase' incident 'INC0009009' to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store->time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();

    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store->time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store->time_of_purchase'));

Saída:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

## GetDynamicAttributeValue(cadeia de caracteres dynamicAttributeField, cadeia de caracteres attrPath) {#ariaid-title44}

Retorna o valor do atributo dinâmico localizado em um campo especificado na tabela atual e um caminho de atributo especificado.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-getDynamicAttributeValue_S_S__ul_cx2_lf1_r3c}
{#GR-getDynamicAttributeValue_S_S__table_n1f_fbx_1bc__entry__3}{#GR-getDynamicAttributeValue_S_S__DynS-dynamicAttributeField-entry}

| Nome | Tipo | Descrição |
|-|-|-|
| DynamicAttributeField | Cadeia de caracteres | Nome do campo na tabela que contém o atributo dinâmico. |
| Caminho de atributo | Cadeia de caracteres | Caminho do atributo a ser usado para localizar o atributo do esquema dinâmico associado. Formato: `"attr_name"` `attr_name`: Nome do atributo dinâmico. Tabela: No campo de atributo da tabela Atributo dinâmico \[dynamic_attribute\]. |
[Tabela 84. Parâmetros]

{#GR-getDynamicAttributeValue_S_S__table_n1f_fbx_1bc} {#GR-getDynamicAttributeValue_S_S__table_o1f_fbx_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Object | Valor do atributo dinâmico localizado no caminho especificado. Se os dynamicAttributeFieldattrPath parâmetros ou forem inválidos, retornará nulo. |
[Tabela 85. Retorna]

{#GR-getDynamicAttributeValue_S_S__table_o1f_fbx_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    // Update the value of the attribute 'attribute_store->time_of_purchase' incident `INC0009009` to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store', 'time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();

    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store', 'time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store', 'time_of_purchase'));

Saída:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

## GetDynamicAttributeDisplayValue (cadeia de caracteres fullPath) {#ariaid-title45}

Retorna o valor de exibição do atributo dinâmico localizado no caminho especificado.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-getDynAttributeDisplayValue_S__ul_cx2_lf1_r3c}
{#GR-getDynAttributeDisplayValue_S__table_nht_nbx_1bc__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Caminho completo | Cadeia de caracteres | Caminho a ser usado para localizar o atributo dinâmico desejado. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#GR-getDynAttributeDisplayValue_S__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
[Tabela 86. Parâmetros]

{#GR-getDynAttributeDisplayValue_S__table_nht_nbx_1bc} {#GR-getDynAttributeDisplayValue_S__table_oht_nbx_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de exibição do atributo dinâmico localizado no caminho especificado. Se o fullPath parâmetro for inválido, retornará nulo. |
[Tabela 87. Retorna]

{#GR-getDynAttributeDisplayValue_S__table_oht_nbx_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    // Update the value of the attribute 'attribute_store->time_of_purchase' incident INC0009009 to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store->time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();

    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store->time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store->time_of_purchase'));

Saída:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

## GetDynamicAttributeDisplayValue(cadeia de caracteres dynamicAttributeField, cadeia de caracteres attrPath) {#ariaid-title46}

Retorna o valor de exibição do atributo dinâmico localizado em um campo de tabela especificado e caminho de atributo.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-getDynAttributeDisplayValue_S_S__ul_cx2_lf1_r3c}
{#GR-getDynAttributeDisplayValue_S_S__table_vm3_wbx_1bc__entry__3}{#GR-getDynAttributeDisplayValue_S_S__DynS-dynamicAttributeField-entry}

| Nome | Tipo | Descrição |
|-|-|-|
| DynamicAttributeField | Cadeia de caracteres | Nome do campo na tabela que contém o atributo dinâmico. |
| Caminho de atributo | Cadeia de caracteres | Caminho do atributo a ser usado para localizar o atributo do esquema dinâmico associado. Formato: `"attr_name"` `attr_name`: Nome do atributo dinâmico. Tabela: No campo de atributo da tabela Atributo dinâmico \[dynamic_attribute\]. |
[Tabela 88. Parâmetros]

{#GR-getDynAttributeDisplayValue_S_S__table_vm3_wbx_1bc} {#GR-getDynAttributeDisplayValue_S_S__table_wm3_wbx_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de exibição do atributo dinâmico localizado no caminho especificado. Se os dynamicAttributeFieldattrPath parâmetros ou forem inválidos, retornará nulo. |
[Tabela 89. Retorna]

{#GR-getDynAttributeDisplayValue_S_S__table_wm3_wbx_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    // Update the value of the attribute 'attribute_store->time_of_purchase' incident INC0009009 to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store', 'time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();

    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store', 'time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store', 'time_of_purchase'));

Saída:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

## GlideRecord - getED() {#ariaid-title47}

Retorna o descritor do elemento.
{#r_GlideRecord-getED__table_ppq_p2r_dt__entry__3}

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

{#r_GlideRecord-getED__table_ppq_p2r_dt} {#r_GlideRecord-getED__table_qpq_p2r_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideElementDescriptor | O descritor do elemento. |
[Tabela 91. Retorna]

{#r_GlideRecord-getED__table_qpq_p2r_dt}  
Este exemplo mostra como recuperar o campo de nome de um GlideRecord de incidente.

    grInc = new GlideRecord('incident');
    grInc.getActiveQuery();
    grInc.query();
    if (grInc.next())
      gs.info("Table Descriptor is - " + grInc.getED().getName());

Saída:

    Table Descriptor is - incident

### Escopo equivalente {#r_GlideRecord-getED__section_vj2_pds_mcb}

Para usar o método getED() em uma aplicação com escopo, use o método com escopo correspondente: [GetED()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-getED "Retorna o descritor do elemento.").

## GetElement (cadeia de caracteres fieldName) {#ariaid-title48}

Recupera o GlideElement para um campo especificado.
O valor retornado por este método é um objeto GlideElement completo. Os resultados são o equivalente ao valor de um campo com referência com pontos. Por exemplo, `now_GR.getElement('``short_description') fornece o mesmo resultado que nowGR.short_description`.

Na maioria dos casos, não use a referência com pontos para obter valores de um registro. A referência com pontos recupera o objeto inteiro em vez do valor do campo. A recuperação do objeto usa mais armazenamento e pode causar resultados indesejáveis quando usado em matrizes ou em Portal de serviços.

Em vez de recuperar o objeto inteiro, você pode usar um dos seguintes métodos para copiar os valores do campo:  
* [getValue()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-getValue_String "Recupera o valor da cadeia de caracteres de um campo especificado ou o valor da cadeia de caracteres de um atributo em um armazenamento dinâmico de atributos.")
* [getDisplayValue()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-getDisplayValue "Recupera o valor de exibição do registro atual ou o valor de exibição de um atributo em um armazenamento dinâmico de atributos.")
{#r_GlideRecord-getElement_String__gr-api-dot-walk-global-rec-lnx}  
Se a referência com pontos em um objeto GlideElement for necessária, use o método toString() para recuperar valores. Por exemplo, você pode precisar do sys_id do gerenciador do solicitante atual para definir outro campo de referência. O exemplo a seguir mostra como obter o valor da cadeia de caracteres em vez de todo o objeto:

    var mgr = current.caller_id.manager.toString();

Ver também: [ToString()](https://www.servicenow.com/docs/8b~fKEUHbZF~fL1vQDQZ9g#r_GlideElement-toString "Converte o valor do campo em uma cadeia de caracteres.").
{#r_GlideRecord-getElement_String__id_rmz_rpn_mpb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome da coluna para a qual o objeto GlideElement será retornado. |
[Tabela 92. Parâmetros]

{#r_GlideRecord-getElement_String__id_rmz_rpn_mpb} {#r_GlideRecord-getElement_String__table_yxw_bfr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| GlideElement | O GlideElement da coluna especificada do registro atual. Cada objeto descreve um campo no GlideRecord atual. |
[Tabela 93. Retorna]

{#r_GlideRecord-getElement_String__table_yxw_bfr_dt}  
Este exemplo mostra como obter o objeto GlideElement para uma tabela passada e compará-los com os valores de metadados esperados do sistema.

    function compareElement(comment, table, element, /*{}*/ expected) {
      var now_GR = new GlideRecord(table);
      var el = now_GR.getElement(element);
      for (var n in expected) {
        assertEquals(comment + ":" + table + "." + element, expected[n], el.sys_meta[n]);
      }
    }

### Escopo equivalente

Para usar o método getElement() em uma aplicação com escopo, use o método com escopo correspondente: [GetElement()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGetElement_String "Recupera o objeto GlideElement para o campo especificado.").

## GlideRecord - getEncodedQuery() {#ariaid-title49}

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

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

{#r_GlideRecord-getEncodedQuery_Boolean__table_ng2_mfr_dt} {#r_GlideRecord-getEncodedQuery_Boolean__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Uma [cadeia de caracteres de consulta codificada](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US). |
[Tabela 95. Retorna]

{#r_GlideRecord-getEncodedQuery_Boolean__table_qpt_3f5_jq}  
Este exemplo mostra como obter a consulta codificada atual para usar mais tarde para criar uma função de ACL de leitura.

    function createAcl(table, role) {
      gs.print("Checking security on table " + table);
      var now_GR = new GlideRecord("sys_security_acl");
      now_GR.addQuery("name", table);
      now_GR.addQuery("operation", "read");
      now_GR.query();
      var encQuery = now_GR.getEncodedQuery();
      if (now_GR.next()) {
        // existing acl found so use it
        createAclRole(now_GR.sys_id.toString(), role);
       return;
      } else {
        now_GR.initialize();
        now_GR.applyEncodedQuery(encQuery);
        var acl = now_GR.insert();
        gs.print("   Added read access control on " + table);
        createAclRole(acl, role);
      }
    }

### Escopo equivalente

Para usar o método getEncodedQuery() em uma aplicação com escopo, use o método com escopo correspondente: [GetEncodedQuery()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGetEncodedQuery "Recupera a condição de consulta do conjunto de resultados atual como uma cadeia de caracteres de consulta codificada.").

## GetEscapedDisplayValue() {#ariaid-title50}

Recupera o valor do campo para o campo de exibição do registro atual e adiciona caracteres de escape para uso em scripts Jelly.
Nota:  
Para que este método funcione, um valor de exibição deve ter sido definido na tabela associada. Para obter informações sobre como fazer isso, consulte [Selecionar um campo como o valor de exibição da tabela](https://www.servicenow.com/docs/access?context=t_SelectTheDisplayValue&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). {#r_GlideRecord-getEscapedDisplayValue__table_xcp_5fr_dt__entry__3}

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

{#r_GlideRecord-getEscapedDisplayValue__table_xcp_5fr_dt} {#r_GlideRecord-getEscapedDisplayValue__table_ycp_5fr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de escape do campo de exibição da tabela atual. |
[Tabela 97. Retorna]

{#r_GlideRecord-getEscapedDisplayValue__table_ycp_5fr_dt}  
Este exemplo mostra como obter o valor de exibição de escape user_name da tabela Usuário \[sys_user\].

    var userName = "Michael J'ones";
    var now_GR = new GlideRecord("sys_user");
    if (now_GR.get("user_name", userName)) {
      gs.print("Deleting existing user=" + userName);
      now_GR.deleteRecord();
    }
    now_GR.initialize();

    var name = userName.split(" ", 2);
    var firstName = name[0];
    var lastName = name[1];
    now_GR.setValue("user_name", userName);
    gs.print("Name: " + now_GR.getValue("user_name"));
    now_GR.setValue("first_name", firstName);
    now_GR.setValue("last_name", lastName);
    var escapeValue = now_GR.getEscapedDisplayValue();
    gs.print("Escaped name: " + escapeValue);

Saída:

    Name: Michael J'ones
    Escaped name: Michael J\'ones

## GlideRecord - getFields() {#ariaid-title51}

Recupera uma Java ArrayList de campos no registro atual.
{#r_GlideRecord-getFields__table_yzn_fgr_dt__entry__3}

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

{#r_GlideRecord-getFields__table_yzn_fgr_dt} {#r_GlideRecord-getFields__table_zzn_fgr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Java ArrayList | Campos no registro atual |
[Tabela 99. Retorna]

{#r_GlideRecord-getFields__table_zzn_fgr_dt}  

    // This can be run in "Scripts - Background" for demonstration purposes
     
    // Get a single incident record
    var grINC = new GlideRecord('incident');
    grINC.query();
    grINC.next();
    gs.print('Using ' + grINC.getValue('number'));
    gs.print('');
     
    // getFields() returns a Java ArrayList
    var fields = grINC.getFields();
     
    // Enumerate GlideElements in the GlideRecord object that have values
    gs.print('Enumerating over all fields with values:');
    for (var i = 0; i < fields.size(); i++) {
      var glideElement = fields.get(i);
      if (glideElement.hasValue()) {
        gs.print('  ' + glideElement.getName() + '\t' + glideElement);
      }
    }
    gs.print('');
     
    // Get a specific GlideElement: number
    gs.print('Getting the number field:');
    for (var i = 0; i < fields.size(); i++) {
      var glideElement = fields.get(i);
      if (glideElement.hasValue() && glideElement.getName() == 'number') {
        gs.print('  ' + glideElement.getName() + '\t' + glideElement);
      }
    }

## GlideRecord - getLabel() {#ariaid-title52}

Recupera o rótulo do campo.
{#r_GlideRecord-getLabel__table_ajl_sgr_dt__entry__3}

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

{#r_GlideRecord-getLabel__table_ajl_sgr_dt} {#r_GlideRecord-getLabel__table_bjl_sgr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O rótulo do campo |
[Tabela 101. Retorna]

{#r_GlideRecord-getLabel__table_bjl_sgr_dt}  
Este exemplo mostra como recuperar um rótulo de um campo de pergunta na tabela Item solicitado e imprimir o rótulo e seu nome de exibição.

    template.print("Summary of Requested items:\n");  
    var now_GR = new GlideRecord("sc_req_item");
    now_GR.addQuery("request", current.sysapproval);
    now_GR.query();
    while(now_GR.next()) {
    var nicePrice = now_GR.price.toString();
        if (nicePrice != '') {
            nicePrice = parseFloat(nicePrice);
            nicePrice = nicePrice.toFixed(2);
        }
        template.print(now_GR.number + ":  " + now_GR.quantity + " X " + now_GR.cat_item.getDisplayValue() 
                         + " at $" + nicePrice + " each \n");
        template.print("    Options:\n");
        for (key in now_GR.variables) {
        var now_V = now_GR.variables[key];
          if(now_V.getGlideObject().getQuestion().getLabel() != '') {
             template.space(4);
             template.print('     ' + now_V.getGlideObject().getQuestion().getLabel() + " = " 
                         + vnow_V.getDisplayValue() + "\n");  
          }
        }
    }

### Escopo equivalente {#r_GlideRecord-getLabel__section_bdc_d2s_mcb}

Para usar o método getLabel() em uma aplicação com escopo, use o método com escopo correspondente: [GetLabel()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-getLabel "Retorna o rótulo do campo.").

## GetLink (noStack booliano) {#ariaid-title53}

Recupera o link do registro atual.
{#r_GlideRecord-getLink_Boolean__table_evz_2hr_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhuma pilha | Booliano | Sinalizador que indica se o link gerado deve ser anexado ao final do URL. Por exemplo: `&Sysparm_stack sysparm_query` Valores válidos: * Verdadeiro: Anexar link. * Falso: Não anexar link. {#r_GlideRecord-getLink_Boolean__ul_jwg_kmt_ymb} Padrão: falso |
[Tabela 102. Parâmetros]

{#r_GlideRecord-getLink_Boolean__table_evz_2hr_dt} {#r_GlideRecord-getLink_Boolean__table_fvz_2hr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | URL do registro atual. |
[Tabela 103. Retorna]

{#r_GlideRecord-getLink_Boolean__table_fvz_2hr_dt}  
Este exemplo verifica se há anexos e adiciona o link se algum for encontrado.

    var attachment_link = '';
    var rec = new GlideRecord('sc_req_item');
    rec.addQuery('sys_id', current.request_item);
    rec.query();
    if(rec.next()){
      if(rec.hasAttachments()){
        attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
      }   
    }

### Escopo equivalente {#r_GlideRecord-getLink_Boolean__section_qvr_f2s_mcb}

Para usar o método getLink() em uma aplicação com escopo, use o método com escopo correspondente: [GetLink()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGetLink_Boolean "Recupera o link para o registro atual.").

## GlideRecord - getLocation() {#ariaid-title54}

Recupera o número da linha do registro atual na tabela.
{#r_GlideRecord-getLocation_Boolean__table_hzq_whr_dt__entry__3}

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

{#r_GlideRecord-getLocation_Boolean__table_hzq_whr_dt} {#r_GlideRecord-getLocation_Boolean__table_izq_whr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Número de linha baseado em zero do registro atual na tabela. |
[Tabela 105. Retorna]

{#r_GlideRecord-getLocation_Boolean__table_izq_whr_dt}  
Este exemplo mostra como verificar se um registro na tabela Incidente não foi recuperado corretamente comparando a contagem de registros com o número do local do registro.

    var now_GR = new GlideRecord("incident");
    now_GR.addQuery("priority", "4");
    now_GR.query();
    for (x=0; x <4; x++) {
      now_GR.next();
      gs.print("Location value: " + now_GR.getLocation());
    }

Saída:

    Location value: 0
    Location value: 1
    Location value: 2
    Location value: 3

## GlideRecord - getPlural() {#ariaid-title55}

Recupera o rótulo plural da tabela GlideRecord.
Por exemplo, se o nome da tabela for "Solicitação de mudança", este método retornará "Solicitações de mudança".
{#r_GlideRecord-getPlural__table_pfl_g3r_dt__entry__3}

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

{#r_GlideRecord-getPlural__table_pfl_g3r_dt} {#r_GlideRecord-getPlural__table_qfl_g3r_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O rótulo plural da tabela do GlideRecord. |
[Tabela 107. Retorna]

{#r_GlideRecord-getPlural__table_qfl_g3r_dt}  
Este exemplo mostra verifica os valores de retorno de getLabel() e getPlural() para a tabela Incidente.

    var now_GR = new GlideRecord('incident');
    gs.print(now_GR.getLabel());
    if (now_GR.getLabel() != 'Incident')
    throw "GlideRecord.getLabel() returned unexpected value for table 'incident': " + now_GR.getLabel();

    gs.print(now_GR.getPlural());
    if (now_GR.getPlural() != 'Incidents')
    throw "GlideRecord.getPlural() returned unexpected value for table 'incident': " + now_GR.getPlural();
    "success";

### Escopo equivalente {#r_GlideRecord-getPlural__section_itl_mcs_mcb}

Para usar o método getPlural() em uma aplicação com escopo, use o [GlideRecord - getED()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-getED "Retorna o descritor do elemento.") método GlideRecord.getED() com escopo para obter o descritor do campo e, em seguida, use o [GlideElementDescriptor - getPlural()](https://www.servicenow.com/docs/5k5nvf4yoQaS5jI9G6__hw#r_SGED-getPlural "Retorna o rótulo plural do elemento.") método GlideElementDescriptor.getPlural() com escopo.

## GetRecordClassName() {#ariaid-title56}

Recupera o nome da classe (tabela) do registro atual.
{#r_GlideRecord-getRecordClassName__table_dxr_r3r_dt__entry__3}

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

{#r_GlideRecord-getRecordClassName__table_dxr_r3r_dt} {#r_GlideRecord-getRecordClassName__table_exr_r3r_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Nome da classe ou tabela |
[Tabela 109. Retorna]

{#r_GlideRecord-getRecordClassName__table_exr_r3r_dt}  

    function TaskAssignmentFilter() {
      var classname = current.getRecordClassName();
      var filter = "type=null";
      if (classname == "incident" && current.category == "database") {
        filter = GetGroupFilter("database");
      }
      else {
        // append exclusion for 'catalog' to the filter
        var cat = new GlideRecord("sys_user_group_type");  
        cat.addQuery("name", "catalog");
        cat.query();
        if (cat.next()) {
          filter += "^ORtype!=" + cat.sys_id;
        }
      }
      gs.log("TaskAssignmentFilter: " + filter);
      return filter;
    }

### Escopo equivalente {#r_GlideRecord-getRecordClassName__section_nrs_h2s_mcb}

Para usar o método getRecordClassName() em uma aplicação com escopo, use o método com escopo correspondente: [GetRecordClassName()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGetRecordClassName "Recupera o nome da classe do registro atual.").

## GlideRecord - getRelatedLists() {#ariaid-title57}

Recupera uma lista de nomes e valores de exibição de listas relacionadas associadas ao GlideRecord atual.
{#r_GlideRecord-getRelatedLists_Boolean__table_f2p_3jr_dt__entry__3}

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

{#r_GlideRecord-getRelatedLists_Boolean__table_f2p_3jr_dt} {#r_GlideRecord-getRelatedLists_Boolean__table_g2p_3jr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| HashMap | Mapa de hash com nomes e valores de exibição de listas relacionadas. |
[Tabela 111. Retorna]

{#r_GlideRecord-getRelatedLists_Boolean__table_g2p_3jr_dt}  
Este exemplo mostra como obter a lista de nomes e valores de exibição de listas relacionadas associadas ao GlideRecord atual, armazená-los em uma matriz e imprimir seus valores.

    var now_GR = new GlideRecord('incident');
    var c = now_GR.getRelatedLists().values().toArray();
    var numElements = c.length;
    for( var i = 0; i < numElements; ++i){
      gs.print(i+": "+c[i]);
    }

## GlideRecord - getRelatedTables() {#ariaid-title58}

Recupera uma lista de nomes e valores de exibição de tabelas que são referenciadas pelo registro atual.
{#r_GlideRecord-getRelatedTables_Boolean__table_lwm_vjr_dt__entry__3}

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

{#r_GlideRecord-getRelatedTables_Boolean__table_lwm_vjr_dt} {#r_GlideRecord-getRelatedTables_Boolean__table_mwm_vjr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| HashMap | Mapa de hash com nomes e valores de exibição de tabelas relacionadas. |
[Tabela 113. Retorna]

{#r_GlideRecord-getRelatedTables_Boolean__table_mwm_vjr_dt}  
Este exemplo mostra como obter a lista de nomes e valores de exibição de tabelas relacionadas ao GlideRecord atual, armazená-los em uma matriz e imprimir seus valores.

    var now_GR = new GlideRecord('incident');
    var c = now_GR.getRelatedTables().values().toArray();
    var numElements = c.length;
    for( var i = 0; i < numElements; ++i){
      gs.print(i+": "+c[i]);
    }

## GlideRecord - getRowCount() {#ariaid-title59}

Recupera o número de linhas (registros) no objeto GlideRecord atual.
Nota:  
GlideRecord retorna registros correspondentes, portanto, pode não ser tão eficiente quanto GlideAggregate quando você só precisa do número de registros. Se você precisar apenas de uma contagem de registros e não estiver iterando sobre os registros correspondentes, use GlideAggregate.  

Recuperando o número de registros no GlideRecord ou GlideAggregate
:   As [](https://www.servicenow.com/docs/lV9GLyX4_Rx9y_qkybweOQ#c_GlideAggregateScopedAPI "A API GlideAggregate permite criar consultas de agregação de banco de dados.") APIs GlideRecord getRowCount() e GlideAggregate getAggregate() oferecem informações semelhantes. Use os critérios a seguir para determinar qual opção é a melhor para você.

    * O método GlideRecord getRowCount() informa quantos registros foram retornados de uma consulta junto com os próprios registros. Se você precisar do número de registros no conjunto de resultados antes ou depois de iterar o conjunto para executar ações nos registros, use este método.
    * O método GlideAggregate getAggregate() recupera somente uma contagem de registros correspondentes à consulta, excluindo os registros reais. O agregado deve ser definido no objeto GlideAggregate antes de emitir a consulta.
    {#r_GlideRecord-getRowCount__ul_wdq_fmn_nyb}
:   Recuperando os registros e a contagem com GlideRecord getRowCount()  
    O exemplo a seguir mostra como obter o número total de incidentes ativos com GlideRecord getRowCount():

        var incident = new GlideRecord("incident");
        incident.addQuery("active", true);
        incident.query();
         
        gs.info("*** Total number of active incidents: {0}", incident.getRowCount());

:   Recuperando somente o número de registros com GlideAggregate getAggregate()  
    O exemplo a seguir mostra como retornar somente o número de registros. Como este método não usa os registros correspondentes, é muito mais eficiente usar uma consulta agregada e retornar apenas a contagem.

        var incident = new GlideAggregate("incident");
        incident.addQuery("active", true);
        incident.addAggregate("COUNT");
        incident.query();
         
        if (incident.next())
            gs.info("*** Total number of active incidents: {0}", incident.getAggregate("COUNT"));

:   Decidir qual opção é a melhor para sua solução

Se você quiser recuperar apenas o número de registros, o método GlideAggregate getAggregate() é a melhor opção. Para usar os registros individuais e recuperar o número de resultados, use GlideRecord getRowCount(), porque uma única consulta fornece essa funcionalidade.  
Nota:  
Se você quiser usar o método getRowCount() ao usar `sys_id EM` com mais de 100 valores sys_id, como `grIncident.addQuery('sys_id', 'IN', listOf200SysIds)`, você deve:

* Chame o método disableSysIdInOptimization() no GlideRecord.
* Ou ajuste a glide.db.first_pass_sys_id_list_size.max propriedade do sistema para um valor maior que o número de sys_ids na lista.

{#r_GlideRecord-getRowCount__ul_j1v_ztm_zcc} Além disso, certifique-se de chamar o método .next() antes de chamar o método getRowCount().
{#r_GlideRecord-getRowCount__table_dxv_hkr_dt__entry__3}

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

{#r_GlideRecord-getRowCount__table_dxv_hkr_dt} {#r_GlideRecord-getRowCount__table_exv_hkr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Número de linhas no GlideRecord atual. |
[Tabela 115. Retorna]

{#r_GlideRecord-getRowCount__table_exv_hkr_dt}  
O exemplo a seguir mostra como obter o número de incidentes da tabela Incidente \[incidente\].

    var numberOfIncidents = new GlideRecord('incident');
    numberOfIncidents.query();
    gs.info("Records in incident table: " + numberOfIncidents.getRowCount());

Saída:

    Records in incident table: 6920

O exemplo de código a seguir mostra como usar o método disableSysIdInOptimiation() para desabilitar a otimização de limite sys_id ao passar uma lista de sys_id de incidente que contém 200 entradas.

    var listOf200SysIds = [ ... ]; // 200 comma separated sys_ids
    var grIncident = new GlideRecord('incident');
    grIncident.addQuery('sys_id', 'IN', listOf200SysIds);
    grIncident.disableSysIdInOptimization(); // Rowcount could be incorrect without this method call
    grIncident.query();
    if (grIncident.next())
        gs.info("Rowcount: " + grIncident.getRowCount());

Saída:

    Rowcount: 200

### Escopo equivalente

Para usar o método getRowCount() em uma aplicação com escopo, use o método com escopo correspondente: [GetRowCount()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGetRowCount "Recupera o número de linhas (registros) no objeto GlideRecord atual.").

## GlideRecord - getRowNumber() {#ariaid-title60}

Recupera o número de linha definido por saveLocation() ou setLocation().
Para obter o número da linha atual, use getLocation().
{#r_GlideRecord-getRowNumber__table_m4c_pkr_dt__entry__3}

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

{#r_GlideRecord-getRowNumber__table_m4c_pkr_dt} {#r_GlideRecord-getRowNumber__table_n4c_pkr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Número de linha salvo. |
[Tabela 117. Retorna]

{#r_GlideRecord-getRowNumber__table_n4c_pkr_dt}  
Este exemplo mostra como salvar um local de linha na tabela Usuários e obter esse número de linha.

    var now_GR = new GlideRecord('sys_user');
    now_GR.addQuery();
    now_GR.query();
    now_GR.saveLocation(5);
    var savedRow = now_GR.getRowNumber();
    gs.print("Saved row: " + savedRow);

Saída:

    Saved row: 5

## GetTableName() {#ariaid-title61}

Recupera o nome da tabela associado a este GlideRecord.
{#r_GlideRecord-getTableName__table_hcx_wkr_dt__entry__3}

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

{#r_GlideRecord-getTableName__table_hcx_wkr_dt} {#r_GlideRecord-getTableName__table_icx_wkr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Um nome de tabela |
[Tabela 119. Retorna]

{#r_GlideRecord-getTableName__table_icx_wkr_dt}  
Este exemplo mostra como gravar o nome da tabela atual no log do sistema.

    gs.log('Table: ' + current.getTableName()); 
    gs.log('Parent: ' + current.parent.sys_id); 
    var item = new GlideRecord('sc_req_item'); 
    item.addQuery('sys_id', current.parent.sys_id); 
    item.query(); 
    if(item.next()){ 
      for(var variable in item.variable_pool) {
        gs.log(variable); 
        var answer = eval ("item.variable_pool." + variable + ".getDisplayValue()");
        gs.log(answer);
      }
    }

### Escopo equivalente {#r_GlideRecord-getTableName__section_hfr_42s_mcb}

Para usar o método getTableName() em uma aplicação com escopo, use o método com escopo correspondente: [GetTableName()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGetTableName "Recupera o nome da tabela associada ao GlideRecord.").

## GlideRecord - getUniqueValue() {#ariaid-title62}

Obtém a chave primária do registro, que geralmente é o sys_id, a menos que especificado de outra forma.
{#GlideRecord-getUniqueValue_S__table_t5k_btb_2r__entry__3}

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

{#GlideRecord-getUniqueValue_S__table_t5k_btb_2r} {#GlideRecord-getUniqueValue_S__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A chave primária exclusiva como uma cadeia de caracteres ou nula se a chave for nula. |
[Tabela 121. Retorna]

{#GlideRecord-getUniqueValue_S__table_qpt_3f5_jq}  

    var now_GR = new GlideRecord('kb_knowledge');
    now_GR.query();
    now_GR.next();
    var uniqueid = now_GR.getUniqueValue();
    gs.info(uniqueid);

## GetValue (cadeia de caracteres fieldName) {#ariaid-title63}

Recupera o valor da cadeia de caracteres de um campo especificado ou o valor da cadeia de caracteres de um atributo em um armazenamento dinâmico de atributos.
Nota:  
Se o Criptografia de campo Enterprise plug-in estiver habilitado e a instância tiver acesso à chave, este método retornará valores de texto não criptografado. Se a instância não tiver acesso à chave, este método retornará o valor criptografado. Para obter mais informações, consulte [Criptografia da plataforma](https://www.servicenow.com/docs/access?context=encryption-landing&version=brazil&pubname=brazil-platform-security&ft:locale=en-US).

Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
{#r_GlideRecord-getValue_String__table_ev2_flr_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo cujo valor você deseja recuperar ou o caminho para um atributo em um armazenamento dinâmico de atributos a ser recuperado. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#r_GlideRecord-getValue_String__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
[Tabela 122. Parâmetros]

{#r_GlideRecord-getValue_String__table_ev2_flr_dt} {#r_GlideRecord-getValue_String__table_fv2_flr_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor do elemento especificado. Retorna nulo se o campo estiver vazio ou o campo não existir. Nota: Os valores boolianos retornam como <kbd class="ph userinput"></kbd><kbd class="ph userinput"></kbd> valores de cadeia de caracteres "0" e "1" em vez de falso e verdadeiro. |
[Tabela 123. Retorna]

{#r_GlideRecord-getValue_String__table_fv2_flr_dt}  
Este exemplo usa o método getValue() para obter valores de campo em dois GlideRecords que estão sendo comparados.

    function() {
      var jobExists = true;
      var jobGr;
      while(jobExists){
        jobGr = new GlideRecord("sys_trigger");
        jobExists = jobGr.get("name", "BaselineAPI: Create Baseline Job");
      }
      var baselineGr =  new GlideRecord('pm_project_baseline');
      baselineGr.get('baseline_name','Test Project Baseline');
      baselineGr.query();
     
      Assert.assertEquals(true, baselineGr.next());
      var projectGr =  new GlideRecord('pm_project');
      projectGr.get(this._project);
      Assert.assertEquals(projectGr.getValue('cost'), baselineGr.getValue('cost'));
      Assert.assertEquals((projectGr.getValue('capex_cost')), baselineGr.getValue('capex_cost'));
      Assert.assertEquals((projectGr.getValue('opex_cost')), baselineGr.getValue('opex_cost'));
      Assert.assertEquals((projectGr.getValue('budget_cost')), baselineGr.getValue('budget_cost'));
      Assert.assertEquals((projectGr.getValue('value')), baselineGr.getValue('value'));
      Assert.assertEquals((projectGr.getValue('npv_value')), baselineGr.getValue('npv_value'));  Assert.assertEquals((projectGr.getValue('score')), baselineGr.getValue('score'));
    }

Este exemplo mostra como recuperar o valor de um atributo dinâmico.

    // Update the value of the attribute 'attribute_store->color' to 'Red' on incident INC0009009
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store->color', 'Red');
    gr1.update();

    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info(gr2.getValue('attribute_store->color'));

Saída:

    *** Script: Red

### Escopo equivalente

Para usar o método getValue() em uma aplicação com escopo, use o método com escopo correspondente: [GetValue()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordGetValue_String "Recupera o valor da cadeia de caracteres de um elemento subjacente em um campo.").

## GlideRecord - hasAttachments() {#ariaid-title64}

Determina se o GlideRecord atual tem anexos.
{#r_GlideRecord-hasAttachments__table_dz4_fzp_dt__entry__3}

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

{#r_GlideRecord-hasAttachments__table_dz4_fzp_dt} {#r_GlideRecord-hasAttachments__table_ez4_fzp_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o registro atual tiver anexos, caso contrário, falso. |
[Tabela 125. Retorna]

{#r_GlideRecord-hasAttachments__table_ez4_fzp_dt}  
Este exemplo verifica se há anexos e cria um link, se houver algum.

    var attachment_link = '';
    var rec = new GlideRecord('sc_req_item');
    rec.addQuery('sys_id', current.request_item);
    rec.query();
    if(rec.next()){
      if(rec.hasAttachments()){
        attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
      }   
    }

## GlideRecord - hasNext() {#ariaid-title65}

Determina se há mais registros no GlideRecord.
{#r_GlideRecord-hasNext__table_fn3_cnq_dt__entry__3}

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

{#r_GlideRecord-hasNext__table_fn3_cnq_dt} {#r_GlideRecord-hasNext__table_gn3_cnq_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se houver mais registros no conjunto de consultas, caso contrário, falso. |
[Tabela 127. Retorna]

{#r_GlideRecord-hasNext__table_gn3_cnq_dt}  
Este exemplo mostra como chamar diferentes funções com base na existência de registros adicionais no GlideRecord atual.

    if (now_GR.hasNext()) {
      dothis(); // found it, do it
    } else {
      dothat(); // didn't find it
    };

### Escopo equivalente {#r_GlideRecord-hasNext__section_qb3_y2s_mcb}

Para usar o método hasNext() em uma aplicação com escopo, use o método com escopo correspondente: [HasNext()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordHasNext "Determina se há mais registros no objeto GlideRecord.").

## GlideRecord - initialize() {#ariaid-title66}

Cria um registro vazio no GlideRecord atual que é adequado para preenchimento antes de uma inserção.
{#r_GlideRecord-initialize__table_t1p_myw_dt__entry__3}

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

{#r_GlideRecord-initialize__table_t1p_myw_dt} {#r_GlideRecord-initialize__table_u1p_myw_dt__entry__2}

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

{#r_GlideRecord-initialize__table_u1p_myw_dt}  
Este exemplo inicializa um novo registro na tabela to_do, cria um registro e o insere na tabela.

    var now_GR = new GlideRecord('to_do');
    now_GR.initialize(); 
    now_GR.name = 'first to do item'; 
    now_GR.description = 'learn about GlideRecord'; 
    now_GR.insert();

### Escopo equivalente {#r_GlideRecord-initialize__section_j1j_1fs_mcb}

Para usar o método initialize() em uma aplicação com escopo, use o método com escopo correspondente: [Initialize()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordInitialize "Cria um registro vazio adequado para preenchimento antes de uma inserção.").

## GlideRecord - insert() {#ariaid-title67}

Insere um novo registro com os valores de campo que foram definidos para o registro atual.
{#r_GlideRecord-insert__table_t3h_vyw_dt__entry__3}

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

{#r_GlideRecord-insert__table_t3h_vyw_dt} {#r_GlideRecord-insert__table_u3h_vyw_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O sys_id do registro inserido ou nulo se o registro não estiver inserido. |
[Tabela 131. Retorna]

{#r_GlideRecord-insert__table_u3h_vyw_dt}  
Este exemplo cria um novo registro na tabela to_do, define valores para alguns campos de registro e insere o registro na tabela.

    var now_GR = new GlideRecord('to_do');
    now_GR.initialize(); 
    now_GR.name = 'first to do item'; 
    now_GR.description = 'learn about GlideRecord'; 
    now_GR.insert();

### Escopo equivalente {#r_GlideRecord-insert__section_dkx_cfs_mcb}

Para usar o método insert() em uma aplicação com escopo, use o método com escopo correspondente: [Insert()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordInsert "Insere um novo registro usando os valores de campo que foram definidos para o registro atual.").

## InsertWithReferences() {#ariaid-title68}

Insere um novo registro e também insere ou atualiza todos os registros relacionados com as informações fornecidas.
{#r_GlideRecord-insertWithReferences__table_scr_fzw_dt__entry__3}

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

{#r_GlideRecord-insertWithReferences__table_scr_fzw_dt} {#r_GlideRecord-insertWithReferences__table_tcr_fzw_dt__entry__2}

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

{#r_GlideRecord-insertWithReferences__table_tcr_fzw_dt}  
Se um valor de referência não for especificado (como abaixo), um novo registro de usuário será criado com o first_name e last_name fornecidos, e o valor caller_id será definido como este registro sys_user recém-criado. O resultado é um novo registro sys_user com first_name e last_name fornecidos e um novo registro de incidente com short_description e caller_id fornecidos.

    var inc = new GlideRecord('incident');
    inc.initialize();
    inc.short_description = 'New incident 1';
    inc.caller_id.first_name = 'John';
    inc.caller_id.last_name = 'Doe';
    inc.insertWithReferences();

Se um valor caller_id for especificado, esse caller_id será atualizado com o first_name e last_name fornecidos. O resultado é um registro de incidente recém-criado com valores definidos para short_description e caller_id.

    var inc = new GlideRecord('incident');
    inc.initialize();
    inc.short_description = 'New incident 1';
    inc.caller_id.setDisplayValue('David Loo');
    inc.caller_id.first_name = 'John';
    inc.caller_id.last_name = 'Doe';
    inc.insertWithReferences();

## Instanceof (cadeia de caracteres classname) {#ariaid-title69}

Verifica uma tabela para o tipo/classe de tabela.
{#r_GlideRecord-instanceOf_String__table_s5n_qnq_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ClassName | Cadeia de caracteres | Nome de um tipo ou classe de registro. |
[Tabela 134. Parâmetros]

{#r_GlideRecord-instanceOf_String__table_s5n_qnq_dt} {#r_GlideRecord-instanceOf_String__table_t5n_qnq_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se a tabela for uma instância da classe especificada. |
[Tabela 135. Retorna]

{#r_GlideRecord-instanceOf_String__table_t5n_qnq_dt}  
Este exemplo verifica se o passado no grupo/usuário é do tipo de tabela/classe sys_user.

    function(groupOrUser, label, grantedBy) {
      var labelCheck;
      var labelRecord;
      if (typeof label === "string") {
        labelRecord = new GlideRecord('label');
        labelRecord.addQuery('name', label);
        labelRecord.query();
        labelRecord.next();
      } else {
        labelRecord = label;
      }
      if (groupOrUser.instanceOf('sys_user')) {
        labelCheck = new GlideRecord('label_user_m2m');
        labelCheck.addQuery('user', groupOrUser.sys_id);
      } else {
        labelCheck = new GlideRecord('label_group_m2m');
        labelCheck.addQuery('group', groupOrUser.sys_id);
      }
      labelCheck.addQuery('label', labelRecord.sys_id);
      if (grantedBy !== "undefined") {
        labelCheck.addQuery('granted_by', grantedBy.sys_id);
      }
      labelCheck.query();
      return labelCheck.hasNext();
    }

## GlideRecord - isNewRecord() {#ariaid-title70}

Determina se o registro atual foi inserido no banco de dados.
Este método retorna verdadeiro somente se o método newRecord() tiver sido chamado. Este método é útil para ACL com script e na condição de ações de IU, mas não deve ser usado em scripts em segundo plano.  
Nota:  
Este método retorna verdadeiro para qualquer novo registro durante uma regra de negócio ou se o método newRecord() for usado para inicializar um registro com valores padrão e um ID exclusivo (sys_id). Em todos os outros casos, retorna falso.
{#r_GlideRecord-isNewRecord__table_vbn_g4q_dt__entry__3}

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

{#r_GlideRecord-isNewRecord__table_vbn_g4q_dt} {#r_GlideRecord-isNewRecord__table_wbn_g4q_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o registro atual é novo (não foi inserido no banco de dados.) Valores possíveis: * Verdadeiro: O registro é novo. * Falso: O registro não é novo. {#r_GlideRecord-isNewRecord__ul_cqj_2fx_z4b} |
[Tabela 137. Retorna]

{#r_GlideRecord-isNewRecord__table_wbn_g4q_dt}  
Este exemplo verifica se o novo registro foi inserido na tabela sys_user.

    var now_GR = new GlideRecord("sys_user");
    now_GR.newRecord();
    now_GR.setValue("user_name", "John Smith");
    gs.print("Is this a new record: " + now_GR.isNewRecord());

    var now_GR2 = new GlideRecord("sys_user");
    now_GR2.addQuery("user_name", "Abel Tutor");
    now_GR2.query();
    now_GR2.next();
    gs.print("Is this a new record: " + now_GR2.isNewRecord());

## GlideRecord - isValid() {#ariaid-title71}

Determina se a tabela GlideRecord atual existe.
{#r_GlideRecord-isValid__table_twy_x4q_dt__entry__3}

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

{#r_GlideRecord-isValid__table_twy_x4q_dt} {#r_GlideRecord-isValid__table_uwy_x4q_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se a tabela existir (válido), caso contrário, falso. |
[Tabela 139. Retorna]

{#r_GlideRecord-isValid__table_uwy_x4q_dt}  
Este exemplo verifica se a tabela Incidente existe.

    var testTable = new GlideRecord('incident');
    gs.print(testTable.isValid());

### Escopo equivalente {#r_GlideRecord-isValid__section_ipl_hfs_mcb}

Para usar o método isValid() em uma aplicação com escopo, use o método com escopo correspondente: [IsValid()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordIsValid "Determina se a tabela atual é válida ou se o registro foi recuperado com sucesso.").

## IsValidField(cadeia de caracteres columnName) {#ariaid-title72}

Determina se o campo especificado está definido na tabela GlideRecord atual.
{#r_GlideRecord-isValidField_String__table_hkx_vpq_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ColumnName | Cadeia de caracteres | Nome de uma coluna a ser verificada. |
[Tabela 140. Parâmetros]

{#r_GlideRecord-isValidField_String__table_hkx_vpq_dt} {#r_GlideRecord-isValidField_String__table_ikx_vpq_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o campo estiver definido na tabela, caso contrário, falso. |
[Tabela 141. Retorna]

{#r_GlideRecord-isValidField_String__table_ikx_vpq_dt}  
Este exemplo verifica se o campo sys_class_name existe na tabela cmds_software_instance.

    var gobj = new GlideRecord('sys_db_object');
    gobj.addQuery('name','cmdb_software_instance');
    gobj.query();
    if (!gobj.next()) {
      var si = new GlideRecord('cmdb_software_instance');
      si.query();
      var count = 0;
      while (si.next()) {
        if (!si.isValidField('sys_class_name')) {
          var ci = new GlideRecord('cmdb_ci');
          ci.name = si.name;
          ci.setNewGuidValue(si.sys_id);
          ci.sys_class_name = 'cmdb_software_instance';
          ci.insert();
          count++;
        }
      }
    }

### Escopo equivalente

Para usar o método isValidField() em uma aplicação com escopo, use o método com escopo correspondente: [IsValidField()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordIsValidField "Determina se o campo especificado está definido na tabela atual.").

## GlideRecord - isValidRecord() {#ariaid-title73}

Determina se o registro atual é válido.
{#r_GlideRecord-isValidRecord__table_ld5_3qq_dt__entry__3}

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

{#r_GlideRecord-isValidRecord__table_ld5_3qq_dt} {#r_GlideRecord-isValidRecord__table_md5_3qq_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o registro atual é válido. Valores válidos: * Verdadeiro: O registro é válido. * Falso: Após o fim do conjunto de registros. {#r_GlideRecord-isValidRecord__ul_dqt_bxs_1nb} |
[Tabela 143. Retorna]

{#r_GlideRecord-isValidRecord__table_md5_3qq_dt}  
Este exemplo verifica se o identificador de registro pelo passado em sys_id é um registro válido na tabela de ideias.

    function(sysId) {
      this.log('Inside acceptIdea sysId = ' + sysId);
      var now_GR = new GlideRecord('idea');
      now_GR.get(sysId);
      this.log('now_GR.isValidRecord() = ' + now_GR.isValidRecord());
      if(now_GR.isValidRecord()) {
        now_GR.setValue('state', 2);
        this.log('Updating gliderecord');
        this.log('gliderecord table name' + now_GR.getTableName());
        now_GR.update();
      }
    }

### Escopo equivalente

Para usar o método isValidRecord() em uma aplicação com escopo, use o método com escopo correspondente: [IsValidRecord()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordIsValidRecord "Determina se um registro foi realmente retornado pela operação de consulta/obtenção de registro.").

## NewRecord() {#ariaid-title74}

Cria um GlideRecord, define os valores padrão para os campos e atribui um ID exclusivo ao registro.
{#r_GlideRecord-newRecord__table_pzw_yzw_dt__entry__3}

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

{#r_GlideRecord-newRecord__table_pzw_yzw_dt} {#r_GlideRecord-newRecord__table_qzw_yzw_dt__entry__2}

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

{#r_GlideRecord-newRecord__table_qzw_yzw_dt}  
Este exemplo verifica se o novo registro foi inserido na tabela sys_user.

    var now_GR = new GlideRecord("sys_user");
    now_GR.newRecord();
    now_GR.setValue("user_name", "John Smith");
    gs.print("Is this a new record: " + now_GR.isNewRecord());

    var now_GR2 = new GlideRecord("sys_user");
    now_GR2.addQuery("user_name", "Abel Tutor");
    now_GR2.query();
    now_GR2.next();
    gs.print("Is this a new record: " + now_GR2.isNewRecord());

### Escopo equivalente

Para usar o método newRecord() em uma aplicação com escopo, use o método com escopo correspondente: [NewRecord()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordNewRecord "Cria um novo registro GlideRecord, define os valores padrão para os campos e atribui um ID exclusivo ao registro.").

## Next() {#ariaid-title75}

Move para o próximo registro no GlideRecord.
Use este método para iterar os registros retornados por uma consulta GlideRecord.  
Nota:  
Este método falha se houver um campo na tabela chamado "next". Se for esse o caso, use o método [_next()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-_next "Move para o próximo registro no GlideRecord. Fornece a mesma funcionalidade que next(), destinado a ser usado nos casos em que o GlideRecord tem uma coluna chamada next.").  
Nota:  
A construção If(myObj.next()) processa somente o primeiro registro retornado.
{#r_GlideRecord-next__table_s2n_yqq_dt__entry__3}

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

{#r_GlideRecord-next__table_s2n_yqq_dt} {#r_GlideRecord-next__table_t2n_yqq_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se há um registro "próximo" no GlideRecord. Valores válidos: * Verdadeiro: Mover para o próximo registro foi bem-sucedido. * Falso: Não há mais registros no conjunto de resultados. {#r_GlideRecord-next__ul_anq_km4_s3b} |
[Tabela 147. Retorna]

{#r_GlideRecord-next__table_t2n_yqq_dt}  
Este exemplo mostra como iterar na tabela Incidente usando o método next().

    var rec = new GlideRecord('incident');
    rec.query();
    while (rec.next()) { 
      gs.print(rec.number + ' exists');
    }

### Escopo equivalente {#r_GlideRecord-next__section_by3_qfs_mcb}

Para usar o método next() em uma aplicação com escopo, use o método com escopo correspondente: [Next()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordNext "Move para o próximo registro no objeto GlideRecord.").

## _Next() {#ariaid-title76}

Move para o próximo registro no GlideRecord. Fornece a mesma funcionalidade que next(), destinado a ser usado nos casos em que o GlideRecord tem uma coluna chamada next.
{#r_GlideRecord-_next__table_nwr_3rq_dt__entry__3}

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

{#r_GlideRecord-_next__table_nwr_3rq_dt} {#r_GlideRecord-_next__table_owr_3rq_dt__entry__2}

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

{#r_GlideRecord-_next__table_owr_3rq_dt}  

    var rec = new GlideRecord('sys_template');
    rec.query();
    while (rec._next()) { 
      gs.print(rec.number + ' exists');
    }

### Escopo equivalente {#r_GlideRecord-_next__section_ucp_vcs_mcb}

Para usar o método _next() em uma aplicação com escopo, use o método com escopo correspondente: [_Next()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-_next "Move para o próximo registro no GlideRecord. Fornece a mesma funcionalidade que next(), use este método se o GlideRecord tiver uma coluna chamada next.").

## GlideRecord - Operation() {#ariaid-title77}

Determina se uma operação é inserir, atualizar ou excluir.
Conhecer a operação permite o uso de current.operation() para criar uma regra de negócio genérica que pode lidar com cada operação exclusivamente.

Para obter informações sobre como usar a variável global atual, consulte [Variáveis globais em regras de negócio](https://www.servicenow.com/docs/HRjxXAzmy_W366Hupp8Q3Q "Variáveis globais predefinidas estão disponíveis para uso em regras de negócio.").
{#r_GlideRecord-operation__table_a3h_wrq_dt__entry__3}

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

{#r_GlideRecord-operation__table_a3h_wrq_dt} {#r_GlideRecord-operation__gr-operation-returns__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A operação atual. Valores possíveis: * excluir * inserir * atualizar {#r_GlideRecord-operation__ul_bnp_xs3_bpb} |
[Tabela 151. Retorna]

{#r_GlideRecord-operation__gr-operation-returns}  
O exemplo a seguir mostra como usar este método em uma regra de negócio. O método operation() detecta qual operação acionou um evento e executa uma ação diferente dependendo das operações de atualização e inserção.

    if(current.operation() == "update") {
      current.updates ++; } 
    if(current.operation() == "insert") {
      current.updates = 0; }

Este exemplo mostra como usar o método operation() para passar o valor da operação para o método startFlow().

    function createNewTransferOrder() {
      var toGr = new GlideRecord("alm_transfer_order");
      toGr.initialize();
      // From Stockroom - Southern California Warehouse
      toGr.setValue('from_stockroom', fromStockroomSysId);
      // To Stockroom - San Diego North - Pickup/Dropoff
      toGr.setValue('to_stockroom', toStockroomSysId);
      var transferOrder = toGr.insert();

      if(toGr.get(transferOrder)){
      // Start Transfer Order Workflow
      var wf = new Workflow();
      var context = wf.startFlow(toWorkflowSysId, toGr, toGr.operation(),{});
        createNewTransferOrderLine(transferOrder);
      } 
    }

### Escopo equivalente

Para usar o método operation() em uma aplicação com escopo, use o método com escopo correspondente: [Operation()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordOperation "Determina se uma operação é inserir, atualizar ou excluir.").

## OrderBy (cadeia de caracteres fieldName) {#ariaid-title78}

Especifica um nome de campo, ou caminho para um atributo em um armazenamento de atributos dinâmico, a ser usado para ordenar o conjunto de consultas. Para ordenar por vários campos, chame este método várias vezes com valores de campo diferentes.
Nota:  
Para impor o acesso à consulta com base no usuário, use [AddUserOrderBy()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderBy_S "Especifica uma coluna orderBy. Use este método para impor o acesso à consulta com base no usuário.").
{#r_GlideRecord-orderBy_String__table_rr5_fsq_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo da tabela ou caminho para um atributo em um armazenamento dinâmico de atributos, no qual solicitar o conjunto de consultas. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#r_GlideRecord-orderBy_String__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
[Tabela 152. Parâmetros]

{#r_GlideRecord-orderBy_String__table_rr5_fsq_dt} {#r_GlideRecord-orderBy_String__table_sr5_fsq_dt__entry__2}

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

{#r_GlideRecord-orderBy_String__table_sr5_fsq_dt}  
Este exemplo mostra como ordenar o conjunto de consultas por "pedido" e, em seguida, por "número".

    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();
      var len = child.getRowCount().toString().length;
      var seq = 0;
      while (child.next()) {
        count += UpdateProjectTaskWBS(child, 1, ++seq, len, '');
      }
      gs.addInfoMessage(count + ' Project Tasks updated');
    }

Este exemplo mostra como ordenar a consulta definida por um atributo em um armazenamento dinâmico de atributos.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.orderBy('attribute_store->first_name');
    gr_Inc.query();

    while(gr_Inc.next()) {
      gs.info("first_name: " + gr_Inc.getValue('attribute_store->first_name'));
    }

Saída:

    *** Script: first_name: Alejandro
    *** Script: first_name: Bertie
    *** Script: first_name: Beth
    *** Script: first_name: Bow
    *** Script: first_name: Bud
    *** Script: first_name: Carol
    *** Script: first_name: Charlie
    *** Script: first_name: Christen
    *** Script: first_name: David

### Escopo equivalente {#r_GlideRecord-orderBy_String__section_slw_vfs_mcb}

Para usar o método orderBy() em uma aplicação com escopo, use o método com escopo correspondente: [Orderby()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordOrderBy_String "Especifica uma coluna orderBy.").

## OrderByDesc(cadeia de caracteres fieldName) {#ariaid-title79}

Especifica o campo, ou um atributo em um armazenamento dinâmico de atributos, a ser usado para ordenar o conjunto de consultas em ordem decrescente.
Nota:  
Para impor o acesso à consulta com base no usuário, use [AddUserOrderByDesc()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-addUserOrderByDesc_S "Especifica uma coluna orderBy decrescente. Use este método para impor o acesso à consulta com base no usuário.").
{#r_GlideRecord-orderByDesc_String__table_yht_ysq_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo da tabela ou caminho para um atributo em um armazenamento dinâmico de atributos, no qual o conjunto de consultas deve ser ordenado em ordem decrescente. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#r_GlideRecord-orderByDesc_String__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
[Tabela 154. Parâmetros]

{#r_GlideRecord-orderByDesc_String__table_yht_ysq_dt} {#r_GlideRecord-orderByDesc_String__table_zht_ysq_dt__entry__2}

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

{#r_GlideRecord-orderByDesc_String__table_zht_ysq_dt}  
Este exemplo mostra como ordenar o conjunto de consultas em ordem crescente ou decrescente.

    function(fiscalType, orderByDesc) {
      var now_GR = new GlideRecord('fiscal_period');
      now_GR.addQuery('fiscal_type', fiscalType);
      if (orderByDesc) {
        now_GR.orderByDesc('fiscal_start_date_time');
      } else {
        now_GR.orderBy('fiscal_start_date_time');
      }
      now_GR.setLimit(1);
      now_GR.query();
      now_GR.next();
      return now_GR.sys_id;
    }

Este exemplo mostra como ordenar a consulta definida por um atributo em um armazenamento dinâmico de atributos.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.orderByDesc('attribute_store->first_name');
    gr_Inc.query();

    while(gr_Inc.next()) {
      gs.info("first_name: " + gr_Inc.getValue('attribute_store->first_name'));
    }

Saída:


    *** Script: first_name: David
    *** Script: first_name: Christen
    *** Script: first_name: Charlie
    *** Script: first_name: Carol
    *** Script: first_name: Bud
    *** Script: first_name: Bow
    *** Script: first_name: Beth
    *** Script: first_name: Bertie
    *** Script: first_name: Alejandro

### Escopo equivalente

Para usar o método orderByDesc() em uma aplicação com escopo, use o método com escopo correspondente: [OrderByDesc()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordOrderByDesc_String "Especifica uma coluna orderBy decrescente.").

## GlideRecord - consulta (campo de cadeia de caracteres, valor de cadeia de caracteres) {#ariaid-title80}

Executa uma consulta na tabela com base nos filtros especificados nos métodos de consulta, como addQuery() e addEncodedQuery().
Este método consulta a tabela GlideRecord, bem como todas as referências da tabela. Para obter mais informações, consulte [Consultar tabelas no script](https://www.servicenow.com/docs/q4J01nmu1lvw3Z5QUb0oJA#c_UsingGlideRecordToQueryTables "Usando métodos na API GlideRecord, você pode retornar todos os registros de uma tabela, retornar registros de uma tabela que atendam a condições específicas ou retornar registros que incluem uma cadeia de caracteres de uma única tabela ou de várias tabelas em um grupo de índice de texto.").  
Nota:  
Este método falha se houver um campo na tabela chamado "consulta". Se for esse o caso, use o método [_query()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-_query_Object_Object "Executa uma consulta na tabela com base nos filtros especificados nos métodos de consulta, como addQuery() e addEncodedQuery(). Este método deve ser usado em tabelas em que há uma coluna chamada \"query\", o que pode causar erros ao executar o método query()."). Para executar consultas em uma instância separada por domínio, use o método [queryNoDomain()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-queryNoDomain_Object_Object "Usado em instâncias separadas por domínio. Semelhante ao query(), executa a consulta na tabela com base nos filtros especificados por addQuery() e addEncodedQuery(), mas ignora domínios.").

Consulte o <https://developer.servicenow.com/dev.do#!/learn/courses/utah/app_store_learnv2_scripting_utah_scripting_in_servicenow/app_store_learnv2_scripting_utah_server_side_scripting/app_store_learnv2_scripting_utah_gliderecord> artigo GlideRecord para obter detalhes sobre como criar e executar consultas.  
Consulte também:

* [GlideAggregate - Global](https://www.servicenow.com/docs/xzD~6b8FXCC7Nvb_DXCWrg#c_GlideAggregateAPI "A API GlideAggregate permite criar consultas de agregação de banco de dados.")
* [GlideQuery()](https://www.servicenow.com/docs/ODvX~GJ5Gzru20mpX8Yetg#GlideQueryGlobalAPI "A inclusão de script GlideQuery é uma alternativa à API GlideRecord para executar operações de CRUD em dados de registro de scripts do lado do servidor."){#r_GlideRecord-query_Object_Object__gr-api-global-link2gquery-api}
{#r_GlideRecord-query_Object_Object__gr-api-global-link2gquery-api}
* [GlideQueryCondition - Global](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#c_GlideQueryConditionAPI "Esta API fornece condições AND ou OR que podem ser adicionadas à condição atual, permitindo que você crie consultas complexas.")
{#r_GlideRecord-query_Object_Object__ul_qcl_14d_lpb}
{#r_GlideRecord-query_Object_Object__id_g13_kwd_lpb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Opcional - Também deve especificar um parâmetro de valor. Nome do campo para pesquisar o valor especificado no parâmetro Valor. Nota: Este método é normalmente executado sem argumentos, mas você pode especificar um par nome-valor para filtrar registros que contêm os valores especificados. Se os parâmetros forem especificados, a condição "nome" será adicionada à consulta. |
| valor | Cadeia de caracteres | Opcional - Também deve especificar um parâmetro de campo. Valor a ser pesquisado no parâmetro de campo especificado. |
[Tabela 156. Parâmetros]

{#r_GlideRecord-query_Object_Object__id_g13_kwd_lpb} {#r_GlideRecord-query_Object_Object__table_qsd_ntq_dt__entry__2}

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

{#r_GlideRecord-query_Object_Object__table_qsd_ntq_dt}  
O exemplo a seguir mostra como verificar o Dicionário do sistema \[sys_dictionary\] em busca de tabelas com um campo de consulta.

    var tableArr = [];

    var now_GR = new GlideRecord('sys_dictionary');
    now_GR.addQuery('element', 'query');
    now_GR.setLimit(6);

    now_GR.query();

    while(now_GR.next()){
       tableArr.push(now_GR.name.getValue());
    };

    gs.info('The following tables have a field column called "query":');

    for (i = 0; i < tableArr.length; i++) {
       gs.info(tableArr[i]);
    };

Saída:

    The following tables have a field column called "query":
    cmdb_convert_bulk_services
    cmdb_multisource_query_status
    cmdb_qb_result_base
    cmdb_qb_table_mapping
    discovery_probes_cim_query
    kb_feedback

### Escopo equivalente {#r_GlideRecord-query_Object_Object__section_xt2_zfs_mcb}

Para usar o método query() em uma aplicação com escopo, use o método com escopo correspondente: [Query()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordQuery_Object_Object "Executa uma consulta na tabela com base nos filtros especificados nos métodos de consulta, como addQuery() e addEncodedQuery().").

## _Query (campo de cadeia de caracteres, valor de cadeia de caracteres) {#ariaid-title81}

Executa uma consulta na tabela com base nos filtros especificados nos métodos de consulta, como addQuery() e addEncodedQuery().
Este método deve ser usado em tabelas em que há uma coluna chamada "query", o que pode causar erros ao executar o método query().
Este método consulta a tabela GlideRecord, bem como todas as referências da tabela. Para obter mais informações, consulte [Consultar tabelas no script](https://www.servicenow.com/docs/q4J01nmu1lvw3Z5QUb0oJA#c_UsingGlideRecordToQueryTables "Usando métodos na API GlideRecord, você pode retornar todos os registros de uma tabela, retornar registros de uma tabela que atendam a condições específicas ou retornar registros que incluem uma cadeia de caracteres de uma única tabela ou de várias tabelas em um grupo de índice de texto.").

Consulte o <https://developer.servicenow.com/dev.do#!/learn/courses/utah/app_store_learnv2_scripting_utah_scripting_in_servicenow/app_store_learnv2_scripting_utah_server_side_scripting/app_store_learnv2_scripting_utah_gliderecord> artigo GlideRecord para obter detalhes sobre como criar e executar consultas.  
Consulte também:

* [GlideAggregate - Global](https://www.servicenow.com/docs/xzD~6b8FXCC7Nvb_DXCWrg#c_GlideAggregateAPI "A API GlideAggregate permite criar consultas de agregação de banco de dados.")
* [GlideQuery()](https://www.servicenow.com/docs/ODvX~GJ5Gzru20mpX8Yetg#GlideQueryGlobalAPI "A inclusão de script GlideQuery é uma alternativa à API GlideRecord para executar operações de CRUD em dados de registro de scripts do lado do servidor."){#r_GlideRecord-_query_Object_Object__gr-api-global-link2gquery-api}
{#r_GlideRecord-_query_Object_Object__gr-api-global-link2gquery-api}
* [GlideQueryCondition - Global](https://www.servicenow.com/docs/a1a5p3MgG8Y_Uf3_Fgy8lA#c_GlideQueryConditionAPI "Esta API fornece condições AND ou OR que podem ser adicionadas à condição atual, permitindo que você crie consultas complexas.")
{#r_GlideRecord-_query_Object_Object__ul_qcl_14d_lpb}
{#r_GlideRecord-_query_Object_Object__id_z1c_ptd_lpb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Opcional - Também deve especificar um parâmetro de valor. Nome do campo para pesquisar o valor especificado no parâmetro Valor. Nota: Este método é normalmente executado sem argumentos, mas você pode especificar um par nome-valor para filtrar registros que contêm os valores especificados. Se os parâmetros forem especificados, a condição "nome" será adicionada à consulta. |
| valor | Cadeia de caracteres | Opcional - Também deve especificar um parâmetro de campo. Valor a ser pesquisado no parâmetro de campo especificado. |
[Tabela 158. Parâmetros]

{#r_GlideRecord-_query_Object_Object__id_z1c_ptd_lpb} {#r_GlideRecord-_query_Object_Object__table_dvc_s5q_dt__entry__2}

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

{#r_GlideRecord-_query_Object_Object__table_dvc_s5q_dt}  
O exemplo a seguir mostra como consultar a tabela Feedback de conhecimento \[kb_feedback\] e listar artigos da base de conhecimento com comentários que incluem o Excel.

    var rec = new GlideRecord('kb_feedback');
    rec.addQuery('comments', 'CONTAINS', 'Excel');
    rec._query();
    while (rec.next()) { 
     gs.info(rec.getDisplayValue('article') + " comment: " + rec.getValue('comments'));
    }

Saída:

    KB0000005 comment: 
    	     Can you please add the version of Excel this applies to? All?
    		
    KB0000005 comment: 
    	     Does this work for all Excel versions? OSX and Windows alike?

### Escopo equivalente {#r_GlideRecord-_query_Object_Object__section_u4j_xcs_mcb}

Para usar o método _query() em uma aplicação com escopo, use o método com escopo correspondente: [_Query()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-_query_O_O "Executa uma consulta na tabela com base nos filtros especificados nos métodos de consulta, como addQuery() e addEncodedQuery(). Este método deve ser usado em tabelas em que há uma coluna chamada \"query\", o que pode causar erros ao executar o método query().").

## QueryNoDomain (campo de cadeia de caracteres, valor da cadeia de caracteres) {#ariaid-title82}

Usado em instâncias separadas por domínio. Semelhante ao query(), executa a consulta na tabela com base nos filtros especificados por addQuery() e addEncodedQuery(), mas ignora domínios.
Este método consulta a tabela GlideRecord, bem como todas as referências da tabela. Para obter mais informações, consulte [Consultar tabelas no script](https://www.servicenow.com/docs/q4J01nmu1lvw3Z5QUb0oJA#c_UsingGlideRecordToQueryTables "Usando métodos na API GlideRecord, você pode retornar todos os registros de uma tabela, retornar registros de uma tabela que atendam a condições específicas ou retornar registros que incluem uma cadeia de caracteres de uma única tabela ou de várias tabelas em um grupo de índice de texto.").
{#r_GlideRecord-queryNoDomain_Object_Object__id_n1d_1jk_lpb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Opcional - Também deve especificar um parâmetro de valor. Nome do campo para pesquisar o valor especificado no parâmetro Valor. Nota: Este método é normalmente executado sem argumentos, mas você pode especificar um par nome-valor para filtrar registros que contêm os valores especificados. Se os parâmetros forem especificados, a condição "nome" será adicionada à consulta. |
| valor | Cadeia de caracteres | Opcional - Também deve especificar um parâmetro de campo. Valor a ser pesquisado no parâmetro de campo especificado. |
[Tabela 160. Parâmetros]

{#r_GlideRecord-queryNoDomain_Object_Object__id_n1d_1jk_lpb} {#r_GlideRecord-queryNoDomain_Object_Object__table_w2k_25q_dt__entry__2}

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

{#r_GlideRecord-queryNoDomain_Object_Object__table_w2k_25q_dt}  
Este exemplo mostra como consultar a tabela de incidentes para todos os domínios.

    var rec = new GlideRecord('incident');
    rec.queryNoDomain();
    while (rec.next()) { 
     gs.print(rec.number + ' exists');
    }

## GlideRecord - restoreLocation() {#ariaid-title83}

Define o registro atual como o registro que foi salvo com saveLocation(). Se saveLocation() não tiver sido chamado, o registro atual será definido como o primeiro registro do GlideRecord.
{#r_GlideRecord-restoreLocation_Boolean__table_vgz_jvq_dt__entry__3}

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

{#r_GlideRecord-restoreLocation_Boolean__table_vgz_jvq_dt} {#r_GlideRecord-restoreLocation_Boolean__table_wgz_jvq_dt__entry__2}

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

{#r_GlideRecord-restoreLocation_Boolean__table_wgz_jvq_dt}  
Este exemplo mostra como salvar o local do registro atual, mover para o próximo registro e retornar para o local salvo.

    function() {
      var now_GR = new GlideRecord("incident");
      now_GR.query();
      now_GR.next();
      var firstID = now_GR.getValue("sys_id");
      now_GR.next();
      var restoreID = now_GR.getValue("sys_id");
      now_GR.saveLocation();
      now_GR.next();
      var lastID = now_GR.getValue("sys_id");
      now_GR.restoreLocation();
      now_GR.next();
      var thisID = now_GR.getValue("sys_id");
      var progress = "first id=" + firstID
        + "\n\t last id=" + lastID
        + "\n\t saved id=" + restoreID
        + "\n\t restored id=" + thisID;
      gs.print("Progress:\n\t" + progress);
    }

## GlideRecord - saveLocation() {#ariaid-title84}

Salva o número da linha atual para que você possa retornar a este local usando o método restoreLocation().
{#r_GlideRecord-saveLocation__table_xpb_zvq_dt__entry__3}

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

{#r_GlideRecord-saveLocation__table_xpb_zvq_dt} {#r_GlideRecord-saveLocation__table_ypb_zvq_dt__entry__2}

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

{#r_GlideRecord-saveLocation__table_ypb_zvq_dt}  
Este exemplo mostra como salvar o local do registro atual, mover para o próximo registro e retornar para o local salvo.

    function() {
      var now_GR = new GlideRecord("incident");
      now_GR.query();
      now_GR.next();
      var firstID = now_GR.getValue("sys_id");
      now_GR.next();
      var restoreID = now_GR.getValue("sys_id");
      now_GR.saveLocation();
      now_GR.next();
      var lastID = now_GR.getValue("sys_id");
      now_GR.restoreLocation();
      now_GR.next();
      var thisID = now_GR.getValue("sys_id");
      var progress = "first id=" + firstID
        + "\n\t last id=" + lastID
        + "\n\t saved id=" + restoreID
        + "\n\t restored id=" + thisID;
      gs.print("Progress:\n\t" + progress);
    }

## SetAbortAction (booliano b) {#ariaid-title85}

Define um sinalizador para indicar se a próxima ação do banco de dados (inserir, atualizar, excluir) deve ser anulada.
Use em uma regra de negócio onBefore para impedir que a ação do banco de dados seja realizada. A regra de negócio continua a ser executada depois que setAbortAction() é chamada. Chamar setAbortAction() não impede a execução de regras de negócio subsequentes. Chamar este método impede apenas que a ação do banco de dados ocorra.
{#r_GlideRecord-setAbortAction_Boolean__table_dch_kgw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| b | Booliano | Verdadeiro para anular a próxima ação ou falso para permitir a próxima ação. |
[Tabela 166. Parâmetros]

{#r_GlideRecord-setAbortAction_Boolean__table_dch_kgw_dt} {#r_GlideRecord-setAbortAction_Boolean__table_ech_kgw_dt__entry__2}

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

{#r_GlideRecord-setAbortAction_Boolean__table_ech_kgw_dt}  

    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);
      }
    }

### Escopo equivalente {#r_GlideRecord-setAbortAction_Boolean__section_qbn_bgs_mcb}

Para usar o método setAbortAction() em uma aplicação com escopo, use o método com escopo correspondente: [SetAbortAction()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordSetAbortAction_Boolean "Define um sinalizador para indicar se a próxima ação do banco de dados (inserir, atualizar, excluir) deve ser anulada. Isso é frequentemente usado em regras de negócio.").

## SetCategory (categoria de cadeia de caracteres) {#ariaid-title86}

Define a categoria de consulta, que determina como a consulta é roteada para um banco de dados secundário.
Este método requer o plug-in Pools de banco de dados secundários \[com.glide.secondary_db_pools\]. Chame este método para rotear consultas para um banco de dados secundário (réplica de leitura) com base na categoria especificada, reduzindo a carga no banco de dados primário. Devido ao atraso na replicação, a execução de uma consulta em um banco de dados de réplica de leitura pode retornar resultados ligeiramente desatualizados em comparação com a execução da mesma consulta no banco de dados primário.

As modificações nos dados são sempre atendidas pelo banco de dados primário, mesmo que setCategory() seja usado na consulta. Por exemplo, uma chamada para GlideRecord.update() é sempre direcionada para o banco de dados primário, mesmo que o objeto GlideRecord tenha sido fornecido com o nome de uma categoria de banco de dados secundária via setCategory().

Para obter mais informações, consulte [KB0824441 Introdução aos bancos de dados de réplica de leitura da ServiceNow](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0824441).
{#GR-setCategory_S__table_bns_y1r_cjc__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| categoria | Cadeia de caracteres | Nome da categoria a ser usada para rotear a consulta para um banco de dados secundário. Tabela: Categorias de banco de dados secundário \[sys_db_category\] |
[Tabela 168. Parâmetros]

{#GR-setCategory_S__table_bns_y1r_cjc} {#GR-setCategory_S__table_cns_y1r_cjc__entry__2}

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

{#GR-setCategory_S__table_cns_y1r_cjc}  
Este exemplo usa a categoria embed_list para rotear a consulta para um banco de dados secundário.

    var gr = new GlideRecord('task');
    gr.setCategory('embedded_list');
    gr.query();

### Escopo equivalente {#GR-setCategory_S__section_m2z_ykr_mcb}

Para usar o método setCategory() em uma aplicação com escopo, use o método com escopo correspondente: [SetCategory()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-setCategory_S "Define a categoria de consulta, que determina como a consulta é roteada para um banco de dados secundário.").

## SetDisplayValue (nome da cadeia de caracteres, valor do objeto) {#ariaid-title87}

Define um campo especificado, ou um atributo em um armazenamento dinâmico de atributos, como um valor de exibição especificado.
Para um campo de referência, este é o valor de exibição da tabela. Para uma data/hora, esta é a hora no fuso horário atual do solicitante.
{#r_GlideRecord-setDisplayValue_String_Object__table_ijf_wgw_dt__entry__3}{#r_GlideRecord-setDisplayValue_String_Object__DynS-value-entry}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo no qual definir o valor. Para definir um atributo em um armazenamento dinâmico de atributos, forneça o caminho do atributo. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#r_GlideRecord-setDisplayValue_String_Object__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
| valor | Object | Valor a ser definido no atributo especificado. Nota: Para atributos dinâmicos, somente os seguintes tipos de dados são compatíveis: * (Verdadeiro/falso) * Decimal * Número de ponto flutuante * GlideDate * GlideDateTime * Inteiro * Cadeia de caracteres {#r_GlideRecord-setDisplayValue_String_Object__ul_dwc_vyy_1hc} |
[Tabela 170. Parâmetros]

{#r_GlideRecord-setDisplayValue_String_Object__table_ijf_wgw_dt} {#r_GlideRecord-setDisplayValue_String_Object__table_jjf_wgw_dt__entry__2}

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

{#r_GlideRecord-setDisplayValue_String_Object__table_jjf_wgw_dt}  
O exemplo de código a seguir mostra como definir um valor de exibição em um registro e atualizar o registro.

    var now_GR = new GlideRecord('incident');
    now_GR.get('46f09e75a9fe198100f4ffd8d366d17b');
    now_GR.setDisplayValue('opened_at','2011-02-13 4:30:00');
    now_GR.update();

O exemplo de código a seguir mostra como definir um valor de exibição em um armazenamento dinâmico de atributos.

    var gr_AppTab = new GlideRecord('application_table'); 
    gr_AppTab.setValue('dyn_att_field->attr', 42); 
    gr_AppTab.setDisplayValue('dyn_att_field->attr2, true);
    gr_AppTab.update();
    gs.info('Attr value: ' + 
    gr_AppTab.getDisplayValue('dyn_att_field->attr);
    gs.info('Attr2 value: ' + 
    gr_AppTab.getDisplayValue('dyn_att_field->attr2);

## SetDynamicAttributeValue(cadeia de caracteres fullPath, valor do objeto) {#ariaid-title88}

Define o valor do atributo dinâmico localizado em um caminho especificado.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-setDynamicAttributeValue_S_O__ul_cx2_lf1_r3c}
{#GR-setDynamicAttributeValue_S_O__table_ynk_tdx_1bc__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Caminho completo | Cadeia de caracteres | Caminho a ser usado para localizar o atributo dinâmico desejado. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#GR-setDynamicAttributeValue_S_O__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
| valor | Object | Valor para definir o atributo dinâmico especificado. O valor aprovado deve ser de um dos seguintes tipos de dados: * (Verdadeiro/falso) * Decimal * Número de ponto flutuante * GlideDate * GlideDateTime * Inteiro * Cadeia de caracteres {#GR-setDynamicAttributeValue_S_O__DynS-valid_data_types-ul} |
[Tabela 172. Parâmetros]

{#GR-setDynamicAttributeValue_S_O__table_ynk_tdx_1bc} {#GR-setDynamicAttributeValue_S_O__table_znk_tdx_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o atributo dinâmico foi atualizado com sucesso. Valores possíveis: * Verdadeiro: O atributo dinâmico foi atualizado com sucesso. * Falso: Ocorreu um erro. O atributo dinâmico não foi atualizado. Verifique se o fullPath parâmetro contém um caminho válido para o atributo desejado. |
[Tabela 173. Retorna]

{#GR-setDynamicAttributeValue_S_O__table_znk_tdx_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->color","black");
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->make","Honda");
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->model","CRV");
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->luxury",false);
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->cost",20000);
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->avg_mpg",28.4);
    gr_Inc.setDynamicAttributeValue("inc_dynamic_schema->date_purchased", new GlideDateTime());
    gr_Inc.setDynamicAttributeValue("u_attributes->total_miles", 120000.12345);
    gr_Inc.insert();

## SetDynamicAttributeValue(cadeia de caracteres dynamicAttributeField, cadeia de caracteres attrPath, valor do objeto) {#ariaid-title89}

Define o valor do atributo dinâmico localizado em um campo especificado do GlideRecord atual e um caminho de atributo especificado.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-setDynamicAttributeValue_S_S_O__ul_cx2_lf1_r3c}
{#GR-setDynamicAttributeValue_S_S_O__table_l12_f2x_1bc__entry__3}{#GR-setDynamicAttributeValue_S_S_O__DynS-dynamicAttributeField-entry}

| Nome | Tipo | Descrição |
|-|-|-|
| DynamicAttributeField | Cadeia de caracteres | Nome do campo na tabela que contém o atributo dinâmico. |
| AttributePath | Cadeia de caracteres | Caminho do atributo a ser usado para localizar o atributo do esquema dinâmico associado. Formato: `"attr_name"` `attr_name`: Nome do atributo dinâmico. Tabela: No campo de atributo da tabela Atributo dinâmico \[dynamic_attribute\]. |
| valor | Object | Valor para definir o atributo dinâmico especificado. O valor aprovado deve ser de um dos seguintes tipos de dados: * (Verdadeiro/falso) * Decimal * Número de ponto flutuante * GlideDate * GlideDateTime * Inteiro * Cadeia de caracteres {#GR-setDynamicAttributeValue_S_S_O__DynS-valid_data_types-ul} |
[Tabela 174. Parâmetros]

{#GR-setDynamicAttributeValue_S_S_O__table_l12_f2x_1bc} {#GR-setDynamicAttributeValue_S_S_O__table_m12_f2x_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o atributo dinâmico foi atualizado com sucesso. Valores possíveis: * Verdadeiro: O atributo dinâmico foi atualizado com sucesso. * Falso: Ocorreu um erro. O atributo dinâmico não foi atualizado. Verifique se os dynamicAttributeFieldattrPath parâmetros e contêm dados válidos. |
[Tabela 175. Retorna]

{#GR-setDynamicAttributeValue_S_S_O__table_m12_f2x_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    // Update the value of the attribute 'attribute_store->time_of_purchase' incident INC0009009 to a timestamp (in UTC)
    var gr1 = new GlideRecord('incident');
    gr1.get('number', 'INC0009009');
    gr1.setDynamicAttributeValue('attribute_store', 'time_of_purchase', '2020-05-13 13:52:44');
    gr1.update();

    // Then retrieve the value of the attribute on the same record
    var gr2 = new GlideRecord('incident');
    gr2.get('number', 'INC0009009');
    gs.info("Time of Purchase Value        (UTC): " + gr2.getDynamicAttributeValue('attribute_store', 'time_of_purchase'));
    gs.info("Time of Purchase DisplayValue (PST): " + gr2.getDynamicAttributeDisplayValue('attribute_store', 'time_of_purchase'));

Saída:

    *** Script: Time of Purchase Value        (UTC): 2020-05-13 13:52:44
    *** Script: Time of Purchase DisplayValue (PST): 2020-05-13 06:52:44

## SetDynamicAttributeDisplayValue(cadeia de caracteres fullPath, valor do objeto) {#ariaid-title90}

Define o valor de exibição do atributo dinâmico localizado em um caminho especificado.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-setDynAttributeDisplayValue_S_O__ul_cx2_lf1_r3c}
{#GR-setDynAttributeDisplayValue_S_O__table_g4h_s2x_1bc__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Caminho completo | Cadeia de caracteres | Caminho a ser usado para localizar o atributo dinâmico cujo valor de exibição você deseja atualizar. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#GR-setDynAttributeDisplayValue_S_O__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
| valor | Object | Valor de exibição para definir o atributo dinâmico especificado. O valor aprovado deve ser de um dos seguintes tipos de dados: * (Verdadeiro/falso) * Decimal * Número de ponto flutuante * GlideDate * GlideDateTime * Inteiro * Cadeia de caracteres {#GR-setDynAttributeDisplayValue_S_O__DynS-valid_data_types-ul} |
[Tabela 176. Parâmetros]

{#GR-setDynAttributeDisplayValue_S_O__table_g4h_s2x_1bc} {#GR-setDynAttributeDisplayValue_S_O__table_h4h_s2x_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o valor de exibição do atributo dinâmico foi atualizado com sucesso. Valores possíveis: * Verdadeiro: O valor de exibição do atributo dinâmico foi atualizado com sucesso. * Falso: Ocorreu um erro. O valor de exibição do atributo dinâmico não foi atualizado. Verifique se o fullPath parâmetro contém um caminho válido para o atributo desejado. |
[Tabela 177. Retorna]

{#GR-setDynAttributeDisplayValue_S_O__table_h4h_s2x_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    var grProdTab = new GlideRecord('products_table');
    grProdTab.query();
    grProdTab.next();
    var val = grProdTab.setDynamicAttributeDisplayValue('product_details->date_purchased', '2023-03-31 08:54:26');

## SetDynamicAttributeDisplayValue(cadeia de caracteres dynamicAttributeField, cadeia de caracteres attrPath, valor do objeto) {#ariaid-title91}

Define o valor de exibição do atributo dinâmico localizado em um campo especificado do GlideRecord atual e um caminho de atributo especificado.
Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-setDynAttributeDisplayValue_S_S_O__ul_cx2_lf1_r3c}
{#GR-setDynAttributeDisplayValue_S_S_O__table_l1k_1fx_1bc__entry__3}{#GR-setDynAttributeDisplayValue_S_S_O__DynS-dynamicAttributeField-entry}

| Nome | Tipo | Descrição |
|-|-|-|
| DynamicAttributeField | Cadeia de caracteres | Nome do campo na tabela que contém o atributo dinâmico. |
| Caminho de atributo | Cadeia de caracteres | Caminho do atributo a ser usado para localizar o atributo do esquema dinâmico associado. Formato: `"attr_name"` `attr_name`: Nome do atributo dinâmico. Tabela: No campo de atributo da tabela Atributo dinâmico \[dynamic_attribute\]. |
| valor | Object | Valor de exibição para definir o atributo dinâmico especificado. O valor aprovado deve ser de um dos seguintes tipos de dados: * (Verdadeiro/falso) * Decimal * Número de ponto flutuante * GlideDate * GlideDateTime * Inteiro * Cadeia de caracteres {#GR-setDynAttributeDisplayValue_S_S_O__DynS-valid_data_types-ul} |
[Tabela 178. Parâmetros]

{#GR-setDynAttributeDisplayValue_S_S_O__table_l1k_1fx_1bc} {#GR-setDynAttributeDisplayValue_S_S_O__table_m1k_1fx_1bc__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o valor de exibição do atributo dinâmico foi atualizado com sucesso. Valores possíveis: * Verdadeiro: O valor de exibição do atributo dinâmico foi atualizado com sucesso. * Falso: Ocorreu um erro. O valor de exibição do atributo dinâmico não foi atualizado. Verifique se os dynamicAttributeFieldattrPath parâmetros e contêm dados válidos. |
[Tabela 179. Retorna]

{#GR-setDynAttributeDisplayValue_S_S_O__table_m1k_1fx_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    var grProdTab = new GlideRecord('products_table');
    grProdTab.query();
    grProdTab.next();
    var val = grProdTab.setDynamicAttributeDisplayValue('product_details', 'date_purchased', '2023-03-31 08:54:26');

## SetDynamicAttributeValues(cadeia de caracteres dynamicAttributeField, GlideDynamicAttributeStore valores) {#ariaid-title92}

Define um ou mais valores de atributo dinâmico com valores especificados no objeto GlideDynamicAttributeStore aprovado.
Este método atualiza somente os atributos e valores passados como argumentos. Os atributos e valores no GlideRecord que não são especificados não são afetados por esta chamada. Todos os atributos ou valores inválidos serão ignorados. Verifique as mensagens de log para obter possíveis informações de erro.

Os atributos dinâmicos têm um tipo de dados definido e um sys_id. Para obter mais detalhes sobre atributos dinâmicos, consulte [Esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
Consulte também:

* [GlideDynamicAttribute - Global](https://www.servicenow.com/docs/~3UShTEZT2sEnchtW6m4sA#GlideDynamicAttributeAPI "A API GlideDynamicAttribute fornece acesso a metadados de atributos dinâmicos.")
* [GlideDynamicAttributeStore - Global](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.")
* [Namespace GlideDynamicNamespace - Global](https://www.servicenow.com/docs/bMpQGKjDt5YcO5Ofv5AqIQ#GlideDynamicNamespaceAPI "A API GlideDynamicNamespace fornece acesso a metadados de namespace dinâmico.")
{#GR-setDynAttributeValues_S_O__ul_cx2_lf1_r3c}
{#GR-setDynAttributeValues_S_O__table_r5l_4fx_1bc__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| DynamicAttributeField | Cadeia de caracteres | Nome do campo na tabela atual que contém o [esquema dinâmico](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
| valores | [GlideDynamicAttributeStore](https://www.servicenow.com/docs/HWs9bdWtNaCPza89jAgPTQ#GlideDynamicAttStoreAPI "Use a API GlideDynamicAttributeStore para criar objetos para trabalhar com atributos dinâmicos independentemente de uma tabela ou campo.") | Objeto GlideDynamicAttributeStore que contém os atributos dinâmicos a serem atualizados. Os valores preenchidos no objeto devem ser dos seguintes tipos de dados: * (Verdadeiro/falso) * Decimal * Número de ponto flutuante * GlideDate * GlideDateTime * Inteiro * Cadeia de caracteres {#GR-setDynAttributeValues_S_O__ul_qjm_bc2_bbc} |
[Tabela 180. Parâmetros]

{#GR-setDynAttributeValues_S_O__table_r5l_4fx_1bc} {#GR-setDynAttributeValues_S_O__table_s5l_4fx_1bc__entry__2}

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

{#GR-setDynAttributeValues_S_O__table_s5l_4fx_1bc}  
O exemplo de código a seguir mostra como chamar este método.

    var das = new GlideDynamicAttributeStore();
    das.setDynamicAttributeValue('attribute1', 'Apple');
    das.setDynamicAttributeValue('attribute2', 1234);

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.query();
    gr_Inc.next();
    gr_Inc.setDynamicAttributeValues(das);

## SetForceUpdate (força booliana) {#ariaid-title93}

Atualiza o registro mesmo que os campos não tenham sido alterados.
{#r_GlideRecord-setForceUpdate_Boolean__table_eds_lhw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| força | Booliano | Verdadeiro para atualizar mesmo que os campos não tenham sido alterados, caso contrário, falso. |
[Tabela 182. Parâmetros]

{#r_GlideRecord-setForceUpdate_Boolean__table_eds_lhw_dt} {#r_GlideRecord-setForceUpdate_Boolean__table_fds_lhw_dt__entry__2}

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

{#r_GlideRecord-setForceUpdate_Boolean__table_fds_lhw_dt}  
Este exemplo mostra como forçar um registro na tabela itfm_cost_model a atualizar mesmo sem mudanças.

    function() {
      gs.log("Update Script: Upgrade_cost_model_data.js started");
      var now_GR = new GlideRecord("itfm_cost_model");
      now_GR.initialize();
      now_GR.addNullQuery("source_table");
      now_GR.query();
      while (now_GR.next()) {
        now_GR.setForceUpdate(true);
        var sourceTable = getSourceTable(now_GR.getValue('clone_from'));
        if(sourceTable){
          now_GR.setValue("source_table", sourceTable);
          now_GR.setWorkflow(false);
          now_GR.update();
        }
      }
    }

## SetLimit (limite de número) {#ariaid-title94}

Define o número máximo de registros a serem retornados no GlideRecord de uma consulta.

Usando setLimit() com chooseWindow()
:   O método setLimit() chama implicitamente o método chooseWindow() e pode causar resultados inesperados quando usado com chooseWindow() em uma consulta.

    * Se o método chooseWindow() for chamado primeiro, sua janela de registro será substituída pelo método setLimit().  
      Usar as seguintes linhas em uma consulta retorna 100 registros começando na linha 1:

          grIncident.chooseWindow(20,30);
          grIncident.setLimit(100);

    * Se o método setLimit() for chamado primeiro, a janela definida por chooseWindow() será usada e o limite será substituído.  
      Usar as seguintes linhas em uma consulta retorna 10 registros começando na linha 21:

          grIncident.setLimit(5);
          grIncident.chooseWindow(20,30);

      Nota:  
      Executar query() com o método chooseWindow() aciona uma consulta COUNT(\*), o que pode resultar em desempenho lento em tabelas com um grande número de registros. Você pode usar setLimit() antes de chooseWindow() para ignorar a execução da consulta COUNT(\*), mas o mesmo benefício de desempenho é possível usando setNoCount().
{#r_GlideRecord-setLimit_Number__ul_btb_yhw_wgc}  
Consulte também:

* [ChooseWindow()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-chooseWindow_N_N_B "Define um intervalo de linhas a serem retornadas por consultas subsequentes.")
* [consulta ()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-query_Object_Object "Executa uma consulta na tabela com base nos filtros especificados nos métodos de consulta, como addQuery() e addEncodedQuery().")
* [SetNoCount()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-setNoCount "Impede que uma consulta GlideRecord execute uma consulta COUNT(*).")
{#r_GlideRecord-setLimit_Number__ul_zjw_cvd_xgc}
{#r_GlideRecord-setLimit_Number__table_pcb_whw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| limite | Número | Limite de registros a serem buscados. |
[Tabela 184. Parâmetros]

{#r_GlideRecord-setLimit_Number__table_pcb_whw_dt} {#r_GlideRecord-setLimit_Number__table_qcb_whw_dt__entry__2}

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

{#r_GlideRecord-setLimit_Number__table_qcb_whw_dt}  
Este exemplo define o número de registros retornados na consulta como no máximo dez.

    var now_GR = new GlideRecord('incident');
    now_GR.orderByDesc('sys_created_on');
    now_GR.setLimit(10);
    now_GR.query();

### Escopo equivalente {#r_GlideRecord-setLimit_Number__section_vrk_dgs_mcb}

Para usar o método setLimit() em uma aplicação com escopo, use o método com escopo correspondente: [SetLimit()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordSetLimit_Number "Define o limite para o número de registros obtidos pela consulta GlideRecord.").

## SetLocation (Number rowNumber) {#ariaid-title95}

Define o local da linha atual com o valor especificado.
{#r_GlideRecord-setLocation_Number__table_tjd_j3w_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| RowNumber | Número | Número da linha a ser definido como a linha atual. |
[Tabela 186. Parâmetros]

{#r_GlideRecord-setLocation_Number__table_tjd_j3w_dt} {#r_GlideRecord-setLocation_Number__table_ujd_j3w_dt__entry__2}

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

{#r_GlideRecord-setLocation_Number__table_ujd_j3w_dt}  
Este exemplo mostra como definir a posição do registro na tabela Incidente

    verifySetLocation : function() {
      var now_GR = new GlideRecord("incident");
      now_GR.query();
      var recordIDs = new Array();
      while(now_GR.next()) {
      recordIDs.push(now_GR.getValue("sys_id"));
      }
      for (var ix = recordIDs.length - 1; ix >= 0; ix--) {
        now_GR.setLocation(ix);
        Assert.assertEquals(recordIDs[ix], now_GR.getValue("sys_id"),
          "The entry retrieved for the index " + ix + " is not valid");
      }
    }

## SetNewGuid() {#ariaid-title96}

Gera um novo GUID e o define como o ID exclusivo (sys_id) do registro atual.
Esta função se aplica somente a novos registros. Não é possível alterar o GUID de um registro existente.
{#r_GlideRecord-setNewGuid__table_mjn_r3w_dt__entry__3}

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

{#r_GlideRecord-setNewGuid__table_mjn_r3w_dt} {#r_GlideRecord-setNewGuid__table_njn_r3w_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Sys_id do registro atual. |
[Tabela 189. Retorna]

{#r_GlideRecord-setNewGuid__table_njn_r3w_dt}  
Este exemplo cria um novo registro de tarefa e armazena o ID na tabela task_rel_task.

    var task = new GlideRecord ('task');
    var tsk_id = task.setNewGuid();
     
    task.description = "Request: " + current.request.number;
    task.description = task.description + "\n" + "Requested by: " + current.request.u_requested_by.name;
    task.description = task.description + "\n" + "Requested for: " + current.request.u_requested_for.name;
    task.description = task.description + "\n" + "Item: " + current.cat_item.name;
     
    var now_GR = new GlideRecord ('task_rel_task');
    //link the incident to the request
    now_GR.parent = current.request;
    now_GR.child = tsk_id;
    now_GR.insert();

## SetNewGuidValue (cadeia de caracteres guid) {#ariaid-title97}

Gera um novo GUID e o define como o ID exclusivo do registro atual ao inserir um novo registro.
{#r_GlideRecord-setNewGuidValue_String__table_qgt_1jw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| guid | Cadeia de caracteres | Valor do novo GUID. |
[Tabela 190. Parâmetros]

{#r_GlideRecord-setNewGuidValue_String__table_qgt_1jw_dt} {#r_GlideRecord-setNewGuidValue_String__table_rgt_1jw_dt__entry__2}

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

{#r_GlideRecord-setNewGuidValue_String__table_rgt_1jw_dt}  
Este exemplo gera um novo GUID e o define como o ID exclusivo do registro cmdb_software_instance recém-criado.

    var gobj = new GlideRecord('sys_db_object');
    gobj.addQuery('name','cmdb_software_instance');
    gobj.query();
    if (!gobj.next()) {
      var si = new GlideRecord('cmdb_software_instance');
      si.query();
      var count = 0;
      while (si.next()) {
      if (!si.isValidField('sys_class_name')) {
        var ci = new GlideRecord('cmdb_ci');
        ci.name = si.name;
        ci.setNewGuidValue(si.sys_id);
        ci.sys_class_name = 'cmdb_software_instance';
        ci.insert();
        count++;
      }
    }

### Escopo equivalente

Para usar o método setNewGuidValue() em uma aplicação com escopo, use o método com escopo correspondente: [SetNewGuidValue()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordSetNewGuidValue_String "Define o valor sys_id do registro atual.").

## SetNoCount() {#ariaid-title98}

Impede que uma consulta GlideRecord execute uma consulta COUNT(\*).
Executar query() com alguns métodos aciona uma consulta COUNT(\*), como os métodos chooseWindow() e getRowCount(). A consulta COUNT(\*) pode causar desempenho lento em tabelas com um milhão ou mais registros. Para obter mais informações, consulte o [https://support.servicenow.com/kb?id=kb_article_view\&sysparm_article=KB0817996](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0817996) artigo Melhoria de desempenho - Remover contagem de paginação \[KB0817996\] na Base de conhecimento do Now Support.  
Nota:  
O método setLimit() também interrompe uma `CONTAGEM(*)`. O uso de setNoCount() é desnecessário se o método setLimit() estiver incluído na consulta.  
Consulte também:

* [ChooseWindow()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#GR-chooseWindow_N_N_B "Define um intervalo de linhas a serem retornadas por consultas subsequentes.")
* [consulta ()](https://www.servicenow.com/docs/Q_BMDeKD6IamkvSPQxMBjg#r_GlideRecord-query_Object_Object "Executa uma consulta na tabela com base nos filtros especificados nos métodos de consulta, como addQuery() e addEncodedQuery().")
{#GR-setNoCount__ul_zjw_cvd_xgc}
{#GR-setNoCount__table_l12_f2x_1bc__entry__3}

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

{#GR-setNoCount__table_l12_f2x_1bc} {#GR-setNoCount__table_obb_bv4_2gb__entry__2}

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

{#GR-setNoCount__table_obb_bv4_2gb}  
O exemplo de código a seguir mostra como usar setNoCount() para ignorar a consulta COUNT(\*) em um conjunto de consultas com janela usando o método chooseWindow().

    var  grIncident = new GlideRecord('incident');

    grIncident.chooseWindow(6915, 6920, true);
    grIncident.setNoCount();
    grIncident.query();

    while (grIncident.next()) { // Iterate through the returned records
        gs.info('Incident Number: ' + grIncident.number + ', Short Description: ' + grIncident.short_description);
    };

Saída:

    Incident Number: INC0006811, Short Description: Request an account to be created for Fidelity 401(k) Plans
    Incident Number: INC0006918, Short Description: Please grant me additional roles in Oracle Fin Collections
    Incident Number: INC0006812, Short Description: Taxware Value-added Tax crashes when I try to launch it
    Incident Number: INC0006919, Short Description: Unable to Access SuccessFactors Learning
    Incident Number: INC0010004, Short Description: Incident for assessment not generating

### Escopo equivalente {#GR-setNoCount__section_zz2_zxc_xgc}

Para usar o método setNoCount() em uma aplicação com escopo, use o método com escopo correspondente: [SetNoCount()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#SGR-setNoCount "Impede que uma consulta GlideRecord execute uma consulta COUNT(*).").

## SetQueryReferences(Boolian queryReferences) {#ariaid-title99}

Habilita ou desabilita o uso do nome de exibição do campo de referência ao consultar um campo de referência.
{#r_GlideRecord-setQueryReferences_Boolean__table_zyr_ljw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ConsultarReferências | Booliano | Sinalizador que indica a hora dos dados a serem gerados. Valores válidos: * Verdadeiro: Gere uma cadeia de caracteres de nomes de exibição. * Falso: Gere uma cadeia de caracteres de sys_ids. {#r_GlideRecord-setQueryReferences_Boolean__ul_mts_315_1nb} |
[Tabela 194. Parâmetros]

{#r_GlideRecord-setQueryReferences_Boolean__table_zyr_ljw_dt} {#r_GlideRecord-setQueryReferences_Boolean__table_azr_ljw_dt__entry__2}

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

{#r_GlideRecord-setQueryReferences_Boolean__table_azr_ljw_dt}  

    var grByName = new GlideRecord(this.TEST_TABLE);
    grByName.addQuery("caller_id", userDisplayName);
    grByName.setQueryReferences(true);
    grByName.query();
    if (grByName.hasNext()) {
      while(grByName.next()) {
        gs.print("Incident caller_id=" + grByName.caller_id);
      }
    } else {
      gs.print("NO RESULTS");
    }

## SetUseEngines (boolian e) {#ariaid-title100}

Desabilita ou habilita a execução de qualquer mecanismo (regras de aprovação/regras de atribuição).
Aviso:  
A desativação da execução de mecanismos pode ter um impacto significativo na sua ServiceNow® instância e na forma como ela funciona. Teste completamente esta mudança antes de implantá-la na produção.
{#r_GlideRecord-setUseEngines_Boolean__table_gdy_vjw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| e | Booliano | Sinalizador que indica se habilitar ou desabilitar a execução de qualquer mecanismo. Valores válidos: * Verdadeiro: Habilitar mecanismos * Falso: Desabilite mecanismos {#r_GlideRecord-setUseEngines_Boolean__ul_rb1_bwx_zqb} |
[Tabela 196. Parâmetros]

{#r_GlideRecord-setUseEngines_Boolean__table_gdy_vjw_dt} {#r_GlideRecord-setUseEngines_Boolean__table_hdy_vjw_dt__entry__2}

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

{#r_GlideRecord-setUseEngines_Boolean__table_hdy_vjw_dt}  
Este exemplo mostra como desabilitar mecanismos e regras de negócio antes de executar uma consulta.

    function auditOAuthInboundRequestsUsage(){
      var now_GR = new GlideRecord("oauth_credential");
      var oauthClient = now_GR.addJoinQuery("oauth_entity", "peer", "sys_id");
      now_GR.addQuery("type", "access_token");
      now_GR.addQuery("expires", ">", nowDateTime());
      now_GR.addNullQuery("oauth_requestor_profile");
      oauthClient.addCondition("active", "true");
      oauthClient.addCondition("type", "client");
      now_GR.setUseEngines(false);
      now_GR.setWorkflow(false);
      now_GR.query();
      return now_GR.hasNext();
    }

## SetValue (Nome da cadeia de caracteres, valor do objeto) {#ariaid-title101}

Define o campo especificado, ou um atributo em um armazenamento dinâmico de atributos, como um valor especificado.
Normalmente, um script faria uma atribuição direta, por exemplo, `now_GR.category: Valor`. No entanto, se em um script o nome do elemento for uma variável, você poderá usar `now_GR.setValue(elementName, valor)`. Ao definir um valor, certifique-se de que o tipo de dados do campo corresponda ao tipo de dados do valor inserido. Para obter informações sobre as diferenças entre usar setValue() e atribuição direta, consulte [Explicação do comportamento de atribuição para campos GlideList de referência \[KB2557324\]](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB2557324) no Now Support Base de conhecimento.  
Se o parâmetro value for nulo, o registro não será atualizado e um erro não será gerado.  
Nota:  
Este método não pode ser usado em campos de diário. [GlideElement - Global](https://www.servicenow.com/docs/8b~fKEUHbZF~fL1vQDQZ9g#c_GlideElementAPI "A API GlideElement fornece uma série de métodos de script convenientes para lidar com campos e seus valores. Os métodos GlideElement estão disponíveis para os campos do registro Glide atual.") Em vez disso, use GlideElement.setJournalEntry().  
Nota:  
Se o Criptografia de campo Enterprise plug-in estiver habilitado e a instância tiver acesso à chave, esse método poderá inserir dados criptografados em campos criptografados. Se a instância não tiver acesso à chave, este método retornará um erro. Para obter mais informações, consulte [Criptografia da plataforma](https://www.servicenow.com/docs/access?context=encryption-landing&version=brazil&pubname=brazil-platform-security&ft:locale=en-US).  

Autenticação com campos password2
:   O método setValue() passa dados password2 como texto não criptografado, o que resulta em um erro sobre a espera de dados criptografados. Além disso, o uso do método setValue() para campos password2 expõe os dados que devem ser criptografados.

    Para autenticação password2, use o método setDisplayValue().  
    Consulte também:

    * [Deprecate GlideEncrypter usage of 3DES for password2 fields](https://www.servicenow.com/docs/access?context=password2-3des-deprecation&version=brazil&pubname=brazil-platform-security&ft:locale=en-US)
    * [Alternativas ao uso do GlideEncrypter no artigo KB1320986 da base de conhecimento](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1320986)
    * [Password2 encryption with the Key Management Framework (KMF)](https://www.servicenow.com/docs/access?context=password-2way-encrypted-fields&version=brazil&pubname=brazil-platform-security&ft:locale=en-US)
    {#r_GlideRecord-setValue_String_Object__ul_m1z_5js_12c}
{#r_GlideRecord-setValue_String_Object__table_yps_2kw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo a ser definido. Para definir valores de atributo no esquema dinâmico, use o caminho para um atributo em um armazenamento de atributos dinâmico. Formato do caminho do atributo: `Dyn_att_field->attr_name` * `Dyn_att_field`: Nome de um campo de armazenamento de atributo dinâmico na tabela. * `attr_name`: Nome do atributo dinâmico. Tabela: Atributo dinâmico \[dynamic_attribute\] {#r_GlideRecord-setValue_String_Object__ul_rsc_lvy_1hc}Consulte também [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
| valor | Object | Valor a ser definido no campo especificado. Nota: Para um atributo dinâmico, somente os seguintes tipos de dados são compatíveis: * (Verdadeiro/falso) * Decimal * Número de ponto flutuante * GlideDate * GlideDateTime * Inteiro * Cadeia de caracteres {#r_GlideRecord-setValue_String_Object__ul_wrx_cb2_bbc} Para especificar um campo de categoria dinâmica no esquema dinâmico, use uma chave de referência com o nome do campo de namespace e categoria em vez de um sys_id. Forneça a coluna de categoria como o parâmetro de nome, por exemplo, `grExample.setValue('cat_column_name', "namespace_name/cat_name")`. Para obter mais informações, consulte [Create a dynamic namespace](https://www.servicenow.com/docs/access?context=create-dynamic-namespace&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US). |
[Tabela 198. Parâmetros]

{#r_GlideRecord-setValue_String_Object__table_yps_2kw_dt} {#r_GlideRecord-setValue_String_Object__table_zps_2kw_dt__entry__2}

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

{#r_GlideRecord-setValue_String_Object__table_zps_2kw_dt}  
Este exemplo mostra como definir o valor do campo estado na tabela planned_task.

    function() {
      var topTask = new GlideRecord('planned_task');
      topTask.setValue('state', -5);
      var childTask = new GlideRecord('planned_task');
      childTask.setValue('state', -5);
      var s = new PlannedTaskStateManagement(childTask, topTask);
      var state = s.manageStateChange(false);
      Assert.assertEquals("-5", state);
    }

Este exemplo mostra como usar este método com esquema dinâmico. O primeiro uso define o valor de uma categoria dinâmica usando uma chave de referência para definir o valor. O segundo usa um caminho de atributo para definir o valor de um atributo dinâmico chamado `total_miles`.

    var used_car = new GlideRecord('u_product');

    // Using setValue() to set the dynamic category column to Car
    // u_product/u_attributes is the namespace and u_car is the category
    used_car.setValue('u_attributes_category', 'u_product/u_attributes/u_car');

    // Using setDynamicAttributeValue() to set the dynamic attribute value
    used_car.setDynamicAttributeValue("u_attributes->color","green");
    used_car.setDynamicAttributeValue("u_attributes->make","Toyota");
    used_car.setDynamicAttributeValue("u_attributes->model","Rav4");
    used_car.setDynamicAttributeValue("u_attributes->luxury",false);
    used_car.setDynamicAttributeValue("u_attributes->cost",12500);
    used_car.setDynamicAttributeValue("u_attributes->avg_mpg",24.8);
    used_car.setDynamicAttributeValue("u_attributes->date_purchased", new GlideDateTime());

    // Using setValue() to set the dynamic attribute value
    used_car.setValue("u_attributes->total_miles", 120000.12345);

    used_car.insert();

### Escopo equivalente

Para usar o método setValue() em uma aplicação com escopo, use o método com escopo correspondente: [SetValue()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordSetValue_String_Object "Define o valor do campo com o nome especificado como o valor especificado.").

## SetWorkflow (Habilitar booliano) {#ariaid-title102}

Habilita ou desabilita a execução de regras de negócio que normalmente podem ser acionadas por ações subsequentes.
Nota:  
O método setWorkflow() é ignorado ao usar posteriormente os métodos deleteProblem() ou deleteMultiple() para exclusão em cascata.  
Aviso:  
A desativação da execução de regras de negócio pode ter um impacto significativo na sua ServiceNow® instância e na forma como ela funciona. Teste completamente esta mudança antes de implantá-la na produção.
{#r_GlideRecord-setWorkFlow_Boolean__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| habilitar | Booliano | Sinalizador que indica se a execução de regras de negócio, mecanismos de script e auditoria deve ser habilitada ou desabilitada. Valores válidos: * Verdadeiro: Habilita a execução de regras de negócio, mecanismos de script ou auditorias. * Falso: Desabilita a execução de regras de negócio, mecanismos de script ou auditorias. {#r_GlideRecord-setWorkFlow_Boolean__ul_rb1_bwx_zqb} Padrão: verdadeiro |
[Tabela 200. Parâmetros]

{#r_GlideRecord-setWorkFlow_Boolean__table_vy2_525_jq} {#r_GlideRecord-setWorkFlow_Boolean__table_ydz_skw_dt__entry__2}

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

{#r_GlideRecord-setWorkFlow_Boolean__table_ydz_skw_dt}  

    doit('name1','name2'); 
     
    function doit(username1,username2) { 
     
      var usr1 = new GlideRecord('sys_user');
      var usr2 = new GlideRecord('sys_user');
      var num = 0;
     
      if (usr1.get('user_name',username1) && usr2.get('user_name',username2)) {
        var ref;
        var dict = new GlideRecord('sys_dictionary');
        dict.addQuery('reference','sys_user');
        dict.addQuery('internal_type','reference');
        dict.query();
        while (dict.next()) {
          num = 0;
          ref = new GlideRecord(dict.name.toString());
          ref.addQuery(dict.element,usr1.sys_id);
          ref.query();
          while (ref.next()) {
            ref.setValue(dict.element.toString(),usr2.sys_id); 
            ref.setWorkflow(false);
            ref.update();
            num++;
          }
          if (num > 0) {
            gs.print(dict.element + ' changed from ' + usr1.user_name + 
              ' to ' + usr2.user_name + ' in ' + num + ' ' + dict.name + ' records');
          }
        }
      }
    }

### Escopo equivalente {#r_GlideRecord-setWorkFlow_Boolean__section_hhf_4gs_mcb}

Para usar o método setWorkflow() em uma aplicação com escopo, use o método com escopo correspondente: [SetWorkflow()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordSetWorkflow_Boolean "Habilita ou desabilita a execução de regras de negócio, mecanismos de script ou auditorias.").

## Atualizar (motivo do objeto) {#ariaid-title103}

Atualiza o GlideRecord com todas as mudanças que foram feitas. Se o registro não existir, ele será inserido.
{#r_GlideRecord-update_Object__table_ovg_wlw_dt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| motivo | Object | Opcional. Motivo da atualização. O motivo aparece no registro de auditoria. |
[Tabela 202. Parâmetros]

{#r_GlideRecord-update_Object__table_ovg_wlw_dt} {#r_GlideRecord-update_Object__table_pvg_wlw_dt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O sys_id do registro novo ou atualizado. Se a atualização falhar, retorna nulo. |
[Tabela 203. Retorna]

{#r_GlideRecord-update_Object__table_pvg_wlw_dt}  
Este exemplo atualiza um registro na tabela task_ci.

    var now_GR = new GlideRecord('task_ci');
    now_GR.addQuery();
    now_GR.query();
    var count = now_GR.getRowCount();
    if (count > 0) {
       var allocation = parseInt(10000 / count) / 100;
       while (now_GR.next()) {
          now_GR.u_allocation = allocation;
          now_GR.update();
       }
    }

### Escopo equivalente {#r_GlideRecord-update_Object__section_hmx_sgs_mcb}

Para usar o método update() em uma aplicação com escopo, use o método com escopo correspondente: [Update()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordUpdate_String "Atualiza o GlideRecord com todas as mudanças que foram feitas. Se o registro ainda não existir, ele será inserido.").

## UpdateMultiple() {#ariaid-title104}

Atualiza cada GlideRecord em uma consulta informada com um conjunto especificado de mudanças.
Para obter informações sobre como adicionar entradas de diário, consulte o [SetJournalEntry (entrada de cadeia de caracteres, cadeia de caracteres de nome de usuário)](https://www.servicenow.com/docs/8b~fKEUHbZF~fL1vQDQZ9g#r_GlideElement-setJournalEntry_Object_String "Adiciona uma entrada de diário e autor como uma anotação de trabalho ou campo de comentário.") método setJournalEntry().

A glide.db.forced.chunk.threshold propriedade do sistema define o limite acima do qual força exclusões e atualizações de registro de bloco. O agrupamento ajuda a evitar que exclusões de chaves não primárias em tabelas enormes causem problemas de replicação. Para obter mais informações, consulte [Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
Nota:  
Para garantir os resultados esperados, use o método setValue() em vez de atribuições diretas. Ou seja, use `gr_Now.setValue('<field_name>', '4');` em vez de `gr_now.<field_name>: 4`.  
Nota:  
Não use este método com os métodos chooseWindow() ou setLimit() ao trabalhar com tabelas grandes.

Este método define novos valores e não limpa os valores existentes. Para limpar um valor existente, use o método setValue() e defina o campo como "NULO". Para obter mais informações, consulte [Definindo uma variável GlideRecord como "NULO"](https://www.servicenow.com/docs/qJ63ocShGQlSi7uJbpUUXA "As variáveis GlideRecord (incluindo atual) são inicialmente nulas no banco de dados. Definir isso de volta para uma cadeia de caracteres vazia, um espaço ou o valor nulo do JavaScript não resultará em um retorno a este estado inicial.").
{#r_GlideRecord-updateMultiple__table_qwk_ysb_2r__entry__3}

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

{#r_GlideRecord-updateMultiple__table_qwk_ysb_2r} {#r_GlideRecord-updateMultiple__table_fj2_htb_2r__entry__2}

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

{#r_GlideRecord-updateMultiple__table_fj2_htb_2r}  
Este exemplo mostra como atualizar o estado de todos os incidentes ativos para 4 - "Aguardando informações do usuário".

    var now_GR = new GlideRecord('incident');
    now_GR.addQuery('active', true);
    now_GR.setValue('state',  4);
    now_GR.updateMultiple();

Este exemplo mostra como limpar os valores existentes do campo de descrição para incidentes de prioridade 1.

    var test = new GlideRecord('incident');
    test.addEncodedQuery('priority=1');
    test.query();
     
    test.setValue('description','NULL');
    test.updateMultiple();

### Escopo equivalente {#r_GlideRecord-updateMultiple__section_ncr_rgs_mcb}

Para usar o método updateMultiple() em uma aplicação com escopo, use o método com escopo correspondente: [UpdateMultiple()](https://www.servicenow.com/docs/9Fi5mkZ6CrauZw~rdgSdeA#r_ScopedGlideRecordUpdateMultiple "Atualiza cada GlideRecord em uma consulta informada com um conjunto especificado de mudanças.").

## UpdateWithReferences (motivo do objeto) {#ariaid-title105}

Atualiza um registro e também insere ou atualiza todos os registros relacionados com as informações fornecidas.
{#r_GlideRecord-updateWithReferences_Object__id_ltp_jfd_3zb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| motivo | Object | Motivo das atualizações. O motivo é exibido no registro de auditoria. |
[Tabela 206. Parâmetros]

{#r_GlideRecord-updateWithReferences_Object__id_ltp_jfd_3zb} {#r_GlideRecord-updateWithReferences_Object__id_r1d_kfd_3zb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O sys_id do registro que está sendo atualizado. |
[Tabela 207. Retorna]

{#r_GlideRecord-updateWithReferences_Object__id_r1d_kfd_3zb}  
Se estiver processando um incidente em que o ID do solicitante está definido para fazer referência ao registro sys_user "John Doe", o código a seguir atualizará o registro de usuário de John Doe. Se estiver processando um incidente em que não há nenhum ID de chamador especificado, o código a seguir criará um novo registro sys_user com as informações fornecidas (first_name, last_name) e definirá o valor do ID do chamador como o registro sys_user recém-criado.

    var inc = new GlideRecord('incident');
    inc.get(inc_sys_id);  // Looking up an existing incident record where 'inc_sys_id' represents the sys_id of a incident record
    inc.caller_id.first_name = 'John';
    inc.caller_id.last_name = 'Doe';
    inc.updateWithReferences();
    }


