m_form - Cliente

Fornece métodos para obter e definir valores de entrada nas telas do formulário de entrada, bem como exibir mensagens.

Esta API oferece suporte aos seguintes tipos de entrada:

• Booliano
• Escolha
• Date/hora
• Número
• Referência
• Cadeia de caracteres

Esta API pode ser usada com MobileScriptIncludeCaller - Cliente API para preencher automaticamente entradas em telas de formulário de entrada. Para obter mais informações sobre telas de formulário de entrada, consulte Input form screen.

Use esta API no Client script Campo de uma ação de regra de IU para celular. Para obter instruções sobre como configurar uma ação de regra de IU para celular com as configurações corretas para esta API, consulte Configure auto-fill inputs on input form screens.

AddErrorMessage (mensagem de cadeia de caracteres)

Exibe uma mensagem de erro na parte superior da tela do formulário de entrada.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
message	Cadeia de caracteres	A mensagem a ser exibida.

Tabela 2. Retornos

Tipo	Descrição
Nenhum(a)

Neste exemplo, uma mensagem informativa ou de erro é exibida no formulário, dependendo do valor inserido para a prioridade.

// Client script in a Mobile UI Rule Action
function onChange(inputName, newValue) { 
   var priority = newValue; 
   if (priority > 0 && priority < 3) { 
      getMessage("This incident should be handled ASAP", function(response){ 
         m_form.addInfoMessage(response); 
      }); 
   } else { 
      getMessage("The selected priority is invalid", function(response){ 
         m_form.addErrorMessage(response); 
      }); 
   }	 
}

AddInfoMessage (mensagem de cadeia de caracteres)

Exibe uma mensagem informativa na parte superior da tela do formulário de entrada.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
message	Cadeia de caracteres	A mensagem a ser exibida.

Tabela 4. Retornos

Tipo	Descrição
Nenhum(a)

Neste exemplo, uma mensagem informativa ou de erro é exibida no formulário, dependendo do valor inserido para a prioridade.

// Client script in a Mobile UI Rule Action
function onChange(inputName, newValue) { 
   var priority = newValue; 
   if (priority > 0 && priority < 3) { 
      getMessage("This incident should be handled ASAP", function(response){ 
         m_form.addInfoMessage(response); 
      }); 
   } else { 
      getMessage("The selected priority is invalid", function(response){ 
         m_form.addErrorMessage(response); 
      }); 
   }	 
}

M_form - getValue(cadeia de caracteres inputName)

Retorna o valor de uma entrada especificada em uma tela de formulário de entrada.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
InputName	Cadeia de caracteres	Nome da entrada da qual retornar o valor.

Tabela 6. Retornos

Tipo	Descrição
Cadeia de caracteres	O valor da entrada especificada. Nota: Se a entrada for uma lista de seleção com seleção múltipla, o tipo de retorno será uma matriz de cadeias de caracteres que contém os valores selecionados.

Este client script passa o valor de entrada employee_id para a inclusão de script, que usa o ID para pesquisar o cargo do funcionário. O título é fornecido para a função de retorno de chamada, que ela usa para preencher automaticamente a entrada business_title na tela do formulário de entrada.

// Client script in a Mobile UI Rule Action
function onChange(inputName, newValue) { 
   var employeeId = m_form.getValue("employee_id"); 
   var caller = new MobileScriptIncludeCaller("UserUtilsTest", "getBusinessTitle"); 
   caller.addParam("employeeId", employeeId); 
   caller.call(function(response) { 
      m_form.setValue("business_title", response); 
   }); 
}

Inclusão de script.

// Mobile callable script include
var UserUtilsTest = Class.create(); 
UserUtilsTest.prototype = Object.extendsObject(global.AbstractMobileCallableInclude, { 
   getBusinessTitle: function() { 
      var employeeId = this.getParameter("employeeId"); 
      var gr = new GlideRecord("sys_user"); 
      gr.get(employeeId); 
      return gr.getValue("title"); 
   }, 
   type: 'UserUtilsTest' 
});

SetAffectedInputs(Array inputNames)

Adiciona um efeito brilhante às entradas especificadas, indicando que o valor está sendo definido por um script.

O efeito de brilho termina quando o valor da entrada é definido.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
InputNames	Matriz	Matriz de cadeias de caracteres que contém os nomes das entradas às quais aplicar o efeito de brilho.

Tabela 8. Retornos

Tipo	Descrição
Nenhum(a)

Este client script adiciona um efeito de brilho à entrada do solicitante para indicar que ela foi preenchida automaticamente.

// Client script in a Mobile UI Rule Action
function onChange(inputName, newValue) { 
   var affectedInputs = []; 
   affectedInputs.push("Caller"); 
   m_form.setAffectedInputs(affectedInputs); 
   m_form.setValue("Caller", ["800b174138d089c868d09de320f9833b", "46d44a23a9fe19810012d100cca80666"]); 
   var result = m_form.getValue("Caller"); 
   console.log(`Ref test: ${result[0]}`); 
}

SetValue (cadeia de caracteres inputName, valor do objeto, cadeia de caracteres displayValue)

Define o valor de uma entrada especificada em uma tela de formulário de entrada.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
InputName	Cadeia de caracteres	Nome da entrada para definir o valor.
valor	Objeto	Valor para definir a entrada. O tipo de dados do valor varia com base na entrada que está sendo definida.
displayValue	Cadeia de caracteres	Opcional. Use este parâmetro ao definir o valor das entradas do tipo Referência.

Tabela 10. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo define um valor inteiro para a entrada de pedido.

m_form.setValue("order", 5);

Este exemplo define um valor de cadeia de caracteres para a entrada de descrição.

m_form.setValue("description", "This is the description content");

Este exemplo usa um objeto que contém o valor e o valor de exibição para definir uma entrada de tipo de referência.

m_form.setValue("Caller", [{"value":"800b174138d089c868d09de320f9833b", "displayValue":"Abel Tuter"}]);