IdentificationEngineScriptableApi - グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：165分

    • IdentificationEngineScriptableAPI は、識別および調整フレームワークを使用して、構成管理データベース (CMDB)の更新時に許可されたデータソースからの情報のみを受け入れることで、重複する構成アイテム (CI) の作成を最小限に抑え、CI 属性を調整します。

    IdentificationEngineScriptableApi - createOrUpdateCI(文字列ソース, 文字列入力)

    識別および調整ルールに基づいて、構成アイテム (CI) および非構成管理データベース (CMDB) CI (cmdb_ci から拡張されていないクラス) を CMDB に挿入または更新します。CMDBを直接更新する代わりに、この API を使用します。

    非 CMDB CI は、IRE ペイロードのルックアップアイテムまたは関連アイテムとして渡す必要があります。 非 CMDB テーブルの取り込みの詳細については、「 IRE support for non-CMDB tables」を参照してください。

    表 : 1. パラメーター
    名前 タイプ 説明
    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:ルールを実行します。

    デフォルト値：false
    input.items.settings.updateWithoutDowngrade ブーリアン このアイテムに対して更新とダウングレードの両方が許可されているかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、ダウングレードは許可されていません。
    • false:アイテムの更新とダウングレードの両方が許可されています。

    デフォルト値：false
    input.items.settings.updateWithoutUpgrade ブーリアン このアイテムに対して更新とアップグレードの両方が許可されているかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、アップグレードは許可されていません。
    • false:アイテムの更新とアップグレードの両方が許可されています。

    デフォルト値：false
    input.items.settings.updateWithoutSwitch ブーリアン アイテムを更新できるかどうか、およびクラスを切り替えることができるかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、クラスの切り替えは許可されません。
    • false:アイテムの更新とクラスの切り替えの両方が許可されます。

    デフォルト値：false
    input.items.sys_オブジェクト_ソース_情報 オブジェクト 特定のソースの一意の 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"
  }
]
    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] フィールドに定義されている選択値のいずれかである必要があります。
    表 : 2. 返される内容
    タイプ 説明
    <文字列> 入力文字列内の構成アイテムの結果リストである JSON 形式の文字列。各結果文字列の形式は「items: [{}], relations:[{}]」です。ここで、items および relations リスト内の各アイテムには名前と値のペアが含まれます。

    データタイプ：文字列
    <String>.additionalCommittedItems 現在、値が返されていません。
    <String>.additionalCommittedRelations 現在、値が返されていません。
    <String>.items 作成または更新された CI の説明。

    データタイプ: オブジェクト

    "items": { 
  "additionalRelatedItems": [Array],
  "className": "String",
  "duplicateIndices": [Array],
  "errorCount": Number,
  "errors": [Array],
  "identificationAttempts": [Array],
  "identifierEntrySysId": "String",
  "info": [Array],
  "inputIndices": [Array],
  "maskedAttributes": [Array],
  "operation": "String",
  "relatedItems": [Array],
  "relatedSysIds": [Array],
  "sysId": "String"
}
    <String>.items.additionalRelatedItems 処理されたものの、入力ペイロードの一部として提供されなかった追加のルックアップおよび関連アイテムに関する情報のリスト。これらのアイテムは部分的ペイロードからのものです。

    この情報は現在返されません。

    データタイプ：オブジェクトのアレイ

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.additionalRelatedItems.className 作成または更新された CI のクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.additionalRelatedItems.inputIndices 対応する入力アイテムのインデックス。トップレベルのアイテムの場合は、整数のリストです。関連アイテムまたはルックアップアイテムの場合は、JSON オブジェクトのリストです。

    データタイプ:数値のアレイまたはオブジェクトのアレイ

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.additionalRelatedItems.inputIndices.mainIndex 追加の関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。

    データタイプ：数値
    <String>.items.additionalRelatedItems.inputIndices.subIndex 追加の関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。

    データタイプ：数値
    <String>.items.additionalRelatedItems.operation 操作のタイプ

    可能な値：

    • INSERT:新しい CI がデータベースに挿入されました。
    • NO_CHANGE:CI の変更は行われませんでした。
    • 更新:既存の CI が更新されました。

    データタイプ：文字列
    <String>.items.additionalRelatedItems.sysId 追加の関連アイテムのSys_id。

    データタイプ：文字列
    <String>.items.className 作成または更新された CI のクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.duplicateIndices 現在のアイテムと重複している CI のインデックスのリスト。

    データタイプ：アレイ
    <String>.items.errorCount エラーの数。

    データタイプ：数値
    <String>.items.errors この CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.errors.error CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    <String>.items.errors.message エラーに関連するエラーメッセージ。

    データタイプ：文字列
    <String>.items.identificationAttempts CI を識別するために行われた試行のリスト。

    データタイプ：オブジェクトのアレイ

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <String>.items.identificationAttempts.attemptResult CI の識別を試みた結果。

    可能な値：

    • 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。
    • MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。
    • NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。
    • スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。

    データタイプ：文字列
    <String>.items.identificationAttempts.attributes 識別プロセス中に使用された CI ID エントリ属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.items.identificationAttempts.hybridEntryCiAttributes 現在、値が返されていません。
    <String>.items.identificationAttempts.identifierName この CI 識別試行に使用される識別子ルール。

    データタイプ：文字列
    <String>.items.identificationAttempts.searchOnTable 識別プロセス中に検索されたテーブルの名前。

    データタイプ：文字列
    <String>.items.identifierEntrySysId CI を識別するために使用される識別子ルールのSys_id。

    データタイプ：文字列

    テーブル:識別子エントリ [cmdb_identifier_entry]
    <String>.items.info アイテムの処理に関する追加情報を含むリスト。

    データタイプ：オブジェクトのアレイ

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    <String>.items.info.code スキップされた再分類タイプ。
    可能な値：
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    データタイプ：文字列
    <String>.items.info.message 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。

    データタイプ：文字列
    <String>.items.info.ruleSysId 一致した再分類制限ルールのSys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグが原因で再分類がスキップされた場合、この値は空です。

    データタイプ：文字列
    <String>.items.inputIndices この CI に対応する要求本文 items アレイの CI のインデックス値。

    データタイプ：アレイ
    <String>.items.maskedAttributes 調整 ルールで定義されているとおりに、権限のないデータソースによる更新がスキップされた属性のリスト。

    データタイプ：アレイ
    <String>.items.relatedItems 処理された関連アイテムに関する情報を提供するリスト。

    データタイプ：オブジェクトのアレイ

    "relatedItems": [
  { 
    "className": "String",
    "errors": [Array],
    "errorCount": Number, 
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.relatedItems.className 関連アイテムのクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.relatedItems.errors 処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.errorCount 処理中に検出されたエラーの数。

    データタイプ：数値
    <String>.items.relatedItems.inputIndices 対応する関連アイテムのインデックス。

    データタイプ:アレイまたは数値

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.relatedItems.inputIndices.mainIndex 関連アイテムの CI 親に対応する要求本文 items アレイの整数値。

    データタイプ：数値
    <String>.items.relatedItems.inputIndices.subIndex 関連アイテムに対応する要求本文 items.lookup アレイの整数値。

    データタイプ：数値
    <String>.items.relatedItems.operation 操作のタイプ

    可能な値：

    • INSERT:新しい CI がデータベースに挿入されました。
    • NO_CHANGE:CI の変更は行われませんでした。
    • 更新:既存の CI が更新されました。

    データタイプ：文字列
    <String>.items.relatedSysIds 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。

    注目値 - null:この関連アイテムのsys_idが特定されませんでした。

    データタイプ：アレイ
    <String>.items.sys_id 更新または作成された CI のSys_id。

    データタイプ：文字列
    <String>.relations 処理された関係に関する情報。

    データタイプ：オブジェクトのアレイ

    "relations":[
  { 
    "className": "String",
    "errorCount": Number,
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String" 
  }
]
    <String>.relations.className この依存関係 CI のSys_class_name。

    サポートされている値:cmdb_rel_ci:CI 関係テーブルのみ。

    データタイプ：文字列
    <String>.relations.errorCount エラーの数。

    データタイプ：数値
    <String>.relations.inputIndices 対応する入力関係のインデックス。

    データタイプ：アレイ
    <String>.relations.operation 実行された操作のタイプ。

    可能な値：

    • 挿入
    • 更新
    • NO_CHANGE

    データタイプ：文字列
    <String>.relations.sysId 依存関係 CI のSys_id。

    データタイプ：文字列

    構成アイテムを再分類する方法を次に示します。

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

    出力:

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

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

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

  "internal_id": "tomcat_id"
  }],

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

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

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

    出力:

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

    依存 CI を識別します。

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

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

    出力:

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

    ルックアップベースの識別で独立 CI を識別します。

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

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

    出力:

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

    スコープ対応

    スコープ対象のアプリケーションで createOrUpdateCI(String source, String input) メソッドを使用するには、対応するスコープ対象の IdentificationEngine メソッド createOrUpdateCI( String source, String input) を使用します。

    IdentificationEngineScriptableApi - createOrUpdateCIEnhanced(文字列ソース、文字列入力、オブジェクトオプション)

    識別および調整ルールに基づいて、構成アイテム (CI) および非構成管理データベース (CMDB) CI (cmdb_ci から拡張されていないクラス) を CMDB に挿入または更新します。CMDBを直接更新する代わりに、この API を使用します。

    非 CMDB CI は、IRE ペイロードのルックアップアイテムまたは関連アイテムとして渡す必要があります。 非 CMDB テーブルの取り込みの詳細については、「 IRE support for non-CMDB tables」を参照してください。

    このメソッドは、 createOrUpdateCI() メソッドの機能を提供するだけでなく、以下もサポートしています。
    • 部分的ペイロードの処理
    • 部分的なコミットの処理
    • ペイロード内の重複アイテムの削除
    • 出力サマリーを生成しています
    IRE の詳細と、このメソッドで使用されるデータの詳細な説明については、「 識別および調整 (IRE)」を参照してください。

    非 CMDB テーブルの取り込みの詳細については、「 IRE support for non-CMDB tables」を参照してください。

    表 : 3. パラメーター
    名前 タイプ 説明
    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:ルールを実行します。

    デフォルト値：false
    input.items.settings.updateWithoutDowngrade ブーリアン このアイテムに対して更新とダウングレードの両方が許可されているかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、ダウングレードは許可されていません。
    • false:アイテムの更新とダウングレードの両方が許可されています。

    デフォルト値：false
    input.items.settings.updateWithoutSwitch ブーリアン アイテムを更新できるかどうか、およびクラスを切り替えることができるかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、クラスの切り替えは許可されません。
    • false:アイテムの更新とクラスの切り替えの両方が許可されます。

    デフォルト値：false
    input.items.settings.updateWithoutUpgrade ブーリアン このアイテムに対して更新とアップグレードの両方が許可されているかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、アップグレードは許可されていません。
    • false:アイテムの更新とアップグレードの両方が許可されています。

    デフォルト値：false
    input.items.sys_オブジェクト_ソース_情報 オブジェクト 特定のソースの一意の 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"
  }
]
    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:重複するアイテムをエラーと見なします。

    デフォルト：true
    options.generate_summary ブーリアン 返された結果にサマリー情報が含まれているかどうかを示すフラグ。返されるサマリー情報の詳細については、返される結果テーブルの <String>.summary を参照してください。

    有効な値：

    • true:サマリー情報を含めます。
    • false:サマリー情報を含めません。

    デフォルト値：false
    options.partial_commits ブーリアン 部分コミットのサポートが有効かどうかを示すフラグ。部分コミットの詳細については、「 拡張 IRE 機能」を参照してください。

    有効な値：

    • true:部分的なコミットが有効です。
    • false:部分的なコミットが無効です。

    デフォルト：true
    options.partial_payloads ブーリアン 部分的ペイロードサポートが有効かどうかを示すフラグ。部分的ペイロードの詳細については、「 拡張 IRE 機能 」および「 IRE データソースルールの作成」を参照してください。

    有効な値：

    • true:部分的ペイロードが有効です。
    • false:部分的ペイロードが無効です。

    デフォルト：true
    options.skip_updating_last_scan_to_now ブーリアン sys_object_sourceのlast_scan時間フィールドの更新をスキップするかどうかを示すフラグ。
    有効な値：
    • true: source_recency_timestamp パラメーターが渡されない場合は sys_object_source_infosys_object_sourceのlast_scan時間フィールドを更新しません。
    • false:sys_object_sourceのlast_scan時間フィールドを更新します。

    デフォルト:glide.identification_engine.skip_updating_last_scan_to_now システムプロパティの値を使用します。
    options.skip_updating_source_last_discovered_to_now ブーリアン 構成アイテム [cmdb_ci] テーブルのdiscovery_sourceフィールドとlast_discoveredフィールドの更新をスキップするかどうかを示すフラグ。
    有効な値：
    • true:ペイロードアイテム値にlast_discoveredが指定されていない場合は、[discovery_source] フィールドと [last_discovered] フィールドを更新しないでください。
    • false:discovery_sourceフィールドとlast_discoveredフィールドを更新します。

    デフォルト:glide.identification_engine.skip_updating_source_last_discovered_to_now システムプロパティの値を使用します。
    ソース 文字列 CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの [discovery_source] フィールドに定義されている選択値のいずれかである必要があります。
    表 : 4. 返される内容
    パラメーター 説明
    <文字列> 入力文字列内の構成アイテムの結果リストである JSON 形式の文字列。

    データタイプ：文字列

    { 
  "additionalCommittedItems": [Array],  
  "additionalCommittedRelations": [Array], 
  "hasError": Boolean, 
  "hasWarning": Boolean,
  "items": [Array],  
  "relations": [Array], 
  "summary": {Object} 
}
    <String>.additionalCommittedItems 現在のペイロードの IRE 処理中にコミットされたが、現在の入力ペイロードには存在しなかった CI のリスト。

    データタイプ：オブジェクトのアレイ

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "operation": "String",
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "sysId": "String"
  }
]
    <String>.additionalCommittedItems.className この追加 CI のSys_class_name。

    データタイプ：文字列
    <String>.additionalCommittedItems.errorCount この追加 CI の処理中に発生したエラーの数。

    データタイプ：数値
    <String>.additionalCommittedItems.errors この追加の CI の処理中に発生したエラーを説明するオブジェクトのアレイ。

    データタイプ：アレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.additionalCommittedItems.errors.error 追加 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    <String>.additionalCommittedItems.errors.message 追加の CI の処理中にエラーメッセージが表示されました。

    データタイプ：文字列
    <String>.additionalCommittedItems.identificationAttempts オブジェクトのアレイ。各オブジェクトは、この追加の CI を識別する試みを記述します。
    データタイプ：オブジェクトのアレイ
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    <String>.additionalCommittedItems.identificationAttempts.attemptResult この追加の CI 識別試行の結果。

    データタイプ：文字列

    可能な値：
    • 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。
    • MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。
    • NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。
    • スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。
    <String>.additionalCommittedItems.identificationAttempts.attributes この追加の CI 識別試行中に使用される CI ID エントリ属性。

    データタイプ：アレイ

    属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes この追加の CI 識別試行中に使用される CI ID エントリ属性のアレイ。

    データタイプ：アレイ

    属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <String>.additionalCommittedItems.identificationAttempts.identifierName この追加の CI 識別の試行に使用される識別子ルール。

    データタイプ：文字列
    <String>.additionalCommittedItems.identificationAttempts.searchOnTable この追加の CI 識別試行が検索されたテーブルの名前。

    データタイプ：文字列
    <String>.additionalCommittedItems.identifierEntrySysId この追加の CI を識別するために使用される識別子ルールのSys_id。

    注目の値 - 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。
    <String>.additionalCommittedItems.inputIndices この追加 CI に対応する要求本文 items アレイの CI のインデックス値。

    データタイプ:数値の配列

    "inputIndices": [
  {
    Number
  }
]
    <String>.additionalCommittedItems.markers 内部使用用のマーカー値。

    データタイプ：アレイ

    "markers": []
    <String>.additionalCommittedItems.mergedPayloads この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのSys_id値。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    <String>.additionalCommittedItems.operation この追加 CI に対して実行された操作。

    データタイプ：文字列

    可能な値：
    • 削除:既存の CI がターゲットテーブルから削除されます。
    • INSERT:追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE:追加の CI に対して操作は実行されません。
    • 更新:ターゲットテーブルの既存の CI が更新されます。
    • UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。
    • UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。
    • UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。
    <String>.additionalCommittedItems.sysId 識別によってこの追加 CI のSys_idが見つかりました。

    データタイプ：文字列

    注目の値 - 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。
    <String>.additionalCommittedItems.warnings この追加 CI の処理中に発生した警告の説明。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.additionalCommittedItems.warnings.error この追加 CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    <String>.additionalCommittedItems.warnings.message この追加 CI の処理中に警告メッセージが表示されました。

    データタイプ：文字列
    <String>.additionalCommittedRelations 挿入または更新する要求本文 relations リストに含まれていなかった依存関係性 CI の説明。

    データタイプ：オブジェクトのアレイ

    "additionalCommittedRelations": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String"
  }
]
    <String>.additionalCommittedRelations.className この追加の依存関係 CI のsys_class_name。

    データタイプ：文字列

    サポートされている値:cmdb_rel_ci:CI 関係テーブルのみ。
    <String>.additionalCommittedRelations.errorCount この追加の依存関係 CI の処理中に発生したエラーの数。

    データタイプ：数値
    <String>.additionalCommittedRelations.errors この追加の依存関係 CI の処理中に発生したエラーの説明。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.additionalCommittedRelations.errors.error 追加の依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    <String>.additionalCommittedRelations.errors.message この追加の依存関係性 CI の処理中にエラーメッセージが発生しました。

    データタイプ：文字列
    <String>.additionalCommittedRelations.inputIndices この追加の依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス値。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    <String>.additionalCommittedRelations.markers 内部使用用のマーカー値。

    データタイプ：アレイ

    "markers": []
    <String>.additionalCommittedRelations.mergedPayloadIds この CI に対して結合された CMDB IRE 部分のペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのSys_id値。この追加の依存関係 CI の処理中に結合された値。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    <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 が更新されます。

    データタイプ：文字列
    <String>.hasError アイテムまたは関係にエラーがあるかどうかを示すフラグ。

    データタイプ：ブーリアン
    <String>.hasWarning アイテムまたは関係に警告があるかどうかを示すフラグ。

    データタイプ：ブーリアン
    <String>.items 作成または更新された CI の説明。

    データタイプ：オブジェクトのアレイ

    "items": [
  {  
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateIndices": [Array],
    "errorCount": Number, 
    "errors": [Array], 
    "identificationAttempts": [Array], 
    "identifierEntrySysId": "String",  
    "incompleteSysIds": "String",
    "info": [Array],
    "inputIndices": [Array], 
    "maskedAttributes": [Array],
    "operation": "String", 
    "partialSysIds": "String", 
    "relatedItems": [Array], 
    "relatedSysIds": [Array], 
    "sysId": "String" 
  }
]
    <String>.items.additionalRelatedItems 処理されたものの、入力ペイロードの一部として提供されなかった追加のルックアップおよび関連アイテムに関する情報。これらのアイテムは部分的ペイロードからのものです。

    データタイプ：オブジェクトのアレイ

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array],
    "mergedPayloadIds": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.additionalRelatedItems.className 作成または更新された CI のクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.additionalRelatedItems.inputIndices この関連アイテムに対応する要求本文 items アレイの CI のインデックス値。

    データタイプ:数値の配列
    <String>.items.additionalRelatedItems.mergedPayloadIds 関連アイテムに結合された部分的ペイロードのsys_idsのリスト。

    データタイプ：アレイ

    テーブル:CMDB IRE 部分のペイロード [cmdb_ire_partial_payloads]
    <String>.items.additionalRelatedItems.operation 操作のタイプ

    可能な値：

    • INSERT:新しい CI がデータベースに挿入されました。
    • NO_CHANGE:CI の変更は行われませんでした。
    • 更新:既存の CI が更新されました。

    データタイプ：文字列
    <String>.items.additionalRelatedItems.sysId 更新または作成された CI のSys_id。

    データタイプ：文字列
    <String>.items.className 作成または更新された CI のクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.duplicateIndices 現在のアイテムと重複している CI のインデックスのリスト。

    データタイプ：アレイ
    <String>.items.errorCount アイテムの処理中に発生したエラーの数。

    データタイプ：数値
    <String>.items.errors この CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.errors.error CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    <String>.items.errors.message エラーに関連するエラーメッセージ。

    データタイプ：文字列
    <String>.items.identificationAttempts CI を識別するために行われた試行のリスト。

    データタイプ：オブジェクトのアレイ

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <String>.items.identificationAttempts.attemptResult CI の識別を試みた結果。

    可能な値：

    • 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。
    • MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。
    • NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。
    • スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。

    データタイプ：文字列
    <String>.items.identificationAttempts.attributes 識別プロセス中に使用された CI ID エントリ属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>items.identificationAttempts.hybridEntryCiAttributes 識別プロセス中に使用された CI ID エントリ属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <String>.items.identificationAttempts.identifierName この CI 識別試行に使用される識別子ルール。

    データタイプ：文字列
    <String>.items.identificationAttempts.searchOnTable 識別プロセス中に検索されたテーブルの名前。

    データタイプ：文字列
    <String>.items.identifierEntrySysId CI を識別するために使用される識別子ルールのSys_id。

    データタイプ：文字列

    テーブル:識別子エントリ [cmdb_identifier_entry]
    <String>.items.incompleteSysIds アイテムにエラーがあり、不完全なペイロードとして保存された場合、このパラメーターには CMDB IRE 不完全なペイロード [cmdb_ire_incomplete_payloads] テーブルのレコードのsys_idが含まれます。

    データタイプ：文字列
    <String>.items.info アイテムの処理に関する追加情報。

    データタイプ：オブジェクトのアレイ

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    <String>.items.info.code スキップされた再分類タイプ。
    可能な値：
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_UPGRADE

    データタイプ：文字列
    <String>.items.info.message 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。

    データタイプ：文字列
    <String>.items.info.ruleSysId 一致した再分類制限ルールのSys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグが原因で再分類がスキップされた場合、この値は空です。

    データタイプ：文字列
    <String>.items.inputIndices 対応する入力 CI のインデックス。トップレベルのアイテムの場合は、整数のリストです。関連 CI またはルックアップ CI の場合は、JSON オブジェクトのリストです。

    データタイプ:数値の配列
    <String>.items.maskedAttributes 調整 ルールで定義されているとおりに、権限のないデータソースによる更新がスキップされた属性のリスト。

    データタイプ：アレイ
    <String>.items.operation 実行された操作。

    可能な値：

    • INSERT:新しい CI がデータベースに挿入されました。
    • INSERT_AS_INCOMPLETE:アイテムはcmdb_ire_incomplete_payloadsテーブルに保存されました。
    • INSERT_AS_PARTIAL:アイテムはcmdb_ire_partial_payloadsテーブルに保存されました。
    • 更新:既存の CI が更新されました。
    • UPDATE_WITH_DOWNGRADE:CI が更新され、クラスがより汎用的なクラス (先祖クラス) に変更されました。
    • UPDATE_WITH_SWITCH:CI が更新され、クラスが先祖でも子孫でもないクラスに変更されました。
    • UPDATE_WITH_UPDRADE:CI が更新され、クラスがより特殊なクラス (子孫クラス) に変更されました。

    データタイプ：文字列
    <String>.items.partialSysIds アイテムにエラーがあり、部分的ペイロードとして保存された場合、このパラメーターには部分的ペイロードレコードのsys_idが含まれます。

    データタイプ：文字列
    <String>.items.relatedItems 要求本文 items.lookup アレイからの関連 CI (テーブルルックアップ CI) を記述する JSON オブジェクトのリスト。

    データタイプ：オブジェクトのアレイ

    "relatedItems": [
  { 
    "className": "String",
    "errors": [Array],
    "errorCount": Number, 
    "incompleteSysIds": [Array],
    "inputIndices": [Array],
    "mergePayloadIds": [Array],
    "operation": "String",
    "partialSysIds": [Array], 
    "sysId": "String",
    "warningCount": Number,
    "warnings": [Array]
  }
]
    <String>.items.relatedItems.className 関連アイテムのクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.relatedItems.errors 関連アイテムの処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.errors.error 関連アイテムの処理中に発生したエラーのタイプ。

    データタイプ：文字列
    <String>.items.relatedItems.errors.message エラーに関連するエラーメッセージ。

    データタイプ：文字列
    <String>.items.relatedItems.errorCount 関連アイテムの処理中に検出されたエラーの数。

    データタイプ：数値
    <String>.items.relatedItems.incompleteSysIds 関係にエラーがあり、不完全なペイロードとして保存された場合、この値は CMDB IRE 不完全なペイロード [cmdb_ire_incomplete_payloads] テーブル内のレコードのsys_idです。

    データタイプ：文字列
    <String>.items.relatedItems.inputIndices 対応する入力アイテムのインデックス。トップレベルのアイテムの場合は、整数のリストです。関連アイテムまたはルックアップアイテムの場合は、JSON オブジェクトのリストです。

    データタイプ:数値のアレイまたはオブジェクトのアレイ

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.relatedItems.inputIndices.mainIndex 関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。

    データタイプ：数値
    <String>.items.relatedItems.inputIndices.subIndex 関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。

    データタイプ：数値
    <String>.items.relatedItems.mergedPayloadIds 処理中に CI に結合された部分的ペイロードのsys_idsのリスト。

    データタイプ：アレイ
    <String>.items.relatedItems.operation 実行された操作。

    可能な値：

    • 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 が更新され、クラスがより特殊化されたクラス (子孫クラス) に変更されました。

    データタイプ：文字列
    <String>.items.relatedItems.partialSysIds 関連アイテムにエラーがあり、部分的ペイロードとして保存された場合、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブル内の関連レコードのsys_idsのリストが含まれます。

    データタイプ：アレイ
    <String>.items.relatedItems.sysId 関連アイテムのSys_id。

    データタイプ：文字列
    <String>.items.relatedItems.warningCount 関連アイテムの処理時に発生した警告の数。

    データタイプ：数値
    <String>.items.relatedItems.warnings 関連アイテムの処理中に発生した警告の説明。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.warnings.error 関連アイテムの処理中に発生した警告のタイプ。

    データタイプ：文字列
    <String>.items.relatedItems.warnings.message 警告に関連付けられたメッセージ。

    データタイプ：文字列
    <String>.items.relatedSysIds 関連アイテムのルックアップベースの識別中に使用された CI のsys_id値のリスト。

    データタイプ：文字列
    <String>.items.sys_id 更新または作成された CI のSys_id。

    データタイプ：文字列
    <String>.relations 要求本文 relations アレイからの依存関係 CI の説明。

    データタイプ：オブジェクトのアレイ

    "relations": [ 
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "incompleteSysIds": "String",
    "inputIndices": [Array],
    "operation": "String",
    "partialSysIds": "String",
    "sysId": "String" 
  }
]
    <String>.relations.className この依存関係 CI のSys_class_name。

    サポートされている値:cmdb_rel_ci:CI 関係テーブルのみ。

    データタイプ：文字列
    <String>.relations.errorCount 依存関係 CI の処理時に発生したエラーの数。

    データタイプ：数値
    <String>.relations.errors この依存関係 CI の処理中に発生したエラーを説明するリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.relations.errors.error 依存関係 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    <String>.relations.errors.message この依存関係性 CI の処理中にエラーメッセージが発生しました。

    データタイプ：文字列
    <String>.relations.incompleteSysIds 関係にエラーがあり、不完全なペイロードとして保存された場合、この値は CMDB IRE 不完全なペイロード [cmdb_ire_incomplete_payloads] テーブル内のレコードのsys_idです。

    データタイプ：文字列
    <String>.relations.inputIndices この依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス。

    データタイプ：アレイ
    <String>.relations.operation 実行された操作のタイプ。

    可能な値：

    • 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 が更新されました。

    データタイプ：文字列
    <String>.relations.partialSysIds 関係にエラーがあり、部分的ペイロードとして保存された場合、この値は CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブル内のレコードのsys_idです。

    データタイプ：文字列
    <String>.relations.sysId 依存関係 CI のSys_id。

    データタイプ：文字列
    <String>.summary クラスごとに挿入されたアイテム数、更新されたアイテム数などの統計情報を提供する JSON プロパティのリスト。

    データタイプ：アレイ
    <String>.summary.<class_name> 特定のクラスの統計情報。

    データタイプ: オブジェクト

    <class_name>: {
 "additionalInsertedItemCount": Number, 
 "errorCount": Number,
 "incompleteItemCount": Number,
 "insertedItemCount": Number,
 "partialItemCount": Number,
 "skippedItemCount": Number,
 "unchangedItemCount": Number,
 "updatedItemCount": Number,
 "warningCount": Number 
}
    <String>.summary.<class_name>.additionalInsertedItemCount 部分的ペイロードの処理のために挿入されたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.errorCount アイテムの処理時に発生したエラーの数。

    データタイプ：数値
    <String>.summary.<class_name>.incompleteItemCount CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.insertedItemCount 作成されたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.partialItemCount 部分的ペイロードテーブル [cmdb_ire_partial_payloads] に保存されているアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.skippedItemCount スキップされたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.unchangedItemCount エントリはあったが変更されていないアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.updatedItemCount 更新されたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.warningCount 処理時に警告を生成したアイテムの数。

    データタイプ：数値

    依存 CI を識別します。

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

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

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

  "internal_id": "tomcat_id"
  }],

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

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

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

    出力:

    {

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

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

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

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

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

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

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

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

    IdentificationEngineScriptableApi - identifyCI(文字列 jsonString)

    データベースで操作をコミットせずに、指定されたペイロードに対して実行する操作 (挿入/更新) を決定します。

    注:
    識別ルールがそのように構成されている場合、このメソッドは非 CMDB テーブルも取り込むことができます。非 CMDB テーブルの取り込みの詳細については、「 IRE support for non-CMDB tables」を参照してください。

    これは createOrUpdateCI()と同じように機能しますが、結果はコミットされません。

    表 : 5. パラメーター
    名前 タイプ 説明
    jsonString 文字列 追加または更新する構成アイテムの JSON 形式の文字列。各入力文字列の形式は「items: [{}], relations:[{}]」です。ここで、items および relations リスト内の各アイテムには名前と値のペアが含まれます。
    アイテムリスト内で可能な名前と値のペアは次のとおりです。
    • className:作成または更新する CI の Sys_class_name。
    • lookup:[{}]:アイテムリストのような名前と値のペアを持つ各アイテムを含むレコードリスト。
    • values:{}:名前と値のペアとしての CI のフィールド情報。名前はフィールド名です。
    関係リスト内で使用可能な名前と値のペアは次のとおりです。
    • child:依存関係にある子アイテムのインデックス
    • parent:依存関係内の親アイテムのインデックス
    • type:関係性タイプ。これは、cmdb_rel_type テーブルの名前フィールド値の 1 つです。
    表 : 6. 返される内容
    タイプ 説明
    文字列 結果のリストである 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。
    関係リスト内で使用可能な名前と値のペアは次のとおりです。
    • className:関係 CI のクラス名であり、常にcmdb_rel_ciです
    • operation:操作のタイプ:INSERT、UPDATE、NO_CHANGE
    • sysId:CI が挿入または更新された関係のSys_id

    ルックアップベースの識別で独立 CI を識別します。

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

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

    出力:

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

    スコープ対応

    スコープ対象のアプリケーションで identifyCI(String jsonString) メソッドを使用するには、対応するスコープ対象の IdentificationEngine メソッドである identifyCI(String jsonString) を使用します。

    IdentificationEngineScriptableApi - identifyCIEnhanced(文字列ソース、文字列入力、オブジェクトオプション)

    データベース内の操作をコミットせずに、指定されたペイロード (要求本文) で実行する 構成管理データベース (CMDB) 操作 (挿入/更新) を決定します。

    注:
    識別ルールがそのように構成されている場合、このメソッドは非 CMDB テーブルも取り込むことができます。非 CMDB テーブルの取り込みの詳細については、「 IRE support for non-CMDB tables」を参照してください。

    この方法を使用して、ペイロードの送信をシミュレートします。

    このメソッドは IdentificationEngineScriptableApi - identifyCI(文字列 jsonString) メソッドと似ていますが、次の機能もサポートしています。
    • 部分的ペイロード
      • アイテムに警告またはエラーがある場合は、アイテム操作がINSERT_AS_PARTIALかINSERT_INCOMPLETEかを示します。
      • 既存の部分的ペイロードと結合された部分的ペイロードのsys_idsを返します。
    • ペイロードの重複排除機能をサポートします。
    • サマリーを生成します。
    表 : 7. パラメーター
    名前 タイプ 説明
    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:ルールを実行します。

    デフォルト値：false
    input.items.settings.updateWithoutDowngrade ブーリアン このアイテムに対して更新とダウングレードの両方が許可されているかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、ダウングレードは許可されていません。
    • false:アイテムの更新とダウングレードの両方が許可されています。

    デフォルト値：false
    input.items.settings.updateWithoutSwitch ブーリアン アイテムを更新できるかどうか、およびクラスを切り替えることができるかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、クラスの切り替えは許可されません。
    • false:アイテムの更新とクラスの切り替えの両方が許可されます。

    デフォルト値：false
    input.items.settings.updateWithoutUpgrade ブーリアン このアイテムに対して更新とアップグレードの両方が許可されているかどうかを示すフラグ。
    有効な値：
    • true:アイテムを更新しますが、アップグレードは許可されていません。
    • false:アイテムの更新とアップグレードの両方が許可されています。

    デフォルト値：false
    input.items.sys_オブジェクト_ソース_情報 オブジェクト 特定のソースの一意の 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"
  }
]
    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:重複するアイテムをエラーと見なします。

    デフォルト：true
    options.generate_summary ブーリアン 返された結果にサマリー情報が含まれているかどうかを示すフラグ。返されるサマリー情報の詳細については、返される結果テーブルの <String>.summary を参照してください。

    有効な値：

    • true:サマリー情報を含めます。
    • false:サマリー情報を含めません。

    デフォルト値：false
    options.partial_commits ブーリアン 部分コミットのサポートが有効かどうかを示すフラグ。部分コミットの詳細については、「 拡張 IRE 機能」を参照してください。

    有効な値：

    • true:部分的なコミットが有効です。
    • false:部分的なコミットが無効です。

    デフォルト：true
    options.partial_payloads ブーリアン 部分的ペイロードサポートが有効かどうかを示すフラグ。部分的ペイロードの詳細については、「 拡張 IRE 機能 」および「 IRE データソースルールの作成」を参照してください。

    有効な値：

    • true:部分的ペイロードが有効です。
    • false:部分的ペイロードが無効です。

    デフォルト：true
    options.skip_updating_last_scan_to_now ブーリアン sys_object_sourceのlast_scan時間フィールドの更新をスキップするかどうかを示すフラグ。
    有効な値：
    • true: source_recency_timestamp パラメーターが渡されない場合は sys_object_source_infosys_object_sourceのlast_scan時間フィールドを更新しません。
    • false:sys_object_sourceのlast_scan時間フィールドを更新します。

    デフォルト:glide.identification_engine.skip_updating_last_scan_to_now システムプロパティの値を使用します。
    options.skip_updating_source_last_discovered_to_now ブーリアン 構成アイテム [cmdb_ci] テーブルのdiscovery_sourceフィールドとlast_discoveredフィールドの更新をスキップするかどうかを示すフラグ。
    有効な値：
    • true:ペイロードアイテム値にlast_discoveredが指定されていない場合は、[discovery_source] フィールドと [last_discovered] フィールドを更新しないでください。
    • false:discovery_sourceフィールドとlast_discoveredフィールドを更新します。

    デフォルト:glide.identification_engine.skip_updating_source_last_discovered_to_now システムプロパティの値を使用します。
    ソース 文字列 CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの [discovery_source] フィールドに定義されている選択値のいずれかである必要があります。
    表 : 8. 返される内容
    タイプ 説明
    <文字列> 入力文字列内の構成アイテムの結果リストである JSON 形式の文字列。

    データタイプ：文字列

    { 
  "additionalCommittedItems": [Array],  
  "additionalCommittedRelations": [Array], 
  "hasError": Boolean, 
  "hasWarning": Boolean,
  "items": [Array],  
  "relations": [Array], 
  "summary": {Object} 
}
    <String>.additionalCommittedItems 現在のペイロードの IRE 処理中にコミットされたが、現在の入力ペイロードには存在しなかった CI のリスト。

    データタイプ：オブジェクトのアレイ

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "operation": "String",
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "sysId": "String"
  }
]
    <String>.additionalCommittedRelations 挿入または更新する要求本文 relations リストに含まれていなかった依存関係性 CI の説明。

    データタイプ：オブジェクトのアレイ

    "additionalCommittedRelations": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String"
  }
]
    <String>.hasError アイテムまたは関係にエラーがあるかどうかを示すフラグ。

    データタイプ：ブーリアン
    <String>.hasWarning アイテムまたは関係に警告があるかどうかを示すフラグ。

    データタイプ：ブーリアン
    <String>.items 作成または更新された CI の説明。

    データタイプ：オブジェクトのアレイ

    "items": [ 
  {  
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateIndices": [Array],
    "errorCount": Number, 
    "errors": [Array], 
    "identificationAttempts": [Array], 
    "identifierEntrySysId": "String",
    "info": [Array], 
    "inputIndices": [Array], 
    "maskedAttributes": [Array],
    "operation": "String",
    "relatedSysIds": [Array], 
    "sysId": "String" 
  }
]
    <String>.items.additionalRelatedItems 処理されたものの、入力ペイロードの一部として提供されなかった追加のルックアップおよび関連アイテムに関する情報。これらのアイテムは部分的ペイロードからのものです。

    データタイプ：オブジェクトのアレイ

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array],
    "mergedPayloadIds": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.additionalRelatedItems.className 作成または更新された CI のクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.additionalRelatedItems.inputIndices この関連アイテムに対応する要求本文 items アレイの CI のインデックス値。

    データタイプ:数値の配列
    <String>.items.additionalRelatedItems.mergedPayloadIds 関連アイテムに結合された部分的ペイロードのsys_idsのリスト。

    データタイプ：アレイ

    テーブル:CMDB IRE 部分のペイロード [cmdb_ire_partial_payloads]
    <String>.items.additionalRelatedItems.operation 操作のタイプ

    可能な値：

    • INSERT:新しい CI がデータベースに挿入されました。
    • NO_CHANGE:CI の変更は行われませんでした。
    • 更新:既存の CI が更新されました。

    データタイプ：文字列
    <String>.items.additionalRelatedItems.sysId 更新または作成された CI のSys_id。

    データタイプ：文字列
    <String>.items.className 作成または更新された CI のクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.duplicateIndices 現在のアイテムと重複している CI のインデックスのリスト。

    データタイプ：アレイ
    <String>.items.errorCount アイテムの処理中に発生したエラーの数。

    データタイプ：数値
    <String>.items.errors この CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.errors.error CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    <String>.items.errors.message CI の処理中にエラーメッセージが表示されました。

    データタイプ：文字列
    <String>.items.identificationAttempts CI を識別するために行われた試行のリスト。

    データタイプ：オブジェクトのアレイ

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <String>.items.identificationAttempts.attemptResult CI の識別を試みた結果。

    可能な値：

    • 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。
    • MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。
    • NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。
    • スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。

    データタイプ：文字列
    <String>.items.identificationAttempts.attributes 識別プロセス中に使用された CI ID エントリ属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような要求本文データと使用中の識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.items.identificationAttempts.identifierName この CI 識別試行に使用される識別子ルール。

    データタイプ：文字列
    <String>.items.identificationAttempts.searchOnTable 識別プロセス中に検索されたテーブルの名前。

    データタイプ：文字列
    <String>.items.identifierEntrySysId CI を識別するために使用される識別子ルールのSys_id。

    データタイプ：文字列

    テーブル:識別子エントリ [cmdb_identifier_entry]
    <String>.items.info アイテムの処理に関する追加情報。

    データタイプ：オブジェクトのアレイ

    "info": [
 {
   "code": "String",
   "message": "String",
   "ruleSysId": "String"
 }
]
    <String>.items.info.code スキップされた再分類タイプ。
    可能な値：
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    データタイプ：文字列
    <String>.items.info.message 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。

    データタイプ：文字列
    <String>.items.info.ruleSysId 一致した再分類制限ルールのSys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグが原因で再分類がスキップされた場合、この値は空です。

    データタイプ：文字列
    <String>.items.inputIndices 対応する入力 CI のインデックス。トップレベルのアイテムの場合は、整数のリストです。関連 CI またはルックアップ CI の場合は、JSON オブジェクトのリストです。

    データタイプ:数値の配列
    <String>.items.maskedAttributes 調整 ルールで定義されているとおりに、権限のないデータソースによる更新がスキップされた属性のリスト。

    データタイプ：アレイ
    <String>.items.operation 実行された操作。

    可能な値：

    • INSERT:新しい CI がデータベースに挿入されました。
    • INSERT_AS_INCOMPLETE:アイテムはcmdb_ire_incomplete_payloadsテーブルに保存されました。
    • INSERT_AS_PARTIAL:アイテムはcmdb_ire_partial_payloadsテーブルに保存されました。
    • 更新:既存の CI が更新されました。
    • UPDATE_WITH_DOWNGRADE:CI が更新され、クラスがより汎用的なクラス (先祖クラス) に変更されました。
    • UPDATE_WITH_SWITCH:CI が更新され、クラスが先祖でも子孫でもないクラスに変更されました。
    • UPDATE_WITH_UPDRADE:CI が更新され、クラスがより特殊なクラス (子孫クラス) に変更されました。

    データタイプ：文字列
    <String>.items.relatedItems 処理された関連アイテムに関する情報。

    データタイプ：オブジェクトのアレイ

    "relatedItems": [
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "mergePayloadIds": [Array],
    "operation": "String",
    "sysId": "String",
    "warningCount": Number,
    "warnings": [Array]
  }
]
    <String>.items.relatedItems.className 関連アイテムのクラス/テーブル名 (sys_class_name)。

    データタイプ：文字列
    <String>.items.relatedItems.errorCount 関連アイテムの処理中に検出されたエラーの数。

    データタイプ：数値
    <String>.items.relatedItems.errors 関連アイテムの処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.errors.error 関連アイテムの処理中に発生したエラーのタイプ。

    データタイプ：文字列
    <String>.items.relatedItems.errors.message 関連アイテムの処理中にエラーメッセージが表示されました。

    データタイプ：文字列
    <String>.items.relatedItems.inputIndices 対応する入力アイテムのインデックス。トップレベルのアイテムの場合は、整数のリストです。関連アイテムまたはルックアップアイテムの場合は、JSON オブジェクトのリストです。

    データタイプ:数値のアレイまたはオブジェクトのアレイ

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.relatedItems.inputIndices.mainIndex 関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。

    データタイプ：数値
    <String>.items.relatedItems.inputIndices.subIndex 関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。

    データタイプ：数値
    <String>.items.relatedItems.mergedPayloadIds 処理中に CI に結合された部分的ペイロードのsys_idsのリスト。

    データタイプ：アレイ
    <String>.items.relatedItems.operation 実行された操作。

    可能な値：

    • 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 が更新され、クラスがより特殊化されたクラス (子孫クラス) に変更されました。

    データタイプ：文字列
    <String>.items.relatedItems.sysId 関連アイテムのSys_id。

    データタイプ：文字列
    <String>.items.relatedItems.warningCount 関連アイテムの処理時に発生した警告の数。

    データタイプ：数値
    <String>.items.relatedItems.warnings 関連アイテムの処理中に発生した警告の説明。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedSysIds 関連アイテムのルックアップベースの識別中に使用された CI のsys_id値のリスト。

    データタイプ：文字列
    <String>.items.sys_id 更新または作成された CI のSys_id。

    データタイプ：文字列
    <String>.relations 処理された関係に関する情報。

    データタイプ：オブジェクトのアレイ

    "relations": [ 
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String" 
  }
]
    <String>.relations.className この依存関係 CI のSys_class_name。

    サポートされている値:cmdb_rel_ci:CI 関係テーブルのみ。

    データタイプ：文字列
    <String>.relations.errorCount 依存関係 CI の処理時に発生したエラーの数。

    データタイプ：数値
    <String>.relations.errors この依存関係 CI の処理中に発生したエラーを説明するリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.relations.inputIndices この依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス。

    データタイプ：アレイ
    <String>.relations.operation 実行された操作のタイプ。

    可能な値：

    • 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 が更新されました。

    データタイプ：文字列
    <String>.relations.sysId 依存関係 CI のSys_id。

    データタイプ：文字列
    <String>.summary クラスごとに挿入されたアイテム数、更新されたアイテム数などの統計情報を提供する JSON プロパティのリスト。

    データタイプ：アレイ
    <String>.summary.<class_name> 特定のクラスの統計情報。

    データタイプ: オブジェクト

    <class_name>: {
 "additionalInsertedItemCount": Number, 
 "errorCount": Number,
 "incompleteItemCount": Number,
 "insertedItemCount": Number,
 "partialItemCount": Number,
 "skippedItemCount": Number,
 "unchangedItemCount": Number,
 "updatedItemCount": Number,
 "warningCount": Number 
}
    <String>.summary.<class_name>.additionalInsertedItemCount 部分的ペイロードの処理のために挿入されたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.errorCount アイテムの処理時に発生したエラーの数。

    データタイプ：数値
    <String>.summary.<class_name>.incompleteItemCount CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.insertedItemCount 作成されたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.partialItemCount 部分的ペイロードテーブル [cmdb_ire_partial_payloads] に保存されているアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.skippedItemCount スキップされたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.unchangedItemCount エントリはあったが変更されていないアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.updatedItemCount 更新されたアイテムの数。

    データタイプ：数値
    <String>.summary.<class_name>.warningCount 処理時に警告を生成したアイテムの数。

    データタイプ：数値

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

    出力:

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

    IdentificationEngineScriptableApi - runIdentificationAudit(GlideRecord now_GR)

    指定された構成アイテム (CI) に対して識別監査を実行し、重複を検出します。

    重複が見つかった場合は、重複タスクが作成されます。この方法は、独立した識別ルールを持つ CI タイプでのみ使用してください。

    表 : 9. パラメーター
    名前 タイプ 説明
    now_GR GlideRecord 重複を検出するために監査を実行する CI。CI には独立した識別ルールが必要です。
    表 : 10. 返される内容
    タイプ 説明
    なし

    次の例は、サーバーで重複タスクをチェックし、重複修復タスクが存在する場合は作成する方法を示しています。

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

    スコープ対応

    スコープ対象のアプリケーションで runIdentificationAudit(GlideRecord now_GR) メソッドを使用するには、対応するスコープ対象の IdentificationEngine メソッドである runIdentificationAudit(GlideRecord now_GR) を使用します。