Durante il runtime, l'attività FTP - Elenca file si connette ad un server FTP e genera un elenco di file dall'ubicazione di directory specificata, utilizzando l'espressione regolare specificata. L'attività FTP - Elenca file restituisce un elenco di file all'orchestrazione utilizzando il parametro di output directoryListing o fileListing.
Se la casella di spunta Elenca solo file (NLST) è deselezionata, viene restituito un elenco di directory completo che include autorizzazioni directory, valori data/ora e proprietà, nel parametro di output directoryListing come una singola stringa. Quando viene restituito un elenco di directory completo come una stringa, è necessario analizzare l'elenco di directory mediante uno schema di file flat con l'attività Leggi file flat. Se la casella di spunta Elenca solo file (NLST) è selezionata e l'attività FTP - Elenca file supporta il formato dell'elenco di directory per il server FTP, viene restituita una struttura di ripetizione di soli nomi file nel parametro di output fileListing. Quando viene restituita una struttura di ripetizione di nome file, non è necessario analizzare l'elenco di directory ed è possibile eseguire un'iterazione attraverso l'elenco mediante un'attività For Each o While Loop.
In alcuni casi, è necessario utilizzare l'attività FTP - Elenca file unitamente alle attività FTP - Acquisisci file, FTP - Inserisci file, FTP - Elimina file e FTP - Rinomina file, per elaborare un insieme di file rilevati in una directory FTP, mentre in altri casi, è possibile utilizzare solo l'attività FTP - Esegui polling della directory.
Link simbolici a... | Link fissi | Link simbolici | Note |
---|---|---|---|
File | Non supportato | Non supportato | L'attività FTP - Elenca file non interpreta i link simbolici ai file come file e, quindi, i link simbolici ai file non vengono elaborati dall'attività FTP - Elenca file durante il runtime. |
Directory | Supportato | Supportato |
Campo | Descrizione |
---|---|
In directory | Specifica la directory sul server FTP, in cui il dispositivo di integrazione
elimina il file specificato. È 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.
|
File denominato | Specifica un pattern o espressione regolare che definisce i nomi file da acquisire dal server FTP. L'elaborazione dell'espressione regolare viene effettuata dal server FTP. Per ulteriori
informazioni, consultare la documentazione del server FTP sulle espressioni regolari. Tipicamente, i server FTP
supportano i seguenti caratteri jolly nelle relative espressioni regolari:
Nota: poiché l'elaborazione dell'espressione regolare viene eseguita sul server FTP, la distinzione tra maiuscole e minuscole è determinata dal server FTP.
Se il server FTP è sensibile al maiuscolo/minuscolo, anche la corrispondenza del file eseguita dall'attività FTP - Esegui polling della directory è sensibile al maiuscolo/minuscolo.
|
Elenca solo file (NLST) | La casella di spunta Elenca solo file (NLST) determina il tipo di elenco di directory restituito dal pulsante Verifica e durante il runtime. Inoltre, questa casella di spunta definisce se il parametro di output fileListing o directoryListing viene visualizzato nell'attività Associa output e restituito dall'attività durante il runtime.
|
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 numero di tentativi - il numero massimo
di volte in cui il dispositivo di integrazione tenta di stabilire una connessione al server
FTP, prima che venga visualizzato un errore. Se un'orchestrazione che inizia con un'attività FTP - Elenca file viene distribuita e il dispositivo di integrazione non riesce a connettersi al server FTP specificato, il dispositivo di integrazione registra gli errori di connessione come avvertenze nel log di sistema fino al raggiungimento del valore del numero di tentativi. Una volta raggiunto il numero dei tentativi, il dispositivo di integrazione registra un errore nel log di sistema, reimposta il numero degli errori di connessione su zero e continua a tentare di stabilire una connessione con il server FTP. 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 un errore e reimposta il numero degli errori di connessione su zero. Pertanto, il quinto errore di connessione genera un'avvertenza nel log di sistema. Il dispositivo di integrazione continua a tentare di stabilire una connessione al server FTP. |
Se i parametri di input elencati nella seguente tabella non vengono visualizzati 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 l'elenco di 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, l'elenco di file è generato 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 In directory dell'attività Configura. |
connection/timeout | Specifica l'intervallo di tempo, in secondi, che deve trascorrere tra il tentativo del dispositivo di integrazione di stabilire una connessione con l'endpoint e la risposta dall'endpoint alla richiesta di connessione, prima che si verifichi un timeout. Per l'attività FTP - Elimina 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. |
Durante il runtime, l'attività FTP - Elenca file restituisce l'elenco di file all'orchestrazione, utilizzando il parametro di output directoryListing o fileListing.
Se la casella di spunta Elenca solo file (NLST) è deselezionata nell'attività Configura, viene restituito un elenco di directory completo che include autorizzazioni directory, valori data/ora e proprietà, nel parametro di output directoryListing come una singola stringa. Quando viene restituito un elenco di directory completo come una stringa, è necessario analizzare l'elenco di directory mediante uno schema di file flat con l'attività Leggi file flat. È possibile creare uno schema di file flat utilizzando l'Editor schema file flat. Per un'orchestrazione di esempio di analisi di un elenco di directory mediante uno schema di file flat, consultare l'Esempio di analisi dell'elenco di directory: Esempio di analisi dell'elenco di directory.
Se la casella di spunta Elenca solo file (NLST) è selezionata e l'attività FTP - Elenca file supporta il formato dell'elenco di directory per il server FTP, viene restituita una struttura di ripetizione di soli nomi file nel parametro di output fileListing. Quando viene restituita una struttura di ripetizione di nome file, non è necessario analizzare l'elenco di directory ed è possibile eseguire un'iterazione attraverso l'elenco mediante un'attività For Each o While Loop.