FB_FtpClient
Task
Il blocco funzione FB_FtpClient è dedicato alle connessioni FTP non protette. Include le funzionalità FTP correlate per le operazioni su file e directory. Ogni istanza gestisce una connessione FTP non protetta. Nel caso in cui si tenti di stabilire un secondo trasferimento, il blocco funzione risponde con ET_Result.UnableToEstablishMutlipleConnections.
Descrizione funzionale
Il blocco funzione FB_FtpClient è l'interfaccia utente per l'interazione con il server FTP esterno tramite una connessione non protetta.
Dopo l'abilitazione del blocco funzione, viene stabilita una connessione FTP non protetta utilizzando le credenziali utente inviate mediante iq_stCredentials. Non appena viene stabilita la connessione non protetta, il blocco funzione è in grado di elaborare i comandi inviati da i_etCommand e un fronte di salita rilevato a i_xExecute.
Finché vengono eseguiti i comandi, l'uscita q_xBusy è impostata su TRUE. Dopo il completamento di un comando, q_xDone è impostato su TRUE.
Messaggi di stato e informazioni di diagnostica vengono forniti tramite le uscite q_xError (TRUE se è stato rilevato un errore), q_etResult e q_etResultMsg.
Per riconoscere gli errori rilevati, disattivare e riattivare il blocco funzione affinché sia in grado di inviare un comando.
Quando si disabilita il blocco funzione (i_xEnable = FALSE), questo deve essere chiamato se q_xActive = TRUE per completare le routine di pulizia interna. In seguito può essere riattivato.
Se viene superato un timeout dopo aver stabilito la connessione, l'esecuzione del successivo comando FTP (ET_FtpCommand) viene rilevato come un errore. Per evitare questo comportamento, attivare il blocco funzione poco prima di eseguire le operazioni correlate e disattivarlo dopo.
Interfaccia
|
Ingresso |
Tipo di dati |
Descrizione |
|---|---|---|
|
i_xEnable |
BOOL |
Attivazione e inizializzazione del blocco funzione. Fare riferimento a Comportamento dei blocchi funzione con gli ingressi i_xEnable e i_xExecute. |
|
i_xExecute |
BOOL |
Il comando specificato con l'ingresso i_etCommand viene eseguito sul fronte di salita di tale ingresso. Fare riferimento a Comportamento dei blocchi funzione con gli ingressi i_xEnable e i_xExecute. |
|
i_etCommand |
ET_FtpCommand |
Il comando FTP eseguito se l'ingresso i_xExecute è TRUE. |
|
Ingresso/uscita |
Tipo di dati |
Descrizione |
|---|---|---|
|
iq_stCredentials |
ST_Credentials |
Utilizzato per passare la struttura contenente le impostazioni utente, ad esempio nome utente o password. |
|
iq_stContent |
ST_Content |
Utilizzato per passare la directory di lavoro e, se applicabile, la quantità e i nomi dei file in questa directory. |
|
Uscita |
Tipo di dati |
Descrizione |
|---|---|---|
|
q_xActive |
BOOL |
Se il blocco funzione è attivo, l'uscita è impostata su TRUE. |
|
q_xReady |
BOOL |
Se l'inizializzazione riesce, l'uscita viene impostata su TRUE finché il blocco funzione è in grado di accettare ingressi. |
|
q_xBusy |
BOOL |
Se si imposta questa uscita su TRUE, il blocco funzione esegue il comando specificato in i_etCommand. |
|
q_xDone |
BOOL |
Se si imposta questa uscita su TRUE, il blocco funzione ha correttamente eseguito il comando specificato in i_etCommand. |
|
q_xError |
BOOL |
Se questa uscita è impostata su TRUE, è stato rilevato un errore. Per informazioni, consultare q_etResult e q_etResultMsg. |
|
q_etResult |
ET_Result |
Fornisce informazioni di stato e di diagnostica. |
|
q_sResultMsg |
STRING[255] |
Fornisce informazioni di stato e diagnostica aggiuntive. |