結果:スコープ、グローバル

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

    • 検索結果 API は、インスタンススキャンチェックによる検索結果の生成方法を処理するためのメソッドを提供します。

    この API は インスタンススキャン (com.glide.instance_scan) プラグインに含まれており、 sn_instance_scan 名前空間で実行されます。詳細については、「 インスタンススキャン」を参照してください。

    インスタンススキャンでは、インスタンスのスキャンのスコープ内の各レコードに対してチェックが実行され、検出結果が生成されます。各検出結果には、問題レコードに関する情報と、問題レコードが違反したチェックに関する情報が保持されます。Findings メソッドは、ユーザーに渡されるエンジンオブジェクトの一部として インスタンススキャン チェックで使用されます。チェックフォームの [スクリプト ] フィールドにコードを追加します。

    関連項目：

    結果:increment()

    現在の検出結果の数を増やします。

    スキャンでチェックが分析する各レコードについて、結果数はゼロから始まります。このメソッドが呼び出されると、結果数が増加します。カウントは、現在のレコードに対して検出結果が生成されることを示します。

    このメソッドを複数回呼び出して、この検出結果に現在のレコード内でチェック違反が複数回発生していることを示すことができます。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし
    表 : 2. 返される内容
    タイプ 説明
    なし

    次の例は、テーブルタイプチェックで失敗ステータスのレコードの数をカウントする方法を示しています。詳細については、「 テーブルタイプチェックの作成」を参照してください。

    (function(engine) {
  if (current.getValue("state") == "failed") {
    engine.finding.increment();
  }
})(engine);

    結果:incrementWithNode(オブジェクトノード)

    現在の検出結果がリンターチェックからのものである場合、このメソッドは現在の検出数をインクリメントし、同時にリンターノードオブジェクトを検出結果に渡します。

    リン ターチェックフォームの [スクリプト] フィールドでこのメソッドを使用します。この方法では、現在の検出結果の詳細列の行番号など、指定されたノードに関する情報が保存されます。

    関連項目：
    表 : 3. パラメーター
    名前 タイプ 説明
    node オブジェクト リンターチェックからのノードオブジェクト。
    表 : 4. 返される内容
    タイプ 説明
    なし

    次の例は、リンターチェックでリンタータイプのノードをインクリメントする方法を示しています。リンター チェック メソッドの使用については、「 LinterCheckAstNode API」を参照してください。

    (function(engine) {
  engine.rootNode.visit(function(node) {
    if (node.getTypeName() === "NAME" &&
        node.getNameIdentifier() === "soughtFunction" &&
        node.getParent().getTypeName() === "CALL") {
      engine.finding.incrementWithNode(node);
    } 
  });
})(engine);

    結果:setCurrentSource(GlideRecord ソース)

    指定された GlideRecord に基づいて現在の検出結果のソースを設定します。

    このメソッドは、[スクリプトのみ] チェックの [スクリプト ] フィールドで使用します。このメソッドは、スキャン中にソースが現在のレコードとして自動的に設定されるため、他のチェックには使用されません。詳細については、「 スクリプトのみのチェックを作成する」を参照してください。

    表 : 5. パラメーター
    名前 タイプ 説明
    source GlideRecord 現在の検出結果のソースレコードとして設定するレコード。この値は、スキャン結果 [scan_finding] テーブルの [ソース] フィールドに参照として追加されます。
    表 : 6. 返される内容
    タイプ 説明
    なし

    次の例は、スクリプトのみのチェックで現在のソースをインシデントレコードに設定する方法を示しています。詳細については、「 スクリプトのみのチェックを作成する」を参照してください。

    (function(engine) {
  var gr = new GlideRecord('incident');
  gr.get('2f99f330730210100a5310c92bf6a798');
  engine.finding.setCurrentSource(gr);
  engine.finding.increment();
})(engine);