Ergebnisse: bereichsbezogen, global

Die API „ Findings “ stellt Methoden bereit, mit denen gehandhabt wird, wie eine Instance Scan -Prüfung Ergebnisse erzeugt.

Diese API ist im Plugin Instance Scan (com.glide.instance_scan) enthalten und wird im Namespace sn_instance_scan ausgeführt. Weitere Informationen finden Sie unter Instanzscan.

Beim Instanz-Scan wird für jeden Datensatz im Rahmen eines Scans der Instanz Prüfungen ausgeführt, um Ergebnisse zu generieren. Jedes Ergebnis enthält Informationen zu einem Problemdatensatz und zu der durch ihn verletzten Prüfung. Ergebnismethoden werden in Prüfungen Instance Scan als Teil des Engine-Objekts verwendet, das an den Benutzer übergeben wird. Fügen Sie den Code dem Feld Skript im Scheckformular hinzu.

Siehe auch:

• Erste Schritte mit Prüfungen
• Ergebnisse

Ergebnisse – inkrement()

Erhöht die Anzahl des aktuellen Ergebnisses.

Die Anzahl der Ergebnisse beginnt für jeden Datensatz, den ein Scheck in einem Scan analysiert, bei Null. Wenn diese Methode aufgerufen wird, erhöht sie die Ergebnisanzahl. Die Anzahl gibt an, dass ein Ergebnis für den aktuellen Datensatz generiert werden soll.

Diese Methode kann mehrmals aufgerufen werden, um anzugeben, dass für dieses Ergebnis ein Prüfungsverstoß im aktuellen Datensatz mehrmals aufgetreten ist.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die Anzahl der Datensätze mit einem fehlgeschlagenen Status in einer Tabellentypprüfung gezählt wird. Weitere Informationen finden Sie unter Überprüfung des Tabellentyps erstellen.

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

Ergebnisse – incrementWithNode(Objektknoten)

Wenn das aktuelle Ergebnis aus einer Linter-Prüfung stammt, erhöht diese Methode die Anzahl der aktuellen Ergebnisse und übergibt gleichzeitig das Linter-Knotenobjekt an das Ergebnis.

Verwenden Sie diese Methode im Feld Skript im Formular „Linter Check“. Diese Methode speichert Informationen zum angegebenen Knoten, z. B. eine Zeilennummer in der Detailspalte eines aktuellen Ergebnisses.

Siehe auch:

• Erweiterte Skripts zur Linter-Prüfung
• LinterCheckAstNode-API

Tabelle : 3. Parameter

Name	Typ	Beschreibung
node	Objekt	Knotenobjekt aus dem Linter-Check.

Tabelle : 4. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Linter-Typknoten bei einer Linter-Prüfung inkrementiert werden. Informationen zur Verwendung von Linter-Prüfungsmethoden finden Sie unter LinterCheckAstNode-API.

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

Ergebnisse – setCurrentSource(GlideRecord source)

Legt die Quelle des aktuellen Ergebnisses basierend auf dem angegebenen GlideRecord fest.

Verwenden Sie diese Methode im Feld Skript einer Prüfung vom Typ „Nur Skript“. Diese Methode wird nicht für andere Prüfungen verwendet, da sie die Quelle während des Scans automatisch als aktuellen Datensatz festlegen. Weitere Informationen finden Sie unter Nur Skriptprüfung erstellen.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Quelle	GlideRecord	Der Datensatz, der als Quelldatensatz für das aktuelle Ergebnis festgelegt werden soll. Dieser Wert wird als Referenz im Feld Quelle der Tabelle „Scanfunde“ [scan_finding] hinzugefügt.

Tabelle : 6. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie bei einer Prüfung vom Typ „Nur Skript“ die aktuelle Quelle auf einen Incident-Datensatz festgelegt wird. Weitere Informationen finden Sie unter Nur Skriptprüfung erstellen.

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