Attività FTP - Inserisci file

Durante il runtime, l'attività FTP - Inserisci file acquisisce i dati dalle variabili dell'orchestrazione, li inserisce in un file, si connette ad un server FTP e inserisce il file nell'ubicazione di directory specificata.

Per un esempio di utilizzo dell'attività FTP - Inserisci file, consultare il manuale Getting Started Guide.

Interruzione del trasferimento

Il trasferimento file eseguito dall'attività FTP - Inserisci file durante il runtime, non è di tipo transazione e, quindi, non è garantito. Ad esempio, se un'attività FTP - Inserisci file trasferisce un file dal dispositivo di integrazione ad un server FTP e il trasferimento del file viene interrotto perché il dispositivo di integrazione viene riavviato, non si garantisce che venga trasferito l'intero file.

Link simbolico

L'attività FTP - Inserisci file supporta i link simbolici alle directory, se i link simbolici alle directory sono supportati dal sistema operativo in cui risiede il server FTP e 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 - Inserisci 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à Inserisci file sull'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 di configurazione dell'attività.
      2. Selezionare un endpoint esistente e fare clic su OK. Passare alla procedura "Configura l'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

Specifica delle regole di consegna

  1. Selezionare l'attività Regole di consegna dall'Elenco di controllo. Viene visualizzato il pannello Regole di consegna. Se per l'endpoint FTP non è abilitata la sicurezza, vengono abilitate le opzioni Trasferisci come testo (ASCII) e Trasferisci come binario (BINARY). Se per l'endpoint FTP è abilitata la sicurezza, il tipo di trasferimento file è sempre binario.
  2. Selezionare il tipo di trasferimento file tra il dispositivo di integrazione e il server FTP da una delle seguenti opzioni:
    • Trasferisci come testo (ASCII) - Il dispositivo di integrazione trasferisce al server FTP solo sette bit di ogni carattere nel file. Questa opzione è utilizzata per trasferire i file ASCII come i file di testo e i file HTML.
      Avvertenza:
      l'uso di questa opzione con i file binari può comportare la perdita di dati.
    • Trasferisci come binario (BINARIO) - Il dispositivo di integrazione trasferisce al server FTP tutti gli otto bit di ogni byte nel file. Questa opzione è utilizzata per trasferire i file binari.
    Nota: l'impostazione della modalità di trasferimento nell'attività Regole di consegna, equivale ad impostare la modalità di trasferimento mediante una sessione della riga comandi con un server FTP utilizzando i seguenti comandi:
    • ascii
    • binary

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
    Salva  
    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.
    In 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:
    • Immettere direttamente il percorso di directory, facendo clic nel campo e immettendo uno dei seguenti percorsi di directory:
      • Percorso di directory relativo, ad esempio: /output.  (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/output.
    • 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.
    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:
    • Dall'elenco a discesa codificato con, selezionare uno dei tipi di codifica predefiniti.  
    • Immettere il tipo di codifica direttamente, facendo clic nel campo codificato con e digitando il tipo di codifica.
    Nota: alcuni caratteri double-byte non vengono convertiti mediante la codifica SHIFT-JIS. Per ulteriori informazioni, consultare Utilizzo della codifica Shift-JIS.
    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:
    • Nell'attività Configura di un'attività FTP - Esegui polling della directory, per il campo Di tipo selezionare l'opzione Testo.
    • Nell'attività Regole di consegna di un'attività FTP - Esegui polling della directory, per il campo Tipo di trasferimento file selezionare l'opzione Trasferisci come testo (ASCII).
    • Nell'attività Configura di un'attività FTP - Inserisci file, per il campo Di tipo selezionare l'opzione Testo.
    • Nell'attività Regole di consegna di un'attività FTP - Inserisci file, per il campo Tipo di trasferimento file selezionare l'opzione Trasferisci come testo (ASCII).
    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à.
    Accodare al file esistente Specifica, nel caso in cui il file già esista, di conservarne i dati originali e di accodare i nuovi dati (restituiti dall'attività) alla fine del file.
    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 - Inserisci 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. Non è necessario associare tutti i parametri di input dell'attività. Sono richiesti i seguenti parametri:
    • filename
    • data
Tutti gli altri parametri sono facoltativi. Per istruzioni generiche relative all'associazione, consultare Creazione di un'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à?
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.
encoding Specifica come vengono scritti nel file i dati in uscita:
  • Se non è richiesta alcuna codifica, specificare la stringa: binario.
  • Se la codifica è richiesta, specificare il tipo di codifica che deve essere utilizzato per codificare i dati in uscita, ad esempio: UTF-8, US-ASCII, ISO_8859-1, EBCDIC-US o SHIFT-JIS.
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.
overwrite Specifica il funzionamento, quando nella directory di output specificata, esiste già un file con lo stesso nome. Specificare uno dei seguenti valori:
  • y - Specifica, nel caso in cui il file già esista, di eliminarne il contenuto e di sostituirlo con i nuovi dati restituiti dall'attività.
  • a - Specifica, nel caso in cui il file già esista, di conservarne i dati originali e di accodare i nuovi dati (restituiti dall'attività) alla fine del file.
  • n - Specifica, nel caso in cui il file già esista, di conservarne i dati originali e di non eseguire operazioni con i nuovi dati restituiti dall'attività.
Il parametro di input overwrite sovrascrive il campo Opzioni dell'attività Configura.
connection/timeout Specifica il timeout di connessione - 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 dall'endpoint alla richiesta di connessione, prima che si verifichi un timeout. Per l'attività FTP - Inserisci 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.