Attività FTP - Rinomina file

Utilizzare l'attività FTP - Rinomina file per ridenominare e/o spostare un file in una directory diversa, durante il runtime.

La directory ridenominata dall'attività FTP - Rinomina file, è mostrata nei seguenti casi supportati: Per un progetto di esempio che utilizza un'attività FTP - Rinomina file, consultare Esempio di analisi dell'elenco di directory: Esempio di analisi dell'elenco di directory.

Link simbolico

L'attività FTP - Rinomina file supporta i link simbolici alle directory, se sono rispettate le seguenti condizioni: 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 - Rinomina file all'orchestrazione

  1. Creare o aprire un'orchestrazione. Viene visualizzata una rappresentazione grafica dell'orchestrazione.
  2. Selezionare la scheda Attività ed espandere la cartella FTP.
  3. Trascinare l'attività Rinomina file nell'orchestrazione.
  4. Selezionare l'attività. Viene visualizzato l'Elenco di controllo.

Creazione, selezione o modifica di un endpoint FTP

  1. Fare clic sull'attività Seleziona endpoint dall'Elenco di controllo e scegliere una delle seguenti azioni:
    • Selezionare un endpoint esistente:
      1. 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à".
      2. Selezionare un endpoint esistente e fare clic su OK. Passare alla procedura "Configurazione dell'attività"
    • Selezionare un endpoint esistente e modificarlo:
      1. Selezionare Sfoglia. Viene visualizzato Esplora progetto.
      2. 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à".
      3. Fare clic su Modifica. Viene visualizzato il pannello Modifica endpoint.
    • Creare un nuovo endpoint: Selezionare Nuovo. Viene visualizzato il pannello Crea endpoint.
  2. Creare o modificare un endpoint FTP: Creazione o modifica di un endpoint FTP

Configurazione dell'attività

  1. Selezionare l'attività Configura dall'Elenco di controllo. Viene visualizzato il pannello Configura.
  2. Configurare i campi in questo pannello, come descritto nella seguente tabella:
    Tabella 1.
    Campo Descrizione
    Rinomina  
    File denominato Questo campo non è utilizzato per questa attività. Specificare il nome del file da ridenominare, utilizzando il parametro di input fromFilename dell'attività Associa input.
    Da 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.
    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.
    Nuovo percorso Questo campo non è utilizzato per questa attività. Specificare il percorso completo, incluso il nuovo nome file e la nuova directory sul server FTP, in cui il dispositivo di integrazione inserisce il file che è stato spostato, mediante il parametro di input toPath dell'attività Associa input.
    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.
    Opzioni - Selezionare una delle seguenti opzioni per definire il funzionamento quando, nella directory di output specificata, esiste già un file con lo stesso nome:
    Sovrascrivere il file esistente se viene trovato un nome file duplicato Specifica, nel caso in cui il file già esista, di eliminarne il contenuto e di sostituirlo con i nuovi dati restituiti dall'attività.
    Generare un errore se viene trovato un file con nome duplicato Specifica, nel caso in cui il file già esista, di conservarne i dati originali, di restituire un errore e di non eseguire operazioni con i nuovi dati restituiti dall'attività.

Specifica delle opzioni dei tentativi

  1. Selezionare l'attività Riprova dall'Elenco di controllo. Viene visualizzato il pannello Riprova.
  2. 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 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 - Rinomina 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à

  1. 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à.
  2. È necessario associare una variabile ai seguenti parametri di input:
    • fromFilename - Durante un'azione di ridenominazione, tale parametro indica il nome originale del file da ridenominare.
    • toPath - Durante un'azione di ridenominazione, tale parametro specifica il percorso, incluso il nuovo nome della directory e il nuovo nome del file. Ad esempio, per specificare che il file venga spostato nella directory /output della directory root del server FTP utilizzando il nome file fileNewName.txt, specificare il seguente valore per toPath: /output/fileNewName.txt

      Tutti gli altri parametri di input sono facoltativi. Consultare Creazione di un'associazione per ottenere istruzioni generali sull'associazione.  

      Se i parametri di input elencati nella seguente tabella non vengono visualizzati nel pannello A attività del pannello Associa input, selezionare Associa > Mostra parametri facoltativi 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 Associa > Mostra parametri facoltativi 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 in cui il dispositivo di integrazione inserisce il file generato in questa attività, viene impostata, nell'attività Configura, sulla directory denominata output. Durante il runtime, il nome della directory: outputXML 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 inserito nella directory outputXML.

      Tabella 3.
      Nodo/Nome parametro di input Descrizione Sovrascrive l'impostazione nell'attività?
      fromDirectory Specifica la directory sul server FTP, da cui il dispositivo di integrazione acquisisce l'elenco di file. Il parametro di input directory sovrascrive il campo In directory dell'attività Configura.
      overwrite 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 - Elenca 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/timeout Specifica il nome host o l'indirizzo IP per il server FTP. 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 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 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.

Associazione dell'output dell'attività

  1. Selezionare l'attività Associa output nell'Elenco di controllo. Il parametro di output directoryListing o fileListing, viene visualizzato nel pannello Da attività.
  2. Associare il parametro di output directoryListing o fileListing ad una variabile. Consultare Creazione di un'associazione per ottenere istruzioni generali sull'associazione.

    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.