---
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 para celular (g_form) - Cliente

# GlideForm para celular (g_form) - Cliente {#ariaid-title1}

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

A API GlideForm para celular (g_form) fornece métodos para trabalhar com formulários na plataforma móvel.

Use esses métodos em qualquer script que tenha como destino um dispositivo móvel.

## MobileGlideForm (g_form) - addDecoration(cadeia de caracteres fieldName, ícone de cadeia de caracteres, texto de cadeia de caracteres) {#ariaid-title2}

Adiciona um ícone decorativo ao lado de um campo.
{#r_MGF-addDecoration_S_S_S__table_nbc_4dw_mt__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. |
| texto | Cadeia de caracteres | O título de texto do ícone (usado para leitores de tela). |
[Tabela 1. Parâmetros]

{#r_MGF-addDecoration_S_S_S__table_nbc_4dw_mt} {#r_MGF-addDecoration_S_S_S__table_obc_4dw_mt__entry__2}

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

{#r_MGF-addDecoration_S_S_S__table_obc_4dw_mt}  
Este exemplo adiciona um ícone VIP ao lado do solicitante.

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

## MobileGlideForm (g_form) -- getLabel(cadeia de caracteres fieldName) {#ariaid-title3}

Obtém o texto do rótulo do formulário.
{#r_MGF-getLabel_S__table_jbc_4dw_mt__entry__3}

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

{#r_MGF-getLabel_S__table_jbc_4dw_mt} {#r_MGF-getLabel_S__table_kbc_4dw_mt__entry__2}

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

{#r_MGF-getLabel_S__table_kbc_4dw_mt}  

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

## MobileGlideForm (g_form) - hasField(cadeia de caracteres fieldName) {#ariaid-title4}

Determina se um campo está presente no formulário.
Presente significa que ele pode ser mostrado, não que está visível.
{#r_MGF-hasField_S__table_lbc_4dw_mt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fieldName | Cadeia de caracteres | O campo a ser pesquisado. |
[Tabela 5. Parâmetros]

{#r_MGF-hasField_S__table_lbc_4dw_mt} {#r_MGF-hasField_S__table_mbc_4dw_mt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o campo estiver presente no formulário; falso, se não for. No formulário, significa que o campo faz parte de g_form. Ele ainda pode estar oculto, somente leitura, obrigatório ou inválido. |
[Tabela 6. Retorna]

{#r_MGF-hasField_S__table_mbc_4dw_mt}  
Este exemplo torna o campo assigned_to obrigatório se o campo assign_group estiver no formulário.

    if (g_form.hasField('assignment_group'))
          g_form.setMandatory('assigned_to', true);
        
## MobileGlideForm (g_form) - removeDecoration(cadeia de caracteres fieldName, ícone de cadeia de caracteres, texto de cadeia de caracteres) {#ariaid-title5}

Remove um ícone decorativo ao lado de um campo.
{#r_MGF-removeDecoration_S_S_S__table_q5v_wvw_mt__entry__3}

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

{#r_MGF-removeDecoration_S_S_S__table_q5v_wvw_mt} {#r_MGF-removeDecoration_S_S_S__table_t5v_wvw_mt__entry__2}

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

{#r_MGF-removeDecoration_S_S_S__table_t5v_wvw_mt}  

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

## MobileGlideForm (g_form) - setLabel(cadeia de caracteres fieldName, cadeia de caracteres rótulo) {#ariaid-title6}

Define o texto do rótulo do formulário.
{#r_MGF-setLabel_S_S__table_fbc_4dw_mt__entry__3}

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

{#r_MGF-setLabel_S_S__table_fbc_4dw_mt} {#r_MGF-setLabel_S_S__table_gbc_4dw_mt__entry__2}

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

{#r_MGF-setLabel_S_S__table_gbc_4dw_mt}  
Este exemplo muda o rótulo de comentários.

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