Résultats : délimités, globaux
L’API Findings fournit des méthodes pour gérer la façon dont une Analyse d'instance vérification produit des résultats.
Cette API est incluse dans le module d’extension Analyse d'instance (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 résultats. Chaque résultat contient des informations sur un enregistrement de problème et sur la vérification qu’il n’a pas respectée. Les méthodes de résultats sont utilisées dans Analyse d'instance les vérifications dans le cadre de l’objet de moteur transmis à l’utilisateur. Ajoutez le code au champ Script du formulaire de vérification.
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 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 vérification dans l’enregistrement actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment compter le nombre d’enregistrements ayant échoué dans une vérification de type de table. Pour plus d’informations, consultez Créer une vérification de type de table.
(function(engine) {
if (current.getValue("state") == "failed") {
engine.finding.increment();
}
})(engine);Résultats : incrementWithNode(nœud Objet)
Si le résultat actuel provient d’un contrôle de linter, cette méthode augmente le nombre de résultats actuels et transmet simultanément l’objet de nœud de linter au résultat.
Utilisez cette méthode dans le champ Script du formulaire Linter Check. 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.
| Nom | Type | Description |
|---|---|---|
| nœud | Objet | Objet de nœud de la vérification Linter. |
| Type | Description |
|---|---|
| Néant |
L’exemple suivant montre comment incrémenter des nœuds de type linter dans une vérification linter. Pour plus d’informations sur l’utilisation des méthodes de vérification Linter, consultez l’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 elle définit automatiquement la source comme enregistrement actuel pendant l’analyse. Pour plus d’informations, consultez Créer une vérification de script uniquement.
| Nom | Type | Description |
|---|---|---|
| source | GlideRecord | Enregistrement à définir comme enregistrement source du résultat actuel. Cette valeur est ajoutée en tant que référence dans le champ Source de la table Conclusions de l’analyse [scan_finding]. |
| Type | Description |
|---|---|
| Néant |
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 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);