Attività FTP - Acquisisci file

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.

L'attività FTP - Acquisisci file è diversa dall'attività FTP - Esegui polling della directory nei seguenti modi:

Link simbolico

Il supporto per i link simbolici dell'attività FTP - Acquisisci file durante il runtime, dipende dai seguenti fattori: 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 - Acquisisci 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à Acquisisci 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 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 tutti i campi in questo pannello, come descritto nella seguente tabella:
    Tabella 2.
    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:
    • 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.
    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).

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. Nella seguente tabella vengono definite le opzioni dei tentativi per una connessione ad un server FTP:
    Tabella 3.
    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.

Associazione dell'input all'attività

  1. Selezionare l'attività Associa input nell'Elenco di controllo. I parametri di input dell'attività vengono visualizzati nel pannello A attività.
  2. Il parametro filename è l'unico parametro che è necessario fornire come valore nell'attività. Tutti gli altri parametri sono facoltativi. Il parametro filename specifica il nome del file da acquisire dal server FTP. Fornire un valore per il parametro filename, creando un link dal parametro di input filename ad una variabile oppure definendo un valore predefinito per il parametro di input filename.

    Se il parametro di input facoltativo elencato nella seguente tabella non viene visualizzato 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 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.

Tabella 4.
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:
  • 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.
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.

Associazione dell'output dell'attività

  1. Selezionare l'attività Associa output nell'Elenco di controllo. I parametri di output dell'attività vengono visualizzati nel pannello Da attività, come descritto nella seguente tabella:
    Tabella 5.
    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.  
  2. Associare i parametri di output desiderati alle variabili.