FTP 适配器配置属性

下表列出了可以为 FTP 适配器接收位置设置的配置属性:

属性名称 类型 DESCRIPTION 限制 注释
URI VT_BSTR 指定受接收位置监视的位置的完整路径。 发送端口或接收位置的 URI 不能超过 256 个字符。 没有
服务器地址 VT_BSTR 指定 FTP 服务器的服务器名称或 IP 地址。 没有 没有
服务器端口 VT_BSTR 指定要通过该端口与目标 FTP 服务器通信的 TCP 端口。 没有 没有
用户名 VT_BSTR 指定用于访问 FTP 服务器的用户名。 没有 没有
密码 VT_BSTR 指定用于访问 FTP 服务器的密码。 导出绑定文件时,始终屏蔽此值。 在将绑定文件导入目标 BizTalk Server 配置之前,必须使用密码手动填充此属性。 没有
文件掩码 VT_BSTR 指定传输文件时要使用的文件掩码筛选器。 没有 没有
目标文件夹 VT_BSTR 指定 FTP 服务器上的轮询位置。 没有 没有
命令日志文件名 VT_BSTR 指定保存日志文件副本的位置。 没有 使用此文件通过 FTP 适配器发送或接收文件时诊断错误情况。
表示类型 VT_BSTR 选择 FTP 适配器接收数据的方式。 有效值为:

-二元
- ASCII
默认值为 Binary。
spoolingFolder VT_BSTR 指定 FTP 服务器上的临时文件夹的位置。 使用此选项可以保证从传输失败中恢复。 没有 没有
receiveDataTimeOut VT_BSTR 指定接收调用中止前的时间(以毫秒为单位)。 这用于防止慢速服务器导致接收位置出现挂起问题。 没有 默认值为 90000。
maximumBatchSize VT_BSTR 指定每个 BizTalk Server 批处理的最大字节数。 没有 没有
最大文件数量 VT_BSTR 指定每个 BizTalk Server 批处理的最大文件数。 没有 没有
被动模式 VT_BSTR 指定适配器连接到 FTP 服务器的模式。 有效值为:

-被动
- 活动
默认值为“活动”。
useNLST VT_BSTR 将此指定为“是”,以仅检索文件名,而不是默认系统定义的文件列表。 有效值为:

-是的
否-
默认值为 No。
beforeGet VT_BSTR 指定要在文件 GET 之前执行的 FTP 命令。 用分号(;)分隔命令 注意: 文件 GET 之前不支持 QUIT 命令。 没有
afterGet VT_BSTR 指定要在文件 GET 之后执行的 FTP 命令。 用分号分隔命令(;) 没有
防火墙类型 VT_BSTR 指定部署的防火墙类型。 有效值为:

- 无
- 袜子 4
- 袜子 5
默认值为 None。
防火墙地址 VT_BSTR 指定防火墙的地址(DNS 名称或 IP 地址)。 没有 没有
防火墙端口 VT_BSTR 指定防火墙的端口。 有效值为 1 到 65535。 默认值为 21。
防火墙用户名 VT_BSTR 指定防火墙的用户名。 没有 没有
防火墙密码 VT_BSTR 指定防火墙的密码。 没有 没有
pollingUnitOfMeasure VT_BSTR 指定 pollingInterval 属性的单位类型。 有效值为:

-秒
-纪要
-小时
-日
默认值为秒。
轮询间隔 VT_BSTR 指定轮询此位置的间隔值。 没有 若要持续轮询,请将此值设置为 0。

默认值是 60秒。
重新下载间隔 VT_BSTR 指定间隔(以秒为单位),之后 FTP 适配器将再次下载文件。 仅当 deleteAfterDownload 和 enableTimeComparison 属性都设置为 No 时,此属性才适用。 -1 值指示适配器不会再次下载文件。

默认值为 -1。
ssoAffiliateApplication VT_BSTR 请指定单一Sign-On(SSO)关联的应用程序。 没有 没有
errorThreshold (错误阈值) VT_BSTR 指定在禁用位置之前 BizTalk Server 可能会遇到的错误数。 没有 默认值为 10。
最大文件大小 VT_BSTR 指定最大可下载文件大小(以 MB 为单位)。 没有 值为 0 表示文件大小没有限制。

默认值为 100。
useSsl VT_BSTR 如果 FTP 适配器在与 FTPS 服务器通信时必须使用 SSL,则将其指定为“是”。 有效值为:

-是的
否-
默认值为 No。
使用数据保护 VT_BSTR 如果 FTP 适配器在向/从 FTPS 服务器发送和接收文件时必须使用 SSL 加密,则将其指定为“是”。 如果 useSsl 属性设置为“是”,则此属性有效。

有效值为:

-是的
否-
默认值为“是”。
ftpsConnMode VT_BSTR 指定与 FTPS 服务器建立的 SSL 连接的模式。 有效值为:

-明确
-含蓄
默认值为 Explicit。
客户端证书哈希 VT_BSTR 指定必须在 SSL 协商中使用的客户端证书的 SHA1 哈希。 没有 基于此哈希,从运行 BizTalk 主机实例的用户帐户的个人存储中选取客户端证书。
下载后删除 VT_BSTR 如果适配器必须在下载完成后从 FTP 服务器中删除文件,请将其指定为“是”。 有效值为:

