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


---

# GlideElement - com escopo

# GlideElement - com escopo {#ariaid-title1}

A API GlideElement com escopo fornece vários métodos de script convenientes para lidar com campos e seus valores. Os métodos GlideElement com escopo estão disponíveis para os campos do registro do Glide atual.

## GlideElement com escopo - canCreate() {#ariaid-title2}

Determina se a função do usuário permite a criação de novas entradas no campo associado.
{#SGE-canCreate__table_hq2_gmp_fz__entry__3}

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

{#SGE-canCreate__table_hq2_gmp_fz} {#SGE-canCreate__table_iq2_gmp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o usuário atual tem permissões para criar novas entradas no campo associado. Valores possíveis: * verdadeiro: o usuário pode criar novas entradas. * falso: o usuário não pode criar novas entradas. {#SGE-canCreate__ul_w1j_ggm_vrb} |
[Tabela 2. Retorna]

{#SGE-canCreate__table_iq2_gmp_fz}  
O exemplo a seguir mostra como determinar se o usuário tem permissões para criar entradas para os três registros mais recentes na tabela Problema \[problema\].

    var gr = new GlideRecord('problem');

    // Get records in new state in Problem Table
    gr.addQuery('state','101');

    // Sort records in order of recent to earlier Created Date
    gr.orderByDesc('sys_created_on');

    // Limit the query to three records
    gr.setLimit(3); 
    gr.query();

    while(gr.next()){
      if(gr.short_description.canCreate()){ ///check to see if the current user is allowed to create the record
      gs.info("I can create new records for the field Problem statement for - " + gr.number);
      }
    }

Saída:

    I can create new records for the field Problem statement for - PRB0000004
    I can create new records for the field Problem statement for - PRB0001000
    I can create new records for the field Problem statement for - PRB0001001

### Equivalente com escopo {#SGE-canCreate__section_k21_xyr_mcb}

Para usar o método canCreate() em uma aplicação com escopo, use o método com escopo correspondente: [canCreate()](https://servicenow-prod.fluidtopics.net/wXAZAy8J_RG27lkh2sf6mw#SGE-canCreate "Determina se a função do usuário permite a criação de novas entradas no campo associado.").

## GlideElement com escopo - canRead() {#ariaid-title3}

Indica se a função do usuário permite que ele leia o GlideRecord associado.
{#SGE-canRead__table_wdj_mnp_fz__entry__3}

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

{#SGE-canRead__table_wdj_mnp_fz} {#SGE-canRead__table_xdj_mnp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o campo puder ser lido, caso contrário, falso. |
[Tabela 4. Retorna]

{#SGE-canRead__table_xdj_mnp_fz}  
O exemplo a seguir mostra como obter uma lista de registros de incidentes ativos com um campo Descrição resumida legível.

    var grIncident = new GlideRecord('incident');
    grIncident.addEncodedQuery("active=true"); //Query the Incident table for active incidents
    grIncident.orderByDesc('number');
    grIncident.setLimit(3); // limit to three results for example
    grIncident.query();

    while (grIncident.next()) {
        if (grIncident.short_description.canRead()) { //check to see if the current user is allowed to read the record
            gs.info('You have permission to read the short description of: ' + grIncident.number + ' ' + grIncident.short_description);
        }
    }

Saída:

    *** Script: You have permission to read the short description of: INC0009009 Unable to access the shared folder.
    *** Script: You have permission to read the short description of: INC0009005 Email server is down.
    *** Script: You have permission to read the short description of: INC0009001 Unable to post content on a Wiki page

## GlideElement com escopo - canWrite() {#ariaid-title4}

Determina se a função do usuário permite que ele grave no GlideRecord associado.
{#SGE-canWrite__table_myz_1pp_fz__entry__3}

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

{#SGE-canWrite__table_myz_1pp_fz} {#SGE-canWrite__table_nyz_1pp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o usuário puder gravar no campo; caso contrário, falso. |
[Tabela 6. Retorna]

{#SGE-canWrite__table_nyz_1pp_fz}  
O exemplo a seguir mostra como obter uma lista de registros de incidentes ativos com um campo Descrição resumida gravável.

    var grIncident = new GlideRecord('incident');
    grIncident.addEncodedQuery("active=true"); //Query the Incident table for active incidents
    grIncident.orderByDesc('number');
    grIncident.setLimit(3); // limit to three results for example
    grIncident.query();

    while (grIncident.next()) {
        if (grIncident.short_description.canWrite()) { //check to see if the current user is allowed to write to the record
            gs.info('You have permission to write to the short description of: ' + grIncident.number + ' ' + grIncident.short_description);
        }
    }

Saída:

    *** Script: You have permission to write to the short description of: INC0009009 Unable to access the shared folder.
    *** Script: You have permission to write to the short description of: INC0009005 Email server is down.
    *** Script: You have permission to write to the short description of: INC0009001 Unable to post content on a Wiki page

## GlideElement com escopo - changes() {#ariaid-title5}

Determina se o campo atual foi modificado. Esta funcionalidade está disponível para todos os tipos de dados disponíveis, exceto campos de diário.
Nota:  
O método changes() não é compatível com scripts de ACL.  
Nota:  
Se o GlideRecord no qual você está executando este método tiver sido apenas inicializado e lido e não tiver sido gravado, os valores anteriores e posteriores subjacentes serão os mesmos. Nesse caso, o método retorna "falso", pois não houve mudança no armazenamento de dados.
{#r_ScopedGlideElementChanges__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideElementChanges__table_vy2_525_jq} {#r_ScopedGlideElementChanges__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se os campos tiverem sido alterados, falso se o campo não tiver sido. |
[Tabela 8. Retorna]

{#r_ScopedGlideElementChanges__table_qpt_3f5_jq}  
O exemplo a seguir de uma regra de negócio mostra como criar um evento no EventQueue se o valor do campo assigned_to for alterado.

    if (!current.assigned_to.nil() && current.assigned_to.changes()) {
      gs.eventQueue('incident.assigned', current, current.assigned_to.getDisplayValue(), previous.assigned_to.getDisplayValue());
    }

## GlideElement com escopo - changesFrom(Object o) {#ariaid-title6}

Determina se o valor anterior do campo atual corresponde ao objeto especificado.
Nota:  
Se o GlideRecord no qual você está executando este método tiver sido apenas inicializado e lido e não tiver sido gravado, os valores anteriores e posteriores subjacentes serão os mesmos. Nesse caso, o método retorna "falso", pois não houve mudança no armazenamento de dados.
{#r_ScopedGlideElementChangesFrom_Object_o__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| o | Objeto | Um valor de objeto a ser verificado em relação ao valor anterior do campo atual. |
[Tabela 9. Parâmetros]

{#r_ScopedGlideElementChangesFrom_Object_o__table_vy2_525_jq} {#r_ScopedGlideElementChangesFrom_Object_o__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o valor anterior corresponder, falso se não corresponder. |
[Tabela 10. Retorna]

{#r_ScopedGlideElementChangesFrom_Object_o__table_qpt_3f5_jq}  

    // The following example shows that in a business rule, if "active" field is changed from true, 
    // insert a event in the EventQueue.
    if (current.active.changesFrom(true)) {
      gs.eventQueue("incident.inactive", current, current.incident_state, previous.incident_state);
    }

## GlideElement com escopo - changesTo(Object o) {#ariaid-title7}

Determina se o novo valor de um campo, após uma mudança, corresponde ao objeto especificado.
Nota:  
O método changesTo() não é compatível com scripts de ACL.  
Nota:  
Se o GlideRecord no qual você está executando este método tiver sido apenas inicializado e lido e não tiver sido gravado, os valores anteriores e posteriores subjacentes serão os mesmos. Nesse caso, o método retorna "falso", pois não houve mudança no armazenamento de dados.
{#r_ScopedGlideElementChangesTo_Object_o__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| o | Objeto | Um valor de objeto a ser verificado em relação ao novo valor do campo atual. |
[Tabela 11. Parâmetros]

{#r_ScopedGlideElementChangesTo_Object_o__table_vy2_525_jq} {#r_ScopedGlideElementChangesTo_Object_o__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o valor anterior corresponder, falso se não corresponder. |
[Tabela 12. Retorna]

{#r_ScopedGlideElementChangesTo_Object_o__table_qpt_3f5_jq}  

    // The following example shows that in a business rule, if "active" field is changed to false, 
    // insert a event in the EventQueue.
    if (current.active.changesTo(false)) {
      gs.eventQueue("incident.inactive", current, current.incident_state, previous.incident_state);
    }

## GlideElement com escopo - dateNumericValue() {#ariaid-title8}

Retorna o número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT para um campo de duração. Não requer a criação de um objeto GlideDateTime porque o campo de duração já é um objeto GlideDateTime.
{#SGE-dateNumericValue__table_wzd_zlp_j2b__entry__3}

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

{#SGE-dateNumericValue__table_wzd_zlp_j2b} {#SGE-dateNumericValue__table_xzd_zlp_j2b__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT. |
[Tabela 14. Retorna]

{#SGE-dateNumericValue__table_xzd_zlp_j2b}  

    var inc = new GlideRecord('incident');
    inc.get('17c90efb13418700cc36b1422244b05d');
    gs.info(inc.calendar_duration.dateNumericValue());

Saída:

    98000

## GlideElement com escopo - getAttribute(String attributeName) {#ariaid-title9}

Retorna o valor do atributo especificado do dicionário.
Se o atributo for booliano, use getBooleanAttribute(String) para obter o valor como booliano em vez de cadeia de caracteres.
{#SGE-getAttribute_String__table_dsj_hqp_fz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| attributeName | Cadeia de caracteres | Nome de atributo |
[Tabela 15. Parâmetros]

{#SGE-getAttribute_String__table_dsj_hqp_fz} {#SGE-getAttribute_String__table_esj_hqp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de atributo |
[Tabela 16. Retorna]

{#SGE-getAttribute_String__table_esj_hqp_fz}  

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

## GlideElement com escopo - getBooleanAttribute(String attributeName) {#ariaid-title10}

Retorna o valor booliano do atributo especificado do dicionário.
Para obter o valor como uma cadeia de caracteres, use getAttribute(string).
{#SGE-getBooleanAttribute_String__table_fv5_prp_fz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| attributeName | Cadeia de caracteres | Nome de atributo |
[Tabela 17. Parâmetros]

{#SGE-getBooleanAttribute_String__table_fv5_prp_fz} {#SGE-getBooleanAttribute_String__table_gv5_prp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Valor booliano do atributo. Retorna falso se o atributo não existir. |
[Tabela 18. Retorna]

{#SGE-getBooleanAttribute_String__table_gv5_prp_fz}  
O exemplo a seguir mostra como obter valores boolianos do atributo ignore_filter_on_new para dois campos.

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

    if (inc.next())
     {
       // opened_by field has attribute "ignore_filter_on_new = true"
       gs.info(inc.opened_by.getBooleanAttribute("ignore_filter_on_new"));

      // short_description field does not have attribute ignore_filter_on_new
       gs.info(inc.short_description.getBooleanAttribute("ignore_filter_on_new"));
     }

Saída:

    true
    false

## GlideElement com escopo - getChoices (cadeia de caracteres dependente) {#ariaid-title11}

Retorna a lista de seleção de um campo especificado.
O campo para o qual a lista de seleção deve ser retornada é especificado na chamada de método. Por exemplo: `var escolhas = glideRecord.urgency.getChoices();`. Para obter informações sobre os tipos de campo de lista de seleção e suas capacidades associadas, consulte [Tipo de campo de](https://www.servicenow.com/docs/access?context=c_ChoiceLists&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)lista de seleção .
{#r_ScopedGlideElementGetChoices_String_dependent__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dependente | Cadeia de caracteres | Opcional. Campo no registro associado do qual o campo da lista de seleção depende. |
[Tabela 19. Parâmetros]

{#r_ScopedGlideElementGetChoices_String_dependent__table_vy2_525_jq} {#r_ScopedGlideElementGetChoices_String_dependent__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Lista de valores possíveis para a lista de seleção, que são os valores na tabela Opção \[sys_choice\]. Se o parâmetro dependent for aprovado, os resultados retornados refletirão somente as opções disponíveis para o campo dependente especificado. |
[Tabela 20. Retorna]

{#r_ScopedGlideElementGetChoices_String_dependent__table_qpt_3f5_jq}  

    var glideRecord = new GlideRecord('incident'); 
    glideRecord.query('priority','1'); 
    glideRecord.next(); 
     
    // urgency has choice list: 1 - High, 2 - Medium, 3 - Low, with value: 1, 2, 3
    var choices = glideRecord.urgency.getChoices();

## GlideElement com escopo - getChoiceValue() {#ariaid-title12}

Retorna o rótulo de opção para a opção atual.
Uma opção tem um valor (número) e um rótulo (cadeia de caracteres). Este método retorna o rótulo.
{#r_ScopedGlideElementGetChoiceValue__table_kgb_3z3_ps__entry__3}

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

{#r_ScopedGlideElementGetChoiceValue__table_kgb_3z3_ps} {#r_ScopedGlideElementGetChoiceValue__table_lgb_3z3_ps__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O rótulo da opção selecionada. |
[Tabela 22. Retorna]

{#r_ScopedGlideElementGetChoiceValue__table_lgb_3z3_ps}  

    var glideRecord = new GlideRecord('incident'); 
    glideRecord.query('priority','1'); 
    glideRecord.next(); 
     
    // urgency has choice list: 1 - High, 2 - Medium, 3 - Low, with value: 1, 2, 3
    var choiceLabel = glideRecord.urgency.getChoiceValue(); 
    gs.info(choiceLabel);

Saída:

    1 - High

## GlideElement com escopo - getDecryptedValue() {#ariaid-title13}

Retorna o valor de texto não criptografado dos campos de senha (criptografia bidirecional) em aplicações com escopo.
{#SGE-getDecryptedValue__table_xd2_gsp_jz__entry__3}

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

{#SGE-getDecryptedValue__table_xd2_gsp_jz} {#SGE-getDecryptedValue__table_yd2_gsp_jz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A senha em texto não criptografado. |
[Tabela 24. Retorna]

{#SGE-getDecryptedValue__table_yd2_gsp_jz}  

    var tablename = 'x_scoped_app_table'
    var CI = new GlideRecord(tablename);  
    CI.addQuery('number', '0001002'); 
    CI.query(); 
    CI.next(); 

    var password = CI.password_field
    var decrypted = password.getDecryptedValue(); 
    gs.info(decrypted);

Saída:

    x_scoped_app: cleartextpassword

## GlideElement com escopo - getDisplayValue(Number maxCharacters) {#ariaid-title14}

Retorna o valor de exibição formatado de um campo especificado de um objeto GlideRecord associado.
Os valores de exibição 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 opção: o valor do banco de dados pode ser um número, mas o valor de exibição será 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 é um campo de exibição do registro referenciado.
{#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__ul_ok1_cbv_hsb}

Para obter mais informações sobre valores de exibição, consulte [Valores](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)de exibição .
{#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| máx. de caracteres | Número | Opcional. Máximo de caracteres desejados. Padrão: todos |
[Tabela 25. Parâmetros]

{#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__table_vy2_525_jq} {#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de exibição do campo especificado. |
[Tabela 26. Retorna]

{#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__table_qpt_3f5_jq}  
O exemplo a seguir mostra como recuperar o valor de exibição do campo de prioridade em um registro de incidente.

    var glideRecord = new GlideRecord('incident');
    glideRecord.query('priority','1');
    glideRecord.next();
    gs.info(glideRecord.priority.getDisplayValue());

Saída:

    1 - Critical

O exemplo a seguir mostra como recuperar o valor de exibição e o valor interno dos campos especificados no banco de dados de incidentes.

    var now_GR = new GlideRecord('incident');
    now_GR.get('9c573169c611228700193229fff72400'); //INC0000001
    gs.info('Display Values:');
    gs.info('Opened at ' + now_GR.opened_at.getDisplayValue());
    gs.info('Opened by ' + now_GR.opened_by.getDisplayValue());
    gs.info('Priority ' + now_GR.priority.getDisplayValue());
    gs.info('Values:');
    gs.info('Opened at ' + now_GR.opened_at.getValue());
    gs.info('Opened by ' + now_GR.opened_by.getValue());
    gs.info('Priority ' + now_GR.priority.getValue());

Saída:

    Display Values:
    Opened at 2022-02-01 15:09:51
    Opened by Joe Employee
    Priority 1 - Critical
    Values:
    Opened at 2022-02-01 23:09:51
    Opened by 681ccaf9c0a8016400b98a06818d57c7
    Priority 1

## GlideElement com escopo - getDisplayValueLang(String idioma) {#ariaid-title15}

Obtém o valor de exibição do campo no idioma passado como um parâmetro.
O resultado só se aplica a tipos de campo traduzíveis, como Opção, Campotraduzido e Texto traduzido. Para outros tipos de campo, o resultado padrão é [getDisplayValue()](https://servicenow-prod.fluidtopics.net/wXAZAy8J_RG27lkh2sf6mw#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters "Retorna o valor de exibição formatado de um campo especificado de um objeto GlideRecord associado.").

Você deve ter o plug-in de idioma correspondente para recuperar um valor traduzido. Para obter informações, consulte [Activate a language](https://www.servicenow.com/docs/access?context=t_ActivateALanguage&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).{#SGE-getDisplayValueLang_S__p_SGE-getDspOrLabellLang-plugins}

Consulte também [GlideElement com escopo - getLabelLang(String idioma)](https://servicenow-prod.fluidtopics.net/wXAZAy8J_RG27lkh2sf6mw#SGE-getLabelLang_S "Obtém o valor do rótulo do campo no idioma passado como um parâmetro.").
{#SGE-getDisplayValueLang_S__table_GE-language-parm__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| idioma | Cadeia de caracteres | Marcador de idioma em conformidade com IETF BCP-47. |
[Tabela 27. Parâmetros]

{#SGE-getDisplayValueLang_S__table_GE-language-parm} {#SGE-getDisplayValueLang_S__table_qpt_3f5_jq__entry__2}{#SGE-getDisplayValueLang_S__ph_getDisOrLblLang_returns_if}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de exibição do campo no idioma aprovado. Se uma tradução não estiver disponível, o método recuperará um valor traduzido no idioma do usuário atual. Se uma tradução não estiver disponível, o resultado padrão será o inglês. |
[Tabela 28. Retorna]

{#SGE-getDisplayValueLang_S__table_qpt_3f5_jq}  
O exemplo a seguir mostra como obter o texto original e o texto traduzido para o alemão do campo de título Aceitar (Exibição de IU).

    var uiView = new GlideRecord("sys_ui_view");
    uiView.get("fa776f6d97700100f309124eda2975bc");

    gs.info("getDisplayValue: " + uiView.getElement("title").getDisplayValue());
    gs.info("getDisplayValueLang: " + uiView.getElement("title").getDisplayValueLang("de"));

Saída:

    getDisplayValue: Accept
    getDisplayValueLang: Akzeptieren

## GlideElement com escopo - getED() {#ariaid-title16}

Retorna o descritor de elemento do campo.
{#r_ScopedGlideElementGetED__table_k23_ps3_yr__entry__3}

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

{#r_ScopedGlideElementGetED__table_k23_ps3_yr} {#r_ScopedGlideElementGetED__table_l23_ps3_yr__entry__2}

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

{#r_ScopedGlideElementGetED__table_l23_ps3_yr}  

    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
     
    var field = grInc.getElement('priority');
    var ed = field.getED();

## GlideElement com escopo - getGlobalDisplayValue() {#ariaid-title17}

Retorna o número de telefone no formato internacional.
{#r_SGE-getGlobalDisplayValue__table_nfm_lq2_bx__entry__3}

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

{#r_SGE-getGlobalDisplayValue__table_nfm_lq2_bx} {#r_SGE-getGlobalDisplayValue__table_ofm_lq2_bx__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Número de telefone no formato internacional. |
[Tabela 32. Retorna]

{#r_SGE-getGlobalDisplayValue__table_ofm_lq2_bx}  
O exemplo a seguir mostra como obter o número de telefone de um local de balcão de serviços. Este exemplo requer o plug-in Walk-up Experience.

    // Passing walkup location name and closed phone number in parameters
    setWalkupLocPhone('Santa Clara Tech Lounge','phone_number');

    function setWalkupLocPhone(locName, field) {
      var walkupLoc = new GlideRecord('wu_location_queue');
      walkupLoc.addQuery('name',locName);
      walkupLoc.query();
      walkupLoc.next();

      // Returns the phone number of walk-up location queue in international format
      gs.info(walkupLoc[field].getGlobalDisplayValue());
    }

Saída:

    +91 98124 56789

## GlideElement com escopo - getHTMLValue(Number maxChars) {#ariaid-title18}

Retorna o valor HTML de um campo.
{#SGE-getHTMLValue_Number__table_p1h_2tp_fz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| máx. de caracteres | Número | Opcional. Número máximo de caracteres a serem retornados. |
[Tabela 33. Parâmetros]

{#SGE-getHTMLValue_Number__table_p1h_2tp_fz} {#SGE-getHTMLValue_Number__table_q1h_2tp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor HTML para o campo. |
[Tabela 34. Retorna]

{#SGE-getHTMLValue_Number__table_q1h_2tp_fz}  

    var inccause = new GlideRecord("incident");
    inccause.short_description = current.short_description;
    inccause.comments = current.comments.getHTMLValue();
    inccause.insert();

## GlideElement com escopo - getJournalEntry(Number mostRecent) {#ariaid-title19}

Retorna a entrada de registro mais recente ou todas as entradas de registro.
{#SGE-getJournalEntry_N__table_lpt_2wp_fz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| maisRecente | Número | Se 1, retorna a entrada mais recente. Se -1, retorna todas as entradas de registro. |
[Tabela 35. Parâmetros]

{#SGE-getJournalEntry_N__table_lpt_2wp_fz} {#SGE-getJournalEntry_N__table_mpt_2wp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Para a entrada mais recente, retorna uma cadeia de caracteres que contém o rótulo do campo, o carimbo de data/hora e o nome de exibição do usuário da entrada de registro. Para todas as entradas de registro, retorna as mesmas informações para todas as entradas de registro já inseridas como uma única cadeia de caracteres com cada entrada delimitada por "\\n\\n". |
[Tabela 36. Retorna]

{#SGE-getJournalEntry_N__table_mpt_2wp_fz}  

    //gets all journal entries as a string where each entry is delimited by '\n\n'
    var notes = current.work_notes.getJournalEntry(-1); 
    //stores each entry into an array of strings
    var na = notes.split("\n\n");  
                          
    for (var i = 0; i < na.length; i++)                 
      gs.info(na[i]);

## GlideElement com escopo - getLabel() {#ariaid-title20}

Retorna o rótulo do objeto.
{#SGE-getLabel__table_tlw_sxp_fz__entry__3}

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

{#SGE-getLabel__table_tlw_sxp_fz} {#SGE-getLabel__table_ulw_sxp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Rótulo do objeto |
[Tabela 38. Retorna]

{#SGE-getLabel__table_ulw_sxp_fz}  

    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");
        var variables = now_GR.variables.getElements();    
        for (var key in variables) {
          var now_V = variables[key];
          if(now_V.getQuestion().getLabel() != ) {
             template.space(4);
             template.print('     ' +  now_V.getQuestion().getLabel() + " = " + now_V.getDisplayValue() + "\n");  
          }
        }
    }

## GlideElement com escopo - getLabelLang(String idioma) {#ariaid-title21}

Obtém o valor do rótulo do campo no idioma passado como um parâmetro.
Você deve ter o plug-in de idioma correspondente para recuperar um valor traduzido. Para obter informações, consulte [Activate a language](https://www.servicenow.com/docs/access?context=t_ActivateALanguage&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).  
Consulte também:

* [getDisplayValueLang()](https://servicenow-prod.fluidtopics.net/wXAZAy8J_RG27lkh2sf6mw#SGE-getDisplayValueLang_S "Obtém o valor de exibição do campo no idioma passado como um parâmetro.")
* [getLabel()](https://servicenow-prod.fluidtopics.net/wXAZAy8J_RG27lkh2sf6mw#SGE-getLabel "Retorna o rótulo do objeto.")
{#SGE-getLabelLang_S__ul_fw4_b1b_txb}
{#SGE-getLabelLang_S__id_nbn_4c5_sxb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| idioma | Cadeia de caracteres | Marcador de idioma em conformidade com IETF BCP-47. |
[Tabela 39. Parâmetros]

{#SGE-getLabelLang_S__id_nbn_4c5_sxb} {#SGE-getLabelLang_S__table_ulw_sxp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor do rótulo do campo no idioma aprovado. Se uma tradução não estiver disponível, o método recuperará um valor traduzido no idioma do usuário atual. Se uma tradução não estiver disponível, o resultado padrão será o inglês. |
[Tabela 40. Retorna]

{#SGE-getLabelLang_S__table_ulw_sxp_fz}  
O exemplo a seguir mostra como obter o texto do rótulo original e sua tradução em alemão do título Aceitar (Exibição de IU).

    var uiView = new GlideRecord("sys_ui_view");
    uiView.get("fa776f6d97700100f309124eda2975bc");

    gs.info("getLabel: " + uiView.getElement("title").getLabel());
    gs.info("getLabelLang: " + uiView.getElement("title").getLabelLang("de"));

Saída:

    getLabel: Title
    getLabelLang: Titel

## GlideElement com escopo - getName() {#ariaid-title22}

Retorna o nome do campo.
{#SGE-getName__table_vdn_vyp_fz__entry__3}

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

{#SGE-getName__table_vdn_vyp_fz} {#SGE-getName__table_wdn_vyp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Nome do campo. |
[Tabela 42. Retorna]

{#SGE-getName__table_wdn_vyp_fz}  
O exemplo a seguir mostra como obter o nome e outros valores de cada campo em um registro sys_user.

    var userRec = new GlideRecord("sys_user"); // GlideRecord to sys_user table

    userRec.get("5137153cc611227c000bbd1bd8cd2005"); // Sys Id of user: Fred Luddy

    var fields = userRec.getFields();

    for (var i = 0; i < fields.size(); i++) {

        var field = fields.get(i);
        var name = field.getName(); // Name of the field
        var label = field.getLabel(); // Label of the field
        var value = field.getDisplayValue(); // Value of the field

        gs.info((Number(i) + 1) + ".\n" + "Field Label: " + label + "\n" + "Field Name: " + name + "\n" + "Field Value: " + value);

    };

Saída. Os resultados incluem 62 campos e foram truncados com pontos de reticências (...) para economizar espaço.

    *** Script: 1.
    Field Label: Country code
    Field Name: country
    Field Value: 
    *** Script: 2.
    Field Label: Calendar integration
    Field Name: calendar_integration
    Field Value: Outlook
    ...
    *** Script: 47.
    Field Label: First name
    Field Name: first_name
    Field Value: Fred
    ...
    *** Script: 54.
    Field Label: Last name
    Field Name: last_name
    Field Value: Luddy
    ...

## GlideElement com escopo - getReferenceTable() {#ariaid-title23}

Obtém o nome da tabela para um elemento de referência.
{#r_ScopedGlideElementGetReferenceTable__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideElementGetReferenceTable__table_vy2_525_jq} {#r_ScopedGlideElementGetReferenceTable__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Nome da tabela da referência. |
[Tabela 44. Retorna]

{#r_ScopedGlideElementGetReferenceTable__table_qpt_3f5_jq}  

    var grINC = new GlideRecord('incident');
    grINC.query('number','INC0010041'); // record assignment group assigned to "CAB Approval"
    if (grINC.next()) { 
      // Get the table name 
      var tableName = grINC.assignment_group.getReferenceTable();
      gs.info( tableName ); 
    }

## GlideElement com escopo - getRefRecord() {#ariaid-title24}

Retorna um objeto GlideRecord para um determinado elemento de referência.
Aviso:  
Se o elemento de referência não contiver um valor, ele retornará um objeto GlideRecord vazio, não um objeto NULO.
{#r_ScopedGlideElementGetRefRecord__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideElementGetRefRecord__table_vy2_525_jq} {#r_ScopedGlideElementGetRefRecord__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| GlideRecord | Um objeto GlideRecord |
[Tabela 46. Retorna]

{#r_ScopedGlideElementGetRefRecord__table_qpt_3f5_jq}  


    var grINC = new GlideRecord('incident'); 
    grINC.addNotNullQuery('caller_id'); 
    grINC.query(); 
    if (grINC.next()) { 

    // Get a GlideRecord object for the referenced sys_user record 
    var grUSER = grINC.caller_id.getRefRecord(); 
    if (grUSER.isValidRecord()) 
      gs.info(grUSER.getValue('name')); 

    } 

## GlideElement com escopo - getTableName() {#ariaid-title25}

Retorna o nome da tabela na qual o campo reside.
{#SGE-getTableName__table_gfq_szp_fz__entry__3}

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

{#SGE-getTableName__table_gfq_szp_fz} {#SGE-getTableName__table_hfq_szp_fz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Nome da tabela. O valor retornado pode ser diferente da classe da tabela em que o registro está. Consulte Tabelas e classes na documentação do produto. |
[Tabela 48. Retorna]

{#SGE-getTableName__table_hfq_szp_fz}  

    if (current.approver.getTableName() == "sysapproval_approver") {
      if (current.approver == email.from_sys_id)  {
         current.comments = "reply from: " + email.from + "\n\n" + email.body_text;
     
       // if it's been cancelled, it's cancelled.
      var doit = true;
      if (current.state=='cancelled')
          doit = false;
     
      if (email.body.state != undefined)
         current.state= email.body.state;
     
       if (doit)
          current.update();
    } else {
       gs.log("Approval for task ("+current.sysapproval.getDisplayValue()+") rejected because user sending 
               email( "+email.from+") does not match the approver ("+current.approver.getDisplayValue()+")");
    }
     
    }

## GlideElement com escopo - nil() {#ariaid-title26}

Determina se um campo é nulo.
{#r_ScopedGlideElementNil__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideElementNil__table_vy2_525_jq} {#r_ScopedGlideElementNil__table_bdf_zfr_2r__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o campo é nulo. Valores possíveis: * verdadeiro: o campo é nulo. * falso: o campo não é nulo. {#r_ScopedGlideElementNil__ul_lhk_bzp_krb} |
[Tabela 50. Retorna]

{#r_ScopedGlideElementNil__table_bdf_zfr_2r}  

    var glideRecord = new GlideRecord('incident'); 
    glideRecord.query('priority','1'); 
    glideRecord.next(); 
    gs.info(glideRecord.state.nil());

Saída:

    false

## GlideElement com escopo - setDateNumericValue(Number milissegundos) {#ariaid-title27}

Define o valor de um elemento de data/hora com o número especificado de milissegundos desde 1º de janeiro de 1970 00:00:00 GMT.
Quando chamado, setDateNumericValue() cria automaticamente o objeto GlideDateTime/GlideDate/GlideDuration necessário e define o elemento com o valor especificado.  
Nota:  
Antes de chamar este método, o elemento já deve existir consultando um registro existente ou usando o método now_GR.initialize() para inicializar um novo registro.
{#SGE-setDateNumericValue_N__table_hqp_hfd_1z__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| milissegundos | Número | Número de milissegundos desde 1/1/1970 |
[Tabela 51. Parâmetros]

{#SGE-setDateNumericValue_N__table_hqp_hfd_1z} {#SGE-setDateNumericValue_N__table_iqp_hfd_1z__entry__2}

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

{#SGE-setDateNumericValue_N__table_iqp_hfd_1z}  

    var now_GR = new GlideRecord("incident");
    now_GR.initialize();
    now_GR.opened_at.setDateNumericValue(10000);

## GlideElement com escopo - setDisplayValue(Object value) {#ariaid-title28}

Define o valor de exibição do campo.
{#r_ScopedGlideElementSetDisplayValue_Object_value__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| valor | Objeto | O valor a ser definido para o campo. |
[Tabela 53. Parâmetros]

{#r_ScopedGlideElementSetDisplayValue_Object_value__table_vy2_525_jq} {#r_ScopedGlideElementSetDisplayValue_Object_value__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideElementSetDisplayValue_Object_value__table_qpt_3f5_jq}  

    var glideRecord = new GlideRecord('incident'); 
    glideRecord.query('priority','1'); 
    glideRecord.next();
     
    //change the urgency to 3 
    glideRecord.urgency.setDisplayValue('3 - Low');
    gs.info(glideRecord.urgency);

## GlideElement com escopo - setError(String errorMessage) {#ariaid-title29}

Adiciona uma mensagem de erro. Disponível no patch 3 da Fuji.
{#r_ScopedGlideElementSetError_String__table_ix3_q5t_vr__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| errorMessage | Cadeia de caracteres | A mensagem de erro. |
[Tabela 55. Parâmetros]

{#r_ScopedGlideElementSetError_String__table_ix3_q5t_vr} {#r_ScopedGlideElementSetError_String__table_jx3_q5t_vr__entry__2}

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

{#r_ScopedGlideElementSetError_String__table_jx3_q5t_vr}  

    var glideRecord = new GlideRecord('incident');
    glideRecord.query('priority','1');
    glideRecord.next();
     
    glideRecord.short_description.setError('Error text');

## GlideElement com escopo - setPhoneNumber (objeto phoneNumber, booliano estrito) {#ariaid-title30}

Define o campo para o número de telefone especificado.
Este método só está disponível em um número de telefone GlideElement.
{#r_SGE-setPhoneNumber_O_B__table_exy_3m2_bx__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| phoneNumber | Objeto | O número de telefone a ser definido. Pode estar no formato internacional ou local. |
| estrito | Booliano | Quando verdadeiro, especifica que o número especificado deve corresponder ao formato correto. Quando falso, o sistema tenta corrigir um número de telefone formatado incorretamente. |
[Tabela 57. Parâmetros]

{#r_SGE-setPhoneNumber_O_B__table_exy_3m2_bx} {#r_SGE-setPhoneNumber_O_B__table_fxy_3m2_bx__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o valor do número de telefone foi definido. Valores possíveis: * verdadeiro: o valor foi definido. * falso: o valor não foi definido. {#r_SGE-setPhoneNumber_O_B__ul_zts_mzp_krb} |
[Tabela 58. Retorna]

{#r_SGE-setPhoneNumber_O_B__table_fxy_3m2_bx}  
O exemplo a seguir mostra como definir o número de telefone de um local de balcão de serviços. Este exemplo requer o plug-in Walk-up Experience.

    setWalkupLocPhone('Santa Clara Tech Lounge','+91 9812456789'); 

    function setWalkupLocPhone(locName, phoneNumber) {
      var walkupLoc = new GlideRecord('wu_location_queue');
      walkupLoc.addQuery('name', locName);
      walkupLoc.query();
      walkupLoc.next();
      
      // Set phone number of walk-up location
      var isPhoneNumberSet = walkupLoc.phone_number.setPhoneNumber(phoneNumber, true);
      walkupLoc.update();
      gs.info('Phone Number: ' + walkupLoc.phone_number);
      gs.info('Is phone number specified match the correct format: ' + isPhoneNumberSet);
    }

Saída:

    Phone Number: +919812456789
    Is phone number specified match the correct format: true

## GlideElement com escopo - setValue(Object value) {#ariaid-title31}

Define o valor de um campo.
Nota:  
Antes de chamar este método, o elemento já deve existir consultando um registro existente ou usando o método now_GR.initialize() para inicializar um novo registro.
{#r_ScopedGlideElementSetValue_Object_value__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| valor | Objeto | Valor do objeto para o qual o campo será definido. |
[Tabela 59. Parâmetros]

{#r_ScopedGlideElementSetValue_Object_value__table_vy2_525_jq} {#r_ScopedGlideElementSetValue_Object_value__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideElementSetValue_Object_value__table_qpt_3f5_jq}  
Defina o valor passando uma cadeia de caracteres.

    var glideRecord = new GlideRecord('incident');
    glideRecord.query('priority','1');
    glideRecord.next();
    glideRecord.short_description.setValue('Network failure');

Defina o valor que passa um objeto.

    var now_GR  = new GlideRecord('student');
    now_GR.initialize();
    now_GR.setValue('first_name', 'Joe');
    now_GR.setValue('last_name', 'Smith');
    now_GR.insert();

## GlideElement com escopo - toString() {#ariaid-title32}

Converte o valor de um campo GlideRecord em uma cadeia de caracteres.
{#r_ScopedGlideElementToString__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideElementToString__table_vy2_525_jq} {#r_ScopedGlideElementToString__table_qpt_3f5_jq__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor como uma cadeia de caracteres. |
[Tabela 62. Retorna]

{#r_ScopedGlideElementToString__table_qpt_3f5_jq}  

    var glideRecord = new GlideRecord('incident');
    glideRecord.query('priority','1');
    glideRecord.next();
    gs.info(glideRecord.opened_at.toString());

Saída:

    2019-08-31 23:09:51