---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 検索結果 - スコープ対象、グローバル

# 検索結果 - スコープ対象、グローバル {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

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

この API は インスタンススキャン (com.glide.instance_scan) プラグインに含まれており、 `sn_instance_scan` 名前空間で実行されます。詳細については、「 [Instance Scan」](https://www.servicenow.com/docs/access?context=hs-landing-page&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)を参照してください。

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

* [チェックの概要](https://www.servicenow.com/docs/access?context=hs-intro-health-check&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)
* [結果](https://www.servicenow.com/docs/access?context=hs-findings&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)
{#FindingsAPI__ul_hlw_q5y_spb}

## Findings - increment() {#ariaid-title2}

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

このメソッドを複数回呼び出すと、検出結果には現在のレコードの複数のチェック違反が含まれている旨を表すことができます。
{#Findings-increment__table_ckd_hxt_4pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#Findings-increment__table_ckd_hxt_4pb} {#Findings-increment__table_dkd_hxt_4pb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 2. 返される内容]

{#Findings-increment__table_dkd_hxt_4pb}  
次の例は、テーブルタイプチェックで失敗ステータスのレコードの数をカウントする方法を示しています。詳細については、「 [テーブルタイプチェックの作成](https://www.servicenow.com/docs/access?context=hs-create-table-health-check&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。

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

## Findings - incrementWithNode(オブジェクト node) {#ariaid-title3}

現在の検出結果がリンターチェックのものである場合、このメソッドは、現在の結果数をインクリメントし、同時にリンターノードオブジェクトを検出結果に渡します。
このメソッドは、 [リンターチェックフォーム](https://www.servicenow.com/docs/access?context=hc-linter-check&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)の \[スクリプト\] フィールドで使用します。このメソッドは、現在の検出結果の詳細列の行番号など、指定されたノードに関する情報を保存します。  
関連項目：

* [詳細リンターチェックスクリプト](https://www.servicenow.com/docs/access?context=hs-linter-check-scripts&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)
* [LinterCheckAstNode API](https://servicenow-prod.fluidtopics.net/h5OoaLfIDER1mdkkTwTdKQ#LinterCheckAstNodeAPIBoth "LinterCheckAstNode API は、リンターチェックで抽象構文ツリー (AST) ノードの詳細を取得するためのメソッドを提供します。")
{#Findings-incrementWithNode_O__ul_nxz_f5y_spb}
{#Findings-incrementWithNode_O__table_ckd_hxt_4pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| node | オブジェクト | リンターチェックのノードオブジェクトです。 |
[表 : 3. パラメーター]

{#Findings-incrementWithNode_O__table_ckd_hxt_4pb} {#Findings-incrementWithNode_O__table_dkd_hxt_4pb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 4. 返される内容]

{#Findings-incrementWithNode_O__table_dkd_hxt_4pb}  
次の例は、リンターチェックでリンタータイプのノードをインクリメントする方法を示しています。リンターチェックメソッドの使用方法については、「[LinterCheckAstNode API](https://servicenow-prod.fluidtopics.net/h5OoaLfIDER1mdkkTwTdKQ#LinterCheckAstNodeAPIBoth "LinterCheckAstNode API は、リンターチェックで抽象構文ツリー (AST) ノードの詳細を取得するためのメソッドを提供します。")」を参照してください。

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

## Findings - setCurrentSource(GlideRecord source) {#ariaid-title4}

指定された GlideRecord に基づいて現在の検出結果のソースを設定します。
このメソッドは、\[スクリプトのみ\] のチェックの \[スクリプト\] フィールドで使用します。このメソッドは他のチェックには使用されません。他のチェックではスキャン中にソースが現在のレコードとして自動的に設定されるためです。詳細については、「 [スクリプトのみのチェックの作成](https://www.servicenow.com/docs/access?context=hs-create-script-health-check&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。
{#Findings-setCurrentSource_O__table_ckd_hxt_4pb__entry__3}

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

{#Findings-setCurrentSource_O__table_ckd_hxt_4pb} {#Findings-setCurrentSource_O__table_dkd_hxt_4pb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 6. 返される内容]

{#Findings-setCurrentSource_O__table_dkd_hxt_4pb}  
次の例は、スクリプトのみのチェックで現在のソースをインシデントレコードに設定する方法を示しています。詳細については、「 [スクリプトのみのチェックの作成](https://www.servicenow.com/docs/access?context=hs-create-script-health-check&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。

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