Configurazione dell'adapter FTP

Prima di iniziare

• L'adapter FTP supporta la lettura e la scrittura di dati da un server FTP sicuro. e il trasferimento di file da un server FTP tramite Secure Sockets Layer (SSL)/Transport Layer Security (TLS).
• L'adapter FTP supporta il download di file da percorsi di file di sola lettura.
• L'adattatore FTP supporta anche il trasferimento di file atomico per la modalità ASCII.

Vedere Procedure consigliate e raccomandazioni per l'adapter FTP.

Configurare il percorso di ricezione

È possibile impostare le proprietà dell'adapter di ricezione FTP nella console di amministrazione di BizTalk Server. Se le proprietà non sono impostate nel percorso di ricezione, vengono usati i valori predefiniti del gestore di ricezione nella console di amministrazione BizTalk Server.

2. Nel riquadro sinistro fare clic sul nodo Porte di ricezione . Nel riquadro destro fare clic con il pulsante destro del mouse sulla porta di ricezione associata a un percorso di ricezione esistente o che si vuole associare a una nuova posizione di ricezione e quindi fare clic su Proprietà.

3. Nella finestra di dialogo Proprietà porta di ricezione selezionare Posizioni di ricezione nel riquadro sinistro. Nel riquadro destro fare doppio clic su un percorso di ricezione esistente oppure scegliere Nuovo per creare una nuova posizione di ricezione.

4. Nella finestra di dialogo Proprietà percorso di ricezione , nella sezione Trasporto accanto a Tipo selezionare FTP dall'elenco a discesa e quindi fare clic su Configura.

