LeadAPIHelperOOB - 범위 지정됨

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • LeadAPIHelperOOB 스크립트 포함은 리드 REST API에서 호출되는 도우미 메서드를 제공하여 GlideRecord 객체의 리드 기록 세트를 JSON 배열 또는 JSON 객체로 변환하고 리드 객체 내의 필드를 변환하는 등 다양한 기능을 수행합니다.

    이러한 도우미 함수를 사용자 지정하려면 LeadAPIHelper 스크립트 포함에서 이 스크립트 포함의 메서드를 재정의합니다. LeadAPIHelper 스크립트 포함에서 재정의하는 메서드 이름은 LeadAPIHelperOOB 스크립트 포함 파일의 이름과 같아야 합니다.

    이 API는 sn_lead_mgmt_core 네임스페이스 내에서 제공됩니다. API에 액세스하려면 인스턴스에서 리드 관리 데이터 모델(sn_lead_mgmt_core) 플러그인이 활성화되어 있어야 하며 호출 사용자에게 sn_lead_mgmt_core.lead_integrator 역할이 있어야 합니다.

    에 대한 리드 관리자세한 내용은 다음 문서를 참조하십시오 Using Lead Management.

    LeadAPIHelperOOB - getJSONFromGR(GlideRecord gr, 배열 필드)

    GlideRecord 객체를 JSON 객체로 변환합니다. 이 메서드는 GlideRecord의 필드를 반복하고, 해당 유형을 확인하고, 해당 값을 JSON 호환 구조로 적절하게 서식을 지정합니다.

    표 1. 매개변수
    이름 유형 설명
    gr GlideRecord JSON 객체로 변환할 GlideRecord 객체입니다.
    필드 배열 옵션입니다. JSON 객체에 포함할 쉼표로 구분된 필드 이름입니다. 이러한 이름은 리드 기록의 이름과 정확히 일치해야 합니다.
    예: ["계정", "first_name", "do_not_call", "lead_line_items"]
    주:

    매개변수가 fields null이거나 "lead_line_items" 값을 포함하는 경우 메서드는 라인 항목의 모든 필드를 포함하여 연결된 각 라인 항목 기록을 가져옵니다.

    이 방법은 리드 라인 항목 [sn_lead_mgmt_core_lead_line_item] 테이블이 아닌 리드 [sn_lead_mgmt_core_lead] 테이블의 개별 필드 변환만 지원합니다. 리드 라인 항목 테이블에서 특정 필드를 지정하면 무시됩니다.

    기본값: 모든 리드 기록 필드는 JSON 객체에 포함됩니다.
    표 2. 반환
    유형 설명
    JSON 객체 지정된 GlideRecord의 필드를 포함하는 JSON 객체입니다.

    GlideRecord의 각 필드는 키-값 쌍으로 변환됩니다. 참조 필드, 선택 필드, 날짜-시간 필드 및 기타 특정 데이터 유형에 대해 올바른 형식이 지정되도록 특수 처리가 적용됩니다.

    다음 코드 예제는 LeadAPIHelper 스크립트 포함에서 getJsonFromGR() 메서드에 대한 사용자 지정 코드를 추가할 위치를 보여줍니다.

    var LeadAPIHelper = Class.create(); 
LeadAPIHelper.prototype = Object.extendsObject(LeadAPIHelperOOB, {

// Define overriding functions here
getJSONFromGR: function(gr, fields) {

// Add your custom code here
},

type: 'LeadAPIHelper'
});

    LeadAPIHelperOOB - getLeadsJSON(GlideRecord leadsGr, 배열 필드)

    리드 기록 세트를 GlideRecord 객체에서 JSON 배열로 변환합니다. JSON 배열에 포함할 잠재 고객 기록 필드를 지정해야 합니다.

    표 3. 매개변수
    이름 유형 설명
    리드Gr GlideRecord JSON으로 변환할 리드 기록을 포함하는 GlideRecord 객체입니다.

    테이블: 리드 [sn_lead_mgmt-core_lead]
    필드 배열 JSON 객체에 포함할 쉼표로 구분된 필드 이름입니다. 이러한 이름은 리드 기록의 이름과 정확히 일치해야 합니다.
    예: ["계정", "first_name", "do_not_call", "lead_line_items"]
    주:

    매개변수가 fields null이거나 "lead_line_items" 값을 포함하는 경우 메서드는 라인 항목의 모든 필드를 포함하여 연결된 각 라인 항목 기록을 가져옵니다.

    이 방법은 리드 라인 항목 [sn_lead_mgmt_core_lead_line_item] 테이블이 아닌 리드 [sn_lead_mgmt_core_lead] 테이블의 개별 필드 변환만 지원합니다. 리드 라인 항목 테이블에서 특정 필드를 지정하면 무시됩니다.
    표 4. 반환
    유형 설명
    JSON 객체의 배열 각 객체는 지정된 필드가 포함된 잠재 고객을 나타냅니다. 해당하는 경우 모든 리드에 대한 리드 라인 항목 객체의 배열도 포함됩니다.

    GlideRecord의 각 필드는 키-값 쌍으로 변환됩니다. 참조 필드, 선택 필드, 날짜-시간 필드 및 기타 특정 데이터 유형에 대해 올바른 형식이 지정되도록 특수 처리가 적용됩니다.

    다음 코드 예제는 LeadAPIHelper 스크립트 포함에서 getLeadsJson() 메서드에 대한 사용자 지정 코드를 추가할 위치를 보여줍니다.

    var LeadAPIHelper = Class.create();
LeadAPIHelper.prototype = Object.extendsObject(LeadAPIHelperOOB, { 

// Define overriding functions here 
getLeadsJson: function(leadsGR, fields) {

// Add your custom code here
}, 

type: 'LeadAPIHelper' 
});

    LeadAPIHelperOOB - getTransformedLeadObject(Object leadObject)

    지정된 리드 객체를 변환합니다.

    이 변환에는 다음이 포함됩니다.
    • 무시된 필드를 제거하는 중입니다.
    • 참조 필드를 sys_id 같은 관련 값으로 변환합니다.
    • 작업 메모 텍스트를 쉼표로 구분된 문자열로 결합합니다.
    • 계정, 접촉 창구 및 소비자 필드의 유효성 확인 계정과 소비자 모두에 값이 포함된 경우 계정, 접촉 창구 및 소비자의 값은 무시됩니다.
    표 5. 매개변수
    이름 유형 설명
    리드 객체 객체 변환할 리드 객체입니다. 이 객체에는 리드 및 관련 리드 라인 항목에 대한 상세 정보가 포함됩니다.
    표 6. 반환
    유형 설명
    객체 변환된 리드 객체입니다.

    다음 코드 예제는 LeadAPIHelper 스크립트 포함에서 getTransformedLeadObject() 메서드에 대한 사용자 지정 코드를 추가할 위치를 보여줍니다.

    var LeadAPIHelper = Class.create();

LeadAPIHelper.prototype = Object.extendsObject(LeadAPIHelperOOB, {

// Define overriding functions here 
getTransformedLeadObject: function(leadObject) { 

// Add your custom code here
}, 

type: 'LeadAPIHelper'
});