---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

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를 API와 함께 [MobileScriptIncludeCaller - 클라이언트](https://servicenow-prod.fluidtopics.net/uTlORNSm2OcWmbAM3vZUhw#MobileScriptInclCallerClientAPI "모바일 UI 규칙 작업에서 스크립트 포함을 호출하는 메서드를 제공합니다.") 사용하여 입력 양식 화면에서 입력을 자동으로 채울 수 있습니다. 입력 양식 화면에 대한 자세한 내용은 다음 문서를 참조하십시오 [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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 | 문자열 | 표시할 메시지입니다. |
[표 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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 | 문자열 | 표시할 메시지입니다. |
[표 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(String inputName) {#ariaid-title4}

입력 양식 화면에서 지정된 입력의 값을 반환합니다.
{#mform-getValue_S__table_lpp_tr2_mbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| inputName | 문자열 | 값을 반환할 입력의 이름입니다. |
[표 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}

| 이름 | 유형 | 설명 |
|-|-|-|
| inputNames | 배열 | 쉬머 효과를 적용할 입력의 이름을 포함하는 문자열의 배열입니다. |
[표 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(String inputName, 객체 값, 문자열 displayValue) {#ariaid-title6}

입력 양식 화면에서 지정된 입력의 값을 설정합니다.
{#mform-setValue_S_S_S__table_tp1_wr2_mbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| inputName | 문자열 | 값을 설정할 입력의 이름입니다. |
| 값 | 객체 | 입력을 설정할 값입니다. 값의 데이터 유형은 설정되는 입력에 따라 달라집니다. |
| 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"}]);