Résultats - Champ d’application, Global

L’API Résultats fournit des méthodes pour gérer la façon dont une Instance Scan vérification produit des 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 sont exécutées sur chaque enregistrement dans le champ d’application d’une analyse sur l’instance pour générer des résultats. Chaque résultat contient des informations sur un enregistrement de problème et sur le contrôle qui a fait l’objet d’une violation. Les méthodes de résultats sont utilisées dans Instance Scan les vérifications dans le cadre de l’objet moteur transmis à l’utilisateur. Ajoutez le code au champ Script du formulaire de vérification.

Voir aussi :

• Mise en route des chèques
• Conclusions

Résultats : increment()

Augmente le nombre de résultats actuels.

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 incrémente 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 contrôle 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 de table. Pour plus d’informations, reportez-vous à la rubrique Création d’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 incrémente le nombre de résultats actuels et transmet simultanément l’objet nœud linter au résultat.

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

Voir aussi :

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

Tableau 3. Paramètres

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

Tableau 4. Renvoie

Type	Description
Aucun

L’exemple suivant montre comment incrémenter des noeuds de type linter dans une vérification linter. Pour plus d’informations sur l’utilisation des méthodes de vérification LinterCheckAstNode, 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 de 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 lors de l’analyse. Pour plus d’informations, reportez-vous à la section Créer une vérification de script uniquement.

Tableau 5. Paramètres

Nom	Type	Description
source	GlideRecord	Enregistrement à définir en tant qu’enregistrement source pour le 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, reportez-vous à la section Créer une vérification de script uniquement.

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