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


---

# CMDBTransformUtil - 전역

# CMDBTransformUtil - 전역 {#ariaid-title1}

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

CMDBTransformUtil 스크립트 포함은 IRE(식별 및 조정) 프레임워크를 사용하여 중복 CI(구성 항목)의 생성을 최소화합니다.

또한 IRE 프레임워크는 `onBefore` 변환 맵 스크립트를 업데이트 CMDB 할 때 승인된 소스의 정보만 수락하여 CI 속성을 조정합니다. 다른 스크립트에서는 이 클래스를 사용할 수 없습니다. IRE 프레임워크의 작동 방식에 대한 자세한 내용은 [CMDB 식별 및 조정](https://www.servicenow.com/docs/access?context=c_CMDBIdentifyandReconcile&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)을 참조하십시오.

## CMDBTransformUtil - CMDBTransformUtil() {#ariaid-title2}

CMDBTransformUtil 객체를 만듭니다.
{#r_CMDBTransformUtil-CMDBTransformUtil__table_fpq_ttd_bt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 1. 매개변수]

{#r_CMDBTransformUtil-CMDBTransformUtil__table_fpq_ttd_bt}  

    var cmdbUtil = new CMDBTransformUtil();

## CMDBTransformUtil - getError() {#ariaid-title3}

이전 identifyAndReconcile() 또는 identifyAndReconcileEnhanced() 메서드 호출에서 생성된 모든 오류를 반환합니다.
onBefore 변환 맵 스크립트에서 이 메서드를 사용하여 오류를 가져옵니다. [hasError()](https://servicenow-prod.fluidtopics.net/9qEZ04nHPkrKk1scverJ0Q#CMDBTU-hasError "이전 identifyAndReconcile() 또는 identifyAndReconcileEnhanced() 메서드 호출에서 오류가 발생했는지 여부를 결정합니다.") 메서드를 사용하여 먼저 identifyAndReconcile() 또는 identifyAndReconcileEnhanced() 메서드에서 오류를 감지합니다.
{#CMDBTU-getError__table_m1n_lxg_gz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 2. 매개변수]

{#CMDBTU-getError__table_m1n_lxg_gz} {#CMDBTU-getError__table_n1n_lxg_gz__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | identifyAndReconcile() 또는 identifyAndReconcileEnhanced()의 오류 메시지입니다. |
[표 3. 반환]

{#CMDBTU-getError__table_n1n_lxg_gz}  

    // Add this code to the onBefore transform map script
    // Call CMDB API to do Identification and Reconciliation of the current row
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.setDataSource('ImportSet');
    cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
    ignore = true;

    if (cmdbUtil.hasError()) {
      var errorMessage = cmdbUtil.getError();
      log.error(errorMessage);
    } else {
      log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
      log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
    }

### 범위가 지정된 해당 항목

이 메서드에 해당하는 범위가 없습니다.

## CMDBTransformUtil - getOutputPayload() {#ariaid-title4}

이전 identifyAndReconcile() 또는 identifyAndReconcileEnhanced() 메서드 호출에서 JSON 페이로드를 반환합니다.
onBefore 변환 맵 스크립트에서 이 메서드를 사용합니다.
{#CMDBTU-getOutputPayload__table_u43_q5g_gz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 4. 매개변수]

{#CMDBTU-getOutputPayload__table_u43_q5g_gz} {#CMDBTU-getOutputPayload__table_dyb_nh4_ylb__entry__2}{#CMDBTU-getOutputPayload__entry_return_item_className}{#CMDBTU-getOutputPayload__entry_return_items_duplicateIndices}{#CMDBTU-getOutputPayload__entry_return_item_error}{#CMDBTU-getOutputPayload__items_errors_errors-entry-IRE}{#CMDBTU-getOutputPayload__items_errors_msg-entry-IRE}{#CMDBTU-getOutputPayload__entry_return_item_identificationAttempts}{#CMDBTU-getOutputPayload__entry_return_item_identificationAttempts_attemptResult}{#CMDBTU-getOutputPayload__entry_return_item_identificationAttempts_attributes}{#CMDBTU-getOutputPayload__entry_return_item_identificationAttempts_identifierName}{#CMDBTU-getOutputPayload__entry_return_item_identificationAttempts_searchOnTable}{#CMDBTU-getOutputPayload__entry_return_item_identifierEntrySysId}{#CMDBTU-getOutputPayload__items_info-entry-IREE}{#CMDBTU-getOutputPayload__entry_return_item_maskedAttributes}{#CMDBTU-getOutputPayload__entry_return_item_sys_id}{#CMDBTU-getOutputPayload__entry_return_relations_className}{#CMDBTU-getOutputPayload__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가 업데이트되었습니다. {#CMDBTU-getOutputPayload__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 {#CMDBTU-getOutputPayload__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가 업데이트되었습니다. {#CMDBTU-getOutputPayload__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입니다. 데이터 유형: 문자열 |
[표 5. 반환]

{#CMDBTU-getOutputPayload__table_dyb_nh4_ylb}  

    // Add this code to the onBefore transform map script
    // Call CMDB API to do Identification and Reconciliation of the current row
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.setDataSource('ImportSet');
    cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
    ignore = true;

    if (cmdbUtil.hasError()) {
      var errorMessage = cmdbUtil.getError();
      log.error(errorMessage);
    } else {
      log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
      log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
    }

### 범위가 지정된 해당 항목

이 메서드에 해당하는 범위가 없습니다.

## CMDBTransformUtil - getOutputRecordSysId() {#ariaid-title5}

삽입되거나 업데이트된 CI(구성 항목)의 sys_id 반환합니다.
onBefore 변환 맵 스크립트에서 이 메서드를 사용합니다.
{#CMDBTU-getOutputRecordSysId__table_yjp_ggz_fz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 6. 매개변수]

{#CMDBTU-getOutputRecordSysId__table_yjp_ggz_fz} {#CMDBTU-getOutputRecordSysId__table_zjp_ggz_fz__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 삽입되거나 업데이트된 CI의 Sys_id입니다. |
[표 7. 반환]

{#CMDBTU-getOutputRecordSysId__table_zjp_ggz_fz}  

    // Add this code to the onBefore transform map script
    // Call CMDB API to do Identification and Reconciliation of current row
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.setDataSource('ImportSet');
    cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
    ignore = true;

    if (cmdbUtil.hasError()) {
      var errorMessage = cmdbUtil.getError();
      log.error(errorMessage);
    } else {
      log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
      log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
    }

### 범위가 지정된 해당 항목

이 메서드에 해당하는 범위가 없습니다.

## CMDBTransformUtil - getPayload(객체 소스, 객체 맵, 객체 로그) {#ariaid-title6}

지정된 입력에서 생성된 JSON 페이로드를 반환합니다.
그런 다음 페이로드를 수정하고 setPayload() 메서드를 사용하여 업데이트된 페이로드를 저장할 수 있습니다. 페이로드가 수정되고 저장되면 identifyAndReconcile() 또는 identifyAndReconcileEnhanced() 를 사용하여 페이로드를 처리합니다.
{#CMDBTU-getPayload_O_O_O__table_t5y_5cb_k4b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 소스 | 객체 | 수신 기록을 포함하는 변환 맵 스크립트에서 사용할 수 있는 전역 객체입니다. |
| 맵 | 객체 | 현재 변환 맵 기록을 포함하는 변환 맵 스크립트에서 사용할 수 있는 맵 객체입니다. |
| log | 객체 | 변환 맵 스크립트에서 사용할 수 있는 로그 객체입니다. |
[표 8. 매개변수]

{#CMDBTU-getPayload_O_O_O__table_t5y_5cb_k4b} {#CMDBTU-getPayload_O_O_O__id_fm1_n55_4pb__entry__2}{#CMDBTU-getPayload_O_O_O__row-string-enhanced}{#CMDBTU-getPayload_O_O_O__row_return_additionalCommittedItems}{#CMDBTU-getPayload_O_O_O__row-return-additionalCommittedItems-className}{#CMDBTU-getPayload_O_O_O__row-return-additionalCommittedItems-errorCount}{#CMDBTU-getPayload_O_O_O__entry-errors}{#CMDBTU-getPayload_O_O_O__entry-errors-error}{#CMDBTU-getPayload_O_O_O__entry-errors-message}{#CMDBTU-getPayload_O_O_O__addCommItems_identificationAttempts-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_idAtt_attemptResult-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_idAtt_attributes-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_idAtt_hybridEntryCIAtt-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_idAtt_identifierName-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_identifierEntrySysId-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_identifierEntrySysId2-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_inputIndices-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_markers-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_mergedPayloads-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_operation-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_sysId-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_warnings-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_warnings_error-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommItems_warnings_message-entry-IRE}{#CMDBTU-getPayload_O_O_O__entry_return_additionalCommittedRelations}{#CMDBTU-getPayload_O_O_O__addCommRel_className-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommRel_errorCount-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommRel_errors-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommRel_errors_error-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommRel_errors_message-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommRel_inputIndices-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommRel_markers-entry-IRE}{#CMDBTU-getPayload_O_O_O__addCommRel_mergedPayloadIds-IRE}{#CMDBTU-getPayload_O_O_O__addCommRel_operations-entry-IRE}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_hasError}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_hasWarning}{#CMDBTU-getPayload_O_O_O__items-entry-IRE}{#CMDBTU-getPayload_O_O_O__entry_return_item_additionalRelatedItems}{#CMDBTU-getPayload_O_O_O__items_addRelItems_className-entry-IRE}{#CMDBTU-getPayload_O_O_O__items_addRelItems_inputIndices-entry-IRE}{#CMDBTU-getPayload_O_O_O__entry_return_item_additionalRelatedItems_mergedPayloadIds}{#CMDBTU-getPayload_O_O_O__entry_return_item_additionalRelatedItems_operations}{#CMDBTU-getPayload_O_O_O__items_addRelItems_sysId-entry-IRE}{#CMDBTU-getPayload_O_O_O__entry_return_item_className}{#CMDBTU-getPayload_O_O_O__entry_return_items_duplicateIndices}{#CMDBTU-getPayload_O_O_O__entry_return_item_errorCount}{#CMDBTU-getPayload_O_O_O__entry_return_item_error}{#CMDBTU-getPayload_O_O_O__items_errors_errors-entry-IRE}{#CMDBTU-getPayload_O_O_O__items_errors_msg-entry-IRE}{#CMDBTU-getPayload_O_O_O__entry_return_item_identificationAttempts}{#CMDBTU-getPayload_O_O_O__entry_return_item_identificationAttempts_attemptResult}{#CMDBTU-getPayload_O_O_O__entry_return_item_identificationAttempts_attributes}{#CMDBTU-getPayload_O_O_O__items_identAtt_hyEntCiAtt-IRE}{#CMDBTU-getPayload_O_O_O__entry_return_item_identificationAttempts_identifierName}{#CMDBTU-getPayload_O_O_O__entry_return_item_identificationAttempts_searchOnTable}{#CMDBTU-getPayload_O_O_O__entry_return_item_identifierEntrySysId}{#CMDBTU-getPayload_O_O_O__entry_return_item_incompleteSysId}{#CMDBTU-getPayload_O_O_O__items_info-entry-IRE}{#CMDBTU-getPayload_O_O_O__items_info_code-entry-IRE}{#CMDBTU-getPayload_O_O_O__items_info_message-entry-IRE}{#CMDBTU-getPayload_O_O_O__items_info_ruleSysId-entry-IRE}{#CMDBTU-getPayload_O_O_O__entry_return_items_inputIndices}{#CMDBTU-getPayload_O_O_O__entry_return_item_maskedAttributes}{#CMDBTU-getPayload_O_O_O__entry_return_item_operation}{#CMDBTU-getPayload_O_O_O__entry_return_item_partialSysId}{#CMDBTU-getPayload_O_O_O__entry_return_item_relatedItems}{#CMDBTU-getPayload_O_O_O__row_return_item_relatedItems_className}{#CMDBTU-getPayload_O_O_O__entry_return_item_relatedItems_errors}{#CMDBTU-getPayload_O_O_O__row_return_item_relatedItems_errors_error}{#CMDBTU-getPayload_O_O_O__row_return_item_relatedItems_errors-message}{#CMDBTU-getPayload_O_O_O__entry_return_item_relatedItems_errorCount}{#CMDBTU-getPayload_O_O_O__entry_return_item_relatedItems_inputIndices}{#CMDBTU-getPayload_O_O_O__entry_return_item_relatedItems_inputIndices.mainIndex}{#CMDBTU-getPayload_O_O_O__entry_return_item_relatedItems_inputIndices.subIndex}{#CMDBTU-getPayload_O_O_O__row_return_item_relatedItems_mergedPayloadIds}{#CMDBTU-getPayload_O_O_O__row_return_item_relatedItems_operation}{#CMDBTU-getPayload_O_O_O__row_return_item_relatedItems_sysId}{#CMDBTU-getPayload_O_O_O__row_return_item_relatedItems_warningCount}{#CMDBTU-getPayload_O_O_O__row_return_item_relatedItems_wrnings}{#CMDBTU-getPayload_O_O_O__entry_return_item_relatedSysIds}{#CMDBTU-getPayload_O_O_O__entry_return_item_sys_id}{#CMDBTU-getPayload_O_O_O__entry_return_relations}{#CMDBTU-getPayload_O_O_O__entry_return_relations_className}{#CMDBTU-getPayload_O_O_O__entry_return_relations_errorsCount}{#CMDBTU-getPayload_O_O_O__entry_return_relations_errors}{#CMDBTU-getPayload_O_O_O__entry_return_relations_incompleteSysId}{#CMDBTU-getPayload_O_O_O__entry_return_relations_inputIndices}{#CMDBTU-getPayload_O_O_O__entry_return_relations_operation}{#CMDBTU-getPayload_O_O_O__entry_return_relations_partialSysId}{#CMDBTU-getPayload_O_O_O__entry_return_relations_sys_id}{#CMDBTU-getPayload_O_O_O__entry_return_summary}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_additionalInsertedItemCount}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_errorCount}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_incompleteItemCount}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_insertedItemCount}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_partialItemCount}{#CMDBTU-getPayload_O_O_O__row_return_summary_class_name_skippedItemCount}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_unchangedItemCount}{#CMDBTU-getPayload_O_O_O__entry_return_summary_class_name_updatedItemCount}{#CMDBTU-getPayload_O_O_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\>.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를 찾을 수 없습니다. * 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. {#CMDBTU-getPayload_O_O_O__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가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. {#CMDBTU-getPayload_O_O_O__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가 업데이트됩니다. {#CMDBTU-getPayload_O_O_O__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가 업데이트되었습니다. {#CMDBTU-getPayload_O_O_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 | 오류와 관련된 오류 메시지입니다. 데이터 유형: 문자열 |
| \<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 {#CMDBTU-getPayload_O_O_O__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가 업데이트되고 클래스가 보다 전문화된 클래스(하위 클래스)로 변경되었습니다. {#CMDBTU-getPayload_O_O_O__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 | 처리 시 경고를 생성한 항목 수입니다. 데이터 유형: 숫자 |
[표 9. 반환]

{#CMDBTU-getPayload_O_O_O__id_fm1_n55_4pb}  
이 코드 예제에서는 페이로드를 업데이트한 다음 cmdbUtil.identifyAndReconcileEnhanced() 메서드를 호출하여 페이로드를 처리하기 전에 새 페이로드를 설정할 수 있는 ImportSet의 페이로드를 가져오는 방법을 보여줍니다.

    // Add this code to the onBefore transform map script
    // Ability to modify the payload using get and set APIs
    // Call cmdbUtil API to do Identification and Reconciliation of current row
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.setDataSource('ImportSet');
    var payload = cmdbUtil.getPayload(source, map, log);
    // Modify the payload here
    cmdbUtil.setPayload(payload);
    cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
    ignore = true;
     
    if (cmdbUtil.hasError()) {
      var errorMessage = cmdbUtil.getError();
      log.error(errorMessage);
    } else {
      log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
      log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
    }

## CMDBTransformUtil - hasError() {#ariaid-title7}

이전 identifyAndReconcile() 또는 identifyAndReconcileEnhanced() 메서드 호출에서 오류가 발생했는지 여부를 결정합니다.
onBefore 변환 맵 스크립트에서 이 메서드를 사용합니다.
{#CMDBTU-hasError__table_yr5_swg_gz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 10. 매개변수]

{#CMDBTU-hasError__table_yr5_swg_gz} {#CMDBTU-hasError__table_zr5_swg_gz__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 이전에 호출된 identifyAndReconcile() 또는 identifyAndReconcileEnhanced() 메서드에서 오류가 발생했는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류가 발생했습니다. * false: 오류가 발생하지 않음 |
[표 11. 반환]

{#CMDBTU-hasError__table_zr5_swg_gz}  

    // Add this code to the onBefore transform map script
    // Call CMDB API to do Identification and Reconciliation of current row
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.setDataSource('ImportSet');
    cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
    ignore = true;

    if (cmdbUtil.hasError()) {
      var errorMessage = cmdbUtil.getError();
      log.error(errorMessage);
    } else {
      log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
      log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
    }

### 범위가 지정된 해당 항목

이 메서드에 해당하는 범위가 없습니다.

## CMDBTransformUtil - identifyAndReconcile(객체 소스, 객체 맵, 객체 로그) {#ariaid-title8}

구성 관리 데이터베이스(CMDB)에서 CI(구성 항목)를 삽입하거나 업데이트합니다.
onBefore 변환 맵 스크립트에서 이 메서드를 사용합니다. 변환에 의존하여 구성 항목 기록을 삽입하거나 업데이트하는 대신 이 방법을 사용하면 CMDB의 중복 항목을 줄일 수 있습니다. 자세한 내용은 [임포트 세트에 CI 식별 및 조정 적용](https://www.servicenow.com/docs/access?context=identification-import-sets&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)을 참조하십시오.

변환이 기록을 두 번째로 추가하거나 업데이트하지 못하게 하려면 `무시 = true`를 설정하십시오.
{#r_CMDBTransformUtil-identifyAndReconcile_Object_Object_Object__table_axf_v5d_bt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 소스 | 객체 | 수신 기록을 포함하는 변환 맵 스크립트에서 사용할 수 있는 전역 객체입니다. |
| 맵 | 객체 | 현재 변환 맵 기록을 포함하는 변환 맵 스크립트에서 사용할 수 있는 맵 객체입니다. |
| log | 객체 | 변환 맵 스크립트에서 사용할 수 있는 로그 객체입니다. |
[표 12. 매개변수]

{#r_CMDBTransformUtil-identifyAndReconcile_Object_Object_Object__table_axf_v5d_bt} {#r_CMDBTransformUtil-identifyAndReconcile_Object_Object_Object__table_bxf_v5d_bt__entry__2}

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

{#r_CMDBTransformUtil-identifyAndReconcile_Object_Object_Object__table_bxf_v5d_bt}  
이 코드 예제에서는 identifyAndReconcile() 메서드를 호출하여 입력 페이로드의 현재 행을 처리하는 방법을 보여줍니다.

    // Add this code to the onBefore transform map script
    // Call CMDBTransformUtil API to do Identification and Reconciliation of the current row
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.identifyAndReconcile(source, map, log);
    ignore = true;

## CMDBTransformUtil - identifyAndReconcileEnhanced(객체 소스, 객체 맵, 객체 로그) {#ariaid-title9}

구성 관리 데이터베이스(CMDB)에서 CI(구성 항목)를 삽입하거나 업데이트합니다.
이 메서드는 CMDBTransformUtil.identifyAndReconcile() 메서드의 기능을 제공하는 것 외에도 다음을 지원합니다.  
* 부분 페이로드 처리
* 부분 커밋 처리
* 페이로드 내에서 중복 항목 제거
* 출력 요약 생성

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 소스 | 객체 | 수신 기록을 포함하는 변환 맵 스크립트에서 사용할 수 있는 전역 객체입니다. |
| 맵 | 객체 | 현재 변환 맵 기록을 포함하는 변환 맵 스크립트에서 사용할 수 있는 맵 객체입니다. |
| log | 객체 | 변환 맵 스크립트에서 사용할 수 있는 로그 객체입니다. |
[표 14. 매개변수]

{#CMDBTU-idAndReconcileEnhanced_O__table_s3d_5c2_l4b} {#CMDBTU-idAndReconcileEnhanced_O__table_t3d_5c2_l4b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 15. 반환]

{#CMDBTU-idAndReconcileEnhanced_O__table_t3d_5c2_l4b}  
이 코드 예제에서는 identifyAndReconcileEnhanced() 메서드를 호출하여 전달된 페이로드를 처리하는 방법을 보여 줍니다.

    // Add this code to the onBefore transform map script
    // Call CMDBTransformUtil API to do Identification and Reconciliation
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
    ignore = true;

## CMDBTransformUtil - logTransformStats(객체 로그) {#ariaid-title10}

삽입, 업데이트, 건너뜀 또는 오류가 발생한 CI(구성 항목) 수를 기록합니다.
onComplete 변환 맵 스크립트에서 이 메서드를 사용합니다.
{#CMDBTU-logTransformStats_O__table_csv_rzg_gz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| log | 객체 | 변환 맵 스크립트에서 사용할 수 있는 로그 객체입니다. |
[표 16. 매개변수]

{#CMDBTU-logTransformStats_O__table_csv_rzg_gz} {#CMDBTU-logTransformStats_O__table_dsv_rzg_gz__entry__2}

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

{#CMDBTU-logTransformStats_O__table_dsv_rzg_gz}  

    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.logTransformStats(log);

### 범위가 지정된 해당 항목

이 메서드에 해당하는 범위가 없습니다.

## CMDBTransformUtil - setDataSource(문자열 소스) {#ariaid-title11}

identifyAndReconcile() 또는 identifyAndReconcileEnhanced() 메서드가 호출될 때 사용할 데이터 소스를 설정합니다.
`onBefore` 변환 맵 스크립트에서 이 메서드를 사용합니다. 이 메서드를 호출하지 않으면 기본값은 <var class="keyword varname">ImportSet</var>입니다.
{#CMDBTU-setDataSource_S__table_rln_ryg_gz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 소스 | 문자열 | 소스 구성 항목 기록의 데이터 소스입니다. |
[표 18. 매개변수]

{#CMDBTU-setDataSource_S__table_rln_ryg_gz} {#CMDBTU-setDataSource_S__table_sln_ryg_gz__entry__2}

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

{#CMDBTU-setDataSource_S__table_sln_ryg_gz}  

    // Add this code to the onBefore transform map script
    // Call CMDB API to do Identification and Reconciliation of current row
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.setDataSource('ImportSet');
    cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
    ignore = true;

    if (cmdbUtil.hasError()) {
      var errorMessage = cmdbUtil.getError();
      log.error(errorMessage);
    } else {
      log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
      log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
    }

### 범위가 지정된 해당 항목

이 메서드에 해당하는 범위가 없습니다.