Utilizzare l'attività FTP - Elimina file per eliminare file specifici da directory specifiche, durante il runtime.
Solitamente, l'attività
FTP - Elimina file è utilizzata unitamente all'attività
FTP - Elenca file, come mostrato nella seguente orchestrazione di esempio:
- L'attività Pianifica lavoro crea un lavoro di orchestrazione ogni ora.
- L'attività FTP - Elenca file genera un elenco di file presenti nella directory \temp, ubicata nella directory root del server FTP, e memorizza il risultato in una stringa.
- L'attività Leggi file flat analizza l'elenco di file e memorizza il risultato in una struttura XML di ripetizione.
- L'attività For Each compie un'iterazione attraverso la
struttura di ripetizione che contiene l'elenco di file:
- Se il file ha un'estensione .tmp, l'attività FTP - Elimina file elimina il file specificato.
Per un progetto di esempio che utilizza un'attività
FTP - Elimina file, consultare
Esempio di analisi dell'elenco di directory.
Link simbolico
L'attività
FTP - Elimina file supporta i link simbolici alle directory, se sono rispettate le seguenti condizioni:
- Se i link simbolici alle directory sono supportati dal sistema operativo in cui risiede il server FTP.
- Se i link simbolici alle directory sono supportati dal server FTP stesso.
Per determinare se un particolare link simbolico è supportato su un server FTP e un sistema operativo specifici, consultare la documentazione relativa al sistema operativo e al server FTP.
Aggiunta di un'attività FTP - Elimina file all'orchestrazione
- Creare o aprire un'orchestrazione. Viene visualizzata una rappresentazione grafica
dell'orchestrazione.
- Selezionare la scheda Attività ed espandere la cartella FTP.
- Trascinare l'attività Elimina file sull'orchestrazione.
- Selezionare l'attività. Viene visualizzato l'Elenco di controllo.
Creazione, selezione o modifica di un endpoint FTP
- Fare clic sull'attività Seleziona endpoint dall'Elenco di controllo e
scegliere una delle seguenti azioni:
- Selezionare un endpoint esistente:
- Selezionare Sfoglia. Viene visualizzato Esplora progetto.
Attenzione: se si specifica un nuovo endpoint FTP con una struttura di directory diversa dall'endpoint FTP originale, il lavoro di orchestrazione può avere esito negativo durante il runtime. È necessario specificare un nuovo server FTP che corrisponda alla struttura di directory del server FTP specificato originariamente oppure modificare la directory configurata del campo
In directory, facendo clic su Sfoglia, come descritto di seguito nella procedura "Configurazione dell'attività".
- Selezionare un endpoint esistente e fare clic su OK.
Passare alla procedura "Configurazione dell'attività".
- Selezionare un endpoint esistente e modificarlo:
- Selezionare Sfoglia. Viene visualizzato Esplora progetto.
- Selezionare un endpoint esistente e fare clic su OK.
Attenzione: se si specifica un nuovo endpoint FTP con una struttura di directory diversa dall'endpoint FTP originale, il lavoro di orchestrazione può avere esito negativo durante il runtime. È necessario specificare un nuovo server FTP che corrisponda alla struttura di directory del server FTP specificato originariamente oppure modificare la directory configurata del campo
In directory, facendo clic su Sfoglia, come descritto di seguito nella procedura "Configurazione dell'attività".
- Fare clic su Modifica. Viene visualizzato il
pannello Modifica endpoint.
- Creare un nuovo endpoint: Selezionare Nuovo. Viene visualizzato il pannello
Crea endpoint.
- Creare o modificare un endpoint FTP: Creazione o modifica di un endpoint FTP
Configurazione dell'attività
- Selezionare l'attività Configura dall'Elenco di controllo. Viene visualizzato il pannello Configura.
- Configurare i campi in questo pannello, come descritto nella seguente
tabella:
Tabella 1. Campo |
Descrizione |
Cerca |
|
File denominato |
Questo campo non è utilizzato per questa attività. Il nome del file da eliminare viene specificato utilizzando il parametro di input filename dell'attività Associa input. |
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:- Immettere direttamente il percorso di directory, facendo clic nel campo e immettendo uno dei seguenti percorsi di directory:
- Percorso di directory relativo, ad esempio: /process.
(Presume che la directory home FTP sia stata configurata per l'account utente che si connette al server FTP. Per ulteriori informazioni, consultare la nota riportata di seguito.)
- Percorso di directory completo, ad esempio su una macchina UNIX: /home/user/process.
- Fare clic su Sfoglia... per popolare l'elenco a discesa di directory disponibili. Selezionare la directory appropriata dall'elenco a discesa.
Durante il runtime, il valore specificato nel campo In directory dell'attività Configura, viene sovrascritto se viene fornito un valore per il parametro di input facoltativo directory, mediante una delle seguenti
opzioni: - Il parametro di input directory viene associato ad una variabile.
- Viene fornito un valore predefinito per il parametro di input directory.
Per ulteriori
informazioni, consultare la procedura "Associazione dell'input dell'attività".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.
|
Specifica delle opzioni dei tentativi
- Selezionare l'attività Riprova dall'Elenco di controllo. Viene visualizzato il pannello Riprova.
- Configurare le opzioni dei tentativi per la connessione ad un server FTP. La seguente tabella
descrive le opzioni dei tentativi per la connessione ad un server FTP:
Tabella 2. 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 massimo di tentativi di stabilire una connessione
al server FTP eseguiti dal dispositivo di integrazione, prima che venga
visualizzato un errore e che l'elaborazione del lavoro di orchestrazione
corrente venga interrotta. Se si distribuisce un'orchestrazione che contiene un'attività FTP - Elimina 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.
|
Associazione dell'input dell'attività
- Selezionare l'attività Associa input
nell'Elenco di controllo. Viene visualizzato il pannello Riprova. I parametri di input
dell'attività vengono visualizzati nel pannello A attività.
- È necessario associare una variabile al parametro di input filename. Tutti gli altri parametri di input sono facoltativi. Il parametro filename specifica il nome del file da eliminare nel server FTP.
Se i parametri di input elencati nella seguente tabella non
vengono visualizzati nel pannello A attività del
pannello Associa input, selezionare dal menu della barra degli strumenti oppure fare clic con il tasto destro del mouse
nel pannello A attività e selezionare l'opzione 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.
Facoltativamente, è 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
elimina il file, viene impostata, nell'attività Configura, sulla directory denominata process. Durante il runtime, il nome della directory: processXML 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 file viene eliminato dalla directory processXML.
Tabella 3. 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
all'endpoint e la risposta dell'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. |