Azione di ingresso: Trasferimento di file

Con l'azione di input «File Transfer» è possibile trasferire un file da una variante operativa (target o visualizzazione web) al PLC, nonché da e verso il PLC. Questo funziona sia attraverso un trasferimento di file («Tipo»: «File») o in streaming («Tipo»: «Streaming»).

L'azione ha l'effetto di visualizzare una finestra di dialogo per la selezione dei file nella visualizzazione in fase di esecuzione. L'utente della visualizzazione può selezionare un file da trasferire al o dal PLC: Per trasferire un file da un PLC alla visualizzazione, si apre la finestra di dialogo «Save File». Per il trasferimento dalla visualizzazione al PLC, si apre la finestra di dialogo «Open File».

«Trasferimento»

«Direzione»

Direzione del trasferimento dei file

«Dal PLC alla visualizzazione»

L'oggetto specificato in «Nome file» o «Nome istanza di streaming» viene trasferito dal PLC alla visualizzazione.

La finestra di dialogo per la selezione del file «Save File» viene visualizzata nella visualizzazione in fase di esecuzione.

«Dalla visualizzazione al PLC»

Il file specificato dall'utente della visualizzazione viene trasferito al PLC e salvato nel percorso del file specificato in «Nome del file» o «Nome dell'istanza di streaming».

La finestra di dialogo per la selezione del file «Open File» viene visualizzata nella visualizzazione in fase di esecuzione.

«Tipo»

Determina la modalità di trasferimento del file

  • Tipo di trasferimento «File»: Per trasferimento di file

  • Tipo di trasferimento «Streaming»: In streaming

«Tipo»

«File»

Il trasferimento dei dati avviene tramite trasferimento di file.

«Nome del file»

Percorso del file (tipo ‎STRING‎), che descrive il file nel file system.

  • Variabile

    Esempio: ‎strTransferFile: STRING;‎

  • Letterale con percorso relativo

    Esempio: ‎'/Recipes/Recipe_1.txt'‎ salva il file nella directory ‎Recipes‎.

  • Letterale con segnaposto ‎$PLCLOGIC$‎

    ‎PlcLogic‎ è la risoluzione predefinita per il segnaposto della directory ‎$PLCLOGIC$‎.

    Esempio: ‎'$$PLCLOGIC$$/test.txt'‎ salva il file nella directory ‎PlcLogic‎.

    Esempio: ‎'$$PLCLOGIC$$/MyData/test.txt'‎ salva il file nella directory ‎PlcLogic/MyData‎.

  • Letterale con segnaposto ‎$VISU$‎

    ‎visu‎ è la risoluzione predefinita per il segnaposto ‎$VISU$‎.

    Esempio: ‎'$$VISU$$/test.txt'‎ salva il file nella sottodirectory ‎PlcLogic/visu‎. In alternativa, è possibile specificare anche ‎'visu/test.txt'‎.

  • Letterale con percorso assoluto

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

    Nota: Questi tipi di percorsi di file non sono sempre supportati.

NOTA:

Se l'utente specifica il percorso del file nella visualizzazione mediante un elemento «Text Field», il carattere di mascheramento ‎$‎ non deve essere incluso: ‎$VISU$/dummy.txt‎

NOTA:

Nel caso in cui il percorso dei file sia specificato dall'utente, deve essere controllato dall'applicazione per evitare che i file vengano letti o sovrascritti accidentalmente.

«Tipo»

«Streaming»

Il trasferimento dei dati avviene in streaming.

«Nome dell'istanza di streaming»

Percorso dell'istanza (tipo ‎IVisuStreamWriter‎ o ‎IVisuStreamReader‎) che descrive l'oggetto nel file system del controllore.

Digitare ‎IVisuStreamReader‎ per la direzione di trasferimento «Dal PLC alla visualizzazione»

Digitare ‎IVisuStreamWriter‎ per la direzione di trasferimento «Dalla visualizzazione al PLC»

«Bandiere di controllo»

Nota: La variabile viene valutata solo per la direzione di trasferimento «Dalla visualizzazione al PLC».

Variabile (tipo ‎DWORD‎)

Determina la gestione dell'oggetto (file o oggetto istanza) nel file system del PLC. Sono previsti due flag con i quali è possibile impostare la variabile.

  • Bandiera 1: ‎VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName‎

  • Bandiera 2: ‎VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc‎

Opzioni

  • Nessun flag impostato:

    L'utente seleziona un file che viene salvato nel percorso specificato in «Nome del file» o «Nome dell'istanza di streaming».

  • Il flag 1 è impostato:

    Il percorso specificato dall'utente durante l'esecuzione della visualizzazione viene applicato e utilizzato come percorso nel file system del PLC.

  • Entrambi i flag sono impostati:

    Viene controllato anche il percorso. Se un oggetto esiste già nel percorso specificato sul lato client, viene visualizzato un messaggio nella visualizzazione. L'utente della visualizzazione può confermare la sovrascrittura del file.

Esempio: ‎dwControlFlag‎

Esempio

La direzione di trasferimento è «Dalla visualizzazione al PLC» (scrittura).

Esempio: Nell'apparecchio di visualizzazione è stato creato un nuovo file di ricetta ‎Recipes/Recipe_2021.txt‎. L'utente della visualizzazione seleziona questo file e vuole salvarlo sul PLC con lo stesso nome. Poiché i flag di controllo sono impostati di conseguenza, si apre una finestra di messaggio e l'utente della visualizzazione può confermare la sovrascrittura del file.

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

«Variabili di stato»

«Trasferimento attivo»

Variabile booleana (opzionale)

‎TRUE‎: Il trasferimento è in corso.

«Trasferimento riuscito»

Variabile booleana (opzionale)

‎TRUE‎: Il trasferimento è stato completato con successo.

«Codice di errore»

  • ‎0‎: Nessun errore

  • ‎1‎: Errore non specificato

  • ‎2‎: Annullamento della finestra di dialogo sui file

  • ‎3‎: Trasferimento di altri file in corso

  • ‎4‎: Errore durante il trasferimento dei file

  • ‎5‎: Annullamento per timeout

  • ‎6‎: Errore di lettura del file - Il file non è disponibile o non può essere letto.

  • ‎7‎: Nessun supporto del dispositivo per il trasferimento dei file

    Possibili cause:

  • CODESYS WebVisu: Il trasferimento di file non è possibile per impostazione predefinita.

  • Comunicazione con un controllore di versione < 3.5.11: Funzionalità non implementata.

  • Comunicazione con un controllore di versione >= 3.5.11: Trasferimento di file non attivato (descrizione del dispositivo).

    CONSIGLIO:

    CODESYS gestisce questa impostazione nelle impostazioni del progetto.

«Utilizzare i file di visualizzazione locali»

Requisiti: L'opzione è disponibile quando è stata specificata come direzione «Trasferire i file di visualizzazione al PLC».

  • _cds_icon_option_deactivated.png: Viene immediatamente visualizzata la finestra di dialogo di selezione dei file del sistema operativo (predefinita per un'azione di immissione creata di recente).

  • _cds_icon_option_black_activated.png: La finestra di dialogo per il trasferimento dei file, disponibile per impostazione predefinita, si apre e chiede di selezionare un file. È possibile adattare la finestra di dialogo.

    Suggerimento: È possibile che la finestra di dialogo venga visualizzata in una posizione scomoda e che il layout della finestra non corrisponda a quello dell'interfaccia della visualizzazione web.