Giriş Eylemi: Dosya Aktarımı

«Dosya Aktarımı» giriş eylemi ile bir dosya bir işletim varyantından (hedef veya web görselleştirme) PLC'ye ve PLC'den PLC'ye aktarılabilir. Bu, bir dosya aktarımı yoluyla gerçekleşir («Type»: «Dosya») veya akış («Tip»: «Akış»).

Eylem, çalışma zamanında görselleştirmede bir dosya seçim iletişim kutusunun görüntülenmesi etkisine sahiptir. Burada görselleştirme kullanıcısı PLC'ye veya PLC'den aktarılacak bir dosya seçebilir: Bir PLC'den görselleştirmeye aktarım için «Dosyayı Kaydet» iletişim kutusu açılır. Görselleştirmeden PLC'ye aktarım için «Dosya Aç» iletişim kutusu açılır.

«Transfer»
«Yön»	Dosya aktarım yönü
«PLC'den Görselleştirmeye»	«Dosya adı» veya «Akış örneği adı» içinde belirtilen nesne PLC'den görselleştirmeye aktarılır. «Dosyayı Kaydet» dosya seçimi iletişim kutusu çalışma zamanında görselleştirmede görüntülenir.
«Görselleştirmeden PLC'ye»	Görselleştirme kullanıcısı tarafından belirtilen dosya PLC'ye aktarılır ve «Dosya adı» veya «Akış örneği adı» içinde belirtilen dosya yoluna kaydedilir. «Dosya Aç» dosya seçim iletişim kutusu çalışma zamanında görselleştirmede görüntülenir.

«Tip»

Dosyanın nasıl aktarılacağını belirler

Aktarım türü «Dosya»: Dosya aktarımı ile
Aktarım türü «Akış»: Akışa göre

«Tip»

«Dosya»

Veri aktarımı dosya aktarımı ile yapılır.

«Dosya adı»

Dosya sistemindeki dosyayı tanımlayan dosya yolu (tip ‎STRING‎)

Değişken

Örnek: ‎strTransferFile: STRING;‎
Göreli yol ile literal

Örnek: ‎'/Recipes/Recipe_1.txt'‎ dosyayı ‎Recipes‎ dizinine kaydeder.
Yer tutucu ile gerçek ‎$PLCLOGIC$‎

‎PlcLogic‎ dizin yer tutucusu için varsayılan çözünürlüktür ‎$PLCLOGIC$‎.

Örnek: ‎'$$PLCLOGIC$$/test.txt'‎ dosyayı ‎PlcLogic‎ dizinine kaydeder.

Örnek: ‎'$$PLCLOGIC$$/MyData/test.txt'‎ dosyayı ‎PlcLogic/MyData‎ dizinine kaydeder.
Yer tutucu ile gerçek ‎$VISU$‎

‎visu‎ yer tutucu için varsayılan çözünürlüktür ‎$VISU$‎.

Örnek: ‎'$$VISU$$/test.txt'‎ dosyayı ‎PlcLogic/visu‎ alt dizinine kaydedin. Alternatif olarak, ‎'visu/test.txt'‎ adresi de belirtilebilir.
Mutlak yol ile literal

Örnek: ‎'E:\temp\test.txt'‎

Not: Bu tür dosya yolları her zaman desteklenmez.

NOT:

Kullanıcı görselleştirmede dosya yolunu bir «Metin Alanı» öğesi aracılığıyla belirtirse, ‎$‎ maskeleme karakteri dahil edilmemelidir: ‎$VISU$/dummy.txt‎

NOT:

Dosya yolunun kullanıcı tarafından belirtilmesi durumunda, dosyaların yanlışlıkla okunmasını veya üzerine yazılmasını önlemek için uygulama tarafından kontrol edilmelidir.

«Tip»

«Akış»

Veri aktarımı akış yoluyla yapılır.

«Akış örneği adı»

Denetleyicinin dosya sistemindeki nesneyi tanımlayan örnek yolu (tip ‎IVisuStreamWriter‎ veya ‎IVisuStreamReader‎)