5. In Proprietà trasporto FTP eseguire le operazioni seguenti:

   Batch

   Usare	Per
   Numero massimo di file	Specificare il numero massimo di file per ogni batch di BizTalk Server. Zero (0) indica che non è definito alcun limite. Valore predefinito: 0
   Dimensioni massime	Specificare il numero massimo di byte per ogni batch di BizTalk Server. Zero (0) indica che non è definito alcun limite. Valore predefinito: 0

   Firewall

   Usare	Per
   Indirizzo	Specificare l'indirizzo del firewall, vale a dire il nome DNS o l'indirizzo IP.
   Modalità	Specificare la modalità utilizzata dall'adapter per la connessione al server FTP. Valori validi: Passivo e attivo In modalità attiva il server FTP si connette a una porta aperta dall'adapter FTP, mentre in modalità passiva l'adapter FTP si connette a una porta aperta dal server FTP. La modalità attiva potrebbe non funzionare se si usa un INDIRIZZO IP interno e si connette a un INDIRIZZO IP esterno. In questo caso, è necessario usare la modalità passiva o la modalità Attiva con un gateway a livello di applicazione con supporto FTP. Valore predefinito: Attivo
   Password	Specificare la password per il firewall.
   Porta	Specificare la porta per il firewall. Valori validi: da 1 a 65535 inclusivo Valore predefinito: 21
   Tipo	Specificare il tipo di firewall distribuito. Valori validi: Nessuno, Calze 4 e Calzini 5 Valore predefinito: Nessuno
   Utente	Specificare il nome utente per il firewall.

   FTP

   Usare	Per
   Account	Specificare il nome account per il server FTP. Questa opzione è deprecata e l'uso di questa proprietà è sconsigliato.
   Dopo GET	Specificare i comandi FTP da eseguire dopo file GET. Separare i comandi con un punto e virgola (;).
   Prima di GET	Specificare i comandi FTP da eseguire prima di file GET. Separare i comandi con un punto e virgola (;). Nota: Il comando QUIT non è supportato prima del file GET.
   Soglia di errore	Specificare il numero di errori tollerati da BizTalk Server prima che l'indirizzo venga disattivato. Valore predefinito: 10
   Maschera di file	Specificare il filtro file da utilizzare per la trasmissione dei file.
   Cartella	Specificare l'indirizzo di polling sul server FTP.
   Tipo di server FTP	Novità a partire da BizTalk Server 2016. Usare questa proprietà per scegliere un server FTP che non richiede il comando SYST. Le opzioni sono Nessuno, AIX, Rileva, GXS, MVS, OS400 e Altro. Se impostato su Nessuno, viene usato il comando SYST. L'altro viene usato quando il tipo di sistema operativo non rientra in nessuna delle categorie specificate. Valore predefinito: Nessuno
   File di log	Specificare il percorso completo, incluso il nome file del file di log a cui eseguire l'output. Utilizzare questo file per diagnosticare le condizioni di errore durante l'invio o la ricezione di file tramite FTP.
   Dimensioni massime file	Specificare le dimensioni massime del file scaricabile, in MB. Zero (0) indica che non vi sono limiti alle dimensioni del file. Valore predefinito: 100
   Password	Specificare la password utente per l'accesso al server FTP.
   Porta	Specificare l'indirizzo della porta per il server FTP. Valore predefinito: 21
   Rappresentazione	Selezionare la modalità di ricezione dei dati da parte del server FTP. Valori validi: binario o ASCII Valore predefinito: binario
   Server	Specificare il nome del server o l'indirizzo IP del server FTP. Nota: L'URI per una porta di invio o una posizione di ricezione non può superare i 256 caratteri.
   Applicazione affiliata SSO	Specificare l'applicazione affiliata Enterprise Single Sign-On.
   Usa elenco nomi (NLST)	Specificare il modo in cui i file vengono elencati dall'adapter. Per visualizzare i nomi file invece dell'elenco di file definito dal sistema, impostare questo valore su Sì. Valore predefinito: No
   Nome utente	Specificare il nome utente per l'accesso al server FTP.

   Polling

   Usare	Per
   Elimina dopo il download	Specificare se l'adapter elimina un file dal server FTP dopo il download. Valore predefinito: Nota sì :
   Abilita confronto timestamp	Specificare se l'adapter scarica di nuovo un file in base al relativo timestamp modificato. Qualora l'adapter non disponga delle autorizzazioni per l'eliminazione sul server FTP, il comando MDTM (Modification Time) consente all'adapter di sapere se un file è stato modificato dall'ultimo download. In base al valore di questa proprietà, il file viene scaricato nuovamente. Valore predefinito:Nessuna nota: nel caso in cui il server FTP non supporti MDTM, impostare la proprietà Intervallo di download . Nota: Questa proprietà è applicabile solo quando Delete After Download è impostato su No.
   Interval	Specificare il numero di intervalli per il polling dell'indirizzo. Per eseguire il polling in modo continuativo, impostare questo valore su 0 (zero). Valore predefinito: 60
   Intervallo di ripetizione download	Specificare l'intervallo di attesa prima del nuovo download del file da parte dell'adapter. Questa proprietà è applicabile solo quando sia Delete After Download che Enable Timestamp Comparison sono impostati su No. Valore predefinito: -1 Il valore -1 indica che l'adapter non scaricherà di nuovo i file. Il valore 0 indica che l'adapter scaricherà il file a ogni ciclo di polling.
   Unità	Specificare il tipo di unità per le proprietà Intervallo e Redownload Interval . Valori validi: Secondi, minuti, ore e giorni Valore predefinito: Secondi

   SSL

   Usare	Per
   Hash del certificato client	Specificare l'hash SHA1 del certificato client da usare nella negoziazione Secure Sockets Layer (SSL). In base all'hash specificato, il certificato client viene prelevato dall'archivio personale dell'account utente in cui è in esecuzione l'istanza host BizTalk.
   Modalità connessione FTPS	Specificare la modalità di connessione SSL al server FTPS. Valori validi: Implicito o esplicito Valore predefinito: Esplicito
   Usare la protezione dati	Specificare Sì se l'adapter deve usare la crittografia SSL durante l'invio e la ricezione di file di dati dal server FTPS. Specificare No per consentire all'adapter di inviare e ricevere file di dati come testo non crittografato. Nota: Questa proprietà è applicabile solo se la proprietà Use SSL è impostata su Sì. Valori validi: Sì o No Valore predefinito: Sì
   Usa SSL	Specificare se l'adapter FTP deve usare SSL per comunicare con il server FTPS. Valori validi: Sì o No Valore predefinito: No

   Parametri di ottimizzazione

   Usare	Per
   Timeout ricezione dati	Specificare il tempo in millisecondi prima che la chiamata di ricezione venga interrotta. Questa proprietà viene utilizzata per impedire che un server lento provochi il blocco delle risposte da parte dell'indirizzo di ricezione. Valore predefinito: 90000
   Cartella temporanea	Specificare il percorso della cartella temporanea. Utilizzare questo indirizzo per garantire il ripristino a seguito di un errore di trasferimento.

6. Fare clic su OK per salvare le impostazioni.

7. Nella finestra di dialogo Proprietà percorso di ricezione immettere i valori appropriati per completare la configurazione della posizione di ricezione e quindi fare clic su OK per salvare le impostazioni. Per informazioni sulla finestra di dialogo Proprietà indirizzo di ricezione , vedere Come creare un indirizzo di ricezione.

