---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# LeadAPIHelperOOB - 범위 지정됨

# LeadAPIHelperOOB - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 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](https://www.servicenow.com/docs/access?context=lead-management-using&version=australia&pubname=australia-order-management&ft:locale=en-US).

## LeadAPIHelperOOB - getJSONFromGR(GlideRecord gr, 배열 필드) {#ariaid-title2}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 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 객체에 포함됩니다. |
[표 1. 매개변수]

{#LAH-getJSONFromGR_GR_A__table_wfp_p1z_ydc} {#LAH-getJSONFromGR_GR_A__table_xfp_p1z_ydc__entry__2}

| 유형 | 설명 |
|-|-|
| JSON 객체 | 지정된 GlideRecord의 필드를 포함하는 JSON 객체입니다. GlideRecord의 각 필드는 키-값 쌍으로 변환됩니다. 참조 필드, 선택 필드, 날짜-시간 필드 및 기타 특정 데이터 유형에 대해 올바른 형식이 지정되도록 특수 처리가 적용됩니다. |
[표 2. 반환]

{#LAH-getJSONFromGR_GR_A__table_xfp_p1z_ydc}  
다음 코드 예제는 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, 배열 필드) {#ariaid-title3}

리드 기록 세트를 GlideRecord 객체에서 JSON 배열로 변환합니다. JSON 배열에 포함할 잠재 고객 기록 필드를 지정해야 합니다.
{#LAH-getLeadsJSON_GR_A__table_d41_qvy_ydc__entry__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\] 테이블의 개별 필드 변환만 지원합니다. 리드 라인 항목 테이블에서 특정 필드를 지정하면 무시됩니다. |
[표 3. 매개변수]

{#LAH-getLeadsJSON_GR_A__table_d41_qvy_ydc} {#LAH-getLeadsJSON_GR_A__table_e41_qvy_ydc__entry__2}

| 유형 | 설명 |
|-|-|
| JSON 객체의 배열 | 각 객체는 지정된 필드가 포함된 잠재 고객을 나타냅니다. 해당하는 경우 모든 리드에 대한 리드 라인 항목 객체의 배열도 포함됩니다. GlideRecord의 각 필드는 키-값 쌍으로 변환됩니다. 참조 필드, 선택 필드, 날짜-시간 필드 및 기타 특정 데이터 유형에 대해 올바른 형식이 지정되도록 특수 처리가 적용됩니다. |
[표 4. 반환]

{#LAH-getLeadsJSON_GR_A__table_e41_qvy_ydc}  
다음 코드 예제는 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) {#ariaid-title4}

지정된 리드 객체를 변환합니다.
이 변환에는 다음이 포함됩니다.

* 무시된 필드를 제거하는 중입니다.
* 참조 필드를 sys_id 같은 관련 값으로 변환합니다.
* 작업 메모 텍스트를 쉼표로 구분된 문자열로 결합합니다.
* 계정, 접촉 창구 및 소비자 필드의 유효성 확인 계정과 소비자 모두에 값이 포함된 경우 계정, 접촉 창구 및 소비자의 값은 무시됩니다.
{#LAH-getTransformedLeadObject_O__ul_oyl_lxq_12c}
{#LAH-getTransformedLeadObject_O__table_vpc_l2z_ydc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 리드 객체 | 객체 | 변환할 리드 객체입니다. 이 객체에는 리드 및 관련 리드 라인 항목에 대한 상세 정보가 포함됩니다. |
[표 5. 매개변수]

{#LAH-getTransformedLeadObject_O__table_vpc_l2z_ydc} {#LAH-getTransformedLeadObject_O__table_wpc_l2z_ydc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 변환된 리드 객체입니다. |
[표 6. 반환]

{#LAH-getTransformedLeadObject_O__table_wpc_l2z_ydc}  
다음 코드 예제는 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'
    });