--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # IdentificationEngineScriptableApi - グローバル # IdentificationEngineScriptableApi - グローバル {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：165分 IdentificationEngineScriptableAPI は、識別および調整フレームワークを使用して、構成管理データベース (CMDB)の更新時に許可されたデータソースからの情報のみを受け入れることで、重複する構成アイテム (CI) の作成を最小限に抑え、CI 属性を調整します。 ## IdentificationEngineScriptableApi - createOrUpdateCI(文字列ソース, 文字列入力) {#ariaid-title2} 識別および調整ルールに基づいて、構成アイテム (CI) および非構成管理データベース (CMDB) CI (cmdb_ci から拡張されていないクラス) を CMDB に挿入または更新します。CMDBを直接更新する代わりに、この API を使用します。 非 CMDB CI は、IRE ペイロードのルックアップアイテムまたは関連アイテムとして渡す必要があります。 非 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)」を参照してください。 {#r_IES-createorUpdateCI_S_S__table_wf2_s2s_pyb__entry__3}{#r_IES-createorUpdateCI_S_S__entry_input}{#r_IES-createorUpdateCI_S_S__entry_items}{#r_IES-createorUpdateCI_S_S__entry_className}{#r_IES-createorUpdateCI_S_S__entry-display_values-ire}{#r_IES-createorUpdateCI_S_S__entry_internal_id}{#r_IES-createorUpdateCI_S_S__entry_lookup}{#r_IES-createorUpdateCI_S_S__row_items_settings}{#r_IES-createorUpdateCI_S_S__items_set_skipReclassRestrictRules-entry-IRE}{#r_IES-createorUpdateCI_S_S__row_items_settings_updateWithoutDowngrade}{#r_IES-createorUpdateCI_S_S__row_items_settings_updateWithoutUpgrade}{#r_IES-createorUpdateCI_S_S__row_items_settings_updateWithoutSwitch}{#r_IES-createorUpdateCI_S_S__entry_values}{#r_IES-createorUpdateCI_S_S__entry_referenceItems}{#r_IES-createorUpdateCI_S_S__entry_referenceItems_referenced}{#r_IES-createorUpdateCI_S_S__entry_referenceItems_referencedBy}{#r_IES-createorUpdateCI_S_S__entry_referenceItems_referenceField}{#r_IES-createorUpdateCI_S_S__entry_relations}{#r_IES-createorUpdateCI_S_S__entry_relations_child}{#r_IES-createorUpdateCI_S_S__entry_relations_child_id}{#r_IES-createorUpdateCI_S_S__entry_relations_parent}{#r_IES-createorUpdateCI_S_S__entry_relations_parent_id}{#r_IES-createorUpdateCI_S_S__sys_rel_source_info-entry-IRE}{#r_IES-createorUpdateCI_S_S__sys_rel_source_info-source_name-entry-ire}{#r_IES-createorUpdateCI_S_S__sys_rel_source_into-source_feed-entry-ire}{#r_IES-createorUpdateCI_S_S__entry_relations_type} | 名前 | タイプ | 説明 | |-|-|-| | input | 文字列 | 必須です。入力ペイロード。追加または更新する構成アイテムの JSON 形式の文字列。 "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] } | | input.items | オブジェクトのアレイ | 追加または更新するアイテム。 "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] | | input.items.className | 文字列 | 必須です。作成または更新する構成アイテム (CI) のクラス/テーブル名 (sys_class_name)。 この値は、cmdb_ci_linux_server や cmdb_ci_win_server など、任意の CMDB クラス/テーブルにすることができます。 | | input.items.display_values | オブジェクト | この関連アイテムを名前と値のペアとして作成または更新するための参照フィールドです。名前はフィールド名で、値は参照される表示値です。参照フィールドの表示値の代わりにsys_idを使用する場合は、このパラメーターではなく input.items.lookup.values パラメーターに情報を渡します。 参照フィールド名は、次のようなユーザーが選択したフィールドによって異なります。 "display_values": { "model_id": "String", "location": "String" } | | input.items.internal_id | 文字列 | 関連付けられたペイロードの一意のアイテム識別子。 これは任意の値にすることができますが、ペイロード内で一意である必要があります。 | | input.items.lookup | オブジェクトのアレイ | ルックアップ (ルックアップベースの識別) を含むトップレベルのアイテムを識別します。これらのレコードは、cmdb_ciへの参照を持つルックアップテーブルに基づいて構成アイテムを識別するために使用されます。 例： "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] | | input.items.lookup.className | 文字列 | 必須です。作成または更新する構成アイテム (CI) のクラス/テーブル名 (sys_class_name)。 この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルにすることができます。 | | input.items.lookup.internal_id | 文字列 | 関連付けられたペイロードの一意のアイテム識別子。 これは任意の値にすることができますが、ペイロード内で一意である必要があります。 | | input.items.lookup.sys_オブジェクト_ソース_情報 | オブジェクト | 特定のソースの一意の CI ID。 "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } | | input.items.lookup.sys_object_source_info.source_feed | 文字列 | ソースが複数のフィードを持つことができる場合は、このフィールドを使用して、このアイテムを送信するフィードの名前を入力します。 データソースによってこのフィード名が生成されます。ソースフィードを一意に識別する任意の文字列にすることができます。 | | input.items.lookup.sys_object_source_info.source_name | 文字列 | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 | | input.items.lookup.sys_object_source_info.source_native_key | 文字列 | ソースからのアイテムの一意のキー/ID。 データソースはこのキーを生成します。アイテムに固有の任意の文字列を指定できます。 | | input.items.lookup.sys_object_source_info.source_recency_timestamp | 文字列 | アイテムがスキャンされた UTC 日時。 形式:YYYY-MM-DD hh:mm:ss | | input.items.lookup.values | オブジェクト | この関連アイテムを名前/値のペアとして作成または更新するフィールド (名前はフィールド名)。参照フィールドの場合、値は参照sys_idである必要があります。参照フィールドのsys_idの代わりに表示値を使用する場合は、この情報をvaluesオブジェクトではなくdisplay_valuesオブジェクトに渡します。 フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } | | input.items.related | アレイ | 関連リストを含むトップレベルのアイテムへの参照。関連エントリ \[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_オブジェクト_ソース_情報 | オブジェクト | 特定のソースの一意の CI ID。 "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" } | | input.items.settings | オブジェクト | 許可される更新のタイプを定義するパラメーター。 "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } | | input.items.settings.skipReclassificationRestrictionRules | ブーリアン | ペイロードアイテムのクラスに一致する再分類制限ルールを IRE が実行しないかどうかを示すフラグ。 有効な値： * true:ルールの実行をスキップします。 * false:ルールを実行します。 {#r_IES-createorUpdateCI_S_S__ul_tl4_qwp_snb} デフォルト値：false | | input.items.settings.updateWithoutDowngrade | ブーリアン | このアイテムに対して更新とダウングレードの両方が許可されているかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、ダウングレードは許可されていません。 * false:アイテムの更新とダウングレードの両方が許可されています。 {#r_IES-createorUpdateCI_S_S__ul_jdl_pfb_sjb} デフォルト値：false | | input.items.settings.updateWithoutUpgrade | ブーリアン | このアイテムに対して更新とアップグレードの両方が許可されているかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、アップグレードは許可されていません。 * false:アイテムの更新とアップグレードの両方が許可されています。 {#r_IES-createorUpdateCI_S_S__ul_vqx_xfb_sjb} デフォルト値：false | | input.items.settings.updateWithoutSwitch | ブーリアン | アイテムを更新できるかどうか、およびクラスを切り替えることができるかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、クラスの切り替えは許可されません。 * false:アイテムの更新とクラスの切り替えの両方が許可されます。 {#r_IES-createorUpdateCI_S_S__ul_h4p_2gb_sjb} デフォルト値：false | | input.items.sys_オブジェクト_ソース_情報 | オブジェクト | 特定のソースの一意の CI ID。 "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } | | input.items.sys_object_source_info.source_feed | 文字列 | ソースが複数のフィードを持つことができる場合は、このフィールドを使用して、このアイテムを送信するフィードの名前を入力します。 データソースによってこのフィード名が生成されます。ソースフィードを一意に識別する任意の文字列にすることができます。 | | input.items.sys_object_source_info.source_name | 文字列 | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 | | input.items.sys_object_source_info.source_native_key | 文字列 | ソースからのアイテムの一意のキー/ID。 データソースはこのキーを生成します。アイテムに固有の任意の文字列を指定できます。 | | input.items.sys_object_source_info.source_recency_timestamp | 文字列 | アイテムがスキャンされた UTC 日時。 形式:YYYY-MM-DD hh:mm:ss | | input.items.values | オブジェクト | この関連アイテムを名前/値のペアとして作成または更新するフィールド (名前はフィールド名)。参照フィールドの場合、値は参照sys_idである必要があります。参照フィールドのsys_idの代わりに表示値を使用する場合は、この情報をvaluesオブジェクトではなくdisplay_valuesオブジェクトに渡します。 フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } | | input.referenceItems | オブジェクトのアレイ | 入力ペイロード内のアイテム間の参照を定義するリスト。各参照アイテムの値は、クラスで定義された IRE ルールを使用して CI を識別する前に入力されます。 "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] | | input.referenceItems.referenced | 文字列 | 別のアイテムによって参照されているアイテムに対して定義された internal_id 。 | | input.referenceItems.referencedBy | 文字列 | 別のアイテムを参照するアイテムに対して定義された internal_id 。 | | input.referenceItems.referenceField | 文字列 | referencedByアイテムのクラス/テーブル内の参照フィールドの名前。 | | input.relations | オブジェクトのアレイ | 入力ペイロード内のアイテム間の関係を指定するリスト。 このアレイ内のオブジェクトは、2 つの形式のいずれかを使用できます。 * このオブジェクトは、 parent と child の名前と値のペアを使用して 2 つのトップレベルのアイテム間の関係を (のみ) 定義できます。その値はペイロード items アレイのアイテムインデックスを表します。 "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] * このオブジェクトは、 parent_id と child_id のキー/値のペアを使用して、トップレベルアイテム、関連アイテム、ルックアップアイテムを含む任意の 2 つのアイテム間の関係を定義できます。その値はそれらのアイテムに定義された internal_id 値を表します。 "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#r_IES-createorUpdateCI_S_S__ul_s1s_phb_nlb} | | input.relations.child | 番号 | 関係 (items、items.related、または items.lookup) の子を表す items アレイ内の CI オブジェクトの整数インデックス。 | | input.relations.child_id | 文字列 | 関係内の子アイテムの internal_id (items、items.related、または items.lookup)。 | | input.relations.parent | 番号 | itemsアレイ内の親アイテム (items、items.related、または items.lookup) の整数インデックス。 | | input.relations.parent_id | 文字列 | 関係内の親アイテムの internal_id (items、items.related、または items.lookup)。 | | input.relations.sys_rel_source_info | オブジェクト | 関係のディスカバリーソース情報。非依存関係の場合、この情報は関係性ソース \[sys_rel_source\] テーブルに保存されます ( identifyCIEnhanced() メソッドまたは identifyCI() メソッドでは保持されません)。 データタイプ: オブジェクト "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } | | input.relations.sys_rel_source_info.source_name | 文字列 | ディスカバリーソースの名前。 デフォルト:API メソッドパラメーターで渡されたディスカバリーソース。 | | input.relations.sys_rel_source_info.source_feed | 文字列 | ディスカバリーソース内のサブディスカバリー/スキャンである任意の文字列。 デフォルト:「UNKNOWN」は、テーブルでレコードを作成するときに \[source_feed\] 列に保存されsys_rel_source。 | | input.relations.type | 文字列 | 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係性タイプ \[cmdb_rel_type\] テーブルの名前フィールド値である必要があります。 | | ソース | 文字列 | CI 情報のデータソースを識別します。この値は、cmdb_ci テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 | [表 : 1. パラメーター] {#r_IES-createorUpdateCI_S_S__table_wf2_s2s_pyb} {#r_IES-createorUpdateCI_S_S__id_cx1_bp4_rnb__entry__2}{#r_IES-createorUpdateCI_S_S__entry_return_item_className}{#r_IES-createorUpdateCI_S_S__entry_return_items_duplicateIndices}{#r_IES-createorUpdateCI_S_S__entry_return_item_error}{#r_IES-createorUpdateCI_S_S__items_errors_errors-entry-IRE}{#r_IES-createorUpdateCI_S_S__items_errors_msg-entry-IRE}{#r_IES-createorUpdateCI_S_S__entry_return_item_identificationAttempts}{#r_IES-createorUpdateCI_S_S__entry_return_item_identificationAttempts_attemptResult}{#r_IES-createorUpdateCI_S_S__entry_return_item_identificationAttempts_attributes}{#r_IES-createorUpdateCI_S_S__entry_return_item_identificationAttempts_identifierName}{#r_IES-createorUpdateCI_S_S__entry_return_item_identificationAttempts_searchOnTable}{#r_IES-createorUpdateCI_S_S__entry_return_item_identifierEntrySysId}{#r_IES-createorUpdateCI_S_S__items_info-entry-IREE}{#r_IES-createorUpdateCI_S_S__entry_return_item_maskedAttributes}{#r_IES-createorUpdateCI_S_S__entry_return_item_sys_id}{#r_IES-createorUpdateCI_S_S__entry_return_relations_className}{#r_IES-createorUpdateCI_S_S__entry_return_relations_sys_id} | タイプ | 説明 | |-|-| | \<文字列\> | 入力文字列内の構成アイテムの結果リストである JSON 形式の文字列。各結果文字列の形式は「items: \[{}\], relations:\[{}\]」です。ここで、items および relations リスト内の各アイテムには名前と値のペアが含まれます。 データタイプ：文字列 | | \.additionalCommittedItems | 現在、値が返されていません。 | | \.additionalCommittedRelations | 現在、値が返されていません。 | | \.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" } | | \.items.additionalRelatedItems | 処理されたものの、入力ペイロードの一部として提供されなかった追加のルックアップおよび関連アイテムに関する情報のリスト。これらのアイテムは部分的ペイロードからのものです。 この情報は現在返されません。 データタイプ：オブジェクトのアレイ "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "operation": "String", "sysId": "String" } ] | | \.items.additionalRelatedItems.className | 作成または更新された CI のクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.additionalRelatedItems.inputIndices | 対応する入力アイテムのインデックス。トップレベルのアイテムの場合は、整数のリストです。関連アイテムまたはルックアップアイテムの場合は、JSON オブジェクトのリストです。 データタイプ:数値のアレイまたはオブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] | | \.items.additionalRelatedItems.inputIndices.mainIndex | 追加の関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。 データタイプ：数値 | | \.items.additionalRelatedItems.inputIndices.subIndex | 追加の関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。 データタイプ：数値 | | \.items.additionalRelatedItems.operation | 操作のタイプ 可能な値： * INSERT:新しい CI がデータベースに挿入されました。 * NO_CHANGE:CI の変更は行われませんでした。 * 更新:既存の CI が更新されました。 {#r_IES-createorUpdateCI_S_S__ul_zk2_jrt_ylb} データタイプ：文字列 | | \.items.additionalRelatedItems.sysId | 追加の関連アイテムのSys_id。 データタイプ：文字列 | | \.items.className | 作成または更新された CI のクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.duplicateIndices | 現在のアイテムと重複している CI のインデックスのリスト。 データタイプ：アレイ | | \.items.errorCount | エラーの数。 データタイプ：数値 | | \.items.errors | この CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.items.errors.error | CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 | | \.items.errors.message | エラーに関連するエラーメッセージ。 データタイプ：文字列 | | \.items.identificationAttempts | CI を識別するために行われた試行のリスト。 データタイプ：オブジェクトのアレイ "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identifierName": "String", "searchOnTable": "String" } ] | | \.items.identificationAttempts.attemptResult | CI の識別を試みた結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 データタイプ：文字列 | | \.items.identificationAttempts.attributes | 識別プロセス中に使用された CI ID エントリ属性のリスト。 データタイプ：アレイ 属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。 "attributes": [ "serial_number": "String", "serial_number_type": "String", ] | | \.items.identificationAttempts.hybridEntryCiAttributes | 現在、値が返されていません。 | | \.items.identificationAttempts.identifierName | この CI 識別試行に使用される識別子ルール。 データタイプ：文字列 | | \.items.identificationAttempts.searchOnTable | 識別プロセス中に検索されたテーブルの名前。 データタイプ：文字列 | | \.items.identifierEntrySysId | CI を識別するために使用される識別子ルールのSys_id。 データタイプ：文字列 テーブル:識別子エントリ \[cmdb_identifier_entry\] | | \.items.info | アイテムの処理に関する追加情報を含むリスト。 データタイプ：オブジェクトのアレイ "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] | | \.items.info.code | スキップされた再分類タイプ。 可能な値： * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_UPGRADE {#r_IES-createorUpdateCI_S_S__ul_cqz_yyp_snb} データタイプ：文字列 | | \.items.info.message | 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。 データタイプ：文字列 | | \.items.info.ruleSysId | 一致した再分類制限ルールのSys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグが原因で再分類がスキップされた場合、この値は空です。 データタイプ：文字列 | | \.items.inputIndices | この CI に対応する要求本文 items アレイの CI のインデックス値。 データタイプ：アレイ | | \.items.maskedAttributes | 調整 [ルール](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)で定義されているとおりに、権限のないデータソースによる更新がスキップされた属性のリスト。 データタイプ：アレイ | | \.items.relatedItems | 処理された関連アイテムに関する情報を提供するリスト。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "errors": [Array], "errorCount": Number, "inputIndices": [Array], "operation": "String", "sysId": "String" } ] | | \.items.relatedItems.className | 関連アイテムのクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.relatedItems.errors | 処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.items.relatedItems.errorCount | 処理中に検出されたエラーの数。 データタイプ：数値 | | \.items.relatedItems.inputIndices | 対応する関連アイテムのインデックス。 データタイプ:アレイまたは数値 "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] | | \.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI 親に対応する要求本文 items アレイの整数値。 データタイプ：数値 | | \.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイの整数値。 データタイプ：数値 | | \.items.relatedItems.operation | 操作のタイプ 可能な値： * INSERT:新しい CI がデータベースに挿入されました。 * NO_CHANGE:CI の変更は行われませんでした。 * 更新:既存の CI が更新されました。 {#r_IES-createorUpdateCI_S_S__ul_a4r_kf4_ylb} データタイプ：文字列 | | \.items.relatedSysIds | 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 注目値 - null:この関連アイテムのsys_idが特定されませんでした。 データタイプ：アレイ | | \.items.sys_id | 更新または作成された CI のSys_id。 データタイプ：文字列 | | \.relations | 処理された関係に関する情報。 データタイプ：オブジェクトのアレイ "relations":[ { "className": "String", "errorCount": Number, "inputIndices": [Array], "operation": "String", "sysId": "String" } ] | | \.relations.className | この依存関係 CI のSys_class_name。 サポートされている値:cmdb_rel_ci:CI 関係テーブルのみ。 データタイプ：文字列 | | \.relations.errorCount | エラーの数。 データタイプ：数値 | | \.relations.inputIndices | 対応する入力関係のインデックス。 データタイプ：アレイ | | \.relations.operation | 実行された操作のタイプ。 可能な値： * 挿入 * 更新 * NO_CHANGE データタイプ：文字列 | | \.relations.sysId | 依存関係 CI のSys_id。 データタイプ：文字列 | [表 : 2. 返される内容] {#r_IES-createorUpdateCI_S_S__id_cx1_bp4_rnb} 構成アイテムを再分類する方法を次に示します。 var payload = { "items": [ { "className": "cmdb_ci_win_server", "values": { "short_description": "Linux server description", "name": "Linux Server 1" } } ] }; var input = new JSON().encode(payload); var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCI('ServiceNow', input); gs.print(output); 出力: { "items": [ { "className": "cmdb_ci_linux_server", "operation": "NO_CHANGE", "sysId": "440577800f321010150efc91ff767e94", "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92", "identificationAttempts": [ { "attributes": [], "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "hybridEntryCiAttributes": [] }, { "attributes": [ "serial_number", "serial_number_type" ], "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "searchOnTable": "cmdb_serial_number", "hybridEntryCiAttributes": [] }, { "attributes": [ "serial_number" ], "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "attributes": [ "name" ], "identifierName": "Hardware Rule", "attemptResult": "MATCHED", "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] } ], "info": [ { "message": "CI Reclassification not allowed from class: [cmdb_ci_linux_server] to [cmdb_ci_win_server] by a reclassification restriction rule", "code": "SKIPPED_CLASS_SWITCH", "ruleSysId": "b3d4b3800f321010150efc91ff767eab" } ], "errorCount": 0, "warningCount": 0, "markers": [], "inputIndices": [ 0 ], "mergedPayloadIds": [] } ], "additionalCommittedItems": [], "relations": [], "additionalCommittedRelations": [] } var payload = { "items": [ { "className": "cmdb_ci_win_server", "values": { "chassis_type": "Desktop", "os": "Windows 2012 R2 Datacenter", "name": "Windows2012Server1", "serial_number": "0000-0011-1690-8730-8636-5722-52", "cpu_count": "1" }, "lookup": [ { "values": { "valid": "true", "serial_number": "0000-0011-1690-8730-8636-5722-52", "serial_number_type": "bios" }, "className": "cmdb_serial_number" }, { "values": { "valid": "true", "serial_number": "3311-9736-4988-9744-1749-4183-41", "serial_number_type": "chassis" }, "className": "cmdb_serial_number" }], "internal_id": "16777219", "sys_object_source_info": { "source_feed": "SN Discovery Feed 1", "source_name": "ServiceNow", "source_native_key": "16777219", "source_recency_timestamp": "2019-10-18 08:31:23" }}, { "className": "cmdb_ci_spkg", "values": { "name": "Windows 2012 R2 Datacenter", "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL" }, "related": [ { "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219", "values": { "name": "Windows 2012 R2 Datacenter-SAMLABVM52" }, "className": "cmdb_software_instance", "sys_object_source_info": { "source_feed": "SN Discovery Feed 1", "source_name": "ServiceNow", "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219" }}]}, { "className": "cmdb_ci_app_server_tomcat", "values": { "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start", "install_directory": "/opt/OV/nonOV/tomcat/b", "name": "Tomcat@hpom9:3443", "server_port": "8006", "sys_class_name": "cmdb_ci_app_server_tomcat" }, "internal_id": "tomcat_id" }], "relations": [ { "parent_id": "tomcat_id", "child_id": "16777219", "type": "Runs on::Runs" }], "referenceItems": [ { "referenceField": "installed_on", "referenced": "16777219", "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219" }]}; var jsonUntil = new JSON(); var input = jsonUntil.encode(payload); var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCI('ServiceNow', input); gs.print(output); 出力: { "items": [ { "className": "cmdb_ci_win_server", "operation": "INSERT", "sysId": "d56ab6eadbd510102f67dfea5e96194e", "relatedSysIds": [ "dd6af62adb1910102f67dfea5e96197f", "996af62adb1910102f67dfea5e961980" ], "relatedItems": [ { "errors": [], "operation": "INSERT", "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "sysId": "dd6af62adb1910102f67dfea5e96197f", "markers": [], "inputIndices": [ { "mainIndex": 0, "subIndex": 0 } ], "className": "cmdb_serial_number" }, { "errors": [], "operation": "INSERT", "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "sysId": "996af62adb1910102f67dfea5e961980", "markers": [], "inputIndices": [ { "mainIndex": 0, "subIndex": 1 } ], "className": "cmdb_serial_number" } ], "identifierEntrySysId": "Unknown", "identificationAttempts": [ { "info": "sys_object_source NO_MATCH", "identifierName": "", "attemptResult": "NO_MATCH", "attributes": [], "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "attributes": [ "serial_number", "serial_number_type" ], "searchOnTable": "cmdb_serial_number", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "attributes": [ "serial_number" ], "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "attributes": [ "name" ], "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "attributes": [ "mac_address", "name" ], "searchOnTable": "cmdb_ci_network_adapter", "hybridEntryCiAttributes": [] } ], "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "markers": [], "inputIndices": [ 0 ] }, { "className": "cmdb_ci_spkg", "operation": "INSERT", "sysId": "116af62adb1910102f67dfea5e961981", "relatedSysIds": [ "6d6af62adb1910102f67dfea5e961984" ], "relatedItems": [ { "errors": [], "operation": "INSERT", "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "sysId": "6d6af62adb1910102f67dfea5e961984", "markers": [], "inputIndices": [ { "mainIndex": 1, "subIndex": 0 } ], "className": "cmdb_software_instance" } ], "identifierEntrySysId": "Unknown", "identificationAttempts": [ { "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "attributes": [], "hybridEntryCiAttributes": [] }, { "identifierName": "Software", "attemptResult": "NO_MATCH", "attributes": [ "key" ], "searchOnTable": "cmdb_ci_spkg", "hybridEntryCiAttributes": [] } ], "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "markers": [], "inputIndices": [ 1 ] }, { "className": "cmdb_ci_app_server_tomcat", "operation": "INSERT", "sysId": "e96af62adb1910102f67dfea5e961985", "identifierEntrySysId": "Unknown", "identificationAttempts": [ { "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "attributes": [], "hybridEntryCiAttributes": [] } ], "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "markers": [], "inputIndices": [ 2 ] } ], "additionalCommittedItems": [], "relations": [ { "className": "cmdb_rel_ci", "operation": "INSERT", "sysId": "e96af62adb1910102f67dfea5e961989", "identifierEntrySysId": "Unknown", "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "markers": [], "inputIndices": [ 0 ] } ], "additionalCommittedRelations": [] } 依存 CI を識別します。 var payload = {items: [ {className:'cmdb_ci_web_server', values: {name:'apache linux den 200', running_process_command: 'xyz', running_process_key_parameters: 'abc', tcp_port:'3452'}}, {className:'cmdb_ci_linux_server', values: {name:'lnux100', ram:'2048'}}], relations:[{parent: 0, child: 1, type: 'Runs on::Runs'}] }; var jsonUntil = new JSON(); var input = jsonUntil.encode(payload); var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCI('ServiceWatch', input); gs.print(output); 出力: { "items": [ { "className": "cmdb_ci_web_server", "operation": "INSERT", "sysId": "b9bb766adb1910102f67dfea5e961962", "identifierEntrySysId": "Unknown", "identificationAttempts": [ { "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "attributes": [], "hybridEntryCiAttributes": [] }, { "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "attributes": [], "hybridEntryCiAttributes": [] } ], "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "markers": [], "inputIndices": [ 0 ] }, { "className": "cmdb_ci_linux_server", "operation": "INSERT", "sysId": "a5bb766adb1910102f67dfea5e96195b", "identifierEntrySysId": "Unknown", "identificationAttempts": [ { "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "attributes": [], "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "attributes": [ "serial_number", "serial_number_type" ], "searchOnTable": "cmdb_serial_number", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "attributes": [ "serial_number" ], "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "attributes": [ "name" ], "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "attributes": [ "mac_address", "name" ], "searchOnTable": "cmdb_ci_network_adapter", "hybridEntryCiAttributes": [] } ], "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "markers": [], "inputIndices": [ 1 ] } ], "additionalCommittedItems": [], "relations": [ { "className": "cmdb_rel_ci", "operation": "INSERT", "sysId": "fdbb766adb1910102f67dfea5e961964", "identifierEntrySysId": "Unknown", "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "markers": [], "inputIndices": [ 0 ] } ], "additionalCommittedRelations": [] } ルックアップベースの識別で独立 CI を識別します。 var payload = {items: [ {className:'cmdb_ci_netgear', values: {name:'ny8500-nbxs08', ports:'1200'}, lookup: [{className:'cmdb_serial_number', values:{serial_number:'1234ABCD', serial_number_type:'uuid',absent:'false',valid:'true'}}, {className:'cmdb_serial_number', values:{serial_number:'3456EFGH', serial_number_type:'system',absent:'false',valid:'true'}}]}]}; var jsonUntil = new JSON(); var input = jsonUntil.encode(payload); var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCI('ServiceNow', input); gs.print(output); 出力: { "items": [ { "className": "cmdb_ci_netgear", "operation": "INSERT", "sysId": "787c7e6adb1910102f67dfea5e96196e", "relatedSysIds": [ "f47c7e6adb1910102f67dfea5e961977", "3c7c7e6adb1910102f67dfea5e961977" ], "relatedItems": [ { "errors": [], "operation": "INSERT", "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "sysId": "f47c7e6adb1910102f67dfea5e961977", "markers": [], "inputIndices": [ { "mainIndex": 0, "subIndex": 0 } ], "className": "cmdb_serial_number" }, { "errors": [], "operation": "INSERT", "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "sysId": "3c7c7e6adb1910102f67dfea5e961977", "markers": [], "inputIndices": [ { "mainIndex": 0, "subIndex": 1 } ], "className": "cmdb_serial_number" } ], "identifierEntrySysId": "Unknown", "identificationAttempts": [ { "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "attributes": [], "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "attributes": [ "serial_number", "serial_number_type" ], "searchOnTable": "cmdb_serial_number", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "attributes": [ "serial_number" ], "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "attributes": [ "name" ], "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "attributes": [ "mac_address", "name" ], "searchOnTable": "cmdb_ci_network_adapter", "hybridEntryCiAttributes": [] } ], "errorCount": 0, "mergedPayloadIds": [], "warningCount": 0, "markers": [], "inputIndices": [ 0 ] } ], "additionalCommittedItems": [], "relations": [], "additionalCommittedRelations": [] } ### スコープ対応 {#r_IES-createorUpdateCI_S_S__section_dtc_h5s_mcb} スコープ対象のアプリケーションで createOrUpdateCI(String source, String input) メソッドを使用するには、対応するスコープ対象の IdentificationEngine メソッド [createOrUpdateCI( String source, String input)](https://servicenow-prod.fluidtopics.net/0raPRiAvbITTm71R1Fuqug#IESS-createorUpdateCI_S_S "識別および調整ルールに基づいて、構成アイテム (CI) および非構成管理データベース (CMDB) CI (cmdb_ci から拡張されていないクラス) を CMDB に挿入または更新します。CMDBを直接更新する代わりに、この API を使用します。") を使用します。 ## IdentificationEngineScriptableApi - createOrUpdateCIEnhanced(文字列ソース、文字列入力、オブジェクトオプション) {#ariaid-title3} 識別および調整ルールに基づいて、構成アイテム (CI) および非構成管理データベース (CMDB) CI (cmdb_ci から拡張されていないクラス) を CMDB に挿入または更新します。CMDBを直接更新する代わりに、この API を使用します。 非 CMDB CI は、IRE ペイロードのルックアップアイテムまたは関連アイテムとして渡す必要があります。 非 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)」を参照してください。 このメソッドは、 createOrUpdateCI() メソッドの機能を提供するだけでなく、以下もサポートしています。 * 部分的ペイロードの処理 * 部分的なコミットの処理 * ペイロード内の重複アイテムの削除 * 出力サマリーを生成しています {#IES-createOrUpdateCIEnhanced__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)」を参照してください。 {#IES-createOrUpdateCIEnhanced__IRE-payload__entry__3}{#IES-createOrUpdateCIEnhanced__entry_input}{#IES-createOrUpdateCIEnhanced__entry_items}{#IES-createOrUpdateCIEnhanced__entry_className}{#IES-createOrUpdateCIEnhanced__entry-display_values-ire}{#IES-createOrUpdateCIEnhanced__entry_internal_id}{#IES-createOrUpdateCIEnhanced__entry_lookup}{#IES-createOrUpdateCIEnhanced__entry-input_items_lookup_className}{#IES-createOrUpdateCIEnhanced__entry_related}{#IES-createOrUpdateCIEnhanced__entry-input_items_related_className}{#IES-createOrUpdateCIEnhanced__entry_items_settings}{#IES-createOrUpdateCIEnhanced__items_set_skipReclassRestrictRules-entry-IRE}{#IES-createOrUpdateCIEnhanced__entry_items_settings_updateWithoutDowngrade}{#IES-createOrUpdateCIEnhanced__entry_items_settings_updateWithoutSwitch}{#IES-createOrUpdateCIEnhanced__entry_items_settings_updateWithoutUpgrade}{#IES-createOrUpdateCIEnhanced__entry_items_sys_object_source_info}{#IES-createOrUpdateCIEnhanced__entry_items_sys_object_source_info_source_feed}{#IES-createOrUpdateCIEnhanced__entry_items_sys_object_source_info_source_name}{#IES-createOrUpdateCIEnhanced__entry_items_sys_object_source_info_source_native_key}{#IES-createOrUpdateCIEnhanced__entry_items_sys_object_source_info_source_recency_timestamp}{#IES-createOrUpdateCIEnhanced__entry_values}{#IES-createOrUpdateCIEnhanced__entry_referenceItems}{#IES-createOrUpdateCIEnhanced__entry_referenceItems_referenced}{#IES-createOrUpdateCIEnhanced__entry_referenceItems_referencedBy}{#IES-createOrUpdateCIEnhanced__entry_referenceItems_referenceField}{#IES-createOrUpdateCIEnhanced__entry_relations}{#IES-createOrUpdateCIEnhanced__entry_relations_child}{#IES-createOrUpdateCIEnhanced__entry_relations_child_id}{#IES-createOrUpdateCIEnhanced__entry_relations_parent}{#IES-createOrUpdateCIEnhanced__entry_relations_parent_id}{#IES-createOrUpdateCIEnhanced__sys_rel_source_info-entry-IRE}{#IES-createOrUpdateCIEnhanced__sys_rel_source_info-source_name-entry-ire}{#IES-createOrUpdateCIEnhanced__sys_rel_source_into-source_feed-entry-ire}{#IES-createOrUpdateCIEnhanced__entry_relations_type}{#IES-createOrUpdateCIEnhanced__entry_options}{#IES-createOrUpdateCIEnhanced__entry_options_deduplicate_payloads}{#IES-createOrUpdateCIEnhanced__entry_options_generate_summary}{#IES-createOrUpdateCIEnhanced__entry_options_partial_commits}{#IES-createOrUpdateCIEnhanced__entry_options_partial_payloads}{#IES-createOrUpdateCIEnhanced__entry_source} | 名前 | タイプ | 説明 | |-|-|-| | input | 文字列 | 必須です。入力ペイロード。追加または更新する構成アイテムの JSON 形式の文字列。 "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] } | | input.items | オブジェクトのアレイ | 追加または更新するアイテム。 "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] | | input.items.className | 文字列 | 必須です。作成または更新する構成アイテム (CI) のクラス/テーブル名 (sys_class_name)。 この値は、cmdb_ci_linux_server や cmdb_ci_win_server など、任意の CMDB クラス/テーブルにすることができます。 | | input.items.display_values | オブジェクト | この関連アイテムを名前と値のペアとして作成または更新するための参照フィールドです。名前はフィールド名で、値は参照される表示値です。参照フィールドの表示値の代わりにsys_idを使用する場合は、このパラメーターではなく input.items.lookup.values パラメーターに情報を渡します。 参照フィールド名は、次のようなユーザーが選択したフィールドによって異なります。 "display_values": { "model_id": "String", "location": "String" } | | input.items.internal_id | 文字列 | 関連付けられたペイロードの一意のアイテム識別子。 これは任意の値にすることができますが、ペイロード内で一意である必要があります。 | | input.items.lookup | オブジェクトのアレイ | ルックアップ (ルックアップベースの識別) を含むトップレベルのアイテムを識別します。これらのレコードは、cmdb_ciへの参照を持つルックアップテーブルに基づいて構成アイテムを識別するために使用されます。 例： "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] | | input.items.lookup.className | 文字列 | 必須です。作成または更新する構成アイテム (CI) のクラス/テーブル名 (sys_class_name)。 この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルにすることができます。 | | input.items.lookup.internal_id | 文字列 | 関連付けられたペイロードの一意のルックアップアイテム識別子。 これは任意の値にすることができますが、ペイロード内で一意である必要があります。 | | input.items.lookup.sys_オブジェクト_ソース_情報 | オブジェクト | 特定のデータソースに対して一意の CI ID を定義します。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } | | input.items.lookup.sys_object_source_info.source_feed | 文字列 | ソースが複数のフィードを持つことができる場合は、このフィールドを使用して、このアイテムを送信するフィードの名前を入力します。 データソースによってこのフィード名が生成されます。ソースフィードを一意に識別する任意の文字列にすることができます。 | | input.items.lookup.sys_object_source_info.source_name | 文字列 | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 | | input.items.lookup.sys_object_source_info.source_native_key | 文字列 | ソースからのアイテムの一意のキー ID。 データソースはこのキーを生成します。アイテムに固有の任意の文字列を指定できます。 | | input.items.lookup.sys_object_source_info.source_recency_timestamp | 文字列 | アイテムがスキャンされた UTC 日時。 形式:YYYY-MM-DD hh:mm:ss | | input.items.lookup.values | オブジェクト | 名前と値のペアとしての CI のフィールド情報 (名前はフィールド名です)。参照フィールドを更新する場合、値は参照sys_idである必要があります。 フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "serial_number": "String", "serial_number_type": "String", "valid": "String", "ip_address": "String", "mac_address": "String" } | | input.items.related | オブジェクトのアレイ | 関連リストを含むトップレベルのアイテムへの参照。関連エントリ \[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_オブジェクト_ソース_情報 | オブジェクト | 指定されたデータソースの一意の CI ID を構成するオブジェクト。ソースが異なれば、同じ 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" } | | input.items.settings | オブジェクト | 許可される更新のタイプを定義するパラメーター。 "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } | | input.items.settings.skipReclassificationRestrictionRules | ブーリアン | ペイロードアイテムのクラスに一致する再分類制限ルールを IRE が実行しないかどうかを示すフラグ。 有効な値： * true:ルールの実行をスキップします。 * false:ルールを実行します。 {#IES-createOrUpdateCIEnhanced__ul_tl4_qwp_snb} デフォルト値：false | | input.items.settings.updateWithoutDowngrade | ブーリアン | このアイテムに対して更新とダウングレードの両方が許可されているかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、ダウングレードは許可されていません。 * false:アイテムの更新とダウングレードの両方が許可されています。 {#IES-createOrUpdateCIEnhanced__ul_jdl_pfb_sjb} デフォルト値：false | | input.items.settings.updateWithoutSwitch | ブーリアン | アイテムを更新できるかどうか、およびクラスを切り替えることができるかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、クラスの切り替えは許可されません。 * false:アイテムの更新とクラスの切り替えの両方が許可されます。 {#IES-createOrUpdateCIEnhanced__ul_h4p_2gb_sjb} デフォルト値：false | | input.items.settings.updateWithoutUpgrade | ブーリアン | このアイテムに対して更新とアップグレードの両方が許可されているかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、アップグレードは許可されていません。 * false:アイテムの更新とアップグレードの両方が許可されています。 {#IES-createOrUpdateCIEnhanced__ul_vqx_xfb_sjb} デフォルト値：false | | input.items.sys_オブジェクト_ソース_情報 | オブジェクト | 特定のソースの一意の CI ID。 "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } | | input.items.sys_object_source_info.source_feed | 文字列 | ソースが複数のフィードを持つことができる場合は、このフィールドを使用して、このアイテムを送信するフィードの名前を入力します。 データソースによってこのフィード名が生成されます。ソースフィードを一意に識別する任意の文字列にすることができます。 | | input.items.sys_object_source_info.source_name | 文字列 | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 | | input.items.sys_object_source_info.source_native_key | 文字列 | ソースからのアイテムの一意のキー/ID。 データソースはこのキーを生成します。アイテムに固有の任意の文字列を指定できます。 | | input.items.sys_object_source_info.source_recency_timestamp | 文字列 | アイテムがスキャンされた UTC 日時。 形式:YYYY-MM-DD hh:mm:ss | | input.items.values | オブジェクト | この関連アイテムを名前/値のペアとして作成または更新するフィールド (名前はフィールド名)。参照フィールドの場合、値は参照sys_idである必要があります。参照フィールドのsys_idの代わりに表示値を使用する場合は、この情報をvaluesオブジェクトではなくdisplay_valuesオブジェクトに渡します。 フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } | | input.referenceItems | オブジェクトのアレイ | 入力ペイロード内のアイテム間の参照を定義するリスト。各参照アイテムの値は、クラスで定義された IRE ルールを使用して CI を識別する前に入力されます。 "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] | | input.referenceItems.referenced | 文字列 | 別のアイテムによって参照されているアイテムに対して定義された internal_id 。 | | input.referenceItems.referencedBy | 文字列 | 別のアイテムを参照するアイテムに対して定義された internal_id 。 | | input.referenceItems.referenceField | 文字列 | referencedByアイテムのクラス/テーブル内の参照フィールドの名前。 | | input.relations | オブジェクトのアレイ | 入力ペイロード内のアイテム間の関係を指定するリスト。 このアレイ内のオブジェクトは、2 つの形式のいずれかを使用できます。 * このオブジェクトは、 parent と child の名前と値のペアを使用して 2 つのトップレベルのアイテム間の関係を (のみ) 定義できます。その値はペイロード items アレイのアイテムインデックスを表します。 "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] * このオブジェクトは、 parent_id と child_id のキー/値のペアを使用して、トップレベルアイテム、関連アイテム、ルックアップアイテムを含む任意の 2 つのアイテム間の関係を定義できます。その値はそれらのアイテムに定義された internal_id 値を表します。 "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#IES-createOrUpdateCIEnhanced__ul_s1s_phb_nlb} | | input.relations.child | 番号 | 関係 (items、items.related、または items.lookup) の子を表す items アレイ内の CI オブジェクトの整数インデックス。 | | input.relations.child_id | 文字列 | 関係内の子アイテムの internal_id (items、items.related、または items.lookup)。 | | input.relations.parent | 番号 | itemsアレイ内の親アイテム (items、items.related、または items.lookup) の整数インデックス。 | | input.relations.parent_id | 文字列 | 関係内の親アイテムの internal_id (items、items.related、または items.lookup)。 | | input.relations.sys_rel_source_info | オブジェクト | 関係のディスカバリーソース情報。非依存関係の場合、この情報は関係性ソース \[sys_rel_source\] テーブルに保存されます ( identifyCIEnhanced() メソッドまたは identifyCI() メソッドでは保持されません)。 データタイプ: オブジェクト "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } | | input.relations.sys_rel_source_info.source_name | 文字列 | ディスカバリーソースの名前。 デフォルト:API メソッドパラメーターで渡されたディスカバリーソース。 | | input.relations.sys_rel_source_info.source_feed | 文字列 | ディスカバリーソース内のサブディスカバリー/スキャンである任意の文字列。 デフォルト:「UNKNOWN」は、テーブルでレコードを作成するときに \[source_feed\] 列に保存されsys_rel_source。 | | input.relations.type | 文字列 | 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係性タイプ \[cmdb_rel_type\] テーブルの名前フィールド値である必要があります。 | | オプション | オブジェクト | オプションですが、{} または null を渡す必要があります。機能を有効または無効にするオプション。 注: デフォルトでは、または partial_payloads が true に設定されている場合、部分的ペイロード機能に不可欠な機能であるため、false に設定されていても、 partial_commits と deduplicate_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:重複するアイテムをエラーと見なします。 {#IES-createOrUpdateCIEnhanced__ul_xv5_bws_mjb} デフォルト：true | | options.generate_summary | ブーリアン | 返された結果にサマリー情報が含まれているかどうかを示すフラグ。返されるサマリー情報の詳細については、返される結果テーブルの \.summary を参照してください。 有効な値： * true:サマリー情報を含めます。 * false:サマリー情報を含めません。 {#IES-createOrUpdateCIEnhanced__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:部分的なコミットが無効です。 {#IES-createOrUpdateCIEnhanced__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:部分的ペイロードが無効です。 {#IES-createOrUpdateCIEnhanced__ul_tzb_tvs_mjb} デフォルト：true | | options.skip_updating_last_scan_to_now | ブーリアン | sys_object_sourceのlast_scan時間フィールドの更新をスキップするかどうかを示すフラグ。 有効な値： * true: source_recency_timestamp パラメーターが渡されない場合は sys_object_source_infosys_object_sourceのlast_scan時間フィールドを更新しません。 * false:sys_object_sourceのlast_scan時間フィールドを更新します。 {#IES-createOrUpdateCIEnhanced__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. パラメーター] {#IES-createOrUpdateCIEnhanced__table_lqf_msb_jlb} {#IES-createOrUpdateCIEnhanced__table_dhd_j1p_sjb__entry__2}{#IES-createOrUpdateCIEnhanced__row-string-enhanced}{#IES-createOrUpdateCIEnhanced__row_return_additionalCommittedItems}{#IES-createOrUpdateCIEnhanced__row-return-additionalCommittedItems-className}{#IES-createOrUpdateCIEnhanced__row-return-additionalCommittedItems-errorCount}{#IES-createOrUpdateCIEnhanced__entry-errors}{#IES-createOrUpdateCIEnhanced__entry-errors-error}{#IES-createOrUpdateCIEnhanced__entry-errors-message}{#IES-createOrUpdateCIEnhanced__addCommItems_identificationAttempts-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_idAtt_attemptResult-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_idAtt_attributes-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_idAtt_hybridEntryCIAtt-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_idAtt_identifierName-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_identifierEntrySysId-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_identifierEntrySysId2-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_inputIndices-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_markers-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_mergedPayloads-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_operation-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_sysId-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_warnings-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_warnings_error-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommItems_warnings_message-entry-IRE}{#IES-createOrUpdateCIEnhanced__entry_return_additionalCommittedRelations}{#IES-createOrUpdateCIEnhanced__addCommRel_className-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommRel_errorCount-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommRel_errors-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommRel_errors_error-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommRel_errors_message-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommRel_inputIndices-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommRel_markers-entry-IRE}{#IES-createOrUpdateCIEnhanced__addCommRel_mergedPayloadIds-IRE}{#IES-createOrUpdateCIEnhanced__addCommRel_operations-entry-IRE}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_hasError}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_hasWarning}{#IES-createOrUpdateCIEnhanced__items-entry-IRE}{#IES-createOrUpdateCIEnhanced__entry_return_item_additionalRelatedItems}{#IES-createOrUpdateCIEnhanced__items_addRelItems_className-entry-IRE}{#IES-createOrUpdateCIEnhanced__items_addRelItems_inputIndices-entry-IRE}{#IES-createOrUpdateCIEnhanced__entry_return_item_additionalRelatedItems_mergedPayloadIds}{#IES-createOrUpdateCIEnhanced__entry_return_item_additionalRelatedItems_operations}{#IES-createOrUpdateCIEnhanced__items_addRelItems_sysId-entry-IRE}{#IES-createOrUpdateCIEnhanced__entry_return_item_className}{#IES-createOrUpdateCIEnhanced__entry_return_items_duplicateIndices}{#IES-createOrUpdateCIEnhanced__entry_return_item_errorCount}{#IES-createOrUpdateCIEnhanced__entry_return_item_error}{#IES-createOrUpdateCIEnhanced__items_errors_errors-entry-IRE}{#IES-createOrUpdateCIEnhanced__items_errors_msg-entry-IRE}{#IES-createOrUpdateCIEnhanced__entry_return_item_identificationAttempts}{#IES-createOrUpdateCIEnhanced__entry_return_item_identificationAttempts_attemptResult}{#IES-createOrUpdateCIEnhanced__entry_return_item_identificationAttempts_attributes}{#IES-createOrUpdateCIEnhanced__items_identAtt_hyEntCiAtt-IRE}{#IES-createOrUpdateCIEnhanced__entry_return_item_identificationAttempts_identifierName}{#IES-createOrUpdateCIEnhanced__entry_return_item_identificationAttempts_searchOnTable}{#IES-createOrUpdateCIEnhanced__entry_return_item_identifierEntrySysId}{#IES-createOrUpdateCIEnhanced__entry_return_item_incompleteSysId}{#IES-createOrUpdateCIEnhanced__items_info-entry-IRE}{#IES-createOrUpdateCIEnhanced__items_info_code-entry-IRE}{#IES-createOrUpdateCIEnhanced__items_info_message-entry-IRE}{#IES-createOrUpdateCIEnhanced__items_info_ruleSysId-entry-IRE}{#IES-createOrUpdateCIEnhanced__entry_return_items_inputIndices}{#IES-createOrUpdateCIEnhanced__entry_return_item_maskedAttributes}{#IES-createOrUpdateCIEnhanced__entry_return_item_operation}{#IES-createOrUpdateCIEnhanced__entry_return_item_partialSysId}{#IES-createOrUpdateCIEnhanced__entry_return_item_relatedItems}{#IES-createOrUpdateCIEnhanced__row_return_item_relatedItems_className}{#IES-createOrUpdateCIEnhanced__entry_return_item_relatedItems_errors}{#IES-createOrUpdateCIEnhanced__row_return_item_relatedItems_errors_error}{#IES-createOrUpdateCIEnhanced__row_return_item_relatedItems_errors-message}{#IES-createOrUpdateCIEnhanced__entry_return_item_relatedItems_errorCount}{#IES-createOrUpdateCIEnhanced__entry_return_item_relatedItems_inputIndices}{#IES-createOrUpdateCIEnhanced__entry_return_item_relatedItems_inputIndices.mainIndex}{#IES-createOrUpdateCIEnhanced__entry_return_item_relatedItems_inputIndices.subIndex}{#IES-createOrUpdateCIEnhanced__row_return_item_relatedItems_mergedPayloadIds}{#IES-createOrUpdateCIEnhanced__row_return_item_relatedItems_operation}{#IES-createOrUpdateCIEnhanced__row_return_item_relatedItems_sysId}{#IES-createOrUpdateCIEnhanced__row_return_item_relatedItems_warningCount}{#IES-createOrUpdateCIEnhanced__row_return_item_relatedItems_wrnings}{#IES-createOrUpdateCIEnhanced__entry_return_item_relatedSysIds}{#IES-createOrUpdateCIEnhanced__entry_return_item_sys_id}{#IES-createOrUpdateCIEnhanced__entry_return_relations}{#IES-createOrUpdateCIEnhanced__entry_return_relations_className}{#IES-createOrUpdateCIEnhanced__entry_return_relations_errorsCount}{#IES-createOrUpdateCIEnhanced__entry_return_relations_errors}{#IES-createOrUpdateCIEnhanced__entry_return_relations_incompleteSysId}{#IES-createOrUpdateCIEnhanced__entry_return_relations_inputIndices}{#IES-createOrUpdateCIEnhanced__entry_return_relations_operation}{#IES-createOrUpdateCIEnhanced__entry_return_relations_partialSysId}{#IES-createOrUpdateCIEnhanced__entry_return_relations_sys_id}{#IES-createOrUpdateCIEnhanced__entry_return_summary}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_additionalInsertedItemCount}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_errorCount}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_incompleteItemCount}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_insertedItemCount}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_partialItemCount}{#IES-createOrUpdateCIEnhanced__row_return_summary_class_name_skippedItemCount}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_unchangedItemCount}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_updatedItemCount}{#IES-createOrUpdateCIEnhanced__entry_return_summary_class_name_warningCount} | パラメーター | 説明 | |-|-| | \<文字列\> | 入力文字列内の構成アイテムの結果リストである JSON 形式の文字列。 データタイプ：文字列 { "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "hasError": Boolean, "hasWarning": Boolean, "items": [Array], "relations": [Array], "summary": {Object} } | | \.additionalCommittedItems | 現在のペイロードの IRE 処理中にコミットされたが、現在の入力ペイロードには存在しなかった CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "operation": "String", "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "sysId": "String" } ] | | \.additionalCommittedItems.className | この追加 CI のSys_class_name。 データタイプ：文字列 | | \.additionalCommittedItems.errorCount | この追加 CI の処理中に発生したエラーの数。 データタイプ：数値 | | \.additionalCommittedItems.errors | この追加の CI の処理中に発生したエラーを説明するオブジェクトのアレイ。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] | | \.additionalCommittedItems.errors.error | 追加 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 | | \.additionalCommittedItems.errors.message | 追加の CI の処理中にエラーメッセージが表示されました。 データタイプ：文字列 | | \.additionalCommittedItems.identificationAttempts | オブジェクトのアレイ。各オブジェクトは、この追加の CI を識別する試みを記述します。 データタイプ：オブジェクトのアレイ "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] | | \.additionalCommittedItems.identificationAttempts.attemptResult | この追加の CI 識別試行の結果。 データタイプ：文字列 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#IES-createOrUpdateCIEnhanced__ul_axc_bxx_glb} | | \.additionalCommittedItems.identificationAttempts.attributes | この追加の CI 識別試行中に使用される CI ID エントリ属性。 データタイプ：アレイ 属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。 "attributes": [ "serial_number": "String", "serial_number_type": "String", ] | | \.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes | この追加の CI 識別試行中に使用される CI ID エントリ属性のアレイ。 データタイプ：アレイ 属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。 "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] | | \.additionalCommittedItems.identificationAttempts.identifierName | この追加の CI 識別の試行に使用される識別子ルール。 データタイプ：文字列 | | \.additionalCommittedItems.identificationAttempts.searchOnTable | この追加の CI 識別試行が検索されたテーブルの名前。 データタイプ：文字列 | | \.additionalCommittedItems.identifierEntrySysId | この追加の CI を識別するために使用される識別子ルールのSys_id。 注目の値 - 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 | | \.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイの CI のインデックス値。 データタイプ:数値の配列 "inputIndices": [ { Number } ] | | \.additionalCommittedItems.markers | 内部使用用のマーカー値。 データタイプ：アレイ "markers": [] | | \.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのSys_id値。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] | | \.additionalCommittedItems.operation | この追加 CI に対して実行された操作。 データタイプ：文字列 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:追加の CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#IES-createOrUpdateCIEnhanced__ul_dwt_qwx_glb} | | \.additionalCommittedItems.sysId | 識別によってこの追加 CI のSys_idが見つかりました。 データタイプ：文字列 注目の値 - 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 | | \.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告の説明。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] | | \.additionalCommittedItems.warnings.error | この追加 CI の処理中に発生した警告のタイプ。 データタイプ：文字列 | | \.additionalCommittedItems.warnings.message | この追加 CI の処理中に警告メッセージが表示されました。 データタイプ：文字列 | | \.additionalCommittedRelations | 挿入または更新する要求本文 relations リストに含まれていなかった依存関係性 CI の説明。 データタイプ：オブジェクトのアレイ "additionalCommittedRelations": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String" } ] | | \.additionalCommittedRelations.className | この追加の依存関係 CI のsys_class_name。 データタイプ：文字列 サポートされている値:cmdb_rel_ci:CI 関係テーブルのみ。 | | \.additionalCommittedRelations.errorCount | この追加の依存関係 CI の処理中に発生したエラーの数。 データタイプ：数値 | | \.additionalCommittedRelations.errors | この追加の依存関係 CI の処理中に発生したエラーの説明。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.additionalCommittedRelations.errors.error | 追加の依存関係性 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 | | \.additionalCommittedRelations.errors.message | この追加の依存関係性 CI の処理中にエラーメッセージが発生しました。 データタイプ：文字列 | | \.additionalCommittedRelations.inputIndices | この追加の依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス値。 データタイプ：アレイ "inputIndices": [ Number ] | | \.additionalCommittedRelations.markers | 内部使用用のマーカー値。 データタイプ：アレイ "markers": [] | | \.additionalCommittedRelations.mergedPayloadIds | この CI に対して結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのSys_id値。この追加の依存関係 CI の処理中に結合された値。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] | | \.additionalCommittedRelations.operation | 追加の依存関係性 CI に対して実行された操作。 可能な値： * INSERT:依存関係 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 が更新されます。 {#IES-createOrUpdateCIEnhanced__ul_ltk_vxx_glb} データタイプ：文字列 | | \.hasError | アイテムまたは関係にエラーがあるかどうかを示すフラグ。 データタイプ：ブーリアン | | \.hasWarning | アイテムまたは関係に警告があるかどうかを示すフラグ。 データタイプ：ブーリアン | | \.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" } ] | | \.items.additionalRelatedItems | 処理されたものの、入力ペイロードの一部として提供されなかった追加のルックアップおよび関連アイテムに関する情報。これらのアイテムは部分的ペイロードからのものです。 データタイプ：オブジェクトのアレイ "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "mergedPayloadIds": [Array], "operation": "String", "sysId": "String" } ] | | \.items.additionalRelatedItems.className | 作成または更新された CI のクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.additionalRelatedItems.inputIndices | この関連アイテムに対応する要求本文 items アレイの CI のインデックス値。 データタイプ:数値の配列 | | \.items.additionalRelatedItems.mergedPayloadIds | 関連アイテムに結合された部分的ペイロードのsys_idsのリスト。 データタイプ：アレイ テーブル:CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] | | \.items.additionalRelatedItems.operation | 操作のタイプ 可能な値： * INSERT:新しい CI がデータベースに挿入されました。 * NO_CHANGE:CI の変更は行われませんでした。 * 更新:既存の CI が更新されました。 {#IES-createOrUpdateCIEnhanced__ul_rk4_fxz_mjb} データタイプ：文字列 | | \.items.additionalRelatedItems.sysId | 更新または作成された CI のSys_id。 データタイプ：文字列 | | \.items.className | 作成または更新された CI のクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.duplicateIndices | 現在のアイテムと重複している CI のインデックスのリスト。 データタイプ：アレイ | | \.items.errorCount | アイテムの処理中に発生したエラーの数。 データタイプ：数値 | | \.items.errors | この CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.items.errors.error | CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 | | \.items.errors.message | エラーに関連するエラーメッセージ。 データタイプ：文字列 | | \.items.identificationAttempts | CI を識別するために行われた試行のリスト。 データタイプ：オブジェクトのアレイ "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identifierName": "String", "searchOnTable": "String" } ] | | \.items.identificationAttempts.attemptResult | CI の識別を試みた結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 データタイプ：文字列 | | \.items.identificationAttempts.attributes | 識別プロセス中に使用された CI ID エントリ属性のリスト。 データタイプ：アレイ 属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。 "attributes": [ "serial_number": "String", "serial_number_type": "String", ] | | \items.identificationAttempts.hybridEntryCiAttributes | 識別プロセス中に使用された CI ID エントリ属性のリスト。 データタイプ：アレイ 属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。 "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] | | \.items.identificationAttempts.identifierName | この CI 識別試行に使用される識別子ルール。 データタイプ：文字列 | | \.items.identificationAttempts.searchOnTable | 識別プロセス中に検索されたテーブルの名前。 データタイプ：文字列 | | \.items.identifierEntrySysId | CI を識別するために使用される識別子ルールのSys_id。 データタイプ：文字列 テーブル:識別子エントリ \[cmdb_identifier_entry\] | | \.items.incompleteSysIds | アイテムにエラーがあり、不完全なペイロードとして保存された場合、このパラメーターには CMDB IRE 不完全なペイロード \[cmdb_ire_incomplete_payloads\] テーブルのレコードのsys_idが含まれます。 データタイプ：文字列 | | \.items.info | アイテムの処理に関する追加情報。 データタイプ：オブジェクトのアレイ "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] | | \.items.info.code | スキップされた再分類タイプ。 可能な値： * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_UPGRADE {#IES-createOrUpdateCIEnhanced__ul_pb2_dxp_snb} データタイプ：文字列 | | \.items.info.message | 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。 データタイプ：文字列 | | \.items.info.ruleSysId | 一致した再分類制限ルールのSys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグが原因で再分類がスキップされた場合、この値は空です。 データタイプ：文字列 | | \.items.inputIndices | 対応する入力 CI のインデックス。トップレベルのアイテムの場合は、整数のリストです。関連 CI またはルックアップ CI の場合は、JSON オブジェクトのリストです。 データタイプ:数値の配列 | | \.items.maskedAttributes | 調整 [ルール](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)で定義されているとおりに、権限のないデータソースによる更新がスキップされた属性のリスト。 データタイプ：アレイ | | \.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 が更新され、クラスがより特殊なクラス (子孫クラス) に変更されました。 {#IES-createOrUpdateCIEnhanced__ul_wyd_hj5_mjb} データタイプ：文字列 | | \.items.partialSysIds | アイテムにエラーがあり、部分的ペイロードとして保存された場合、このパラメーターには部分的ペイロードレコードのsys_idが含まれます。 データタイプ：文字列 | | \.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] } ] | | \.items.relatedItems.className | 関連アイテムのクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.relatedItems.errors | 関連アイテムの処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.items.relatedItems.errors.error | 関連アイテムの処理中に発生したエラーのタイプ。 データタイプ：文字列 | | \.items.relatedItems.errors.message | エラーに関連するエラーメッセージ。 データタイプ：文字列 | | \.items.relatedItems.errorCount | 関連アイテムの処理中に検出されたエラーの数。 データタイプ：数値 | | \.items.relatedItems.incompleteSysIds | 関係にエラーがあり、不完全なペイロードとして保存された場合、この値は CMDB IRE 不完全なペイロード \[cmdb_ire_incomplete_payloads\] テーブル内のレコードのsys_idです。 データタイプ：文字列 | | \.items.relatedItems.inputIndices | 対応する入力アイテムのインデックス。トップレベルのアイテムの場合は、整数のリストです。関連アイテムまたはルックアップアイテムの場合は、JSON オブジェクトのリストです。 データタイプ:数値のアレイまたはオブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] | | \.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。 データタイプ：数値 | | \.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。 データタイプ：数値 | | \.items.relatedItems.mergedPayloadIds | 処理中に CI に結合された部分的ペイロードのsys_idsのリスト。 データタイプ：アレイ | | \.items.relatedItems.operation | 実行された操作。 可能な値： * INSERT:新しい関連 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 が更新され、クラスがより特殊化されたクラス (子孫クラス) に変更されました。 データタイプ：文字列 | | \.items.relatedItems.partialSysIds | 関連アイテムにエラーがあり、部分的ペイロードとして保存された場合、CMDB IRE 部分的ペイロード \[cmdb_ire_partial_payloads\] テーブル内の関連レコードのsys_idsのリストが含まれます。 データタイプ：アレイ | | \.items.relatedItems.sysId | 関連アイテムのSys_id。 データタイプ：文字列 | | \.items.relatedItems.warningCount | 関連アイテムの処理時に発生した警告の数。 データタイプ：数値 | | \.items.relatedItems.warnings | 関連アイテムの処理中に発生した警告の説明。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] | | \.items.relatedItems.warnings.error | 関連アイテムの処理中に発生した警告のタイプ。 データタイプ：文字列 | | \.items.relatedItems.warnings.message | 警告に関連付けられたメッセージ。 データタイプ：文字列 | | \.items.relatedSysIds | 関連アイテムのルックアップベースの識別中に使用された CI のsys_id値のリスト。 データタイプ：文字列 | | \.items.sys_id | 更新または作成された CI のSys_id。 データタイプ：文字列 | | \.relations | 要求本文 relations アレイからの依存関係 CI の説明。 データタイプ：オブジェクトのアレイ "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "incompleteSysIds": "String", "inputIndices": [Array], "operation": "String", "partialSysIds": "String", "sysId": "String" } ] | | \.relations.className | この依存関係 CI のSys_class_name。 サポートされている値:cmdb_rel_ci:CI 関係テーブルのみ。 データタイプ：文字列 | | \.relations.errorCount | 依存関係 CI の処理時に発生したエラーの数。 データタイプ：数値 | | \.relations.errors | この依存関係 CI の処理中に発生したエラーを説明するリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.relations.errors.error | 依存関係 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 | | \.relations.errors.message | この依存関係性 CI の処理中にエラーメッセージが発生しました。 データタイプ：文字列 | | \.relations.incompleteSysIds | 関係にエラーがあり、不完全なペイロードとして保存された場合、この値は CMDB IRE 不完全なペイロード \[cmdb_ire_incomplete_payloads\] テーブル内のレコードのsys_idです。 データタイプ：文字列 | | \.relations.inputIndices | この依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス。 データタイプ：アレイ | | \.relations.operation | 実行された操作のタイプ。 可能な値： * INSERT:依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されました。 * INSERT_AS_INCOMPLETE:依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード \[cmdb_ire_incomplete_payloads\] テーブルに挿入されました。 * INSERT_AS_PARTIAL:依存関係 CI にエラーがあり、CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルに挿入されました。 * NO_CHANGE:操作は実行されませんでした。 * 更新:ターゲットテーブルの既存の依存関係 CI が更新されました。 データタイプ：文字列 | | \.relations.partialSysIds | 関係にエラーがあり、部分的ペイロードとして保存された場合、この値は CMDB IRE 部分的ペイロード \[cmdb_ire_partial_payloads\] テーブル内のレコードのsys_idです。 データタイプ：文字列 | | \.relations.sysId | 依存関係 CI のSys_id。 データタイプ：文字列 | | \.summary | クラスごとに挿入されたアイテム数、更新されたアイテム数などの統計情報を提供する JSON プロパティのリスト。 データタイプ：アレイ | | \.summary.\ | 特定のクラスの統計情報。 データタイプ: オブジェクト : { "additionalInsertedItemCount": Number, "errorCount": Number, "incompleteItemCount": Number, "insertedItemCount": Number, "partialItemCount": Number, "skippedItemCount": Number, "unchangedItemCount": Number, "updatedItemCount": Number, "warningCount": Number } | | \.summary.\.additionalInsertedItemCount | 部分的ペイロードの処理のために挿入されたアイテムの数。 データタイプ：数値 | | \.summary.\.errorCount | アイテムの処理時に発生したエラーの数。 データタイプ：数値 | | \.summary.\.incompleteItemCount | CMDB IRE 不完全ペイロード \[cmdb_ire_incomplete_payloads\] テーブルに挿入されたアイテムの数。 データタイプ：数値 | | \.summary.\.insertedItemCount | 作成されたアイテムの数。 データタイプ：数値 | | \.summary.\.partialItemCount | 部分的ペイロードテーブル \[cmdb_ire_partial_payloads\] に保存されているアイテムの数。 データタイプ：数値 | | \.summary.\.skippedItemCount | スキップされたアイテムの数。 データタイプ：数値 | | \.summary.\.unchangedItemCount | エントリはあったが変更されていないアイテムの数。 データタイプ：数値 | | \.summary.\.updatedItemCount | 更新されたアイテムの数。 データタイプ：数値 | | \.summary.\.warningCount | 処理時に警告を生成したアイテムの数。 データタイプ：数値 | [表 : 4. 返される内容] {#IES-createOrUpdateCIEnhanced__table_dhd_j1p_sjb} 依存 CI を識別します。 var payload = { "items": [ { "className": "cmdb_ci_win_server", "values": { "chassis_type": "Desktop", "os": "Windows 2012 R2 Datacenter", "name": "Windows2012Server1", "serial_number": "0000-0011-1690-8730-8636-5722-52", "cpu_count": "1" }, "lookup": [ { "values": { "valid": "true", "serial_number": "0000-0011-1690-8730-8636-5722-52", "serial_number_type": "bios" }, "className": "cmdb_serial_number" }, { "values": { "valid": "true", "serial_number": "3311-9736-4988-9744-1749-4183-41", "serial_number_type": "chassis" }, "className": "cmdb_serial_number" }], "internal_id": "16777219", "sys_object_source_info": { "source_feed": "SN Discovery Feed 1", "source_name": "ServiceNow", "source_native_key": "16777219", "source_recency_timestamp": "2019-10-18 08:31:23" }}, { "className": "cmdb_ci_spkg", "values": { "name": "Windows 2012 R2 Datacenter", "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL" }, "related": [ { "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219", "values": { "name": "Windows 2012 R2 Datacenter-SAMLABVM52" }, "className": "cmdb_software_instance", "sys_object_source_info": { "source_feed": "SN Discovery Feed 1", "source_name": "ServiceNow", "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219" }}] "settings" : { "skipReclassificationRestrictionRules" : "false", "updateWithoutDowngrade" : "true", "updateWithoutUpgrade" : "true", "updateWithoutSwitch" : "true" }}, { "className": "cmdb_ci_app_server_tomcat", "values": { "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start", "install_directory": "/opt/OV/nonOV/tomcat/b", "name": "Tomcat@hpom9:3443", "server_port": "8006", "sys_class_name": "cmdb_ci_app_server_tomcat" }, "internal_id": "tomcat_id" }], "relations": [ { "parent_id": "tomcat_id", "child_id": "16777219", "type": "Runs on::Runs" }], "referenceItems": [ { "referenceField": "installed_on", "referenced": "16777219", "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219" }]}; var input = new JSON().encode(payload); var output = SNC.IdentificationEngineScriptableApi.createOrUpdateCIEnhanced('ServiceNow', input, {}); 出力: { "items": [ { "className": "cmdb_ci_win_server", "operation": "NO_CHANGE", "sysId": "65d873d2b3a0001028f6eae2c6a8dc2a", "relatedSysIds": [ "a1d873d2b3a0001028f6eae2c6a8dc32", "a1d873d2b3a0001028f6eae2c6a8dc33" ], "relatedItems": [ { "className": "cmdb_serial_number", "sysId": "a1d873d2b3a0001028f6eae2c6a8dc32", "markers": [], "inputIndices": [ { "mainIndex": 0, "subIndex": 0 }] }, "className": "cmdb_serial_number", "sysId": "a1d873d2b3a0001028f6eae2c6a8dc33", "markers": [], "inputIndices": [ { "mainIndex": 0, "subIndex": 1 }] }], "additionalRelatedItems": [], "identificationAttempts": [], "errorCount": 0, "inputIndices": [0] }, { "className": "cmdb_ci_spkg", "operation": "NO_CHANGE", "sysId": "c764e971b320001028f6eae2c6a8dc44", "relatedSysIds": [ "8b64e971b320001028f6eae2c6a8dc47" ], "relatedItems": [ { "className": "cmdb_software_instance", "sysId": "8b64e971b320001028f6eae2c6a8dc47", "markers": [], "inputIndices": [ { "mainIndex": 1, "subIndex": 0 }] }], "additionalRelatedItems": [], "identifierEntrySysId": "a52a87c03746220006b216a543990e8c", "identificationAttempts": [ { "attributes": [ "key" ], "identifierName": "Software", "attemptResult": "MATCHED", "searchOnTable": "cmdb_ci_spkg", "hybridEntryCiAttributes": [] }], "errorCount": 0, "inputIndices": [1] }, { "className": "cmdb_ci_app_server_tomcat", "operation": "INSERT", "sysId": "6f29f3d2b3a0001028f6eae2c6a8dcc6", "identifierEntrySysId": "Unknown", "identificationAttempts": [ { "attributes": [ "install_directory", "running_process_key_parameters", "sys_class_name" ], "identifierName": "Tomcat", "attemptResult": "NO_MATCH", "searchOnTable": "cmdb_ci_app_server_tomcat", "hybridEntryCiAttributes": [] }, { "attributes": [ "cl_port", "sys_class_name" ], "identifierName": "Application Rule", "attemptResult": "SKIPPED", "searchOnTable": "cmdb_ci_appl", "hybridEntryCiAttributes": [] }, { "attributes": [ "running_process_command", "running_process_key_parameters", "sys_class_name" ], "identifierName": "Application Rule", "attemptResult": "NO_MATCH", "searchOnTable": "cmdb_ci_appl", "hybridEntryCiAttributes": [] } ], "errorCount": 0, "inputIndices": [2] } ], "additionalCommittedItems": [], "relations": [ { "className": "cmdb_rel_ci", "operation": "INSERT", "sysId": "6729f3d2b3a0001028f6eae2c6a8dcc9", "errorCount": 0, "inputIndices": [0] }], "additionalCommittedRelations": [] } ## IdentificationEngineScriptableApi - identifyCI(文字列 jsonString) {#ariaid-title4} データベースで操作をコミットせずに、指定されたペイロードに対して実行する操作 (挿入/更新) を決定します。 注: 識別ルールがそのように構成されている場合、このメソッドは非 CMDB テーブルも取り込むことができます。非 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)」を参照してください。 これは createOrUpdateCI()と同じように機能しますが、結果はコミットされません。 {#IES-identifyCI_S__id_mqd_n1t_pyb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | jsonString | 文字列 | 追加または更新する構成アイテムの JSON 形式の文字列。各入力文字列の形式は「items: \[{}\], relations:\[{}\]」です。ここで、items および relations リスト内の各アイテムには名前と値のペアが含まれます。 アイテムリスト内で可能な名前と値のペアは次のとおりです。 * className:作成または更新する CI の Sys_class_name。 * lookup:\[{}\]:アイテムリストのような名前と値のペアを持つ各アイテムを含むレコードリスト。 * values:{}:名前と値のペアとしての CI のフィールド情報。名前はフィールド名です。 関係リスト内で使用可能な名前と値のペアは次のとおりです。 * child:依存関係にある子アイテムのインデックス * parent:依存関係内の親アイテムのインデックス * type:関係性タイプ。これは、cmdb_rel_type テーブルの名前フィールド値の 1 つです。 | [表 : 5. パラメーター] {#IES-identifyCI_S__id_mqd_n1t_pyb} {#IES-identifyCI_S__id_mdr_q1t_pyb__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 結果のリストである JSON 形式の文字列。各結果文字列の形式は「items: \[{}\], relations:\[{}\]」です。ここで、items および relations リスト内の各アイテムには名前と値のペアが含まれます。 アイテムリスト内で可能な名前と値のペアは次のとおりです。 * className:更新または作成された CI の Sys_class_name。 * duplicateIndices:現在のアイテムと重複しているアイテムのインデックスのリスト。 * errors:(エラー、メッセージ文字列) 形式のエラーのリスト * identificationAttempts:試行のリスト。 * attemptResult:SKIPPED、NO_MATCH、MATCHED、MULTI_MATCH のいずれか。 * attributes:識別中に使用される識別子エントリの属性。 * identiferName:この識別子エントリが属する CI ID。 * searchOnTable:識別プロセス中に検索されるテーブル。 * identifierEntrySysId:照合中に使用される識別子エントリのSys_id。 * operation:実行する操作。次のいずれかです。 * 消去 * 挿入 * 更新 * UPDATE_WITH_DOWNGRADE * UPDATE_WITH_SWITCH * UPDATE_WITH_UPGRADE * relatedSysIds:ルックアップベースの識別中に使用される CI のsys_id値のリスト。 * sysId:更新または作成された CI の Sys_id。 {#IES-identifyCI_S__ul_axv_x4h_1t} 関係リスト内で使用可能な名前と値のペアは次のとおりです。 * className:関係 CI のクラス名であり、常にcmdb_rel_ciです * operation:操作のタイプ:INSERT、UPDATE、NO_CHANGE * sysId:CI が挿入または更新された関係のSys_id {#IES-identifyCI_S__ul_ajf_wzl_jt} | [表 : 6. 返される内容] {#IES-identifyCI_S__id_mdr_q1t_pyb} ルックアップベースの識別で独立 CI を識別します。 var payload = {items: [ {className:'cmdb_ci_netgear', values: {name:'ny8500-nbxs08', ports:'1200'}, lookup: [{className:'cmdb_serial_number', values:{serial_number:'1234ABCD', serial_number_type:'uuid',absent:'false',valid:'true'}}, {className:'cmdb_serial_number', values:{serial_number:'3456EFGH', serial_number_type:'system',absent:'false',valid:'true'}}]}]}; var jsonUntil = new JSON(); var input = jsonUntil.encode(payload); var output = SNC.IdentificationEngineScriptableApi.identifyCI(input); gs.print(output); 出力: { "items": [ { "className": "cmdb_ci_netgear", "operation": "UPDATE", "sysId": "55b35562c0a8010e01cff22378e0aea9", "relatedSysIds": [ null, null ], "relatedItems": [ { "errors": [ ], "operation": "INSERT", "info": [ ], "errorCount": 0, "mergedPayloadIds": [ ], "inputIndices": [ { "mainIndex": 0, "subIndex": 0 } ], "warningCount": 0, "markers": [ ], "className": "cmdb_serial_number" }, { "errors": [ ], "operation": "INSERT", "info": [ ], "errorCount": 0, "mergedPayloadIds": [ ], "inputIndices": [ { "mainIndex": 0, "subIndex": 1 } ], "warningCount": 0, "markers": [ ], "className": "cmdb_serial_number" } ], "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92", "identificationAttempts": [ { "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "attributes": [ "source_name", "source_native_key" ], "searchOnTable": "sys_object_source", "hybridEntryCiAttributes": [ ] }, { "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "attributes": [ "serial_number", "serial_number_type" ], "searchOnTable": "cmdb_serial_number", "hybridEntryCiAttributes": [ ] }, { "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "attributes": [ "serial_number" ], "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [ ] }, { "identifierName": "Hardware Rule", "attemptResult": "MATCHED", "attributes": [ "name" ], "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [ ] } ], "info": [ ], "errorCount": 0, "mergedPayloadIds": [ ], "inputIndices": [ 0 ], "warningCount": 0, "markers": [ ] } ], "additionalCommittedItems": [ ], "relations": [ ], "additionalCommittedRelations": [ ], "hasError": false, "hasWarning": false } ### スコープ対応 スコープ対象のアプリケーションで identifyCI(String jsonString) メソッドを使用するには、対応するスコープ対象の IdentificationEngine メソッドである [identifyCI(String jsonString)](https://servicenow-prod.fluidtopics.net/0raPRiAvbITTm71R1Fuqug#IESS-identifyCI_S "データベースで操作をコミットせずに、指定されたペイロードに対して実行する操作 (挿入/更新) を決定します。") を使用します。 ## IdentificationEngineScriptableApi - identifyCIEnhanced(文字列ソース、文字列入力、オブジェクトオプション) {#ariaid-title5} データベース内の操作をコミットせずに、指定されたペイロード (要求本文) で実行する 構成管理データベース (CMDB) 操作 (挿入/更新) を決定します。 注: 識別ルールがそのように構成されている場合、このメソッドは非 CMDB テーブルも取り込むことができます。非 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)」を参照してください。 この方法を使用して、ペイロードの送信をシミュレートします。 このメソッドは [IdentificationEngineScriptableApi - identifyCI(文字列 jsonString)](https://servicenow-prod.fluidtopics.net/efxbwjzT4jCKc5M95kiQjw#IES-identifyCI_S "データベースで操作をコミットせずに、指定されたペイロードに対して実行する操作 (挿入/更新) を決定します。") メソッドと似ていますが、次の機能もサポートしています。 * 部分的ペイロード * アイテムに警告またはエラーがある場合は、アイテム操作がINSERT_AS_PARTIALかINSERT_INCOMPLETEかを示します。 * 既存の部分的ペイロードと結合された部分的ペイロードのsys_idsを返します。 {#IES-IdentifyCIEnhanced_S_S_O__ul_x4s_nvk_xlb} * ペイロードの重複排除機能をサポートします。 * サマリーを生成します。 {#IES-IdentifyCIEnhanced_S_S_O__ul_scj_jvk_xlb} {#IES-IdentifyCIEnhanced_S_S_O__IRE-payload__entry__3}{#IES-IdentifyCIEnhanced_S_S_O__entry_input}{#IES-IdentifyCIEnhanced_S_S_O__entry_items}{#IES-IdentifyCIEnhanced_S_S_O__entry_className}{#IES-IdentifyCIEnhanced_S_S_O__entry-display_values-ire}{#IES-IdentifyCIEnhanced_S_S_O__entry_internal_id}{#IES-IdentifyCIEnhanced_S_S_O__entry_lookup}{#IES-IdentifyCIEnhanced_S_S_O__entry-input_items_lookup_className}{#IES-IdentifyCIEnhanced_S_S_O__entry_related}{#IES-IdentifyCIEnhanced_S_S_O__entry-input_items_related_className}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_settings}{#IES-IdentifyCIEnhanced_S_S_O__items_set_skipReclassRestrictRules-entry-IRE}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutDowngrade}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutSwitch}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutUpgrade}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_sys_object_source_info}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_feed}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_name}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_native_key}{#IES-IdentifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_recency_timestamp}{#IES-IdentifyCIEnhanced_S_S_O__entry_values}{#IES-IdentifyCIEnhanced_S_S_O__entry_referenceItems}{#IES-IdentifyCIEnhanced_S_S_O__entry_referenceItems_referenced}{#IES-IdentifyCIEnhanced_S_S_O__entry_referenceItems_referencedBy}{#IES-IdentifyCIEnhanced_S_S_O__entry_referenceItems_referenceField}{#IES-IdentifyCIEnhanced_S_S_O__entry_relations}{#IES-IdentifyCIEnhanced_S_S_O__entry_relations_child}{#IES-IdentifyCIEnhanced_S_S_O__entry_relations_child_id}{#IES-IdentifyCIEnhanced_S_S_O__entry_relations_parent}{#IES-IdentifyCIEnhanced_S_S_O__entry_relations_parent_id}{#IES-IdentifyCIEnhanced_S_S_O__sys_rel_source_info-entry-IRE}{#IES-IdentifyCIEnhanced_S_S_O__sys_rel_source_info-source_name-entry-ire}{#IES-IdentifyCIEnhanced_S_S_O__sys_rel_source_into-source_feed-entry-ire}{#IES-IdentifyCIEnhanced_S_S_O__entry_relations_type}{#IES-IdentifyCIEnhanced_S_S_O__entry_options}{#IES-IdentifyCIEnhanced_S_S_O__entry_options_deduplicate_payloads}{#IES-IdentifyCIEnhanced_S_S_O__entry_options_generate_summary}{#IES-IdentifyCIEnhanced_S_S_O__entry_options_partial_commits}{#IES-IdentifyCIEnhanced_S_S_O__entry_options_partial_payloads}{#IES-IdentifyCIEnhanced_S_S_O__entry_source} | 名前 | タイプ | 説明 | |-|-|-| | input | 文字列 | 必須です。入力ペイロード。追加または更新する構成アイテムの JSON 形式の文字列。 "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] } | | input.items | オブジェクトのアレイ | 追加または更新するアイテム。 "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] | | input.items.className | 文字列 | 必須です。作成または更新する構成アイテム (CI) のクラス/テーブル名 (sys_class_name)。 この値は、cmdb_ci_linux_server や cmdb_ci_win_server など、任意の CMDB クラス/テーブルにすることができます。 | | input.items.display_values | オブジェクト | この関連アイテムを名前と値のペアとして作成または更新するための参照フィールドです。名前はフィールド名で、値は参照される表示値です。参照フィールドの表示値の代わりにsys_idを使用する場合は、このパラメーターではなく input.items.lookup.values パラメーターに情報を渡します。 参照フィールド名は、次のようなユーザーが選択したフィールドによって異なります。 "display_values": { "model_id": "String", "location": "String" } | | input.items.internal_id | 文字列 | 関連付けられたペイロードの一意のアイテム識別子。 これは任意の値にすることができますが、ペイロード内で一意である必要があります。 | | input.items.lookup | オブジェクトのアレイ | ルックアップ (ルックアップベースの識別) を含むトップレベルのアイテムを識別します。これらのレコードは、cmdb_ciへの参照を持つルックアップテーブルに基づいて構成アイテムを識別するために使用されます。 例： "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] | | input.items.lookup.className | 文字列 | 必須です。作成または更新する構成アイテム (CI) のクラス/テーブル名 (sys_class_name)。 この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルにすることができます。 | | input.items.lookup.internal_id | 文字列 | 関連付けられたペイロードの一意のルックアップアイテム識別子。 これは任意の値にすることができますが、ペイロード内で一意である必要があります。 | | input.items.lookup.sys_オブジェクト_ソース_情報 | オブジェクト | 特定のデータソースに対して一意の CI ID を定義します。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } | | input.items.lookup.sys_object_source_info.source_feed | 文字列 | ソースが複数のフィードを持つことができる場合は、このフィールドを使用して、このアイテムを送信するフィードの名前を入力します。 データソースによってこのフィード名が生成されます。ソースフィードを一意に識別する任意の文字列にすることができます。 | | input.items.lookup.sys_object_source_info.source_name | 文字列 | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 | | input.items.lookup.sys_object_source_info.source_native_key | 文字列 | ソースからのアイテムの一意のキー ID。 データソースはこのキーを生成します。アイテムに固有の任意の文字列を指定できます。 | | input.items.lookup.sys_object_source_info.source_recency_timestamp | 文字列 | アイテムがスキャンされた UTC 日時。 形式:YYYY-MM-DD hh:mm:ss | | input.items.lookup.values | オブジェクト | 名前と値のペアとしての CI のフィールド情報 (名前はフィールド名です)。参照フィールドを更新する場合、値は参照sys_idである必要があります。 フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "serial_number": "String", "serial_number_type": "String", "valid": "String", "ip_address": "String", "mac_address": "String" } | | input.items.related | オブジェクトのアレイ | 関連リストを含むトップレベルのアイテムへの参照。関連エントリ \[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_オブジェクト_ソース_情報 | オブジェクト | 指定されたデータソースの一意の CI ID を構成するオブジェクト。ソースが異なれば、同じ 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" } | | input.items.settings | オブジェクト | 許可される更新のタイプを定義するパラメーター。 "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } | | input.items.settings.skipReclassificationRestrictionRules | ブーリアン | ペイロードアイテムのクラスに一致する再分類制限ルールを IRE が実行しないかどうかを示すフラグ。 有効な値： * true:ルールの実行をスキップします。 * false:ルールを実行します。 {#IES-IdentifyCIEnhanced_S_S_O__ul_tl4_qwp_snb} デフォルト値：false | | input.items.settings.updateWithoutDowngrade | ブーリアン | このアイテムに対して更新とダウングレードの両方が許可されているかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、ダウングレードは許可されていません。 * false:アイテムの更新とダウングレードの両方が許可されています。 {#IES-IdentifyCIEnhanced_S_S_O__ul_jdl_pfb_sjb} デフォルト値：false | | input.items.settings.updateWithoutSwitch | ブーリアン | アイテムを更新できるかどうか、およびクラスを切り替えることができるかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、クラスの切り替えは許可されません。 * false:アイテムの更新とクラスの切り替えの両方が許可されます。 {#IES-IdentifyCIEnhanced_S_S_O__ul_h4p_2gb_sjb} デフォルト値：false | | input.items.settings.updateWithoutUpgrade | ブーリアン | このアイテムに対して更新とアップグレードの両方が許可されているかどうかを示すフラグ。 有効な値： * true:アイテムを更新しますが、アップグレードは許可されていません。 * false:アイテムの更新とアップグレードの両方が許可されています。 {#IES-IdentifyCIEnhanced_S_S_O__ul_vqx_xfb_sjb} デフォルト値：false | | input.items.sys_オブジェクト_ソース_情報 | オブジェクト | 特定のソースの一意の CI ID。 "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } | | input.items.sys_object_source_info.source_feed | 文字列 | ソースが複数のフィードを持つことができる場合は、このフィールドを使用して、このアイテムを送信するフィードの名前を入力します。 データソースによってこのフィード名が生成されます。ソースフィードを一意に識別する任意の文字列にすることができます。 | | input.items.sys_object_source_info.source_name | 文字列 | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 | | input.items.sys_object_source_info.source_native_key | 文字列 | ソースからのアイテムの一意のキー/ID。 データソースはこのキーを生成します。アイテムに固有の任意の文字列を指定できます。 | | input.items.sys_object_source_info.source_recency_timestamp | 文字列 | アイテムがスキャンされた UTC 日時。 形式:YYYY-MM-DD hh:mm:ss | | input.items.values | オブジェクト | この関連アイテムを名前/値のペアとして作成または更新するフィールド (名前はフィールド名)。参照フィールドの場合、値は参照sys_idである必要があります。参照フィールドのsys_idの代わりに表示値を使用する場合は、この情報をvaluesオブジェクトではなくdisplay_valuesオブジェクトに渡します。 フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } | | input.referenceItems | オブジェクトのアレイ | 入力ペイロード内のアイテム間の参照を定義するリスト。各参照アイテムの値は、クラスで定義された IRE ルールを使用して CI を識別する前に入力されます。 "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] | | input.referenceItems.referenced | 文字列 | 別のアイテムによって参照されているアイテムに対して定義された internal_id 。 | | input.referenceItems.referencedBy | 文字列 | 別のアイテムを参照するアイテムに対して定義された internal_id 。 | | input.referenceItems.referenceField | 文字列 | referencedByアイテムのクラス/テーブル内の参照フィールドの名前。 | | input.relations | オブジェクトのアレイ | 入力ペイロード内のアイテム間の関係を指定するリスト。 このアレイ内のオブジェクトは、2 つの形式のいずれかを使用できます。 * このオブジェクトは、 parent と child の名前と値のペアを使用して 2 つのトップレベルのアイテム間の関係を (のみ) 定義できます。その値はペイロード items アレイのアイテムインデックスを表します。 "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] * このオブジェクトは、 parent_id と child_id のキー/値のペアを使用して、トップレベルアイテム、関連アイテム、ルックアップアイテムを含む任意の 2 つのアイテム間の関係を定義できます。その値はそれらのアイテムに定義された internal_id 値を表します。 "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#IES-IdentifyCIEnhanced_S_S_O__ul_s1s_phb_nlb} | | input.relations.child | 番号 | 関係 (items、items.related、または items.lookup) の子を表す items アレイ内の CI オブジェクトの整数インデックス。 | | input.relations.child_id | 文字列 | 関係内の子アイテムの internal_id (items、items.related、または items.lookup)。 | | input.relations.parent | 番号 | itemsアレイ内の親アイテム (items、items.related、または items.lookup) の整数インデックス。 | | input.relations.parent_id | 文字列 | 関係内の親アイテムの internal_id (items、items.related、または items.lookup)。 | | input.relations.sys_rel_source_info | オブジェクト | 関係のディスカバリーソース情報。非依存関係の場合、この情報は関係性ソース \[sys_rel_source\] テーブルに保存されます ( identifyCIEnhanced() メソッドまたは identifyCI() メソッドでは保持されません)。 データタイプ: オブジェクト "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } | | input.relations.sys_rel_source_info.source_name | 文字列 | ディスカバリーソースの名前。 デフォルト:API メソッドパラメーターで渡されたディスカバリーソース。 | | input.relations.sys_rel_source_info.source_feed | 文字列 | ディスカバリーソース内のサブディスカバリー/スキャンである任意の文字列。 デフォルト:「UNKNOWN」は、テーブルでレコードを作成するときに \[source_feed\] 列に保存されsys_rel_source。 | | input.relations.type | 文字列 | 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係性タイプ \[cmdb_rel_type\] テーブルの名前フィールド値である必要があります。 | | オプション | オブジェクト | オプションですが、{} または null を渡す必要があります。機能を有効または無効にするオプション。 注: デフォルトでは、または partial_payloads が true に設定されている場合、部分的ペイロード機能に不可欠な機能であるため、false に設定されていても、 partial_commits と deduplicate_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:重複するアイテムをエラーと見なします。 {#IES-IdentifyCIEnhanced_S_S_O__ul_xv5_bws_mjb} デフォルト：true | | options.generate_summary | ブーリアン | 返された結果にサマリー情報が含まれているかどうかを示すフラグ。返されるサマリー情報の詳細については、返される結果テーブルの \.summary を参照してください。 有効な値： * true:サマリー情報を含めます。 * false:サマリー情報を含めません。 {#IES-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:部分的なコミットが無効です。 {#IES-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:部分的ペイロードが無効です。 {#IES-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_infosys_object_sourceのlast_scan時間フィールドを更新しません。 * false:sys_object_sourceのlast_scan時間フィールドを更新します。 {#IES-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. パラメーター] {#IES-IdentifyCIEnhanced_S_S_O__table_lqf_msb_jlb} {#IES-IdentifyCIEnhanced_S_S_O__entry__170}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_additionalCommittedRelations}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_hasError}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_hasWarning}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems}{#IES-IdentifyCIEnhanced_S_S_O__items_addRelItems_className-entry-IRE}{#IES-IdentifyCIEnhanced_S_S_O__items_addRelItems_inputIndices-entry-IRE}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems_mergedPayloadIds}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems_operations}{#IES-IdentifyCIEnhanced_S_S_O__items_addRelItems_sysId-entry-IRE}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_className}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_items_duplicateIndices}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_errorCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_error}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_attemptResult}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_attributes}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_identifierName}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_searchOnTable}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_identifierEntrySysId}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_items_inputIndices}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_maskedAttributes}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_operation}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_relatedItems_identifyCI}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_relatedItems_errorCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_relatedItems_errors}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices.mainIndex}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices.subIndex}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_relatedSysIds}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_item_sys_id}{#IES-IdentifyCIEnhanced_S_S_O___identifyCI}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_relations_className}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_relations_errorsCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_relations_errors}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_relations_inputIndices}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_relations_operation}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_relations_sys_id}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_additionalInsertedItemCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_errorCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_incompleteItemCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_insertedItemCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_partialItemCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_unchangedItemCount}{#IES-IdentifyCIEnhanced_S_S_O__entry_return_summary_class_name_updatedItemCount}{#IES-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} } | | \.additionalCommittedItems | 現在のペイロードの IRE 処理中にコミットされたが、現在の入力ペイロードには存在しなかった CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "operation": "String", "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "sysId": "String" } ] | | \.additionalCommittedRelations | 挿入または更新する要求本文 relations リストに含まれていなかった依存関係性 CI の説明。 データタイプ：オブジェクトのアレイ "additionalCommittedRelations": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String" } ] | | \.hasError | アイテムまたは関係にエラーがあるかどうかを示すフラグ。 データタイプ：ブーリアン | | \.hasWarning | アイテムまたは関係に警告があるかどうかを示すフラグ。 データタイプ：ブーリアン | | \.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" } ] | | \.items.additionalRelatedItems | 処理されたものの、入力ペイロードの一部として提供されなかった追加のルックアップおよび関連アイテムに関する情報。これらのアイテムは部分的ペイロードからのものです。 データタイプ：オブジェクトのアレイ "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "mergedPayloadIds": [Array], "operation": "String", "sysId": "String" } ] | | \.items.additionalRelatedItems.className | 作成または更新された CI のクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.additionalRelatedItems.inputIndices | この関連アイテムに対応する要求本文 items アレイの CI のインデックス値。 データタイプ:数値の配列 | | \.items.additionalRelatedItems.mergedPayloadIds | 関連アイテムに結合された部分的ペイロードのsys_idsのリスト。 データタイプ：アレイ テーブル:CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] | | \.items.additionalRelatedItems.operation | 操作のタイプ 可能な値： * INSERT:新しい CI がデータベースに挿入されました。 * NO_CHANGE:CI の変更は行われませんでした。 * 更新:既存の CI が更新されました。 {#IES-IdentifyCIEnhanced_S_S_O__ul_rk4_fxz_mjb} データタイプ：文字列 | | \.items.additionalRelatedItems.sysId | 更新または作成された CI のSys_id。 データタイプ：文字列 | | \.items.className | 作成または更新された CI のクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.duplicateIndices | 現在のアイテムと重複している CI のインデックスのリスト。 データタイプ：アレイ | | \.items.errorCount | アイテムの処理中に発生したエラーの数。 データタイプ：数値 | | \.items.errors | この CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.items.errors.error | CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 | | \.items.errors.message | CI の処理中にエラーメッセージが表示されました。 データタイプ：文字列 | | \.items.identificationAttempts | CI を識別するために行われた試行のリスト。 データタイプ：オブジェクトのアレイ "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identifierName": "String", "searchOnTable": "String" } ] | | \.items.identificationAttempts.attemptResult | CI の識別を試みた結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 データタイプ：文字列 | | \.items.identificationAttempts.attributes | 識別プロセス中に使用された CI ID エントリ属性のリスト。 データタイプ：アレイ 属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。 "attributes": [ "serial_number": "String", "serial_number_type": "String", ] | | \.items.identificationAttempts.identifierName | この CI 識別試行に使用される識別子ルール。 データタイプ：文字列 | | \.items.identificationAttempts.searchOnTable | 識別プロセス中に検索されたテーブルの名前。 データタイプ：文字列 | | \.items.identifierEntrySysId | CI を識別するために使用される識別子ルールのSys_id。 データタイプ：文字列 テーブル:識別子エントリ \[cmdb_identifier_entry\] | | \.items.info | アイテムの処理に関する追加情報。 データタイプ：オブジェクトのアレイ "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] | | \.items.info.code | スキップされた再分類タイプ。 可能な値： * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_UPGRADE {#IES-IdentifyCIEnhanced_S_S_O__ul_m11_1zp_snb} データタイプ：文字列 | | \.items.info.message | 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。 データタイプ：文字列 | | \.items.info.ruleSysId | 一致した再分類制限ルールのSys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグが原因で再分類がスキップされた場合、この値は空です。 データタイプ：文字列 | | \.items.inputIndices | 対応する入力 CI のインデックス。トップレベルのアイテムの場合は、整数のリストです。関連 CI またはルックアップ CI の場合は、JSON オブジェクトのリストです。 データタイプ:数値の配列 | | \.items.maskedAttributes | 調整 [ルール](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)で定義されているとおりに、権限のないデータソースによる更新がスキップされた属性のリスト。 データタイプ：アレイ | | \.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 が更新され、クラスがより特殊なクラス (子孫クラス) に変更されました。 {#IES-IdentifyCIEnhanced_S_S_O__ul_wyd_hj5_mjb} データタイプ：文字列 | | \.items.relatedItems | 処理された関連アイテムに関する情報。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "mergePayloadIds": [Array], "operation": "String", "sysId": "String", "warningCount": Number, "warnings": [Array] } ] | | \.items.relatedItems.className | 関連アイテムのクラス/テーブル名 (sys_class_name)。 データタイプ：文字列 | | \.items.relatedItems.errorCount | 関連アイテムの処理中に検出されたエラーの数。 データタイプ：数値 | | \.items.relatedItems.errors | 関連アイテムの処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.items.relatedItems.errors.error | 関連アイテムの処理中に発生したエラーのタイプ。 データタイプ：文字列 | | \.items.relatedItems.errors.message | 関連アイテムの処理中にエラーメッセージが表示されました。 データタイプ：文字列 | | \.items.relatedItems.inputIndices | 対応する入力アイテムのインデックス。トップレベルのアイテムの場合は、整数のリストです。関連アイテムまたはルックアップアイテムの場合は、JSON オブジェクトのリストです。 データタイプ:数値のアレイまたはオブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] | | \.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。 データタイプ：数値 | | \.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。 データタイプ：数値 | | \.items.relatedItems.mergedPayloadIds | 処理中に CI に結合された部分的ペイロードのsys_idsのリスト。 データタイプ：アレイ | | \.items.relatedItems.operation | 実行された操作。 可能な値： * INSERT:新しい関連 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 が更新され、クラスがより特殊化されたクラス (子孫クラス) に変更されました。 データタイプ：文字列 | | \.items.relatedItems.sysId | 関連アイテムのSys_id。 データタイプ：文字列 | | \.items.relatedItems.warningCount | 関連アイテムの処理時に発生した警告の数。 データタイプ：数値 | | \.items.relatedItems.warnings | 関連アイテムの処理中に発生した警告の説明。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] | | \.items.relatedSysIds | 関連アイテムのルックアップベースの識別中に使用された CI のsys_id値のリスト。 データタイプ：文字列 | | \.items.sys_id | 更新または作成された CI のSys_id。 データタイプ：文字列 | | \.relations | 処理された関係に関する情報。 データタイプ：オブジェクトのアレイ "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "operation": "String", "sysId": "String" } ] | | \.relations.className | この依存関係 CI のSys_class_name。 サポートされている値:cmdb_rel_ci:CI 関係テーブルのみ。 データタイプ：文字列 | | \.relations.errorCount | 依存関係 CI の処理時に発生したエラーの数。 データタイプ：数値 | | \.relations.errors | この依存関係 CI の処理中に発生したエラーを説明するリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] | | \.relations.inputIndices | この依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス。 データタイプ：アレイ | | \.relations.operation | 実行された操作のタイプ。 可能な値： * INSERT:依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されました。 * INSERT_AS_INCOMPLETE:依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード \[cmdb_ire_incomplete_payloads\] テーブルに挿入されました。 * INSERT_AS_PARTIAL:依存関係 CI にエラーがあり、CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルに挿入されました。 * NO_CHANGE:操作は実行されませんでした。 * 更新:ターゲットテーブルの既存の依存関係 CI が更新されました。 データタイプ：文字列 | | \.relations.sysId | 依存関係 CI のSys_id。 データタイプ：文字列 | | \.summary | クラスごとに挿入されたアイテム数、更新されたアイテム数などの統計情報を提供する JSON プロパティのリスト。 データタイプ：アレイ | | \.summary.\ | 特定のクラスの統計情報。 データタイプ: オブジェクト : { "additionalInsertedItemCount": Number, "errorCount": Number, "incompleteItemCount": Number, "insertedItemCount": Number, "partialItemCount": Number, "skippedItemCount": Number, "unchangedItemCount": Number, "updatedItemCount": Number, "warningCount": Number } | | \.summary.\.additionalInsertedItemCount | 部分的ペイロードの処理のために挿入されたアイテムの数。 データタイプ：数値 | | \.summary.\.errorCount | アイテムの処理時に発生したエラーの数。 データタイプ：数値 | | \.summary.\.incompleteItemCount | CMDB IRE 不完全ペイロード \[cmdb_ire_incomplete_payloads\] テーブルに挿入されたアイテムの数。 データタイプ：数値 | | \.summary.\.insertedItemCount | 作成されたアイテムの数。 データタイプ：数値 | | \.summary.\.partialItemCount | 部分的ペイロードテーブル \[cmdb_ire_partial_payloads\] に保存されているアイテムの数。 データタイプ：数値 | | \.summary.\.skippedItemCount | スキップされたアイテムの数。 データタイプ：数値 | | \.summary.\.unchangedItemCount | エントリはあったが変更されていないアイテムの数。 データタイプ：数値 | | \.summary.\.updatedItemCount | 更新されたアイテムの数。 データタイプ：数値 | | \.summary.\.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": { }, "className": "cmdb_software_instance", "sys_object_source_info": { "source_feed": "SN Discovery Feed 1", "source_name": "ServiceNow", "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229" }} ], "settings" : { "skipReclassificationRestrictionRules" : "true", "updateWithoutDowngrade" : "true", "updateWithoutUpgrade" : "true", "updateWithoutSwitch" : "true" }}, { "className": "cmdb_ci_app_server_tomcat", "values": { "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start", "install_directory": "/opt/OV/nonOV/tomcat/b", "name": "Tomcat@hpom9:3443", "server_port": "8006", "sys_class_name": "cmdb_ci_app_server_tomcat" }, "internal_id": "tomcat_id" }], "relations": [ { "parent_id": "tomcat_id", "child_id": "16777219", "type": "Runs on::Runs" }], "referenceItems": [ { "referenceField": "installed_on", "referenced": "16777219", "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219" }]}; var input = new JSON().encode(payload); var output = SNC.IdentificationEngineScriptableApi.identifyCIEnhanced('ServiceNow', input, {}); 出力: { "items": [ { "className": "cmdb_ci_win_server", "operation": "INSERT", "relatedSysIds": [ null, null ], "relatedItems": [ { "errors": [], "operation": "INSERT", "className": "cmdb_serial_number", "errorCount": 0, "markers": [], "inputIndices": [ { "mainIndex": 0, "subIndex": 0 } ], "mergedPayloadIds": [], "warningCount": 0 }, { "errors": [], "operation": "INSERT", "className": "cmdb_serial_number", "errorCount": 0, "markers": [], "inputIndices": [ { "mainIndex": 0, "subIndex": 1 } ], "mergedPayloadIds": [], "warningCount": 0 } ], "identificationAttempts": [ { "attributes": [], "info": "sys_object_source NO_MATCH", "identifierName": "", "attemptResult": "NO_MATCH", "hybridEntryCiAttributes": [] }, { "attributes": [ "serial_number", "serial_number_type" ], "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "searchOnTable": "cmdb_serial_number", "hybridEntryCiAttributes": [] }, { "attributes": [ "serial_number" ], "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "attributes": [ "name" ], "identifierName": "Hardware Rule", "attemptResult": "NO_MATCH", "searchOnTable": "cmdb_ci_hardware", "hybridEntryCiAttributes": [] }, { "attributes": [ "mac_address", "name" ], "identifierName": "Hardware Rule", "attemptResult": "SKIPPED", "searchOnTable": "cmdb_ci_network_adapter", "hybridEntryCiAttributes": [] } ], "errorCount": 0, "markers": [], "inputIndices": [ 0 ], "mergedPayloadIds": [], "warningCount": 0 }, { "className": "cmdb_ci_spkg", "operation": "INSERT", "relatedSysIds": [ null ], "relatedItems": [ { "errors": [], "operation": "INSERT", "className": "cmdb_software_instance", "errorCount": 0, "markers": [], "inputIndices": [ { "mainIndex": 1, "subIndex": 0 } ], "mergedPayloadIds": [], "warningCount": 0 }, { "errors": [], "warnings": [ { "error": "MISSING_MATCHING_ATTRIBUTES", "message": "In payload missing minimum set of input values for criterion (matching) attributes from identify rule for table [cmdb_software_instance]. Add these input values in payload item '{\"className\":\"cmdb_software_instance\",\"values\":{},\"internal_id\":\"f7273cccec30101056cd4bb46eb4db5d\",\"sys_object_source_info\":{\"source_feed\":\"SN Discovery Feed 1\",\"source_name\":\"ServiceNow\",\"source_native_key\":\"Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229\"},\"settings\":{},\"sys_ire_info\":{\"ire_received_time\":\"2020-05-10 17:57:48\"}}'" } ], "operation": "INSERT_AS_PARTIAL", "className": "cmdb_software_instance", "errorCount": 0, "sysId": "Unknown", "markers": [], "inputIndices": [ { "mainIndex": 1, "subIndex": 1 } ], "mergedPayloadIds": [], "warningCount": 1 } ], "identificationAttempts": [ { "attributes": [], "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "hybridEntryCiAttributes": [] }, { "attributes": [ "key" ], "identifierName": "Software", "attemptResult": "NO_MATCH", "searchOnTable": "cmdb_ci_spkg", "hybridEntryCiAttributes": [] } ], "errorCount": 0, "markers": [], "inputIndices": [ 1 ], "mergedPayloadIds": [], "warningCount": 0 }, { "className": "cmdb_ci_app_server_tomcat", "operation": "INSERT", "identificationAttempts": [ { "attributes": [], "info": "sys_object_source SKIPPED", "identifierName": "", "attemptResult": "SKIPPED", "hybridEntryCiAttributes": [] } ], "errorCount": 0, "markers": [], "inputIndices": [ 2 ], "mergedPayloadIds": [], "warningCount": 0 } ], "additionalCommittedItems": [], "relations": [ { "className": "cmdb_rel_ci", "operation": "INSERT", "errorCount": 0, "markers": [], "inputIndices": [ 0 ], "mergedPayloadIds": [], "warningCount": 0 } ], "additionalCommittedRelations": [] }  ## IdentificationEngineScriptableApi - runIdentificationAudit(GlideRecord now_GR) {#ariaid-title6} 指定された構成アイテム (CI) に対して識別監査を実行し、重複を検出します。 重複が見つかった場合は、重複タスクが作成されます。この方法は、独立した識別ルールを持つ CI タイプでのみ使用してください。 {#r_IES-runIdentificationAudit_GR__table_tkz_h3m_jt__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | now_GR | GlideRecord | 重複を検出するために監査を実行する CI。CI には独立した識別ルールが必要です。 | [表 : 9. パラメーター] {#r_IES-runIdentificationAudit_GR__table_tkz_h3m_jt} {#r_IES-runIdentificationAudit_GR__table_ukz_h3m_jt__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 10. 返される内容] {#r_IES-runIdentificationAudit_GR__table_ukz_h3m_jt} 次の例は、サーバーで重複タスクをチェックし、重複修復タスクが存在する場合は作成する方法を示しています。 var grServer = new GlideRecord('cmdb_ci_server'); grServer.query(); while (grServer.next()) { SNC.IdentificationEngineScriptableApi.runIdentificationAudit(grServer); } {#r_IES-runIdentificationAudit_GR__codeblock_lmg_g5j_yrb} ### スコープ対応 スコープ対象のアプリケーションで runIdentificationAudit(GlideRecord now_GR) メソッドを使用するには、対応するスコープ対象の IdentificationEngine メソッドである [runIdentificationAudit(GlideRecord now_GR)](https://servicenow-prod.fluidtopics.net/0raPRiAvbITTm71R1Fuqug#IESS-runIdentificationAudit_GR "指定された構成アイテム (CI) に対して識別監査を実行し、重複を検出します。") を使用します。