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. 매개변수

이름	유형	설명
scriptName	문자열	호출할 모바일 호출 가능 스크립트 포함의 이름입니다. 스크립트 포함이 교차 범위 액세스를 지원하고 클라이언트 스크립트와 다른 범위에 있는 경우 스크립트 포함의 이름 앞에 범위를 지정해야 합니다.
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 - 호출(함수 successCallback, 함수 errorCallback)

생성자에 의해 지정된 스크립트 포함을 호출합니다.

서버 호출은 비동기적으로 실행되고 스크립트 포함의 응답은 콜백 함수에 전달됩니다. 서버의 응답이 실패하는 경우(예: 스크립트 포함을 찾을 수 없는 경우) 콜백에 전달된 응답 인수가 비어 있거나 null입니다.

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

표 4. 매개변수

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

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