GlideForm para celular (g_form) - Cliente

Os métodos GlideForm (g_form) para celular permitem que você trabalhe 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")

Adiciona um ícone decorativo ao lado de um campo.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
fieldName	Cadeia de caracteres	O nome do campo.
ícone	Cadeia de caracteres	O ícone de fonte a ser exibido ao lado do campo.
texto	Cadeia de caracteres	O título do texto para o ícone (usado para leitores de tela).

Tabela 2. Retorna

Tipo	Descrição
vazio

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

Obtém o texto do rótulo do formulário.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
fieldName	Cadeia de caracteres	O nome do campo.

Tabela 4. Retorna

Tipo	Descrição
Cadeia de caracteres	O texto do rótulo.

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

Determina se um campo está presente no formulário.

Presente significa que ele pode ser mostrado, não que está visível.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
fieldName	Cadeia de caracteres	O campo a ser pesquisado.

Tabela 6. Retorna

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, ser somente leitura, obrigatório ou ser inválido.

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

Remove um ícone decorativo ao lado de um campo.

Tabela 7. Parâmetros

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 do texto para o ícone.

Tabela 8. Retorna

Tipo	Descrição
vazio

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 "label")

Define o texto do rótulo do formulário.

Tabela 9. Parâmetros

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 10. Retorna

Tipo	Descrição
vazio

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