MobileScriptIncludeCaller – Client

Stellt Methoden zum Aufrufen von Skripteinbindungen aus Mobile UI-Regelaktionen bereit.

Diese API kann mit verwendet werden M_Form – Client API zum automatischen Ausfüllen von Eingaben auf Eingabeformularbildschirmen. Weitere Informationen zu Eingabeformularbildschirmen finden Sie unter Input form screen.

Verwenden Sie diese API in Client-Skript Feld einer Mobile UI-Regelaktion. Anweisungen zum Konfigurieren einer mobilen UI-Regelaktion mit den richtigen Einstellungen für diese API finden Sie unter Configure auto-fill inputs on input form screens.

Die Skripteinbindung muss haben Mobil aufrufbar Feld, das von dieser API aufgerufen werden soll.

MobileScriptIncludeCaller: MobileScriptIncludeCaller(Zeichenfolge scriptName, Zeichenfolge FunctionName)

Erstellt eine Instanz von MobileScriptIncludeCaller Klasse mit der Skripteinbindung und der aufzurufenden Funktion.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
scriptName	Zeichenfolge	Name der für Mobilgeräte aufrufbaren Skripteinbindung, die aufgerufen werden soll. Wenn die Skripteinbindung bereichsübergreifenden Zugriff unterstützt und sich in einem anderen Bereich als das Clientskript befindet, muss dem Namen der Skripteinbindung das Präfix vorangestellt werden Umfang .
functionName	Zeichenfolge	Die öffentliche Funktion, die in der Skripteinbindung aufgerufen werden soll.

Dieses Beispiel zeigt, wie eine Instanz von erstellt wird MobileScriptIncludeCaller Klasse, die zum Aufrufen von verwendet werden kann GetBusinessTitle() Funktion in der Skripteinbindung „UserUtilsTest“.

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

MobileScriptIncludeCaller – addParam(Zeichenfolgenschlüssel, Objektwert)

Fügt einen Parameter hinzu, der beim Aufrufen der Skripteinbindung übergeben werden soll.

Mit dieser Methode können Sie Werte aus dem Eingabeformular an die Skripteinbindung übergeben.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Schlüssel, der für den Parameter verwendet werden soll.
Wert	Objekt	Wert des Parameters.

Tabelle : 3. Rückgaben

Typ	Beschreibung
Keine

Dieses Beispiel zeigt, wie der Wert der Eingabe „Employee_ID“ aus dem Eingabeformular zu hinzugefügt wird MobileScriptIncludeCaller Objekt.

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

MobileScriptIncludeCaller – Call(function Success Callback, function error Callback)

Ruft die vom Konstruktor angegebene Skripteinbindung auf.

Der Serveraufruf wird asynchron ausgeführt, und die Antwort der Skripteinbindung wird an die Rückruffunktion übergeben. Wenn die Antwort vom Server fehlschlägt, z. B. wenn die Skripteinbindung nicht gefunden wird, ist das an den Rückruf übergebene Antwortargument leer oder null.

Die Skripteinbindung muss haben Mobil aufrufbar Feld, das von dieser Methode aufgerufen werden soll.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
successCallback	Funktion	Optional. Der Name der Rückruffunktion, um die vom Server zurückgegebenen Ergebnisse zu verarbeiten. Wenn keine Rückruffunktion bereitgestellt wird, gibt diese Methode eine Zusage zurück, die mit verbraucht werden kann Zusage-API .
Fehler – Rückruf	Funktion	Optional. Der Name der Rückruffunktion, die aufgerufen werden soll, wenn ein Fehler auftritt.

Tabelle : 5. Rückgaben

Typ	Beschreibung
Keine

Dieses Clientskript übergibt den Eingabewert Employee_ID an die Skripteinbindung, die die ID verwendet, um den Titel des Mitarbeiters zu suchen. Der Titel wird der Rückruffunktion bereitgestellt, mit der die Eingabe „Business_title“ auf dem Eingabeformularbildschirm automatisch ausgefüllt wird.

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

Skripteinbindung.

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