---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# MobileScriptIncludeCaller - クライアント

# MobileScriptIncludeCaller - クライアント {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

モバイル UI のルールアクションからスクリプトインクルードを呼び出すメソッドを提供します。

この API を [m_form - クライアント](https://servicenow-prod.fluidtopics.net/10db8tQpUvuELoBUsJoFuw#m_formClientAPI "入力フォーム画面で入力値を取得および設定したり、メッセージを表示したりするメソッドを提供します。") API とともに使用して、入力フォーム画面に入力を自動入力できます。 入力フォーム画面の詳細については、 [Input form screen](https://www.servicenow.com/docs/access?context=parameter-input-screen&version=xanadu&pubname=xanadu-mobile&ft:locale=en-US)を参照してください。

この API は、モバイル UI ルールアクションの \[クライアントスクリプト \] フィールドで使用します。この API の正しい設定でモバイル UI ルールアクションを構成する手順については、「 [Configure auto-fill inputs on input form screens](https://www.servicenow.com/docs/access?context=config-autofil-inputs-nptfrmscrn&version=xanadu&pubname=xanadu-mobile&ft:locale=en-US)」を参照してください。

スクリプトインクルードでは、この API によって呼び出されるように \[モバイルコール可能 \] フィールドが選択されている必要があります。

## MobileScriptIncludeCaller - MobileScriptIncludeCaller(文字列 scriptName, 文字列 functionName) {#ariaid-title2}

呼び出すスクリプトインクルードと関数を持つ MobileScriptIncludeCaller クラスのインスタンスを作成します。
{#MobileScrInCl-MobileScrInCl_S_S__table_umw_wlk_mbc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| scriptName | 文字列 | 呼び出すモバイル呼び出し可能スクリプトインクルードの名前。 スクリプトインクルードがクロススコープアクセスをサポートし、クライアントスクリプトとは異なるスコープ内にある場合は、スクリプトインクルードの名前にプリフィックス scope を付ける必要があります。 |
| functionName | 文字列 | スクリプトインクルードで呼び出すパブリック関数。 |
[表 : 1. パラメーター]

{#MobileScrInCl-MobileScrInCl_S_S__table_umw_wlk_mbc}  
この例では、UserUtilsTest スクリプトインクルードで `getBusinessTitle()` 関数を呼び出すために使用できる MobileScriptIncludeCaller クラスのインスタンスを作成する方法を示します。

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

## MobileScriptIncludeCaller - addParam(文字列 key, オブジェクト値) {#ariaid-title3}

スクリプトインクルードを呼び出すときに渡すパラメーターを追加します。
このメソッドを使用すると、入力フォームからスクリプトインクルードに値を渡すことができます。
{#MobileScrInCl-addParam_S_S__table_r3s_xtl_mbc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| key | 文字列 | パラメーターに使用するキー。 |
| 値 | オブジェクト | パラメーターの値。 |
[表 : 2. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 3. 返される内容]

{#MobileScrInCl-addParam_S_S__table_s3s_xtl_mbc}  
この例では、入力フォームからのemployee_id入力の値を MobileScriptIncludeCaller オブジェクトに追加する方法を示します。

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

## MobileScriptIncludeCaller - call(関数 successCallback, 関数 errorCallback) {#ariaid-title4}

コンストラクターによって指定されたスクリプトインクルードを呼び出します。
サーバー呼び出しは非同期に実行され、スクリプトインクルードの応答がコールバック関数に渡されます。スクリプトインクルードが見つからない場合など、サーバーからの応答が失敗した場合、コールバックに渡される応答引数は空または null になります。

スクリプトインクルードでは、このメソッドによって呼び出されるように \[モバイルコール可能 \] フィールドが選択されている必要があります。
{#MobileScrInCl-call_F__table_es1_b5l_mbc__entry__3}

| 名前 | タイプ | Description (説明) |
|-|-|-|
| successCallback | 関数 | オプション。サーバーから返された結果を処理するコールバック関数の名前 コールバック関数が指定されていない場合、このメソッドは [Promise を返し、Promise API](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) を使用して使用できます。 |
| errorCallback | 関数 | オプション。エラーが発生した場合に呼び出すコールバック関数の名前。 |
[表 : 4. パラメーター]

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

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 5. 返される内容]

{#MobileScrInCl-call_F__table_fs1_b5l_mbc}  
このクライアントスクリプトは、employee_id入力値をスクリプトインクルードに渡します。スクリプトインクルードは、ID を使用して従業員の役職を検索します。タイトルはコールバック関数に提供され、入力フォーム画面にbusiness_title入力を自動入力するために使用されます。

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

スクリプトインクルード。

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