GlideForm para celular (g_form) - Cliente

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

Use esses métodos em qualquer script direcionado a 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.
ícones	Cadeia de caracteres	O ícone de fonte a ser exibido ao lado do campo.
texto	Cadeia de caracteres	O título do texto do ícone (usado para leitores de tela).

Tabela 2. Retornos

Tipo	Descrição
vazio

Este exemplo adiciona um ícone VIP ao lado do chamador.

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

Tabela 6. Retornos

Tipo	Descrição
Booliano	Verdadeiro se o campo estiver presente no formulário; falso, se não estiver. No formulário significa que o campo faz parte de g_form. Ainda pode estar oculto, somente leitura, obrigatório ou inválido.

Este exemplo torna o campo assigned_to obrigatório se o campo assignment_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 de ao lado de um campo.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
fieldName	Cadeia de caracteres	O nome do campo.
ícones	Cadeia de caracteres	O ícone a ser removido.
texto	Cadeia de caracteres	O título do texto do ícone.

Tabela 8. Retornos

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, rótulo da cadeia de caracteres)

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

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