MobileScriptIncludeCaller - 클라이언트

모바일 UI 규칙 작업에서 스크립트 포함을 호출하는 메서드를 제공합니다.

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

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

스크립트 포함에는 이 API에서 호출할 모바일 호출 가능 필드가 선택되어 있어야 합니다.

MobileScriptIncludeCaller - MobileScriptIncludeCaller(String scriptName, String functionName)

호출할 스크립트 포함 및 함수로 MobileScriptIncludeCaller 클래스의 인스턴스를 만듭니다.

표 1. 매개변수

이름	유형	설명
스크립트 이름	문자열	호출할 모바일 호출 가능 스크립트 포함의 이름입니다. 스크립트 포함이 교차 범위 액세스를 지원하고 클라이언트 스크립트와 다른 범위에 있는 경우 스크립트 포함의 이름에 범위를 프리픽스로 추가해야 합니다.
functionName	문자열	스크립트 포함에서 호출할 공용 함수입니다.

이 예제에서는 UserUtilsTest 스크립트 포함에서 getBusinessTitle() 함수를 호출하는 데 사용할 수 있는 MobileScriptIncludeCaller 클래스의 인스턴스를 만드는 방법을 보여 줍니다.

var caller = new MobileScriptIncludeCaller("UserUtilsTest", "getBusinessTitle");

MobileScriptIncludeCaller - addParam(문자열 키, 객체 값)

스크립트 포함을 호출할 때 전달할 매개변수를 추가합니다.

이 메서드를 사용하면 입력 양식에서 스크립트 포함으로 값을 전달할 수 있습니다.

표 2. 매개변수

이름	유형	설명
키	문자열	매개변수에 사용할 키입니다.
값	객체	매개변수의 값입니다.

표 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입니다.

스크립트 포함에는 이 메서드에서 호출하도록 Mobile 호출 가능 필드가 선택되어 있어야 합니다.

표 4. 매개변수

이름	유형	설명
successCallback	기능	옵션입니다. 서버에서 반환된 결과를 처리하기 위한 콜백 함수의 이름입니다. 콜백 함수가 제공되지 않은 경우 이 메서드는 Promise API를 사용하여 사용할 수 있는 promise를 반환합니다.
오류 콜백	기능	옵션입니다. 오류가 발생할 경우 호출할 콜백 함수의 이름입니다.

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