IdentificationEngineScriptableApi - 전역

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기158분

    • IdentificationEngineScriptableApi는 식별 및 조정 프레임워크를 사용하여 중복 구성 항목(CI) 생성을 최소화하고, .구성 관리 데이터베이스(CMDB)

    IdentificationEngineScriptableApi - createOrUpdateCI(문자열 소스, 문자열 입력)

    식별 및 조정 규칙에 따라 CI(구성 항목) 및 비구성 관리 데이터베이스(CMDB) CI(cmdb_ci에서 확장되지 않는 클래스) CMDB 를 삽입하거나 업데이트합니다. 직접 업데이트하는 대신 이 API를 CMDB 사용합니다.

    비CMDB CI를 IRE 페이로드의 조회 또는 관련 항목으로 전달해야 합니다. 비 CMDB 테이블 수집에 대한 자세한 내용은 을 참조하십시오 IRE support for non-CMDB tables.

    표 1. 매개변수
    이름 유형 설명
    입력 문자열 필수 입력 페이로드. 추가하거나 업데이트할 구성 항목의 JSON 형식 문자열입니다. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    입력.항목 배열 추가하거나 업데이트할 항목을 정의하는 객체의 배열입니다.
    "items": [
  { 
    "className": "String",
    "display_values": {Object},
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server 같은 클래스 CMDB /테이블일 수 있습니다.
    input.items.display_values 객체 이름-값 쌍으로 이 관련 항목에 대해 만들거나 업데이트할 참조 필드입니다. 여기서 이름은 필드 이름이고 값은 참조된 표시 값입니다. 참조 필드에 표시 값 대신 sys_id 사용하려면 이 매개변수 대신 매개변수에 input.items.lookup.values 정보를 전달합니다.

    참조 필드 이름은 다음과 같이 사용자가 선택한 필드에 따라 다릅니다.

    "display_values": {
  "model_id": "String",
  "location": "String"
}
    input.items.internal_id 문자열 연결된 페이로드의 고유 항목 식별자입니다.

    이 값은 어떤 값이든 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.lookup 배열 조회(조회 기반 식별)를 포함하는 최상위 항목을 식별합니다. 이러한 기록은 다시 cmdb_ci에 대한 참조가 있는 조회 테이블을 기반으로 구성 항목을 식별하는 데 사용됩니다.

    예:

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.lookup.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_serial_number 또는 cmdb_ci_network_adapter 같은 클래스 CMDB /테이블이 될 수 있습니다.
    input.items.lookup.internal_id 문자열 연결된 페이로드의 고유 항목 식별자입니다.

    이 값은 어떤 값이든 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.lookup.sys_object_source_info 객체 특정 소스의 고유한 CI 식별자입니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.lookup.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.lookup.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.lookup.sys_object_source_info.source_native_key 문자열 원본에서 항목의 고유 키/ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.lookup.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜 및 시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.lookup.values 객체 이 관련 항목에 대해 생성하거나 업데이트할 필드(이름은 필드 이름)입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다. 참조 필드에 sys_id 대신 표시 값을 사용하려면 객체 대신 values 객체에 display_values 이 정보를 전달합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    입력.항목.관련 배열 관련 목록이 포함된 최상위 항목에 대한 참조입니다. 관련 항목 [cmdb_related_entry]의 규칙은 이 배열에 포함될 수 있는 기록 유형을 정의합니다. 이러한 기록은 식별 중인 CI에 대한 참조가 있는 관련 테이블을 기반으로 항목을 추가하는 데 사용됩니다.

    관련 테이블은 cmdb_ci 확장되거나 확장되지 않을 수 있습니다. 이러한 기록은 구성 항목을 식별하는 데 사용되지 않습니다.

    "related" [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.related.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_software_instance 또는 cmdb_key_value와 같은 클래스 CMDB /테이블일 수 있습니다.
    input.items.related.internal_id 문자열 연결된 페이로드의 고유 항목 식별자입니다.

    이 값은 어떤 값이든 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.related.sys_object_source_info 객체 특정 소스의 고유한 CI 식별자입니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.related.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.related.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.related.sys_object_source_info.source_native_key 문자열 원본에서 항목의 고유 키/ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.related.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜 및 시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.related.values 객체 이 관련 항목에 대해 생성하거나 업데이트할 필드(이름은 필드 이름)입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다. 참조 필드에 sys_id 대신 표시 값을 사용하려면 객체 대신 values 객체에 display_values 이 정보를 전달합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    입력.항목.설정 객체 허용되는 업데이트 유형을 정의하는 매개변수입니다.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.skipReclassificationRestrictionRules 부울 IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙을 실행해서는 안 되는지를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 규칙 실행을 건너뜁니다.
    • false: 규칙을 실행합니다.

    기본값: false
    input.items.settings.updateWithoutDowngrade 부울 이 항목에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 다운그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 다운그레이드가 모두 허용됩니다.

    기본값: false
    input.items.settings.updateWithoutUpgrade 부울 이 항목에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 업그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 업그레이드가 모두 허용됩니다.

    기본값: false
    input.items.settings.updateWithoutSwitch 부울 항목을 업데이트하고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 클래스 전환이 허용되지 않습니다.
    • false: 항목 업데이트와 클래스 전환이 모두 허용됩니다.

    기본값: false
    input.items.sys_object_source_info 객체 특정 소스의 고유한 CI 식별자입니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.sys_object_source_info.source_native_key 문자열 원본에서 항목의 고유 키/ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜 및 시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.values 객체 이 관련 항목에 대해 생성하거나 업데이트할 필드(이름은 필드 이름)입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다. 참조 필드에 sys_id 대신 표시 값을 사용하려면 객체 대신 values 객체에 display_values 이 정보를 전달합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.referenceItems 배열 입력 페이로드의 항목 간 참조를 정의하는 객체의 배열입니다. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced 문자열 internal_id 다른 항목에서 참조하는 항목에 대해 정의되었습니다.
    input.referenceItems.referencedBy 문자열 internal_id 다른 항목을 참조하는 항목에 대해 정의되었습니다.
    input.referenceItems.referenceField 문자열 항목의 클래스/테이블에 있는 referencedBy 참조 필드의 이름입니다.
    입력.관계 배열 입력 페이로드의 항목 간 관계를 지정하는 객체의 배열입니다.
    이 배열의 개체는 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 payload items 배열의 항목 인덱스를 나타내는 값을 사용하여 두 최상위 항목(전용) parentchild 및 이름-값 쌍 간의 관계를 정의할 수 있습니다.
      "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    • 객체는 두 항목(최상위 항목, 관련 항목 또는 조회 항목 사용 parent_id ) 및 child_id 키/값 쌍을 포함하여 이러한 항목에 대해 정의된 값을 나타내는 internal_id 값으로 두 항목 간의 관계를 정의할 수 있습니다.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.relations.child 번호 관계(items, items.related 또는 items.lookup)에서 하위 항목을 나타내는 배열 내 items CI 객체의 정수 인덱스입니다.
    input.relations.child_id 문자열 관계 internal_id 의 하위 항목(items, items.related 또는 items.lookup)입니다.
    input.relations.parent 번호 배열에 있는 items 상위 항목의 정수 인덱스(items, items.related 또는 items.lookup)
    input.relations.parent_id 문자열 internal_id 관계에서 상위 항목(items, items.related 또는 items.lookup)입니다.
    input.relations.sys_rel_source_info 객체 관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스 [sys_rel_source] 테이블에 저장됩니다(identifyCIEnhanced() 또는 identifyCI() 메서드에 대해 유지 되지 않음).

    데이터 유형: 객체

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    input.relations.sys_rel_source_info.source_name 문자열 검색 소스 이름입니다.

    기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
    input.relations.sys_rel_source_info.source_feed 문자열 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다.

    기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 작성할 때 source_feed 열에 저장됩니다.
    input.relations.type 문자열 상위 항목과 하위 항목 간에 존재하는 관계 유형입니다. 이는 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다.
    source 문자열 CI 정보의 데이터 소스를 식별합니다. 이 값은 cmdb_ci 테이블의 discovery_source 필드에 정의된 선택 값 중 하나여야 합니다.
    표 2. 반환
    유형 설명
    <문자열> 입력 문자열의 구성 항목에 대한 결과 목록인 JSON 형식의 문자열입니다. 각 결과 문자열은 'items: [{}], relations:[{}]' 형식이며, 항목 및 관계 목록 내의 각 항목에는 이름-값 쌍이 포함됩니다.

    데이터 유형: 문자열
    <String>.additionalCommittedItems 현재 반환된 값이 없습니다.
    <String>.additionalCommittedRelations 현재 반환된 값이 없습니다.
    <String>.items 생성되거나 업데이트된 CI를 설명하는 객체 목록입니다.

    데이터 유형: 배열

    "items": { 
  "additionalRelatedItems": [Array],
  "className": "String",
  "duplicateIndices": [Array],
  "errorCount": Number,
  "errors": [Array],
  "identificationAttempts": [Array],
  "identifierEntrySysId": "String",
  "info": [Array],
  "inputIndices": [Array],
  "maskedAttributes": [Array],
  "operation": "String",
  "relatedItems": [Array],
  "relatedSysIds": [Array],
  "sysId": "String"
}
    <String>.items.additionalRelatedItems 처리되었지만 입력 페이로드의 일부로 제공되지 않은 추가 조회 및 관련 항목에 대한 정보를 제공하는 JSON 객체 목록입니다. 이러한 항목은 부분 페이로드에서 가져온 것입니다.

    이 정보는 현재 반환되지 않습니다.

    데이터 유형: 배열

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.additionalRelatedItems.className 작성되거나 업데이트된 CI의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    <String>.items.additionalRelatedItems.inputIndices 해당 입력 항목의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 항목 또는 조회 항목의 경우 JSON 객체의 목록입니다.

    데이터 유형: 숫자 배열 또는 객체 배열

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <문자열>.items.additionalRelatedItems.inputIndices.mainIndex 추가 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    <String>.items.additionalRelatedItems.inputIndices.subIndex 추가 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    <String>.items.additionalRelatedItems.operation 작업 유형입니다.

    가능한 값:

    • INSERT: 새 CI가 데이터베이스에 삽입되었습니다.
    • NO_CHANGE: CI가 변경되지 않았습니다.
    • 업데이트 : 기존 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    <String>.items.additionalRelatedItems.sysId 추가 관련 항목의 Sys_id입니다.

    데이터 유형: 문자열
    <String>.items.className 작성되거나 업데이트된 CI의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    <String>.items.duplicateIndices 현재 항목과 중복되는 CI의 인덱스 목록입니다.

    데이터 유형: 배열
    <String>.items.errorCount 오류 수입니다.

    데이터 유형: 숫자
    <String>.items.errors 각 객체가 이 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <문자열>.items.errors.error CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    <String>.items.errors.message 오류와 관련된 오류 메시지입니다.

    데이터 유형: 문자열
    <String>.items.identificationAttempts CI를 식별하기 위해 시도한 목록입니다.

    데이터 유형: 배열

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <String>.items.identificationAttempts.attemptResult CI를 식별하려는 시도의 결과입니다.

    가능한 값:

    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    <String>.items.identificationAttempts.attributes 식별 프로세스 중에 사용된 CI 식별자 항목 속성 목록입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.items.identificationAttempts.hybridEntryCiAttributes 현재 반환된 값이 없습니다.
    <String>.items.identificationAttempts.identifierName 이 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    <String>.items.identificationAttempts.searchOnTable 식별 프로세스 중에 검색되는 테이블의 이름입니다.

    데이터 유형: 문자열
    <String>.items.identifierEntrySysId CI를 식별하는 데 사용되는 식별자 규칙에 대한 Sys_id입니다. 식별자 항목 [cmdb_identifier_entry] 테이블에 있습니다.

    데이터 유형: 문자열
    <문자열>.items.info 항목 처리에 대한 추가 정보가 들어 있는 객체의 목록입니다.

    데이터 유형: 배열

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    <문자열>.items.info.code 건너뛴 재분류 유형입니다.
    가능한 값:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    데이터 유형: 문자열
    <String>.items.info.message 재분류를 건너뛰는 이유에 대한 추가 통찰력을 제공하는 메시지입니다.

    데이터 유형: 문자열
    <String>.items.info.ruleSysId 일치하는 재분류 제한 규칙의 Sys_id입니다. 재분류 제한 규칙으로 인해 IRE가 재분류를 건너뛸 때만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛸 경우 이 값은 비어 있습니다.

    데이터 유형: 문자열
    <String>.items.inputIndices 이 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값입니다.

    데이터 유형: 배열
    <String>.items.maskedAttributes 조정 규칙에 정의된 대로 신뢰할 수 없는 데이터 소스에 의한 업데이트를 건너뛴 속성 목록입니다.

    데이터 유형: 배열
    <String>.items.relatedItems 처리된 관련 항목에 대한 정보를 제공하는 JSON 객체의 목록입니다.

    데이터 유형: 배열

    "relatedItems": [
  { 
    "className": "String",
    "errors": [Array],
    "errorCount": Number, 
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.relatedItems.className 관련 항목의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    <String>.items.relatedItems.errors 처리 중에 발생한 오류 목록입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.errorCount 처리 중에 탐지된 오류 수입니다.

    데이터 유형: 숫자
    <String>.items.relatedItems.inputIndices 해당 관련 항목의 인덱스입니다.

    데이터 유형: 배열 또는 숫자

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.relatedItems.inputIndices.mainIndex 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 정수 값입니다.

    데이터 유형: 숫자
    <문자열>.items.relatedItems.inputIndices.subIndex 관련 항목에 해당하는 요청 본문 items.lookup 배열의 정수 값입니다.

    데이터 유형: 숫자
    <String>.items.relatedItems.operation 작업 유형입니다.

    가능한 값:

    • INSERT: 새 CI가 데이터베이스에 삽입되었습니다.
    • NO_CHANGE: CI가 변경되지 않았습니다.
    • 업데이트 : 기존 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    <String>.items.relatedSysIds 요청 본문 items.lookup 배열에서 관련 항목(테이블 조회 항목)에 대한 sys_id 값 목록입니다.

    주목할 만한 값 - null: 이 관련 항목에 대해 식별된 sys_id 없습니다.

    데이터 유형: 배열
    <문자열>.items.sys_id 업데이트되거나 생성된 CI의 Sys_id입니다.

    데이터 유형: 문자열
    <문자열>.관계 처리된 관계에 대한 정보를 제공하는 JSON 객체의 목록입니다.

    데이터 유형: 배열

    "relations":[
  { 
    "className": "String",
    "errorCount": Number,
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String" 
  }
]
    <String>.relations.className 이 종속 관계 CI의 Sys_class_name입니다.

    지원되는 값만: cmdb_rel_ci: CI 관계 테이블.

    데이터 유형: 문자열
    <String>.relations.errorCount 오류 수입니다.

    데이터 유형: 숫자
    <String>.relations.inputIndices 해당 입력 관계의 인덱스입니다.

    데이터 유형: 배열
    <String>.relations.operation 수행된 작업의 유형입니다.

    가능한 값:

    • 삽입
    • 업데이트
    • NO_CHANGE

    데이터 유형: 문자열
    <String>.relations.sysId 종속 관계 CI의 Sys_id입니다.

    데이터 유형: 문자열

    다음은 구성 항목을 재분류하는 방법입니다.

    var payload = {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "values": {
        "short_description": "Linux server description",
        "name": "Linux Server 1"
      }
    }
  ]
};
var input = new JSON().encode(payload);
var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCI('ServiceNow', input);
gs.print(output);

    출력:

    {
  "items": [
    {
      "className": "cmdb_ci_linux_server",
      "operation": "NO_CHANGE",
      "sysId": "440577800f321010150efc91ff767e94",
      "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "MATCHED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        }
      ],
      "info": [
        {
          "message": "CI Reclassification not allowed from class: [cmdb_ci_linux_server] to [cmdb_ci_win_server] by a reclassification restriction rule",
          "code": "SKIPPED_CLASS_SWITCH",
          "ruleSysId": "b3d4b3800f321010150efc91ff767eab"
        }
      ],
      "errorCount": 0,
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": []
    }
  ],
  "additionalCommittedItems": [],
  "relations": [],
  "additionalCommittedRelations": []
}
    var payload = {
"items": [
{
 "className": "cmdb_ci_win_server", 
 "values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],

    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {  
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },

  "related": [
    {
      "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }}]}, 
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },

  "internal_id": "tomcat_id"
  }],

"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],

"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};

var jsonUntil = new JSON();
var input = jsonUntil.encode(payload);
var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCI('ServiceNow', input);
gs.print(output);

    출력:

    {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "operation": "INSERT",
      "sysId": "d56ab6eadbd510102f67dfea5e96194e",
      "relatedSysIds": [
        "dd6af62adb1910102f67dfea5e96197f",
        "996af62adb1910102f67dfea5e961980"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "dd6af62adb1910102f67dfea5e96197f",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "className": "cmdb_serial_number"
        },
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "996af62adb1910102f67dfea5e961980",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "className": "cmdb_serial_number"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source NO_MATCH",
          "identifierName": "",
          "attemptResult": "NO_MATCH",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    },
    {
      "className": "cmdb_ci_spkg",
      "operation": "INSERT",
      "sysId": "116af62adb1910102f67dfea5e961981",
      "relatedSysIds": [
        "6d6af62adb1910102f67dfea5e961984"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "6d6af62adb1910102f67dfea5e961984",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 0
            }
          ],
          "className": "cmdb_software_instance"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Software",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "key"
          ],
          "searchOnTable": "cmdb_ci_spkg",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ]
    },
    {
      "className": "cmdb_ci_app_server_tomcat",
      "operation": "INSERT",
      "sysId": "e96af62adb1910102f67dfea5e961985",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        2
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "sysId": "e96af62adb1910102f67dfea5e961989",
      "identifierEntrySysId": "Unknown",
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedRelations": []
}

    종속 CI를 식별합니다.

    var payload = 
              {items: [ 
                    {className:'cmdb_ci_web_server', 
                     values: {name:'apache linux den 200', 
                              running_process_command: 'xyz',  
                              running_process_key_parameters: 'abc', 
                              tcp_port:'3452'}}, 
                    {className:'cmdb_ci_linux_server', 
                     values: {name:'lnux100', ram:'2048'}}],
               relations:[{parent: 0, child: 1, type: 'Runs on::Runs'}]
              };

