MobileScriptIncludeCaller :クライアント

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

この API を m_form :クライアント API とともに使用して、入力フォーム画面に入力を自動入力できます。 入力フォーム画面の詳細については、「 Input form screen」を参照してください。

モバイル UI ルールアクションの [クライアントスクリプト ] フィールドでこの API を使用します。この API の正しい設定でモバイル UI ルールアクションを構成する手順については、「 Configure auto-fill inputs on input form screens」を参照してください。

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

MobileScriptIncludeCaller - MobileScriptIncludeCaller(文字列 scriptName, 文字列 functionName)

スクリプトインクルードと呼び出す関数を使用して、 MobileScriptIncludeCaller クラスのインスタンスを作成します。

表 : 1. パラメーター

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

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

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

MobileScriptIncludeCaller - addParam(文字列キー, オブジェクト値)

スクリプトインクルードを呼び出すときに渡すパラメーターを追加します。

このメソッドを使用すると、入力フォームからスクリプトインクルードに値を渡すことができます。

表 : 2. パラメーター

名前	タイプ	説明
キー	文字列	パラメーターに使用するキー。
値	オブジェクト	パラメーターの値。

表 : 3. 戻り値

タイプ	説明
なし

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

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

MobileScriptIncludeCaller - call(関数 successCallback, 関数 errorCallback)

コンストラクターによって指定されたスクリプトインクルードを呼び出します。

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

スクリプトインクルードでは、このメソッドで呼び出すモバイル コール可能 フィールドを選択する必要があります。

表 : 4. パラメーター

名前	タイプ	説明
successCallback	関数	オプション。サーバーから返された結果を処理するコールバック関数の名前。 コールバック関数が提供されていない場合、このメソッドは Promise API を使用して使用できる Promise を返します。
エラーコールバック	関数	オプション。エラーが発生した場合に呼び出すコールバック関数の名前。

表 : 5. 戻り値

タイプ	説明
なし

このクライアントスクリプトは、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' 
});