# WriteData

Mit der Funktion „WriteData“ können Sie Daten in eine Datei schreiben oder eine Datenzeichenfolge an eine Datei auf einem lokalen Gerät oder einem FTP-Server anhängen. Mit dieser Funktion können Sie Datenergebnisse protokollieren und in einer Datei anzeigen.

Hinweis: Sie können die Datei am ausgewählten Speicherort im Online- oder Offline-Modus speichern.

## WriteData – Eingaben

Parameter | Beschreibung
Data | Gibt eine Textzeichenfolge oder eine Referenz auf eine Zelle an, die eine Textzeichenfolge enthält, die Sie schreiben oder an eine Datei anhängen können.
Ereignis | Gibt das Ereignis an, das eine Aktualisierung erzwingt. Dieser Parameter muss ein Verweis auf ein Ereignis mit einem Zeitstempel sein, z. B.: Eine Zelle, die eine Event-Funktion enthält. Eine Zelle, die eine Button-Funktion enthält.
Speicher | Gibt an, ob die Datendatei auf einem lokalen Gerät oder auf einem FTP-Server gespeichert werden soll. Der Speicherort hängt vom angeschlossenen Gerät und der Speichereinstellung der Funktion ab.
Speichereinstellung | Angeschlossenes Gerät | Speicherort
--- | --- | ---
Lokales Gerät | In-Sight-Gerät | In-Sight-Gerät Im In-Sight-Gerät installierte SD-Karte Hinweis: Zum Anzeigen von Dateien müssen Sie FTP-Software wie FileZilla Client verwenden. Weitere Informationen finden Sie unter Auf einem In-Sight-Gerät gespeicherte Dateien anzeigen. Wenn Sie einen SD-Kartenspeicher verwenden, müssen Sie vor dem Ausführen des Jobs die SD-Speicherkarte einstecken. Wenn Sie den SD-Kartenspeicher ohne eingesteckte SD-Karte konfigurieren, speichert der Job die Dateien im Verzeichnis /sdcard des internen Flash-Speichers.
PC | PC Hinweis: Das Speichern auf einem PC wird nur bei Verwendung eines FTP-Servers unterstützt.
FTP-Server | Beliebiges Gerät | Angegebener FTP-Server
Server | Gibt den Servernamen (oder die IP-Adresse) des FTP-Servers im Netzwerk an, auf den die Datendatei geschrieben wird. Ein FTP-Server kann ein In-Sight-Emulator oder ein beliebiges Gerät sein, das im Netzwerk als FTP-Server erkannt wird. Hinweis: Diese Option ist nur aktiviert, wenn Sie FTP-Server als Speichertyp auswählen. Wenn ein bestimmter Port erforderlich ist, können Sie ihn an den Servernamen anhängen. Beispiel: Der FTP-Server verwendet Port 50021, geben Sie „127.0.0.1:50021“ ein.
Benutzername | Gibt den Benutzernamen des FTP-Servers an. Wenn dieses Feld leer gelassen wird, wird „admin“ verwendet. Hinweis: Diese Option ist nur aktiviert, wenn Sie FTP-Server als Speichertyp auswählen.
Kennwort | Legt das Kennwort für den FTP-Server fest. Beim Kennwort wird zwischen Groß- und Kleinschreibung unterschieden. Wenn der FTP-Server kein Kennwort hat, können Sie dieses Feld leer lassen. Hinweis: Diese Option ist nur aktiviert, wenn Sie FTP-Server als Speichertyp auswählen. Aus Sicherheitsgründen wird das eingegebene Kennwort auf dem WriteData-Eigenschaftsblatt und in der Formelleiste nur mit Sternchen (*) dargestellt. Das Kennwort wird in verschlüsselter Form in der Jobdatei gespeichert.
Dateipfad | Gibt den Speicherort zum Speichern der Datei an. Beim Speichern auf dem PC können Sie die Datei auf einen beliebigen Speicherort schreiben, für den Sie über Schreibrechte für das Betriebssystem verfügen. Sie können einen hartcodierten Pfad (z. B. X:/, X:/Unterverzeichnis), einen UNC-Pfad (z. B. //Cognex/freigegeben/), ein zugeordnetes Laufwerk (z. B. M:/Unterverzeichnis) oder einen relativen Pfad (../../Unterverzeichnis) in dieses Feld eingeben. Wenn der Pfad auf dem In-Sight-Gerät oder dem PC nicht vorhanden ist, gibt die Funktion #ERR zurück. Wenn der Pfad oder die FTP-Anmeldeinformationen auf dem FTP-Server ungültig sind, gibt die Funktion nicht #ERR zurück. Wenn Sie dieses Feld leer lassen, senden Sie die Datei an eines der folgenden Standardverzeichnisse: In-Sight-Gerät: Stammverzeichnis des Geräts. FTP-Server: Das Standardverzeichnis des angegebenen FTP-Servers.
Dateiname | Gibt den Namen der Datendatei an. Hinweis: Folgen Sie den Beschränkungen des Betriebssystems hinsichtlich der zulässigen Zeichen.
Dateiformat | Gibt den Dateityp an. Die Erweiterung wird automatisch an den Dateinamen angehängt.
0 = TXT (Standard) | Standard ASCII Text-Dateiformat (.TXT).
1 = HTML | Standard-HTML-Dateiformat (.HTML).
2 = XML | Standard XML-Dateiformat (.XML).
3 = CSV | Standard-CSV-Dateiformat (.CSV).
Anhängen | Gibt an, wie die Daten in die Datei geschrieben werden.
0 = AUS | Überschreibt die in der Datei vorhandenen Daten.
1 = EIN (Standard) | Hängt die Datenzeichenfolge am Ende der Datei an.

## WriteData – Ausgaben

Rückgabewert | Eine WriteData-Struktur, die die im Parameter „Data“ enthaltene Datenzeichenfolge auf ein lokales Gerät oder einen FTP-Server schreibt, wenn das referenzierte Ereignis ausgelöst wird. Gibt #ERR zurück, wenn Eingabeparameter ungültig sind oder die Dateiwarteschlange voll ist. Hinweis: Bei einem ungültigen FTP-Server, Pfad oder Dateinamen wird nicht #ERR zurückgegeben.