ReportCiStatusOutputJS - スコープ指定

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

    • ReportCiStatusOutputJS API には、DiscoveryAPI の reportCiIpAddressStatus メソッドの特定のオブジェクトプロパティを返し、その情報を JSON 文字列に変換するメソッドが用意されています。

    このクラスの実行は、 sn_discovery 名前空間にあります。

    ReportCiStatusOutputJS - getCiOperationStatus()

    スキャンされた CI のステータスを返します。

    これは、discovery_device_historyテーブルの [last_state] フィールドと [discovery_status] テーブルの [ステータス] フィールドに基づいて計算されたフィールドです。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし
    表 : 2. 返される内容
    タイプ 説明
    文字列 このメソッドによって返される 3 つの可能なステータスは次のとおりです。
    • 処理中:ディスカバリーはまだ要求を処理中です。
    • 成功:CI が作成または更新されました。
    • NotSuccessful:CI は作成または更新されておらず、ディスカバリーステータスは [完了] または [キャンセル] でした。
    		 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
gs.info("ipResultObj(CiOperationStatus): " + ipResultObj.getCiOperationStatus());

    ReportCiStatusOutputJS - getCmdbCI()

    スキャンされている CI のdiscovery_device_historyテーブルから [cmdb_ci] フィールドの値を返します。

    表 : 3. パラメーター
    名前 タイプ 説明
    なし
    表 : 4. 返される内容
    タイプ 説明
    文字列 作成または更新された CI のSys_id。CI が作成される前の中間結果の場合は、この値が null になることがあります。 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
gs.info("ipResultObj(cmdb): " + ipResultObj.getCmdbCI());

    ReportCiStatusOutputJS - getDiscoveryState()

    ディスカバリーステータス [discovery_status] テーブルの [ ステータス ] フィールドの値を返します。

    このメソッドによって返された値は、 getCiOperationStatus() メソッドによって返された値を計算するために使用されます

    表 : 5. パラメーター
    名前 タイプ 説明
    なし
    表 : 6. 返される内容
    タイプ 説明
    文字列 このメソッドによって返される可能なステータスは次のとおりです。
    • 開始中
    • 有効
    • 完了
    • キャンセル
    		 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
gs.info("ipResultObj(discoveryState): " + ipResultObj.getDiscoveryState());

    ReportCiStatusOutputJS - getIpAddress()

    スキャンされている CI のdiscovery_device_historyテーブルのソースフィールドから値を返します。

    表 : 7. パラメーター
    名前 タイプ 説明
    なし
    表 : 8. 返される内容
    タイプ 説明
    文字列 スキャンされる CI の IP アドレス。 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
gs.info("ipResultObj(IpAddress): " + ipResultObj.getIpAddress());

    ReportCiStatusOutputJS - getIssues()

    スキャンされている CI のdiscovery_device_historyテーブルの問題フィールドの値を返します。

    表 : 9. パラメーター
    名前 タイプ 説明
    なし
    表 : 10. 返される内容
    タイプ 説明
    整数 この CI のこのディスカバリーの問題の数。 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
gs.info("ipResultObj(issues): " + ipResultObj.getIssues());

    ReportCiStatusOutputJS:toJson()

    ReportCiStatusOutputJSオブジェクトをシリアル化します。

    このメソッドは、メソッドがオブジェクトをシリアル化できない場合、 IllegalArgumentException 例外「 オブジェクトをシリアル化できません 」をスローします。e は例外オブジェクトで、例外メッセージとトレースを提供します。

    表 : 13. パラメーター
    名前 タイプ 説明
    なし
    表 : 14. 返される内容
    タイプ 説明
    文字列 ReportCiStatusOutputJS オブジェクトのインスタンスを JSON 文字列にシリアル化します。 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);
gs.info("ipResultObj(json): " + ipResultObj.toJson());