m_form - 클라이언트

입력 양식 화면에서 입력 값을 가져오고 설정하고 메시지를 표시하는 메서드를 제공합니다.

이 API는 다음 입력 유형을 지원합니다.

• 부울
• 선택
• 날짜/시간
• 번호
• 참조
• 문자열

이 API는 API와 MobileScriptIncludeCaller - 클라이언트 함께 사용하여 입력 양식 화면의 입력을 자동으로 채울 수 있습니다. 입력 양식 화면에 대한 자세한 내용은 을 참조하십시오 Input form screen.

모바일 UI 규칙 작업의 클라이언트 스크립트 필드에 이 API를 사용합니다. 이 API에 대한 올바른 설정을 사용하여 모바일 UI 규칙 작업을 구성하는 방법에 대한 지침은 을 참조하십시오 Configure auto-fill inputs on input form screens.

m_form - addErrorMessage(문자열 메시지)

입력 양식 화면 상단에 오류 메시지를 표시합니다.

표 1. 매개변수

이름	유형	설명
메시지	문자열	표시할 메시지입니다.

표 2. 반환

유형	설명
없음

이 예에서는 우선순위에 입력한 값에 따라 정보 또는 오류 메시지가 양식에 표시됩니다.

// 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(문자열 메시지)

입력 양식 화면 상단에 정보 메시지를 표시합니다.

표 3. 매개변수

이름	유형	설명
메시지	문자열	표시할 메시지입니다.

표 4. 반환

유형	설명
없음

이 예에서는 우선순위에 입력한 값에 따라 정보 또는 오류 메시지가 양식에 표시됩니다.

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

입력 양식 화면에서 지정된 입력 값을 반환합니다.

표 5. 매개변수

이름	유형	설명
입력 이름	문자열	값을 반환할 입력의 이름입니다.

표 6. 반환

유형	설명
문자열	지정된 입력의 값입니다. 주: 입력이 다중 선택이 있는 선택 목록인 경우 반환 유형은 선택한 값을 포함하는 문자열의 배열입니다.

이 클라이언트 스크립트는 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)

값이 스크립트에 의해 설정되고 있음을 나타내는 지정된 입력에 반짝이는 효과를 추가합니다.

쉬머링 효과는 입력 값이 설정되면 종료됩니다.

표 7. 매개변수

이름	유형	설명
입력 이름	배열	쉬머 효과를 적용할 입력 이름을 포함하는 문자열 배열입니다.

표 8. 반환

유형	설명
없음

이 클라이언트 스크립트는 호출자 입력에 쉬머 효과를 추가하여 자동으로 채워짐을 나타냅니다.

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

입력 양식 화면에서 지정된 입력 값을 설정합니다.

표 9. 매개변수

이름	유형	설명
입력 이름	문자열	값을 설정할 입력의 이름입니다.
값	객체	입력을 설정할 값입니다. 값의 데이터 유형은 설정되는 입력에 따라 달라집니다.
displayValue	문자열	옵션입니다. 참조 유형 입력의 값을 설정할 때 이 매개변수를 사용합니다.

표 10. 반환

유형	설명
없음

이 예제에서는 order 입력에 대한 정수 값을 설정합니다.

m_form.setValue("order", 5);

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

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

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

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