Résultats : Champ d’application, Global

L’API Résultats fournit des méthodes pour gérer la façon dont une vérification produit des Instance Scan résultats.

Cette API est incluse dans le module d’extension Instance Scan (com.glide.instance_scan) et s’exécute dans l’espace de noms sn_instance_scan . Pour plus d’informations, consultez Analyse d’instance.

Dans Instance Scan, les vérifications s’exécutent sur chaque enregistrement dans le périmètre d’une analyse sur l’instance pour générer des conclusions. Chaque résultat contient des informations sur un enregistrement de problème et sur la vérification qu’il a violée. Les méthodes de résultats sont utilisées dans les Instance Scan vérifications dans le cadre de l’objet moteur transmis à l’utilisateur. Ajoutez le code au champ Script dans le formulaire de vérification.

Voir aussi :

• Introduction aux vérifications
• Résultats

Résultats : increment()

Augmente le nombre du résultat actuel.

Le nombre de résultats commence à zéro pour chaque enregistrement qu’une vérification analyse dans une analyse. Lorsqu’elle est appelée, cette méthode augmente le nombre de résultats. Le nombre indique qu’un résultat doit être généré pour l’enregistrement actuel.

Cette méthode peut être appelée plusieurs fois pour signifier que ce résultat comporte plusieurs occurrences d’une violation de vérification dans l’enregistrement actuel.

Tableau 1. Paramètres

Nom	Type	Description
Aucun

Tableau 2. Renvoie

Type	Description
Aucun

L’exemple suivant montre comment compter le nombre d’enregistrements avec un état d’échec dans une vérification de type table. Pour plus d’informations, voir Créer une vérification du type de table.

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

Résultats : incrementWithNode(nœud d’objet)

Si le résultat actuel provient d’une vérification de linter, cette méthode augmente le nombre de résultats actuels et transmet simultanément l’objet de nœud Linter au résultat.

Utilisez cette méthode dans le champ Script du formulaire de vérification Linter. Cette méthode enregistre des informations sur le nœud donné, telles qu’un numéro de ligne dans la colonne des détails d’un résultat actuel.

Voir aussi :

• Scripts de vérification de linter avancés
• LinterCheckAstNode API

Tableau 3. Paramètres

Nom	Type	Description
nœud	Objet	Objet de nœud de la vérification linter.

Tableau 4. Renvoie

Type	Description
Aucun

L’exemple suivant montre comment incrémenter les nœuds de type linter dans un contrôle linter. Pour plus d’informations sur l’utilisation des méthodes de vérification Linter, consultez 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);

Résultats : setCurrentSource(source GlideRecord)

Définit la source du résultat actuel en fonction du GlideRecord fourni.

Utilisez cette méthode dans le champ Script d’une vérification Script uniquement. Cette méthode n’est pas utilisée pour d’autres vérifications, car elles définissent automatiquement la source comme enregistrement actuel pendant l’analyse. Pour plus d’informations, consultez la section Vérification de la création d’un script uniquement.

Tableau 5. Paramètres

Nom	Type	Description
source	GlideRecord	Enregistrement à définir comme enregistrement source du résultat actuel. Cette valeur est ajoutée comme référence dans le champ Source de la table Conclusions de l’analyse [scan_finding].

Tableau 6. Renvoie

Type	Description
Aucun

L’exemple suivant montre comment définir la source actuelle sur un enregistrement d’incident dans une vérification de script uniquement. Pour plus d’informations, consultez la section Vérification de la création d’un script uniquement.

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