Durante il runtime, l'attività FTP - Acquisisci file si connette ad un server FTP e tenta l'acquisizione di un singolo file nell'ubicazione specificata. È possibile configurare l'attività FTP - Acquisisci file per restituire il contenuto del file in una variabile dell'orchestrazione. Inoltre, è possibile configurare l'attività FTP - Acquisisci file per restituire il valore data/ora del file restituito dal server FTP, in una variabile dell'orchestrazione.
Link simbolici a... | Link fissi | Link simbolici | Note |
---|---|---|---|
File | Non supportato | Non supportato | L'attività FTP - Acquisisci file non interpreta i link simbolici ai file come file e, quindi, i link simbolici ai file non vengono elaborati dall'attività FTP - Acquisisci file durante il runtime. |
Directory | Supportato | Supportato |
Campo | Descrizione |
---|---|
File denominato | Questo campo non è utilizzato per questa attività. Specificare il nome del file di output utilizzando il parametro di input filename dell'attività Associa input. |
Da directory | Specifica la directory sul server FTP, in cui il dispositivo di integrazione
inserisce il file generato in questa attività.
È possibile specificare una directory utilizzando una delle seguenti opzioni:
Nota: UNIX:
se si specifica un percorso di directory relativo quando si esegue la connessione ad un server FTP su una macchina UNIX, verificare che sia stata correttamente specificata la directory home FTP nel file /etc/password, per l'account utente che si connette al server FTP.
|
Di tipo | Specifica come leggere il contenuto del file - come dati binari o testo codificato. Se è selezionata l'opzione Testo, impostare il tipo di codifica mediante una delle seguenti
opzioni:
Attenzione: è necessario specificare l'opzione Trasferisci come testo (ASCII) per le attività FTP, quando si richiamano i file di testo e si inseriscono i file di testo su un server FTP per gli endpoint che intervengono sui dati testo, durante il trasferimento dei dati dall'/all'endpoint FTP in modalità ASCII. Ad esempio, gli endpoint FTP DOS e mainframe
intervengono sui dati ASCII quando i dati sono trasmessi in modalità ASCII.
Ad esempio, se l'orchestrazione richiama i file
ASCII mediante l'attività FTP - Esegui polling della directory e inserisce i file ASCII in un server FTP mainframe utilizzando l'attività FTP - Inserisci file, è necessario specificare le opzioni nelle seguenti attività in
Studio:
|
Campo | Descrizione |
---|---|
Riprova | |
1) Attendere __ secondo/i tra un tentativo e l'altro. | Il numero di secondi durante i quali il dispositivo di integrazione resta in attesa prima di provare a stabilire una connessione al server FTP. |
2) Tentare di connettersi__ volte prima di dare errore. | Specifica il conteggio dei tentativi - il numero massimo
di volte in cui il dispositivo di integrazione prova a
stabilire una connessione al server FTP, prima che venga visualizzato un errore e l'elaborazione
del lavoro di orchestrazione corrente venga arrestata. Se si distribuisce un'orchestrazione che contiene un'attività FTP - Acquisisci file e il dispositivo di integrazione non riesce a connettersi al server FTP specificato, il dispositivo di integrazione registra gli errori di connessione come avvertenze nei log di sistema e dell'orchestrazione, fino al raggiungimento del valore relativo al numero di tentativi. Una volta raggiunto il numero di tentativi, il dispositivo di integrazione registra un errore nei log di sistema e dell'orchestrazione ed arresta l'elaborazione del lavoro di orchestrazione corrente. Ad esempio, se si imposta il numero di tentativi su 3, il primo, il secondo e il terzo errore di connessione vengono visualizzati nel log di sistema come avvertenze. Il dispositivo di integrazione registra il quarto errore di connessione come errore ed arresta l'elaborazione del lavoro di orchestrazione corrente. |
Se il parametro di input facoltativo elencato nella seguente tabella non viene visualizzato nel pannello A attività del pannello Associa input, selezionare Mostra parametri facoltativi. Se non è possibile selezionare l'opzione nel menu della barra degli strumenti, fare clic su un nodo nel pannello Associa input per attivare questa opzione.
dal menu della barra degli strumenti oppure fare clic con il tasto destro del mouse nel pannello A attività e selezionare l'opzioneFacoltativamente, è possibile sovrascrivere in modo dinamico le impostazioni specificate nelle attività Configura e Seleziona endpoint dell'Elenco di controllo durante il runtime, utilizzando i parametri di input definiti nella seguente tabella.
Ad esempio, la directory sul server FTP dove il dispositivo di integrazione acquisisce il file, viene impostata, nell'attività Configura, sulla directory denominata input. Durante il runtime, il nome della directory: inputXML viene trasmesso all'attività utilizzando il parametro di input directory. Il nome della directory specificato in modo dinamico durante il runtime, sovrascrive l'impostazione originale specificata nel pannello Configura. In questo esempio, il dispositivo di integrazione tenta di acquisire il file dalla directory inputXML.
Nodo/Nome parametro di input | Descrizione | Sovrascrive l'impostazione nell'attività? |
---|---|---|
directory | Specifica la directory sul server FTP, in cui il dispositivo di integrazione inserisce il file generato in questa attività. | Il parametro di input directory sovrascrive il campo Da directory dell'attività Configura. |
encoding | Specifica come vengono scritti nel file i dati in uscita:
|
Il parametro di input encoding sovrascrive la codifica specificata nel campo Di tipo dell'attività Configura, ma se è selezionata l'opzione Binario nel campo Di tipo dell'attività Configura, la codifica specificata dal parametro di input encoding viene ignorata. |
connection/timeout | Specifica il timeout di connessione - il numero di secondi, prima che si verifichi un timeout tra il tentativo del dispositivo di integrazione di stabilire una connessione all'endpoint e il tempo impiegato dall'endpoint per rispondere alla richiesta di connessione. Per l'attività FTP - Acquisisci file, l'intervallo di tempo in cui il dispositivo di integrazione tenta di stabilire una connessione al server FTP, prima che si verifichi il timeout. | Il nodo timeout del parametro di input connection sovrascrive il campo Timeout connessione -Timeout dopo ___ secondo/i quando si stabilisce una connessione con l'endpoint dell'endpoint FTP. |
connection/host | Specifica il nome host o l'indirizzo IP per il server FTP. | Il nodo host del parametro di input connection sovrascrive il campo Nome host dell'endpoint FTP. |
connection/port | Specifica il numero di porta per il nome host specificato. La porta standard per il traffico FTP è 21. La porta predefinita per il traffico SFTP è 22. | Il nodo port del parametro di input connection sovrascrive il campo Porta dell'endpoint FTP. |
connection/username | Specificare un nome utente per l'account utilizzato per la connessione al server FTP. | Il nodo username del parametro di input connection sovrascrive il campo Nome utente dell'endpoint FTP. |
connection/password | Specificare una password per l'account utilizzato per la connessione al server FTP. | Il nodo password del parametro di input connection sovrascrive il campo Password dell'endpoint FTP. |
Nome parametro di output | Descrizione |
---|---|
data | Contiene il contenuto del file. |
timestamp | Contiene il valore data/ora per il file restituito dal server FTP, tipicamente la data di creazione o dell'ultima modifica del file. |