모든 기회 가져오기 사용자 지정 작업

모든 기회 가져오기 작업은 Salesforce 애플리케이션에서 기회 기록을 검색합니다. 이 작업은 원격 기회 테이블을 볼 때 호출됩니다.

작업 입력

모든 기회 가져오기 작업은 쿼리에 의해 반환될 최대 기록 수를 식별하는 단일 정수 매개변수를 사용합니다. REST 기반 작업은 페이지 매김을 수용할 수 없으므로 외부 공급업체 애플리케이션에서 반환되는 기록 수를 제한하는 것이 중요합니다. 원격 테이블에는 1,000개가 넘는 기록을 배치하지 않는 것이 좋습니다. 기본 기록 수는 500입니다.

전처리 단계

전처리 스크립트 단계는 작업 입력을 고유한 것으로 수용합니다.

전처리 스크립트는 허용되는 최대 기록 수로 제한되는 모든 기회에 대해 SELECT 쿼리를 만듭니다. 이 쿼리는 Salesforce 객체 쿼리 언어(SOQL)를 기반으로 합니다.

(function execute(inputs, outputs) {
  
  outputs.query = "query/?q=SELECT+Name,Id,AccountId,CloseDate,Amount,” +
                  “StageName,Probability,Type+FROM+Opportunity”;

  outputs.query = outputs.query +
                  “+LIMIT+” + inputs.max_number_of_opportunity_records; 
  
})(inputs, outputs);

관심 있는 기회 기록의 필드를 지정해야 합니다. 이 예시에서는 이름, Id, 계정 Id, 종결 날짜, 금액, 단계 이름, 확률 필드를 사용합니다. 사용 가능한 필드의 전체 목록을 보려면 기회 필드 가져오기 작업을 사용하십시오.

ORDERED BY 키워드와 ASC 또는 DESC 순서 방향 값을 추가하여 쿼리 검색의 순서를 제어할 수도 있습니다. 예를 들어, 스크립트에서 LIMIT를 지정하는 줄 앞에 다음 줄을 추가할 수 있습니다. 그러면 쿼리가 가장 최근 종결 날짜로 처음 500개 기록을 반환합니다.

outputs.query = outputs.query + “+ORDERED+BY+CloseDate+DESC”;

전처리 출력이 쿼리입니다.

REST 단계

REST 단계는 Salesforce 스포크 REST 기반 작업의 표준 REST 단계입니다. 변경할 필요는 없습니다. 올바른 연결 별칭을 가리켜야 합니다.

후처리 단계

후처리 스크립트 단계는 작업 입력과 REST 단계 출력을 입력으로 수용합니다.

후처리 스크립트는 쿼리 응답에 오류가 있는지 확인하고, 필요한 경우 오류 메시지를 설정하고, 응답 본문에서 기회 데이터를 추출하고, 기록 수 제한으로 인해 Salesforce에서 모든 데이터가 검색되지는 않았음을 나타내는 정보 메시지를 작성합니다.

(function execute(inputs, outputs) {

  try{
    var response = JSON.parse(inputs.res_body);
  } catch(e) {
    outputs = errorHandler(inputs, outputs);
  }


  function createOutputJson(inputs, outputs) {
    try{
      outputs.records = { data: response.records };
      outputs.status = "Success";

      if ( outputs.records.data.length ==   
           inputs.max_number_of_opportunity_records ) {
        outputs.info_message = "Opportunity retrieve operation was “ +
                               “limited to" +
                               inputs.max_number_of_opportunity_records +
                               " records.";
      }      
    } catch(e) {
      outputs = errorHandler(inputs, outputs);
    }
    return outputs;
  }


  function errorHandler(inputs, outputs) {
    outputs.status = "Error";
    outputs.error_message = "Unknown Error. “ + 
                            “Please check error log for more information";

    if(inputs.res_body.contains("message"))
      outputs.error_message = response[0].message;

    return outputs;
  }

  if(inputs.status_code == "200")
    outputs = createOutputJson(inputs, outputs);
  else
    outputs = errorHandler(inputs, outputs);

})(inputs, outputs);

다음은 후처리 단계의 출력입니다.

작업 출력

작업 출력은 쿼리 상태, 오류, 정보 메시지, 기회 기록으로 구성됩니다. 작업 출력은 앞의 스크린샷을 참조하십시오.