配置文件适配器时的限制

项目
10/14/2023

使用文件适配器时的限制和规则。

文件掩码和文件名 gotchas

文件掩码是一个字符串，用于指定文件接收处理程序将从接收位置提取的文件的类型。文件名是一个字符串，用于指定文件发送处理程序将在其中写入消息的文件的名称。

文件名和文件掩码属性具有以下限制：

每个接收位置或发送端口只能指定一个文件掩码或文件名。
不允许将完整路径或部分路径与文件掩码或文件名一起使用。文件掩码和文件名始终表示不带路径的名称。
文件掩码和文件名不区分大小写。
文件名不能包含以下任何字符：： <> / |" ? * ;
文件掩码不能包含以下任何字符：： <> / |" ;
以下保留设备名称不能用作文件的名称：CON、PRN、AUX、CLOCK$、NUL、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8 和 LPT9。此外，不允许使用这些保留名称与扩展名的任意组合。
默认情况下，Windows 磁盘卷使用 8.3 (8dot3) 命名约定，该约定使用短文件名和长文件名。非系统磁盘卷禁用 8dot3 命名约定，因此仅使用长文件名。

启用 8dot3 后，文件及其文件扩展名将转换为短名称。例如， testabcdefgh.docx 被 testab~1.doc转换为。请注意，文件名已缩短，文件扩展名从 .docx 缩短为 doc。

此行为会影响文件适配器接收文件的方式。如果文件掩码设置为 *.xml，则会选取与和 *.xmln 扩展名匹配*.xml的文件。

若要查看是否在磁盘上启用了 8dot3 命名约定，请以管理员身份打开命令提示符，然后键入 fsutil 8dot3name query c:、或 fsutil 8dot3name query d:等。示例输出如下所示：
```
C:\WINDOWS\system32>fsutil 8dot3name query c:
The volume state is: 0 (8dot3 name creation is enabled).
The registry state is: 2 (Per volume setting - the default).

Based on the above two settings, 8dot3 name creation is enabled on c:
```
文件适配器使用 FindFirstFile 函数。此函数包括具有短文件名和长文件名的搜索结果。若要查看文件夹中的短文件名和长文件名，请打开命令提示符，转到文件夹，然后键入 dir /x。在命令提示符下，还可以键入 dir c:\foldername /x。

如果更改卷上的 8dot3name 设置，则新文件将使用新设置。任何现有文件将保留其名称，直到它们被移动。

若要仅选取预期文件，并在较高负载期间获得更好的性能 (减少) 开销，最好将文件适配器配置为使用禁用了 8dot3name 的卷。
文件路径、文件掩码和文件名（没有宏替换）的总长度不能超过 256 个字符。（这是 MessageBox 数据库的限制。）
文件路径不能以“\\？”开头。
网络映射驱动器号不能用在文件路径中，因为它们是基于用户会话的。

BizTalk 消息引擎在设计时始终通过使用前面列出的项来验证文件名和文件掩码属性。此外，如果适配器在动态端口上发送消息，则文件适配器将在运行时验证文件名和文件掩码属性。

注意

文件适配器不提取系统文件或只读文件。只提取基于磁盘的文件，而不提取设备文件。

在文件名中使用宏

您可以使用预定义的宏集合动态创建文件发送处理程序在其中写入消息的文件。在文件系统中创建文件之前，文件发送处理程序将使用单独的值来替换文件名中的所有宏。可以在一个文件名中使用若干不同的宏。

在使用 BizTalk 浏览器对象模型配置文件发送处理程序时，可以使用文件名宏。

如果存在以下任何一种情况，文件发送处理程序将不会使用值替换宏：

未设置相应的系统属性。
宏拼写错误。
宏的值所包含的符号在文件名中无效。

如果出现上述任何情况，文件发送处理程序都会将文件名中的宏保持不变，例如 Myfile_%MessageID%.xml。

下表列出了所支持的宏，并介绍文件发送处理程序如何替换这些宏：

