GlideForm para celular (g_form) - Cliente

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)

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 mostrado ao lado do campo.
texto	Cadeia de caracteres	O título de texto do í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, somente leitura, obrigatório ou 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 de texto do í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 rótulo)

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