---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# MobileScriptIncludeCaller -- Client

# MobileScriptIncludeCaller -- Client {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

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

Diese API kann mit verwendet werden [M_Form -- Client](https://servicenow-prod.fluidtopics.net/nmKDUU6hxg8CycnPHUeikQ#m_formClientAPI "Stellt Methoden zum Abrufen und Festlegen von Eingabewerten auf Eingabeformularbildschirmen sowie zum Anzeigen von Nachrichten bereit.")API zum automatischen Ausfüllen von Eingaben auf Eingabeformularbildschirmen. Weitere Informationen zu Eingabeformularbildschirmen finden Sie unter [Input form screen](https://www.servicenow.com/docs/access?context=parameter-input-screen&version=yokohama&pubname=yokohama-mobile&ft:locale=en-US).

Verwenden Sie diese API in Client-Skript Feld einer mobilen 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](https://www.servicenow.com/docs/access?context=config-autofil-inputs-nptfrmscrn&version=yokohama&pubname=yokohama-mobile&ft:locale=en-US).

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

## MobileScriptIncludeCaller -- MobileScriptIncludeCaller(Zeichenfolge scriptName, Zeichenfolge FunctionName) {#ariaid-title2}

Erstellt eine Instanz von MobileScriptIncludeCaller Klasse mit der Skripteinbindung und der aufzurufenden Funktion.
{#MobileScrInCl-MobileScrInCl_S_S__table_umw_wlk_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Skriptname | Zeichenfolge | Name der für Mobilgeräte aufrufbaren Skripteinbindung, die aufgerufen werden soll. Wenn die Skripteinbindung den bereichsübergreifenden Zugriff unterstützt und sich in einem anderen Bereich als das Client-Skript befindet, muss dem Namen der Skripteinbindung das Präfix vorangestellt werden Umfang . |
| functionName | Zeichenfolge | Die öffentliche Funktion, die in der Skripteinbindung aufgerufen werden soll. |
[Tabelle : 1. Parameter]

{#MobileScrInCl-MobileScrInCl_S_S__table_umw_wlk_mbc}  
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) {#ariaid-title3}

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.
{#MobileScrInCl-addParam_S_S__table_r3s_xtl_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| key | Zeichenfolge | Schlüssel, der für den Parameter verwendet werden soll. |
| Wert | Objekt | Wert des Parameters. |
[Tabelle : 2. Parameter]

{#MobileScrInCl-addParam_S_S__table_r3s_xtl_mbc} {#MobileScrInCl-addParam_S_S__table_s3s_xtl_mbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Rückgaben]

{#MobileScrInCl-addParam_S_S__table_s3s_xtl_mbc}  
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) {#ariaid-title4}

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 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.
{#MobileScrInCl-call_F__table_es1_b5l_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Erfolgreicher Rückruf | Funktion | Optional. Der Name der Rückruffunktion zur Verarbeitung der vom Server zurückgegebenen Ergebnisse. Wenn keine Rückruffunktion bereitgestellt wird, gibt diese Methode eine Zusage zurück, die mit verbraucht werden kann [Zusage-API](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise). |
| Fehler -- Rückruf | Funktion | Optional. Der Name der Rückruffunktion, die aufgerufen werden soll, wenn ein Fehler auftritt. |
[Tabelle : 4. Parameter]

{#MobileScrInCl-call_F__table_es1_b5l_mbc} {#MobileScrInCl-call_F__table_fs1_b5l_mbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Rückgaben]

{#MobileScrInCl-call_F__table_fs1_b5l_mbc}  
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, die verwendet wird, um die Eingabe „Business_title" auf dem Eingabeformularbildschirm automatisch auszufüllen.

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


