Beschreibung
Exportiert einen oder alle Datensätze einer Rezeptur in eine CSV-Datei oder eine TXT-Datei.
Pro Rezeptur wird eine Datei angelegt.
Verwendung in der Funktionsliste
ExportiereDatensätze (Rezepturnummer/-name, Datensatznummer/-name, Dateiname, Überschreiben, Statusmeldung ausgeben, Bearbeitungsstatus)
Verwendung in benutzerdefinierten Funktionen
ExportDataRecords Recipe_number/name, Data_record number/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 Datei, in welche die Rezepturdatensätze exportiert werden. Geben Sie den Namen einschließlich des Ablageorts und der Dateierweiterung (*.csv oder *.txt) an, z.B. "C:\TEMP\Orange.csv". Wenn ein Ordner nicht existiert, wird er beim Export angelegt.
Wenn Sie den Dateinamen nicht vollständig eingeben, ist das Verhalten abhängig von der Anzahl der projektierten Rezepturen:
-
Wenn mehrere Rezepturen projektiert sind und
Sie nur einen Dateinamen und keinen Pfad angeben, wird die Datei in einem Systemverzeichnis, z.B. "C:\Documents and Settings\[User]", abgelegt.
Sie nur einen Pfad und keinen Dateinamen angeben, wird der Dateiname aus dem Rezepturnamen erzeugt. Die Voraussetzung ist, dass der im Pfad angebene Ordner, z. B. "D:\Data\", angelegt ist. Wenn der Ordner "D:\Data" nicht angelegt ist, wird der Ordnername als Präfix für den Dateinamen verwendet, z.B. "Data_Rezepturname.csv".
-
Wenn nur eine Rezeptur projektiert ist und Sie nur einen Pfad und keinen Dateinamen angeben,
wird, wenn der Ordner nicht existiert eine Datei mit dem Ordnernamen angelegt. Diese besitzt jedoch keine Dateierweiterung.
wird, wenn der Ordner existiert, der Export mit einer Fehlermeldung abgebrochen.
Wenn Sie als Ablageort eine Speicherkarte verwenden, dann geben Sie den Ablageort wie folgt an: "\StorageCard\<Name>".
Für Basic Panel geben Sie den Dateinamen wie folgt an: "\USB_X60.1\<Name>"
Überschreiben
Legt fest, ob eine bereits vorhandene Export-Datei gleichen Namens überschrieben wird:
0 (hmiOverwriteForbidden) = Nein: Export-Datei wird nicht überschrieben. Der Exportvorgang wird nicht ausgeführt.
1 (hmiOverwriteAlways) = Ja: Export-Datei wird ohne Nachfrage überschrieben.
2 (hmiOverwriteWithPrompting) = Nach Bestätigung: Export-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.
Hinweise zur Projektierung
Projektieren Sie die Systemfunktion "ExportiereDatensätze" an das Ereignis "Drücken" der gewünschten Taste. Übergeben Sie folgende Parameter:
-
Rezepturnummer/-name = 1
-
Datensatznummer/-name = 0
-
Dateiname = c:\temp\orange.csv (für Basic Panels "\USB_X60.1\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. Wenn die Datei bereits vorhanden ist, wird sie überschrieben.
Nach dem Export der Datensätze wird eine Systemmeldung ausgegeben.