Aktarım yönü için ‎IVisuStreamReader‎ yazın «PLC'den Görselleştirmeye»

Aktarım yönü için ‎IVisuStreamWriter‎ yazın «Görselleştirmeden PLC'ye»

«Kontrol bayrakları»

Not: Değişken sadece aktarım yönü için değerlendirilir «Görselleştirmeden PLC'ye».

Değişken (tip ‎DWORD‎)

Nesnenin (dosya veya örnek nesne) PLC'nin dosya sisteminde nasıl işleneceğini belirler. Bunun için değişkenin ayarlanabileceği iki bayrak sağlanmıştır.

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

Seçenekler

Bayrak ayarlanmamış:

Kullanıcı, «Dosya adı» veya «Akış örneği adı» içinde belirtilen yola kaydedilen bir dosya seçer.
Bayrak 1 ayarlanmıştır:

Görselleştirme çalışma zamanında kullanıcı tarafından belirtilen yol uygulanır ve PLC dosya sistemindeki yol olarak kullanılır.
Her iki bayrak da ayarlanmıştır:

Yol da kontrol edilir. İstemci tarafında belirtilen yolda bir nesne zaten mevcutsa, görselleştirmede bir mesaj istemi görüntülenir. Burada görselleştirme kullanıcısı dosyanın üzerine yazılacağını onaylayabilir.

Örnek: ‎dwControlFlag‎

Örnek

Aktarım yönü «Görselleştirmeden PLC'ye» (yazma) şeklindedir.

Örnek: Görselleştirme cihazında yeni bir tarif dosyası ‎Recipes/Recipe_2021.txt‎ oluşturuldu. Görselleştirme kullanıcısı bu dosyayı seçer ve dosyayı PLC'ye aynı adla kaydetmek ister. Kontrol bayrakları uygun şekilde ayarlandığından, bir mesaj penceresi açılır ve görselleştirme kullanıcısı dosyanın üzerine yazılacağını onaylayabilir.

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

«Durum Değişkenleri»
«Transfer aktif»	Boolean değişkeni (isteğe bağlı) `‎TRUE‎`: Transfer işlemi devam ediyor.
«Transfer başarılı»	Boolean değişkeni (isteğe bağlı) `‎TRUE‎`: Aktarım başarıyla tamamlandı.
«Hata kodu»	`‎0‎`: Hata yok `‎1‎`: Belirtilmemiş hata `‎2‎`: Dosya iletişim kutusunun iptali `‎3‎`: Diğer dosya aktarımı devam ediyor `‎4‎`: Dosya aktarımı sırasında hata `‎5‎`: Zaman aşımı ile iptal `‎6‎`: Dosya okuma hatası - Dosya mevcut değil veya okunamıyor. `‎7‎`: Dosya aktarımı için cihaz desteği yok Olası nedenler: CODESYS WebVisu: Dosya aktarımı varsayılan olarak mümkün değildir. Sürüm < 3.5.11 olan bir kontrolör ile iletişim: İşlevsellik uygulanmadı. Sürüm >= 3.5.11 olan bir kontrolör ile iletişim: Dosya aktarımı etkinleştirilmedi (cihaz açıklaması). TIP: CODESYS proje ayarlarında bu ayarı yönetir.

«Lokal görselleştirme dosyalarını kullanma»

Gereklilik: Bu seçenek, «Görselleştirme dosyalarını PLC'ye aktar» yön olarak belirtildiğinde kullanılabilir.

: İşletim sisteminin dosya seçim iletişim kutusu hemen görüntülenir (yeni oluşturulmuş bir giriş eylemi için varsayılan).

: Varsayılan olarak mevcut olan dosya aktarım iletişim kutusu açılır ve sizden bir dosya seçmenizi ister. Diyaloğu uyarlayabilirsiniz.

İpucu: İletişim kutusunun uygunsuz bir konumda görüntülenmesi ve iletişim kutusu düzeninin web görselleştirmesinin arayüzüyle uyuşmaması mümkündür.