MobileScriptIncludeCaller - Cliente

Fornece métodos para chamar inclusões de script de Ações de regra da IU para celular.

Esta API pode ser usada com a API m_form — Cliente para preencher automaticamente as entradas nas telas do formulário de entrada. Para obter mais informações sobre as telas do formulário de entrada, consulte Input form screen.

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

A inclusão de script deve ter o campo Móvel chamável selecionado para ser chamado por esta API.

MobileScriptIncludeCaller - MobileScriptIncludeCaller (cadeia de caracteres scriptName, cadeia de caracteres functionName)

Cria uma instância da classe MobileScriptIncludeCaller com a inclusão de script e a função a serem chamadas.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
scriptNome	Cadeia de caracteres	Nome da inclusão de script móvel chamável a ser chamada. Se a inclusão de script oferecer suporte ao acesso entre escopos e estiver em um escopo diferente do script do cliente, o nome da inclusão de script deverá ser prefixado com o escopo.
functionName	Cadeia de caracteres	A função pública a ser chamada na inclusão de script.

Este exemplo mostra como criar uma instância da classe MobileScriptIncludeCaller que pode ser usada para chamar a função getBusinessTitle() na inclusão de script UserUtilsTest.

var caller = new MobileScriptIncludeCaller("UserUtilsTest", "getBusinessTitle");

MobileScriptIncludeCaller - addParam (chave de cadeia de caracteres, valor de objeto)

Adiciona um parâmetro a ser passado ao chamar a inclusão de script.

Este método permite passar valores do formulário de entrada para a inclusão de script.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
chave	Cadeia de caracteres	Chave a ser usada para o parâmetro.
valor	Objeto	Valor do parâmetro.

Tabela 3. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo mostra como adicionar o valor da entrada employee_id do formulário de entrada ao objeto MobileScriptIncludeCaller.

var employeeId = m_form.getValue("employee_id"); 
var caller = new MobileScriptIncludeCaller("UserUtilsTest", "getBusinessTitle"); 
caller.addParam("employeeId", employeeId);

MobileScriptIncludeCaller - call (Retorno de chamada com sucesso na função, Retorno de chamada com erro na função)

Chama a inclusão de script especificada pelo construtor.

A chamada do servidor é executada de forma assíncrona e a resposta da inclusão de script é passada para a função de retorno de chamada. Se a resposta do servidor falhar, por exemplo, se a inclusão de script não for encontrada, o argumento de resposta passado para o retorno de chamada será vazio ou nulo.

A inclusão de script deve ter o campo Móvel chamável selecionado para ser chamado por este método.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
sucessoRetorno de chamada	Função	Opcional. O nome da função de retorno de chamada para processar os resultados retornados pelo servidor. Se uma função de retorno de chamada não for fornecida, este método retornará uma promessa, que pode ser consumida usando a API Promise.
erroRetorno de chamada	Função	Opcional. O nome da função de retorno de chamada a ser chamada se ocorrer um erro.

Tabela 5. Retornos

Tipo	Descrição
Nenhum(a)

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