Beschreibung
Exportiert einen oder alle Datensätze einer Rezeptur in eine CSV-Datei und generiert für jede Zeile in der Datei eine Prüfsumme.
Pro Rezeptur wird eine Datei angelegt.
Verwendung in der Funktionsliste
ExportiereDatensätzeMitPrüfsumme (Rezepturnummer/-name, Datensatznummer/-name, Dateiname, Überschreiben, Statusmeldung ausgeben, Bearbeitungsstatus)
Verwendung in benutzerdefinierten Funktionen
ExportDataRecordsWithChecksum Recipe_number_or_name, Data_record number_or_name, File_name, Overwrite, Output_status_message, Processing_status
Verwendbar, sofern das projektierte Gerät benutzerdefinierte Funktionen unterstützt. Weitere Informationen finden Sie unter "Geräteabhängigkeit".
Parameter
Rezepturnummer/-name
Nummer oder Name der Rezeptur, aus der Rezepturdatensätze exportiert werden. Geben Sie "0" an, wenn Sie aus allen verfügbaren Rezepturen Rezepturdatensätze exportieren wollen.
Datensatznummer/-name
Nummer oder Name des Rezepturdatensatzes, der exportiert wird. Geben Sie "0" an, wenn Sie alle Rezepturdatensätze exportieren wollen.
Dateiname
Name der CSV-Datei, in welche die Rezepturdatensätze exportiert werden. Geben Sie den Pfad und die Dateiendung mit an z.B. "C:\TEMP\Orange.CSV".
Wenn Sie als Ablageort eine Speicherkarte verwenden, dann geben Sie den Ablageort wie folgt an: "\StorageCard\<Dateiname>".
Wenn Sie nur einen Dateinamen und keinen Pfad festlegen, wird die Datei in dem Verzeichnis abgelegt, aus dem die Runtime gestartet wurde. Wenn unter Betriebssystem Windows 7 keine Schreibrechte für das Verzeichnis bestehen, wird die Datei im Benutzerverzeichnis im Ordner "VirtualStore" abgelegt.
Wenn Sie nur den Pfad für den Export angeben, wird der Dateiname jeweils automatisch aus dem Rezepturnamen erzeugt. Die Voraussetzung ist, dass das Verzeichnis z. B. "D:\Temp\" angelegt ist. Wenn das Verzeichnis "D:\Temp" nicht angelegt ist, wird der Verzeichnisname als Präfix für den Dateinamen verwendet,Temp_Rezepturnamen.csv.
Überschreiben
Legt fest, ob eine bereits vorhandene CSV-Datei gleichen Namens überschrieben wird:
0 (hmiOverwriteForbidden) = Nein: CSV-Datei wird nicht überschrieben. Der Exportvorgang wird nicht ausgeführt.
1 (hmiOverwriteAlways) = Ja: CSV-Datei wird ohne Nachfrage überschrieben.
2 (hmiOverwriteWithConfirmation) = Nach Bestätigung: CSV-Datei wird erst nach Bestätigung überschrieben.
Statusmeldung ausgeben
Legt fest, ob nach dem Export eine Statusmeldung ausgegeben wird:
0 (hmiOff) = Aus: Statusmeldung wird nicht ausgegeben.
1 (hmiOn) = Ein: Statusmeldung wird ausgegeben.
Bearbeitungsstatus
Gibt den Bearbeitungsstatus der Systemfunktion zurück. Verwenden Sie den Rückgabewert, um z.B. andere Systemfunktionen erst dann auszuführen, wenn diese Systemfunktion erfolgreich beendet wurde:
2 = Systemfunktion wird gerade ausgeführt.
4 = Systemfunktion wurde erfolgreich beendet.
12 = Systemfunktion wurde nicht ausgeführt, weil ein Fehler aufgetreten ist.
Für den Parameter können Sie nur eine HMI-Variable verwenden.
Exportformat der Rezepturdatensätze
Wenn für die Exportdatei die Dateierweiterung ".csv" gewählt wird, dann werden lediglich gültige Zeichen aus dem ANSI-Zeichensatz unterstützt. Dies gilt auch für Trennzeichen bei Dezimalzahlen und Listenelementen. Die verwendeten Trennzeichen werden in den Ländereinstellungen des Betriebssystems des exportierenden Computers festgelegt.
Für den Export kann auch das Dateiformat "Unicode Text" (".txt") gewählt werden. Dieses Dateiformat unterstützt alle in WinCC und WinCC Runtime verwendbaren Zeichen. Die verwendeten Trennzeichen werden auch hier in den Ländereinstellungen des Betriebssystems des exportierenden Computers festgelegt. Bei diesem Dateiformat wird als Trennzeichen für Listenelemente immer der Tabulator verwendet.
Die zugehörige Funktion zum Import der Daten unterstützt ebenfalls die beiden Dateiformate ".csv" und ".txt" (Unicode).
Anwendungsbeispiel
Sie wollen über eine Taste alle Datensätze exportieren und mit einer Prüfsumme versehen.
Hinweise zur Projektierung
Projektieren Sie die Systemfunktion "ExportiereDatensätzeMitPrüfsumme" an das Ereignis "Drücken" der gewünschten Taste. Übergeben Sie folgende Parameter:
-
Rezepturnummer/-name = 1
-
Datensatznummer/-name = 0
-
Dateiname = c:\temp\orange.csv
-
Überschreiben = 1
-
Statusmeldung ausgeben = 1
An Stelle der Konstanten können Sie auch Variablen angeben. Je nach Projektierung kann der Bediener die gewünschten Werte in E/A-Felder eingeben oder aus der Steuerung lesen. Auf diese Weise kann der Bediener bestimmen, welche Rezepturdatensätze exportiert werden.
Ablauf am Bediengerät
Sobald die Taste betätigt wird, wird die Systemfunktion ausgelöst. Die Konstanten oder Variablen werden ausgewertet. Alle Datensätze der Rezeptur 1 werden in die Datei orange.csv exportiert und mit Prüfsummen versehen. Wenn die Datei bereits vorhanden ist, wird sie überschrieben.
Nach dem Export der Datensätze wird eine Systemmeldung ausgegeben.