--- 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 --- # CMDBDuplicateTemplateUtil - 전역 # CMDBDuplicateTemplateUtil - 전역 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 7분 CMDBDuplicateTemplateUtil 스크립트 포함은 중복 제거 템플릿에 중복 제거 작업을 추가하거나 제거하는 메서드를 제공합니다. CI의 중복 제거, 중복 제거 작업 및 중복 제거 템플릿에 대한 자세한 내용은 다음 문서를 참조하십시오 [Duplicate CIs remediation](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). ## CMDBDuplicateTemplateUtils - CMDBDuplicateTemplateUtils() {#ariaid-title2} CMDBDuplicateTemplateUtils 클래스의 인스턴스를 만듭니다. {#CDupTempU-CMDBDupTemplateUtils__table_bhp_st5_xxb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 없음 | | | [표 1. 매개변수] {#CDupTempU-CMDBDupTemplateUtils__table_bhp_st5_xxb} 다음 코드 예제에서는 이 메서드를 호출하여 CMDBDuplicateTemplateUtils 개체를 만드는 방법을 보여 줍니다. var dupTemp = new CMDBDuplicateTemplateUtils(); ## CMDBDuplicateTemplateUtils - addTasksToTemplate(String templateId, 배열 taskIds) {#ariaid-title3} 지정된 중복 제거 템플릿에 하나 이상의 중복 제거 작업을 추가합니다. 이 메서드는 기존 템플릿 값을 덮어쓰지만 각 템플릿의 이전 값을 시스템 로그에 기록합니다. 다음 목록에서는 작업이 템플릿에 추가되지 않은 다음 건너뜀 또는 실패로 표시되는 시나리오를 설명합니다. * 지정한 템플릿이 게시됨 상태가 아닙니다. 모든 작업이 건너뜀으로 표시됩니다. * 지정된 템플릿이 실행 중입니다. 모든 작업이 건너뜀으로 표시됩니다. * 작업이 열림 상태가 아닙니다. 작업이 건너뜀으로 표시됩니다. * 작업이 지정된 템플릿과 호환되지 않습니다. 예를 들어, 지정된 템플릿이 애플리케이션 서버 Tomcat용으로 생성될 수 있지만 지정된 중복 제거 작업은 Linux 서버에 대해 생성됩니다. 작업이 건너뜀으로 표시됩니다. * 지정된 템플릿이 없습니다. 모든 작업이 실패로 표시됩니다. * 작업의 템플릿 열에 대한 GlideRecord 업데이트가 실패합니다. 작업이 실패로 표시됩니다. {#CDupTempU-addTasksToTemplate_S_A__ul_b45_fmh_yxb} {#CDupTempU-addTasksToTemplate_S_A__table_tch_4y5_xxb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | templateId | 문자열 | 중복 제거 작업과 연결할 중복 제거 템플릿의 Sys_id입니다. | | taskIds | 배열 | 지정된 템플릿과 연결할 중복 제거 작업 sys_ids 목록입니다. | [표 2. 매개변수] {#CDupTempU-addTasksToTemplate_S_A__table_tch_4y5_xxb} {#CDupTempU-addTasksToTemplate_S_A__table_uch_4y5_xxb__entry__2} | 유형 | 설명 | |-|-| | 객체 | 지정된 템플릿과 연결하려고 시도한 모든 작업의 상태를 포함하는 결과 객체입니다. 데이터 유형: 객체 { "failed": [Array], "skipped": [Array], "success": [Array], "summary": "String" } | | 실패 | 템플릿과 연결하지 못한 작업 목록입니다. 데이터 유형: 객체 배열 "failed": [ { "message": "String", "messageType: "String", "taskId": "String" } ] | | 실패.메시지 | 작업을 템플릿과 연결하지 못한 이유를 설명하는 메시지입니다. 데이터 유형: 문자열 | | failed.messageType | 실패의 원인입니다. 데이터 유형: 문자열 | | 실패.taskId | 템플릿과 연결하지 못한 작업의 Sys_id입니다. 데이터 유형: 문자열 | | 건너뜀 | 실패하지 않았지만 템플릿과 연결되지 않은 작업 목록입니다(건너뜀). 데이터 유형: 객체 배열 "skipped": [ { "message": "String", "messageType: "String", "taskId": "String" } ] | | 건너뜀.메시지 | 작업을 건너뛰었던 이유를 설명하는 메시지입니다. 데이터 유형: 문자열 | | skipped.messageType | 작업을 건너뜀 이유. 데이터 유형: 문자열 | | 건너뜀.taskId | 메서드가 건너뛴 작업의 Sys_id 템플릿과 연결된 작업입니다. 데이터 유형: 문자열 | | 성공 | 템플릿과 성공적으로 연결된 작업 목록입니다. 데이터 유형: 객체 배열 "success": [ { "message": "String", "messageType: "String", "taskId": "String" } ] | | 성공.메시지 | 현재 사용 중이 아닙니다. 데이터 유형: 문자열 | | success.messageType | 현재 사용 중이 아닙니다. 데이터 유형: 문자열 | | success.taskId | 템플릿과 연결된 작업의 Sys_id입니다. 데이터 유형: 문자열 | | 요약 | 발생한 전체 처리 오류에 대한 간략한 설명입니다(예: 지정된 템플릿이 없는 경우). 데이터 유형: 문자열 | [표 3. 반환] {#CDupTempU-addTasksToTemplate_S_A__table_uch_4y5_xxb} 다음 코드 예제에서는 이 메서드를 호출하여 중복 제거 템플릿에 중복 제거 작업을 추가하는 방법을 보여 줍니다. // Add tasks to template var taskIds = []; taskIds.push("96d2d25113152200eef2dd828144b0a4"); taskIds.push("f785a2c3d7012201de92a5f75e610398"); taskIds.push("635dd3dbc128ce0100655f1ec66ed41d"); var result = new CMDBDuplicateTemplateUtils().addTasksToTemplate("6b43105c37301000deeabfc8bcbe5db2", taskIds); ); gs.info('Success: ' + result.success); gs.info('Failed: ' + result.failed); gs.info('Skipped: ' + result.skipped); gs.info(Summary: ' + result.summary); 출력: Success: [ { "taskId": "f785a2c3d7012201de92a5f75e610398", "message": "", "messageType": "" } ] Failed: [ { "taskId": "96d2d25113152200eef2dd828144b0a4", "message": "Failed to add task 96d2d25113152200eef2dd828144b0a4 to template 6b43105c37301000deeabfc8bcbe5db2 because there were update errors.", "messageType": "update_failed" } ] Skipped: [ { "taskId": "635dd3dbc128ce0100655f1ec66ed41d", "message": "Cannot add de-duplication task(s) to template 6b43105c37301000deeabfc8bcbe5db2 because the template is not published. Publish the template before adding tasks.", "messageType": "unpublished_template" } ] Summary: ## CMDBDuplicateTemplateUtils - removeTemplateFromTask(배열 taskIds) {#ariaid-title4} 지정된 중복 제거 작업 기록에서 중복 제거 템플릿 값을 지웁니다. 이 값을 지우면 템플릿과 작업 간의 연결이 제거됩니다. 다음 목록에서는 템플릿 값이 작업 기록에서 제거되지 않고 건너뜀 또는 실패로 표시되는 시나리오를 설명합니다. * 작업과 연결된 중복 제거 템플릿이 실행 중입니다. 작업이 건너뜀으로 표시됩니다. * 작업 상태가 "진행 중"이거나 작업을 찾을 수 없습니다. 작업이 건너뜀으로 표시됩니다. * 작업의 템플릿 열에 대한 GlideRecord 업데이트가 실패합니다. 작업이 실패로 표시됩니다. {#CDupTempU-removeTemplateFromTasks_A__table_pn5_g3v_xxb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | taskIds | 배열 | 중복 제거 템플릿 값을 지울 중복 제거 작업 기록의 sys_ids 목록입니다. | [표 4. 매개변수] {#CDupTempU-removeTemplateFromTasks_A__table_pn5_g3v_xxb} {#CDupTempU-removeTemplateFromTasks_A__table_qn5_g3v_xxb__entry__2} | 유형 | 설명 | |-|-| | 객체 | 템플릿 값 제거가 성공했거나 건너뜀 또는 실패한 작업의 수를 포함하는 결과 객체입니다. { "failed": Number, "success": Number, "skipped": Number } | | 실패 | 중복 제거 템플릿 값을 제거하지 못한 작업 수입니다. 데이터 유형: 숫자 | | 성공 | 중복 제거 템플릿 값을 성공적으로 제거한 작업 수입니다. 데이터 유형: 숫자 | | 건너뜀 | 메서드가 중복 제거 템플릿 값을 제거하면서 건너뛴 작업 수입니다. 데이터 유형: 숫자 | [표 5. 반환] {#CDupTempU-removeTemplateFromTasks_A__table_qn5_g3v_xxb} 다음 코드 예제에서는 이 메서드를 호출하여 중복 제거 작업 기록에서 중복 제거 템플릿 값을 제거하는 방법을 보여 줍니다. // Remove tasks from template var taskIds = []; taskIds.push("96d2d25113152200eef2dd828144b0a4"); taskIds.push("f785a2c3d7012201de92a5f75e610398"); taskIds.push("635dd3dbc128ce0100655f1ec66ed41d"); var result = new CMDBDuplicateTemplateUtils().removeTemplateFromTasks(taskIds); ); gs.info('Success: ' + result.success); gs.info('Failed: ' + result.failed); gs.info('Skipped: ' + result.skipped); 출력: Success: 2 Failed: 0 Skipped: 1