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

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideRecordUtil - Global

# GlideRecordUtil - Global {#ariaid-title1}

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

A inclusão de script GlideRecordUtil é uma classe de utilitário para trabalhar com GlideRecords.

Esta inclusão de script está disponível em scripts do lado do servidor. Para casos de uso, consulte [Como usar inclusões de script de descoberta](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).

## GlideRecordUtil -- getCIGR(cadeia de caracteres sys_id) {#ariaid-title2}

Retorna o objeto GlideRecord para o item de configuração (IC) especificado usando apenas o sys_id do IC.
Use este método para obter rapidamente um IC específico sem conhecer sua classe/tabela associada.
{#r_GRU-getCIGR_S__table_ccv_mjw_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sys_id | Cadeia de caracteres | Sys_id do IC desejado. |
[Tabela 1. Parâmetros]

{#r_GRU-getCIGR_S__table_ccv_mjw_4t} {#r_GRU-getCIGR_S__table_dcv_mjw_4t__entry__2}

| Tipo | Descrição |
|-|-|
| GlideRecord | Objeto GlideRecord do IC especificado. |
[Tabela 2. Retorna]

{#r_GRU-getCIGR_S__table_dcv_mjw_4t}  
O exemplo a seguir retorna o objeto GlideRecord para o IC especificado usando apenas o sys_id do IC.

    var now_GR = new GlideRecordUtil().getCIGR("2dfd7c8437201000deeabfc8bcbe5d56");

## GlideRecordUtil -- getFields(GlideRecord gr) {#ariaid-title3}

Retorna uma matriz de todos os campos no GlideRecord especificado.
Nota:  
Se houver um nome de campo igual ao nome da tabela, o método getFields() não retornará o valor do campo.
{#r_GRU-getFields_GR__table_llf_skw_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| gr | GlideRecord | Instância de GlideRecord posicionada para um registro válido. |
[Tabela 3. Parâmetros]

{#r_GRU-getFields_GR__table_llf_skw_4t} {#r_GRU-getFields_GR__table_mlf_skw_4t__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Nomes de campo para o GlideRecord especificado. |
[Tabela 4. Retorna]

{#r_GRU-getFields_GR__table_mlf_skw_4t}  

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

    var gRU = new GlideRecordUtil();
    var fieldList = gRU.getFields(now_GR);
    gs.info(fieldList);

Saída: quebras de linha adicionadas para apresentação.

    sys_id,skills,closed_by,assigned_to,contract,category,escalation,state,reassignment_count,location,
    time_worked,order,due_date,number,upon_approval,sys_tags,sla_due,follow_up,reopen_count,notify,business_stc,
    caused_by,rejection_goto,assignment_group,comments_and_work_notes,incident_state,opened_at,parent_incident,
    business_service,wf_activity,calendar_duration,group_list,caller_id,comments,priority,sys_updated_by,
    variables,delivery_task,resolved_at,sys_updated_on,parent,active,opened_by,expected_start,watch_list,
    company,upon_reject,work_notes,sys_created_by,additional_assignee_list,approval_set,cmdb_ci,user_input,
    sys_created_on,close_code,contact_type,resolved_by,rfc,approval_history,activity_due,severity,child_incidents,
    ,subcategory,work_end,closed_at,close_notes,variables,business_duration,knowledge,approval,sys_domain_path,
    sys_mod_count,problem_id,calendar_stc,work_start,sys_domain,correlation_id,sys_class_name,short_description,
    impact,description,correlation_display,urgency,made_sla,delivery_plan,work_notes_list

## GlideRecordUtil -- getGR(cadeia de caracteres baseTable, cadeia de caracteres sys_id) {#ariaid-title4}

Retorna uma instância de GlideRecord para a tabela fornecida, posicionada no sys_id fornecido e da classe correta (tabela).
Este método é útil quando você precisa carregar um GlideRecord de um sys_id, mas não sabe qual é a tabela real (porque ela pode ser estendida da tabela base). Este método sempre retorna um GlideRecord do tipo correto base_table: o nome da tabela base em que o sys_id especificado está.
{#r_GRU-getGR_S_S__table_xt1_bkw_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| baseTable | Cadeia de caracteres | O nome da tabela base que contém o sys_id. |
| sys_id | Cadeia de caracteres | O sys_id do registro desejado. |
[Tabela 5. Parâmetros]

{#r_GRU-getGR_S_S__table_xt1_bkw_4t} {#r_GRU-getGR_S_S__table_yt1_bkw_4t__entry__2}

| Tipo | Descrição |
|-|-|
| GlideRecord | O GlideRecord para o sys_id especificado. |
[Tabela 6. Retorna]

{#r_GRU-getGR_S_S__table_yt1_bkw_4t}  

    var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");

## GlideRecordUtil -- getTables(cadeia de caracteres "tableName") {#ariaid-title5}

Retorna um Java ArrayList dos ancestrais do nome da tabela especificada.
Por exemplo, dado cmdb_ci_linux_server, isso retornaria cmdb_ci_linux_server, cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci e cmdbr.
{#r_GRU-getTables_S__table_n34_hnw_4t__entry__3}

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

{#r_GRU-getTables_S__table_n34_hnw_4t} {#r_GRU-getTables_S__table_o34_hnw_4t__entry__2}

| Tipo | Descrição |
|-|-|
| ArrayList | Lista de ancestrais da tabela especificada. |
[Tabela 8. Retorna]

{#r_GRU-getTables_S__table_o34_hnw_4t}  
O exemplo a seguir mostra os ancestrais da tabela cmdb_ci_linux_server.

    var tables = new GlideRecordUtil().getTables("cmdb_ci_linux_server");
    gs.info("Tables returned: " + tables);

Saída:

    Tables returned: [cmdb_ci_linux_server, cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci, cmdb]

## GlideRecordUtil - mergeToGR (objeto hashMap, GlideRecord now_GR, objeto ignorar) {#ariaid-title6}

Define os campos no GlideRecord especificado com os valores de campos contidos no mapa de hash especificado, a menos que o nome do campo esteja no hashmap de ignorar.
{#r_GRU-mergeToGR_O_GR_O__table_i1b_tmw_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| hashMap | Objeto | Uma instância de objeto (sendo usada como um hashmap), com propriedades nomeadas para campos e contendo o valor dos campos. |
| GlideRecord | GR | A instância de GlideRecord para receber os valores de campos. |
| ignorar | Objeto | Um hashmap opcional de nomes de campo a serem ignorados. |
[Tabela 9. Parâmetros]

{#r_GRU-mergeToGR_O_GR_O__table_i1b_tmw_4t} {#r_GRU-mergeToGR_O_GR_O__table_j1b_tmw_4t__entry__2}

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

{#r_GRU-mergeToGR_O_GR_O__table_j1b_tmw_4t}  
Este exemplo atualiza os campos de nome e sistema operacional de um registro de computador, mas não atualiza o campo sys_created_by:

    var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");   
    var obj = {"name": "xyz", "os": "windows 2000", "sys_created_by", "aleck.lin"};
    var ignore = {"sys_created_by": true};
    new GlideRecordUtil().mergeToGR(obj, now_GR, ignore);
    now_GR.update();

## GlideRecordUtil - populateFromGR(Object hashMap, GlideRecord now_GR, Object ignore) {#ariaid-title7}

Preenche o hashmap fornecido da instância GlideRecord fornecida. Cada campo no GlideRecord se torna uma propriedade no hashmap.
{#r_GRU-populateFromGR_O_GR_O__table_czg_4lw_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| hashMap | Objeto | Um objeto sendo usado como um hashmap. |
| now_GR | GlideRecord | Uma instância de GlideRecord posicionada em um registro válido. |
| ignorar | Objeto | Um hashmap opcional de nomes de arquivo a não ser preenchido. |
[Tabela 11. Parâmetros]

{#r_GRU-populateFromGR_O_GR_O__table_czg_4lw_4t} {#r_GRU-populateFromGR_O_GR_O__table_dzg_4lw_4t__entry__2}

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

{#r_GRU-populateFromGR_O_GR_O__table_dzg_4lw_4t}  

    var objectToPopulate = {};
    var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");
    var ignore = {"sys_created_on": true, "sys_updated_by": true};
    new GlideRecordUtil().populateFromGR(objectToPopulate, now_GR, ignore);
    // Now the objectToPopulate contains field/value pairs from the computer GlideRecord