-是的
否-
默认值为“是”。
enableTimeComparison VT_BSTR 如果适配器必须在文件的时间戳发生更改时再次下载文件,请将其指定为“是”。 仅当 deleteAfterDownload 设置为 No 时,此属性才有效。

目标 FTP 服务器必须支持此功能的 MDTM 命令。

有效值为:

-是的
否-
默认值为 No。

以下代码显示了用于设置属性的字符串的格式:

<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>  

下表列出了可以为 FTP 适配器发送端口设置的配置属性:

属性名称 类型 DESCRIPTION 限制 注释
URI VT_BSTR 指定要向其发送数据的位置的完整路径。 发送端口或接收位置的 URI 不能超过 256 个字符。 没有
服务器地址 VT_BSTR 指定防火墙的地址,即 DNS 名称或 IP 地址。 没有 没有
服务器端口 VT_BSTR 指定 FTP 服务器的端口地址。 没有 默认值为 21。
用户名 VT_BSTR 指定要登录到 FTP 服务器的用户名。 没有 没有
密码 VT_BSTR 指定要登录到 FTP 服务器的密码。 导出绑定文件时,始终屏蔽此值。 在将绑定文件导入目标 BizTalk Server 配置之前,必须使用密码手动填充此属性。 没有
账户名称 VT_BSTR 指定 FTP 服务器的帐户名称。 可选 没有
目标文件夹 VT_BSTR 指定要将文件移动到 FTP 服务器上的位置。 没有 没有
目标文件名 VT_BSTR 指定文件的备用名称。 保留默认名称将保证发送的每个邮件的唯一消息名称。 没有 默认值为 %MessageID%.xml。
命令日志文件名 VT_BSTR 指定保存日志文件副本的位置。 使用日志文件诊断通过 FTP 服务器发送或接收文件时的错误情况。 没有 没有
表示类型 VT_BSTR 选择 FTP 将数据作为二进制或 ASCII 发送的方式。 有效值为:

-二进制
- ASCII
默认值为二进制值。
beforePut VT_BSTR 指定要在文件 PUT 之前运行的 FTP 命令,例如用于更改 FTP 服务器上的默认值的命令。 用分号分隔命令(;))。 注意:在进行文件 PUT 操作之前,不支持使用 QUIT 命令。 无需打开命令。
afterPut VT_BSTR 指定要在文件 PUT 之后运行的 FTP 命令。 用分号分隔命令(;))。 没有
分配存储 VT_BSTR 指定是否为旧主机系统分配存储空间。 有效值为:

-是的
否-
默认值为 No。
spoolingFolder VT_BSTR 指定 FTP 服务器上的临时文件夹的位置。 如果传输模式是二进制模式,则可以使用此模式保证从传输失败中恢复。 如果传输模式为 ASCII,适配器将重启上传。 没有 没有
连接限制 VT_BSTR 指定可以与服务器建立的最大并发 FTP 连接数。 没有 值为 0 表示没有限制。
被动模式 VT_BSTR 指定是使用被动模式还是主动模式。 有效值为:

- True (被动模式)
- 假 (活动模式)
默认值为 False(活动模式)。
防火墙类型 VT_BSTR 选择部署的防火墙类型。 有效值为:

- 袜子 4
- 袜子 5
- 无
默认值为 None。
防火墙地址 VT_BSTR 指定防火墙的地址,即 DNS 名称或 IP 地址。 没有 没有
防火墙端口 VT_BSTR 指定防火墙的端口。 有效值为 1 到 65535。 默认值为 21。
防火墙用户名 VT_BSTR 指定防火墙的用户名。 没有 没有
防火墙密码 VT_BSTR 指定防火墙的密码。 导出绑定文件时,始终屏蔽此值。 在将绑定文件导入目标 BizTalk Server 配置之前,必须使用密码手动填充此属性。 没有
ssoAffiliateApplication VT_BSTR 指定单Sign-On(SSO)关联应用程序。 没有 没有
useSsl VT_BSTR 如果 FTP 适配器在与 FTPS 服务器通信时必须使用 SSL,则将其指定为“是”。 有效值为:

-是的
否-
默认值为 No。
使用数据保护 VT_BSTR 如果 FTP 适配器在向/从 FTPS 服务器发送和接收文件时必须使用 SSL 加密,则将其指定为“是”。 如果 useSsL 设置为“是”,则此属性有效。

有效值为:

-是的
否-
默认值为“是”。
ftpsConnMode VT_BSTR 指定与 FTPS 服务器建立的 SSL 连接的模式。 有效值为:

-明确
-含蓄
默认值为 Explicit。
客户端证书哈希 VT_BSTR 指定必须在 SSL 协商中使用的客户端证书的 SHA1 哈希。 没有 基于此哈希,从运行 BizTalk 主机实例的用户帐户的个人存储中选取客户端证书。

以下代码显示了用于设置属性的字符串的格式:

<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>  

注释

为使用适配器框架生成的适配器指定 TransportTypeData 配置数据时,使用的所有名称/值对都必须存储在 AdapterConfig> 元素中<。 <由于 AdapterConfig> 元素指定了 VT_BSTR(vt=“8”)数据类型,所以数据里的<>字符必须转义。