--- 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 --- # LeadAPIProcessUtilOOB - 범위 지정됨 # LeadAPIProcessUtilOOB - 범위 지정됨 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 10분 LeadAPIProcessUtilOOB 스크립트 포함은 리드 기록 및 연결된 리드 라인 항목 기록을 검색하기 위해 리드 REST API에서 호출되는 메서드를 제공합니다. 메서드가 호출될 때 [리드 API](https://servicenow-prod.fluidtopics.net/IUUGPPwaUh1DqkyKbc7vGA#lead-api "리드 API는 인스턴스에서 마케팅 리드 및 연결된 리드 라인 항목을 생성, 업데이트 및 쿼리/검색할 수 있는 엔드포인트를 제공합니다.") 리드 레코드를 검색하는 방법을 사용자 지정하려면 LeadAPIProcessUtil 스크립트 포함에서 이 스크립트 포함의 메서드를 재정의합니다. LeadAPIProcessUtil 스크립트 포함에서 재정의하는 메서드 이름은 LeadAPIProcessUtilOOB 스크립트 포함 파일의 이름과 같아야 합니다. 이 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). ## LeadAPIProcessUtilOOB - processCreateLead(객체 requestBody) {#ariaid-title2} 요청 본문을 처리하고 전달된 매개변수를 기반으로 리드 및 연결된 모든 라인 항목을 생성합니다. 기록은 다음 테이블에 삽입됩니다. * 리드 \[sn_lead_mgmt_core_lead\] * 리드 라인 항목 \[sn_lead_mgmt_core_lead_line_item\] {#LAPU-processCreateLead_O__table_sxx_crr_ydc__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | requestBody | 객체 | 생성할 리드 및 관련 리드 라인 항목의 본문을 요청합니다. 이 객체의 내용에 대한 자세한 내용은 다음 문서를 참조하십시오 [리드 - POST /sn_lead_mgmt_core/lead](https://servicenow-prod.fluidtopics.net/IUUGPPwaUh1DqkyKbc7vGA#lead-POST-lead "지정된 매개변수를 사용하여 리드 기록 및 연결된 리드 라인 항목을 생성합니다."). | [표 1. 매개변수] {#LAPU-processCreateLead_O__table_sxx_crr_ydc} {#LAPU-processCreateLead_O__table_txx_crr_ydc__entry__2} | 유형 | 설명 | |-|-| | JSON 객체 | 저장된 리드 및 리드 라인 항목 기록의 상세 정보입니다. 데이터 유형: 객체 { "body": {Object}, "status": "String" } | | \.body | 응답 본문. 성공적인 응답: 요청된 리드 기록 내의 모든 필드와 연결된 리드 라인 항목 기록의 모든 필드입니다. 반환되는 필드에 대한 설명은 다음 문서를 [리드 - POST /sn_lead_mgmt_core/lead](https://servicenow-prod.fluidtopics.net/IUUGPPwaUh1DqkyKbc7vGA#lead-POST-lead "지정된 매개변수를 사용하여 리드 기록 및 연결된 리드 라인 항목을 생성합니다.")참조하십시오. 오류 응답: 요청을 처리하려고 할 때 탐지된 오류 목록입니다. 이러한 오류 메시지는 LeadAPIConstants 스크립트 포함에 정의되어 있습니다. 데이터 유형: 객체 | | \.status | 응답 상태 코드입니다. 이러한 상태 코드는 LeadAPIConstants 스크립트 포함에 정의되어 있습니다. 데이터 유형: 문자열 | [표 2. 반환] {#LAPU-processCreateLead_O__table_txx_crr_ydc} 다음 코드 예제에서는 LeadAPIProcessUtil 스크립트 포함에서 processCreateLead() 메서드에 대한 사용자 지정 코드를 추가할 위치를 보여 줍니다. var LeadAPIProcessUtil = Class.create(); LeadAPIProcessUtil.prototype = Object.extendsObject(LeadAPIProcessUtilOOB, { // Define overriding functions here processCreateLead: function(requestBody) { // Add your custom code }, type: 'LeadAPIProcessUtil' }); ## LeadAPIProcessUtilOOB - processGetAllLeads(객체 queryParams, 문자열 requestUrl) {#ariaid-title3} 전달된 필터 기준에 따라 모든 리드 기록과 연결된 라인 항목 기록을 검색합니다. 이 메서드는 연결된 기록 내의 모든 필드를 반환합니다. 기록 상세 정보는 다음 테이블에서 가져옵니다. * 리드 \[sn_lead_mgmt_core_lead\] * 리드 라인 항목 \[sn_lead_mgmt_core_lead_line_item\] {#LAPU-processGetAllLeads_O_S__table_igt_klr_ydc__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | queryParams | 객체 | 리드 기록을 검색할 때 적용할 쿼리 매개변수가 포함된 객체입니다. 엔드포인트에 전달된 쿼리 매개변수입니다.[리드 - GET /sn_lead_mgmt_core/lead](https://servicenow-prod.fluidtopics.net/IUUGPPwaUh1DqkyKbc7vGA#lead-GET-lead "쿼리 매개변수에 전달된 필터 기준에 따라 모든 리드 및 연결된 리드 라인 항목을 검색합니다.") 예: { "sysparm_fields":["first_name,last_name,sys_id,lead_line_items"], "sysparm_query":["lead_type=new_business"], "sysparm_offset":["2"],"sysparm_limit":["25"] } | | requestUrl | 문자열 | 요청 URL입니다. 메서드에 응답의 모든 페이지에 대한 링크가 있도록 페이지 매김된 응답을 처리할 때 이 URL을 전달합니다. | [표 3. 매개변수] {#LAPU-processGetAllLeads_O_S__table_igt_klr_ydc} {#LAPU-processGetAllLeads_O_S__table_jgt_klr_ydc__entry__2} | 유형 | 설명 | |-|-| | JSON 객체 | 요청된 리드 및 리드 라인 항목 기록의 상세 정보입니다. 데이터 유형: 객체 { "body": [Array], "contentRange": "String", "links": "String", "status": "String", "totalCount": "Number" } 요청을 처리하는 동안 오류가 발생하면 JSON 객체에는 `본문` 및 `상태` 매개변수만 포함됩니다. | | \.body | 응답 본문. 성공적인 응답: 리드 기록과 연결된 모든 리드 라인 항목 기록을 포함하는 각 객체가 있는 객체의 배열입니다. 요청된 리드 기록 내의 모든 필드와 연결된 리드 라인 항목 기록의 모든 필드가 반환됩니다. 반환되는 필드에 대한 설명은 다음 문서를 [리드 - GET /sn_lead_mgmt_core/lead](https://servicenow-prod.fluidtopics.net/IUUGPPwaUh1DqkyKbc7vGA#lead-GET-lead "쿼리 매개변수에 전달된 필터 기준에 따라 모든 리드 및 연결된 리드 라인 항목을 검색합니다.")참조하십시오. 오류 응답: 요청을 처리하려고 할 때 탐지된 오류 목록입니다. 이러한 오류 메시지는 LeadAPIConstants 스크립트 포함에 정의되어 있습니다. 데이터 유형: 객체 배열 | | \.contentRange | 페이지 매김된 호출에서 반환되는 콘텐츠의 범위입니다. 예: 오프셋=2 및 limit=3인 경우 이 매개변수의 값은 항목 3-5입니다. 데이터 유형: 문자열 | | \.links | 페이지 매김된 응답의 경우 응답에 포함된 각 페이지에 대한 쉼표로 구분된 링크입니다. 예: ;rel="self", ;rel="last", ;rel="next" 데이터 유형: 문자열 | | \.status | 응답 상태 코드입니다. 이러한 상태 코드는 LeadAPIConstants 스크립트 포함에 정의되어 있습니다. 데이터 유형: 문자열 | | \.totalCount | 메서드에서 반환한 리드 기록의 총 수입니다. 데이터 유형: 숫자(정수) | [표 4. 반환] {#LAPU-processGetAllLeads_O_S__table_jgt_klr_ydc} 다음 코드 예제에서는 LeadAPIProcessUtil 스크립트 포함에서 processGetAllLeads() 메서드에 대한 사용자 지정 코드를 추가할 위치를 보여 줍니다. var LeadAPIProcessUtil = Class.create(); LeadAPIProcessUtil.prototype = Object.extendsObject(LeadAPIProcessUtilOOB, { // Define overriding functions here processGetAllLeads: function(queryParams, requestUrl) { // Add your custom code here }, type: 'LeadAPIProcessUtil' }); ## LeadAPIProcessUtilOOB - processGetLeadById(문자열 ID) {#ariaid-title4} 지정된 리드 기록과 관련 라인 항목 기록을 조회합니다. 이 메서드는 연결된 기록 내의 모든 필드를 반환합니다. 기록 상세 정보는 다음 테이블에서 가져옵니다. * 리드 \[sn_lead_mgmt_core_lead\] * 리드 라인 항목 \[sn_lead_mgmt_core_lead_line_item\] {#LAPU-processGetLeadById_S__table_fvz_qcl_ydc__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | ID | 문자열 | 검색할 리드 기록의 Sys_id입니다. 테이블: 리드 \[sn_lead_mgmt_core_lead\] | [표 5. 매개변수] {#LAPU-processGetLeadById_S__table_fvz_qcl_ydc} {#LAPU-processGetLeadById_S__table_gvz_qcl_ydc__entry__2} | 유형 | 설명 | |-|-| | JSON 객체 | 요청된 리드 및 리드 라인 항목 기록의 상세 정보입니다. 데이터 유형: 객체 { "body": {Object}, "status": "String" } | | \.body | 응답 본문. 성공적인 응답: 요청된 리드 기록 내의 모든 필드와 연결된 리드 라인 항목 기록의 모든 필드입니다. 반환되는 필드에 대한 설명은 다음 문서를 [리드 - GET /sn_lead_mgmt_core/lead/{sys_id}](https://servicenow-prod.fluidtopics.net/IUUGPPwaUh1DqkyKbc7vGA#lead-GET-lead-sys_id "지정된 sys_id에 대한 리드 기록 및 연결된 모든 리드 라인 항목을 반환합니다.")참조하십시오. 오류 응답: 요청을 처리하려고 할 때 탐지된 오류 목록입니다. 이러한 오류 메시지는 LeadAPIConstants 스크립트 포함에 정의되어 있습니다. 데이터 유형: 객체 | | \.status | 응답 상태 코드입니다. 이러한 상태 코드는 LeadAPIConstants 스크립트 포함에 정의되어 있습니다. 데이터 유형: 문자열 | [표 6. 반환] {#LAPU-processGetLeadById_S__table_gvz_qcl_ydc} 다음 코드 예제에서는 LeadAPIProcessUtil 스크립트 포함에서 processGetLeadById() 메서드에 대한 사용자 지정 코드를 추가할 위치를 보여 줍니다. var LeadAPIProcessUtil = Class.create(); LeadAPIProcessUtil.prototype = Object.extendsObject(LeadAPIProcessUtilOOB, { // Define overriding functions here processGetLeadById: function(id) { // Add your custom code here }, type: 'LeadAPIProcessUtil' }); ## LeadAPIProcessUtilOOB - processUpdateLead(객체 requestBody, 문자열 ID) {#ariaid-title5} 요청 본문을 처리하고 전달된 매개변수를 기반으로 지정된 리드와 연결된 모든 라인 항목을 업데이트합니다. 기록은 다음 테이블에서 업데이트됩니다. * 리드 \[sn_lead_mgmt_core_lead\] * 리드 라인 항목 \[sn_lead_mgmt_core_lead_line_item\] {#LAPU-processUpdateLead_O_S__table_n24_k5r_ydc__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | requestBody | 객체 | 업데이트할 리드 및 관련 리드 라인 항목 필드의 본문을 요청합니다. 이 객체의 내용에 대한 자세한 내용은 다음 문서를 참조하십시오 [lead - PATCH /sn_lead_mgmt_core/lead/{sys_id}](https://servicenow-prod.fluidtopics.net/IUUGPPwaUh1DqkyKbc7vGA#lead-PATCH-lead "지정된 리드 기록과 연결된 리드 라인 항목을 업데이트합니다. 이 엔드포인트를 사용하여 새 리드 라인 항목을 지정된 리드에 연결할 수도 있습니다."). | | ID | 문자열 | 업데이트할 리드 기록의 Sys_id입니다. 테이블: 리드 \[sn_lead_mgmt_core_lead\] | [표 7. 매개변수] {#LAPU-processUpdateLead_O_S__table_n24_k5r_ydc} {#LAPU-processUpdateLead_O_S__table_o24_k5r_ydc__entry__2} | 유형 | 설명 | |-|-| | JSON 객체 | 저장된 리드 및 리드 라인 항목 기록의 상세 정보입니다. 데이터 유형: 객체 { "body": {Object}, "status": "String" } | | \.body | 응답 본문. 성공적인 응답: 업데이트된 리드 기록의 모든 필드와 연결된 리드 라인 항목 기록의 모든 필드(업데이트 여부)입니다. 반환되는 필드에 대한 설명은 다음 문서를 [lead - PATCH /sn_lead_mgmt_core/lead/{sys_id}](https://servicenow-prod.fluidtopics.net/IUUGPPwaUh1DqkyKbc7vGA#lead-PATCH-lead "지정된 리드 기록과 연결된 리드 라인 항목을 업데이트합니다. 이 엔드포인트를 사용하여 새 리드 라인 항목을 지정된 리드에 연결할 수도 있습니다.")참조하십시오. 오류 응답: 요청을 처리하려고 할 때 탐지된 오류 목록입니다. 이러한 오류 메시지는 LeadAPIConstants 스크립트 포함에 정의되어 있습니다. 데이터 유형: 객체 | | \.status | 응답 상태 코드입니다. 이러한 상태 코드는 LeadAPIConstants 스크립트 포함에 정의되어 있습니다. 데이터 유형: 문자열 | [표 8. 반환] {#LAPU-processUpdateLead_O_S__table_o24_k5r_ydc} 다음 코드 예제에서는 LeadAPIProcessUtil 스크립트 포함에서 processUpdateLead() 메서드에 대한 사용자 지정 코드를 추가할 위치를 보여 줍니다. var LeadAPIProcessUtil = Class.create(); LeadAPIProcessUtil.prototype = Object.extendsObject(LeadAPIProcessUtilOOB, { // Define overriding functions here processUpdateLead: function(requestBody, id) { // Add your custom code here }, type: 'LeadAPIProcessUtil' });