---
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


---

# m_form :クライアント

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

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

入力フォーム画面で入力値を取得および設定するメソッド、およびメッセージを表示するメソッドを提供します。  
この API は、次の入力タイプをサポートしています。

* ブーリアン
* 選択肢
* 日付/時刻
* 番号
* 参照
* 文字列
{#m_formClientAPI__ul_hqy_jnl_ccc}

この API を [MobileScriptIncludeCaller :クライアント](https://servicenow-prod.fluidtopics.net/frd6luCXeRxKHe0Nj3l9Lg#MobileScriptInclCallerClientAPI "モバイル UI ルールアクションからスクリプトインクルードを呼び出すメソッドを提供します。") 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)」を参照してください。

## m_form:addErrorMessage(文字列メッセージ) {#ariaid-title2}

入力フォーム画面の上部にエラーメッセージを表示します。
{#mform-addErrorMessage_S__table_g3q_js2_mbc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| message | 文字列 | 表示するメッセージ。 |
[表 : 1. パラメーター]

{#mform-addErrorMessage_S__table_g3q_js2_mbc} {#mform-addErrorMessage_S__table_h3q_js2_mbc__entry__2}

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

{#mform-addErrorMessage_S__table_h3q_js2_mbc}  
この例では、優先度に入力された値に応じて、情報メッセージまたはエラーメッセージがフォームに表示されます。

    // Client script in a Mobile UI Rule Action
    function onChange(inputName, newValue) { 
       var priority = newValue; 
       if (priority > 0 && priority < 3) { 
          getMessage("This incident should be handled ASAP", function(response){ 
             m_form.addInfoMessage(response); 
          }); 
       } else { 
          getMessage("The selected priority is invalid", function(response){ 
             m_form.addErrorMessage(response); 
          }); 
       }	 
    }

## m_form:addInfoMessage(文字列メッセージ) {#ariaid-title3}

入力フォーム画面の上部に情報メッセージを表示します。
{#mform-addInfoMessage_S__table_ofb_3s2_mbc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| message | 文字列 | 表示するメッセージ。 |
[表 : 3. パラメーター]

{#mform-addInfoMessage_S__table_ofb_3s2_mbc} {#mform-addInfoMessage_S__table_pfb_3s2_mbc__entry__2}

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

{#mform-addInfoMessage_S__table_pfb_3s2_mbc}  
この例では、優先度に入力された値に応じて、情報メッセージまたはエラーメッセージがフォームに表示されます。

    // Client script in a Mobile UI Rule Action
    function onChange(inputName, newValue) { 
       var priority = newValue; 
       if (priority > 0 && priority < 3) { 
          getMessage("This incident should be handled ASAP", function(response){ 
             m_form.addInfoMessage(response); 
          }); 
       } else { 
          getMessage("The selected priority is invalid", function(response){ 
             m_form.addErrorMessage(response); 
          }); 
       }	 
    }

## m_form:getValue(文字列 inputName) {#ariaid-title4}

入力フォーム画面で指定された入力の値を返します。
{#mform-getValue_S__table_lpp_tr2_mbc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 入力名 | 文字列 | 値を返す入力の名前。 |
[表 : 5. パラメーター]

{#mform-getValue_S__table_lpp_tr2_mbc} {#mform-getValue_S__table_mpp_tr2_mbc__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 指定された入力の値。 注: 入力が複数選択の選択リストの場合、戻り値の型は、選択した値を含む文字列のアレイです。 |
[表 : 6. 返される内容]

{#mform-getValue_S__table_mpp_tr2_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' 
    });

## m_form:setAffectedInputs(アレイ inputNames) {#ariaid-title5}

指定された入力に、値がスクリプトによって設定されていることを示すきらめく効果を追加します。
きらめき効果は、入力の値が設定されると終了します。
{#mform-setAffectedInputs_O__table_d1p_ms2_mbc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| inputName | アレイ | シマー効果を適用する入力の名前を含む文字列のアレイ。 |
[表 : 7. パラメーター]

{#mform-setAffectedInputs_O__table_d1p_ms2_mbc} {#mform-setAffectedInputs_O__table_e1p_ms2_mbc__entry__2}

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

{#mform-setAffectedInputs_O__table_e1p_ms2_mbc}  
このクライアントスクリプトは、発信者入力にシマー効果を追加して、自動入力されることを示します。

    // Client script in a Mobile UI Rule Action
    function onChange(inputName, newValue) { 
       var affectedInputs = []; 
       affectedInputs.push("Caller"); 
       m_form.setAffectedInputs(affectedInputs); 
       m_form.setValue("Caller", ["800b174138d089c868d09de320f9833b", "46d44a23a9fe19810012d100cca80666"]); 
       var result = m_form.getValue("Caller"); 
       console.log(`Ref test: ${result[0]}`); 
    }

## m_form:setValue(文字列 inputName, オブジェクト値, 文字列 displayValue) {#ariaid-title6}

入力フォーム画面で指定された入力の値を設定します。
{#mform-setValue_S_S_S__table_tp1_wr2_mbc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 入力名 | 文字列 | 値を設定する入力の名前。 |
| value | オブジェクト | 入力を設定する値。 値のデータタイプは、設定されている入力によって異なります。 |
| displayValue | 文字列 | オプション。このパラメーターは、参照タイプ入力の値を設定するときに使用します。 |
[表 : 9. パラメーター]

{#mform-setValue_S_S_S__table_tp1_wr2_mbc} {#mform-setValue_S_S_S__table_up1_wr2_mbc__entry__2}

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

{#mform-setValue_S_S_S__table_up1_wr2_mbc}  
この例では、順序入力に整数値を設定します。

    m_form.setValue("order", 5);

この例では、説明入力の文字列値を設定します。

    m_form.setValue("description", "This is the description content");

この例では、値と表示値を含むオブジェクトを使用して、参照タイプ入力を設定します。

    m_form.setValue("Caller", [{"value":"800b174138d089c868d09de320f9833b", "displayValue":"Abel Tuter"}]);