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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# m_form - 클라이언트

# m_form - 클라이언트 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](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/GRE26xBS7GN1FZpPUqa_gw#MobileScriptInclCallerClientAPI "모바일 UI 규칙 작업에서 스크립트 포함을 호출하는 메서드를 제공합니다.") 함께 사용하여 입력 양식 화면의 입력을 자동으로 채울 수 있습니다. 입력 양식 화면에 대한 자세한 내용은 을 참조하십시오 [Input form screen](https://www.servicenow.com/docs/access?context=parameter-input-screen&version=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-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(문자열 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}

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

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 입력 이름 | 문자열 | 값을 설정할 입력의 이름입니다. |
| 값 | 객체 | 입력을 설정할 값입니다. 값의 데이터 유형은 설정되는 입력에 따라 달라집니다. |
| 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}  
이 예제에서는 order 입력에 대한 정수 값을 설정합니다.

    m_form.setValue("order", 5);

이 예제에서는 설명 입력에 대한 문자열 값을 설정합니다.

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

이 예제에서는 값과 표시 값이 포함된 개체를 사용하여 참조 유형 입력을 설정합니다.

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