기회 테이블을 쿼리하는 예시 스크립트

이 예시에서는 모든 기회 가져오기, 계정 Id에 대한 기회 가져오기 및 기회 세부 정보 가져오기 사용자 지정 작업을 사용하여 기회 테이블을 쿼리합니다.

예시 스크립트는 다음 세 부분으로 구성되어 있습니다.

1. 첫 번째 부분에서는 올바른 사용자 지정 작업을 선택하고 입력을 준비합니다.
2. 두 번째 부분에서는 작업을 호출합니다.
3. 세 번째 부분에서는 작업의 출력을 처리합니다.

스포크 작업 선택 및 입력 준비

이 스크립트 섹션에서는 Salesforce 애플리케이션에서 기회를 가져오기 위해 준비한 세 가지 사용자 지정 작업 중 하나를 선택합니다.

• 모든 기회 가져오기
• 계정 ID에 대한 기회 가져오기
• 기회 세부 정보 가져오기

v_query 함수 인수에 포함된 매개변수를 기반으로 호출할 작업을 결정할 수 있습니다.

/****** Choose action and prepare action inputs *****/
var action = null;
var inputs = {};

// look up opportunity by salesforce record id
if (v_query.isGet()) {

  action = "get_opportunity_details";
  inputs.salesforce_opportunity_record_id = v_query.getSysId();
      

// look up opportunities by salesforce account id
} else if (v_query.getParameter("u_sf_account_id")) {

    if (v_query.getParameter("u_sf_account_id") == "undefined") {
      gs.addInfoMessage(“Opportunities cannot be retrieved because “ +
                        “this “Account does not have associated “    +
                        “Salesforce Account. Please contact System “ +
                         “Administrator.");
      return;

    } else {
      action = "get_opportunities_for_account_id";
      inputs.salesforce_account_id = v_query.getParameter("u_sf_account_id");
    }

// look up all opportunities
} else {
  action = "get_all_opportunities";
}

이 스크립트는 Salesforce 계정이 작업에 필요할 때 정의되지 않은 경우 정보 메시지를 구성합니다. 정의되지 않은 값은 관련 목록을 사용하여 고객 계정과 Salesforce 기회 간 연결 만들기에 설명된 관계에서 비롯됩니다.

Salesforce 계정이 정의되어 있지 않으면 이 케이스에 쿼리할 것이 없으며, 함수는 스포크 작업을 호출하지 않고 반환됩니다.

스포크 작업 호출

이 스크립트 섹션에서는 Salesforce 스포크 이름과 선택한 작업을 사용하여 작업을 호출하고 호출의 출력을 저장합니다.

/***** Call action *****/
var outputs =
        sn_fd.FlowAPI.executeAction("sn_salesforce_spok." + action, inputs);

작업 출력 처리

스크립트의 이 섹션에서는 오류 검사로 시작하는 출력을 처리합니다.

/***** Process action outputs *****/
if (outputs.status != "Success") {
throw new Error(outputs.error_message);
}

쿼리가 오류를 반환하지 않으면 스크립트가 반환된 기록을 처리하여 원격 테이블에 행으로 추가해야 합니다. Salesforce 기회 필드를 원격 테이블 열에 매핑합니다.

var opportunities = outputs.opportunities.data;

 for (var i = 0; i < opportunities.length; i++) {
  var opportunity = opportunities[i];
  v_table.addRow({
    "u_sf_amount": opportunity.Amount,
    "u_sf_close_date": opportunity.CloseDate,
    "u_sf_name": opportunity.Name,
    "u_sf_probability": opportunity.Probability + "%",
    "u_sf_account_id": opportunity.AccountId,
    "u_sf_stage": opportunity.StageName,
    “u_sf_type": opportunity.Type,
    "sys_id": opportunity.Id,
  });
}

Salesforce 기회 기록 Id가 원격 테이블 sys_id에 할당됩니다. 이렇게 하면 원격 테이블의 목록과 양식이 제대로 작동하고, 다음에 원격 테이블 스크립트가 호출될 때 v_query.getSysId()를 사용하여 기록 Id를 추출할 수 있게 됩니다.

그런 다음 쿼리에 의해 통과되면 정보 메시지를 표시합니다.

if (outputs.info_message) {
  gs.addInfoMessage(outputs.info_message);
}

원격 테이블 스크립트 섹션을 함께 배치

스크립트의 세 개 섹션은 try-catch 블록에 포함되어 오류 처리를 제공합니다.

(function executeQuery(v_table, v_query) {

  try {

    // place code here from: <Selecting a spoke action and preparing the inputs>

    // place code here from: <Calling the spoke action>

    // place code here from: <Processing the action output>  	
        
  } catch (error) {
    gs.addErrorMessage("Error retrieving  Salesforce Opportunities. “ +
                       “Please contact System Administrator.");
    gs.addErrorMessage("System Error: " + error.message);
  }

})(v_table, v_query);