Configurare la porta di invio

È possibile impostare le proprietà dell'adattatore di porta di trasmissione FTP nella console di amministrazione di BizTalk Server. Se le proprietà non sono impostate per la porta di invio, vengono usati i valori predefiniti del gestore di invio nella console di amministrazione di BizTalk Server.

1. Nella Console di amministrazione BizTalk Server creare una nuova porta di trasmissione oppure fare doppio clic su una porta di trasmissione esistente per modificarla. Vedere Come creare una porta di trasmissione. Configurare tutte le opzioni di porta di invio e nella sezione Trasporto della pagina Generale specificare FTP per l'opzione Tipo .

2. Nella sezione Trasporto della pagina Generale fare clic sul pulsante Configura accanto a Tipo.

3. In Proprietà trasporto FTP eseguire le operazioni seguenti:

   Firewall

   Usare	Per
   Indirizzo	Specificare l'indirizzo del firewall, vale a dire il nome DNS o l'indirizzo IP.
   Modalità	Selezionare la modalità usata dall'adapter per la connessione al server FTP. Valori validi: Passivo e attivo In modalità attiva il server FTP si connette a una porta aperta dall'adapter FTP, mentre in modalità passiva l'adapter FTP si connette a una porta aperta dal server FTP. La modalità attiva potrebbe non funzionare se si usa un INDIRIZZO IP interno e si connette a un INDIRIZZO IP esterno. In questo caso, è necessario usare la modalità passiva o la modalità Attiva con un gateway a livello di applicazione con supporto FTP. Valore predefinito: Attivo
   Password	Specificare la password per il firewall.
   Porta	Specificare la porta per il firewall. Valori validi: da 1 a 65535 inclusi Valore predefinito: 21
   Tipo	Selezionare il tipo di firewall distribuito. Valori validi: Calzini 4, Calzini 5, Nessuno Valore predefinito: Nessuno
   Utente	Specificare il nome utente per il firewall.

   FTP

   Usare	Per
   Account	facoltativo. Specificare il nome account per il server FTP. Tale opzione è obsoleta e l'uso di questa proprietà è sconsigliato.
   Dopo PUT	Specificare i comandi FTP da eseguire dopo file PUT. Separare i comandi con un punto e virgola (;).
   Alloca spazio di archiviazione	Specificare se allocare spazio di archiviazione per i sistemi host precedenti. Questa proprietà viene fornita per la compatibilità con le versioni precedenti. Valori validi: No e Sì Valore predefinito: No
   Prima di PUT	Specificare i comandi FTP da eseguire prima di file PUT, ad esempio i comandi per modificare i valori predefiniti nel server FTP. Separare i comandi con un punto e virgola (;). Non è necessario un comando di apertura. Nota: Il comando QUIT non è supportato prima del file PUT.
   Cartella	Specificare l'indirizzo per lo spostamento dei file nel server FTP.
   Tipo di server FTP	Novità a partire da BizTalk Server 2016. Utilizzare questa proprietà per scegliere un server FTP che non richiede il comando SYST. Le opzioni sono None, AIX, Detect, GXS, MVS, OS400 e Other. Se impostato su Nessuno, viene usato il comando SYST. L'altro viene usato quando il tipo di sistema operativo non rientra in nessuna delle categorie specificate. Valore predefinito: Nessuno
   File di log	Specificare il percorso completo, incluso il nome file del file di log in cui restituire l'output. Usare questo file per diagnosticare le condizioni di errore durante l'invio o la ricezione di file tramite l'adapter FTP.
   Password	Specificare la password per l'accesso al server FTP.
   Porta	Specificare l'indirizzo della porta per il server FTP. Valore predefinito: 21
   Rappresentazione	Selezionare le modalità di trasmissione dei dati dell'adapter FTP, come binari o come ASCII Valori validi: binario o ASCII Valore predefinito: binary
   Server	Specificare il nome del server o l'indirizzo IP del server FTP.
   Applicazione affiliata SSO	Specificare l'applicazione affiliata Enterprise Single Sign-On.
   Nome file di destinazione	Specificare un nome alternativo per il file. Se si mantiene il nome predefinito, si garantiscono nomi di messaggio univoci per ogni messaggio inviato. Valore predefinito: %MessageID%.xml
   Nome utente	Specificare il nome utente per l'accesso al server FTP.

   SSL

   Usare	Per
   Hash del certificato client	Specificare l'hash SHA1 del certificato client da usare nella negoziazione Secure Sockets Layer (SSL). In base all'hash specificato, il certificato client viene prelevato dall'archivio personale dell'account utente in cui è in esecuzione l'istanza host BizTalk.
   Modalità connessione FTPS	Specificare la modalità di connessione SSL al server FTPS. Valori validi: Implicito o Esplicito Valore predefinito: Esplicito
   Usare la protezione dati	Specificare Sì se l'adapter deve usare la crittografia SSL durante l'invio e la ricezione di file di dati dal server FTPS. Specificare No per consentire all'adapter di inviare e ricevere file di dati come testo non crittografato. Nota: Questa proprietà è applicabile solo se la proprietà Use SSL è impostata su Sì. Valori validi: Sì o No Valore predefinito: Sì
   Usa SSL	Specificare se l'adapter FTP deve usare SSL per comunicare con il server FTPS. Valori validi: Sì o No Valore predefinito: No

   Parametri di ottimizzazione

   Usare	Per
   Limite di connessioni	Specificare il numero massimo di connessioni FTP simultanee al server. Il valore 0 indica l'assenza di limiti. Valore predefinito: 0 Nota: questa proprietà sostituisce la voce del Registro di sistema usata nelle versioni precedenti di BizTalk Server per gestire il limite di connessione. BizTalk Server ignora la voce del Registro di sistema utilizzata per controllare il limite di connessione.
   Cartella temporanea	Specificare il percorso di una cartella temporanea nel server FTP in cui il file viene caricato prima di essere spostato nella cartella di destinazione FTP. In caso di errore di trasferimento, l'adapter riavvia il caricamento del file nella modalità ASCII di trasferimento e riprende nella modalità binaria di trasferimento. Nota: Se il trasferimento di file è atomico tra il percorso temporaneo e il percorso pertinente nel server FTP, anche il caricamento del file è atomico.

