下表列出了可以为 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”)数据类型,所以数据里的<>字符必须转义。