宏名称	替代值
%datetime%	YYYY-MM-DDThhmmss 格式的世界时 (UTC) 日期时间（例如 1997-07-12T103508）。
%datetime_bts2000%	YYYYMMDDhhmmsss 格式的 UTC 日期时间，其中，sss 表示秒和毫秒（例如，199707121035234 表示 1997/07/12 10:35:23 和 400 毫秒）。
%datetime.tz%	本地日期时间加上 GMT 时区，格式为 YYYY-MM-DDThhmmssTZD（例如 1997-07-12T103508+800）。
%DestinationParty%	目标参与方的名称。该值来自消息上下文属性 BTS.DestinationParty。
%DestinationPartyQualifier%	目标参与方的限定符。该值来自消息上下文属性 BTS.DestinationPartyQualifier。
%MessageID%	BizTalk Server 中消息的全局唯一标识符 (GUID)。该值直接来自消息上下文属性 BTS。MessageID。
%SourceFileName%	文件适配器从中读取消息的文件的名称。文件名包含扩展名，并排除文件路径，例如，Sample.xml。替换此属性时，文件适配器将从存储在 FILE 中的绝对文件路径中提取文件名。ReceivedFileName 上下文属性。如果上下文属性没有值（例如，如果消息是在文件适配器之外的其他适配器上接收到的），则将不替代该宏，并在文件名中按原样保留该宏（例如 C:\Drop\%SourceFileName%）。注意：正确实现此宏要求输出消息与接收的消息相同。
%SourceParty%	文件适配器从其接收消息的源参与方的名称。注意：正确实现此宏要求输出消息与接收的消息相同。
%SourcePartyQualifier%	文件适配器从其接收消息的源参与方的限定符。注意：正确实现此宏要求输出消息与接收的消息相同。
%time%	hhmmss 格式的 UTC 时间。
%time.tz%	本地时间加上 GMT 时区，格式为 hhmmssTZD（例如 124525+530）。

接收文件夹和目标位置属性

文件接收位置字符串包含指向文件接收处理程序从中读取文件的文件系统或网络共享位置上文件夹的路径。文件目标位置字符串包含指向文件发送处理程序要向其中写入文件的文件系统或网络共享位置上文件夹的路径。

接收文件夹和目标位置属性具有以下限制：

在用户中指定属性时，不需要在文件系统或网络共享上存在文件路径。
文件路径始终必须是绝对路径。
可以使用通用命名约定 (UNC) 格式 (指定文件路径，例如\\<server>\<share>) 。
如果文件路径采用 UNC 格式，则服务器名称不得包含以下字符：' ~ ！ @ # $ ^ & * ( ) = + [ ] { } \ | ;： '' “ ， <> / ？ ;
不能在文件路径的任何部分中使用父文件夹符号 (\..\) 和当前文件夹符号 (\.\)。
文件路径不区分大小写。
文件路径不能包含以下任何字符：： <> / |" ? * ;
在文件路径中不能使用以下保留的设备名称：CON、PRN、AUX、CLOCK$、NUL、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8 和 LPT9。
文件路径、文件掩码或文件名（没有宏替换）的总长度不能超过 256 个字符。（MessageBox 数据库规定了此限制。）
文件适配器不支持采用 Unicode 规范的文件路径（例如“\\?\”）。

以下限制只适用于接收文件夹属性：
请不要将接收文件夹属性设置为使用 Microsoft Windows NT 分布式文件系统的带符号链接的文件夹。如果使用 Windows NT 分布式文件系统，则在文件适配器接收位置中只能使用具有直接网络路径的文件夹。
如果将文档发送到 UNC 路径，并且有多台服务器通过文件适配器的接收位置接收文档，则只有一台服务器将提取并处理发送到该 UNC 路径的大多数文档。有关文件重命名的详细信息，请参阅文件适配器的“ 文件接收适配器”部分。

以下限制只适用于发送文件夹属性：
在 Microsoft Windows Vista 等非服务器操作系统上运行时，文件适配器可能没有足够的操作系统资源来同时处理批处理中的所有消息。

文件适配器将在设计时通过使用上文所述的规则对文件路径进行验证。此外，如果文件适配器通过动态端口发送消息，还会在运行时对消息进行验证。

通过

配置文件适配器时的限制

文件掩码和文件名 gotchas

在文件名中使用宏

接收文件夹和目标位置属性

反馈

其他资源