ListToFileTool

Das ListToFile Tool ermöglicht das Speichern einer Liste, die per Eingabeterminal übergeben wird, in CSV oder JSON Dateien. Dabei kann ausgewählt werden, welche Eigenschaften der Listeneinträge berücksichtigt werden soll.

Oberfläche

../../../_images/tool.png

(1) Berücksichtige Eigenschaften

Zuerst muss definiert werden, welche Eigenschaften der Listen-Einträge berücksichtigt werden sollen.

Path: Pfad zum Wert (Cognex Terminal Format)

Header: In einer CSV-Datei ist dies der Spaltenkopf. In einer JSON-Datei ist dies der Name der Eigenschaft.

../../../_images/select-path.png

Um eine neue Eigenschaft zu berücksichtigen muss ein neuer Eintrag angelegt werden. Im aufgehenden Dialog, kann nun wie bei Cognex Terminals der Pfad zur berücksichtigten Eigenschaft ausgewählt werden.

(2) Datei Einstellungen

Directory: Verzeichnis, in das die Datei geschrieben wird.

FileName: Dateiname

Bemerkung

Der vollständige Pfad wird aus Verzeichnis und Dateinamen zusammengebaut. Das Verzeichnis ist normalerweise vorkonfiguriert, während der Dateiname sich pro Lauf ändert und als Eingabeterminal übergeben wird.

(3) Ergebnis bei Fehler

Result On Error: Welches Ergebnis soll von diesem Tool zurückgegeben werden, falls ein Fehler vorgekommen ist?

Use Global Setting: WriteCsvToolResultOnError: Falls der Haken aktiviert ist, wird diese Einstellung aus Viper.NET übernommen. (Dort zu finden unter: Globale Einstellungen / VisionPro Tools)

(4) Format - CSV

Write Headers: Sollen die Namen der Spalten in die Erste Zeile der CSV Datei gespeichert werden?

Delimiter: Welches Spaltentrennzeichen soll verwendet werden?

WriteMode: Wie soll bei existierenden Dateien vorgegangen werden?

  • Overwrite: Die Datei wird überschrieben.

  • Append: Die Liste wird an die bereits bestehende Datei angehängt.

(4) Format - JSON

JSON verfügt über keine Konfiguration

Bemerkung

Existiertende JSON Dateien werden immer überschrieben.

(5) Zusätzliche Eigenschaften

../../../_images/additional-inputs.png

Manchmal ist es notwendig, den einzelnen Datensätzen eine übergeordnete Eigenschaft zuzuweisen, um diese beispielsweise dem gleichen Durchlauf oder Bauteil zurechnen zu können. Dafür gibt es Additional Inputs. Diese funktionieren exakt wie Eingabe Terminals bei Toolblocks. Es können Daten definiert werden, oder per DataBinding auf das ListToFileTool gezogen werden. Diese Daten werden jedem Listeneintrag hinzugefügt.