4. Fare di nuovo clic su OK e su OK per salvare le impostazioni.

Comandi FTP richiesti dall'adapter FTP

L'adapter FTP è soggetto alle limitazioni del protocollo FTP e rende obbligatoria la disponibilità di determinati comandi FTP nel server di origine o di destinazione.

L'adattatore FTP funziona come client FTP e potrebbe richiedere che i comandi seguenti siano disponibili nel server FTP per funzionare correttamente:

Per altre informazioni su questi comandi FTP, vedere:

• RFC 959 - Protocollo di trasferimento file (https://go.microsoft.com/fwlink/p/?LinkId=119603)

• RFC 4217 - Protezione di FTP con TLS (https://go.microsoft.com/fwlink/p/?LinkId=183154)

• RFC 3659 - Estensioni a FTP (https://go.microsoft.com/fwlink/p/?LinkId=183155)

Configurazione di un adattatore FTP per l'uso con host legacy

Queste sezioni illustrano ciò che è necessario conoscere per facilitare la comunicazione tra l'adapter FTP e un computer mainframe.

MVS

Per inviare file a un server FTP su un mainframe, è necessario che quest'ultimo supporti IBM Generation Data Group (GDG). Nel campo relativo al nome, a ciascun file verrà aggiunto (+1) al nome file di destinazione (percorso completo racchiuso tra virgolette).

AS400

Per il trasferimento di file da e verso un sistema AS400 sono disponibili tre metodi di denominazione dei file e definizione dei relativi percorsi:

• Campo Nome file: quando si invia un file a un server FTP, immettere il nome del file nel campo Nome file . Il nome file deve rispettare le convenzioni di denominazione dei file del sistema AS400, poiché il file verrà archiviato nel Library File System.

• Comando Quote: usare il comando Quote per eseguire uno script nel computer remoto. Immettere il comando Quote nei campi Before GET, Before PUT, After GET e After PUT in uno degli endpoint. Immettere il comando Quote nel seguente formato:

  QUOTE RCMD <command to be run on the remote system>.
  

• File system integrato (IFS): IFS è un'area nel sistema AS400 che consente l'archiviazione di file basati su PC e quindi le stesse convenzioni di denominazione di un PC. Per usare IFS anziché il file system di libreria predefinito, il primo comando da immettere è quote site namefmt 1. Questo comando indica al sistema AS400 di utilizzare la convenzione di denominazione IFS.

Altre informazioni utili

Proprietà e schema proprietà dell'adapter FTP

Procedure consigliate e raccomandazioni per l'adapter FTP

FTP Adapter