var jsonUntil = new JSON();
var input = jsonUntil.encode(payload);
var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCI('ServiceWatch', input);
gs.print(output);

    출력:

    {
  "items": [
    {
      "className": "cmdb_ci_web_server",
      "operation": "INSERT",
      "sysId": "b9bb766adb1910102f67dfea5e961962",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    },
    {
      "className": "cmdb_ci_linux_server",
      "operation": "INSERT",
      "sysId": "a5bb766adb1910102f67dfea5e96195b",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "sysId": "fdbb766adb1910102f67dfea5e961964",
      "identifierEntrySysId": "Unknown",
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedRelations": []
}

    조회 기반 식별을 통해 독립적인 CI를 식별합니다.

    var payload = {items: [
 {className:'cmdb_ci_netgear', 
   values: {name:'ny8500-nbxs08',
            ports:'1200'}, 
   lookup: [{className:'cmdb_serial_number',
             values:{serial_number:'1234ABCD', serial_number_type:'uuid',absent:'false',valid:'true'}},
            {className:'cmdb_serial_number',
             values:{serial_number:'3456EFGH', serial_number_type:'system',absent:'false',valid:'true'}}]}]};

var jsonUntil = new JSON();
var input = jsonUntil.encode(payload);
var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCI('ServiceNow', input);
gs.print(output);

    출력:

    {
  "items": [
    {
      "className": "cmdb_ci_netgear",
      "operation": "INSERT",
      "sysId": "787c7e6adb1910102f67dfea5e96196e",
      "relatedSysIds": [
        "f47c7e6adb1910102f67dfea5e961977",
        "3c7c7e6adb1910102f67dfea5e961977"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "f47c7e6adb1910102f67dfea5e961977",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "className": "cmdb_serial_number"
        },
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "3c7c7e6adb1910102f67dfea5e961977",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "className": "cmdb_serial_number"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [],
  "additionalCommittedRelations": []
}

    범위가 지정된 등가

    범위가 지정된 애플리케이션에서 createOrUpdateCI(String source, String input) 메서드를 사용하려면 해당 범위가 지정된 IdentificationEngine 메서드인 createOrUpdateCI(String source, String input)를 사용합니다.

    IdentificationEngineScriptableApi - createOrUpdateCIEnhanced(문자열 소스, 문자열 입력, 객체 옵션)

    식별 및 조정 규칙에 따라 CI(구성 항목) 및 비구성 관리 데이터베이스(CMDB) CI(cmdb_ci에서 확장되지 않는 클래스) CMDB 를 삽입하거나 업데이트합니다. 직접 업데이트하는 대신 이 API를 CMDB 사용합니다.

    비CMDB CI를 IRE 페이로드의 조회 또는 관련 항목으로 전달해야 합니다. 비 CMDB 테이블 수집에 대한 자세한 내용은 을 참조하십시오 IRE support for non-CMDB tables.

    createOrUpdateCI() 메서드의 기능을 제공하는 것 외에도 이 메서드는 다음을 지원합니다.
    • 부분 페이로드 처리
    • 부분 커밋 처리
    • 페이로드 내에서 중복 항목 제거
    • 출력 요약 작성 중
    IRE에 대한 자세한 내용과 이 메서드에서 사용하는 데이터에 대한 자세한 설명은 IRE(식별 및 조정)를 참조하세요.

    비 CMDB 테이블 수집에 대한 자세한 내용은 을 참조하십시오 IRE support for non-CMDB tables.

    표 3. 매개변수
    이름 유형 설명
    입력 문자열 필수 입력 페이로드. 추가하거나 업데이트할 구성 항목의 JSON 형식 문자열입니다. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    입력.항목 배열 추가하거나 업데이트할 항목을 정의하는 객체의 배열입니다.
    "items": [
  { 
    "className": "String",
    "display_values": {Object},
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server 같은 클래스 CMDB /테이블일 수 있습니다.
    input.items.display_values 객체 이름-값 쌍으로 이 관련 항목에 대해 만들거나 업데이트할 참조 필드입니다. 여기서 이름은 필드 이름이고 값은 참조된 표시 값입니다. 참조 필드에 표시 값 대신 sys_id 사용하려면 이 매개변수 대신 매개변수에 input.items.lookup.values 정보를 전달합니다.

    참조 필드 이름은 다음과 같이 사용자가 선택한 필드에 따라 다릅니다.

    "display_values": {
  "model_id": "String",
  "location": "String"
}
    input.items.internal_id 문자열 연결된 페이로드의 고유 항목 식별자입니다.

    이 값은 어떤 값이든 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.lookup 배열 조회(조회 기반 식별)를 포함하는 최상위 항목을 식별합니다. 이러한 기록은 다시 cmdb_ci에 대한 참조가 있는 조회 테이블을 기반으로 구성 항목을 식별하는 데 사용됩니다.

    예:

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.lookup.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_serial_number 또는 cmdb_ci_network_adapter 같은 클래스 CMDB /테이블이 될 수 있습니다.
    input.items.lookup.internal_id 문자열 연결된 페이로드의 고유한 조회 항목 식별자입니다.

    이 값은 어떤 값이든 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.lookup.sys_object_source_info 객체 특정 데이터 소스에 대한 고유 CI 식별자를 정의합니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.lookup.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.lookup.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.lookup.sys_object_source_info.source_native_key 문자열 소스에서 항목의 고유 키 ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.lookup.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜/시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.lookup.values 객체 이름-값 쌍으로서의 CI에 대한 필드 정보입니다. 여기서 이름은 필드 이름입니다. 참조 필드를 업데이트할 때 값은 참조된 sys_id이어야 합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String",
  "ip_address": "String",
  "mac_address": "String"
}
    입력.항목.관련 배열 관련 목록이 포함된 최상위 항목에 대한 참조입니다. 관련 항목 [cmdb_related_entry]의 규칙은 이 배열에 포함될 수 있는 기록 유형을 정의합니다. 이러한 기록은 식별 중인 CI에 대한 참조가 있는 관련 테이블을 기반으로 항목을 추가하는 데 사용됩니다.

    관련 테이블은 cmdb_ci 확장되거나 확장되지 않을 수 있습니다. 이러한 기록은 구성 항목을 식별하는 데 사용되지 않습니다.

    "related" [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.related.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_software_instance 또는 cmdb_key_value와 같은 클래스 CMDB /테이블일 수 있습니다.
    input.items.related.internal_id 문자열 이 페이로드의 이 관련 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.related.sys_object_source_info 객체 지정된 데이터 소스에 대한 고유 CI 식별자를 구성하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.related.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.related.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스를 식별합니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.related.sys_object_source_info.source_native_key 문자열 관련 항목에 대한 소스의 고유 키/ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.related.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜 및 시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.related.values 객체 이 관련 항목에 대해 생성하거나 업데이트할 필드(이름은 필드 이름)입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다. 참조 필드에 sys_id 대신 표시 값을 사용하려면 객체 대신 values 객체에 display_values 이 정보를 전달합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    입력.항목.설정 객체 허용되는 업데이트 유형을 정의하는 매개변수입니다.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.skipReclassificationRestrictionRules 부울 IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙을 실행해서는 안 되는지를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 규칙 실행을 건너뜁니다.
    • false: 규칙을 실행합니다.

    기본값: false
    input.items.settings.updateWithoutDowngrade 부울 이 항목에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 다운그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 다운그레이드가 모두 허용됩니다.

    기본값: false
    input.items.settings.updateWithoutSwitch 부울 항목을 업데이트하고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 클래스 전환이 허용되지 않습니다.
    • false: 항목 업데이트와 클래스 전환이 모두 허용됩니다.

    기본값: false
    input.items.settings.updateWithoutUpgrade 부울 이 항목에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 업그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 업그레이드가 모두 허용됩니다.

    기본값: false
    input.items.sys_object_source_info 객체 특정 소스의 고유한 CI 식별자입니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.sys_object_source_info.source_native_key 문자열 원본에서 항목의 고유 키/ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜 및 시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.values 객체 이 관련 항목에 대해 생성하거나 업데이트할 필드(이름은 필드 이름)입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다. 참조 필드에 sys_id 대신 표시 값을 사용하려면 객체 대신 values 객체에 display_values 이 정보를 전달합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.referenceItems 배열 입력 페이로드의 항목 간 참조를 정의하는 객체의 배열입니다. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced 문자열 internal_id 다른 항목에서 참조하는 항목에 대해 정의되었습니다.
    input.referenceItems.referencedBy 문자열 internal_id 다른 항목을 참조하는 항목에 대해 정의되었습니다.
    input.referenceItems.referenceField 문자열 항목의 클래스/테이블에 있는 referencedBy 참조 필드의 이름입니다.
    입력.관계 배열 입력 페이로드의 항목 간 관계를 지정하는 객체의 배열입니다.
    이 배열의 개체는 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 payload items 배열의 항목 인덱스를 나타내는 값을 사용하여 두 최상위 항목(전용) parentchild 및 이름-값 쌍 간의 관계를 정의할 수 있습니다.
      "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    • 객체는 두 항목(최상위 항목, 관련 항목 또는 조회 항목 사용 parent_id ) 및 child_id 키/값 쌍을 포함하여 이러한 항목에 대해 정의된 값을 나타내는 internal_id 값으로 두 항목 간의 관계를 정의할 수 있습니다.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.relations.child 번호 관계(items, items.related 또는 items.lookup)에서 하위 항목을 나타내는 배열 내 items CI 객체의 정수 인덱스입니다.
    input.relations.child_id 문자열 관계 internal_id 의 하위 항목(items, items.related 또는 items.lookup)입니다.
    input.relations.parent 번호 배열에 있는 items 상위 항목의 정수 인덱스(items, items.related 또는 items.lookup)
    input.relations.parent_id 문자열 internal_id 관계에서 상위 항목(items, items.related 또는 items.lookup)입니다.
    input.relations.sys_rel_source_info 객체 관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스 [sys_rel_source] 테이블에 저장됩니다(identifyCIEnhanced() 또는 identifyCI() 메서드에 대해 유지 되지 않음).

    데이터 유형: 객체

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    input.relations.sys_rel_source_info.source_name 문자열 검색 소스 이름입니다.

    기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
    input.relations.sys_rel_source_info.source_feed 문자열 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다.

    기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 작성할 때 source_feed 열에 저장됩니다.
    input.relations.type 문자열 상위 항목과 하위 항목 간에 존재하는 관계 유형입니다. 이는 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다.
    옵션 객체 선택 사항이지만 {} 또는 null을 전달해야 합니다. 기능을 활성화하거나 비활성화하는 옵션입니다.
    주:
    기본적으로 또는 가 true로 설정된 경우 partial_payloads , partial_commits 두 deduplicate_payloads 및 는 false로 설정된 경우에도 부분 페이로드 기능에 필수적이므로 활성화됩니다.
    "options": { 
 "deduplicate_payloads": "Boolean",
 "generate_summary": "Boolean", 
 "partial_commits": "Boolean", 
 "partial_payloads": "Boolean",
 "skip_updating_last_scan_to_now": "Boolean",
 "skip_updating_source_last_discovered_to_now": "Boolean"
}
    options.deduplicate_payloads 부울 중복 항목이 병합되는지 또는 오류로 간주되는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.

    • true: 중복 항목을 병합합니다.
    • false: 중복 항목을 오류로 간주합니다.

    기본값: true
    options.generate_summary 부울 반환된 결과에 요약 정보가 포함되어 있는지 여부를 나타내는 플래그입니다. 리턴된 요약 정보에 대한 세부사항은 리턴 결과 테이블의 내용을 참조하십시오 <String>.summary .

    유효한 값은 다음과 같습니다.

    • true: 요약 정보를 포함합니다.
    • false: 요약 정보를 포함하지 않습니다.

    기본값: false
    options.partial_commits 부울 부분 커밋 지원을 사용할 수 있는지 여부를 나타내는 플래그입니다. 부분 커밋에 대한 자세한 내용은 향상된 IRE 기능을 참조하세요.

    유효한 값은 다음과 같습니다.

    • true: 부분 커밋을 사용할 수 있습니다.
    • false: 부분 커밋을 사용할 수 없습니다.

    기본값: true
    options.partial_payloads 부울 부분 페이로드 지원을 사용할 수 있는지 여부를 나타내는 플래그입니다. 부분 페이로드에 대한 자세한 내용은 향상된 IRE 기능 및 IRE 데이터 소스 규칙 생성을 참조하세요.

    유효한 값은 다음과 같습니다.

    • true: 부분 페이로드 사용.
    • false: 부분 페이로드가 비활성화되었습니다.

    기본값: true
    options.skip_updating_last_scan_to_now 부울 sys_object_source의 last_scan 시간 필드 업데이트를 건너뛸지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 매개변수가 source_recency_timestamp 전달 sys_object_source_info되지 않은 경우 sys_object_source의 last_scan 시간 필드를 업데이트하지 않습니다.
    • false: sys_object_source의 last_scan 시간 필드를 업데이트합니다.

    기본값: glide.identification_engine.skip_updating_last_scan_to_now 시스템 속성의 값을 사용합니다.
    options.skip_updating_source_last_discovered_to_now 부울 구성 항목 [cmdb_ci] 테이블의 discovery_source 및 last_discovered 필드 업데이트를 건너뛸지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 페이로드 항목 값에 last_discovered 제공되지 않은 경우 discovery_source 및 last_discovered 필드를 업데이트하지 않습니다.
    • false: discovery_source 및 last_discovered 필드를 업데이트합니다.

    기본값: glide.identification_engine.skip_updating_source_last_discovered_to_now 시스템 속성의 값을 사용합니다.
    source 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    표 4. 반환
    매개변수 설명
    &lt;문자열> 입력 문자열의 구성 항목에 대한 결과 목록인 JSON 형식의 문자열입니다.

    데이터 유형: 문자열

    { 
  "additionalCommittedItems": [Array],  
  "additionalCommittedRelations": [Array], 
  "hasError": "Boolean", 
  "hasWarning": "Boolean",
  "items": [Array],  
  "relations": [Array], 
  "summary": {Object} 
}
    &lt;String>.additionalCommittedItems 현재 페이로드의 IRE 처리 중에 커밋되었지만 현재 입력 페이로드에 없는 CI 목록입니다.

    데이터 유형: 배열

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "operation": "String",
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "sysId": "String"
  }
]
    &lt;String>.additionalCommittedItems.className 이 추가 CI의 Sys_class_name입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedItems.errorCount 이 추가 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    &lt;String>.additionalCommittedItems.errors 이 추가 CI를 처리하는 동안 발생한 오류를 설명하는 객체 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;문자열>.additionalCommittedItems.errors.error 추가 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedItems.errors.message 추가 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedItems.identificationAttempts 각 객체가 이 추가 CI를 식별하기 위한 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    &lt;String>.additionalCommittedItems.identificationAttempts.attemptResult 이 추가적인 CI 식별 시도의 결과입니다.

    데이터 유형: 문자열

    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.
    &lt;String>.additionalCommittedItems.identificationAttempts.attributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    &lt;String>.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    &lt;String>.additionalCommittedItems.identificationAttempts.identifierName 이 추가적인 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedItems.identificationAttempts.searchOnTable 이 추가 CI 식별 시도를 위해 검색된 테이블의 이름입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedItems.identifierEntrySysId 이 추가 CI를 식별하는 데 사용되는 식별자 규칙에 대한 Sys_id입니다.

    주목할 만한 값 - 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.
    &lt;String>.additionalCommittedItems.inputIndices 이 추가 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    &lt;String>.additionalCommittedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    &lt;String>.additionalCommittedItems.mergedPayloads 이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    &lt;String>.additionalCommittedItems.operation 이 추가 CI에 대해 수행된 운영입니다.

    데이터 유형: 문자열

    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: 추가 CI가 대상 테이블에 새 레코드로 삽입됩니다.
    • NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.
    &lt;String>.additionalCommittedItems.sysId 식별을 통해 이 추가 CI에 대한 Sys_id 찾을 수 있습니다.

    데이터 유형: 문자열

    주목할 만한 값 - 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.
    &lt;String>.additionalCommittedItems.warnings 이 추가 CI를 처리하는 동안 발생한 경고를 설명하는 객체 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;String>.additionalCommittedItems.warnings.error 이 추가 CI를 처리하는 동안 발생한 경고 유형입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedItems.warnings.message 이 추가 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedRelations 삽입 또는 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalCommittedRelations": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String"
  }
]
    &lt;String>.additionalCommittedRelations.className 이 추가 종속 관계 CI의 sys_class_name입니다.

    데이터 유형: 문자열

    지원하는 값만: cmdb_rel_ci: CI 관계 테이블입니다.
    &lt;String>.additionalCommittedRelations.errorCount 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    &lt;String>.additionalCommittedRelations.errors 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;String>.additionalCommittedRelations.errors.error 추가 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedRelations.errors.message 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.additionalCommittedRelations.inputIndices 이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값입니다.

    데이터 유형: 배열

    "inputIndices": [
  Number
]
    &lt;String>.additionalCommittedRelations.markers 내부에서 사용할 마커 값입니다.

    데이터 유형: 배열

    "markers": []
    &lt;String>.additionalCommittedRelations.mergedPayloadIds 이 추가 종속 관계 CI를 처리하는 동안 병합된 이 CI에 대해 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 Sys_id 값입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    &lt;String>.additionalCommittedRelations.operation 추가 종속 관계 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입됩니다.
    • INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입됩니다.
    • NO_CHANGE: 종속 관계 CI에 대한 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다.

    데이터 유형: 문자열
    &lt;String>.hasError 항목 또는 관계에 오류가 있는지 여부를 나타내는 플래그입니다.

    데이터 유형: 부울
    &lt;String>.hasWarning 항목 또는 관계에 경고가 있는지 여부를 나타내는 플래그입니다.

    데이터 유형: 부울
    &lt;String>.items 생성되거나 업데이트된 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {  
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateIndices": [Array],
    "errorCount": Number, 
    "errors": [Array], 
    "identificationAttempts": [Array], 
    "identifierEntrySysId": "String",  
    "incompleteSysIds": "String",
    "info": [Array],
    "inputIndices": [Array], 
    "maskedAttributes": [Array],
    "operation": "String", 
    "partialSysIds": "String", 
    "relatedItems": [Array], 
    "relatedSysIds": [Array], 
    "sysId": "String" 
  }
]
    &lt;String>.items.additionalRelatedItems 처리되었지만 입력 페이로드의 일부로 제공되지 않은 추가 조회 및 관련 항목에 대한 정보를 제공하는 JSON 객체 목록입니다. 이러한 항목은 부분 페이로드에서 가져온 것입니다.

    데이터 유형: 배열

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array],
    "mergedPayloadIds": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    &lt;String>.items.additionalRelatedItems.className 작성되거나 업데이트된 CI의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    &lt;String>.items.additionalRelatedItems.inputIndices 이 관련 항목에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값입니다.

    데이터 유형: 숫자 배열
    &lt;String>.items.additionalRelatedItems.mergedPayloadIds 관련 항목에 병합된 부분 페이로드의 sys_ids 목록입니다. CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 있습니다.

    데이터 유형: 배열
    &lt;String>.items.additionalRelatedItems.operation 작업 유형입니다.

    가능한 값:

    • INSERT: 새 CI가 데이터베이스에 삽입되었습니다.
    • NO_CHANGE: CI가 변경되지 않았습니다.
    • 업데이트 : 기존 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    &lt;String>.items.additionalRelatedItems.sysId 업데이트되거나 생성된 CI의 Sys_id입니다.

    데이터 유형: 문자열
    &lt;String>.items.className 작성되거나 업데이트된 CI의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    &lt;String>.items.duplicateIndices 현재 항목과 중복되는 CI의 인덱스 목록입니다.

    데이터 유형: 배열
    &lt;String>.items.errorCount 항목을 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    &lt;String>.items.errors 각 객체가 이 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;문자열>.items.errors.error CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    &lt;String>.items.errors.message 오류와 관련된 오류 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.items.identificationAttempts CI를 식별하기 위해 시도한 목록입니다.

    데이터 유형: 배열

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    &lt;String>.items.identificationAttempts.attemptResult CI를 식별하려는 시도의 결과입니다.

    가능한 값:

    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    &lt;String>.items.identificationAttempts.attributes 식별 프로세스 중에 사용된 CI 식별자 항목 속성 목록입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    &lt;String>items.identificationAttempts.hybridEntryCiAttributes 식별 프로세스 중에 사용된 CI 식별자 항목 속성 목록입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    &lt;String>.items.identificationAttempts.identifierName 이 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    &lt;String>.items.identificationAttempts.searchOnTable 식별 프로세스 중에 검색되는 테이블의 이름입니다.

    데이터 유형: 문자열
    &lt;String>.items.identifierEntrySysId CI를 식별하는 데 사용되는 식별자 규칙에 대한 Sys_id입니다. 식별자 항목 [cmdb_identifier_entry] 테이블에 있습니다.

    데이터 유형: 문자열
    &lt;String>.items.incompleteSysIds 항목에 오류가 있어 불완전한 페이로드로 저장된 경우 이 매개변수에는 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블의 기록 sys_id 포함됩니다.

    데이터 유형: 문자열
    &lt;문자열>.items.info 항목 처리에 대한 추가 정보가 들어 있는 객체의 목록입니다.

    데이터 유형: 배열

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    &lt;문자열>.items.info.code 건너뛴 재분류 유형입니다.
    가능한 값:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    데이터 유형: 문자열
    &lt;String>.items.info.message 재분류를 건너뛰는 이유에 대한 추가 통찰력을 제공하는 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.items.info.ruleSysId 일치하는 재분류 제한 규칙의 Sys_id입니다. 재분류 제한 규칙으로 인해 IRE가 재분류를 건너뛸 때만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛸 경우 이 값은 비어 있습니다.

    데이터 유형: 문자열
    &lt;String>.items.inputIndices 해당 입력 CI의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 또는 조회 CI의 경우 JSON 객체의 목록입니다.

    데이터 유형: 숫자 배열
    &lt;String>.items.maskedAttributes 조정 규칙에 정의된 대로 신뢰할 수 없는 데이터 소스에 의한 업데이트를 건너뛴 속성 목록입니다.

    데이터 유형: 배열
    &lt;String>.items.operation 발생한 작업입니다.

    가능한 값:

    • INSERT: 새 CI가 데이터베이스에 삽입되었습니다.
    • INSERT_AS_INCOMPLETE: 항목이 cmdb_ire_incomplete_payloads 테이블에 저장되었습니다.
    • INSERT_AS_PARTIAL: 항목이 cmdb_ire_partial_payloads 테이블에 저장되었습니다.
    • 업데이트 : 기존 CI가 업데이트되었습니다.
    • UPDATE_WITH_DOWNGRADE: CI가 업데이트되었고 클래스가 보다 일반적인 클래스(상위 클래스)로 변경되었습니다.
    • UPDATE_WITH_SWITCH: CI가 업데이트되었고 클래스가 상위 또는 하위 항목이 아닌 클래스로 변경되었습니다.
    • UPDATE_WITH_UPDRADE: CI가 업데이트되었고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다.

    데이터 유형: 문자열
    &lt;String>.items.partialSysIds 항목에 오류가 있어 부분 페이로드로 저장된 경우 이 매개변수에는 부분 페이로드 기록의 sys_id 포함됩니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems 요청 본문 items.lookup 배열에서 관련 CI(테이블 조회 CI)를 설명하는 JSON 객체의 목록입니다.

    데이터 유형: 배열

    "relatedItems": [
  { 
    "className": "String",
    "errors": [Array],
    "errorCount": Number, 
    "incompleteSysIds": [Array],
    "inputIndices": [Array],
    "mergePayloadIds": [Array],
    "operation": "String",
    "partialSysIds": [Array], 
    "sysId": "String",
    "warningCount": Number,
    "warnings": [Array]
  }
]
    &lt;String>.items.relatedItems.className 관련 항목의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.errors 관련 항목을 처리하는 동안 발생한 오류의 목록입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;문자열>.items.relatedItems.errors.error 관련 항목을 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.errors.message 오류와 관련된 오류 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.errorCount 관련 항목을 처리하는 동안 탐지된 오류 수입니다.

    데이터 유형: 숫자
    &lt;String>.items.relatedItems.incompleteSysIds 관계에 오류가 있어 불완전한 페이로드로 저장된 경우 이 값은 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 있는 기록의 sys_id입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.inputIndices 해당 입력 항목의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 항목 또는 조회 항목의 경우 JSON 객체의 목록입니다.

    데이터 유형: 숫자 배열 또는 객체 배열

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    &lt;String>.items.relatedItems.inputIndices.mainIndex 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    &lt;문자열>.items.relatedItems.inputIndices.subIndex 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    &lt;String>.items.relatedItems.mergedPayloadIds 처리 중에 CI에 병합된 부분 페이로드의 sys_ids 목록입니다.

    데이터 유형: 배열
    &lt;String>.items.relatedItems.operation 발생한 작업입니다.

    가능한 값:

    • 삽입: 새 관련 CI가 데이터베이스에 삽입되었습니다.
    • INSERT_AS_INCOMPLETE: 항목이 cmdb_ire_incomplete_payloads 테이블에 저장되었습니다.
    • INSERT_AS_PARTIAL: 항목이 cmdb_ire_partial_payloads 테이블에 저장되었습니다.
    • NO_CHANGE: 관련 CI가 변경되지 않았습니다.
    • 업데이트: 기존 관련 CI가 업데이트되었습니다.
    • UPDATE_WITH_DOWNGRADE: 관련 CI가 업데이트되었고 클래스가 보다 일반적인 클래스(상위 클래스)로 변경되었습니다.
    • UPDATE_WITH_SWITCH: 관련 CI가 업데이트되었고 클래스가 상위 또는 하위 항목이 아닌 클래스로 변경되었습니다.
    • UPDATE_WITH_UPDRADE: 관련 CI가 업데이트되었고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.partialSysIds 관련 항목에 오류가 있어 부분 페이로드로 저장된 경우 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 연결된 기록의 sys_ids 목록이 포함됩니다.

    데이터 유형: 배열
    &lt;String>.items.relatedItems.sysId 관련 항목의 sys_id입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.warningCount 관련 항목을 처리할 때 발생한 경고 수입니다.

    데이터 유형: 숫자
    &lt;String>.items.relatedItems.warnings 관련 항목을 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;String>.items.relatedItems.warnings.error 관련 항목을 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.warnings.message 경고와 관련된 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedSysIds 관련 항목의 조회 기반 식별 중에 사용되는 CI의 sys_id 값 목록입니다.

    데이터 유형: 문자열
    &lt;문자열>.items.sys_id 업데이트되거나 생성된 CI의 Sys_id입니다.

    데이터 유형: 문자열
    &lt;문자열>.관계 요청 본문 relations 배열의 종속 관계 CI를 설명하는 JSON 객체의 목록입니다.

    데이터 유형: 배열

    "relations": [ 
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "incompleteSysIds": "String",
    "inputIndices": [Array],
    "operation": "String",
    "partialSysIds": "String",
    "sysId": "String" 
  }
]
    &lt;String>.relations.className 이 종속 관계 CI의 Sys_class_name입니다.

    지원되는 값만: cmdb_rel_ci: CI 관계 테이블.

    데이터 유형: 문자열
    &lt;String>.relations.errorCount 종속 관계 CI를 처리할 때 발생한 오류 수입니다.

    데이터 유형: 숫자
    &lt;문자열>.relations.errors 이 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;문자열>.relations.errors.error 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    &lt;String>.relations.errors.message 이 종속 관계 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.relations.incompleteSysIds 관계에 오류가 있어 불완전한 페이로드로 저장된 경우 이 값은 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 있는 기록의 sys_id입니다.

    데이터 유형: 문자열
    &lt;String>.relations.inputIndices 이 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스입니다.

    데이터 유형: 배열
    &lt;String>.relations.operation 수행된 작업의 유형입니다.

    가능한 값:

    • 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입되었습니다.
    • INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다.
    • INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    &lt;String>.relations.partialSysIds 관계에 오류가 있어 부분 페이로드로 저장된 경우 이 값은 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 있는 기록의 sys_id입니다.

    데이터 유형: 문자열
    &lt;String>.relations.sysId 종속 관계 CI의 Sys_id입니다.

    데이터 유형: 문자열
    &lt;문자열>.요약 클래스당 삽입, 업데이트된 항목 수 등에 대한 통계를 제공하는 JSON 속성 목록입니다.

    데이터 유형: 배열
    &lt;String>.summary.&lt;class_name> 특정 클래스에 대한 통계입니다.

    데이터 유형: 객체

    <class_name>: {
 "additionalInsertedItemCount": Number, 
 "errorCount": Number,
 "incompleteItemCount": Number,
 "insertedItemCount": Number,
 "partialItemCount": Number,
 "skippedItemCount": Number,
 "unchangedItemCount": Number,
 "updatedItemCount": Number,
 "warningCount": Number 
}
    &lt;String>.summary.&lt;class_name>.additionalInsertedItemCount 부분 페이로드 처리로 인해 삽입된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.errorCount 항목을 처리할 때 발생하는 오류 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.incompleteItemCount CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.insertedItemCount 생성된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.partialItemCount 부분 페이로드 테이블 [cmdb_ire_partial_payloads]에 저장된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.skippedItemCount 건너뛴 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.unchangedItemCount 항목이 있지만 수정되지 않은 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.updatedItemCount 업데이트된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.warningCount 처리 시 경고를 생성한 항목 수입니다.

    데이터 유형: 숫자

    종속 CI를 식별합니다.

    var payload = {
"items": [
{
 "className": "cmdb_ci_win_server", 
 "values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],

    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {  
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },

  "related": [
    {
      "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }}]  
  "settings" : {
        "skipReclassificationRestrictionRules" : "false",
        "updateWithoutDowngrade" : "true",
        "updateWithoutUpgrade" : "true",
        "updateWithoutSwitch" : "true"
      }}, 
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },

  "internal_id": "tomcat_id"
  }],

"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],

"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};

var input = new JSON().encode(payload);
var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCIEnhanced('ServiceNow', input, {});

    출력:

    {

"items": [
{
  "className": "cmdb_ci_win_server",
  "operation": "NO_CHANGE",
  "sysId": "65d873d2b3a0001028f6eae2c6a8dc2a",
  "relatedSysIds": [
    "a1d873d2b3a0001028f6eae2c6a8dc32",
    "a1d873d2b3a0001028f6eae2c6a8dc33"
],

"relatedItems": [
{
  "className": "cmdb_serial_number",
  "sysId": "a1d873d2b3a0001028f6eae2c6a8dc32",
  "markers": [],
  "inputIndices": [
  {
    "mainIndex": 0,
    "subIndex": 0
  }]
},
  "className": "cmdb_serial_number",
  "sysId": "a1d873d2b3a0001028f6eae2c6a8dc33",
  "markers": [],
  "inputIndices": [
  {
    "mainIndex": 0,
    "subIndex": 1
  }]
}],

"additionalRelatedItems": [],
"identificationAttempts": [],
"errorCount": 0,
"inputIndices": [0]
},
{
"className": "cmdb_ci_spkg",
"operation": "NO_CHANGE",
"sysId": "c764e971b320001028f6eae2c6a8dc44",

"relatedSysIds": [
  "8b64e971b320001028f6eae2c6a8dc47"
],
"relatedItems": [
  {
  "className": "cmdb_software_instance",
  "sysId": "8b64e971b320001028f6eae2c6a8dc47",
  "markers": [],
  "inputIndices": [
    {
      "mainIndex": 1,
      "subIndex": 0
    }]
  }],

"additionalRelatedItems": [],
"identifierEntrySysId": "a52a87c03746220006b216a543990e8c",
"identificationAttempts": [
  {
    "attributes": [
      "key"
     ],
    "identifierName": "Software",
    "attemptResult": "MATCHED",
    "searchOnTable": "cmdb_ci_spkg",
    "hybridEntryCiAttributes": []
  }],

"errorCount": 0,
"inputIndices": [1]
},

{
"className": "cmdb_ci_app_server_tomcat",
"operation": "INSERT",
"sysId": "6f29f3d2b3a0001028f6eae2c6a8dcc6",
"identifierEntrySysId": "Unknown",
"identificationAttempts": [
{
  "attributes": [
    "install_directory",
    "running_process_key_parameters",
    "sys_class_name"
  ],
"identifierName": "Tomcat",
"attemptResult": "NO_MATCH",
"searchOnTable": "cmdb_ci_app_server_tomcat",
"hybridEntryCiAttributes": []
},
{
"attributes": [
  "cl_port",
  "sys_class_name"
],
"identifierName": "Application Rule",
"attemptResult": "SKIPPED",
"searchOnTable": "cmdb_ci_appl",
"hybridEntryCiAttributes": []
},
{
"attributes": [
  "running_process_command",
  "running_process_key_parameters",
  "sys_class_name"
],
"identifierName": "Application Rule",
"attemptResult": "NO_MATCH",
"searchOnTable": "cmdb_ci_appl",
"hybridEntryCiAttributes": []
}
],

"errorCount": 0,
"inputIndices": [2]
}
],
"additionalCommittedItems": [],
"relations": [
{
  "className": "cmdb_rel_ci",
  "operation": "INSERT",
  "sysId": "6729f3d2b3a0001028f6eae2c6a8dcc9",
  "errorCount": 0,
  "inputIndices": [0]
}],
"additionalCommittedRelations": []
}

    IdentificationEngineScriptableApi - identifyCI(문자열 jsonString)

    데이터베이스에서 작업을 커밋하지 않고 지정된 페이로드로 수행할 작업(삽입/업데이트)을 결정합니다.

    주:
    식별 규칙이 이렇게 구성된 경우 이 방법은 비 CMDB 테이블도 수집할 수 있습니다. 비 CMDB 테이블 수집에 대한 자세한 내용은 을 참조하십시오 IRE support for non-CMDB tables.

    이것은 createOrUpdateCI()처럼 작동하지만 결과를 커밋하지는 않습니다.

    표 5. 매개변수
    이름 유형 설명
    jsonString 문자열 추가하거나 업데이트할 구성 항목의 JSON 형식 문자열입니다. 각 입력 문자열은 'items: [{}], relations:[{}]' 형식이며, 항목 및 관계 목록 내의 각 항목에는 이름-값 쌍이 포함됩니다.
    항목 목록에서 사용할 수 있는 이름-값 쌍은 다음과 같습니다.
    • className - 작성하거나 업데이트할 CI의 Sys_class_name.
    • values:{} - 이름-값 쌍으로서의 CI에 대한 필드 정보입니다. 여기서 이름은 필드 이름입니다.
    • lookup:[{}] - 항목 목록과 같은 이름-값 쌍이 있는 각 항목이 있는 기록 목록입니다.
    관계 목록 내에서 사용할 수 있는 이름-값 쌍은 다음과 같습니다.
    • 상위 - 의존성 관계의 상위 항목 인덱스입니다.
    • 하위 - 종속성 관계의 하위 항목 인덱스입니다.
    • 유형 - 관계 유형입니다. 이는 cmdb_rel_type 테이블의 이름 필드 값 중 하나입니다.
    표 6. 반환
    유형 설명
    문자열 결과 목록인 JSON 형식의 문자열입니다. 각 결과 문자열은 'items: [{}], relations:[{}]' 형식이며, 항목 및 관계 목록 내의 각 항목에는 이름-값 쌍이 포함됩니다.
    항목 목록에서 사용할 수 있는 이름-값 쌍은 다음과 같습니다.
    • className - 업데이트되거나 작성된 CI의 Sys_class_name입니다.
    • operation - 수행할 운영으로, 다음 중 하나입니다.
      • 삭제
      • 삽입
      • 업데이트
      • UPDATE_WITH_DOWNGRADE
      • UPDATE_WITH_SWITCH
      • UPDATE_WITH_UPGRADE
    • sysId - 업데이트되거나 작성된 CI의 Sys_id입니다.
    • relatedSysIds - 조회 기반 식별 중에 사용되는 CI의 sys_id 값 목록입니다.
    • identifierEntrySysId - 일치 중에 사용되는 식별자 항목의 Sys_id.
    • 오류 - (오류, 메시지 문자열) 형식의 오류 목록입니다.
    • duplicateIndices - 현재 항목과 중복되는 항목의 인덱스 목록입니다.
    • identificationAttempts - (attributes, identiferName, attemptResult, searchOnTable) 형식의 시도 목록입니다.
      • 속성 - 식별 중에 사용되는 식별자 항목의 속성
      • identiferName - 이 식별자 항목이 속한 CI 식별자
      • attemptResult - 건너뜀, NO_MATCH, 일치, MULTI_MATCH 중 하나
      • searchOnTable - 식별 프로세스 중에 검색된 테이블입니다.
    관계 목록 내에서 사용할 수 있는 이름-값 쌍은 다음과 같습니다.
    • className - 관계 CI의 클래스 이름이며 항상 cmdb_rel_ci.
    • operation - operation 유형: INSERT, UPDATE NO_CHANGE
    • sysId - 삽입되거나 업데이트된 관계 CI의 Sys_id입니다.

    조회 기반 식별을 통해 독립적인 CI를 식별합니다.

    var payload = {items: [
 {className:'cmdb_ci_netgear', 
   values: {name:'ny8500-nbxs08',
            ports:'1200'}, 
   lookup: [{className:'cmdb_serial_number',
             values:{serial_number:'1234ABCD', serial_number_type:'uuid',absent:'false',valid:'true'}},
            {className:'cmdb_serial_number',
             values:{serial_number:'3456EFGH', serial_number_type:'system',absent:'false',valid:'true'}}]}]};

