---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Descobertas - com escopo, global

# Descobertas - com escopo, global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A API de descobertas fornece métodos para lidar com como uma verificação Instance Scan produz descobertas.

Esta API está incluída com o plug-in Instance Scan (com.glide.instance_scan) e é executada no namespace `sn_instance_scan`. Para obter mais informações, consulte [Verificação de instância](https://www.servicenow.com/docs/access?context=hs-landing-page&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

Na Verificação de instância, as verificações são executadas em cada registro no escopo de uma verificação na instância para gerar descobertas. Cada descoberta contém informações sobre um registro de problema e qual verificação foi violada. Os métodos dedescoberta são usados em Instance Scan verificações como parte do objeto de mecanismo passado para o usuário. Adicione o código ao campo Script no formulário de verificação.  
Consulte também:

* [Introdução às verificações](https://www.servicenow.com/docs/access?context=hs-intro-health-check&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)
* [Descobertas](https://www.servicenow.com/docs/access?context=hs-findings&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)
{#FindingsAPI__ul_hlw_q5y_spb}

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

Aumenta a contagem da descoberta atual.
A contagem de descobertas começa em zero para cada registro que uma verificação analisa em uma verificação. Quando chamado, este método incrementa a contagem de descobertas. A contagem indica que uma descoberta deve ser gerada para o registro atual.

Este método pode ser chamado várias vezes para indicar que esta descoberta tem várias ocorrências de uma violação de verificação no registro atual.
{#Findings-increment__table_ckd_hxt_4pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 2. Retorna]

{#Findings-increment__table_dkd_hxt_4pb}  
O exemplo a seguir mostra como contar o número de registros com um estado de falha em uma verificação de tipo de tabela. Para obter mais informações, consulte [Criar uma verificação de tipo de tabela](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);

## Descobertas - incrementWithNode(Object node) {#ariaid-title3}

Se a descoberta atual for de uma verificação de linter, este método incrementará a contagem de descobertas atual e passará simultaneamente o objeto de nó de linter para a descoberta.
Use este método no campo Script no [formulário Verificação de Linter](https://www.servicenow.com/docs/access?context=hc-linter-check&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Este método salva informações sobre o nó fornecido, como um número de linha na coluna de detalhes de uma descoberta atual.  
Consulte também:

* [Scripts de verificação avançada de linter](https://www.servicenow.com/docs/access?context=hs-linter-check-scripts&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)
* [API LinterCheckAstNode](https://servicenow-prod.fluidtopics.net/aFGeTq64iz15pG1Up4G3Zg#LinterCheckAstNodeAPIBoth "A API LinterCheckAstNode fornece métodos para obter detalhes do nó da árvore de sintaxe abstrata (AST) em verificações de linter.")
{#Findings-incrementWithNode_O__ul_nxz_f5y_spb}
{#Findings-incrementWithNode_O__table_ckd_hxt_4pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| node | Objeto | Objeto de nó da verificação de linter. |
[Tabela 3. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 4. Retorna]

{#Findings-incrementWithNode_O__table_dkd_hxt_4pb}  
O exemplo a seguir mostra como incrementar nós de tipo linter em uma verificação de linter. Para obter informações sobre como usar métodos de verificação de linter, consulte [API LinterCheckAstNode](https://servicenow-prod.fluidtopics.net/aFGeTq64iz15pG1Up4G3Zg#LinterCheckAstNodeAPIBoth "A API LinterCheckAstNode fornece métodos para obter detalhes do nó da árvore de sintaxe abstrata (AST) em verificações de linter.").

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

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

Define a origem da descoberta atual com base no GlideRecord fornecido.
Use este método no campo Script de uma verificação Somente script. Este método não é usado para outras verificações porque elas definem automaticamente a origem como o registro atual durante a verificação. Para obter mais informações, consulte [Criar uma verificação somente de script](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}

| Nome | Tipo | Descrição |
|-|-|-|
| origem | GlideRecord | O registro a ser definido como o registro de origem para a descoberta atual. Este valor é adicionado como uma referência no campo Origem da tabela Descobertas de verificação \[scan_finding\]. |
[Tabela 5. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 6. Retorna]

{#Findings-setCurrentSource_O__table_dkd_hxt_4pb}  
O exemplo a seguir mostra como definir a origem atual para um registro de incidente em uma verificação somente de script. Para obter mais informações, consulte [Criar uma verificação somente de script](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);