JobResultCSV Plugin

Das JobResultCSV Plugin ist eine Erweiterung für das VisionPlugin. Es schreibt Ergebnisse ausgeführter Jobs in CSV-Dateien. In die Ausgabedateien aufgenommen werden folgende Ergebniswerte:

  • Input-Terminals des CsvMetadataToolBlock mit Typ String

  • Inputs von ValueBlocks in Spalten mit Namen ToolBlockName.InputName

  • Das Ausführungsergebnis des Jobs in der Spalte Result.

  • Eingabewerte, zugehörige Schwellwerte und das Bewertungsergebnis von Kanälen der CogDataAnalysisTool. Die Spalten-Namen werden zusammengesetzt aus dem ToolNamen, dem Kanal-Namen und einem Suffix. Für jeden Kanal werden folgende Spalten generiert:

    • ToolName.KanalName_Min: Untere Ablehnungsschwelle

    • ToolName.KanalName_WarnMin: Untere Warnungsschwelle

    • ToolName.KanalName_WarnMax: Obere Warnungsschwelle

    • ToolName.KanalName_Max: Obere Ablehnungsschwelle

    • ToolName.KanalName_CurrentValue: Aktueller Eingabewert des Kanals

    • ToolName.KanalName_Result: Bewertungsergebnis des Kanals: Zum Beispiel pass.

  • Eine ErrorList: In der Spalte ErrorList werden die Tool-Namen und der Bewertungsstatus aller CogDataAnalysisTools eingetragen, die einen Status Reject oder InvalidValue besitzen. Die Auflistung erfolgt als Komma-separierte Liste, zum Beispiel: TheFirstFailedAnalysisTool.RejectHigh, AnotherFailedAnalysisTool.IvalidValue

  • Der Hyperlink zu einem FinalImage in der Spalte Image file: Enthält die Toolgroup einen SaveImagesEx-ToolBlock, dessen Name auf _FinalImage endet, so wird ein Hyperlink auf den Pfad des gespeicherten Bildes eingefügt.

Siehe auch
CSV Dateien
ResultCsvTool

Plugin-Einstellungen

Die Konfiguration des Plugins erfolgt in zwei Menüs: in den Globalen Einstellungen im Tab Job result csv werden Job-übergreifend die Standard-Einstellungen festgelegt.

Global werden folgende Einstellungen verwaltet:

../../_images/default-plugins-jobresultcsv-globalsettings.png

  1. Enabled: Aktiviert das Speichern von .csv Ergebnisdateien.

  2. Base path: Basis-Verzeichnis zum Speichern der .csv Dateien. Die Dateien werden abhängig von der Konfiguration in Unterverzeichnissen dieses Pfades abgelegt.

  3. Sub directory pattern: Muster, welches ein Unterverzeichnis für die Ausgabedateien definiert. Das Muster kann eine Reihe dynamischer Platzhalter enthalten, die bei jeder Job-Ausführung durch konkrete Eigenschaften der Ausführung, beispielsweise die Uhrzeit, ersetzt werden. Die unterstützten Platzhalter werden unter der Einstellungsgruppe angezeigt (8).

  4. File name pattern: Muster, welches den Dateinamen der Ausgabedatei definiert. Platzhalter des Musters werden bei jeder Job-Ausführung durch konkrete Werte ersetzt. Die unterstützten Platzhalter werden unter der Einstellungsgruppe angezeigt (8).

  5. Decimal separator: Auswahl des Dezimal-Trennzeichens zur Kennzeichnung von Nachkommastellen in der Ausgabedatei.

  6. Column spearator: Auswahl des Trennzeichens für Tabellen-Spalten im CSV-Format.

  7. DataAnalysisTool name in column header: Bei aktivierter Option wird der Spaltenüberschrift von Ergebnissen aus DataAnalysisTools jeweils der Name des Tools vorangestellt. Ohne die Option besteht die Spaltenüberschrift lediglich aus dem Namen des Terminals.

  8. Pattern variables: Legende der unterstützten Muster in File name pattern und Sub directory pattern.

Das JobResultCSV Plugin fügt dem Extension-Tab des Job-Editor einen Tab Result CSV hinzu. Dort können individuell für den jeweiligen Job folgende Einstellungen angepasst werden:

../../_images/default-plugins-jobresultcsv-jobextensiontab.png

  1. Enabled: De-/Aktiviert das Schreiben der CSV Datei mit den Job-Ergebnissen für diesen Job.

  2. Exception handling: Bestimmt das Verhalten des Jobs, falls Fehler während des Speicherns der CSV-Datei auftreten:

  • Warning: Das Job-Ergebnis wird im Fehlerfall auf Warning gesetzt, außer es ist bereits schlechter.

  • RunError: Das Job-Ergebnis wird im Fehlerfall auf RunError gesetzt.

  • Ignore: Fehler beim Sammeln und schreiben der Ergebnisse CSV in die CSV-Datei werden ignoriert. Die Ausgabedatei enthält dann keine oder nur unvollständige Daten zur aktuellen Job-Ausführung.

  1. Include value results: De-/Aktiviert die Auflistung von Ergebnissen aus ValueBlocks in der CSV-Ausgabedatei.

CsvMetadataToolBlock

Ein aktives CsvMetadataPlugin erweitert die Namenskonvention VisionPro-Schnittstelle um einen Toolblock: ToolgroupItems können einen Toolblock mit Namen CsvMetadata enthalten um die CSV Ausgabe dynamisch zu konfigurieren und zusätzliche Spalten zur Ergebnis-Csv-Datei hinzuzufügen.

../../_images/default-plugins-jobresultscsv-csvmetadatablock.png

Über folgende Input-Terminals des ToolBlocks kann das Plugin-Verhalten gesteuert werden:

  • FilePrefix [String]: Präfix, das dem Dateinamen der erzeugten Csv-Datei vorangestellt wird.

  • Enabled [Bool]: De-/Aktiviert das Schreiben von Ergebnissen der aktuellen Ausführung in eine ResultCsv Datei

Falls dem CsvMetadataToolBlock weitere Eingabe-Terminals vom Typ String hinzugefügt wurden, so wird für jedes Terminal eine Spalte in der Ausgabedatei erzeugt. Vor dem Schreiben der Werte prüft das JobResultCSV Plugin, ob der CsvMetadataToolBlock tatsächlich ausgeführt wurde. Falls nicht, so wird anstelle der eigentlichen Terminal-Werte des CsvMetadataToolBlock die Zeichenkette NOT EXECUTED geschrieben.