MobileScriptIncludeCaller - 클라이언트

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분
  • 모바일 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 - call(Function successCallback, Function 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' 
    });