Ergebnisse: bereichsbezogen, global

Die Findings -API bietet Methoden für die Verarbeitung der Ergebnisse einer Instance Scan -Prüfung.

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 Instanz-Scan.

Beim Instanz-Scan werden Prüfungen für jeden Datensatz im Rahmen eines Scans der Instanz ausgeführt, um Ergebnisse zu generieren. Jedes Ergebnis enthält Informationen zu einem Problemdatensatz und zu der Prüfung, gegen die verstoßen wurde. Ergebnismethoden werden in Prüfungen von Instance Scan als Teil des an den Benutzer übergebenen Engine-Objekts verwendet. Fügen Sie den Code dem Feld Skript im Prüfungsformular hinzu.

Siehe auch:

• Erste Schritte mit Prüfungen
• Ergebnisse

Ergebnisse – increment()

Erhöht die Anzahl der aktuellen Ergebnisse.

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

Diese Methode kann mehrmals aufgerufen werden, um anzugeben, dass für dieses Ergebnis ein Prüfungsverstoß im aktuellen Datensatz mehrfach 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 Tabellentypprüfungen erstellen.

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

Findings – incrementWithNode(Object node)

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

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

Siehe auch:

• Erweiterte Linter-Prüfskripts
• LinterCheckAstNode-API

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Knoten	Objekt	Knotenobjekt aus der Linter-Prüfung.

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Linter-Typ-Knoten in einer Linter-Prüfung erhöht werden. Weitere 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);

Findings – setCurrentSource(GlideRecord source)

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

Verwenden Sie diese Methode im Feld Skript einer Prüfung 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 Skriptüberprü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. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die aktuelle Quelle auf einen Incident-Datensatz in einer reinen Skriptüberprüfung festgelegt wird. Weitere Informationen finden Sie unter Nur Skriptüberprüfung erstellen.

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