---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# MobileScriptIncludeCaller :クライアント

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

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

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

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

モバイル UI ルールアクションの \[クライアントスクリプト \] フィールドでこの API を使用します。この API の正しい設定でモバイル UI ルールアクションを構成する手順については、「 [Configure auto-fill inputs on input form screens](https://www.servicenow.com/docs/access?context=config-autofil-inputs-nptfrmscrn&version=australia&pubname=australia-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(文字列キー, オブジェクト値) {#ariaid-title3}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| key | 文字列 | パラメーターに使用するキー。 |
| value | オブジェクト | パラメーターの値。 |
[表 : 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}

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