MobileScriptIncludeCaller : client

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

Cette API peut être utilisée avec l’API m_form : client pour remplir automatiquement les entrées sur les écrans de formulaire d’entrée. Pour en savoir plus 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.

L’include de script doit avoir le champ Mobile joignable sélectionné pour être appelé par cette API.

MobileScriptIncludeCaller : MobileScriptIncludeCaller(String scriptName, String functionName)

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

Tableau 1. Paramètres

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

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 l’include de script.

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
key	Chaîne	Clé à utiliser pour le paramètre.
valide	Objet	Valeur du paramètre.

Tableau 3. Renvoie

Type	Description
Aucun

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 : appel (fonction successCallback, fonction errorCallback)

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

L’appel de 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 le script include est introuvable, l’argument de réponse transmis au rappel est vide ou nul.

L’include de script doit avoir le champ Mobile appelable sélectionné pour être appelé par cette méthode.

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 aucune fonction de rappel n’est fournie, cette méthode renvoie une promesse, qui peut être consommée à l’aide de l’API Promise.
errorCallback (en anglais seulement)	Fonction	Facultatif. Nom de la fonction de rappel à appeler en cas d’erreur.

Tableau 5. Renvoie

Type	Description
Aucun

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