Proprietà di configurazione di adapter FTP
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per l'indirizzo di ricezione di un adapter FTP.
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| Uri | VT_BSTR | Specificare il percorso completo dell'indirizzo monitorato dall'indirizzo di ricezione. | L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri. | Nessuno |
| serverAddress | VT_BSTR | Specificare il nome del server o l'indirizzo IP del server FTP. | Nessuno | Nessuno |
| serverPort | VT_BSTR | Specificare la porta TCP su cui comunicare con il server FTP di destinazione. | Nessuno | Nessuno |
| userName | VT_BSTR | Specificare il nome utente utilizzato per accedere al server FTP. | Nessuno | Nessuno |
| password | VT_BSTR | Specificare la password utilizzata per accedere al server FTP. | Quando si esporta un file di associazione, questo valore è sempre mascherato. Questa proprietà deve essere compilata manualmente con la password prima di importare il file di associazione nella configurazione di BizTalk Server di destinazione. | Nessuno |
| fileMask | VT_BSTR | Specificare il filtro file da utilizzare per la trasmissione dei file. | Nessuno | Nessuno |
| targetFolder | VT_BSTR | Specificare l'indirizzo di polling sul server FTP. | Nessuno | Nessuno |
| commandLogFilename | VT_BSTR | Specificare il percorso per il salvataggio di una copia del file di registro. | Nessuno | Utilizzare questo file per diagnosticare le condizioni di errore durante l'invio o la ricezione di file tramite l'adapter FTP. |
| representationType | VT_BSTR | Selezionare la modalità di ricezione dei dati da parte dell'adapter FTP. | I valori validi sono: - Binary -ASCII |
Il valore predefinito è Binario. |
| spoolingFolder | VT_BSTR | Specificare il percorso di una cartella temporanea nel server FTP Utilizzare questa cartella per garantire il ripristino a seguito di un errore di trasferimento. | Nessuno | Nessuno |
| receiveDataTimeOut | VT_BSTR | 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 dell'indirizzo di ricezione. | Nessuno | Il valore predefinito è 90000. |
| maximumBatchSize | VT_BSTR | Specificare il numero massimo di byte per ogni batch di BizTalk Server. | Nessuno | Nessuno |
| maximumNumberOfFiles | VT_BSTR | Specificare il numero massimo di file per ogni batch di BizTalk Server. | Nessuno | Nessuno |
| passiveMode | VT_BSTR | Specificare la modalità utilizzata dall'adapter per la connessione al server FTP. | I valori validi sono: -Passivo - Attivo |
Il valore predefinito è Attiva. |
| useNLST | VT_BSTR | Sepcificare Sì per recuperare solo i nomi dei file anziché l'elenco di file predefinito definito dal sistema. | I valori validi sono: -Sì -No |
Il valore predefinito è No. |
| beforeGet | VT_BSTR | Specificare i comandi FTP da eseguire prima dell'operazione GET sui file. | Separare i comandi con un punto e virgola (;) Nota: Il comando QUIT non è supportato prima del file GET. | Nessuno |
| afterGet | VT_BSTR | Specificare i comandi FTP da eseguire dopo l'operazione GET sui file. | Separare i comandi con un punto e virgola (;). | Nessuno |
| firewallType | VT_BSTR | Specificare il tipo di firewall distribuito. | I valori validi sono: -Nessuno - Calzini 4 - Calzini 5 |
Il valore predefinito è None (Nessuna). |
| firewallAddress | VT_BSTR | Specificare l'indirizzo del firewall, vale a dire il nome DNS o l'indirizzo IP. | Nessuno | Nessuno |
| firewallPort | VT_BSTR | Specificare la porta per il firewall. | I valori validi sono compresi tra 1 e 65535. | Il valore predefinito è 21. |
| firewallUserName | VT_BSTR | Specificare il nome utente per il firewall. | Nessuno | Nessuno |
| firewallPassword | VT_BSTR | Specificare la password per il firewall. | Nessuno | Nessuno |
| pollingUnitOfMeasure | VT_BSTR | Specificare il tipo di unità per la proprietà pollingInterval. | I valori validi sono: -Secondi -Minuti -Ore -Giorni |
Il valore predefinito è Secondi. |
| pollingInterval | VT_BSTR | Specificare il valore del'intervallo per il polling dell'indirizzo. | Nessuno | Per eseguire il polling in modo continuativo, impostare questo valore su 0. Il valore predefinito è 60. |
| redownloadInterval | VT_BSTR | Specificare l'intervallo in secondi dopo il quale l'adapter FTP scaricherà nuovamente il file. | Questa proprietà è applicabile solo se entrambe le proprietà deleteAfterDownload ed enableTimeComparison sono impostate su No. | Il valore -1 indica che l'adattatore non scaricherà di nuovo il file. Il valore predefinito è -1. |
| ssoAffiliateApplication | VT_BSTR | Specificare l'applicazione affiliata Single Sign-On (SSO). | Nessuno | Nessuno |
| errorThreshold | VT_BSTR | Specificare il numero di errori tollerati da BizTalk Server prima che l'indirizzo venga disattivato. | Nessuno | Il valore predefinito è 10. |
| maxFileSize | VT_BSTR | Specificare le dimensioni massime del file scaricabile, in MB. | Nessuno | Un valore 0 indica che non vi sono limiti alle dimensioni del file. Il valore predefinito è 100. |
| useSsl | VT_BSTR | Specificare Sì se l'adapter FTP deve utilizzare SSL per comunicare con il server FTPS. | I valori validi sono: -Sì -No |
Il valore predefinito è No. |
| useDataProtection | VT_BSTR | Specificare Sì se l'adapter FTP deve utilizzare la crittografia SSL durante la trasmissione e la ricezione di file al e dal server FTPS. | Questa proprietà è valida se la proprietà useSsl è impostata su Sì. I valori validi sono: -Sì -No |
Il valore predefinito è Sì. |
| ftpsConnMode | VT_BSTR | Specificare la modalità di connessione SSL al server FTPS. | I valori validi sono: -Esplicito -Implicita |
Il valore predefinito è Explicit. |
| clientCertificateHash | VT_BSTR | Specificare l'hash SHA1 del certificato client che deve essere utilizzato nella negoziazione SSL. | Nessuno | In base all'hash specificato, il certificato client viene prelevato dall'archivio personale dell'account utente in cui è in esecuzione l'istanza host BizTalk. |
| deleteAfterDownload | VT_BSTR | Specificare questa opzione come Sì se l'adattatore deve eliminare il file dal server FTP al termine del download. | I valori validi sono: -Sì -No |
Il valore predefinito è Sì. |
| enableTimeComparison | VT_BSTR | Specificare Sì se l'adapter deve scaricare nuovamente un file quando il timestamp del file viene modificato. | Questa proprietà è valido solo quando deleteAfterDownload è impostata su No. Il server FTP di destinazione deve supportare il comando MDTM per questa funzionalità. I valori validi sono: -Sì -No |
Il valore predefinito è No. |
Nel codice seguente viene illustrato il formato della stringa utilizzata per impostare le proprietà:
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>ftp://localhost:21/in/*.xml</uri><serverAddress>localhost</serverAddress><serverPort>21</serverPort><userName>domain\testuser</userName><password>******</password><fileMask>*.xml</fileMask><targetFolder>in</targetFolder><commandLogFilename>c:\temp\realftplog.txt</commandLogFilename><representationType>binary</representationType><maximumBatchSize>0</maximumBatchSize><maximumNumberOfFiles>0</maximumNumberOfFiles><passiveMode>False</passiveMode><firewallType>NoFirewall</firewallType><firewallPort>21</firewallPort><pollingUnitOfMeasure>Seconds</pollingUnitOfMeasure><pollingInterval>5</pollingInterval><errorThreshold>10</errorThreshold><maxFileSize>5000</maxFileSize><useSsl>False</useSsl><useDataProtection>True</useDataProtection><ftpsConnMode>Explicit</ftpsConnMode><clientCertificateHash>bc 32 2c a9 22 75 6a 3f e4 f7 a9 b1 b3 3a 24 20 23 53 68 49</clientCertificateHash><deleteAfterDownload>True</deleteAfterDownload><enableTimeComparison>False</enableTimeComparison></Config></AdapterConfig></CustomProps>
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per la porta di trasmissione di un adapter FTP:
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| Uri | VT_BSTR | Specificare il percorso completo dell'indirizzo a cui trasmettere i dati. | L'URI per una porta di trasmissione o un indirizzo di ricezione non può essere superiore a 256 caratteri. | Nessuno |
| serverAddress | VT_BSTR | Specificare l'indirizzo del firewall, vale a dire il nome DNS o l'indirizzo IP. | Nessuno | Nessuno |
| serverPort | VT_BSTR | Specificare l'indirizzo della porta per il server FTP. | Nessuno | Il valore predefinito è 21. |
| userName | VT_BSTR | Specificare il nome utente per l'accesso al server FTP. | Nessuno | Nessuno |
| password | VT_BSTR | Specificare la password per l'accesso al server FTP. | Quando si esporta un file di associazione, questo valore è sempre mascherato. Questa proprietà deve essere compilata manualmente con la password prima di importare il file di associazione nella configurazione di BizTalk Server di destinazione. | Nessuno |
| accountName | VT_BSTR | Specificare il nome account per il server FTP. | Facoltativo | Nessuno |
| targetFolder | VT_BSTR | Specificare l'indirizzo per lo spostamento dei file nel server FTP. | Nessuno | Nessuno |
| targetFileName | VT_BSTR | Specificare un nome alternativo per il file. Se si mantiene il nome predefinito si garantiranno nomi di messaggi univoci per ogni messaggio inviato. | Nessuno | Il valore predefinito è %MessageID%.xml. |
| commandLogFilename | VT_BSTR | Specificare il percorso per il salvataggio di una copia del file di registro. Utilizzare questo file per diagnosticare le condizioni di errore durante l'invio o la ricezione di file tramite il server FTP. | Nessuno | Nessuno |
| representationType | VT_BSTR | Selezionare la modalità di trasmissione dei dati tramite FTP, ovvero binaria o ASCII | I valori validi sono: -Binario -ASCII |
Il valore predefinito è binaria. |
| beforePut | VT_BSTR | 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 (;). Nota: Il comando QUIT non è supportato prima del file PUT. | Non è necessario un comando di apertura. |
| afterPut | VT_BSTR | Specificare i comandi FTP da eseguire dopo file PUT. | Separare i comandi con un punto e virgola (;). | Nessuno |
| allocateStorage | VT_BSTR | Specificare se allocare spazio di archiviazione per i sistemi host precedenti. | I valori validi sono: -Sì -No |
Il valore predefinito è No. |
| spoolingFolder | VT_BSTR | Specificare il percorso di una cartella temporanea nel server FTP Utilizzare questa cartella per garantire il ripristino a seguito di un errore di trasferimento se la modalità di trasferimento è binaria. Se la modalità di trasferimento è ASCII, l'adapter riavvia il caricamento. | Nessuno | Nessuno |
| connectionLimit | VT_BSTR | Specificare il numero massimo di connessioni FTP simultanee al server. | Nessuno | Il valore 0 indica l'assenza di limiti. |
| passiveMode | VT_BSTR | Specificare se utilizzare la modalità passiva o attiva. | I valori validi sono: - True (modalità passiva) - False (modalità attiva) |
Il valore predefinito è False (modalità attiva). |
| firewallType | VT_BSTR | Selezionare il tipo di firewall distribuito. | I valori validi sono: - Calzini 4 - Calzini 5 -Nessuno |
Il valore predefinito è None (Nessuna). |
| firewallAddress | VT_BSTR | Specificare l'indirizzo del firewall, vale a dire il nome DNS o l'indirizzo IP. | Nessuno | Nessuno |
| firewallPort | VT_BSTR | Specificare la porta per il firewall. | I valori validi sono compresi tra 1 e 65535. | Il valore predefinito è 21. |
| firewallUserName | VT_BSTR | Specificare il nome utente per il firewall. | Nessuno | Nessuno |
| firewallPassword | VT_BSTR | Specificare la password per il firewall. | Quando si esporta un file di associazione, questo valore è sempre mascherato. Questa proprietà deve essere compilata manualmente con la password prima di importare il file di associazione nella configurazione di BizTalk Server di destinazione. | Nessuno |
| ssoAffiliateApplication | VT_BSTR | Specificare l'applicazione affiliata Single Sign-On (SSO). | Nessuno | Nessuno |
| useSsl | VT_BSTR | Specificare Sì se l'adapter FTP deve utilizzare SSL per comunicare con il server FTPS. | I valori validi sono: -Sì -No |
Il valore predefinito è No. |
| useDataProtection | VT_BSTR | Specificare Sì se l'adapter FTP deve utilizzare la crittografia SSL durante la trasmissione e la ricezione di file al e dal server FTPS. | Questa proprietà è valido se useSsL è impostata su Sì. I valori validi sono: -Sì -No |
Il valore predefinito è Sì. |
| ftpsConnMode | VT_BSTR | Specificare la modalità di connessione SSL al server FTPS. | I valori validi sono: -Esplicito -Implicita |
Il valore predefinito è Explicit. |
| clientCertificateHash | VT_BSTR | Specificare l'hash SHA1 del certificato client che deve essere utilizzato nella negoziazione SSL. | Nessuno | In base all'hash specificato, il certificato client viene prelevato dall'archivio personale dell'account utente in cui è in esecuzione l'istanza host BizTalk. |
Nel codice seguente viene illustrato il formato della stringa utilizzata per impostare le proprietà:
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><serverAddress>TestServer</serverAddress><serverPort>21</serverPort><userName>testuser</userName><password>******</password><accountName>testuser</accountName><targetFolder>output</targetFolder><targetFileName>%MessageID%.xml</targetFileName><commandLogFilename>c:\logfile\ftpsendlog.txt</commandLogFilename><representationType>binary</representationType><beforePut>CDW dir</beforePut><afterPut>CDUP </afterPut><allocateStorage>False</allocateStorage><spoolingFolder>tempfolder</spoolingFolder><connectionLimit>0</connectionLimit><passiveMode>False</passiveMode><firewallType>Socks4</firewallType><firewallAddress>TestServer</firewallAddress><firewallPort>21</firewallPort><firewallUserName>domain\testuser</firewallUserName><firewallPassword>******</firewallPassword><useSsl>False</useSsl><useDataProtection>True</useDataProtection><ftpsConnMode>Explicit</ftpsConnMode><clientCertificateHash>bc 32 2c a9 22 75 6a 3f e4 f7 a9 b1 b3 3a 24 20 23 53 68 49</clientCertificateHash><uri>ftp://TestServer:21/output/%MessageID%.xml</uri></Config></AdapterConfig></CustomProps>
Nota
Quando si specificano i dati di configurazione TransportTypeData per una scheda compilata tramite Adapter Framework, tutte le coppie nome/valore utilizzate devono essere archiviate nell'elemento <AdapterConfig> . Poiché l'elemento <AdapterConfig> specifica il tipo di dati VT_BSTR (vt="8"), i <> caratteri nei dati devono essere preceduti da un carattere di escape.