CMDBDuplicateTemplateUtil - 전역

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 7분

    • CMDBDuplicateTemplateUtil 스크립트 포함은 중복 제거 템플릿에서 중복 제거 작업을 추가하고 제거하는 메서드를 제공합니다.

    CI 중복 제거, 중복 제거 작업 및 중복 제거 템플릿에 대한 자세한 내용은 다음 문서를 참조하십시오 Duplicate CIs remediation.

    CMDBDuplicateTemplateUtils - CMDBDuplicateTemplateUtils()

    CMDBDuplicateTemplateUtils 클래스의 인스턴스를 만듭니다.

    표 1. 매개변수
    이름 유형 설명
    없음

    다음 코드 예제에서는 이 메서드를 호출하여 CMDBDuplicateTemplateUtils 개체를 만드는 방법을 보여 줍니다.

    
var dupTemp = new CMDBDuplicateTemplateUtils();

    CMDBDuplicateTemplateUtils - addTasksToTemplate(문자열 templateId, 배열 taskIds)

    지정된 중복 제거 템플릿에 하나 이상의 중복 제거 작업을 추가합니다.

    이 메서드는 기존 템플릿 값을 덮어쓰지만 각 템플릿의 이전 값을 시스템 로그에 기록합니다.

    다음 목록에서는 작업이 템플릿에 추가되지 않은 다음 건너뜀 또는 실패로 표시되는 시나리오를 설명합니다.
    • 지정한 템플릿이 게시됨 상태가 아닙니다. 모든 작업이 건너뜀으로 표시됩니다.
    • 지정된 템플릿이 실행 중입니다. 모든 작업이 건너뜀으로 표시됩니다.
    • 작업이 열림 상태가 아닙니다. 작업이 건너뜀으로 표시됩니다.
    • 작업이 지정된 템플릿과 호환되지 않습니다. 예를 들어, 지정된 템플리트는 Application Server Tomcat에 대해 작성될 수 있지만 지정된 중복 제거 작업은 Linux Server에 대해 작성될 수 있습니다. 작업이 건너뜀으로 표시됩니다.
    • 지정된 템플릿이 없습니다. 모든 작업이 실패로 표시됩니다.
    • 작업의 템플릿 열에 대한 GlideRecord 업데이트가 실패합니다. 작업이 실패로 표시됩니다.
    표 2. 매개변수
    이름 유형 설명
    templateId 문자열 중복 제거 작업과 연결할 중복 제거 템플릿의 Sys_id입니다.
    taskIds 배열 지정된 템플릿과 연결할 중복 제거 작업의 sys_ids 목록입니다.
    표 3. 반환
    유형 설명
    객체 지정된 템플릿과 연결하려고 시도한 모든 작업의 상태를 포함하는 결과 객체입니다.

    데이터 유형: 객체

    {
  "failed": [Array],
  "skipped": [Array],
  "success": [Array],
  "summary": "String"
}
    실패 템플릿과 연결하지 못한 작업 목록입니다.

    데이터 유형: 객체 배열

    "failed": [
  {
    "message": "String",
    "messageType: "String",
    "taskId": "String"
  }
]
    failed.message 작업을 템플릿과 연결하지 못한 이유를 설명하는 메시지입니다.

    데이터 유형: 문자열
    failed.messageType 실패 원인입니다.

    데이터 유형: 문자열
    failed.taskId 템플릿과 연결하지 못한 작업의 Sys_id입니다.

    데이터 유형: 문자열
    건너뜀 실패하지 않았지만 템플릿과 연결되지 않은(건너뜀) 작업 목록입니다.

    데이터 유형: 객체 배열

    "skipped": [
  {
    "message": "String",
    "messageType: "String",
    "taskId": "String"
  }
]
    skipped.message 작업을 건너뛴 이유를 설명하는 메시지입니다.

    데이터 유형: 문자열
    skipped.messageType 작업을 건너뛴 이유입니다.

    데이터 유형: 문자열
    skipped.taskId 템플릿과 관련하여 메서드가 건너뛴 작업의 Sys_id입니다.

    데이터 유형: 문자열
    성공 템플릿과 성공적으로 연결된 작업 목록입니다.

    데이터 유형: 객체 배열

    "success": [
  {
    "message": "String",
    "messageType: "String",
    "taskId": "String"
  }
]
    성공.메시지 현재 사용 중이 아닙니다.

    데이터 유형: 문자열
    success.messageType 현재 사용 중이 아닙니다.

    데이터 유형: 문자열
    success.taskId 템플릿과 연결된 작업의 Sys_id입니다.

    데이터 유형: 문자열
    요약 발생한 전체 처리 오류(예: 지정된 템플릿이 없는 경우)에 대한 간략한 설명입니다.

    데이터 유형: 문자열

    다음 코드 예제에서는 이 메서드를 호출하여 중복 제거 템플릿에 중복 제거 작업을 추가하는 방법을 보여 줍니다.

    // 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)

    지정된 중복 제거 작업 기록에서 중복 제거 템플릿 값을 지웁니다. 이 값을 지우면 템플릿과 작업 간의 연결이 제거됩니다.

    다음 목록에서는 템플릿 값이 작업 기록에서 제거되지 않고 건너뜀 또는 실패로 표시되는 시나리오를 설명합니다.
    • 작업과 연결된 중복 제거 템플릿이 실행 중입니다. 작업이 건너뜀으로 표시됩니다.
    • 작업 상태가 "진행 중"이거나 작업을 찾을 수 없습니다. 작업이 건너뜀으로 표시됩니다.
    • 작업의 템플릿 열에 대한 GlideRecord 업데이트가 실패합니다. 작업이 실패로 표시됩니다.
    표 4. 매개변수
    이름 유형 설명
    taskIds 배열 중복 제거 템플릿 값을 지울 중복 제거 작업 기록의 sys_ids 목록입니다.
    표 5. 반환
    유형 설명
    객체
    템플릿 값 제거가 성공, 건너뜀 또는 실패한 작업 수를 포함하는 결과 객체입니다.
    {
  "failed": Number,
  "success": Number,
  "skipped": Number
}
    실패 중복 제거 템플릿 값을 제거하지 못한 작업 수입니다.

    데이터 유형: 숫자
    성공 중복 제거 템플릿 값을 성공적으로 제거한 작업 수입니다.

    데이터 유형: 숫자
    건너뜀 메서드에서 중복 제거 템플릿 값 제거를 건너뛴 작업 수입니다.

    데이터 유형: 숫자

    다음 코드 예제에서는 이 메서드를 호출하여 중복 제거 작업 기록에서 중복 제거 템플릿 값을 제거하는 방법을 보여줍니다.

    // 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