Eingabe Aktion: Dateiübertragung

Mit der Eingabeaktion „File Transfer“ kann eine Datei von einer Bedienvariante (Target- oder Web-Visualisierung) zur SPS sowie von und zur SPS übertragen werden. Dies funktioniert entweder über eine Dateiübertragung („Typ“: „Datei“) oder Streaming („Typ“: „Streaming“).

Die Aktion bewirkt, dass zur Laufzeit ein Dateiauswahldialog in der Visualisierung angezeigt wird. Dort kann der Visualisierungsanwender eine Datei auswählen, die entweder zur oder von der SPS übertragen werden soll: Bei einer Übertragung von einer SPS zur Visualisierung öffnet sich der Dialog „Datei speichern“. Für die Übertragung von der Visualisierung zur SPS öffnet sich der Dialog „Datei öffnen“.

„Übertragung“
„Richtung“	Richtung der Dateiübertragung
„Vom PLC zur Visualisierung“	Das in „Dateiname“ oder „Streaming-Instanzname“ angegebene Objekt wird von der SPS zur Visualisierung übertragen. Der „Datei speichern“ Dateiauswahldialog wird zur Laufzeit in der Visualisierung angezeigt.
„Von der Visualisierung zur PLC“	Die vom Visualisierungsanwender angegebene Datei wird an die SPS übertragen und in dem unter „Dateiname“ oder „Streaming-Instanzname“ angegebenen Dateipfad gespeichert. Der Dateiauswahldialog „Open File“ wird zur Laufzeit in der Visualisierung angezeigt.

„Typ“

Legt fest, wie die Datei übertragen wird

Übertragungsart „Datei“: Durch Dateiübertragung
Übertragungsart „Streaming“: Durch Streaming

„Typ“

„Datei“

Die Datenübertragung erfolgt per Dateitransfer.

„Name der Datei“

Dateipfad (Typ ‎STRING‎), der die Datei im Dateisystem beschreibt

Variable

Beispiel: ‎strTransferFile: STRING;‎
Literal mit relativem Pfad

Beispiel: ‎'/Recipes/Recipe_1.txt'‎ speichert die Datei in dem Verzeichnis ‎Recipes‎.
Wörtlich mit Platzhalter ‎$PLCLOGIC$‎

‎PlcLogic‎ ist die Standardauflösung für den Verzeichnisplatzhalter ‎$PLCLOGIC$‎.

Beispiel: ‎'$$PLCLOGIC$$/test.txt'‎ speichert die Datei in dem Verzeichnis ‎PlcLogic‎.

Beispiel: ‎'$$PLCLOGIC$$/MyData/test.txt'‎ speichert die Datei in dem Verzeichnis ‎PlcLogic/MyData‎.
Wörtlich mit Platzhalter ‎$VISU$‎

‎visu‎ ist die Standardauflösung für den Platzhalter ‎$VISU$‎.

Beispiel: ‎'$$VISU$$/test.txt'‎ Speichern Sie die Datei im Unterverzeichnis ‎PlcLogic/visu‎. Alternativ dazu kann auch ‎'visu/test.txt'‎ angegeben werden.
Literal mit absolutem Pfad

Beispiel: ‎'E:\temp\test.txt'‎

Hinweis: Diese Art von Dateipfaden wird nicht immer unterstützt.

HINWEIS:

Wenn ein Benutzer den Dateipfad in der Visualisierung mit Hilfe eines „Textfeldes“ Elements angibt, darf das Maskierungszeichen ‎$‎ nicht enthalten sein: ‎$VISU$/dummy.txt‎

HINWEIS:

Wenn der Dateipfad vom Benutzer angegeben wird, sollte er von der Anwendung überprüft werden, um zu verhindern, dass Dateien versehentlich gelesen oder überschrieben werden.

„Typ“

„Streaming“

Die Datenübertragung erfolgt per Streaming.

„Name der Streaming-Instanz“

Instanzpfad (Typ ‎IVisuStreamWriter‎ oder ‎IVisuStreamReader‎), der das Objekt im Dateisystem des Controllers beschreibt

Typ ‎IVisuStreamReader‎ für Übertragungsrichtung „Von der SPS zur Visualisierung“

