MobileScriptIncludeCaller - クライアント

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

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

この API は、モバイル UI ルールアクションの [クライアントスクリプト ] フィールドで使用します。この 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(文字列 key, オブジェクト値)

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

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

表 : 2. パラメーター

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

表 : 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. パラメーター

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

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