Descobertas - Com escopo, Global

. Descobertas A API fornece métodos para lidar com como um Instance Scan a verificação produz descobertas.

Esta API está incluída com Instance Scan(com.glide.instance_scan) plug-in e é executado no sn_instance_scan namespace. Para obter mais informações, consulte Verificação de instância .

Em 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. Descobertas os métodos são usados em Instance Scan verificações como parte do objeto do mecanismo passado para o usuário. Adicione o código ao Script campo no formulário de verificação.

Consulte também:

• Introdução às verificações
• Descobertas

Descobertas - increment()

Aumenta a contagem da descoberta atual.

A contagem da descoberta 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 significar que esta descoberta tem várias ocorrências de uma violação de verificação no registro atual.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 2. Retorna

Tipo	Descrição
Nenhum(a)

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 Crie uma verificação de tipo de tabela .

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

Descobertas - incrementWithNode(nó de objeto)

Se a descoberta atual for de uma verificação de linter, este método incrementa a contagem de descoberta atual e passa simultaneamente o objeto de nó linter para a descoberta.

Use este método no campo Script em Formulário Verificação de linter . 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 de linter avançados
• API LinterCheckAstNode

Tabela 3. Parâmetros

Nome	Tipo	Descrição
node	Objeto	Objeto de nó da verificação de linter.

Tabela 4. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como incrementar nós do 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 .

(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(origem GlideRecord)

Define a origem da descoberta atual com base no GlideRecord fornecido.

Use este método no Script Campo de uma verificação Somente script. Este método não é usado para outras verificações porque eles 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 .

Tabela 5. Parâmetros

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

Tabela 6. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir a origem atual como um registro de incidente em uma verificação somente de script. Para obter mais informações, consulte Criar uma verificação somente de script .

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