Typ ‎IVisuStreamWriter‎ für Übertragungsrichtung „Von der Visualisierung zur SPS“

„Kontrollflaggen“

Hinweis: Die Variable wird nur für die Übertragungsrichtung ausgewertet „Von der Visualisierung zur SPS“.

Variable (Typ ‎DWORD‎)

Bestimmt, wie das Objekt (Datei oder Instanzobjekt) im Dateisystem der SPS behandelt wird. Hierfür sind zwei Flags vorgesehen, mit denen die Variable gesetzt werden kann.

Flagge 1: ‎VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName‎
Flagge 2: ‎VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc‎

Optionen

Kein Flag gesetzt:

Der Benutzer wählt eine Datei aus, die unter dem in „angegebenen Pfad gespeichert wird. Dateiname“ oder „Name der Streaming-Instanz“.
Flagge 1 ist gesetzt:

Der Pfad, der vom Benutzer zur Laufzeit der Visualisierung angegeben wird, wird übernommen und als Pfad im SPS-Dateisystem verwendet.
Beide Flaggen sind gesetzt:

Auch der Pfad wird überprüft. Wenn ein Objekt in dem auf der Client-Seite angegebenen Pfad bereits existiert, wird in der Visualisierung eine entsprechende Meldung angezeigt. Dort kann der Visualisierungsbenutzer bestätigen, dass die Datei überschrieben werden soll.

Beispiel: ‎dwControlFlag‎

Beispiel

Die Übertragungsrichtung ist „Von der Visualisierung zur SPS“ (schreiben).

Beispiel: Im Visualisierungsgerät ist eine neue Rezepturdatei ‎Recipes/Recipe_2021.txt‎ angelegt worden. Der Visualisierungsanwender wählt diese Datei aus und möchte die Datei unter dem gleichen Namen auf der SPS speichern. Da die Kontrollflags entsprechend gesetzt sind, öffnet sich ein Meldungsfenster und der Visualisierungsbenutzer kann bestätigen, dass die Datei überschrieben wird.

PROGRAM PLC_PRG
VAR
    xVisuToggle : BOOL;
    dwControlFlag : DWORD := VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName
                             + VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc;
    strFileName: STRING := '/Recipes/Recipe_new.txt';
END_VAR

„Status-Variablen“
„Übertragung aktiv“	Boolesche Variable (optional) `‎TRUE‎`: Die Übertragung ist im Gange.
„Übertragung erfolgreich“	Boolesche Variable (optional) `‎TRUE‎`: Die Übertragung wurde erfolgreich abgeschlossen.
„Fehlercode“	`‎0‎`: Keine Fehler `‎1‎`: Nicht spezifizierter Fehler `‎2‎`: Abbruch des Dateidialogs `‎3‎`: Andere Dateiübertragung im Gange `‎4‎`: Fehler bei der Dateiübertragung `‎5‎`: Löschung durch Zeitüberschreitung `‎6‎`: Dateilesefehler - Die Datei ist nicht verfügbar oder kann nicht gelesen werden. `‎7‎`: Keine Geräteunterstützung für die Dateiübertragung Mögliche Ursachen: CODESYS WebVisu: Die Dateiübertragung ist standardmäßig nicht möglich. Kommunikation mit einem Steuergerät mit einer Version < 3.5.11: Funktionalität nicht implementiert. Kommunikation mit einer Steuerung der Version >= 3.5.11: Dateiübertragung nicht aktiviert (Gerätebeschreibung). TIPP: CODESYS verwaltet diese Einstellung in den Projekteinstellungen.

„Lokale Visualisierungsdateien verwenden“

Erfordernis: Die Option ist verfügbar, wenn als Richtung „Visualisierungsdateien zur SPS übertragen“ angegeben wurde.

: Der Dateiauswahldialog des Betriebssystems wird sofort angezeigt (Standard für eine kürzlich erstellte Eingabeaktion).

: Das standardmäßig verfügbare Dialogfeld für die Dateiübertragung wird geöffnet und fordert Sie auf, eine Datei auszuwählen. Sie können den Dialog anpassen.

Hint: Es ist möglich, dass der Dialog an einer ungünstigen Stelle angezeigt wird und dass das Layout des Dialogs nicht mit dem der Oberfläche der Web-Visualisierung übereinstimmt.