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

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# IdentificationEngine - 범위 지정됨

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

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 154분

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

범위가 지정된 애플리케이션에서 이 클래스를 사용하는 경우 `sn_cmdb` 네임스페이스 식별자를 사용하십시오.

## IdentificationEngine - createOrUpdateCI(문자열 소스, 문자열 입력) {#ariaid-title2}

식별 및 조정 규칙에 따라 CI(구성 항목) 및 비구성 관리 데이터베이스(CMDB) CI(cmdb_ci에서 확장되지 않는 클래스)를 CMDB 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.
비 CMDB 테이블 수집에 대한 자세한 내용은 다음 문서를 참조하십시오 [IRE support for non-CMDB tables](https://www.servicenow.com/docs/access?context=ire-support-non-cmdb-tables&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US).
{#IESS-createorUpdateCI_S_S__entry__3}{#IESS-createorUpdateCI_S_S__entry_input}{#IESS-createorUpdateCI_S_S__entry_items}{#IESS-createorUpdateCI_S_S__entry_className}{#IESS-createorUpdateCI_S_S__entry-display_values-ire}{#IESS-createorUpdateCI_S_S__entry_internal_id}{#IESS-createorUpdateCI_S_S__entry_lookup}{#IESS-createorUpdateCI_S_S__row_items_settings}{#IESS-createorUpdateCI_S_S__items_set_skipReclassRestrictRules-entry-IRE}{#IESS-createorUpdateCI_S_S__row_items_settings_updateWithoutDowngrade}{#IESS-createorUpdateCI_S_S__row_items_settings_updateWithoutUpgrade}{#IESS-createorUpdateCI_S_S__row_items_settings_updateWithoutSwitch}{#IESS-createorUpdateCI_S_S__entry_values}{#IESS-createorUpdateCI_S_S__entry_referenceItems}{#IESS-createorUpdateCI_S_S__entry_referenceItems_referenced}{#IESS-createorUpdateCI_S_S__entry_referenceItems_referencedBy}{#IESS-createorUpdateCI_S_S__entry_referenceItems_referenceField}{#IESS-createorUpdateCI_S_S__entry_relations}{#IESS-createorUpdateCI_S_S__entry_relations_child}{#IESS-createorUpdateCI_S_S__entry_relations_child_id}{#IESS-createorUpdateCI_S_S__entry_relations_parent}{#IESS-createorUpdateCI_S_S__entry_relations_parent_id}{#IESS-createorUpdateCI_S_S__sys_rel_source_info-entry-IRE}{#IESS-createorUpdateCI_S_S__sys_rel_source_info-source_name-entry-ire}{#IESS-createorUpdateCI_S_S__sys_rel_source_into-source_feed-entry-ire}{#IESS-createorUpdateCI_S_S__entry_relations_type}

| 이름 | 유형 | 설명 |
|-|-|-|
| 입력 | 문자열 | 필수 입력 페이로드입니다. 추가 또는 업데이트할 구성 항목의 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 | 문자열 | 연결된 페이로드의 고유 항목 식별자입니다. 이 값은 무엇이든 될 수 있지만 페이로드 내에서 고유해야 합니다. |
| 입력.항목.조회 | 객체 배열 | 조회(조회 기반 식별)를 포함하는 최상위 항목을 식별합니다. 이러한 기록은 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 |
| 입력.항목.조회.값 | 객체 | 이 관련 항목에 대해 이름/값 쌍으로 작성하거나 업데이트할 필드로, 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 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: 규칙을 실행합니다. {#IESS-createorUpdateCI_S_S__ul_tl4_qwp_snb} 기본값: false |
| input.items.settings.updateWithoutDowngrade | 부울 | 이 항목에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. * 아니오: 항목 업데이트와 다운그레이드가 모두 허용됩니다. {#IESS-createorUpdateCI_S_S__ul_jdl_pfb_sjb} 기본값: false |
| input.items.settings.updateWithoutUpgrade | 부울 | 이 항목에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. * 아니오: 항목 업데이트와 업그레이드가 모두 허용됩니다. {#IESS-createorUpdateCI_S_S__ul_vqx_xfb_sjb} 기본값: false |
| input.items.settings.updateWithoutSwitch | 부울 | 항목을 업데이트할 수 있고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. * 아니오: 항목 업데이트와 클래스 전환이 모두 허용됩니다. {#IESS-createorUpdateCI_S_S__ul_h4p_2gb_sjb} 기본값: 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 |
| 입력.항목.값 | 객체 | 이 관련 항목에 대해 이름/값 쌍으로 작성하거나 업데이트할 필드로, 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 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 | 객체 배열 | 입력 페이로드의 항목 간 참조를 정의하는 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| input.referenceItems.referenced | 문자열 | internal_id 다른 항목에서 참조하는 항목에 대해 정의되어 있습니다. |
| input.referenceItems.referencedBy | 문자열 | internal_id 다른 항목을 참조하는 항목에 대해 정의되어 있습니다. |
| input.referenceItems.referenceField | 문자열 | 항목의 클래스/테이블에 있는 참조 필드의 이름입니다 referencedBy . |
| 입력.관계 | 객체 배열 | 입력 페이로드의 항목 간의 관계를 지정하는 목록입니다. 이 배열의 객체는 두 형식 중 하나를 사용할 수 있습니다. * 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 이름-값 쌍을 사용하여 parentchild 두 최상위 항목 간의 관계를 정의할 수 있습니다. "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] * 이 객체는 키/값 쌍을 child_id 사용하여 parent_id 최상위 항목, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타낼 internal_id 수 있습니다. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#IESS-createorUpdateCI_S_S__ul_s1s_phb_nlb} |
| 입력.관계.하위 | 번호 | 관계의 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다(items, items.related 또는 items.lookup). |
| input.relations.child_id | 문자열 | internal_id 관계의 하위 항목(items, items.related 또는 items.lookup)의 |
| 입력.관계.상위 | 번호 | 배열에 있는 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 | 문자열 | 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다. 기본값: 테이블에서 기록을 생성할 때 source_feed 열에 "알 수 없음"sys_rel_source 저장됩니다. |
| 입력.관계.유형 | 문자열 | 상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. CI 관계 유형 \[cmdb_rel_type\] 테이블의 이름 필드 값이어야 합니다. |
| 소스 | 문자열 | CI 정보의 데이터 소스를 식별합니다. 이 값은 cmdb_ci 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. |
[표 1. 매개변수]

{#IESS-createorUpdateCI_S_S__table_yyd_zxn_ylb__entry__2}{#IESS-createorUpdateCI_S_S__entry_return_item_className}{#IESS-createorUpdateCI_S_S__entry_return_items_duplicateIndices}{#IESS-createorUpdateCI_S_S__entry_return_item_error}{#IESS-createorUpdateCI_S_S__items_errors_errors-entry-IRE}{#IESS-createorUpdateCI_S_S__items_errors_msg-entry-IRE}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts_attemptResult}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts_attributes}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts_identifierName}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts_searchOnTable}{#IESS-createorUpdateCI_S_S__entry_return_item_identifierEntrySysId}{#IESS-createorUpdateCI_S_S__items_info-entry-IREE}{#IESS-createorUpdateCI_S_S__entry_return_item_maskedAttributes}{#IESS-createorUpdateCI_S_S__entry_return_item_sys_id}{#IESS-createorUpdateCI_S_S__entry_return_relations_className}{#IESS-createorUpdateCI_S_S__entry_return_relations_sys_id}

| 유형 | 설명 |
|-|-|
| \<문자열\> | 입력 문자열의 구성 항목에 대한 결과 목록인 JSON 형식의 문자열입니다. 각 결과 문자열은 '항목: \[{}\], 관계:\[{}\]' 형식이며, 여기서 항목 및 관계 목록 내의 각 항목에는 이름-값 쌍이 포함됩니다. 데이터 유형: 문자열 |
| \<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 | 처리되었지만 입력 페이로드의 일부로 제공되지 않은 추가 조회 및 관련 항목에 대한 정보 목록입니다. 이러한 항목은 부분 페이로드에서 가져온 것입니다. 이 정보는 현재 반환되지 않습니다. 데이터 유형: 객체 배열 "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 } ] |
| \<String\>.items.additionalRelatedItems.inputIndices.mainIndex | 추가 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다. 데이터 유형: 숫자 |
| \<String\>.items.additionalRelatedItems.inputIndices.subIndex | 추가 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다. 데이터 유형: 숫자 |
| \<String\>.items.additionalRelatedItems.operation | 운영 유형입니다. 가능한 값: * INSERT: 새 CI가 데이터베이스에 삽입되었습니다. * NO_CHANGE: CI를 변경하지 않았습니다. * 업데이트: 기존 CI가 업데이트되었습니다. {#IESS-createorUpdateCI_S_S__ul_zk2_jrt_ylb} 데이터 유형: 문자열 |
| \<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" } ] |
| \<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" } ] |
| \<String\>.items.info.code | 건너뛴 재분류 유형입니다. 가능한 값: * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_UPGRADE {#IESS-createorUpdateCI_S_S__ul_cqz_yyp_snb} 데이터 유형: 문자열 |
| \<String\>.items.info.message | 재분류를 건너뛰는 이유에 대한 추가 인사이트를 제공하는 메시지입니다. 데이터 유형: 문자열 |
| \<string\>.items.info.ruleSysId | 일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값은 비어 있습니다. 데이터 유형: 문자열 |
| \<String\>.items.inputIndices | 이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값입니다. 데이터 유형: 배열 |
| \<String\>.items.maskedAttributes | [조정 규칙](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)에 정의된 대로 권한이 부여되지 않은 데이터 소스에 의한 업데이트를 건너뛴 속성 목록입니다. 데이터 유형: 배열 |
| \<String\>.items.relatedItems | 처리된 관련 항목에 대한 정보를 제공하는 목록입니다. 데이터 유형: 객체 배열 "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 배열의 정수 값입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.inputIndices.subIndex | 관련 항목에 해당하는 요청 본문 items.lookup 배열의 정수 값입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.operation | 운영 유형입니다. 가능한 값: * INSERT: 새 CI가 데이터베이스에 삽입되었습니다. * NO_CHANGE: CI를 변경하지 않았습니다. * 업데이트: 기존 CI가 업데이트되었습니다. {#IESS-createorUpdateCI_S_S__ul_a4r_kf4_ylb} 데이터 유형: 문자열 |
| \<String\>.items.relatedSysIds | 요청 본문 items.lookup 배열의 관련 항목(테이블 조회 항목)에 대한 sys_id 값 목록입니다. 주목할 만한 값 - null: 이 관련 항목에 대해 식별된 sys_id가 없습니다. 데이터 유형: 배열 |
| \<문자열\>.items.sys_id | 업데이트되거나 생성된 CI의 Sys_id입니다. 데이터 유형: 문자열 |
| \<String\>.relations | 처리된 관계에 대한 정보입니다. 데이터 유형: 객체 배열 "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입니다. 데이터 유형: 문자열 |
[표 2. 반환]

{#IESS-createorUpdateCI_S_S__table_yyd_zxn_ylb}  
다음은 구성 항목을 재분류하는 방법을 보여줍니다.

    var payload = {
      "items": [
        {
          "className": "cmdb_ci_win_server",
          "values": {
            "short_description": "Linux server description",
            "name": "Linux Server 1"
          }
        }
      ]
    };

    var input = JSON.stringify(payload);
    var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

    gs.info(JSON.stringify(JSON.parse(output), null, 2));

출력:

    {
      "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 input = JSON.stringify(payload);
    var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

    gs.info(JSON.stringify(JSON.parse(output), null, 2));

출력:

    {
      "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 input = JSON.stringify(payload);
    var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

    gs.info(JSON.stringify(JSON.parse(output), null, 2));

출력:

    {
      "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 input = JSON.stringify(payload);
    var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

    gs.info(JSON.stringify(JSON.parse(output), null, 2));

출력:

    {
      "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": []
    }

## IdentificationEngine - createOrUpdateCIEnhanced(문자열 소스, 문자열 입력, 객체 옵션) {#ariaid-title3}

식별 및 조정 규칙에 따라 CI(구성 항목) 및 비구성 관리 데이터베이스(CMDB) CI(cmdb_ci에서 확장되지 않는 클래스)를 CMDB 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.
createOrUpdateCI() 메서드의 기능을 제공하는 것 외에도 이 메서드는 다음을 지원합니다.

* 부분 페이로드 처리
* 부분 커밋 처리
* 페이로드 내에서 중복 항목 제거
* 출력 요약 생성

{#IESS-createOrUpdateCIEnhanced_S_S_S__ul_wyg_3f1_njb}IRE에 대한 자세한 내용과 이 메서드에서 사용되는 데이터에 대한 자세한 설명은 [IRE(식별 및 조정)](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)를 참조하십시오.

비 CMDB 테이블 수집에 대한 자세한 내용은 다음 문서를 참조하십시오 [IRE support for non-CMDB tables](https://www.servicenow.com/docs/access?context=ire-support-non-cmdb-tables&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US).
{#IESS-createOrUpdateCIEnhanced_S_S_S__IRE-payload__entry__3}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_input}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-display_values-ire}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_internal_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_lookup}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-input_items_lookup_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_related}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-input_items_related_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_settings}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_set_skipReclassRestrictRules-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_settings_updateWithoutDowngrade}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_settings_updateWithoutSwitch}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_settings_updateWithoutUpgrade}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info_source_feed}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info_source_name}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info_source_native_key}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info_source_recency_timestamp}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_values}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_referenceItems}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_referenceItems_referenced}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_referenceItems_referencedBy}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_referenceItems_referenceField}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_child}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_child_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_parent}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_parent_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__sys_rel_source_info-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__sys_rel_source_info-source_name-entry-ire}{#IESS-createOrUpdateCIEnhanced_S_S_S__sys_rel_source_into-source_feed-entry-ire}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_type}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options_deduplicate_payloads}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options_generate_summary}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options_partial_commits}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options_partial_payloads}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_source}

| 이름 | 유형 | 설명 |
|-|-|-|
| 입력 | 문자열 | 필수 입력 페이로드입니다. 추가 또는 업데이트할 구성 항목의 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 | 문자열 | 연결된 페이로드의 고유 항목 식별자입니다. 이 값은 무엇이든 될 수 있지만 페이로드 내에서 고유해야 합니다. |
| 입력.항목.조회 | 객체 배열 | 조회(조회 기반 식별)를 포함하는 최상위 항목을 식별합니다. 이러한 기록은 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 |
| 입력.항목.조회.값 | 객체 | 이름-값 쌍으로 된 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: 규칙을 실행합니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_tl4_qwp_snb} 기본값: false |
| input.items.settings.updateWithoutDowngrade | 부울 | 이 항목에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. * 아니오: 항목 업데이트와 다운그레이드가 모두 허용됩니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_jdl_pfb_sjb} 기본값: false |
| input.items.settings.updateWithoutSwitch | 부울 | 항목을 업데이트할 수 있고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. * 아니오: 항목 업데이트와 클래스 전환이 모두 허용됩니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_h4p_2gb_sjb} 기본값: false |
| input.items.settings.updateWithoutUpgrade | 부울 | 이 항목에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. * 아니오: 항목 업데이트와 업그레이드가 모두 허용됩니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_vqx_xfb_sjb} 기본값: 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 |
| 입력.항목.값 | 객체 | 이 관련 항목에 대해 이름/값 쌍으로 작성하거나 업데이트할 필드로, 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 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 | 객체 배열 | 입력 페이로드의 항목 간 참조를 정의하는 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| input.referenceItems.referenced | 문자열 | internal_id 다른 항목에서 참조하는 항목에 대해 정의되어 있습니다. |
| input.referenceItems.referencedBy | 문자열 | internal_id 다른 항목을 참조하는 항목에 대해 정의되어 있습니다. |
| input.referenceItems.referenceField | 문자열 | 항목의 클래스/테이블에 있는 참조 필드의 이름입니다 referencedBy . |
| 입력.관계 | 객체 배열 | 입력 페이로드의 항목 간의 관계를 지정하는 목록입니다. 이 배열의 객체는 두 형식 중 하나를 사용할 수 있습니다. * 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 이름-값 쌍을 사용하여 parentchild 두 최상위 항목 간의 관계를 정의할 수 있습니다. "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] * 이 객체는 키/값 쌍을 child_id 사용하여 parent_id 최상위 항목, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타낼 internal_id 수 있습니다. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_s1s_phb_nlb} |
| 입력.관계.하위 | 번호 | 관계의 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다(items, items.related 또는 items.lookup). |
| input.relations.child_id | 문자열 | internal_id 관계의 하위 항목(items, items.related 또는 items.lookup)의 |
| 입력.관계.상위 | 번호 | 배열에 있는 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 | 문자열 | 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다. 기본값: 테이블에서 기록을 생성할 때 source_feed 열에 "알 수 없음"sys_rel_source 저장됩니다. |
| 입력.관계.유형 | 문자열 | 상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. CI 관계 유형 \[cmdb_rel_type\] 테이블의 이름 필드 값이어야 합니다. |
| 옵션 | 객체 | 선택 사항이지만 {} 또는 null을 전달해야 합니다. 기능을 활성화하거나 비활성화하는 옵션입니다. 주: 기본적으로 또는 if partial_payloads true로 설정되어 있으며, 이러한 기능은 부분 페이로드 기능에 필수적이므로 false로 설정되더라도 둘 다 partial_commitsdeduplicate_payloads 활성화됩니다. "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: 중복 항목을 오류로 간주합니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_xv5_bws_mjb} 기본값: true |
| options.generate_summary | 부울 | 반환된 결과에 요약 정보가 포함되어 있는지 여부를 나타내는 플래그입니다. 반환된 요약 정보에 대한 자세한 내용은 반환 결과 테이블을 참조하십시오 \<String\>.summary . 유효한 값은 다음과 같습니다. * true: 요약 정보를 포함합니다. * false: 요약 정보를 포함하지 않습니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_w5w_mws_mjb} 기본값: false |
| options.partial_commits | 부울 | 부분 커밋 지원이 사용되는지 여부를 나타내는 플래그입니다. 부분 커밋에 대한 자세한 내용은 [향상된 IRE 기능을](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 참조하세요. 유효한 값은 다음과 같습니다. * true: 부분 커밋이 활성화되었습니다. * false: 부분 커밋이 비활성화되었습니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_k3p_wvs_mjb} 기본값: true |
| options.partial_payloads | 부울 | 부분 페이로드 지원이 활성화되었는지 여부를 나타내는 플래그입니다. 부분 페이로드에 대한 자세한 내용은 [향상된 IRE 기능](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 및 [IRE 데이터 소스 규칙 생성](https://www.servicenow.com/docs/access?context=create-ire-data-source-rule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)을 참조하십시오. 유효한 값은 다음과 같습니다. * true: 부분 페이로드가 활성화되었습니다. * false: 부분 페이로드가 비활성화되었습니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_tzb_tvs_mjb} 기본값: 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 시간 필드를 업데이트합니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_rhk_4tx_brb} 기본값: 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 시스템 속성의 값을 사용합니다. |
| 소스 | 문자열 | CI 정보의 데이터 소스입니다. 이 값은 구성 항목 \[cmdb_ci\] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. |
[표 3. 매개변수]

{#IESS-createOrUpdateCIEnhanced_S_S_S__table_vyh_fvh_sjb} {#IESS-createOrUpdateCIEnhanced_S_S_S__table_q4n_dvx_3lb__entry__2}{#IESS-createOrUpdateCIEnhanced_S_S_S__row-string-enhanced}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_additionalCommittedItems}{#IESS-createOrUpdateCIEnhanced_S_S_S__row-return-additionalCommittedItems-className}{#IESS-createOrUpdateCIEnhanced_S_S_S__row-return-additionalCommittedItems-errorCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-errors}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-errors-error}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-errors-message}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_identificationAttempts-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_idAtt_attemptResult-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_idAtt_attributes-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_idAtt_hybridEntryCIAtt-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_idAtt_identifierName-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_identifierEntrySysId-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_identifierEntrySysId2-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_inputIndices-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_markers-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_mergedPayloads-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_operation-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_sysId-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_warnings-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_warnings_error-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_warnings_message-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_additionalCommittedRelations}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_className-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_errorCount-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_errors-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_errors_error-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_errors_message-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_inputIndices-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_markers-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_mergedPayloadIds-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_operations-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_hasError}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_hasWarning}{#IESS-createOrUpdateCIEnhanced_S_S_S__items-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_additionalRelatedItems}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_addRelItems_className-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_addRelItems_inputIndices-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_additionalRelatedItems_mergedPayloadIds}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_additionalRelatedItems_operations}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_addRelItems_sysId-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_items_duplicateIndices}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_errorCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_error}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_errors_errors-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_errors_msg-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts_attemptResult}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts_attributes}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_identAtt_hyEntCiAtt-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts_identifierName}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts_searchOnTable}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identifierEntrySysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_incompleteSysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_info-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_info_code-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_info_message-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_info_ruleSysId-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_items_inputIndices}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_maskedAttributes}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_operation}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_partialSysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_errors}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_errors_error}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_errors-message}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_errorCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_inputIndices}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_inputIndices.mainIndex}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_inputIndices.subIndex}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_mergedPayloadIds}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_operation}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_sysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_warningCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_wrnings}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedSysIds}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_sys_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_errorsCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_errors}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_incompleteSysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_inputIndices}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_operation}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_partialSysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_sys_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_additionalInsertedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_errorCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_incompleteItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_insertedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_partialItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_summary_class_name_skippedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_unchangedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_updatedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_warningCount}

| 매개변수 | 설명 |
|-|-|
| \<문자열\> | 입력 문자열의 구성 항목에 대한 결과 목록인 JSON 형식의 문자열입니다. 데이터 유형: 문자열 { "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "hasError": Boolean, "hasWarning": Boolean, "items": [Array], "relations": [Array], "summary": {Object} } |
| \<String\>.additionalCommittedItems | 현재 페이로드의 IRE 처리 중에 커밋되었지만 현재 입력 페이로드에 없는 CI 목록입니다. 데이터 유형: 객체 배열 "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "operation": "String", "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "sysId": "String" } ] |
| \<String\>.additionalCommittedItems.className | 이 추가 CI의 Sys_class_name입니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedItems.errorCount | 이 추가 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자 |
| \<String\>.additionalCommittedItems.errors | 이 추가 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.additionalCommittedItems.errors.error | 추가 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedItems.errors.message | 추가 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedItems.identificationAttempts | 각 객체가 이 추가 CI를 식별하려는 시도를 설명하는 객체의 배열입니다. 데이터 유형: 객체 배열 "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| \<String\>.additionalCommittedItems.identificationAttempts.attemptResult | 이 추가 CI 식별 시도의 결과입니다. 데이터 유형: 문자열 가능한 값: * 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. * MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. * NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. * 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_axc_bxx_glb} |
| \<String\>.additionalCommittedItems.identificationAttempts.attributes | 이 추가 CI 식별 시도 중에 사용되는 CI 식별자 항목 속성입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| \<String\>.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes | 이 추가 CI 식별 시도 중에 사용되는 CI 식별자 항목 속성의 배열입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| \<String\>.additionalCommittedItems.identificationAttempts.identifierName | 이 추가 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedItems.identificationAttempts.searchOnTable | 이 추가 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedItems.identifierEntrySysId | 이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할 만한 값 - 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. |
| \<String\>.additionalCommittedItems.inputIndices | 이 추가 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값입니다. 데이터 유형: 숫자 배열 "inputIndices": [ { Number } ] |
| \<String\>.additionalCommittedItems.markers | 내부용 마커 값입니다. 데이터 유형: 배열 "markers": [] |
| \<String\>.additionalCommittedItems.mergedPayloads | 이 추가 CI를 처리하는 동안 병합된 CMDB IRE Partial Payloads \[cmdb_ire_partial_payloads\] 테이블의 부분 페이로드 값을 Sys_id합니다. 데이터 유형: 배열 "mergedPayloadIds": [ "String" ] |
| \<String\>.additionalCommittedItems.operation | 이 추가 CI에 대해 수행된 작업입니다. 데이터 유형: 문자열 가능한 값: * 삭제: 기존 CI가 대상 테이블에서 제거됩니다. * 삽입: 추가적인 CI가 대상 테이블에 새 기록으로 삽입됩니다. * NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다. * 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. * UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. * UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. * UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_dwt_qwx_glb} |
| \<String\>.additionalCommittedItems.sysId | 식별을 통해 이 추가 CI에 대한 Sys_id 찾았습니다. 데이터 유형: 문자열 주목할 만한 값 - 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. |
| \<String\>.additionalCommittedItems.warnings | 이 추가 CI를 처리하는 동안 발생한 경고에 대한 설명입니다. 데이터 유형: 객체 배열 "warnings": [ { "error": "String", "message": "String" } ] |
| \<String\>.additionalCommittedItems.warnings.error | 이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedItems.warnings.message | 이 추가 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedRelations | 종속 관계에 대한 설명 삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 CI입니다. 데이터 유형: 객체 배열 "additionalCommittedRelations": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String" } ] |
| \<String\>.additionalCommittedRelations.className | 이 추가 종속 관계 CI의 sys_class_name입니다. 데이터 유형: 문자열 지원되는 값: cmdb_rel_ci: CI 관계 테이블만 지원됩니다. |
| \<String\>.additionalCommittedRelations.errorCount | 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자 |
| \<String\>.additionalCommittedRelations.errors | 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류에 대한 설명입니다. 데이터 유형: 객체 배열 "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.additionalCommittedRelations.errors.error | 추가 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedRelations.errors.message | 이 추가 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열 |
| \<String\>.additionalCommittedRelations.inputIndices | 이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값입니다. 데이터 유형: 배열 "inputIndices": [ Number ] |
| \<String\>.additionalCommittedRelations.markers | 내부용 마커 값입니다. 데이터 유형: 배열 "markers": [] |
| \<String\>.additionalCommittedRelations.mergedPayloadIds | 이 CI에 대해 병합된 CMDB IRE Partial Payloads \[cmdb_ire_partial_payloads\] 테이블의 부분 페이로드에 대한 Sys_id 값입니다. 이 추가 종속 관계 CI를 처리하는 동안 병합되었습니다. 데이터 유형: 배열 "mergedPayloadIds": [ "String" ] |
| \<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가 업데이트됩니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_ltk_vxx_glb} 데이터 유형: 문자열 |
| \<String\>.hasError | 항목 또는 관계에 오류가 있는지 여부를 나타내는 플래그입니다. 데이터 유형: 부울 |
| \<String\>.hasWarning | 항목 또는 관계에 경고가 있는지 여부를 나타내는 플래그입니다. 데이터 유형: 부울 |
| \<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" } ] |
| \<String\>.items.additionalRelatedItems | 처리되었지만 입력 페이로드의 일부로 제공되지 않은 추가 조회 및 관련 항목에 대한 정보입니다. 이러한 항목은 부분 페이로드에서 가져온 것입니다. 데이터 유형: 객체 배열 "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "mergedPayloadIds": [Array], "operation": "String", "sysId": "String" } ] |
| \<String\>.items.additionalRelatedItems.className | 생성되거나 업데이트된 CI의 클래스/테이블 이름(sys_class_name)입니다. 데이터 유형: 문자열 |
| \<String\>.items.additionalRelatedItems.inputIndices | 이 관련 항목에 해당하는 요청 본문 items 배열의 CI 인덱스 값입니다. 데이터 유형: 숫자 배열 |
| \<String\>.items.additionalRelatedItems.mergedPayloadIds | 관련 항목에 병합된 부분 페이로드 sys_ids 목록입니다. 데이터 유형: 배열 테이블: CMDB IRE 부분 페이로드 \[cmdb_ire_partial_payloads\] |
| \<String\>.items.additionalRelatedItems.operation | 운영 유형입니다. 가능한 값: * INSERT: 새 CI가 데이터베이스에 삽입되었습니다. * NO_CHANGE: CI를 변경하지 않았습니다. * 업데이트: 기존 CI가 업데이트되었습니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_rk4_fxz_mjb} 데이터 유형: 문자열 |
| \<String\>.items.additionalRelatedItems.sysId | 업데이트되거나 생성된 CI의 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" } ] |
| \<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 | 식별 프로세스 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| \<String\>.items.identificationAttempts.identifierName | 이 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열 |
| \<String\>.items.identificationAttempts.searchOnTable | 식별 프로세스 중에 검색된 테이블의 이름입니다. 데이터 유형: 문자열 |
| \<String\>.items.identifierEntrySysId | CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 데이터 유형: 문자열 테이블: 식별자 항목 \[cmdb_identifier_entry\] |
| \<String\>.items.incompleteSysIds | 항목에 오류가 있고 미완료 페이로드로 저장된 경우 이 매개변수에는 CMDB IRE 미완료 페이로드 \[cmdb_ire_incomplete_payloads\] 테이블의 기록 sys_id이 포함됩니다. 데이터 유형: 문자열 |
| \<String\>.items.info | 항목 처리에 대한 추가 정보입니다. 데이터 유형: 객체 배열 "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| \<String\>.items.info.code | 건너뛴 재분류 유형입니다. 가능한 값: * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_UPGRADE {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_pb2_dxp_snb} 데이터 유형: 문자열 |
| \<String\>.items.info.message | 재분류를 건너뛰는 이유에 대한 추가 인사이트를 제공하는 메시지입니다. 데이터 유형: 문자열 |
| \<string\>.items.info.ruleSysId | 일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값은 비어 있습니다. 데이터 유형: 문자열 |
| \<String\>.items.inputIndices | 해당 입력 CI의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 또는 조회 CI의 경우 JSON 객체의 목록입니다. 데이터 유형: 숫자 배열 |
| \<String\>.items.maskedAttributes | [조정 규칙](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)에 정의된 대로 권한이 부여되지 않은 데이터 소스에 의한 업데이트를 건너뛴 속성 목록입니다. 데이터 유형: 배열 |
| \<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가 업데이트되고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_wyd_hj5_mjb} 데이터 유형: 문자열 |
| \<String\>.items.partialSysIds | 항목에 오류가 있고 부분 페이로드로 저장된 경우 이 매개변수에는 부분 페이로드 기록의 sys_id 포함됩니다. 데이터 유형: 문자열 |
| \<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] } ] |
| \<String\>.items.relatedItems.className | 관련 항목의 클래스/테이블 이름(sys_class_name)입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.errors | 관련 항목을 처리하는 동안 발생한 오류의 목록입니다. 데이터 유형: 객체 배열 "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.items.relatedItems.errors.error | 관련 항목을 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.errors.message | 오류와 관련된 오류 메시지입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.errorCount | 관련 항목을 처리하는 동안 탐지된 오류 수입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.incompleteSysIds | 관계에 오류가 있고 미완료 페이로드로 저장된 경우 이 값은 CMDB IRE 미완료 페이로드 \[cmdb_ire_incomplete_payloads\] 테이블의 기록 sys_id입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.inputIndices | 해당 입력 항목의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 항목 또는 조회 항목의 경우 JSON 객체의 목록입니다. 데이터 유형: 숫자 배열 또는 객체 배열 "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| \<String\>.items.relatedItems.inputIndices.mainIndex | 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.inputIndices.subIndex | 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.mergedPayloadIds | 처리 중에 CI에 병합된 부분 페이로드 sys_ids 목록입니다. 데이터 유형: 배열 |
| \<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가 업데이트되고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.partialSysIds | 관련 항목에 오류가 있고 부분 페이로드로 저장된 경우 여기에는 CMDB IRE 부분 페이로드 \[cmdb_ire_partial_payloads\] 테이블에 연결된 기록의 sys_ids 목록이 포함됩니다. 데이터 유형: 배열 |
| \<String\>.items.relatedItems.sysId | 관련 항목의 Sys_id입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.warningCount | 관련 항목을 처리할 때 발생한 경고 수입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.warnings | 관련 항목을 처리하는 동안 발생한 경고에 대한 설명입니다. 데이터 유형: 객체 배열 "warnings": [ { "error": "String", "message": "String" } ] |
| \<String\>.items.relatedItems.warnings.error | 관련 항목을 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.warnings.message | 경고와 관련된 메시지입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedSysIds | 관련 항목의 조회 기반 식별 중에 사용되는 CI의 sys_id 값 목록입니다. 데이터 유형: 문자열 |
| \<문자열\>.items.sys_id | 업데이트되거나 생성된 CI의 Sys_id입니다. 데이터 유형: 문자열 |
| \<String\>.relations | 요청 본문 relations 배열의 종속 관계 CI에 대한 설명입니다. 데이터 유형: 객체 배열 "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "incompleteSysIds": "String", "inputIndices": [Array], "operation": "String", "partialSysIds": "String", "sysId": "String" } ] |
| \<String\>.relations.className | 이 종속 관계 CI의 Sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블. 데이터 유형: 문자열 |
| \<String\>.relations.errorCount | 종속 관계 CI를 처리할 때 발생한 오류 수입니다. 데이터 유형: 숫자 |
| \<String\>.relations.errors | 이 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 목록입니다. 데이터 유형: 객체 배열 "errors": [ { "error": "String", "message": "String" } ] |
| \<string\>.relations.errors.error | 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열 |
| \<string\>.relations.errors.message | 이 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열 |
| \<String\>.relations.incompleteSysIds | 관계에 오류가 있고 미완료 페이로드로 저장된 경우 이 값은 CMDB IRE 미완료 페이로드 \[cmdb_ire_incomplete_payloads\] 테이블의 기록 sys_id입니다. 데이터 유형: 문자열 |
| \<String\>.relations.inputIndices | 이 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스입니다. 데이터 유형: 배열 |
| \<String\>.relations.operation | 수행된 작업의 유형입니다. 가능한 값: * 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입되었습니다. * INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 미완료 페이로드 \[cmdb_ire_incomplete_payloads\] 테이블에 삽입되었습니다. * INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE Partial Payloads \[cmdb_ire_partial_payloads\] 테이블에 삽입되었습니다. * NO_CHANGE: 수행된 작업이 없습니다. * 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다. 데이터 유형: 문자열 |
| \<String\>.relations.partialSysIds | 관계에 오류가 있고 부분 페이로드로 저장된 경우 이 값은 CMDB IRE 부분 페이로드 \[cmdb_ire_partial_payloads\] 테이블의 기록 sys_id입니다. 데이터 유형: 문자열 |
| \<String\>.relations.sysId | 종속 관계 CI의 Sys_id입니다. 데이터 유형: 문자열 |
| \<문자열\>.summary | 클래스당 삽입된 항목 수, 업데이트된 항목 수에 대한 통계를 제공하는 JSON 속성 목록입니다. 데이터 유형: 배열 |
| \<string\>.summary.\<class_name\> | 특정 클래스에 대한 통계입니다. 데이터 유형: 객체 <class_name>: { "additionalInsertedItemCount": Number, "errorCount": Number, "incompleteItemCount": Number, "insertedItemCount": Number, "partialItemCount": Number, "skippedItemCount": Number, "unchangedItemCount": Number, "updatedItemCount": Number, "warningCount": Number } |
| \<String\>.summary.\<class_name\>.additionalInsertedItemCount | 부분 페이로드 처리로 인해 삽입된 항목 수입니다. 데이터 유형: 숫자 |
| \<string\>.summary.\<class_name\>.errorCount | 항목을 처리할 때 발생하는 오류 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.incompleteItemCount | CMDB IRE 미완료 페이로드 \[cmdb_ire_incomplete_payloads\] 테이블에 삽입된 항목 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.insertedItemCount | 생성된 항목 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.partialItemCount | 부분 페이로드 테이블 \[cmdb_ire_partial_payloads\]에 저장된 항목 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.skippedItemCount | 건너뛴 항목 수입니다. 데이터 유형: 숫자 |
| \<문자열\>.요약.\<class_name\>.unchangedItemCount | 항목이 있지만 수정되지 않은 항목의 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.updatedItemCount | 업데이트된 항목 수입니다. 데이터 유형: 숫자 |
| \<string\>.summary.\<class_name\>.warningCount | 처리 시 경고를 생성한 항목 수입니다. 데이터 유형: 숫자 |
[표 4. 반환]

{#IESS-createOrUpdateCIEnhanced_S_S_S__table_q4n_dvx_3lb}  
이 예시에서는 여러 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 = JSON.stringify((payload));
    var output = sn_cmdb.IdentificationEngine.createOrUpdateCIEnhanced('ServiceNow', input, {});

    gs.info(JSON.stringify(JSON.parse(output), null, 2));

출력:

    {

    "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": []
    }

## IdentificationEngine - identifyCI(String jsonString) {#ariaid-title4}

데이터베이스에서 작업을 커밋하지 않고 지정된 페이로드로 수행할 작업(삽입/업데이트)을 결정합니다.
이는 createOrUpdateCI()와 동일하게 작동하지만 결과를 커밋하지는 않습니다.
{#IESS-identifyCI_S__id_mqd_n1t_pyb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| json문자열 | 문자열 | 추가 또는 업데이트할 구성 항목의 JSON 형식 문자열입니다. 각 입력 문자열은 '항목: \[{}\], 관계:\[{}\]" 형식이며, 여기서 항목 및 관계 목록 내의 각 항목에는 이름-값 쌍이 포함됩니다. 항목 목록 내에서 가능한 이름-값 쌍은 다음과 같습니다. * className: 만들거나 업데이트할 CI의 Sys_class_name입니다. * 조회:\[{}\]: 항목 목록과 같은 이름-값 쌍이 있는 각 항목의 기록 목록입니다. * 값:{}: 이름-값 쌍으로 된 CI에 대한 필드 정보이며, 여기서 이름은 필드 이름입니다. 관계 목록 내에서 가능한 이름-값 쌍은 다음과 같습니다. * child: 의존성 관계에 있는 하위 항목의 인덱스입니다. * parent: 의존성 관계에 있는 상위 항목의 인덱스입니다. * 유형: 관계 유형입니다. cmdb_rel_type 테이블의 이름 필드 값 중 하나입니다. |
[표 5. 매개변수]

{#IESS-identifyCI_S__id_mqd_n1t_pyb} {#IESS-identifyCI_S__id_vn1_51t_pyb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 결과 목록인 JSON 형식의 문자열입니다. 각 결과 문자열은 '항목: \[{}\], 관계:\[{}\]' 형식이며, 여기서 항목 및 관계 목록 내의 각 항목에는 이름-값 쌍이 포함됩니다. 항목 목록 내에서 가능한 이름-값 쌍은 다음과 같습니다. * className: 업데이트되거나 생성된 CI에 대한 Sys_class_name입니다. * duplicateIndices: 현재 항목과 중복되는 항목의 인덱스 목록입니다. * 오류: (오류, 메시지 문자열) 형식의 오류 목록입니다. * identificationAttempts: 시도 목록입니다. * attemptResult: SKIPPED, NO_MATCH, MATCHED, MULTI_MATCH 중 하나입니다. * 속성: 식별 중에 사용되는 식별자 항목의 속성입니다. * identiferName: 이 식별자 항목이 속한 CI 식별자입니다. * searchOnTable: 식별 프로세스 중에 검색된 테이블입니다. * identifierEntrySysId: 일치 중에 사용되는 식별자 항목의 Sys_id입니다. * operation: 수행할 작업이며 다음 중 하나입니다. * 삭제 * 삽입 * 업데이트 * UPDATE_WITH_DOWNGRADE * UPDATE_WITH_SWITCH * UPDATE_WITH_UPGRADE * relatedSysIds: 조회 기반 식별 중에 사용되는 CI의 sys_id 값 목록입니다. * sysId: 업데이트되거나 생성된 CI의 Sys_id입니다. {#IESS-identifyCI_S__ul_axv_x4h_1t} 관계 목록 내에서 가능한 이름-값 쌍은 다음과 같습니다. * className: 관계 CI의 클래스 이름이며 항상 cmdb_rel_ci됩니다. * 작업: 작업 유형: 삽입, 업데이트, NO_CHANGE * sysId: 삽입되거나 업데이트된 관계 CI의 Sys_id {#IESS-identifyCI_S__ul_ajf_wzl_jt} |
[표 6. 반환]

{#IESS-identifyCI_S__id_vn1_51t_pyb}  
다음은 구성 항목을 재분류하는 방법을 보여줍니다.

    var payload = {
      "items": [
        {
          "className": "cmdb_ci_win_server",
          "values": {
            "short_description": "Linux server description",
            "name": "Linux Server 1"
          }
        }
      ]
    };

    var input = JSON.stringify(payload);
    var output = sn_cmdb.IdentificationEngine.identifyCI(input);

    gs.info(JSON.stringify(JSON.parse(output), null, 2));

출력:

    {
      "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": []
    }

## IdentificationEngine - identifyCIEnhanced(문자열 소스, 문자열 입력, 객체 옵션) {#ariaid-title5}

데이터베이스에서 구성 관리 데이터베이스(CMDB) 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다.
이 방법을 사용하여 페이로드 제출을 시뮬레이션합니다.  
이 메서드는 메서드와 [IdentificationEngine - identifyCI(String jsonString)](https://servicenow-prod.fluidtopics.net/AKs_4WOUCoF_ELzhcpnYFQ#IESS-identifyCI_S "데이터베이스에서 작업을 커밋하지 않고 지정된 페이로드로 수행할 작업(삽입/업데이트)을 결정합니다.") 비슷하지만 다음 기능도 지원합니다.

* 부분 페이로드
  * 항목에 경고 또는 오류가 있는 경우 항목 작업이 INSERT_AS_PARTIAL되었는지 또는 INSERT_INCOMPLETE 여부를 나타냅니다.
  * 기존 부분 페이로드와 병합된 부분 페이로드의 sys_ids를 반환합니다.
  {#IESS-identifyCIEnhanced_S_S_O__ul_x4s_nvk_xlb}
* 페이로드 중복 제거 기능을 지원합니다.
* 요약을 생성합니다.
{#IESS-identifyCIEnhanced_S_S_O__ul_scj_jvk_xlb}
{#IESS-identifyCIEnhanced_S_S_O__IRE-payload__entry__3}{#IESS-identifyCIEnhanced_S_S_O__entry_input}{#IESS-identifyCIEnhanced_S_S_O__entry_items}{#IESS-identifyCIEnhanced_S_S_O__entry_className}{#IESS-identifyCIEnhanced_S_S_O__entry-display_values-ire}{#IESS-identifyCIEnhanced_S_S_O__entry_internal_id}{#IESS-identifyCIEnhanced_S_S_O__entry_lookup}{#IESS-identifyCIEnhanced_S_S_O__entry-input_items_lookup_className}{#IESS-identifyCIEnhanced_S_S_O__entry_related}{#IESS-identifyCIEnhanced_S_S_O__entry-input_items_related_className}{#IESS-identifyCIEnhanced_S_S_O__entry_items_settings}{#IESS-identifyCIEnhanced_S_S_O__items_set_skipReclassRestrictRules-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutDowngrade}{#IESS-identifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutSwitch}{#IESS-identifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutUpgrade}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_feed}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_name}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_native_key}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_recency_timestamp}{#IESS-identifyCIEnhanced_S_S_O__entry_values}{#IESS-identifyCIEnhanced_S_S_O__entry_referenceItems}{#IESS-identifyCIEnhanced_S_S_O__entry_referenceItems_referenced}{#IESS-identifyCIEnhanced_S_S_O__entry_referenceItems_referencedBy}{#IESS-identifyCIEnhanced_S_S_O__entry_referenceItems_referenceField}{#IESS-identifyCIEnhanced_S_S_O__entry_relations}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_child}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_child_id}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_parent}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_parent_id}{#IESS-identifyCIEnhanced_S_S_O__sys_rel_source_info-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__sys_rel_source_info-source_name-entry-ire}{#IESS-identifyCIEnhanced_S_S_O__sys_rel_source_into-source_feed-entry-ire}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_type}{#IESS-identifyCIEnhanced_S_S_O__entry_options}{#IESS-identifyCIEnhanced_S_S_O__entry_options_deduplicate_payloads}{#IESS-identifyCIEnhanced_S_S_O__entry_options_generate_summary}{#IESS-identifyCIEnhanced_S_S_O__entry_options_partial_commits}{#IESS-identifyCIEnhanced_S_S_O__entry_options_partial_payloads}{#IESS-identifyCIEnhanced_S_S_O__entry_source}

| 이름 | 유형 | 설명 |
|-|-|-|
| 입력 | 문자열 | 필수 입력 페이로드입니다. 추가 또는 업데이트할 구성 항목의 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 | 문자열 | 연결된 페이로드의 고유 항목 식별자입니다. 이 값은 무엇이든 될 수 있지만 페이로드 내에서 고유해야 합니다. |
| 입력.항목.조회 | 객체 배열 | 조회(조회 기반 식별)를 포함하는 최상위 항목을 식별합니다. 이러한 기록은 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 |
| 입력.항목.조회.값 | 객체 | 이름-값 쌍으로 된 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: 규칙을 실행합니다. {#IESS-identifyCIEnhanced_S_S_O__ul_tl4_qwp_snb} 기본값: false |
| input.items.settings.updateWithoutDowngrade | 부울 | 이 항목에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. * 아니오: 항목 업데이트와 다운그레이드가 모두 허용됩니다. {#IESS-identifyCIEnhanced_S_S_O__ul_jdl_pfb_sjb} 기본값: false |
| input.items.settings.updateWithoutSwitch | 부울 | 항목을 업데이트할 수 있고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. * 아니오: 항목 업데이트와 클래스 전환이 모두 허용됩니다. {#IESS-identifyCIEnhanced_S_S_O__ul_h4p_2gb_sjb} 기본값: false |
| input.items.settings.updateWithoutUpgrade | 부울 | 이 항목에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. * 아니오: 항목 업데이트와 업그레이드가 모두 허용됩니다. {#IESS-identifyCIEnhanced_S_S_O__ul_vqx_xfb_sjb} 기본값: 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 |
| 입력.항목.값 | 객체 | 이 관련 항목에 대해 이름/값 쌍으로 작성하거나 업데이트할 필드로, 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 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 | 객체 배열 | 입력 페이로드의 항목 간 참조를 정의하는 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| input.referenceItems.referenced | 문자열 | internal_id 다른 항목에서 참조하는 항목에 대해 정의되어 있습니다. |
| input.referenceItems.referencedBy | 문자열 | internal_id 다른 항목을 참조하는 항목에 대해 정의되어 있습니다. |
| input.referenceItems.referenceField | 문자열 | 항목의 클래스/테이블에 있는 참조 필드의 이름입니다 referencedBy . |
| 입력.관계 | 객체 배열 | 입력 페이로드의 항목 간의 관계를 지정하는 목록입니다. 이 배열의 객체는 두 형식 중 하나를 사용할 수 있습니다. * 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 이름-값 쌍을 사용하여 parentchild 두 최상위 항목 간의 관계를 정의할 수 있습니다. "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] * 이 객체는 키/값 쌍을 child_id 사용하여 parent_id 최상위 항목, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타낼 internal_id 수 있습니다. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#IESS-identifyCIEnhanced_S_S_O__ul_s1s_phb_nlb} |
| 입력.관계.하위 | 번호 | 관계의 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다(items, items.related 또는 items.lookup). |
| input.relations.child_id | 문자열 | internal_id 관계의 하위 항목(items, items.related 또는 items.lookup)의 |
| 입력.관계.상위 | 번호 | 배열에 있는 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 | 문자열 | 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다. 기본값: 테이블에서 기록을 생성할 때 source_feed 열에 "알 수 없음"sys_rel_source 저장됩니다. |
| 입력.관계.유형 | 문자열 | 상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. CI 관계 유형 \[cmdb_rel_type\] 테이블의 이름 필드 값이어야 합니다. |
| 옵션 | 객체 | 선택 사항이지만 {} 또는 null을 전달해야 합니다. 기능을 활성화하거나 비활성화하는 옵션입니다. 주: 기본적으로 또는 if partial_payloads true로 설정되어 있으며, 이러한 기능은 부분 페이로드 기능에 필수적이므로 false로 설정되더라도 둘 다 partial_commitsdeduplicate_payloads 활성화됩니다. "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: 중복 항목을 오류로 간주합니다. {#IESS-identifyCIEnhanced_S_S_O__ul_xv5_bws_mjb} 기본값: true |
| options.generate_summary | 부울 | 반환된 결과에 요약 정보가 포함되어 있는지 여부를 나타내는 플래그입니다. 반환된 요약 정보에 대한 자세한 내용은 반환 결과 테이블을 참조하십시오 \<String\>.summary . 유효한 값은 다음과 같습니다. * true: 요약 정보를 포함합니다. * false: 요약 정보를 포함하지 않습니다. {#IESS-identifyCIEnhanced_S_S_O__ul_w5w_mws_mjb} 기본값: false |
| options.partial_commits | 부울 | 부분 커밋 지원이 사용되는지 여부를 나타내는 플래그입니다. 부분 커밋에 대한 자세한 내용은 [향상된 IRE 기능을](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 참조하세요. 유효한 값은 다음과 같습니다. * true: 부분 커밋이 활성화되었습니다. * false: 부분 커밋이 비활성화되었습니다. {#IESS-identifyCIEnhanced_S_S_O__ul_k3p_wvs_mjb} 기본값: true |
| options.partial_payloads | 부울 | 부분 페이로드 지원이 활성화되었는지 여부를 나타내는 플래그입니다. 부분 페이로드에 대한 자세한 내용은 [향상된 IRE 기능](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 및 [IRE 데이터 소스 규칙 생성](https://www.servicenow.com/docs/access?context=create-ire-data-source-rule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)을 참조하십시오. 유효한 값은 다음과 같습니다. * true: 부분 페이로드가 활성화되었습니다. * false: 부분 페이로드가 비활성화되었습니다. {#IESS-identifyCIEnhanced_S_S_O__ul_tzb_tvs_mjb} 기본값: 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 시간 필드를 업데이트합니다. {#IESS-identifyCIEnhanced_S_S_O__ul_rhk_4tx_brb} 기본값: 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 시스템 속성의 값을 사용합니다. |
| 소스 | 문자열 | CI 정보의 데이터 소스입니다. 이 값은 구성 항목 \[cmdb_ci\] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. |
[표 7. 매개변수]

{#IESS-identifyCIEnhanced_S_S_O__table_lqf_msb_jlb} {#IESS-identifyCIEnhanced_S_S_O__entry__170}{#IESS-identifyCIEnhanced_S_S_O__entry_return_additionalCommittedRelations}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_hasError}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_hasWarning}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems}{#IESS-identifyCIEnhanced_S_S_O__items_addRelItems_className-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__items_addRelItems_inputIndices-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems_mergedPayloadIds}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems_operations}{#IESS-identifyCIEnhanced_S_S_O__items_addRelItems_sysId-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_className}{#IESS-identifyCIEnhanced_S_S_O__entry_return_items_duplicateIndices}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_errorCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_error}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_attemptResult}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_attributes}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_identifierName}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_searchOnTable}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identifierEntrySysId}{#IESS-identifyCIEnhanced_S_S_O__entry_return_items_inputIndices}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_maskedAttributes}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_operation}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_identifyCI}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_errorCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_errors}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices.mainIndex}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices.subIndex}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedSysIds}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_sys_id}{#IESS-identifyCIEnhanced_S_S_O___identifyCI}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_className}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_errorsCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_errors}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_inputIndices}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_operation}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_sys_id}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_additionalInsertedItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_errorCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_incompleteItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_insertedItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_partialItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_unchangedItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_updatedItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_warningCount}

| 유형 | 설명 |
|-|-|
| \<문자열\> | 입력 문자열의 구성 항목에 대한 결과 목록인 JSON 형식의 문자열입니다. 데이터 유형: 문자열 { "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "hasError": Boolean, "hasWarning": Boolean, "items": [Array], "relations": [Array], "summary": {Object} } |
| \<String\>.additionalCommittedItems | 현재 페이로드의 IRE 처리 중에 커밋되었지만 현재 입력 페이로드에 없는 CI 목록입니다. 데이터 유형: 객체 배열 "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "operation": "String", "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "sysId": "String" } ] |
| \<String\>.additionalCommittedRelations | 종속 관계에 대한 설명 삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 CI입니다. 데이터 유형: 객체 배열 "additionalCommittedRelations": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String" } ] |
| \<String\>.hasError | 항목 또는 관계에 오류가 있는지 여부를 나타내는 플래그입니다. 데이터 유형: 부울 |
| \<String\>.hasWarning | 항목 또는 관계에 경고가 있는지 여부를 나타내는 플래그입니다. 데이터 유형: 부울 |
| \<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" } ] |
| \<String\>.items.additionalRelatedItems | 처리되었지만 입력 페이로드의 일부로 제공되지 않은 추가 조회 및 관련 항목에 대한 정보입니다. 이러한 항목은 부분 페이로드에서 가져온 것입니다. 데이터 유형: 객체 배열 "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "mergedPayloadIds": [Array], "operation": "String", "sysId": "String" } ] |
| \<String\>.items.additionalRelatedItems.className | 생성되거나 업데이트된 CI의 클래스/테이블 이름(sys_class_name)입니다. 데이터 유형: 문자열 |
| \<String\>.items.additionalRelatedItems.inputIndices | 이 관련 항목에 해당하는 요청 본문 items 배열의 CI 인덱스 값입니다. 데이터 유형: 숫자 배열 |
| \<String\>.items.additionalRelatedItems.mergedPayloadIds | 관련 항목에 병합된 부분 페이로드 sys_ids 목록입니다. 데이터 유형: 배열 테이블: CMDB IRE 부분 페이로드 \[cmdb_ire_partial_payloads\] |
| \<String\>.items.additionalRelatedItems.operation | 운영 유형입니다. 가능한 값: * INSERT: 새 CI가 데이터베이스에 삽입되었습니다. * NO_CHANGE: CI를 변경하지 않았습니다. * 업데이트: 기존 CI가 업데이트되었습니다. {#IESS-identifyCIEnhanced_S_S_O__ul_rk4_fxz_mjb} 데이터 유형: 문자열 |
| \<String\>.items.additionalRelatedItems.sysId | 업데이트되거나 생성된 CI의 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" } ] |
| \<String\>.items.errors.error | CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열 |
| \<String\>.items.errors.message | CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열 |
| \<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.identifierName | 이 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열 |
| \<String\>.items.identificationAttempts.searchOnTable | 식별 프로세스 중에 검색된 테이블의 이름입니다. 데이터 유형: 문자열 |
| \<String\>.items.identifierEntrySysId | CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 데이터 유형: 문자열 테이블: 식별자 항목 \[cmdb_identifier_entry\] |
| \<문자열\>.items.info | 항목 처리에 대한 추가 정보입니다. 데이터 유형: 객체 배열 "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| \<String\>.items.info.code | 건너뛴 재분류 유형입니다. 가능한 값: * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_UPGRADE {#IESS-identifyCIEnhanced_S_S_O__ul_m11_1zp_snb} 데이터 유형: 문자열 |
| \<String\>.items.info.message | 재분류를 건너뛰는 이유에 대한 추가 인사이트를 제공하는 메시지입니다. 데이터 유형: 문자열 |
| \<string\>.items.info.ruleSysId | 일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값은 비어 있습니다. 데이터 유형: 문자열 |
| \<String\>.items.inputIndices | 해당 입력 CI의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 또는 조회 CI의 경우 JSON 객체의 목록입니다. 데이터 유형: 숫자 배열 |
| \<String\>.items.maskedAttributes | [조정 규칙](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)에 정의된 대로 권한이 부여되지 않은 데이터 소스에 의한 업데이트를 건너뛴 속성 목록입니다. 데이터 유형: 배열 |
| \<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가 업데이트되고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다. {#IESS-identifyCIEnhanced_S_S_O__ul_wyd_hj5_mjb} 데이터 유형: 문자열 |
| \<String\>.items.relatedItems | 처리된 관련 항목에 대한 정보입니다. 데이터 유형: 객체 배열 "relatedItems": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "mergePayloadIds": [Array], "operation": "String", "sysId": "String", "warningCount": Number, "warnings": [Array] } ] |
| \<String\>.items.relatedItems.className | 관련 항목의 클래스/테이블 이름(sys_class_name)입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.errorCount | 관련 항목을 처리하는 동안 탐지된 오류 수입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.errors | 관련 항목을 처리하는 동안 발생한 오류의 목록입니다. 데이터 유형: 객체 배열 "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.items.relatedItems.errors.error | 관련 항목을 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.errors.message | 관련 항목을 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.inputIndices | 해당 입력 항목의 인덱스입니다. 최상위 항목의 경우 정수 목록입니다. 관련 항목 또는 조회 항목의 경우 JSON 객체의 목록입니다. 데이터 유형: 숫자 배열 또는 객체 배열 "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| \<String\>.items.relatedItems.inputIndices.mainIndex | 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.inputIndices.subIndex | 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.mergedPayloadIds | 처리 중에 CI에 병합된 부분 페이로드 sys_ids 목록입니다. 데이터 유형: 배열 |
| \<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가 업데이트되고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.sysId | 관련 항목의 Sys_id입니다. 데이터 유형: 문자열 |
| \<String\>.items.relatedItems.warningCount | 관련 항목을 처리할 때 발생한 경고 수입니다. 데이터 유형: 숫자 |
| \<String\>.items.relatedItems.warnings | 관련 항목을 처리하는 동안 발생한 경고에 대한 설명입니다. 데이터 유형: 객체 배열 "warnings": [ { "error": "String", "message": "String" } ] |
| \<String\>.items.relatedSysIds | 관련 항목의 조회 기반 식별 중에 사용되는 CI의 sys_id 값 목록입니다. 데이터 유형: 문자열 |
| \<문자열\>.items.sys_id | 업데이트되거나 생성된 CI의 Sys_id입니다. 데이터 유형: 문자열 |
| \<String\>.relations | 처리된 관계에 대한 정보입니다. 데이터 유형: 객체 배열 "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "operation": "String", "sysId": "String" } ] |
| \<String\>.relations.className | 이 종속 관계 CI의 Sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블. 데이터 유형: 문자열 |
| \<String\>.relations.errorCount | 종속 관계 CI를 처리할 때 발생한 오류 수입니다. 데이터 유형: 숫자 |
| \<String\>.relations.errors | 이 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 목록입니다. 데이터 유형: 객체 배열 "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.relations.inputIndices | 이 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스입니다. 데이터 유형: 배열 |
| \<String\>.relations.operation | 수행된 작업의 유형입니다. 가능한 값: * 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입되었습니다. * INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 미완료 페이로드 \[cmdb_ire_incomplete_payloads\] 테이블에 삽입되었습니다. * INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE Partial Payloads \[cmdb_ire_partial_payloads\] 테이블에 삽입되었습니다. * NO_CHANGE: 수행된 작업이 없습니다. * 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다. 데이터 유형: 문자열 |
| \<String\>.relations.sysId | 종속 관계 CI의 Sys_id입니다. 데이터 유형: 문자열 |
| \<문자열\>.summary | 클래스당 삽입된 항목 수, 업데이트된 항목 수에 대한 통계를 제공하는 JSON 속성 목록입니다. 데이터 유형: 배열 |
| \<string\>.summary.\<class_name\> | 특정 클래스에 대한 통계입니다. 데이터 유형: 객체 <class_name>: { "additionalInsertedItemCount": Number, "errorCount": Number, "incompleteItemCount": Number, "insertedItemCount": Number, "partialItemCount": Number, "skippedItemCount": Number, "unchangedItemCount": Number, "updatedItemCount": Number, "warningCount": Number } |
| \<String\>.summary.\<class_name\>.additionalInsertedItemCount | 부분 페이로드 처리로 인해 삽입된 항목 수입니다. 데이터 유형: 숫자 |
| \<string\>.summary.\<class_name\>.errorCount | 항목을 처리할 때 발생하는 오류 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.incompleteItemCount | CMDB IRE 미완료 페이로드 \[cmdb_ire_incomplete_payloads\] 테이블에 삽입된 항목 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.insertedItemCount | 생성된 항목 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.partialItemCount | 부분 페이로드 테이블 \[cmdb_ire_partial_payloads\]에 저장된 항목 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.skippedItemCount | 건너뛴 항목 수입니다. 데이터 유형: 숫자 |
| \<문자열\>.요약.\<class_name\>.unchangedItemCount | 항목이 있지만 수정되지 않은 항목의 수입니다. 데이터 유형: 숫자 |
| \<String\>.summary.\<class_name\>.updatedItemCount | 업데이트된 항목 수입니다. 데이터 유형: 숫자 |
| \<string\>.summary.\<class_name\>.warningCount | 처리 시 경고를 생성한 항목 수입니다. 데이터 유형: 숫자 |
[표 8. 반환]

    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": {
            "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|16777229"
      }}
    ],
      "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 = JSON.stringify(payload);
    var output = sn_cmdb.IdentificationEngine.identifyCIEnhanced('ServiceNow', input, {});

    gs.info(JSON.stringify(JSON.parse(output), null, 2));

출력:

    {
      "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": []
    }  

## IdentificationEngine - runIdentificationAudit(GlideRecord now_GR) {#ariaid-title6}

지정된 CI(구성 항목)에 대한 식별 감사를 실행하여 중복을 탐지합니다.
중복이 발견되면 중복 작업이 생성됩니다. 독립적인 식별 규칙이 있는 CI 유형에서만 이 방법을 사용하십시오.
{#IESS-runIdentificationAudit_GR__table_l3p_n3c_tx__entry__3}

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

{#IESS-runIdentificationAudit_GR__table_l3p_n3c_tx} {#IESS-runIdentificationAudit_GR__table_m3p_n3c_tx__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 10. 반환]

{#IESS-runIdentificationAudit_GR__table_m3p_n3c_tx}  
다음 예제는 Linux 서버 \[cmdb_ci_linux_server\] 테이블의 레코드에 중복이 있는지 확인하는 방법을 보여줍니다.

    var sysId = '<cbdb_ci_sys_id>';
    var gr = new GlideRecord('cmdb_ci_linux_server');
    gr.get(sysId);
    sn_cmdb.IdentificationEngine.runIdentificationAudit(gr);