var jsonUntil = new JSON();
var input = jsonUntil.encode(payload);
var output = SNC.IdentificationEngineScriptableApi.identifyCI(input);
gs.print(output);

    출력:

    {
  "items": [
    {
      "className": "cmdb_ci_netgear",
      "operation": "UPDATE",
      "sysId": "55b35562c0a8010e01cff22378e0aea9",
      "relatedSysIds": [
        null,
        null
      ],
      "relatedItems": [
        {
          "errors": [
          
          ],
          "operation": "INSERT",
          "info": [
          
          ],
          "errorCount": 0,
          "mergedPayloadIds": [
          
          ],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "warningCount": 0,
          "markers": [
          
          ],
          "className": "cmdb_serial_number"
        },
        {
          "errors": [
          
          ],
          "operation": "INSERT",
          "info": [
          
          ],
          "errorCount": 0,
          "mergedPayloadIds": [
          
          ],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "warningCount": 0,
          "markers": [
          
          ],
          "className": "cmdb_serial_number"
        }
      ],
      "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [
            "source_name",
            "source_native_key"
          ],
          "searchOnTable": "sys_object_source",
          "hybridEntryCiAttributes": [
           
          ]
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": [
           
          ]
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": [
          
          ]
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "MATCHED",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": [
           
          ]
        }
      ],
      "info": [
      
      ],
      "errorCount": 0,
      "mergedPayloadIds": [
      
      ],
      "inputIndices": [
        0
      ],
      "warningCount": 0,
      "markers": [
      
      ]
    }
  ],
  "additionalCommittedItems": [
            
  ],
  "relations": [
  
  ],
  "additionalCommittedRelations": [
       
  ],
  "hasError": false,
  "hasWarning": false
}

    범위가 지정된 등가

    범위가 지정된 애플리케이션에서 identifyCI(String jsonString) 메서드를 사용하려면 해당 범위 IdentificationEngine 메서드 identifyCI(String jsonString)을 사용합니다.

    IdentificationEngineScriptableApi - identifyCIEnhanced(문자열 소스, 문자열 입력, 객체 옵션)

    데이터베이스에서 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다 구성 관리 데이터베이스(CMDB) .

    주:
    식별 규칙이 이렇게 구성된 경우 이 방법은 비 CMDB 테이블도 수집할 수 있습니다. 비 CMDB 테이블 수집에 대한 자세한 내용은 을 참조하십시오 IRE support for non-CMDB tables.

    이 메서드를 사용하여 페이로드 제출을 시뮬레이션합니다.

    이 방법은 방법과 비슷 IdentificationEngineScriptableApi - identifyCI(문자열 jsonString) 하지만 다음 기능도 지원합니다.
    • 부분 페이로드
      • 경고 또는 오류가 있는 항목의 경우 항목 작업이 INSERT_AS_PARTIAL인지 INSERT_INCOMPLETE인지를 나타냅니다.
      • 기존 부분 페이로드와 병합된 부분 페이로드의 sys_ids 반환합니다.
    • 페이로드 중복 제거 기능을 지원합니다.
    • 요약을 생성합니다.
    표 7. 매개변수
    이름 유형 설명
    입력 문자열 필수 입력 페이로드. 추가하거나 업데이트할 구성 항목의 JSON 형식 문자열입니다. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    입력.항목 배열 추가하거나 업데이트할 항목을 정의하는 객체의 배열입니다.
    "items": [
  { 
    "className": "String",
    "display_values": {Object},
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server 같은 클래스 CMDB /테이블일 수 있습니다.
    input.items.display_values 객체 이름-값 쌍으로 이 관련 항목에 대해 만들거나 업데이트할 참조 필드입니다. 여기서 이름은 필드 이름이고 값은 참조된 표시 값입니다. 참조 필드에 표시 값 대신 sys_id 사용하려면 이 매개변수 대신 매개변수에 input.items.lookup.values 정보를 전달합니다.

    참조 필드 이름은 다음과 같이 사용자가 선택한 필드에 따라 다릅니다.

    "display_values": {
  "model_id": "String",
  "location": "String"
}
    input.items.internal_id 문자열 연결된 페이로드의 고유 항목 식별자입니다.

    이 값은 어떤 값이든 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.lookup 배열 조회(조회 기반 식별)를 포함하는 최상위 항목을 식별합니다. 이러한 기록은 다시 cmdb_ci에 대한 참조가 있는 조회 테이블을 기반으로 구성 항목을 식별하는 데 사용됩니다.

    예:

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.lookup.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_serial_number 또는 cmdb_ci_network_adapter 같은 클래스 CMDB /테이블이 될 수 있습니다.
    input.items.lookup.internal_id 문자열 연결된 페이로드의 고유한 조회 항목 식별자입니다.

    이 값은 어떤 값이든 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.lookup.sys_object_source_info 객체 특정 데이터 소스에 대한 고유 CI 식별자를 정의합니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.lookup.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.lookup.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.lookup.sys_object_source_info.source_native_key 문자열 소스에서 항목의 고유 키 ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.lookup.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜/시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.lookup.values 객체 이름-값 쌍으로서의 CI에 대한 필드 정보입니다. 여기서 이름은 필드 이름입니다. 참조 필드를 업데이트할 때 값은 참조된 sys_id이어야 합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String",
  "ip_address": "String",
  "mac_address": "String"
}
    입력.항목.관련 배열 관련 목록이 포함된 최상위 항목에 대한 참조입니다. 관련 항목 [cmdb_related_entry]의 규칙은 이 배열에 포함될 수 있는 기록 유형을 정의합니다. 이러한 기록은 식별 중인 CI에 대한 참조가 있는 관련 테이블을 기반으로 항목을 추가하는 데 사용됩니다.

    관련 테이블은 cmdb_ci 확장되거나 확장되지 않을 수 있습니다. 이러한 기록은 구성 항목을 식별하는 데 사용되지 않습니다.

    "related" [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.related.className 문자열 필수 생성하거나 업데이트할 CI(구성 항목)의 클래스/테이블 이름, sys_class_name입니다.

    이 값은 cmdb_software_instance 또는 cmdb_key_value와 같은 클래스 CMDB /테이블일 수 있습니다.
    input.items.related.internal_id 문자열 이 페이로드의 이 관련 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다.
    input.items.related.sys_object_source_info 객체 지정된 데이터 소스에 대한 고유 CI 식별자를 구성하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.related.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.related.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스를 식별합니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.related.sys_object_source_info.source_native_key 문자열 관련 항목에 대한 소스의 고유 키/ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.related.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜 및 시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.related.values 객체 이 관련 항목에 대해 생성하거나 업데이트할 필드(이름은 필드 이름)입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다. 참조 필드에 sys_id 대신 표시 값을 사용하려면 객체 대신 values 객체에 display_values 이 정보를 전달합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    입력.항목.설정 객체 허용되는 업데이트 유형을 정의하는 매개변수입니다.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.skipReclassificationRestrictionRules 부울 IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙을 실행해서는 안 되는지를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 규칙 실행을 건너뜁니다.
    • false: 규칙을 실행합니다.

    기본값: false
    input.items.settings.updateWithoutDowngrade 부울 이 항목에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 다운그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 다운그레이드가 모두 허용됩니다.

    기본값: false
    input.items.settings.updateWithoutSwitch 부울 항목을 업데이트하고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 클래스 전환이 허용되지 않습니다.
    • false: 항목 업데이트와 클래스 전환이 모두 허용됩니다.

    기본값: false
    input.items.settings.updateWithoutUpgrade 부울 이 항목에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 업그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 업그레이드가 모두 허용됩니다.

    기본값: false
    input.items.sys_object_source_info 객체 특정 소스의 고유한 CI 식별자입니다.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.sys_object_source_info.source_feed 문자열 소스에 여러 피드가 있을 수 있는 경우 이 필드를 사용하여 이 항목을 보내는 피드의 이름을 제공합니다.

    데이터 소스가 이 피드 이름을 생성합니다. 소스 피드를 고유하게 식별하는 모든 문자열이 될 수 있습니다.
    input.items.sys_object_source_info.source_name 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    input.items.sys_object_source_info.source_native_key 문자열 원본에서 항목의 고유 키/ID입니다.

    데이터 소스에서 이 키를 생성합니다. 항목에 고유한 모든 문자열이 될 수 있습니다.
    input.items.sys_object_source_info.source_recency_timestamp 문자열 항목이 스캔된 UTC 날짜 및 시간입니다.

    형식: YYYY-MM-DD hh:mm:ss
    input.items.values 객체 이 관련 항목에 대해 생성하거나 업데이트할 필드(이름은 필드 이름)입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다. 참조 필드에 sys_id 대신 표시 값을 사용하려면 객체 대신 values 객체에 display_values 이 정보를 전달합니다.

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.referenceItems 배열 입력 페이로드의 항목 간 참조를 정의하는 객체의 배열입니다. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced 문자열 internal_id 다른 항목에서 참조하는 항목에 대해 정의되었습니다.
    input.referenceItems.referencedBy 문자열 internal_id 다른 항목을 참조하는 항목에 대해 정의되었습니다.
    input.referenceItems.referenceField 문자열 항목의 클래스/테이블에 있는 referencedBy 참조 필드의 이름입니다.
    입력.관계 배열 입력 페이로드의 항목 간 관계를 지정하는 객체의 배열입니다.
    이 배열의 개체는 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 payload items 배열의 항목 인덱스를 나타내는 값을 사용하여 두 최상위 항목(전용) parentchild 및 이름-값 쌍 간의 관계를 정의할 수 있습니다.
      "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    • 객체는 두 항목(최상위 항목, 관련 항목 또는 조회 항목 사용 parent_id ) 및 child_id 키/값 쌍을 포함하여 이러한 항목에 대해 정의된 값을 나타내는 internal_id 값으로 두 항목 간의 관계를 정의할 수 있습니다.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.relations.child 번호 관계(items, items.related 또는 items.lookup)에서 하위 항목을 나타내는 배열 내 items CI 객체의 정수 인덱스입니다.
    input.relations.child_id 문자열 관계 internal_id 의 하위 항목(items, items.related 또는 items.lookup)입니다.
    input.relations.parent 번호 배열에 있는 items 상위 항목의 정수 인덱스(items, items.related 또는 items.lookup)
    input.relations.parent_id 문자열 internal_id 관계에서 상위 항목(items, items.related 또는 items.lookup)입니다.
    input.relations.sys_rel_source_info 객체 관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스 [sys_rel_source] 테이블에 저장됩니다(identifyCIEnhanced() 또는 identifyCI() 메서드에 대해 유지 되지 않음).

    데이터 유형: 객체

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    input.relations.sys_rel_source_info.source_name 문자열 검색 소스 이름입니다.

    기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
    input.relations.sys_rel_source_info.source_feed 문자열 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다.

    기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 작성할 때 source_feed 열에 저장됩니다.
    input.relations.type 문자열 상위 항목과 하위 항목 간에 존재하는 관계 유형입니다. 이는 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다.
    옵션 객체 선택 사항이지만 {} 또는 null을 전달해야 합니다. 기능을 활성화하거나 비활성화하는 옵션입니다.
    주:
    기본적으로 또는 가 true로 설정된 경우 partial_payloads , partial_commits 두 deduplicate_payloads 및 는 false로 설정된 경우에도 부분 페이로드 기능에 필수적이므로 활성화됩니다.
    "options": { 
 "deduplicate_payloads": "Boolean",
 "generate_summary": "Boolean", 
 "partial_commits": "Boolean", 
 "partial_payloads": "Boolean",
 "skip_updating_last_scan_to_now": "Boolean",
 "skip_updating_source_last_discovered_to_now": "Boolean"
}
    options.deduplicate_payloads 부울 중복 항목이 병합되는지 또는 오류로 간주되는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.

    • true: 중복 항목을 병합합니다.
    • false: 중복 항목을 오류로 간주합니다.

    기본값: true
    options.generate_summary 부울 반환된 결과에 요약 정보가 포함되어 있는지 여부를 나타내는 플래그입니다. 리턴된 요약 정보에 대한 세부사항은 리턴 결과 테이블의 내용을 참조하십시오 <String>.summary .

    유효한 값은 다음과 같습니다.

    • true: 요약 정보를 포함합니다.
    • false: 요약 정보를 포함하지 않습니다.

    기본값: false
    options.partial_commits 부울 부분 커밋 지원을 사용할 수 있는지 여부를 나타내는 플래그입니다. 부분 커밋에 대한 자세한 내용은 향상된 IRE 기능을 참조하세요.

    유효한 값은 다음과 같습니다.

    • true: 부분 커밋을 사용할 수 있습니다.
    • false: 부분 커밋을 사용할 수 없습니다.

    기본값: true
    options.partial_payloads 부울 부분 페이로드 지원을 사용할 수 있는지 여부를 나타내는 플래그입니다. 부분 페이로드에 대한 자세한 내용은 향상된 IRE 기능 및 IRE 데이터 소스 규칙 생성을 참조하세요.

    유효한 값은 다음과 같습니다.

    • true: 부분 페이로드 사용.
    • false: 부분 페이로드가 비활성화되었습니다.

    기본값: true
    options.skip_updating_last_scan_to_now 부울 sys_object_source의 last_scan 시간 필드 업데이트를 건너뛸지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 매개변수가 source_recency_timestamp 전달 sys_object_source_info되지 않은 경우 sys_object_source의 last_scan 시간 필드를 업데이트하지 않습니다.
    • false: sys_object_source의 last_scan 시간 필드를 업데이트합니다.

    기본값: glide.identification_engine.skip_updating_last_scan_to_now 시스템 속성의 값을 사용합니다.
    options.skip_updating_source_last_discovered_to_now 부울 구성 항목 [cmdb_ci] 테이블의 discovery_source 및 last_discovered 필드 업데이트를 건너뛸지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 페이로드 항목 값에 last_discovered 제공되지 않은 경우 discovery_source 및 last_discovered 필드를 업데이트하지 않습니다.
    • false: discovery_source 및 last_discovered 필드를 업데이트합니다.

    기본값: glide.identification_engine.skip_updating_source_last_discovered_to_now 시스템 속성의 값을 사용합니다.
    source 문자열 CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.
    표 8. 반환
    유형 설명
    &lt;문자열> 입력 문자열의 구성 항목에 대한 결과 목록인 JSON 형식의 문자열입니다.

    데이터 유형: 문자열

    { 
  "additionalCommittedItems": [Array],  
  "additionalCommittedRelations": [Array], 
  "hasError": "Boolean", 
  "hasWarning": "Boolean",
  "items": [Array],  
  "relations": [Array], 
  "summary": {Object} 
}
    &lt;String>.additionalCommittedItems 현재 페이로드의 IRE 처리 중에 커밋되었지만 현재 입력 페이로드에 없는 CI 목록입니다.

    데이터 유형: 배열

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "operation": "String",
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "sysId": "String"
  }
]
    &lt;String>.additionalCommittedRelations 삽입 또는 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalCommittedRelations": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String"
  }
]
    &lt;String>.hasError 항목 또는 관계에 오류가 있는지 여부를 나타내는 플래그입니다.

    데이터 유형: 부울
    &lt;String>.hasWarning 항목 또는 관계에 경고가 있는지 여부를 나타내는 플래그입니다.

    데이터 유형: 부울
    &lt;String>.items 생성되거나 업데이트된 CI를 설명하는 객체 목록입니다.

    데이터 유형: 배열

    "items": [ 
  {  
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateIndices": [Array],
    "errorCount": Number, 
    "errors": [Array], 
    "identificationAttempts": [Array], 
    "identifierEntrySysId": "String",
    "info": [Array], 
    "inputIndices": [Array], 
    "maskedAttributes": [Array],
    "operation": "String",
    "relatedSysIds": [Array], 
    "sysId": "String" 
  }
]
    &lt;String>.items.additionalRelatedItems 처리되었지만 입력 페이로드의 일부로 제공되지 않은 추가 조회 및 관련 항목에 대한 정보를 제공하는 JSON 객체 목록입니다. 이러한 항목은 부분 페이로드에서 가져온 것입니다.

    데이터 유형: 배열

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array],
    "mergedPayloadIds": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    &lt;String>.items.additionalRelatedItems.className 작성되거나 업데이트된 CI의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    &lt;String>.items.additionalRelatedItems.inputIndices 이 관련 항목에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값입니다.

    데이터 유형: 숫자 배열
    &lt;String>.items.additionalRelatedItems.mergedPayloadIds 관련 항목에 병합된 부분 페이로드의 sys_ids 목록입니다. CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 있습니다.

    데이터 유형: 배열
    &lt;String>.items.additionalRelatedItems.operation 작업 유형입니다.

    가능한 값:

    • INSERT: 새 CI가 데이터베이스에 삽입되었습니다.
    • NO_CHANGE: CI가 변경되지 않았습니다.
    • 업데이트 : 기존 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    &lt;String>.items.additionalRelatedItems.sysId 업데이트되거나 생성된 CI의 Sys_id입니다.

    데이터 유형: 문자열
    &lt;String>.items.className 작성되거나 업데이트된 CI의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    &lt;String>.items.duplicateIndices 현재 항목과 중복되는 CI의 인덱스 목록입니다.

    데이터 유형: 배열
    &lt;String>.items.errorCount 항목을 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    &lt;String>.items.errors 각 객체가 이 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;문자열>.items.errors.error CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    &lt;String>.items.errors.message CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.items.identificationAttempts CI를 식별하기 위해 시도한 목록입니다.

    데이터 유형: 배열

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    &lt;String>.items.identificationAttempts.attemptResult CI를 식별하려는 시도의 결과입니다.

    가능한 값:

    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    &lt;String>.items.identificationAttempts.attributes 식별 프로세스 중에 사용된 CI 식별자 항목 속성 목록입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    &lt;String>.items.identificationAttempts.identifierName 이 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    &lt;String>.items.identificationAttempts.searchOnTable 식별 프로세스 중에 검색되는 테이블의 이름입니다.

    데이터 유형: 문자열
    &lt;String>.items.identifierEntrySysId CI를 식별하는 데 사용되는 식별자 규칙에 대한 Sys_id입니다. 식별자 항목 [cmdb_identifier_entry] 테이블에 있습니다.

    데이터 유형: 문자열
    &lt;문자열>.items.info 항목 처리에 대한 추가 정보가 들어 있는 객체의 목록입니다.

    데이터 유형: 배열

    "info": [
 {
   "code": "String",
   "message": "String",
   "ruleSysId": "String"
 }
]
    &lt;문자열>.items.info.code 건너뛴 재분류 유형입니다.
    가능한 값:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    데이터 유형: 문자열
    &lt;String>.items.info.message 재분류를 건너뛰는 이유에 대한 추가 통찰력을 제공하는 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.items.info.ruleSysId 일치하는 재분류 제한 규칙의 Sys_id입니다. 재분류 제한 규칙으로 인해 IRE가 재분류를 건너뛸 때만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛸 경우 이 값은 비어 있습니다.

    데이터 유형: 문자열
    &lt;String>.items.inputIndices 해당 입력 CI의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 또는 조회 CI의 경우 JSON 객체의 목록입니다.

    데이터 유형: 숫자 배열
    &lt;String>.items.maskedAttributes 조정 규칙에 정의된 대로 신뢰할 수 없는 데이터 소스에 의한 업데이트를 건너뛴 속성 목록입니다.

    데이터 유형: 배열
    &lt;String>.items.operation 발생한 작업입니다.

    가능한 값:

    • INSERT: 새 CI가 데이터베이스에 삽입되었습니다.
    • INSERT_AS_INCOMPLETE: 항목이 cmdb_ire_incomplete_payloads 테이블에 저장되었습니다.
    • INSERT_AS_PARTIAL: 항목이 cmdb_ire_partial_payloads 테이블에 저장되었습니다.
    • 업데이트 : 기존 CI가 업데이트되었습니다.
    • UPDATE_WITH_DOWNGRADE: CI가 업데이트되었고 클래스가 보다 일반적인 클래스(상위 클래스)로 변경되었습니다.
    • UPDATE_WITH_SWITCH: CI가 업데이트되었고 클래스가 상위 또는 하위 항목이 아닌 클래스로 변경되었습니다.
    • UPDATE_WITH_UPDRADE: CI가 업데이트되었고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems 처리된 관련 항목에 대한 정보를 제공하는 JSON 객체의 목록입니다.

    데이터 유형: 배열

    "relatedItems": [
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "mergePayloadIds": [Array],
    "operation": "String",
    "sysId": "String",
    "warningCount": Number,
    "warnings": [Array]
  }
]
    &lt;String>.items.relatedItems.className 관련 항목의 클래스/테이블 이름(sys_class_name)입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.errorCount 관련 항목을 처리하는 동안 탐지된 오류 수입니다.

    데이터 유형: 숫자
    &lt;String>.items.relatedItems.errors 관련 항목을 처리하는 동안 발생한 오류의 목록입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;문자열>.items.relatedItems.errors.error 관련 항목을 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.errors.message 관련 항목을 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.inputIndices 해당 입력 항목의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 항목 또는 조회 항목의 경우 JSON 객체의 목록입니다.

    데이터 유형: 숫자 배열 또는 객체 배열

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    &lt;String>.items.relatedItems.inputIndices.mainIndex 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    &lt;문자열>.items.relatedItems.inputIndices.subIndex 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    &lt;String>.items.relatedItems.mergedPayloadIds 처리 중에 CI에 병합된 부분 페이로드의 sys_ids 목록입니다.

    데이터 유형: 배열
    &lt;String>.items.relatedItems.operation 발생한 작업입니다.

    가능한 값:

    • 삽입: 새 관련 CI가 데이터베이스에 삽입되었습니다.
    • INSERT_AS_INCOMPLETE: 항목이 cmdb_ire_incomplete_payloads 테이블에 저장되었습니다.
    • INSERT_AS_PARTIAL: 항목이 cmdb_ire_partial_payloads 테이블에 저장되었습니다.
    • NO_CHANGE: 관련 CI가 변경되지 않았습니다.
    • 업데이트: 기존 관련 CI가 업데이트되었습니다.
    • UPDATE_WITH_DOWNGRADE: 관련 CI가 업데이트되었고 클래스가 보다 일반적인 클래스(상위 클래스)로 변경되었습니다.
    • UPDATE_WITH_SWITCH: 관련 CI가 업데이트되었고 클래스가 상위 또는 하위 항목이 아닌 클래스로 변경되었습니다.
    • UPDATE_WITH_UPDRADE: 관련 CI가 업데이트되었고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.sysId 관련 항목의 sys_id입니다.

    데이터 유형: 문자열
    &lt;String>.items.relatedItems.warningCount 관련 항목을 처리할 때 발생한 경고 수입니다.

    데이터 유형: 숫자
    &lt;String>.items.relatedItems.warnings 관련 항목을 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;String>.items.relatedSysIds 관련 항목의 조회 기반 식별 중에 사용되는 CI의 sys_id 값 목록입니다.

    데이터 유형: 문자열
    &lt;문자열>.items.sys_id 업데이트되거나 생성된 CI의 Sys_id입니다.

    데이터 유형: 문자열
    &lt;문자열>.관계 처리된 관계에 대한 정보를 제공하는 JSON 객체의 목록입니다.

    데이터 유형: 배열

    "relations": [ 
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String" 
  }
]
    &lt;String>.relations.className 이 종속 관계 CI의 Sys_class_name입니다.

    지원되는 값만: cmdb_rel_ci: CI 관계 테이블.

    데이터 유형: 문자열
    &lt;String>.relations.errorCount 종속 관계 CI를 처리할 때 발생한 오류 수입니다.

    데이터 유형: 숫자
    &lt;문자열>.relations.errors 이 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    &lt;String>.relations.inputIndices 이 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스입니다.

    데이터 유형: 배열
    &lt;String>.relations.operation 수행된 작업의 유형입니다.

    가능한 값:

    • 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입되었습니다.
    • INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다.
    • INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    &lt;String>.relations.sysId 종속 관계 CI의 Sys_id입니다.

    데이터 유형: 문자열
    &lt;문자열>.요약 클래스당 삽입, 업데이트된 항목 수 등에 대한 통계를 제공하는 JSON 속성 목록입니다.

    데이터 유형: 배열
    &lt;String>.summary.&lt;class_name> 특정 클래스에 대한 통계입니다.

    데이터 유형: 객체

    <class_name>: {
 "additionalInsertedItemCount": Number, 
 "errorCount": Number,
 "incompleteItemCount": Number,
 "insertedItemCount": Number,
 "partialItemCount": Number,
 "skippedItemCount": Number,
 "unchangedItemCount": Number,
 "updatedItemCount": Number,
 "warningCount": Number 
}
    &lt;String>.summary.&lt;class_name>.additionalInsertedItemCount 부분 페이로드 처리로 인해 삽입된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.errorCount 항목을 처리할 때 발생하는 오류 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.incompleteItemCount CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.insertedItemCount 생성된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.partialItemCount 부분 페이로드 테이블 [cmdb_ire_partial_payloads]에 저장된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.skippedItemCount 건너뛴 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.unchangedItemCount 항목이 있지만 수정되지 않은 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.updatedItemCount 업데이트된 항목 수입니다.

    데이터 유형: 숫자
    &lt;String>.summary.&lt;class_name>.warningCount 처리 시 경고를 생성한 항목 수입니다.

    데이터 유형: 숫자

    		 
    var payload = {
"items": [
{
"className": "cmdb_ci_win_server",
"values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],
 
    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },
 
  "related": [
    {
     "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }},
  {
    "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229",
    "values": {
    },
    "className": "cmdb_software_instance",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229"
  }}
],
  "settings" : {
        "skipReclassificationRestrictionRules" : "true",
        "updateWithoutDowngrade" : "true",
        "updateWithoutUpgrade" : "true",
        "updateWithoutSwitch" : "true"
      }},
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },
 
  "internal_id": "tomcat_id"
  }],
 
