MobileScriptIncludeCaller : Client

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

Diese API kann mit der m_form : Client API verwendet werden, um Eingaben auf Eingabeformular-Bildschirmen automatisch auszufüllen. Weitere Informationen zu Eingabeformular-Bildschirmen finden Sie unter Input form screen.

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

In der Skripteinbindung muss das Feld Mobil aufrufbar ausgewählt sein, damit sie von dieser API aufgerufen wird.

MobileScriptIncludeCaller - MobileScriptIncludeCaller(Zeichenfolge scriptName, ZeichenfolgefunktionsName)

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

Tabelle : 1. Parameter

Name	Typ	Beschreibung
scriptName	Zeichenfolge	Name der aufzurufenden mobil aufrufbaren Skripteinbindung. Wenn die Skripteinbindung bereichsübergreifenden Zugriff unterstützt und sich in einem anderen Bereich als das Client-Skript befindet, muss dem Namen der Skripteinbindung der Bereich Bereichvorangestellt werden.
functionName	Zeichenfolge	Die öffentliche Funktion zum Aufrufen in der Skripteinbindung.

Dieses Beispiel zeigt, wie Sie eine Instanz der MobileScriptIncludeCaller -Klasse erstellen, die zum Aufrufen der Funktion getBusinessTitle() in der Skripteinbindung UserUtilsTest verwendet werden kann.

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

MobileScriptIncludeCaller - addParam(Zeichenfolgenschlüssel, Objektwert)

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

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

Tabelle : 2. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Für den Parameter zu verwendender Schlüssel.
Wert	Objekt	Wert des Parameters.

Tabelle : 3. Rückgaben

Typ	Beschreibung
Keine

In diesem Beispiel wird gezeigt, wie Sie den Wert der Eingabe „employee_id“ aus dem Eingabeformular zum Objekt MobileScriptIncludeCaller hinzufügen.

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

MobileScriptIncludeCaller – call(Funktion erfolgreichCallback, Funktion errorCallback)

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 des Servers fehlschlägt, z. B. wenn die Skripteinbindung nicht gefunden wurde, ist das an den Rückruf übergebene Antwortargument leer oder null.

In der Skripteinbindung muss das Feld Mobil aufrufbar ausgewählt sein, damit es von dieser Methode aufgerufen werden kann.

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 angegeben ist, gibt diese Methode ein Promise zurück, das mit der Promise-APIverwendet werden kann.
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 Client-Skript übergibt den Eingabewert „employee_id“ an die Skripteinbindung, die anhand der ID den Titel des Mitarbeiters sucht. Der Titel wird der Rückruffunktion bereitgestellt, die zum automatischen Ausfüllen der Eingabe „business_title“ auf dem Eingabeformularbildschirm verwendet 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' 
});