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


---

# GlideForm - Cliente

# GlideForm - Cliente {#ariaid-title1}

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

A API GlideForm fornece métodos para personalizar formulários.

GlideForm.js é a classe JavaScript que contém os métodos. Use somente métodos GlideForm no cliente. Você pode usar esses métodos para fazer mudanças personalizadas na exibição de formulário de registros. Toda a validação de exemplos foi feita usando client scripts.

Você também pode usar alguns desses métodos em outros scripts de cliente (como Scripts de cliente de catálogo ou Scripts de cliente do assistente), mas primeiro você deve testar isso para determinar se eles funcionarão conforme o esperado.  
Nota:  
Os métodos getControl(), getHelpTextControl(), getElement()e getFormElement() estão obsoletos para dispositivos móveis. Para obter informações sobre como usar o GlideForm para dispositivos móveis, consulte [Scripts e migração do GlideForm (g_form) do cliente móvel](https://www.servicenow.com/docs/access?context=r_MobilePlatformMigrationImpacts&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).

Não há construtor para a classe GlideForm. Acesse métodos GlideForm usando o objeto global `g_form`.

## GlideForm -- addDecoration(cadeia de caracteres fieldName, ícone de cadeia de caracteres, título de cadeia de caracteres) {#ariaid-title2}

Adiciona um ícone ao rótulo de um campo.
É impedido adicionar o mesmo item duas vezes; no entanto, você pode adicionar o mesmo ícone com um título diferente.  
Nota:  
Este método não é compatível com o Catálogo de serviços.
{#r_GlideForm-AddDecoration_S_S_S__table_vyw_1dw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo. |
| ícone | Cadeia de caracteres | O ícone de fonte a ser mostrado ao lado do campo. Ícones compatíveis - icon-user, icon-user-group, icon-lightbulb, icon-home, icon-mobile, icon-comment, icon-mail, icon-locked, icon-database, icon-book, icon-drawer, icon -folder, icon-catalog, icon-tab, icon-cards, icon-tree-right, icon-tree, icon-book-open, icon-paperclip, icon-edit, icon-trash, icon-image, icon-search , icon-power, icon-cog, icon-star, icon-star-vazio, icon-new-ticket, icon-dashboard, icon-cart-full, icon-view, icon-label, icon-filter, icon-calendar , icon-script, icon-add, icon-delete, icon-help, icon-info, icon-check-círculo, icon-alert, icon-sort-crescente, icon-console, icon-list, icon-form e ícone-livefeed. |
| título | Cadeia de caracteres | O título de texto do ícone. |
[Tabela 1. Parâmetros]

{#r_GlideForm-AddDecoration_S_S_S__table_vyw_1dw_ts} {#r_GlideForm-AddDecoration_S_S_S__table_wyw_1dw_ts__entry__2}

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

{#r_GlideForm-AddDecoration_S_S_S__table_wyw_1dw_ts}  

    g_form.addDecoration('caller_id', 'icon-star', 'preferred member');

## GlideForm - addDecoration(cadeia de caracteres fieldName, ícone de cadeia de caracteres, título de cadeia de caracteres, cor de cadeia de caracteres) {#ariaid-title3}

Adiciona um ícone ao rótulo de um campo.
É impedido adicionar o mesmo item duas vezes; no entanto, você pode adicionar o mesmo ícone com um título diferente.  
Nota:  
Este método não é compatível com o Catálogo de serviços.
{#r_GlideForm-AddDecoration_S_S_S_S__table_gzh_fyd_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo. |
| ícone | Cadeia de caracteres | O ícone de fonte a ser mostrado ao lado do campo. Ícones compatíveis - icon-user, icon-user-group, icon-lightbulb, icon-home, icon-mobile, icon-comment, icon-mail, icon-locked, icon-database, icon-book, icon-drawer, icon -folder, icon-catalog, icon-tab, icon-cards, icon-tree-right, icon-tree, icon-book-open, icon-paperclip, icon-edit, icon-trash, icon-image, icon-search , icon-power, icon-cog, icon-star, icon-star-vazio, icon-new-ticket, icon-dashboard, icon-cart-full, icon-view, icon-label, icon-filter, icon-calendar , icon-script, icon-add, icon-delete, icon-help, icon-info, icon-check-círculo, icon-alert, icon-sort-crescente, icon-console, icon-list, icon-form e ícone-livefeed. |
| título | Cadeia de caracteres | O título de texto do ícone. |
| cor | Cadeia de caracteres | Uma cor de CSS. |
[Tabela 3. Parâmetros]

{#r_GlideForm-AddDecoration_S_S_S_S__table_gzh_fyd_5s} {#r_GlideForm-AddDecoration_S_S_S_S__table_hzh_fyd_5s__entry__2}

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

{#r_GlideForm-AddDecoration_S_S_S_S__table_hzh_fyd_5s}  

    g_form.addDecoration('caller_id', 'icon-star', 'Mark as Favorite', 'color-green');

## GlideForm -- addErrorMessage(cadeia de caracteres mensagem) {#ariaid-title4}

Exibe a mensagem de erro especificada na parte superior do formulário.
Essa mensagem aparece por aproximadamente quatro segundos e depois desaparece. Este tempo limite não é configurável no momento.
{#r_GlideFormAddErrorMessage_String__table_fyn_vnd_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| message | Cadeia de caracteres | Mensagem a ser exibida. |
[Tabela 5. Parâmetros]

{#r_GlideFormAddErrorMessage_String__table_fyn_vnd_5s} {#r_GlideFormAddErrorMessage_String__table_gyn_vnd_5s__entry__2}

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

{#r_GlideFormAddErrorMessage_String__table_gyn_vnd_5s}  

    g_form.addErrorMessage('This is an error');

## GlideForm - addFormMessage(cadeia de caracteres mensagem, tipo de cadeia de caracteres, opções de objeto) {#ariaid-title5}

Exibe uma mensagem de formulário flutuante na parte superior da seção de detalhes do formulário. A mensagem não cobre ações de IU.
Consulte também:

* [clearAllFormMessages()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#GF-clearAllFormMessages "Remove todas as mensagens do formulário de qualquer tipo.")
* [clearFormMessages ()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#GF-clearFormMessages_S "Remove todas as mensagens de formulário de um determinado tipo.")
{#GF-addFormMessage_S_S__ul_unz_vkt_4pb}
{#GF-addFormMessage_S_S__table_f2v_zym_4pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| message | Cadeia de caracteres | Mensagem a ser exibida. |
| tipo | Cadeia de caracteres | O tipo de mensagem. Valores válidos: * erro * informações * aviso {#GF-addFormMessage_S_S__ul_gzv_bbn_4pb} |
| opções | Objeto | Opcional. Objeto que contém botões a serem adicionados à mensagem do formulário e todos os metadados necessários para lidar com um clique de botão. { buttons: [Array], meta: {Object} } |
| opções.botões | Matriz | Matriz de botões a serem adicionados à mensagem do formulário. buttons: [ { label: "String", actionName: "String" } ] |
| opções.botões.rótulo | Cadeia de caracteres | Texto a ser exibido no botão. |
| opções.botões.açãoNome | Cadeia de caracteres | Nome usado pelos manipuladores de eventos FORM_MESSAGE_BUTTON_CLICKED para determinar o botão que foi clicado. Por exemplo, se você adicionar um botão com o actionName `assign_to_me`, deverá criar um manipulador de eventos em UIB no evento FORM_MESSAGE_BUTTON_CLICKED que só é executado quando o actionName é `assign_to_me`. |
| opções.meta | Objeto | Mapa de todos os metadados necessários para lidar com o clique do botão formatado como pares de chave-valor. meta: { 'key': 'value' } Por exemplo, para um botão Atribuir a mim, o manipulador de eventos precisa do sys_id do usuário ao qual atribuir o registro. |
[Tabela 7. Parâmetros]

{#GF-addFormMessage_S_S__table_f2v_zym_4pb} {#GF-addFormMessage_S_S__table_g2v_zym_4pb__entry__2}

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

{#GF-addFormMessage_S_S__table_g2v_zym_4pb}  
O exemplo a seguir mostra como adicionar mensagens de formulário de cada tipo.

    g_form.addFormMessage('info message','info');
    g_form.addFormMessage('warning message','warning');
    g_form.addFormMessage('error message','error');
    g_form.addFormMessage('info2 message','info');
    g_form.addFormMessage('warning2 message','warning');
    g_form.addFormMessage('error2 message','error');
    g_form.addFormMessage('Would you like to reassign this to yourself?', 'info', {buttons: [{label: "Assign to me", actionName: "assign_to_me"}], meta: {'userId': '46d44a23a9fe19810012d100cca80666'}});

## GlideForm - addInfoMessage(cadeia de caracteres mensagem) {#ariaid-title6}

Adiciona a mensagem informativa especificada à parte superior do formulário.
Essa mensagem aparece por aproximadamente quatro segundos e depois desaparece. Este tempo limite não é configurável no momento.
{#r_GlideFormAddInfoMessage_String__table_pcg_n4d_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| message | Cadeia de caracteres | Mensagem a ser exibida. |
[Tabela 9. Parâmetros]

{#r_GlideFormAddInfoMessage_String__table_pcg_n4d_5s} {#r_GlideFormAddInfoMessage_String__table_qcg_n4d_5s__entry__2}

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

{#r_GlideFormAddInfoMessage_String__table_qcg_n4d_5s}  

    g_form.addInfoMessage('The top five fields in this form are mandatory');

## GlideForm - addOption(cadeia de caracteres "fieldName", cadeia de caracteres "choleValue", cadeia de caracteres "choiceLabel") {#ariaid-title7}

Adiciona uma opção ao final de um campo de lista de seleção.
{#r_GF-AddOption_S_S_S__table_omk_pgd_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo. |
| escolhaValor | Cadeia de caracteres | O valor a ser armazenado no banco de dados. |
| escolhaRótulo | Cadeia de caracteres | O valor exibido. |
[Tabela 11. Parâmetros]

{#r_GF-AddOption_S_S_S__table_omk_pgd_5s} {#r_GF-AddOption_S_S_S__table_pmk_pgd_5s__entry__2}

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

{#r_GF-AddOption_S_S_S__table_pmk_pgd_5s}  

    g_form.addOption('priority', '6', '6 - Really Low');

## GlideForm - addOption(cadeia de caracteres "fieldName", cadeia de caracteres "choiceValue", cadeia de caracteres "choiceLabel", "Número" "choiceIndex") {#ariaid-title8}

Adiciona uma opção ao campo de lista na posição especificada.
Nota:  
Não há suporte para rótulos de lista duplicados em Portal de serviços. Por exemplo, itens com texto de rótulo correspondente a outro rótulo são ignorados e não adicionados à lista.
{#r_GlideForm-AddOption_S_S_S_N__table_k5s_qhd_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo. |
| escolhaValor | Cadeia de caracteres | O valor armazenado no banco de dados. |
| escolhaRótulo | Cadeia de caracteres | O valor exibido. |
| índicede escolha | Número | Ordem da seleção na lista. O índice está em uma matriz baseada em zero. |
[Tabela 13. Parâmetros]

{#r_GlideForm-AddOption_S_S_S_N__table_k5s_qhd_5s} {#r_GlideForm-AddOption_S_S_S_N__table_l5s_qhd_5s__entry__2}

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

{#r_GlideForm-AddOption_S_S_S_N__table_l5s_qhd_5s}  

    g_form.addOption('priority', '2.5', '2.5 - Moderately High', 3);

## GlideForm -- clearMessages() {#ariaid-title9}

Remove todas as mensagens informativas e de erro da parte superior do formulário.
Remove mensagens informativas e de erro adicionadas com g_form.addInfoMessage() e g_form.addErrorMessage().
{#r_GlideFormClearMessages__table_krr_y4d_5s__entry__3}

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

{#r_GlideFormClearMessages__table_krr_y4d_5s} {#r_GlideFormClearMessages__table_lrr_y4d_5s__entry__2}

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

{#r_GlideFormClearMessages__table_lrr_y4d_5s}  

    g_form.clearMessages();

## GlideForm -- clearAllFormMessages() {#ariaid-title10}

Remove todas as mensagens do formulário de qualquer tipo.
Consulte também:

* [addFormMessage()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#GF-addFormMessage_S_S "Exibe uma mensagem de formulário flutuante na parte superior da seção de detalhes do formulário. A mensagem não cobre ações de IU.")
* [clearFormMessages ()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#GF-clearFormMessages_S "Remove todas as mensagens de formulário de um determinado tipo.")
{#GF-clearAllFormMessages__ul_unz_vkt_4pb}
{#GF-clearAllFormMessages__table_qpm_dzm_4pb__entry__3}

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

{#GF-clearAllFormMessages__table_qpm_dzm_4pb} {#GF-clearAllFormMessages__table_rpm_dzm_4pb__entry__2}

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

{#GF-clearAllFormMessages__table_rpm_dzm_4pb}  
O exemplo a seguir mostra como limpar todas as mensagens do formulário.

    g_form.clearAllFormMessages();

## GlideForm -- clearFormMessages(tipo de cadeia de caracteres) {#ariaid-title11}

Remove todas as mensagens de formulário de um determinado tipo.
Consulte também:

* [addFormMessage()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#GF-addFormMessage_S_S "Exibe uma mensagem de formulário flutuante na parte superior da seção de detalhes do formulário. A mensagem não cobre ações de IU.")
* [clearAllFormMessages()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#GF-clearAllFormMessages "Remove todas as mensagens do formulário de qualquer tipo.")
{#GF-clearFormMessages_S__ul_unz_vkt_4pb}
{#GF-clearFormMessages_S__table_ilw_bzm_4pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tipo | Cadeia de caracteres | O tipo de mensagem. Valores válidos: * erro * informações * aviso {#GF-clearFormMessages_S__ul_gzv_bbn_4pb} |
[Tabela 19. Parâmetros]

{#GF-clearFormMessages_S__table_ilw_bzm_4pb} {#GF-clearFormMessages_S__table_jlw_bzm_4pb__entry__2}

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

{#GF-clearFormMessages_S__table_jlw_bzm_4pb}  
O exemplo a seguir mostra como limpar todas as mensagens de erro do formulário.

    g_form.clearFormMessages('error');

## GlideForm - clearOptions(cadeia de caracteres fieldName) {#ariaid-title12}

Remove todas as opções da lista de seleção.
{#r_GlideFormClearOptions_String__table_bdt_v3d_5s__entry__3}

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

{#r_GlideFormClearOptions_String__table_bdt_v3d_5s} {#r_GlideFormClearOptions_String__table_cdt_v3d_5s__entry__2}

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

{#r_GlideFormClearOptions_String__table_cdt_v3d_5s}

## GlideForm - clearValue(String fieldName) {#ariaid-title13}

Remove todos os valores do campo.
{#r_GlideFormClearValue_String__table_tlr_znc_5s__entry__3}

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

{#r_GlideFormClearValue_String__table_tlr_znc_5s} {#r_GlideFormClearValue_String__table_ulr_znc_5s__entry__2}

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

{#r_GlideFormClearValue_String__table_ulr_znc_5s}

## GlideForm -- disableAttachments() {#ariaid-title14}

Impede que anexos de arquivo sejam adicionados.
Este método não está disponível na plataforma móvel. Se este método for executado em uma plataforma móvel, nenhuma ação ocorrerá.
{#r_GlideFormDisableAttachments__table_ggk_bqd_5s__entry__3}

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

{#r_GlideFormDisableAttachments__table_ggk_bqd_5s} {#r_GlideFormDisableAttachments__table_hgk_bqd_5s__entry__2}

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

{#r_GlideFormDisableAttachments__table_hgk_bqd_5s}

## GlideForm -- enableAttachments() {#ariaid-title15}

Permite que anexos de arquivo sejam adicionados. Mostra o ícone de clipe de papel.
Este método não está disponível na plataforma móvel. Se este método for executado em uma plataforma móvel, nenhuma ação ocorrerá.
{#r_GlideFormEnableAttachments__table_i3c_ppd_5s__entry__3}

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

{#r_GlideFormEnableAttachments__table_i3c_ppd_5s} {#r_GlideFormEnableAttachments__table_j3c_ppd_5s__entry__2}

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

{#r_GlideFormEnableAttachments__table_j3c_ppd_5s}

## GlideForm - flash (cadeia de caracteres fieldName, cor da cadeia de caracteres, contagem de números) {#ariaid-title16}

Usado para chamar a atenção para um campo específico. Pisca na cor especificada por uma duração especificada no campo especificado.
Este método não é compatível com o Catálogo de serviços.

Este método não está disponível na plataforma móvel. Se este método for executado em uma plataforma móvel, nenhuma ação ocorrerá.
{#r_GlideFormFlash_String_String_Number__table_htn_w2w_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Especifica o campo a ser realçado no seguinte formato: `"`\<table-name\> .\<field-name\> " . |
| cor | Cadeia de caracteres | Cor RGB ou cor CSS aceitável. |
| contagem | Número | Especifica por quanto tempo o rótulo ficará intermitente. As opções incluem: * 2: Pisca por 1 segundo * 0: Pisca por 2 segundos * -2: Pisca por 3 segundos * -4: Pisca por 4 segundos {#r_GlideFormFlash_String_String_Number__ul_qcc_4fw_ts} |
[Tabela 29. Parâmetros]

{#r_GlideFormFlash_String_String_Number__table_htn_w2w_ts} {#r_GlideFormFlash_String_String_Number__table_itn_w2w_ts__entry__2}

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

{#r_GlideFormFlash_String_String_Number__table_itn_w2w_ts}  

    g_form.flash("incident.number", "#FFFACD", 0);

## GlideForm -- getActionName() {#ariaid-title17}

Retorna o nome da ação mais recente ou, para um client script, o sys_id da ação de IU clicada.
Nota:  
Não disponível em scripts de cliente do Assistente.
{#r_GlideFormGetActionName__table_zhn_xjd_5s__entry__3}

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

{#r_GlideFormGetActionName__table_zhn_xjd_5s} {#r_GlideFormGetActionName__table_a3n_xjd_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O nome da ação atual. |
[Tabela 32. Retorna]

{#r_GlideFormGetActionName__table_a3n_xjd_5s}  

    function onSubmit() {
       var action = g_form.getActionName();
       alert('You pressed ' + action);
    }

## GlideForm -- getBooleanValue(cadeia de caracteres fieldName) {#ariaid-title18}

Retorna um valor booliano para o campo especificado.
{#r_GlideFormGetBooleanValue_String__table_vfk_25b_5s__entry__3}

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

{#r_GlideFormGetBooleanValue_String__table_vfk_25b_5s} {#r_GlideFormGetBooleanValue_String__table_wfk_25b_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna falso se o valor do campo for falso ou indefinido; caso contrário, retornará verdadeiro. |
[Tabela 34. Retorna]

{#r_GlideFormGetBooleanValue_String__table_wfk_25b_5s}

## GlideForm -- getControl(String fieldName) {#ariaid-title19}

Retorna o elemento HTML do campo especificado.
Os campos compostos podem conter vários elementos HTML. Este método geralmente não é necessário, pois há métodos internos que usam os campos em um formulário.

Se o campo for um campo de referência e o controle for uma lista de seleção, getControl() poderá não retornar um controle conforme o esperado. Nesse caso, use `sys_select.<table name>.`\<field name\> .

Este método não está disponível em scripts móveis ou scripts do Portal de serviços.
{#r_GlideFormGetControl_String__table_lzt_x5b_5s__entry__3}

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

{#r_GlideFormGetControl_String__table_lzt_x5b_5s} {#r_GlideFormGetControl_String__table_mzt_x5b_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Elemento HTML | O elemento HTML do campo. |
[Tabela 36. Retorna]

{#r_GlideFormGetControl_String__table_mzt_x5b_5s}

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

Retorna o valor decimal do campo especificado.
{#r_GlideFormGetDecimalValue_String__table_izt_31c_5s__entry__3}

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

{#r_GlideFormGetDecimalValue_String__table_izt_31c_5s} {#r_GlideFormGetDecimalValue_String__table_jzt_31c_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O valor decimal do campo especificado. |
[Tabela 38. Retorna]

{#r_GlideFormGetDecimalValue_String__table_jzt_31c_5s}  

    function onChange(control, oldValue, newValue, isLoading) {
       alert(g_form.getDecimalValue('percent_complete'));
    }

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

Obtém o valor de exibição de um formulário na IU principal.
Nota:  
Para obter um valor de exibição de um formulário em Portal de serviços, use o método [getDisplayValue()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#GF-getDisplayValue_S "Obtém o valor de exibição de um formulário em Portal de serviços.").  
Consulte também:

* [getValue()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#r_GlideFormGetValue_String "Retorna o valor do campo de formulário especificado.")
* [Obter o valor de exibição de uma variável de referência](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763)
{#GF-getDisplayBox_S__ul_djx_h4g_cvb}
{#GF-getDisplayBox_S__table_nf2_bfp_zw__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo do qual você deseja recuperar um valor no formulário. |
[Tabela 39. Parâmetros]

{#GF-getDisplayBox_S__table_nf2_bfp_zw} {#GF-getDisplayBox_S__table_ydf_qpc_5s__entry__2}

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

{#GF-getDisplayBox_S__table_ydf_qpc_5s}  

    var caller = g_form.getDisplayBox('caller_id').value;

    var assignee = g_form.getDisplayBox('assigned_to').value;

    if (caller == assignee)
    {
       alert('in');
    }

## GlideForm -- getDisplayValue(cadeia de caracteres fieldName) {#ariaid-title22}

Obtém o valor de exibição de um formulário em Portal de serviços.
Nota:  
Para obter um valor de exibição de um formulário na IU principal, use o método [getDisplayBox()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#GF-getDisplayBox_S "Obtém o valor de exibição de um formulário na IU principal.").  
Consulte também:

* [getValue()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#r_GlideFormGetValue_String "Retorna o valor do campo de formulário especificado.")
* [Obter o valor de exibição de uma variável de referência](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763)
{#GF-getDisplayValue_S__ul_djx_h4g_cvb}  
Nota:  
Na IU principal, chamar este método como `g_form.getDisplayValue()` sem um argumento retorna o valor de exibição do registro em vez do valor de exibição de um campo individual.
{#GF-getDisplayValue_S__table_nf2_bfp_zw__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo do qual você deseja recuperar um valor no formulário. |
[Tabela 41. Parâmetros]

{#GF-getDisplayValue_S__table_nf2_bfp_zw} {#GF-getDisplayValue_S__table_ydf_qpc_5s__entry__2}

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

{#GF-getDisplayValue_S__table_ydf_qpc_5s}  
O exemplo a seguir mostra como obter o valor de exibição de uma variável de referência na IU principal ou Portal de serviços. O caso de uso deste exemplo está no site da [comunidade](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763).

    function onChange(control, oldValue, newValue, isLoading) {
         if (isLoading || newValue == '') {
              return;
         }
         if(window == null){
              var valuePortal = g_form.getDisplayValue('requester');
              alert('Portal->' + valuePortal);
         }
         else{
              var valueNative = g_form.getDisplayBox('requester').value;     
              alert('CoreUI->' + valueCoreUI);
         }
         //Type appropriate comment here, and begin script below
    }

## GlideForm -- getElement(ID da cadeia de caracteres) {#ariaid-title23}

Retorna o elemento HTML especificado pelo parâmetro.
Os campos compostos podem conter vários elementos HTML. Este método geralmente não é necessário, pois há métodos internos que usam os campos em um formulário.

Este método não está disponível em scripts móveis ou scripts do Portal de serviços.
{#r_GlideFormGetElement_String__table_l1k_vvb_5s__entry__3}

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

{#r_GlideFormGetElement_String__table_l1k_vvb_5s} {#r_GlideFormGetElement_String__table_m1k_vvb_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Elemento HTML | O elemento HTML do campo. |
[Tabela 44. Retorna]

{#r_GlideFormGetElement_String__table_m1k_vvb_5s}

## GlideForm -- getFormElement() {#ariaid-title24}

Retorna o elemento HTML do formulário.
Este método não está disponível em scripts móveis ou scripts do Portal de serviços.
{#r_GlideFormGetFormElement__table_fs4_kkd_5s__entry__3}

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

{#r_GlideFormGetFormElement__table_fs4_kkd_5s} {#r_GlideFormGetFormElement__table_gs4_kkd_5s__entry__2}

| Tipo | Descrição |
|-|-|
| HTMLFormElement | O elemento HTML do formulário. |
[Tabela 46. Retorna]

{#r_GlideFormGetFormElement__table_gs4_kkd_5s}

## GlideForm -- getHelpTextControl(cadeia de caracteres fieldName) {#ariaid-title25}

Retorna o elemento HTML do texto de ajuda do campo especificado.
Este método é aplicável somente a variáveis do catálogo de serviços.
{#r_GF-getHelpTextControl_S__table_nf2_bfp_zw__entry__3}

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

{#r_GF-getHelpTextControl_S__table_nf2_bfp_zw} {#r_GF-getHelpTextControl_S__table_of2_bfp_zw__entry__2}

| Tipo | Descrição |
|-|-|
| Elemento HTML | Elemento HTML do campo de texto de ajuda. |
[Tabela 48. Retorna]

{#r_GF-getHelpTextControl_S__table_of2_bfp_zw}

## GlideForm -- getIntValue(cadeia de caracteres fieldName) {#ariaid-title26}

Retorna o valor inteiro do campo.
{#r_GlideFormGetIntValue_String__table_unc_nwb_5s__entry__3}

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

{#r_GlideFormGetIntValue_String__table_unc_nwb_5s} {#r_GlideFormGetIntValue_String__table_vnc_nwb_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Valor inteiro do campo. |
[Tabela 50. Retorna]

{#r_GlideFormGetIntValue_String__table_vnc_nwb_5s}

## GlideForm -- getLabelOf(cadeia de caracteres fieldName) {#ariaid-title27}

Retorna o valor de texto simples do rótulo do campo.
{#r_GlideFormGetLabelOf_String__table_gfz_kgw_ts__entry__3}

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

{#r_GlideFormGetLabelOf_String__table_gfz_kgw_ts} {#r_GlideFormGetLabelOf_String__table_hfz_kgw_ts__entry__2}

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

{#r_GlideFormGetLabelOf_String__table_hfz_kgw_ts}  

    if (g_user.hasRole('itil')) {
        var oldLabel = g_form.getLabelOf('comments');
        g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
    }

## GlideForm -- getOption(cadeia de caracteres "fieldName", cadeia de caracteres "choiceValue") {#ariaid-title28}

Retorna o elemento de opção de uma caixa selecionada chamada fieldName em que choiceValue corresponde ao valor da opção.
Nota:  
Este método não funciona em campos somente leitura.
{#r_GlideFormGetOption_String_String__table_u1p_1xb_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| escolhaValor | Cadeia de caracteres | Valor da opção. |
[Tabela 53. Parâmetros]

{#r_GlideFormGetOption_String_String__table_u1p_1xb_5s} {#r_GlideFormGetOption_String_String__table_v1p_1xb_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Elemento HTML | O HTMLElement da opção. Retorna nulo se o campo ou a opção não for encontrado. |
[Tabela 54. Retorna]

{#r_GlideFormGetOption_String_String__table_v1p_1xb_5s}  
O exemplo a seguir mostra como obter o rótulo para um valor de lista de seleção.

    // Get the label for a choice list value
    // fieldName is 'category'
     
    function onChange(control, oldValue, newValue, isLoading) {
    var choiceValue = g_form.getValue('category');
    var choiceLabel = g_form.getOption('category', choiceValue).text; 
    }

## GlideForm -- getReference(cadeia de caracteres fieldName, retorno de chamada de função) {#ariaid-title29}

Retorna o GlideRecord para um campo especificado.
Se uma função de retorno de chamada estiver presente, esta rotina será executada de forma assíncrona. O processamento do navegador (e do script) continua normalmente até que o servidor retorne o valor de referência, momento em que a função de retorno de chamada é invocada. Se uma função de retorno de chamada não estiver presente, esta rotina será executada de forma síncrona e o processamento será interrompido (fazendo com que o navegador apareça travado) enquanto aguarda uma resposta do servidor.  
Importante:  
É altamente recomendável que você use uma função de retorno de chamada.

O suporte à função de retorno de chamada para ServiceCatalogForm.getReference está disponível.  
Nota:  
O uso deste método requer uma chamada para o servidor, o que requer tempo adicional e pode introduzir latência na sua página. Use este método com cuidado. Para obter informações adicionais, consulte [Design e processamento de client script](https://www.servicenow.com/docs/access?context=client-script-best-practices&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).
{#r_GlideForm-GetReference_S_F__table_k4c_1yb_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| retorno de chamada | Função | Nome da função de retorno de chamada. |
[Tabela 55. Parâmetros]

{#r_GlideForm-GetReference_S_F__table_k4c_1yb_5s} {#r_GlideForm-GetReference_S_F__table_l4c_1yb_5s__entry__2}

| Tipo | Descrição |
|-|-|
| GlideRecord | Objeto GlideRecord para o campo especificado. Se a referência especificada não puder ser encontrada, ele retornará um objeto GlideRecord inicializado em que currentRow = -1 e rows.length = 0. |
[Tabela 56. Retorna]

{#r_GlideForm-GetReference_S_F__table_l4c_1yb_5s}  

    function onChange(control, oldValue, newValue, isLoading) {
        g_form.getReference('caller_id', doAlert); // doAlert is our callback function
    }
     
    function doAlert(caller) { // reference is passed into callback as first arguments
       if (caller.getValue('vip') == 'true') {
          alert('Caller is a VIP!');
       }
    }

## GlideForm -- getRelatedListNames() {#ariaid-title30}

Retorna uma matriz de nomes de lista relacionada do formulário atual.
{#GF-getRelatedListNames__table_vfp_grv_dhb__entry__3}

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

{#GF-getRelatedListNames__table_vfp_grv_dhb} {#GF-getRelatedListNames__table_wfp_grv_dhb__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Matriz de cadeia de caracteres de nomes de lista relacionada do formulário atual. Os nomes das listas relacionadas são listados na ordem em que aparecem no formulário. |
[Tabela 58. Retorna]

{#GF-getRelatedListNames__table_wfp_grv_dhb}  

    var listNames = g_form.getRelatedListNames();

    for (var i = 0; i < listNames.length; i++) {  
      this.showRelatedList(listNames[i]);
     }

## GlideForm -- getSectionNames() {#ariaid-title31}

Retorna todos os nomes de seção, visíveis ou não.
{#r_GlideFormGetSectionNames__table_rsg_vkd_5s__entry__3}

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

{#r_GlideFormGetSectionNames__table_rsg_vkd_5s} {#r_GlideFormGetSectionNames__table_ssg_vkd_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz de cadeias de caracteres | Os nomes das seções. |
[Tabela 60. Retorna]

{#r_GlideFormGetSectionNames__table_ssg_vkd_5s}

## GlideForm -- getSections() {#ariaid-title32}

Retorna uma matriz de seções do formulário.
Este método não está disponível na plataforma móvel. Se este método for executado em uma plataforma móvel, nenhuma ação ocorrerá.
{#r_GlideFormGetSections__table_sg4_hld_5s__entry__3}

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

{#r_GlideFormGetSections__table_sg4_hld_5s} {#r_GlideFormGetSections__table_tg4_hld_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz de elementos HTML | As seções do formulário. |
[Tabela 62. Retorna]

{#r_GlideFormGetSections__table_tg4_hld_5s}  

    function onChange(control, oldValue, newValue, isLoading) {
       //this example was run on a form divided into sections (Change form)
       // and hid a section when the "state" field was changed
       var sections = g_form.getSections();
       if (newValue == '2') {
          g_form.setSectionDisplay(sections[1], false);
       } else {
          g_form.setSectionDisplay(sections[1], true);
       }
    }

## GlideForm -- getTableName() {#ariaid-title33}

Retorna o nome da tabela à qual este registro pertence.
No lado do servidor, a tabela do registro atual pode ser recuperada com current.sys_class_name ou current.getTableName().
{#r_GlideFormGetTableName__table_gqk_5ld_5s__entry__3}

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

{#r_GlideFormGetTableName__table_gqk_5ld_5s} {#r_GlideFormGetTableName__table_hqk_5ld_5s__entry__2}

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

{#r_GlideFormGetTableName__table_hqk_5ld_5s}  

    function onLoad() {
        if (g_form.isNewRecord()) {
            var tableName = g_form.getTableName(); //Get the table name
        }
    }

## GlideForm -- getUniqueValue() {#ariaid-title34}

Retorna o sys_id do registro exibido no formulário.
{#r_GlideFormGetUniqueValue__table_xxg_lmd_5s__entry__3}

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

{#r_GlideFormGetUniqueValue__table_xxg_lmd_5s} {#r_GlideFormGetUniqueValue__table_yxg_lmd_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O sys_id do registro. |
[Tabela 66. Retorna]

{#r_GlideFormGetUniqueValue__table_yxg_lmd_5s}  

    function onLoad() {
       var incSysid = g_form.getUniqueValue();
       alert(incSysid);
    }

## GlideForm -- getValue(cadeia de caracteres fieldName) {#ariaid-title35}

Retorna o valor do campo de formulário especificado.
Este método também oferece suporte à obtenção de valores de um conjunto de variáveis com várias linhas (MRVS). Para obter dados de campos em um MRVS, você deve primeiro usar `JSON.parse(getValue('` \<mrvs_field_name\> ') \|\| '\[\]') para obter a matriz MRVS e usar a indexação para acessar os campos nos objetos de linha. Para obter mais detalhes, consulte o exemplo de código abaixo.
{#r_GlideFormGetValue_String__table_nxm_wzb_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo cujo valor será retornado. |
[Tabela 67. Parâmetros]

{#r_GlideFormGetValue_String__table_nxm_wzb_5s} {#r_GlideFormGetValue_String__table_oxm_wzb_5s__entry__2}

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

{#r_GlideFormGetValue_String__table_oxm_wzb_5s}  
O exemplo a seguir mostra como obter a descrição resumida do formulário atual.

    function onChange(control, oldValue, newValue, isLoading) {
       alert(g_form.getValue('short_description'));
    }

O exemplo a seguir mostra como obter valores de um MRVS. Neste exemplo, os salários estão sendo gerenciados por meio do Catálogo de serviços. O client script pesquisa todas as linhas no MRVS em busca do valor inserido no cargo e atualiza as entradas correspondentes no MRVS com o que está inserido no campo Salário. O MRVS é chamado de "variable_set_1" e contém os seguintes campos em cada objeto de linha: Nome do funcionário \[employee_name\], Cargo \[employee_job_title\] e Salário \[employee_salary\]. Além disso, o Item do catálogo contém: Cargo \[job_title\] e Salário \[salário\].

    function onChange(control, oldValue, newValue, isLoading) {
    if (isLoading || newValue == '') {
    return;
    }
     
    // Get the MRVS
    var vs1 = g_form.getValue('variable_set_1') || '[]';
    var multiRowVariableSet = JSON.parse(vs1);
     
    for (var i = 0; i < multiRowVariableSet.length; i++) {
    // Check if the entered job title matches the title in the current MRVS row
      if (multiRowVariableSet[i].employee_job_title == g_form.getValue("job_title")){
        // Update the value of a matching field with the new salary
        multiRowVariableSet[i].employee_salary = newValue;
      }
    }
     
    // Update the MRVS
    g_form.setValue('variable_set_1', JSON.stringify(multiRowVariableSet));
    }

## GlideForm -- hideAllFieldMsgs() {#ariaid-title36}

Oculta todas as mensagens de campo.
{#r_GlideFormHideAllFieldMsgs__table_mr1_3hw_ts__entry__3}

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

{#r_GlideFormHideAllFieldMsgs__table_mr1_3hw_ts} {#r_GlideFormHideAllFieldMsgs__table_nr1_3hw_ts__entry__2}

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

{#r_GlideFormHideAllFieldMsgs__table_nr1_3hw_ts}

## GlideForm -- hideAllFieldMsgs(tipo de cadeia de caracteres) {#ariaid-title37}

Oculta todas as mensagens de campo do tipo especificado.
{#r_GlideFormHideAllFieldMsgs_String__table_y2c_qhw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tipo | Cadeia de caracteres | O tipo de mensagem. Valores válidos: * erro * informações {#r_GlideFormHideAllFieldMsgs_String__ul_gzv_bbn_4pb} |
[Tabela 71. Parâmetros]

{#r_GlideFormHideAllFieldMsgs_String__table_y2c_qhw_ts} {#r_GlideFormHideAllFieldMsgs_String__table_z2c_qhw_ts__entry__2}

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

{#r_GlideFormHideAllFieldMsgs_String__table_z2c_qhw_ts}

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

Oculta a mensagem de erro colocada por showErrorBox().
Sempre que possível, use hideFieldMsg() em vez deste método.
{#r_GlideFormHideErrorBox_String__table_kll_t4w_ts__entry__3}

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

{#r_GlideFormHideErrorBox_String__table_kll_t4w_ts} {#r_GlideFormHideErrorBox_String__table_lll_t4w_ts__entry__2}

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

{#r_GlideFormHideErrorBox_String__table_lll_t4w_ts}

## GlideForm -- hideFieldMsg(cadeia de caracteres fieldName, booliano clearAll) {#ariaid-title39}

Oculta a primeira mensagem que aparece no campo especificado no formulário atual.
Use os métodos [GlideForm - showFieldMsg(cadeia de caracteres de campo, mensagem de cadeia de caracteres, tipo de cadeia de caracteres)](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#r_GF-ShowFieldMsg_S_S_S "Exibe uma mensagem informativa ou de erro no campo de formulário especificado (um objeto de controle ou o nome do campo). Se o controle ou o campo estiver fora da tela, o formulário será rolado para o campo.") ou [GlideForm - showFieldMsg(cadeia de caracteres de campo, mensagem de cadeia de caracteres, tipo de cadeia de caracteres, rollForm booliano)](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#r_GF-ShowFieldMsg_S_S_S_B "Exibe uma mensagem informativa ou de erro no campo de formulário especificado (um objeto de controle ou o nome do campo). Se o controle ou o campo estiver fora da tela e o rollForm for verdadeiro, o formulário será rolado para o campo.") para exibir mensagens em um formulário.  
Por exemplo, o snippet de código a seguir mostra como exibir duas mensagens no campo `work_notes` de um formulário e ocultar a primeira mensagem:

    g_form.showFieldMsg('work_notes', 'First message', "error");
    g_form.showFieldMsg('work_notes', 'Second message', "error");
    g_form.hideFieldMsg('work_notes', false); // This call hides the 'First message'

{#r_GlideFormHideFieldMsg_String__table_xnf_3pw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo no qual a mensagem será ocultada. |
| limparTudo | Booliano | Opcional. Sinalizador que indica se todas as mensagens do campo especificado devem ser ocultadas. Valores válidos: * verdadeiro: ocultar todas as mensagens. * falso: oculta somente a primeira mensagem exibida. Padrão: falso |
[Tabela 75. Parâmetros]

{#r_GlideFormHideFieldMsg_String__table_xnf_3pw_ts} {#r_GlideFormHideFieldMsg_String__table_ynf_3pw_ts__entry__2}

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

{#r_GlideFormHideFieldMsg_String__table_ynf_3pw_ts}  
O exemplo a seguir mostra como limpar todas as mensagens de um campo de formulário especificado e exibir uma mensagem de erro de criptografia.

    function submitEncryptedInputs() {
      return processEncryptedInputs(function(inputName, fieldName) {
        if (!checkEncryptedFieldValue(fieldName)) {
          g_form.hideFieldMsg(fieldName, true); // Hide all messages for the specified field
          g_form.showFieldMsg(fieldName, "Your activity requires an encrypted input.", "error");
          return false;
        }
        return true;
      });
    }

## GlideForm -- hideFieldMsg(cadeia de caracteres fieldName, booliano clearAll) {#ariaid-title40}

Oculta as mensagens colocadas por showFieldMsg().
{#r_GlideForm-HideFieldMsg_S_B__table_gvy_vpw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| limparTudo | Booliano | Quando verdadeiro, todas as mensagens do campo são apagadas. Quando falso, somente a última mensagem é removida. |
[Tabela 77. Parâmetros]

{#r_GlideForm-HideFieldMsg_S_B__table_gvy_vpw_ts} {#r_GlideForm-HideFieldMsg_S_B__table_hvy_vpw_ts__entry__2}

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

{#r_GlideForm-HideFieldMsg_S_B__table_hvy_vpw_ts}  

    g_form.hideFieldMsg('impact', true);

## GlideForm -- hideRelatedList(cadeia de caracteres listTableName) {#ariaid-title41}

Oculta a lista relacionada especificada no formulário.
Este método não está disponível na plataforma móvel. Se este método for executado em uma plataforma móvel, nenhuma ação ocorrerá.
{#r_GlideFormHideRelatedList_String__table_syn_wqw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| listTableName | Cadeia de caracteres | Nome da lista relacionada. Use o sys_id para ocultar uma lista por meio de um relacionamento. |
[Tabela 79. Parâmetros]

{#r_GlideFormHideRelatedList_String__table_syn_wqw_ts} {#r_GlideFormHideRelatedList_String__table_tyn_wqw_ts__entry__2}

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

{#r_GlideFormHideRelatedList_String__table_tyn_wqw_ts}

## GlideForm -- hideRelatedLists() {#ariaid-title42}

Oculta todas as listas relacionadas no formulário.
Este método não está disponível na plataforma móvel. Se este método for executado em uma plataforma móvel, nenhuma ação ocorrerá.
{#r_GlideFormHideRelatedLists__table_zmg_jrw_ts__entry__3}

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

{#r_GlideFormHideRelatedLists__table_zmg_jrw_ts} {#r_GlideFormHideRelatedLists__table_ang_jrw_ts__entry__2}

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

{#r_GlideFormHideRelatedLists__table_ang_jrw_ts}

## GlideForm -- isLiveUpdating() {#ariaid-title43}

Retorna verdadeiro enquanto uma atualização em tempo real está sendo feita no registro que o formulário está mostrando.
Isso pode ser usado em um client script onChange() para determinar se uma mudança no registro é devido a uma atualização em tempo real de outra sessão. O script do cliente pode decidir qual ação executar ou não. Isso se aplica a sistemas que usam IU principal com formulários dinâmicos habilitados.
{#r_GF-isLiveUpdating__table_fjz_sks_kx__entry__3}

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

{#r_GF-isLiveUpdating__table_fjz_sks_kx} {#r_GF-isLiveUpdating__table_gjz_sks_kx__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna verdadeiro se uma atualização em tempo real estiver acontecendo no registro exibido pelo formulário. |
[Tabela 84. Retorna]

{#r_GF-isLiveUpdating__table_gjz_sks_kx}

## GlideForm -- isMandatory(String fieldName) {#ariaid-title44}

Retorna verdadeiro se o campo for obrigatório.
{#r_GlideFormIsMandatory_String__table_kpt_nnc_5s__entry__3}

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

{#r_GlideFormIsMandatory_String__table_kpt_nnc_5s} {#r_GlideFormIsMandatory_String__table_lpt_nnc_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o campo for obrigatório, caso contrário, falso. |
[Tabela 86. Retorna]

{#r_GlideFormIsMandatory_String__table_lpt_nnc_5s}

## GlideForm -- isNewRecord() {#ariaid-title45}

Retorna verdadeiro se o registro nunca foi salvo.
{#r_GlideFormIsNewRecord__table_wlm_wmd_5s__entry__3}

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

{#r_GlideFormIsNewRecord__table_wlm_wmd_5s} {#r_GlideFormIsNewRecord__table_xlm_wmd_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna verdadeiro se o registro não tiver sido salvo; caso contrário, falso. |
[Tabela 88. Retorna]

{#r_GlideFormIsNewRecord__table_xlm_wmd_5s}  

    function onLoad() {
       if(g_form.isNewRecord()){
          alert('New Record!');
       }
    }

## GlideForm -- isSectionVisible(cadeia de caracteres "sectionName") {#ariaid-title46}

Retorna verdadeiro se a seção estiver visível.
Importante:  
A função isSectionVisible() não é compatível com o Workspace.
{#r_GlideFormIsSectionVisible_String__table_msy_jnd_5s__entry__3}

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

{#r_GlideFormIsSectionVisible_String__table_msy_jnd_5s} {#r_GlideFormIsSectionVisible_String__table_nsy_jnd_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna verdadeiro quando a seção está visível; caso contrário, falso será retornado. |
[Tabela 90. Retorna]

{#r_GlideFormIsSectionVisible_String__table_nsy_jnd_5s}

## GlideForm -- onUserChangeValue(Função fn) {#ariaid-title47}

Registra um ouvinte de eventos personalizado que detecta quando qualquer campo no formulário atual é modificado por um usuário.
Quando um campo de formulário é modificado, o ouvinte de eventos chama a função que é passada quando o ouvinte é registrado inicialmente. Este ouvinte só é acionado quando um usuário faz uma mudança em um campo no formulário. Mudanças de client scripts, políticas de IU ou quaisquer outras interações que não sejam do usuário não acionam o ouvinte.  
Nota:  
Este método não funciona para campos de diário ou itens Catálogo de serviços no ambiente clássico.
{#GF-onUserChangeValue_F__table_m5y_wll_1hb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fn | Função | Função a ser chamada quando um usuário altera o valor de um campo no formulário atual. Na verdade, este é o código da função, não apenas o nome da função. Esta função deve aceitar os três seguintes argumentos: * nome do campo * valor do campo original * valor de campo atualizado {#GF-onUserChangeValue_F__ul_fnz_j4l_1hb} |
[Tabela 91. Parâmetros]

{#GF-onUserChangeValue_F__table_m5y_wll_1hb} {#GF-onUserChangeValue_F__table_n5y_wll_1hb__entry__2}

| Tipo | Descrição |
|-|-|
| Função | Função a ser chamada para cancelar o registro do ouvinte de eventos onUserChangeValue. |
[Tabela 92. Retorna]

{#GF-onUserChangeValue_F__table_n5y_wll_1hb}  

    var handler = function(fieldname, originalValue, newValue) {
      console.log('The field ('+ fieldname + ') has a new value of: ' + newValue); // function code
    }
     
    var unregister = g_form.onUserChangeValue(handler);
     
    // To unregister the event listener
    unregister();

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

Você pode atualizar uma variável do coletor de lista.
{#r_GF-refreshSlushbucket_S__table_n3v_plp_cv__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do bucket de slush. |
[Tabela 93. Parâmetros]

{#r_GF-refreshSlushbucket_S__table_n3v_plp_cv} {#r_GF-refreshSlushbucket_S__table_o3v_plp_cv__entry__2}

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

{#r_GF-refreshSlushbucket_S__table_o3v_plp_cv}  

    g_form.refreshSlushbucket('bucket');

## GlideForm - removeDecoration(cadeia de caracteres fieldname, ícone de cadeia de caracteres, título de cadeia de caracteres) {#ariaid-title49}

Remove o ícone do campo especificado que corresponde ao ícone e ao título.
Nota:  
Este método não é compatível com o Catálogo de serviços.
{#r_GF-RemoveDecoration_S_S_S__table_x23_vrw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| ícone | Cadeia de caracteres | Nome do ícone a ser removido. |
| título | Cadeia de caracteres | O título de texto do ícone (nome). |
[Tabela 95. Parâmetros]

{#r_GF-RemoveDecoration_S_S_S__table_x23_vrw_ts} {#r_GF-RemoveDecoration_S_S_S__table_y23_vrw_ts__entry__2}

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

{#r_GF-RemoveDecoration_S_S_S__table_y23_vrw_ts}  

    function onChange(control, oldValue, newValue, isLoading) {
    	// if the caller_id field is not present, then we can't add an icon anywhere
    	if (!g_form.hasField('caller_id'))
    		return;
     
    	if (!newValue)
    		return;
     
    	g_form.getReference('caller_id', function(ref) {
    		g_form.removeDecoration('caller_id', 'icon-star', 'VIP');
     
    		if (ref.getValue('vip') == 'true')
    			g_form.addDecoration('caller_id', 'icon-star', 'VIP');			
    	});
    }

## GlideForm - removeDecoration(cadeia de caracteres fieldname, ícone de cadeia de caracteres, título de cadeia de caracteres, cor de cadeia de caracteres) {#ariaid-title50}

Remove o ícone do campo especificado que corresponde ao ícone, título e cor.
Nota:  
Este método não é compatível com o Catálogo de serviços.
{#r_GF-RemoveDecoration_S_S_S_S__table_mcg_5zd_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| ícone | Cadeia de caracteres | Nome do ícone a ser removido. |
| título | Cadeia de caracteres | O título de texto do ícone (nome). |
| cor | Cadeia de caracteres | Uma cor de CSS |
[Tabela 97. Parâmetros]

{#r_GF-RemoveDecoration_S_S_S_S__table_mcg_5zd_5s} {#r_GF-RemoveDecoration_S_S_S_S__table_ncg_5zd_5s__entry__2}

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

{#r_GF-RemoveDecoration_S_S_S_S__table_ncg_5zd_5s}  

    g_form.removeDecoration('caller_id', 'icon-star', 'VIP', 'blue');

## GlideForm - removeOption(cadeia de caracteres "fieldName", cadeia de caracteres "choiceValue") {#ariaid-title51}

Remove a opção especificada da lista de seleção.
{#r_GlideFormRemoveOption_String_String__table_p4k_hjd_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| escolhaValor | Cadeia de caracteres | O valor armazenado no banco de dados. Este não é o rótulo. |
[Tabela 99. Parâmetros]

{#r_GlideFormRemoveOption_String_String__table_p4k_hjd_5s} {#r_GlideFormRemoveOption_String_String__table_q4k_hjd_5s__entry__2}

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

{#r_GlideFormRemoveOption_String_String__table_q4k_hjd_5s}  

    g_form.removeOption('priority', '1');

## GlideForm -- salvar () {#ariaid-title52}

Salva o registro sem sair da navegação (atualizar e permanecer).
{#r_GlideFormSave__table_xgb_3qd_5s__entry__3}

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

{#r_GlideFormSave__table_xgb_3qd_5s} {#r_GlideFormSave__table_ygb_3qd_5s__entry__2}

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

{#r_GlideFormSave__table_ygb_3qd_5s}

## GlideForm -- setMandatory(cadeia de caracteres fieldName, booliano obrigatório) {#ariaid-title53}

Torna o campo especificado obrigatório.
Sempre que possível, use uma política de IU em vez deste método.
{#r_GF-SetMandatory_S_B__table_xnx_z4c_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| obrigatória | Booliano | Quando verdadeiro, o campo é obrigatório. Quando falso, torna o campo opcional. |
[Tabela 103. Parâmetros]

{#r_GF-SetMandatory_S_B__table_xnx_z4c_5s} {#r_GF-SetMandatory_S_B__table_ynx_z4c_5s__entry__2}

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

{#r_GF-SetMandatory_S_B__table_ynx_z4c_5s}

## GlideForm -- setSectionDisplay(cadeia de caracteres "sectionName", exibição booliana) {#ariaid-title54}

Mostra ou oculta uma seção.
{#r_GF-SetSectionDisplay_S_B__table_pqq_qqd_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sectionName | Cadeia de caracteres | O nome da seção está em minúsculas com um sublinhado substituindo o primeiro espaço no nome e com os espaços restantes sendo removidos, por exemplo, "Seção quatro está aqui" se torna "section_Fourishere". Outros caracteres não alfanuméricos, como e comercial (\&), são removidos. Os nomes de seção podem ser encontrados usando o método getSectionNames(). |
| tela | Booliano | Quando verdadeiro, mostra a seção. Quando falso, oculta a seção. |
[Tabela 105. Parâmetros]

{#r_GF-SetSectionDisplay_S_B__table_pqq_qqd_5s} {#r_GF-SetSectionDisplay_S_B__table_qqq_qqd_5s__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna verdadeiro quando bem-sucedido. |
[Tabela 106. Retorna]

{#r_GF-SetSectionDisplay_S_B__table_qqq_qqd_5s}

## GlideForm - setValue(cadeia de caracteres fieldName, cadeia de caracteres valor, cadeia de caracteres displayValue) {#ariaid-title55}

Define o valor de um campo de formulário especificado como o valor de um valor de exibição especificado em um registro de referência.
Para melhorar o desempenho, evitando um retorno ao definir o valor de um campo de referência, use este método, não setValue(fieldName, value). Ao definir vários valores de referência para um campo de coletor de lista, passe matrizes nos parâmetros value e displayValue.  
Nota:  
O método setValue() pode causar um estouro de pilha quando usado em um client script OnChange. Isso ocorre porque sempre que o valor for definido, ele será registrado como uma mudança, o que pode acionar novamente o script do cliente OnChange. Para evitar isso, execute uma verificação que validará que o novo valor será diferente do valor antigo. Por exemplo, antes de executar `setValue(shortDesc, newValue.toUpperCase());`, valide se a descrição resumida ainda não está em maiúscula. Isso impedirá que o client script aplique toUpperCase() mais de uma vez.
{#r_GlideForm-SetValue_S_S_S__table_oxn_vrc_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo de formulário a ser atualizado. |
| valor | Cadeia de caracteres ou matriz | Sys_id do registro de referência a ser usado para atualizar o campo. Se o campo especificado for um GlideList, este parâmetro poderá conter uma matriz de sys_ids. Nesse caso, o método executa uma pesquisa de todos os registros especificados na matriz e esses valores são usados para atualizar o conteúdo do campo especificado (lista relacionada). Nota: Ao definir um valor em uma lista de seleção, certifique-se de usar o valor numérico em vez do rótulo. |
| displayValue | Cadeia de caracteres ou matriz | Campo no registro de referência especificado a ser usado para atualizar o campo especificado. Por exemplo, na tabela Usuário \[sys_user\], pode ser userName. Se o campo especificado for um GlideList, este parâmetro poderá conter uma matriz de nomes de valor de exibição. Para obter informações adicionais sobre valores de exibição, consulte [Valor de exibição](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). |
[Tabela 107. Parâmetros]

{#r_GlideForm-SetValue_S_S_S__table_oxn_vrc_5s} {#r_GlideForm-SetValue_S_S_S__table_pxn_vrc_5s__entry__2}

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

{#r_GlideForm-SetValue_S_S_S__table_pxn_vrc_5s}  
Este exemplo mostra a passagem do sys_id do registro de referência que contém o campo userName a ser usado para atualizar o campo de formulário assigned_to.

    g_form.setValue('assigned_to', userSysID, userName);

Este exemplo mostra a passagem de uma matriz de sys_ids do registro de referência e uma matriz de nomes de valor de exibição correspondentes a serem usados para atualizar os campos de formulário no GlideList glide-list_field_name.

    g_form.setValue('glide-list_field_name', sysIDArray, displayNameArray);

## GlideForm -- showErrorBox(cadeia de caracteres nome, cadeia de caracteres mensagem, booliano rollForm) {#ariaid-title56}

Exibe uma mensagem de erro no campo de formulário especificado (um objeto de controle ou o nome do campo). Se o controle ou campo estiver fora da tela e o parâmetro rollForm for verdadeiro, o formulário será rolado para o controle ou campo.
Está disponível uma propriedade global (glide.ui.scroll_to_message_field) que controla a rolagem automática de mensagens quando o campo do formulário está fora da tela (rola o formulário para o controle ou campo). O método showFieldMsg() é um método semelhante que requer um parâmetro de tipo.
{#r_GF-ShowErrorBox_S_S_B__table_lyr_dww_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo ou controle. |
| mensagem | Cadeia de caracteres | Mensagem a ser exibida. |
| rolarFormulário | Booliano | Quando verdadeiro, rola o formulário para o campo. Quando falso, o formulário não rola para o campo. |
[Tabela 109. Parâmetros]

{#r_GF-ShowErrorBox_S_S_B__table_lyr_dww_ts} {#r_GF-ShowErrorBox_S_S_B__table_myr_dww_ts__entry__2}

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

{#r_GF-ShowErrorBox_S_S_B__table_myr_dww_ts}

## GlideForm - showFieldMsg(cadeia de caracteres de campo, mensagem de cadeia de caracteres, tipo de cadeia de caracteres) {#ariaid-title57}

Exibe uma mensagem informativa ou de erro no campo de formulário especificado (um objeto de controle ou o nome do campo). Se o controle ou o campo estiver fora da tela, o formulário será rolado para o campo.
Está disponível uma propriedade global (glide.ui.scroll_to_message_field) que controla a rolagem automática de mensagens quando o campo do formulário está fora da tela (rola o formulário para o controle ou campo).

O método showErrorBox() é um método abreviado que não requer o parâmetro de tipo.  
Nota:  
Este método não funciona com o campo de tipo \[ journal_field em IU principal.
{#r_GF-ShowFieldMsg_S_S_S__table_u3z_hxw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Assunto: | Cadeia de caracteres | Nome do campo ou controle. |
| mensagem | Cadeia de caracteres | Mensagem a ser exibida. |
| tipo | Cadeia de caracteres | "erro", "informações" ou "aviso". |
[Tabela 111. Parâmetros]

{#r_GF-ShowFieldMsg_S_S_S__table_u3z_hxw_ts} {#r_GF-ShowFieldMsg_S_S_S__table_v3z_hxw_ts__entry__2}

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

{#r_GF-ShowFieldMsg_S_S_S__table_v3z_hxw_ts}  

    g_form.showFieldMsg('impact','Low impact response time can be one week','info');

## GlideForm - showFieldMsg(cadeia de caracteres de campo, mensagem de cadeia de caracteres, tipo de cadeia de caracteres, rollForm booliano) {#ariaid-title58}

Exibe uma mensagem informativa ou de erro no campo de formulário especificado (um objeto de controle ou o nome do campo). Se o controle ou o campo estiver fora da tela e o rollForm for verdadeiro, o formulário será rolado para o campo.
Está disponível uma propriedade global (glide.ui.scroll_to_message_field) que controla a rolagem automática de mensagens quando o campo do formulário está fora da tela (rola o formulário para o controle ou campo).

O método showErrorBox() é um método abreviado que não requer o parâmetro de tipo.  
Nota:  
Este método não funciona com o campo de tipo \[ journal_field em IU principal.
{#r_GF-ShowFieldMsg_S_S_S_B__table_wmr_gyw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Assunto: | Cadeia de caracteres | Nome do campo ou controle. |
| mensagem | Cadeia de caracteres | Mensagem a ser exibida. |
| tipo | Cadeia de caracteres | "erro", "informações" ou "aviso". |
| rolarFormulário | Booliano | Quando verdadeiro, o formulário rola para o campo se ele estiver fora da tela. Quando falso, o formulário não rola. |
[Tabela 113. Parâmetros]

{#r_GF-ShowFieldMsg_S_S_S_B__table_wmr_gyw_ts} {#r_GF-ShowFieldMsg_S_S_S_B__table_xmr_gyw_ts__entry__2}

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

{#r_GF-ShowFieldMsg_S_S_S_B__table_xmr_gyw_ts}  

    g_form.showFieldMsg('impact','Low impact not allowed with High priority','error',false);

## GlideForm -- setDisabled(cadeia de caracteres fieldName, Booliano disable) {#ariaid-title59}

Torna o campo especificado disponível ou indisponível.
{#r_GlideFormSetDisabled_String_Boolean__table_sn2_j4c_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| desativar | Booliano | Quando verdadeiro, desabilita o campo. Quando falso, habilita o campo. |
[Tabela 115. Parâmetros]

{#r_GlideFormSetDisabled_String_Boolean__table_sn2_j4c_5s} {#r_GlideFormSetDisabled_String_Boolean__table_tn2_j4c_5s__entry__2}

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

{#r_GlideFormSetDisabled_String_Boolean__table_tn2_j4c_5s}

## GlideForm - setDisplay(cadeia de caracteres fieldName, exibição booliana) {#ariaid-title60}

Exibe ou oculta um campo.
Este método não pode ocultar um campo obrigatório sem valor. Se o campo estiver oculto, o espaço será usado para exibir outros itens. Sempre que possível, use uma política de IU em vez deste método.
{#r_GlideFormSetDisplay_String_Boolean__table_k4d_ctw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome do campo | Cadeia de caracteres | Nome do campo. |
| tela | Booliano | Quando verdadeiro, exibe o campo, quando falso, oculta o campo. |
[Tabela 117. Parâmetros]

{#r_GlideFormSetDisplay_String_Boolean__table_k4d_ctw_ts} {#r_GlideFormSetDisplay_String_Boolean__table_l4d_ctw_ts__entry__2}

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

{#r_GlideFormSetDisplay_String_Boolean__table_l4d_ctw_ts}  

    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
       //If the page isn't loading
       if (!isLoading) {
          //If the new value isn't blank
          if (newValue != '') {
             g_form.setDisplay('priority', false);   
          }
          else 
             g_form.setDisplay('priority', true);
          }
       }

## GlideForm -- setLabelOf(cadeia de caracteres fieldName, cadeia de caracteres rótulo) {#ariaid-title61}

Define o valor de texto simples do rótulo do campo.
Nota:  
Este método não é compatível com o Catálogo de serviços.
{#r_GlideFormSetLabelOf_String_String__table_h5q_ytw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo. |
| rótulo | Cadeia de caracteres | O rótulo de texto do campo. |
[Tabela 119. Parâmetros]

{#r_GlideFormSetLabelOf_String_String__table_h5q_ytw_ts} {#r_GlideFormSetLabelOf_String_String__table_i5q_ytw_ts__entry__2}

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

{#r_GlideFormSetLabelOf_String_String__table_i5q_ytw_ts}  

    if (g_user.hasRole('itil')) {
        var oldLabel = g_form.getLabelOf('comments');
        g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
    }

## GlideForm -- setReadOnly(cadeia de caracteres fieldName, booliano readOnly) {#ariaid-title62}

Torna o campo especificado somente leitura ou editável.
Sempre que possível, use uma política de IU em vez deste método.

Para tornar um campo obrigatório somente leitura, você deve primeiro remover o requisito obrigatório desse campo usando o método setMandatory().

Depois de definir um campo como somente leitura, você não poderá usar o método [setValue()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#r_GlideFormSetValue_String_String "Define o valor de um campo de formulário especificado para o valor passado.") para atualizar o valor desse campo. Se você precisar definir o valor dessa forma, deverá definir o valor readOnly como falso.
{#r_GlideFormSetReadOnly_String_Boolean__table_xdf_qpc_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo. |
| readOnly | Booliano | Sinalizador que determina se o campo associado é editável ou somente leitura. Valores possíveis: * verdadeiro: definir campo como somente leitura * falso: define o campo como editável {#r_GlideFormSetReadOnly_String_Boolean__ul_ah1_bkw_yqb} |
[Tabela 121. Parâmetros]

{#r_GlideFormSetReadOnly_String_Boolean__table_xdf_qpc_5s} {#r_GlideFormSetReadOnly_String_Boolean__table_ydf_qpc_5s__entry__2}

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

{#r_GlideFormSetReadOnly_String_Boolean__table_ydf_qpc_5s}  
O exemplo a seguir mostra como definir o Editor de variáveis como somente leitura. Para fazer isso em tabelas Catálogo de serviços, use setVariablesReadOnly().

    // Create a Client Script on a table (e.g., incident) and paste this script
    // Uncheck (set to false) the "isolate script" checkbox (not available by default)
    // To add the isolate script checkbox to the form, configure form layout to add the checkbox
    function onLoad() { 
      $("variable_map").querySelectorAll("item").forEach(function(item){
        var variable = item.getAttribute("qname"); 
        g_form.setReadOnly("variables."+ variable, true); 
      }); 
    }

## GlideForm - setValue(cadeia de caracteres fieldName, valor de cadeia de caracteres) {#ariaid-title63}

Define o valor de um campo de formulário especificado para o valor passado.
Este método também oferece suporte à definição de valores em um conjunto de variáveis com várias linhas (MRVS). Você deve primeiro usar `JSON.parse(getValue('` \<mrvs_field_name\> ')) para obter a matriz MRVS e usar a indexação para atualizar os campos nos objetos de linha. Depois que todos os valores forem atualizados no MRVS, use o método setValue() para salvar a matriz do MRVS atualizada. Para obter mais detalhes, consulte o exemplo de código abaixo.  
Nota:  
O método setValue() pode causar um estouro de pilha quando usado em um client script OnChange. Isso ocorre porque sempre que o valor for definido, ele será registrado como uma mudança, o que pode acionar novamente o script do cliente OnChange. Para evitar isso, execute uma verificação que validará que o novo valor será diferente do valor antigo. Por exemplo, antes de executar `setValue(shortDesc, newValue.toUpperCase());`, valide se a descrição resumida ainda não está em maiúscula. Isso impedirá que o client script aplique toUpperCase() mais de uma vez.  
Nota:  
Ao definir um valor em uma lista de seleção, certifique-se de usar o valor numérico em vez do rótulo.
{#r_GlideFormSetValue_String_String__table_bqz_pqc_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | Nome do campo de formulário a ser atualizado. |
| valor | Cadeia de caracteres | Valor de cadeia de caracteres a ser definido no campo especificado. |
[Tabela 123. Parâmetros]

{#r_GlideFormSetValue_String_String__table_bqz_pqc_5s} {#r_GlideFormSetValue_String_String__table_cqz_pqc_5s__entry__2}

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

{#r_GlideFormSetValue_String_String__table_cqz_pqc_5s}  
O exemplo a seguir mostra como definir a descrição resumida no formulário atual.

    g_form.setValue('short_description', 'replace this with appropriate text');

O exemplo a seguir mostra como definir valores em um MRVS. Neste exemplo, os salários estão sendo gerenciados por meio do Catálogo de serviços. O client script pesquisa todas as linhas no MRVS em busca do valor inserido no cargo e atualiza as entradas correspondentes no MRVS com o que está inserido no campo Salário. O MRVS é chamado de "variable_set_1" e contém os seguintes campos em cada objeto de linha: Nome do funcionário \[employee_name\], Cargo \[employee_job_title\] e Salário \[employee_salary\]. Além disso, o Item do catálogo contém: Cargo \[job_title\] e Salário \[salário\].

    function onChange(control, oldValue, newValue, isLoading) {
    if (isLoading || newValue == '') {
    return;
    }

    // Get the MRVS
    var multiRowVariableSet = JSON.parse(g_form.getValue('variable_set_1'));

    for (var i = 0; i < multiRowVariableSet.length; i++) {
    // Check if the entered job title matches the title in the current MRVS row
      if (multiRowVariableSet[i].employee_job_title == g_form.getValue("job_title")){
        // Update the value of a matching field with the new salary
        multiRowVariableSet[i].employee_salary = newValue;
      }
    }

    // Update the MRVS
    g_form.setValue('variable_set_1', JSON.stringify(multiRowVariableSet));
    }

## GlideForm -- setVariablesReadOnly(Booliano isReadOnly) {#ariaid-title64}

Torna um editor de variáveis Catálogo de serviços somente leitura.
Nota:  
Este método só se aplica a editores de variáveis Catálogo de serviços na IU principal. Este método não é compatível com o formulário Catálogo de serviços.

O método deve ser colocado no client script da tabela na qual o editor de variáveis é adicionado, como Item solicitado \[sc_req_item\], Incidente \[incident\] e assim por diante. Para definir variáveis para leitura somente em outras tabelas, use o método [setReadOnly()](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#r_GlideFormSetReadOnly_String_Boolean "Torna o campo especificado somente leitura ou editável.").

Consulte também: [Editores de variáveis do Catálogo de serviços](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
{#GF-setVariablesReadOnly_B__table_xdf_qpc_5s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| isReadOnly | Booliano | Sinalizador que determina se o editor de variáveis é somente leitura. Valores possíveis: * verdadeiro: define o editor de variáveis como somente leitura. * falso: define o editor de variáveis como editável. {#GF-setVariablesReadOnly_B__ul_ah1_bkw_yqb} Padrão: falso |
[Tabela 125. Parâmetros]

{#GF-setVariablesReadOnly_B__table_xdf_qpc_5s} {#GF-setVariablesReadOnly_B__table_ydf_qpc_5s__entry__2}

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

{#GF-setVariablesReadOnly_B__table_ydf_qpc_5s}  
Adicionar a seguinte linha a um client script define o editor de variáveis como somente leitura.

    g_form.setVariablesReadOnly(true);

## GlideForm -- setVisible(cadeia de caracteres fieldName, exibição booliana) {#ariaid-title65}

Exibe ou oculta o campo.
Na IU da área de trabalho, o espaço é deixado em branco quando oculto. Na IU para celular ou no Portal de serviços, o espaço é preenchido em Meus outros campos quando oculto. Este método não pode ocultar campos obrigatórios sem valor.

Use a Política de IU em vez deste método sempre que possível.
{#r_GlideFormSetVisible_String_Boolean__table_k24_45w_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O nome do campo. |
| tela | Booliano | Quando verdadeiro, exibe o campo. Quando falso, oculta o campo. |
[Tabela 127. Parâmetros]

{#r_GlideFormSetVisible_String_Boolean__table_k24_45w_ts} {#r_GlideFormSetVisible_String_Boolean__table_l24_45w_ts__entry__2}

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

{#r_GlideFormSetVisible_String_Boolean__table_l24_45w_ts}  

    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
       //If the page isn't loading
       if (!isLoading) {
          //If the new value isn't blank
          if(newValue != '') {
             g_form.setVisible('priority', false); 
          }
          else
             g_form.setVisible('priority', true); 
          }
       }

## GlideForm -- showErrorBox(cadeia de caracteres nome, cadeia de caracteres mensagem) {#ariaid-title66}

Exibe uma mensagem de erro no campo de formulário especificado (um objeto de controle ou o nome do campo). Se o controle ou campo estiver fora da tela, o formulário rolará para o controle ou campo.
Está disponível uma propriedade global (glide.ui.scroll_to_message_field) que controla a rolagem automática de mensagens quando o campo do formulário está fora da tela (rola o formulário para o controle ou campo). O método showFieldMsg() é um método semelhante que requer um parâmetro de tipo.
{#r_GlideFormShowErrorBox_String_String__table_rxv_2vw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | O nome do controle ou campo. |
| mensagem | Cadeia de caracteres | A mensagem a ser exibida. |
[Tabela 129. Parâmetros]

{#r_GlideFormShowErrorBox_String_String__table_rxv_2vw_ts} {#r_GlideFormShowErrorBox_String_String__table_sxv_2vw_ts__entry__2}

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

{#r_GlideFormShowErrorBox_String_String__table_sxv_2vw_ts}

## GlideForm -- showRelatedList(cadeia de caracteres listTableName) {#ariaid-title67}

Exibe a lista relacionada especificada no formulário.
Este método não está disponível na plataforma móvel. Se este método for executado em uma plataforma móvel, nenhuma ação ocorrerá.
{#r_GlideFormShowRelatedList_String__table_mps_2zw_ts__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| listTableName | Cadeia de caracteres | Nome da lista relacionada. |
[Tabela 131. Parâmetros]

{#r_GlideFormShowRelatedList_String__table_mps_2zw_ts} {#r_GlideFormShowRelatedList_String__table_nps_2zw_ts__entry__2}

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

{#r_GlideFormShowRelatedList_String__table_nps_2zw_ts}

## GlideForm -- showRelatedLists() {#ariaid-title68}

Exibe todas as listas relacionadas ao formulário.
Este método não está disponível na plataforma móvel. Se este método for executado em uma plataforma móvel, nenhuma ação ocorrerá.
{#r_GlideFormShowRelatedLists__table_jcj_rzw_ts__entry__3}

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

{#r_GlideFormShowRelatedLists__table_jcj_rzw_ts} {#r_GlideFormShowRelatedLists__table_kcj_rzw_ts__entry__2}

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

{#r_GlideFormShowRelatedLists__table_kcj_rzw_ts}

## GlideForm -- enviar() {#ariaid-title69}

Salva o registro.
O usuário é retirado do formulário, retornando-o para onde estava.
{#r_GlideFormSubmit__table_nhk_grd_5s__entry__3}

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

{#r_GlideFormSubmit__table_nhk_grd_5s} {#r_GlideFormSubmit__table_ohk_grd_5s__entry__2}

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

{#r_GlideFormSubmit__table_ohk_grd_5s}

## GlideForm - submit (verbo da cadeia de caracteres) {#ariaid-title70}

Executa a ação de IU especificada pelo parâmetro.
{#GF-submit_S__table_o1z_d3p_qx__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| verbo | Cadeia de caracteres | Um action_name de um registro sys_ui_action. O nome da ação deve ser para um botão de formulário visível. |
[Tabela 137. Parâmetros]

{#GF-submit_S__table_o1z_d3p_qx} {#GF-submit_S__table_p1z_d3p_qx__entry__2}

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

{#GF-submit_S__table_p1z_d3p_qx}