"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],
 
"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};
 
var input = new JSON().encode(payload);
var output = SNC.IdentificationEngineScriptableApi.identifyCIEnhanced('ServiceNow', input, {});

    출력:

    {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "operation": "INSERT",
      "relatedSysIds": [
        null,
        null
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_serial_number",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        },
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_serial_number",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        }
      ],
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source NO_MATCH",
          "identifierName": "",
          "attemptResult": "NO_MATCH",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "mac_address",
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    },
    {
      "className": "cmdb_ci_spkg",
      "operation": "INSERT",
      "relatedSysIds": [
        null
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_software_instance",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 0
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        },
        {
          "errors": [],
          "warnings": [
            {
              "error": "MISSING_MATCHING_ATTRIBUTES",
              "message": "In payload missing minimum set of input values for criterion (matching) attributes from identify rule for table [cmdb_software_instance]. Add these input values in payload item '{\"className\":\"cmdb_software_instance\",\"values\":{},\"internal_id\":\"f7273cccec30101056cd4bb46eb4db5d\",\"sys_object_source_info\":{\"source_feed\":\"SN Discovery Feed 1\",\"source_name\":\"ServiceNow\",\"source_native_key\":\"Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229\"},\"settings\":{},\"sys_ire_info\":{\"ire_received_time\":\"2020-05-10 17:57:48\"}}'"
            }
          ],
          "operation": "INSERT_AS_PARTIAL",
          "className": "cmdb_software_instance",
          "errorCount": 0,
          "sysId": "Unknown",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 1
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 1
        }
      ],
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "key"
          ],
          "identifierName": "Software",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_spkg",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    },
    {
      "className": "cmdb_ci_app_server_tomcat",
      "operation": "INSERT",
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        2
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    }
  ],
  "additionalCommittedRelations": []
} 

    IdentificationEngineScriptableApi - runIdentificationAudit(GlideRecord now_GR)

    지정된 CI(구성 항목)에 대해 식별 감사를 실행하여 중복을 탐지합니다.

    중복이 발견되면 중복 작업이 생성됩니다. 독립적인 식별 규칙이 있는 CI 유형에만 이 방법을 사용하십시오.

    표 9. 매개변수
    이름 유형 설명
    now_GR GlideRecord 중복을 탐지하기 위해 감사를 실행할 CI입니다. CI에는 독립적인 식별 규칙이 있어야 합니다.
    표 10. 반환
    유형 설명
    void

    다음 예제에서는 서버에서 중복 작업을 확인하고 중복 수정 작업(있는 경우)을 만드는 방법을 보여 줍니다.

    var grServer = new GlideRecord('cmdb_ci_server');
grServer.query();
while (grServer.next()) {
    SNC.IdentificationEngineScriptableApi.runIdentificationAudit(grServer);
}

    범위가 지정된 등가

    범위가 지정된 애플리케이션에서 runIdentificationAudit(GlideRecord now_GR) 메서드를 사용하려면 해당 범위 지정 IdentificationEngine 메서드인 runIdentificationAudit(GlideRecord now_GR)를 사용합니다. IdentificationEngine - runIdentificationAudit(GlideRecord now_GR)