MobileScriptIncludeCaller : client

Fournit des méthodes pour appeler des includes de script à partir d’actions de règle d’interface utilisateur mobile.

Cette API peut être utilisée avec l’API pour remplir automatiquement les entrées sur les m_form : client écrans du formulaire d’entrée. Pour plus d’informations sur les écrans du formulaire d’entrée, reportez-vous à la section Input form screen.

Utilisez cette API dans le champ Script client d’une action de règle d’interface utilisateur mobile. Pour obtenir des instructions sur la configuration d’une action de règle d’interface utilisateur mobile avec les paramètres corrects pour cette API, reportez-vous à la section Configure auto-fill inputs on input form screens.

Le champ Mobile pouvant être appelé doit être sélectionné pour être appelé par cette API dans l’include de script.

MobileScriptIncludeCaller : MobileScriptIncludeCaller(String scriptName, String functionName)

Crée une instance de la classe MobileScriptIncludeCaller avec le script include et la fonction à appeler.

Tableau 1. Paramètres

Nom	Type	Description
Nom du script	Chaîne	Nom de l’include de script mobile pouvant être appelé. Si l’include de script prend en charge l’accès entre périmètres et qu’il se trouve dans un périmètre différent de celui du script client, le nom de l’include de script doit être précédé du périmètre.
functionName	Chaîne	Fonction publique à appeler dans le script include.

Cet exemple montre comment créer une instance de la classe MobileScriptIncludeCaller qui peut être utilisée pour appeler la fonction getBusinessTitle() dans l’include de script UserUtilsTest.

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

MobileScriptIncludeCaller : addParam(Clé de chaîne, Valeur d’objet)

Ajoute un paramètre à transmettre lors de l’appel de script include.

Cette méthode vous permet de transmettre des valeurs du formulaire d’entrée à l’include de script.

Tableau 2. Paramètres

Nom	Type	Description
clé	Chaîne	Clé à utiliser pour le paramètre.
valide	Objet	Valeur du paramètre.

Tableau 3. Renvoie

Type	Description
Néant

Cet exemple montre comment ajouter la valeur de l’entrée employee_id du formulaire d’entrée à l’objet MobileScriptIncludeCaller .

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

MobileScriptIncludeCaller : call(Function successCallback, Function errorCallback)

Appelle l’include de script spécifié par le constructeur.

L’appel du serveur s’exécute de manière asynchrone et la réponse du script include est transmise à la fonction de rappel. Si la réponse du serveur échoue, par exemple si l’include de script est introuvable, l’argument de réponse transmis au rappel est vide ou nul.

Le champ Mobile pouvant être appelé doit être sélectionné pour être appelé par cette méthode pour l’include de script.

Tableau 4. Paramètres

Nom	Type	Description
successCallback	Fonction	Facultatif. Nom de la fonction de rappel pour traiter les résultats retournés par le serveur. Si une fonction de rappel n’est pas fournie, cette méthode renvoie une promesse, qui peut être consommée à l’aide de l’API Promise.
errorCallback	Fonction	Facultatif. Nom de la fonction de rappel à appeler en cas d’erreur.

Tableau 5. Renvoie

Type	Description
Néant

Ce script client transmet la valeur d’entrée employee_id à l’include de script, qui utilise l’ID pour rechercher le titre de l’employé. Le titre est fourni à la fonction de rappel, qu’elle utilise pour remplir automatiquement l’entrée business_title sur l’écran du formulaire d’entrée.

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

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